XCSV-REFACTOR-DOCS-001: documentation front door and wiki IA - #42
Conversation
Rewrite the XCSV README and wiki Home as concise repository front doors, strengthen architecture around source/deployment/runtime evidence boundaries, and add durable map-editing and drone/counter-UAS documentation surfaces. Regenerate docs/wiki from canonical wiki source, add generated-output markers, and add local documentation link/drift checks for this documentation lane. XCSV-Agent: codex XCSV-Agent-Role: primary XCSV-Work-ID: XCSV-REFACTOR-DOCS-001 XCSV-Contract: 1.0.0
|
Independent review — XCSV-REFACTOR-DOCS-001 / PR #42 Verdict: CHANGES_REQUIRED before merge. The candidate is substantially stronger visually and structurally, but three issue-#31 acceptance conditions remain unmet.
Required correction is documentation-only. Preserve the strong README/AI bootstrap/Home/IA/generated-marker/link/drift work already present. Do not broaden into #37 CI, gameplay/runtime mutation, member-repo writes, or live verification. PR #42 remains draft/unmerged pending independent review. |
Move legacy Roadmap execution/status material into an explicitly historical canonical page, replace Roadmap with durable planning direction, remove duplicated manual inventory counters from front doors, and preserve local-model, override, anti-cheat and extDB historical lessons without making them current runtime truth. XCSV-Agent: codex XCSV-Agent-Role: primary XCSV-Work-ID: XCSV-REFACTOR-DOCS-001 XCSV-Contract: 1.0.0
|
Correction receipt for independent review comments Candidate: Implemented only the requested documentation-authority correction. Corrections:
Regenerated:
Focused validation passed:
Preserved boundaries:
PR #42 remains draft/unmerged for independent review. |
|
INDEPENDENT REVIEW — REQUEST_CHANGES_CI_GATE_DRIFT Candidate reviewed: The documentation-authority corrections themselves are sound: Roadmap is now concise planning-only, legacy roadmap/status material is preserved in BLOCKER: GitHub Actions is red on the exact PR head. Workflow: The existing workflow requires the literal marker Required narrow correction:
Do not merge PR #42 while CI is failing. No other documentation blocker identified in this review slice. |
Restore the current Roadmap's AI / AGENT ROADMAP GATE marker without reintroducing legacy status/runtime content. Regenerate Roadmap and Memory projections from canonical wiki source. XCSV-Agent: codex XCSV-Agent-Role: primary XCSV-Work-ID: XCSV-REFACTOR-DOCS-001 XCSV-Contract: 1.0.0
Declare Home documentation state as UNKNOWN for the existing AI contract gate without claiming wiki or Pages synchronization. XCSV-Agent: codex XCSV-Agent-Role: primary XCSV-Work-ID: XCSV-REFACTOR-DOCS-001 XCSV-Contract: 1.0.0
|
XCSV-REFACTOR-DOCS-001 CI contract-drift correction receipt PR: #42 Narrow correction performed:
Generated outputs:
Local validation passed:
GitHub Actions evidence:
Completion impact:
PR #42 remains draft/open/unmerged for independent review. |
Record post-merge observations for PR #42, merged main, canonical local checkout, GitHub Wiki, and GitHub Pages without storing standing CURRENT claims. XCSV-Agent: codex XCSV-Agent-Role: primary XCSV-Work-ID: XCSV-REFACTOR-DOCS-001 XCSV-Contract: 1.0.0
|
XCSV-REFACTOR-DOCS-001 final merge/publication/reconciliation receipt PR: #42 Merge transaction:
GitHub Actions evidence:
Post-merge validation on isolated worktree
GitHub Wiki:
GitHub Pages:
Canonical
Observation/freshness record:
Cold rehydration:
Completion impact:
Stopping for independent review. Issue #31 documentation modernization is merged/published, but this does not close #30 live/runtime evidence or #37 durable guardrail work, and it does not claim global XCSV modernization complete. |
XCSV-REFACTOR-DOCS-001 / Issue #31
Mode: DOCUMENT / CONSOLIDATE / GENERATE / VERIFY.
Final accepted candidate:
dba49ae7a905bee631cdd9f412f8e09b7346dc1f.Independent review verdict:
PASS_DOCS_REFACTOR_CANDIDATE.GitHub Actions verification:
XCSV AI contract drift32450185772Verify XCSV-AI-CONTRACT 1.0.0: PASSSync policy regression suite: PASSPrior candidate trajectory preserved:
f464fcfbcfd68f95bcad186db83763d27ce4d716: initial documentation modernization candidate.90e54a871906f0d1a2152f32e4d06d818e66b173: documentation-authority correction after review comments5365439593/5365440652.910d4c4929e1e9e9cafe2888006cdfb55199addd: restored current Roadmap AI gate marker; exposed remaining Home documentation-state assertion.dba49ae7a905bee631cdd9f412f8e09b7346dc1f: final candidate with AI gate and documentation-state contract green.Scope
AI / AGENT START HERE, ownership/non-ownership boundaries, source-observation posture, architecture overview, repository-family map, navigation, entrypoints, and security/provenance posture.AI-START-HERE.mdas a provider-neutral bootstrap route.wiki/Home.mdas a compact human/AI orientation page and declares conservative documentation stateUNKNOWNfor the existing AI contract.wiki/Architecture.mdaround ownership topology, canonical source vs generated docs vs deployment mirror vs runtime/historical evidence, critical integration seams, local-model trust boundary, and override collision risk.wiki/Roadmap.mdwith a concise durable planning/issue-routing surface.AI / AGENT ROADMAP GATEin currentwiki/Roadmap.mdwithout restoring stale execution/status material.wiki/Roadmap-History.md, visibly labeledHISTORICAL EVIDENCE / NOT CURRENT EXECUTION AUTHORITY / DATED CLAIMS REQUIRE REVERIFICATION.registry/components.jsonandSystem Components.wiki/Custom-Map-Editing.mdandwiki/Drone-and-Counter-UAS.mdpages._Sidebar.mdto the target information architecture without adding Roadmap History to primary navigation.docs/wiki/*throughtools/build-docs.ps1.tools/check-doc-links.ps1andtools/check-docs-generated.ps1.docs/wiki/*fromwiki/and refresheswiki/Memory-Index.md/docs/wiki/Memory-Index.md.No gameplay/runtime/member-repository source was modified.
Evidence Boundaries Preserved
PARTIAL_INVENTORY / PARTIAL_SOURCE_VERIFIED.registry/components.json/System Components, not README/Home prose.NOT_REVERIFIED/UNKNOWNunless separately inspected.registry/current-state.jsonand the freshness model instead of embedding permanent CURRENT prose.Wiki Page Classification Audit
_Sidebar.md: CURRENT after navigation update.Home.md: CURRENT after rewrite, counter-removal and conservative documentation-state declaration.Architecture.md: CURRENT after rewrite plus restored security/operational invariants.System-Components.md: GENERATED fromregistry/components.json; preserved as authority projection for source inventory.Repositories.md: CURRENT with existing freshness/path caveats; no broad rewrite needed in this slice.Runbook.md: UPDATE_REQUIRED completed with freshness banner and narrowed runtime wording.XM8-Apps.md: UPDATE_REQUIRED completed with freshness banner and source/documented wording.Custom-Map-Editing.md: CURRENT new durable surface.Drone-and-Counter-UAS.md: CURRENT new durable surface.Roadmap.md: CURRENT as concise planning and issue-routing surface with AI Roadmap gate.Roadmap-History.md: HISTORICAL evidence page; not current execution authority.XCSV-GUARD-Development-Plan.md: HISTORICAL / PROGRAMME authority retained; generated projection refreshed only.AI-Start-Here.md: CURRENT canonical deeper contract retained; generated projection refreshed only.AI-Provenance-and-Doc-Sync.md: CURRENT policy retained; generated projection refreshed only.AI-Tooling.md: CURRENT decision record retained; generated projection refreshed only.AI-Continuity.md: HISTORICAL / UPDATE_REQUIRED completed with freshness banner; detailed receipts preserved.Repository-Identity-and-Freshness.md: CURRENT retained; generated projection refreshed only.Memory.md: CURRENT retained; generated projection refreshed only.Memory-Index.md: GENERATED; refreshed bytools/build-memory-index.ps1.Lessons.md: HISTORICAL retained and expanded with preserved architecture/runtime lessons.Validation
Final local validation passed on
dba49ae7a905bee631cdd9f412f8e09b7346dc1f:wiki/Roadmap.mdcontainsAI / AGENT ROADMAP GATEREADME.mdcontainsAI / AGENT START HEREwiki/Home.mdcontainsAI / AGENT START HEREwiki/Home.mddeclares documentation state using an allowed contract state330components)19pages)41files)489entries)2206chunks)Completion Impact
README.md;AI-START-HERE.md; canonicalwiki/*documentation pages listed above; generateddocs/wiki/*;tools/build-docs.ps1;tools/check-doc-links.ps1;tools/check-docs-generated.ps1.Ready for the accepted bounded merge/publication/reconciliation transaction. Do not claim XCSV modernization globally complete; #37 and remaining #30 live/runtime evidence lanes remain separate.