docs(10/10): enforce the topics-only tree and remove JS doc shims

[flyingrobots]

Decision

Finish the reconstruction with one canonical documentation topology and one Rust-native truth gate. Transitional JavaScript parity checks and dead workspace/documentation scripts are removed only after native coverage proves equivalence or stronger behavior.

This is documentation reconstruction slice 10 of 10.

Scope

• Make docs/truth-manifest.json an exact, deterministic map of the public root README.md plus tracked docs/topics/**/*.md.
• Add a topology invariant: reader-facing Markdown inside docs/ must live under docs/topics/. Permit only explicitly required machine metadata/assets outside it.
• Remove every temporary migration allowlist.
• Make cargo xtask docs-check the sole implementation for link targets and anchors, native command/flag truth, pnpm package/script truth, current path claims, release-language truth, manifest coverage, and topics-only topology.
• Replace the JavaScript docs workflow with the Rust-native gate, then delete duplicate/dead shims such as:
  • scripts/check-doc-links.mjs
  • scripts/check-doc-truth.mjs
  • scripts/check-doc-cli-commands.mjs
  • their dedicated parity tests and preflight hooks
  • the broken tasks:update script and scripts/tasks-update.mjs
  • stale pnpm workspace entries that match no package
• Update root entrances, CI path filters, package scripts, contributor guidance, release guards, and topic navigation to the final paths.

Keep live JavaScript with an explicit owner—especially packages/wesley-holmes and necessary repository automation. This is removal of dead docs-era duplication, not a blanket language purge.

RED

Add final fixtures that fail on: any non-topic Markdown under docs/, an unmanifested topic, a manifest entry without a topic, an audit sidecar, a missing anchor, a stale command/flag, a zero-match pnpm filter, and a deleted JS-check reference.

Acceptance

• The root product entrance and topic tree provide complete current navigation.
• No reader-facing Markdown remains under docs/ outside docs/topics/.
• No *.audit.md sidecar, duplicate docs shell, historical attic, or JavaScript docs checker remains.
• The truth manifest and tracked topic Markdown are bijective.
• Pages/navigation, docs workflow, cargo test --locked -p xtask, all relevant Bats suites, cargo xtask docs-check, full pnpm run preflight, and git diff --check pass.
• A final repository search finds no references to deleted paths or scripts.
• The campaign closes only when all ten issues are green and the final PR has no unresolved review threads.

Scheduling

• Ordered after docs(9/10): delete historical packets and generated audit sludge #751.
• Blocked by refactor(governance): replace goalposts with version milestones #742 and all prior documentation-reconstruction slices.
• The v0.3.0 label is temporary until the plain version-milestone cutover.

[coderabbitai]

🔗 Related PRs

#657 - docs(release): adapt lifecycle runbook [merged]
#686 - docs: add plain Wesley onboarding path [merged]
#687 - docs: publish assurance capability matrix [merged]
#692 - docs: add first contributor fast paths [merged]
#741 - Add IR-to-Brainfuck extension generator example [open]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[flyingrobots]

Midpoint topology addendum\n\nThis final slice explicitly owns docs/reference/cli.md, the sole remaining reader-facing Markdown file outside docs/topics/ that is not naturally assigned to slices 6 through 9. Before deleting it, migrate any unique reader guidance into docs/topics/native-cli.md or the owning task topic, retarget every inbound link, remove its truth-manifest entry, and prove native help remains the executable command authority.\n\nCampaign accounting correction: scripts/check-doc-cli-commands.mjs, its dedicated test, and its legacy-preflight hook were already retired in commit 1bdfeb92 after the stronger Rust-native gate landed. That happened earlier than #744 scheduled. Do not recreate the dead checker merely to delete it here; instead, make the final absence/reference and semantic-equivalence fixtures prove the intended terminal state.