Publish manifest and wiki mapping recorded #12

New issue

Closed

opened 2026-10-06 10:13:28 +00:00 by pit · 0 comments

pit commented

2026-10-06 10:13:28 +00:00

Owner

Part of #7

What to build

Make the publish decision explicit per document. A manifest that lives in the repo — not in the sync script — lists what reaches the wiki, with allowlist semantics, so a new, renamed or moved document cannot silently reach the wiki without a decision. Record the wiki page mapping against the wiki-sync work.

Acceptance criteria

A publish manifest lives in the repo, is allowlist by default (a document is published only if listed, or explicitly excluded), and carries the exclusions.
A coverage check fails when a document is neither published nor excluded, so changing the docs forces a publish decision. Running it shows it pass when covered and fail when not.
The page mapping is recorded (docs entry point to Home, architecture, runbooks index and pages as numbered runbook pages, decisions index and pages as numbered ADR pages, actions index, glossary), with the agent docs excluded and mirror semantics preserved.
The mapping change and the collision between the two decisions numbered 0001 are recorded on the wiki-sync issue; no sync, hook or workflow is built here.
Lands as its own PR.

Blocked by

Part of #7 ## What to build Make the publish decision explicit per document. A manifest that lives in the repo — not in the sync script — lists what reaches the wiki, with allowlist semantics, so a new, renamed or moved document cannot silently reach the wiki without a decision. Record the wiki page mapping against the wiki-sync work. ## Acceptance criteria - [ ] A publish manifest lives in the repo, is allowlist by default (a document is published only if listed, or explicitly excluded), and carries the exclusions. - [ ] A coverage check fails when a document is neither published nor excluded, so changing the docs forces a publish decision. Running it shows it pass when covered and fail when not. - [ ] The page mapping is recorded (docs entry point to Home, architecture, runbooks index and pages as numbered runbook pages, decisions index and pages as numbered ADR pages, actions index, glossary), with the agent docs excluded and mirror semantics preserved. - [ ] The mapping change and the collision between the two decisions numbered 0001 are recorded on the wiki-sync issue; no sync, hook or workflow is built here. - [ ] Lands as its own PR. ## Blocked by - #8

pit added the

ready-for-agent

label

2026-10-06 10:13:39 +00:00

pit referenced this issue

2026-10-06 10:44:11 +00:00

docs: add the docs tree — entry point, architecture, runbooks, ADRs, glossary, license #13

pit referenced this issue

2026-10-06 10:44:38 +00:00

Docs tree lands: entry point, architecture, runbooks, ADRs, glossary, license #8

pit referenced this issue from a commit

2026-10-06 12:03:04 +00:00