wiki-finalize-drafts

name	wiki-finalize-drafts
description	Review stale draft wiki pages and finalize them — fix missing citations, run validator, commit
triggers	["wiki-finalize-drafts","wiki finalize-drafts"]

What This Does

Surfaces stale draft pages, identifies what's blocking finalization (missing citations, failing validator), fixes the blockers, and runs wiki finalize.

Reference conventions: WIKI.md § 8 (draft lifecycle), § 12.2 lint check stale-drafts.

Usage

/wiki-finalize-drafts                  # Review all stale drafts
/wiki-finalize-drafts wiki/synthesis/foo.md   # Target one page

Execution Steps

1. Find drafts: Run wiki lint --scope stale-drafts to list pages with draft: true older than 7 days.

2. Prioritize: For each draft, classify:

   • Cat A — has ## Sources cited section with [[sources/...]] links → ready to finalize
   • Cat B — has claims but no citations → needs cite-suggest
   • Cat C — stub content → flag for user decision (finalize or abandon)

3. Cat A — finalize directly:

   .venv/bin/wiki finalize wiki/<type>/<slug>.md
   

4. Cat B — add citations first: Run /wiki-cite wiki/<type>/<slug>.md (or use wiki cite-add) to surface citation candidates. Then finalize.

5. Cat C — present to user: Show the slug and ask: finalize as-is, abandon, or skip? To abandon: .venv/bin/wiki finalize wiki/<type>/<slug>.md --abandon

6. Report: State how many pages were finalized, abandoned, skipped.

Key constraints

• Never modify page body via direct Edit for citation purposes — use wiki cite or wiki cite-add.
• wiki finalize will fail if citation grounding is not met; fix citations, don't force.
• draft: true in frontmatter is the only authoritative source of draft status.