Scaled-Tech-Consulting/Gitea-Tools

Files

T

sysadminandClaude Opus 4.8 f58317d079 Add docs/wiki source tree and Gitea Wiki sync helper (#224 )

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]>

2026-07-06 01:36:10 -04:00

1.7 KiB

Raw Blame History

Operator Runbooks

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

gitea_resolve_task_capability(task="review_pr")
gitea_check_pr_eligibility for review and merge actions.
Validate locally: tests, py_compile, git diff --check.
gitea_mark_final_review_decision → approve via gitea_review_pr.
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:

Preview (no network):
```
scripts/sync-gitea-wiki.sh
```

Operator-confirmed push:

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

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.

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.
Reviewer checklist — PR template requires verifying the repo Wiki tab.
Publication authority — --push requires exact GITEA_WIKI_SYNC_CONFIRM phrase.
Per-repo status — Update Repositories Map when published.