sysadminandClaude Opus 4.8
f58317d079
Bootstrap repo-tracked wiki pages (10 required pages), the operator- confirmed sync script, PR template publication gate, and safety tests so Gitea-Tools can publish to the live Gitea Wiki per issue #224. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# 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. |