1

Runbooks

Jason Walker edited this page 2026-07-06 01:36:36 -04:00

Table of Contents

• Operator Runbooks
• Navigation
• PR review and merge
• Gitea Wiki sync
• Wiki Publication Readiness Gate (#224)

Operator Runbooks

Navigation

• Home | Operator Guide | Repositories Map | Identity and Profiles | Workflow Model | Safety and Gates | MCP Tools Reference | Operator Runbooks | Open Decisions | Project History

PR review and merge

1. gitea_resolve_task_capability(task="review_pr")
2. gitea_check_pr_eligibility for review and merge actions.
3. Validate locally: tests, py_compile, git diff --check.
4. gitea_mark_final_review_decision → approve via gitea_review_pr.
5. gitea_merge_pr with pinned head SHA and confirmation="MERGE PR <n>".

Gitea Wiki sync

The Gitea Wiki mirrors docs/wiki/ (source of truth). After merging wiki changes:

1. Preview (no network):

   scripts/sync-gitea-wiki.sh
   

2. Operator-confirmed push:

   GITEA_WIKI_SYNC_CONFIRM="SYNC WIKI Gitea-Tools" scripts/sync-gitea-wiki.sh --push
   

3. If clone fails on first run, bootstrap Home via Gitea API or UI, then re-run.

The script mirrors only docs/wiki/*.md, never deletes wiki pages, and never prints credentials.

Wiki Publication Readiness Gate (#224)

Actual Gitea Wiki publication is a required repo readiness gate.

1. Closure prevention — No wiki issue may close on markdown/helper work alone. Closing requires live-Wiki proof: Wiki Home link plus page listing or wiki git log.
2. Reviewer checklist — PR template requires verifying the repo Wiki tab.
3. Publication authority — --push requires exact GITEA_WIKI_SYNC_CONFIRM phrase.
4. Per-repo status — Update Repositories Map when published.