From 7ddd2f5e1d7d72b7a8d9b439cb20e6f83db8582a Mon Sep 17 00:00:00 2001 From: Jason Woltje Date: Mon, 10 Aug 2026 18:35:46 -0500 Subject: [PATCH] docs: replace stale sitemap inventory --- docs/README.md | 18 +- docs/SITEMAP.md | 171 ++++++------------ docs/scratchpads/DOCS-IA-002-catalog-audit.md | 7 +- 3 files changed, 69 insertions(+), 127 deletions(-) diff --git a/docs/README.md b/docs/README.md index 01346568..ca25d816 100644 --- a/docs/README.md +++ b/docs/README.md @@ -205,17 +205,17 @@ The initial structure pass defined the target structure without moving or rewrit ## Current transition state -The structure is being established incrementally while classified content migration proceeds. During this transition: +Classified migration is active and the audience books now contain verified current pages. During this transition: -- The target directories listed above are a blueprint; not all indexes or chapters exist yet. -- `docs/_old_structure/` remains available for reference but is not current documentation. -- Existing root documentation files remain until their migration destinations are reviewed; migrated pages must leave a verified navigation path. -- `docs/SITEMAP.md` has current scaffold entry points but still contains legacy paths and will be refreshed as pages are migrated. +- The target directories listed above remain the placement contract; some planned chapters are not populated yet. +- `docs/_old_structure/` remains available for migration evidence but is not current documentation or command authority. +- Root control and API artifacts remain until their authority and destination decisions are approved. +- `docs/SITEMAP.md` contains only resolvable current navigation plus a non-linked summary of authority-gated migration groups. - No external publishing platform is assumed. The canonical source remains this repository under `docs/`. -## Non-goals for this pass +## Current migration boundaries -- Do not move, delete, or rewrite the archived documentation. -- Do not rewrite the product PRD, active task rollup, API contract, or sitemap yet. -- Do not create a documentation website or publishing pipeline. +- Do not bulk-promote or bulk-rewrite quarantined documentation; classify and verify each coherent slice. +- Do not rewrite product requirements, orchestrator-owned task state, mission status, or the API contract without the required authority decision. +- Do not create a documentation website or publishing pipeline as part of content migration. - Do not treat Obsidian metadata as product or project source of truth. diff --git a/docs/SITEMAP.md b/docs/SITEMAP.md index 172a7ba5..e450a1c0 100644 --- a/docs/SITEMAP.md +++ b/docs/SITEMAP.md @@ -1,138 +1,77 @@ # Documentation Sitemap -> **Transition status:** The current structure is listed first. The legacy sections below are retained migration inventory and may contain stale or unresolved paths; they are not a claim that those pages are current. +> **Status:** Current navigation index. Quarantined and authority-gated material is summarized without being presented as current guidance. -## Current documentation structure +## Start here - [Documentation atlas](README.md) — placement, source-of-truth, linking, and migration rules. -- [User guide index](USER-GUIDE/README.md) — end-user documentation and current quickstart. -- [Administrator guide index](ADMIN-GUIDE/README.md) — operator documentation and current security runbooks. -- [Developer guide index](DEVELOPER-GUIDE/README.md) — partially migrated contributor and architecture documentation. -- [Architecture index](DEVELOPER-GUIDE/architecture/README.md) — system design, security contracts, decisions, and RFCs. -- [Lease-broker protocol](DEVELOPER-GUIDE/architecture/lease-broker-protocol.md) — authenticated runtime lease-broker protocol and persistence boundary. -- [Lease-broker security notes](DEVELOPER-GUIDE/architecture/lease-broker-security.md) — identity, ancestry, filesystem, and residual security boundaries. -- [Whole mutator-class gate](DEVELOPER-GUIDE/architecture/mutator-class-gate.md) — default-deny tool authorization and launch choke point. -- [Compaction revocation lifecycle](DEVELOPER-GUIDE/architecture/compaction-revocation.md) — Claude/Pi lifecycle observers, generation fencing, and residual boundary. -- [Channel protocol architecture](DEVELOPER-GUIDE/architecture/channel-protocol.md) — shared channel DTOs and current Discord compatibility boundary; future adapters are labeled draft. -- [Architecture decisions index](DEVELOPER-GUIDE/architecture/decisions/README.md) — approved and implemented architecture decisions. -- [Mos runtime portability M1](DEVELOPER-GUIDE/architecture/decisions/mos-runtime-portability-m1.md) — logical identity, connector lease, grant, audit, and fencing decision. -- [Administrator operations index](ADMIN-GUIDE/operations/README.md) — current local procedures and held operational outlines. -- [Upgrade safety and recovery](ADMIN-GUIDE/operations/upgrade-safety-and-recovery.md) — installed-CLI/local-PGlite upgrade and framework recovery runbook. -- [Mos connector lease operations](ADMIN-GUIDE/operations/mos-connector-lease-operations.md) — held/non-operative M1 operations outline. -- [Lease-broker operations and verification](DEVELOPER-GUIDE/testing/lease-broker-operations.md) — safe static/test workflow with live procedures held. -- [Optional AI egress gateways RFC](DEVELOPER-GUIDE/architecture/rfcs/optional-ai-egress-gateways.md) — draft proposal; no candidate is integrated. -- [Web dashboard](USER-GUIDE/product/web-dashboard.md) — current routes, views, chat persistence, settings, and admin behavior. -- [Discord conversations](USER-GUIDE/workflows/discord-conversations.md) — current authorized Discord workflow. -- [Discord ingress security](ADMIN-GUIDE/security/discord-ingress.md) — current service authentication, allowlist, binding, role, and replay controls. -- [Channel adapter authoring](DEVELOPER-GUIDE/integrations/channel-adapters.md) — current shared contract and Discord reference boundary. -- [API documentation index](API/README.md) — scaffold for the consolidated gateway contract. +- [User guide](USER-GUIDE/README.md) — end-user workflows and product behavior. +- [Administrator guide](ADMIN-GUIDE/README.md) — installation, configuration, operations, security, and recovery. +- [Developer guide](DEVELOPER-GUIDE/README.md) — architecture, testing, integrations, and contributor material. +- [API documentation](API/README.md) — API contract migration status. - [Reports index](reports/README.md) — review, audit, QA, security, and retained evidence. -- [Documentation catalog and truth audit](reports/documentation/2026-08-10-docs-catalog-audit.md) — evidence and migration recommendations. -- [User quickstart](USER-GUIDE/getting-started/quickstart.md) — installed-CLI first-use path. -- [SSO provider runbook](ADMIN-GUIDE/security/sso-providers.md) — current Authentik, WorkOS, and Keycloak configuration. -- [P8-003 performance report](reports/qa/p8-003-performance-optimization.md) — historical performance evidence; not a current SLO or runbook. -- [Archive index](archive/README.md) — retained historical pages; not current guidance. +- [Archive index](archive/README.md) — superseded historical pages. -Canonical pages added to a book must be linked from that book's README and this section. Replace or retire legacy entries only after the associated migration slice verifies repository references and claim status. +## Product and delivery control -## Compaction refresh lease broker +- [Product requirements](PRD.md) — normative requirements; currently marked draft and retaining authority-gated legacy references. +- [Active task rollup](TASKS.md) — orchestrator-owned work state; workers do not modify it. +- [MVP mission manifest](MISSION-MANIFEST.md) — stale rollup retained pending an orchestrator/maintainer disposition decision. +- [Documentation catalog and truth audit](reports/documentation/2026-08-10-docs-catalog-audit.md) — complete baseline inventory, evidence labels, broken-link clusters, and migration recommendations. -- [Internal broker protocol](DEVELOPER-GUIDE/architecture/lease-broker-protocol.md) — kernel identity, ancestry and generation invariants, framed requests, responses, and persisted cycle bindings. -- [Broker operations](DEVELOPER-GUIDE/testing/lease-broker-operations.md) — safe static/test workflow; live startup, recovery, mutation, and cleanup remain held. -- [Constrained recovery skill](../packages/mosaic/framework/skills/mosaic-context-refresh/SKILL.md) — source-resident thin wrapper, receipt scope, C4 replay boundary, and T-C middle-drop disclosure. -- [Lease-broker security notes](DEVELOPER-GUIDE/architecture/lease-broker-security.md) — identity, whole-class authorization, threat boundaries, and coordinator review requirements. -- [Whole mutator-class gate](DEVELOPER-GUIDE/architecture/mutator-class-gate.md) — default-deny policy, revoke-first/promote-last state machine, TTL, runtime adapters, and T-B/T-C assurance boundary. -- [Compaction revocation lifecycle](DEVELOPER-GUIDE/architecture/compaction-revocation.md) — Claude/Pi observer matrix, same-PID generation rollover, failure fencing, and the named bounded residual stale window. +## User documentation -## CLI and skill management +- [Quickstart](USER-GUIDE/getting-started/quickstart.md) — installed-CLI first-use route with local PGlite safety boundaries. +- [Web dashboard](USER-GUIDE/product/web-dashboard.md) — current routes, views, chat persistence, settings, and admin behavior. +- [Discord conversations](USER-GUIDE/workflows/discord-conversations.md) — current authorized parent-channel, thread, attachment, and control workflow. -- [Skill registration user guide](guides/user-guide.md#claude-code-skill-registration) — register, unregister, list statuses, automatic install/update reconciliation, and Claude reload behavior. -- [Skill bridge developer guide](guides/dev-guide.md#claude-code-skill-bridge) — path-validation, ownership, clobber-protection, install/update wiring, tests, and Pi/Codex scope notes. +## Administrator documentation -## Fleet configuration management +- [Administrator operations](ADMIN-GUIDE/operations/README.md) — current local procedures and explicitly held outlines. +- [Upgrade safety and recovery](ADMIN-GUIDE/operations/upgrade-safety-and-recovery.md) — installed-CLI/local-PGlite upgrade and framework recovery. +- [Mos connector lease operations](ADMIN-GUIDE/operations/mos-connector-lease-operations.md) — held/non-operative M1 outline while policy remains deny-all. +- [Administrator security](ADMIN-GUIDE/security/README.md) — current security chapter index. +- [SSO providers](ADMIN-GUIDE/security/sso-providers.md) — Authentik, WorkOS, and Keycloak configuration and discovery. +- [Discord ingress security](ADMIN-GUIDE/security/discord-ingress.md) — service authentication, allowlists, bindings, roles, replay, and failure controls. -- [Fleet configuration entry point](fleet/README.md) — desired-versus-observed decision tree and complete operator link map. -- [Desired, derived, and observed state](fleet/concepts/desired-vs-observed-state.md) — roster authority, generation, ownership, and drift. -- [Identity, class, and runtime](fleet/concepts/identity-class-runtime.md) — stable name, display alias, class, runtime, provider, and model separation. -- [Role authority and leases](fleet/concepts/role-authority-and-leases.md) — validator/merge-gate separation and bounded lease authority. -- [Generated launch chain](fleet/concepts/generated-env-launch-chain.md) — strict data parsing, precedence, and quarantine. -- [Roster v2 structural contract](fleet/reference/roster-v2-fields.md) — schema, supported values, required fields, defaults, and constraints. -- [Fleet CLI reference](fleet/reference/cli.md) — local desired-state commands, JSON/exit behavior, and gateway-catalog separation. -- [Lifecycle transitions](fleet/reference/lifecycle-transitions.md) — create/apply/reboot/migration/rollback boundaries. -- [Status and drift](fleet/reference/status-and-drift.md) — desired/managed/observed state and current/future classifications. -- [Safe agent CRUD](fleet/how-to/create-update-delete-agent.md) — expected generation, dry-run, and partial-failure recovery. -- [Local lifecycle operations](fleet/how-to/start-stop-restart.md) — persisted versus one-shot actions. -- [Configurable interaction instance](fleet/how-to/configure-tess-interaction.md) and [validator instance](fleet/how-to/configure-ultron-validator.md) — generic identities and protected limits. -- [Reconcile and recover](fleet/operations/reconcile-and-recover.md) — plan/apply lock and recovery behavior. -- [Environment quarantine](fleet/operations/env-quarantine.md) — private evidence and value-free diagnostics. -- [Systemd/tmux troubleshooting](fleet/operations/systemd-tmux-troubleshooting.md) — socket, holder, unmanaged-session, and lock decisions. -- [Backup/restore boundary](fleet/operations/backup-restore.md) and [upgrade-assets hold](fleet/operations/upgrade-assets.md). -- [v1-to-v2 migration preview](fleet/migration/v1-to-v2.md) and [executable artifact dispositions](fleet/migration/example-profile-disposition.md). -- [FCM M5 closure evidence](reports/documentation/758-fleet-config-ia-closure.md) and [approved deferrals](reports/deferred/758-fleet-config-deferrals.md). +## Developer documentation -## Official channel plugins +- [Architecture index](DEVELOPER-GUIDE/architecture/README.md) — current architecture contracts, decisions, and draft RFCs. +- [Channel protocol](DEVELOPER-GUIDE/architecture/channel-protocol.md) — shared DTOs and current Discord compatibility boundary; future adapters are draft. +- [Lease-broker protocol](DEVELOPER-GUIDE/architecture/lease-broker-protocol.md) — authenticated Unix-socket protocol and persistence boundary. +- [Lease-broker security](DEVELOPER-GUIDE/architecture/lease-broker-security.md) — identity, ancestry, filesystem, observer, and residual boundaries. +- [Whole mutator-class gate](DEVELOPER-GUIDE/architecture/mutator-class-gate.md) — default-deny tool authorization and launch choke point. +- [Compaction revocation](DEVELOPER-GUIDE/architecture/compaction-revocation.md) — lifecycle observers, generation fencing, and residual stale window. +- [Architecture decisions](DEVELOPER-GUIDE/architecture/decisions/README.md) — implemented and accepted boundaries. +- [Mos runtime portability M1](DEVELOPER-GUIDE/architecture/decisions/mos-runtime-portability-m1.md) — logical identity, connector lease, grants, audit, and fencing. +- [Architecture RFCs](DEVELOPER-GUIDE/architecture/rfcs/README.md) — draft proposals without operational authority. +- [Optional AI egress gateways](DEVELOPER-GUIDE/architecture/rfcs/optional-ai-egress-gateways.md) — draft proposal; LiteLLM and Bifrost are not integrated. +- [Lease-broker operations and verification](DEVELOPER-GUIDE/testing/lease-broker-operations.md) — safe static/test workflow; live procedures remain held. +- [Channel adapter authoring](DEVELOPER-GUIDE/integrations/channel-adapters.md) — current shared contract and Discord reference boundary. -- [Channel protocol architecture](DEVELOPER-GUIDE/architecture/channel-protocol.md) — shared lifecycle, message, stable-route, authorization, and response-target contracts; future adapters are explicitly draft. -- [Discord administrator configuration](ADMIN-GUIDE/security/discord-ingress.md) — secrets, allowlists, bindings, role policy, and thread permissions. -- [Discord user workflow](USER-GUIDE/workflows/discord-conversations.md) — in-channel messages, mention-created threads, and runtime-transparent continuity. -- [Channel plugin authoring](DEVELOPER-GUIDE/integrations/channel-adapters.md) — current shared contract and requirements for future adapters. -- [Discord package guide](../plugins/discord/README.md) — package behavior, configuration shape, and development commands. +## API transition -## Native Kanban and canonical task SOT +- [API index](API/README.md) — consolidated gateway contract remains planned. +- [Legacy Tess-scoped OpenAPI contract](openapi-tess.yaml) — valid OpenAPI 3.1 artifact with incomplete gateway coverage; canonical scope requires maintainer approval. -- [Canonical requirements](requirements/native-kanban-sot.md) — ratified P0–P3 requirements and acceptance criteria. -- [Workstream index](native-kanban-sot/INDEX.md) — artifact map, lane partition, and delivery order. -- [Mission manifest](native-kanban-sot/MISSION-MANIFEST.md) — scope, authority, invariants, and gate model. -- [Task decomposition](native-kanban-sot/TASKS.md) — dependency-ordered implementation slices and ownership boundaries. -- [KBN-101 database role split](native-kanban-sot/KBN-101-DB-ROLE-SPLIT.md) — rc.16 direct-Drizzle storage-wrapper hold: legacy N-1/uncertified/non-operative pending -02/-03/-06/-08; exact README/user-guide wrapper forms fail before masking and source-consistency rejects runner-delegation copy; held bootstrap → TLS/roles → run → verify → readiness; plus prior attestation, pgvector owner, classifier, TLS, activation, and certification prerequisite. -- [Federated tier data migration](guides/migrate-tier.md) — active KBN-101-07 operator route: runner-produced target attestation, dedicated non-DDL importer, and paired credential-/attestation-file references only. -- [Frozen shared contract](native-kanban-sot/SHARED-CONTRACT.md) — schema, API, Coordinator, health, recovery, and migration contracts. -- [KBN-101 exact-head security review](reports/native-kanban-sot/kbn-101-contract-security-review-82ce325.md) — retained prior REQUEST CHANGES evidence for `da742ca`; rc.16 awaits independent exact-head re-review after closing the current generic storage-wrapper authority HIGH finding. -- [Initial independent review](reports/native-kanban-sot/canon-initial-review-no-go.md) — KCR-001–016 findings that blocked the first draft. -- [Final independent re-review](reports/native-kanban-sot/canon-final-rereview-go.md) — closure evidence and GO verdict. -- [Ultron final gate](reports/native-kanban-sot/ultron-final-go.md) — final requirements, authority, schema, migration, recovery, and evidence review. +## Evidence and planning -## Tess interaction agent +- [Reports index](reports/README.md) — all tracked report categories and evidence boundaries. +- [P8-003 performance report](reports/qa/p8-003-performance-optimization.md) — historical implementation evidence, not a current SLO. +- [Documentation information-architecture design](plans/2026-08-10-docs-information-architecture-design.md) — approved documentation structure decision. +- [Documentation catalog-audit plan](plans/2026-08-10-docs-catalog-audit.md) — evidence method and migration acceptance criteria. +- [Documentation migration scratchpad](scratchpads/DOCS-IA-002-catalog-audit.md) — coordinator progress, verification, and resumability record. -### Operator guides +## Authority-gated migration backlog -- [User guide](tess/USER-GUIDE.md) — authorized session, attach, send, stop, and handoff workflows. -- [Admin guide](tess/ADMIN-GUIDE.md) — deployment configuration, policy, and approval controls. -- [Developer guide](tess/DEVELOPER-GUIDE.md) — provider contracts, scope boundaries, and test workflow. -- [Plugin guide](tess/PLUGIN-GUIDE.md) — adapter, redaction, and identity-as-data requirements. -- [Operations guide](tess/OPERATIONS-GUIDE.md) — readiness, recovery, and incident-safe procedures. +The complete file-level backlog remains in the [documentation catalog](reports/documentation/2026-08-10-docs-catalog-audit.md). The groups below are intentionally not linked as current pages: -### Architecture and security +- **Fleet configuration:** quarantined pages have executable source/test consumers and require a coordinated path, authority, and test migration. +- **Federation:** active-versus-historical workstream status and normative authority require maintainer/orchestrator confirmation. +- **Native Kanban/KBN-101:** requirements, task state, reports, and held PostgreSQL procedures require product-owner and orchestrator decisions. +- **Tess:** mixed user, administrator, developer, migration, qualification, and API material requires audience splitting and a decision on active versus historical status. +- **Gateway API:** the Tess-scoped OpenAPI artifact must not be renamed into the canonical full-gateway contract until scope, authentication, errors, schemas, and transport coverage are approved. +- **Deployment and tier migration:** PostgreSQL, federated, bare-metal, Compose, Gateway/Web activation, and migration-runner procedures remain held under the repository safety policy. +- **Mixed legacy guides and scratchpads:** promote only evidence-backed current facts; retain the rest as historical artifacts. -- [Architecture](tess/ARCHITECTURE.md) -- [Threat model](tess/THREAT-MODEL.md) -- [Mos coordination boundary](tess/MOS-COORDINATION.md) -- [Hermes runtime adapter design](tess/hermes-runtime-adapter-design.md) -- [Operator plugin sketch](tess/M4-003-OPERATOR-PLUGIN-SKETCH.md) - -### API contract - -- [Tess OpenAPI contract](openapi-tess.yaml) - -### Migration and qualification - -- [Migration inventory](tess/M5-MIGRATION-INVENTORY.md) -- [Cutover procedure](tess/M5-MIGRATION-CUTOVER.md) -- [Rollback procedure](tess/M5-MIGRATION-ROLLBACK.md) -- [Retention and deprecation evidence](tess/M5-MIGRATION-RETENTION-DEPRECATION.md) -- [Verification matrix](tess/VERIFICATION-MATRIX.md) -- [Documentation checklist](tess/M5-003-DOCUMENTATION-CHECKLIST.md) -- [Independent Option 2 runtime-portability qualification (2026-07-14)](tess/qualification/2026-07-14-option2-runtime-portability.md) - -## Runtime-neutral Mos portability - -- [Optional AI egress gateway RFC](DEVELOPER-GUIDE/architecture/rfcs/optional-ai-egress-gateways.md) — draft placement and gates for LiteLLM, Bifrost, and translation proxies; no candidate is integrated. -- [Runtime-neutral Mos identity and failover mission](https://git.mosaicstack.dev/mosaicstack/stack/issues/754) -- [Logical identity and connector lease/fencing implementation](https://git.mosaicstack.dev/mosaicstack/stack/issues/755) -- [M1 logical identity and fencing architecture](DEVELOPER-GUIDE/architecture/decisions/mos-runtime-portability-m1.md) -- [M1 connector lease operations](ADMIN-GUIDE/operations/mos-connector-lease-operations.md) — held/non-operative. - -## Comms evolution — Matrix-native MACP (design, draft) - -- [RFC-001 — MACP: a Mosaic-native, Matrix-native comms layer](rfcs/RFC-001-MACP-MATRIX-NATIVE.md) — Synapse + Mosaic appservice backbone, MACP v1 protocol, presence/escalation, federation, strangler migration off the Hermes MCP bridge. -- [RFC-002 — Install, configuration & topology for the Matrix/MACP comms system](rfcs/RFC-002-INSTALL-CONFIG-TOPOLOGY.md) — open-source install topology modes, ACME cert provisioning, pluggable secret backend, and config precedence. +`docs/_old_structure/` remains read-only migration quarantine. It is not current navigation and must not be used as command authority. diff --git a/docs/scratchpads/DOCS-IA-002-catalog-audit.md b/docs/scratchpads/DOCS-IA-002-catalog-audit.md index 8c3fbd55..d4a7a260 100644 --- a/docs/scratchpads/DOCS-IA-002-catalog-audit.md +++ b/docs/scratchpads/DOCS-IA-002-catalog-audit.md @@ -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` |