deep-wiki

Body-generation worker for A5 page-level fanout. Receives one page_plan entry with pre-captured existing_page_body bytes, emits one page_content draft. Invoked by /wiki-ingest in single-source A5 fanout mode (page_plan ≥ a5_fanout_threshold).

Stage 1 of single-source A5 page-fanout (v1.4.0+). Reads source + candidate pages, decides create-vs-update per topic, emits a `page_plan` (with `inline_bodies` for sub-threshold cases). DOES NOT write or version pages — main owns Stage 3 atomic-write under lock. Invoked by /wiki-ingest Step 7.5 single-source branch.

Dormant in v1.4.x+; preserved for future restoration of v1.3.0 single-source byte-identical inline path. Reads source + candidate pages, decides create-vs-update, version-backs-up under .wiki-meta/.versions/, atomic-writes pages under <wiki_root>/pages/, returns manifest. NO active caller in v1.4.x+ (skills/wiki-ingest/SKILL.md Step 7.5 routes to wiki-synthesizer-analysis instead).

Multi-source A4 fanout worker (v1.3.0+). Reads one source-shard + cross-page candidates, decides create/update/skip per topic, emits structured `drafts[]` for main session to aggregate + atomic-write under the global lock during Phase 3. Also handles second-pass cross-worker collision merge via `colliding_drafts` input. Invoked by /wiki-ingest Step 7.5.M-A (per-shard) and Step 7.5.M-B Case B2 (collision second-pass).

Use when the user wants to inspect the deep-wiki for health issues — orphan pages, broken inter-page links, schema violations, contradictions, stale content, missing source provenance YAML, `pages_created` exactly-once invariant breaks, and `.last-scan` monotonicity violations. Triggers on `/wiki-lint`, "lint wiki", "check wiki health", "wiki status", "wiki audit", "wiki diagnose", "wiki dashboard", "위키 린트", "위키 점검", "위키 상태", "위키 헬스체크", "위키 무결성". Accepts an optional `--fix` flag that auto-repairs the auto-fixable subset (broken links, orphan removal, sources/ slug normalization) while leaving audit-only items in the dashboard.

Use when the user wants to ask a question against the deep-wiki and get an answer grounded in the accumulated knowledge — searching pages, reading their bodies, and (when the answer is novel cross-page synthesis) auto-filing the answer back into the wiki as a new page via the `query-filed` lifecycle action. Triggers on `/wiki-query`, "ask the wiki", "wiki query", "search the wiki", "ask wiki", "위키 질의", "위키 검색", "위키에서 찾기", "위키에 물어보기", "위키 답변". The question string is passed as the sole argument.

Use when the user wants to regenerate derived wiki artifacts (M3-envelope-wrapped `.wiki-meta/index.json`) from the source-of-truth page frontmatter — used when the index is suspected stale, corrupted, or drifted relative to actual page files. Triggers on `/wiki-rebuild`, "rebuild wiki index", "regenerate index", "rebuild wiki", "wiki reindex", "wiki rebuild", "위키 인덱스 재생성", "위키 재빌드", "위키 인덱스 복구", "wiki 재구성". Takes no arguments; always acquires the wiki lock and emits a `rebuild` lifecycle event to `log.jsonl`.

Defines schema, invariants, and lifecycle rules for any deep-wiki knowledge base operation. Activate whenever wiki pages or metadata are read, created, modified, or validated — specifically during /wiki-ingest, /wiki-query (including auto-filing of cross-page synthesis), /wiki-lint, /wiki-rebuild, /wiki-setup, page frontmatter validation, source provenance tracking, or any direct manipulation of pages/, index.json, log.jsonl, sources/, or .versions/ under a wiki root. Covers required frontmatter fields, kebab-case naming, markdown link conventions, source provenance YAML, M3-envelope-wrapped index.json catalog, append-only log.jsonl event log with 10 lifecycle actions (ingest, ingest-skip, ingest-repair, ingest-fail, update, lint, rebuild, delete, query-filed, setup), mkdir-based concurrency locking, page versioning, and the 4 critical invariants (pages_created exactly-once, .last-scan monotonicity, lock atomicity, source provenance correspondence).

Use when the user wants to initialize the deep-wiki knowledge base for first use — creating the wiki root directory, the config file at `~/.claude/deep-wiki-config.yaml`, the initial directory structure (`pages/`, `.wiki-meta/`), and a seed `welcome.md` page. Triggers on `/wiki-setup`, "init wiki", "set up wiki", "scaffold wiki", "create wiki", "wiki bootstrap", "위키 초기화", "위키 셋업", "위키 설정", "위키 만들기", "위키 시작". Accepts an optional `<wiki_root_path>` argument; otherwise prompts the user via AskUserQuestion (option A — inside an Obsidian vault, option B — standalone directory). Windows users must supply a POSIX form path (`/c/...` or `/mnt/c/...`).

1 hook across 1 event