# Operator Runbooks

## Navigation

- [Home](Home.md) | [Operator Guide](Operator-Guide.md) | [Repositories Map](Repositories.md) | [Identity and Profiles](Identity-and-Profiles.md) | [Workflow Model](Workflow.md) | [Safety and Gates](Safety-and-Gates.md) | [MCP Tools Reference](MCP-Tools.md) | [Operator Runbooks](Runbooks.md) | [Open Decisions](Open-Decisions.md) | [Project History](History.md)

## 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):
   ```bash
   scripts/sync-gitea-wiki.sh
   ```
2. Operator-confirmed push:
   ```bash
   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](Repositories.md) when published.