docs: absolute wiki links, a current Home, and the service manifest as it now is
Three things, all of which made the published wiki disagree with reality.
Links: 160 relative targets across 27 pages resolved to raw.githubusercontent.com instead of the
wiki page, because the wiki flattens directories (guides/beads.md -> /wiki/beads). Rewritten
mechanically by `mise run docs`; all 62 distinct URLs verified 200.
Home: called docs/ a "git submodule" and told the reader to bump a pointer that does not exist --
it is an unpinned live clone, refreshed with `git -C docs pull`. Its guide list was also missing six
guides that have shipped since (extending-stacks, recipe-catalog, system-prompt, beads, pulumi,
git-hooks); the sidebar was missing container-filesystem.
service-authoring: documented 5 of the manifest's 12 fields and marked `port` required when the
schema requires only name and image -- a service on a unix socket has no port at all. Adds scope,
publish, socket, client_env, data, exclusive_lock and sync, including what `publish: stable` buys
over `ephemeral`: a port that survives a reboot is what lets the PROJECT hold its own client config
instead of that config existing only inside a harnessed process.
Not fixed here: 7 links point at catalog paths that no longer exist (beads-team/ became beads/team/,
claude_openbrain-example became openbrain-example, and the omp/claude_time/gstack stacks are gone).
Those need prose judgment about intent, so the tool reports them rather than guessing.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs: reconcile maps + roadmap with source (Phase 5 review fixes)
Corrects accuracy defects found in the Phase 5 independent review, each
filed as a bd issue:
- ROADMAP: 15 -> 16 recipes (add repowise); mark main-2nu done (PR #24
merged); scan.py "cbm-verified" -> source-verified (main-1gl)
- STACK.md: fix harnessed-tools subcommand list to match cli.py
(assemble/test/scan/scan-image/scan-image-online/scan-snyk-container/
persist-list/persist-prune); note only claude+omp launchable (main-7yv.1)
- CONCERNS.md: drop void M-5 (both entries now committed); refresh H-1
line/function count; replace drifted launcher.py line citations with
drift-proof symbol refs; point docs/todos refs at bd main-5ki (main-7yv.2)
- INTEGRATIONS.md + ARCHITECTURE.md: mark gemini/codex/opencode/antigravity
planned-unmerged (bd main-9sv); flag serena not capability-verified
(main-7yv.3)
- recipe-catalog.md: add repowise; remove unmerged headroom from a
copy-paste stack; fix superpowers naming note (main-mya)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs: refresh codebase maps, roadmap, and retire todos/ dir
- regenerate codebase/*.md (ARCHITECTURE, STRUCTURE, CONVENTIONS,
INTEGRATIONS, STACK, TESTING, CONCERNS)
- promote todos/ROADMAP.md -> ROADMAP.md
- retire docs/todos/: resolved specs -> done/, reference research -> research/,
obsolete dated dumps removed (dispositions filed as bd issues)
- update Home/_Sidebar, guides (recipe-authoring, recipe-catalog, system-prompt),
harnessed-design, research/*, prompts/ultra-detailed-design-review
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>