Gitea-Tools/docs/wiki/Runbooks.md

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>".

Stable MCP control runtime (#615)

Policy ADR: mcp-stable-control-runtime-policy-adr.md.

Situation	Who acts	What to do
Transport EOF / missing tools	LLM	Client reconnect only — do not kill PIDs
Wrong profile / dual-namespace missing	Operator	Configure or reload the correct static namespace(s)
Master parity stale after merge	LLM stops + reports; operator reloads stable MCP	Resume only after parity re-verified
Promote unpromoted MCP code to stable	Operator / release-manager only	Full §2.4 promotion record

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.