docs: replace stale sitemap inventory

2026-08-10 18:35:46 -05:00
parent 16920c4a6f
commit 7ddd2f5e1d
3 changed files with 69 additions and 127 deletions
@@ -75,6 +75,7 @@ Shared indexes, navigation, audit records, integration review, and final commits
 - [x] Migrate the three-file #756 Discord evidence batch byte-identically and add a reports index.
 - [x] Complete and integrate the four implementation-agent slices after independent scope and evidence review.
 - [x] Complete wave 2 audience, testing, RFC, and dashboard migrations and connect every page to its owning index and sitemap.
+- [x] Replace the stale sitemap link inventory with fully resolvable current navigation and an authority-gated backlog summary.

 ## Initial findings

@@ -88,7 +89,7 @@ Shared indexes, navigation, audit records, integration review, and final commits
 - `docs/openapi-tess.yaml` parses as OpenAPI 3.1 with 17 paths, but remains a legacy root-level Tess-scoped contract rather than the full API SSOT.
 - The baseline `.gitignore` ignored `docs/reports/`, conflicting with the new documentation contract and lint-staged. The blanket rule is now removed so canonical evidence can be tracked normally.
 - The scaffold slice adds `USER-GUIDE/README.md`, `ADMIN-GUIDE/README.md`, `ADMIN-GUIDE/security/README.md`, `DEVELOPER-GUIDE/README.md`, `DEVELOPER-GUIDE/architecture/README.md`, and `API/README.md`; legacy pages remain unchanged.
- `SITEMAP.md` now has a labeled current-structure section; its legacy sections remain unchanged and explicitly transitional.
+- `SITEMAP.md` now contains 40 resolvable current relative links and no stale legacy targets. Authority-gated Fleet, Federation, Kanban, Tess/API, and deployment groups are summarized without presenting quarantine paths as current navigation.
 - `docs/PERFORMANCE.md` had no live source/test dependency or internal links; it moved unchanged to `docs/reports/qa/p8-003-performance-optimization.md`. The admin index and current sitemap now classify it as historical evidence, not an operator runbook.
 - `PRD-TUI_Improvements.md` and `TASKS-TUI_Improvements.md` had no live source/test dependencies beyond their internal relative link; both moved unchanged to `docs/archive/tui/`, and `docs/archive/README.md` labels them historical.
 - The empty `docs/QUICKSTART.md` placeholder was replaced by `docs/USER-GUIDE/getting-started/quickstart.md`, based on verified installer, wizard, CLI, and runtime-safety behavior. The page explicitly excludes held PostgreSQL/source-checkout routes.
@@ -106,7 +107,7 @@ Shared indexes, navigation, audit records, integration review, and final commits

 ## Risks and blockers

- `docs/SITEMAP.md`, `docs/PRD.md`, task manifests, and source/tests still contain legacy paths.
+- `docs/PRD.md`, `docs/TASKS.md`, and `docs/MISSION-MANIFEST.md` retain 17 unresolved links that require maintainer/orchestrator authority. Source/tests still contain Fleet/Federation legacy paths that must move with those workstreams.
 - Historical documents may contain commands or security claims that are unsafe if resurfaced as current guidance.
 - Truth audit is static unless a claim can be verified without starting held services or violating database/runtime safety rules.
 - `docs/TASKS.md` is single-writer orchestrator state and will not be edited by this task.
@@ -144,3 +145,5 @@ Shared indexes, navigation, audit records, integration review, and final commits
 | Lease-broker verification   | PASS — safe static/test workflow is current; startup, recovery, mutation, service management, and cleanup remain held                                                       |
 | Optional egress RFC         | PASS — proposal remains draft/non-operative; model and runtime-provider boundaries are separated and candidates are not integrated                                          |
 | Web dashboard guide         | PASS — current routes, views, chat persistence, and absent project/task creation controls are documented from source/tests                                                  |
+| Sitemap refresh             | PASS — 40/40 relative links resolve; legacy link farm replaced by a non-linked authority-gated backlog summary                                                              |
+| Canonical link audit        | BLOCKED ONLY BY CONTROL DOCS — 273 links scanned, 17 unresolved; all are in maintainer/orchestrator-owned `PRD.md`, `TASKS.md`, or `MISSION-MANIFEST.md`                    |