51 lines
2.4 KiB
Markdown
51 lines
2.4 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>"`.
|
|
|
|
## Stable MCP control runtime (#615)
|
|
|
|
Policy ADR: [mcp-stable-control-runtime-policy-adr.md](../architecture/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):
|
|
```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. |