wiki-stage-commit

1# Wiki Stage Commit — Staged Write Promotion
2 
3You are reviewing LLM-written pages that are waiting in `_staging/` for human approval before they land in the live wiki. This skill is only useful when `WIKI_STAGED_WRITES=true` in the vault config.
4 
5## Before You Start
6 
71. **Resolve config** — follow the Config Resolution Protocol in `llm-wiki/SKILL.md`. This gives `OBSIDIAN_VAULT_PATH` and `WIKI_STAGED_WRITES`.
82. If `WIKI_STAGED_WRITES` is not set or is `false`, tell the user: "Staged writes mode is not enabled. Set `WIKI_STAGED_WRITES=true` in your `.env` to use this feature." Then stop.
93. Read the `_staging/` directory inventory.
10 
11## Invocation Forms
12 
13```
14/wiki-stage-commit               # interactive review: show each file and ask accept/reject
15/wiki-stage-commit --all         # accept all staged files without per-file review
16/wiki-stage-commit --reject-all  # reject all staged files (move to _raw/ for manual editing)
17/wiki-stage-commit --list        # list staged files with summary, no changes
18```
19 
20## Step 1: Inventory Staged Files
21 
22The CLI owns the inventory — don't glob `_staging/` yourself:
23 
24```bash
25obsidian-wiki staging list --json
26```
27 
28Each entry carries:
29 
30| Field | Meaning |
31|---|---|
32| `staged_path` | vault-relative path of the staged file |
33| `live_path` | where it will land (a `.patch.md` targets the page it is named after) |
34| `kind` | `new`, `update`, or `patch` |
35| `staged_revision` | content hash of the staged file, as you are seeing it now |
36…