Files
hermes 0d111f29de fix: use HERMES_GITEA_TOKEN secret (GITEA_* prefix is reserved)
Gitea rejects secret names matching ^GIT(EA|HUB)_ per services/secrets/validation.go.
Renamed to HERMES_GITEA_TOKEN and updated workflow + README accordingly.

Assisted-By: hermes-agent:minimax-m3
2026-09-14 17:00:03 +00:00

1.7 KiB

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
HERMES_GITEA_TOKEN yes clone + fetch over HTTPS

Names starting with GITEA_ or GITHUB_ are reserved by Gitea, hence the HERMES_ prefix.

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.