hermes 4059b4194f feat: initial fork-sync workflow
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
2026-09-14 16:56:58 +00:00
2026-09-14 16:56:58 +00:00
2026-09-14 16:56:58 +00:00

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>:

  1. Clones the fork if not present
  2. Adds <upstream-owner>/<name> as upstream remote
  3. Fetches both upstream and origin with --prune
  4. Fast-forwards every local branch with an upstream counterpart (only --ff-only)
  5. Creates local tracking branches for upstream branches we don't have yet
  6. Reports divergences (non-FF-able conflicts) on stdout

Stdout is empty on quiet tick. Non-empty stdout = one Telegram alert.

Trigger

  • Schedule: hourly (0 * * * *) — workflow fork-sync.yml
  • Manual: workflow_dispatch
  • Local cron (fallback for environments without actions): /opt/data/cron/jobs.json → job fork-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 definition
  • tools/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.

S
Description
Hermes-agent cron-driven fork-sync infrastructure. Workflow syncs upstream branches into hermes/* forks hourly.
Readme
65 KiB
Languages
Python 100%