4059b4194fdaa5b29a2a1c3b13da29d1a9a7006c
Adds:
- .gitea/workflows/fork-sync.yml — hourly Gitea Actions workflow that clones
hermes/* forks, fast-forwards branches with upstream counterparts, creates
tracking branches for upstream-only branches, surfaces divergences.
- tools/fork-sync.py — shared sync script (used by both the workflow and the
hermes-agent local cron fallback).
- README.md — operator documentation.
Forks covered by default: hermes/{brencher,ansible,reverseproxy,mcps,
hermes-voice-gateway} ← admin/{brencher,ansible,reverseproxy,mcps} and
Org1/{hermes-voice-gateway}.
Assisted-By: hermes-agent:minimax-m3
hermes/fork-sync
Sync infrastructure for hermes/* forks. Workflow pulls upstream branches
into forks every hour.
What it does
For each fork pair hermes/<name>=<upstream-owner>/<name>:
- Clones the fork if not present
- Adds
<upstream-owner>/<name>asupstreamremote - Fetches both
upstreamandoriginwith--prune - Fast-forwards every local branch with an upstream counterpart (only
--ff-only) - Creates local tracking branches for upstream branches we don't have yet
- Reports divergences (non-FF-able conflicts) on stdout
Stdout is empty on quiet tick. Non-empty stdout = one Telegram alert.
Trigger
- Schedule: hourly (
0 * * * *) — workflowfork-sync.yml - Manual:
workflow_dispatch - Local cron (fallback for environments without actions):
/opt/data/cron/jobs.json→ jobfork-sync(every 1h)
Fork pairs (default)
hermes/brencher = admin/brencher
hermes/ansible = admin/ansible
hermes/reverseproxy = admin/reverseproxy
hermes/mcps = admin/mcps
hermes/hermes-voice-gateway = Org1/hermes-voice-gateway
Override via FORK_PAIRS env (comma-separated fork=upstream).
Secrets
| Name | Required | Used for |
|---|---|---|
GITEA_TOKEN |
yes | clone + fetch over HTTPS |
Files
.gitea/workflows/fork-sync.yml— workflow definitiontools/fork-sync.py— sync script (shared with local cron fallback)
Adding a new fork
Append hermes/<repo>=<upstream-owner>/<repo> to FORK_PAIRS. The next run
will clone the fork and pull every upstream branch.
Description
Hermes-agent cron-driven fork-sync infrastructure. Workflow syncs upstream branches into hermes/* forks hourly.
65 KiB
Languages
Python
100%