wiki-query

# Wiki Query FTS5 BM25 retrieval over wiki pages indexed by `wiki-builder`. ## When to use - Before writing any new wiki page → check coverage first - User asks a domain question that may already live in a wiki - "Ask the <slug> wiki: <question>" - Verifying citations before quoting a claim - `SessionStart` auto-load when prompt matches a known wiki topic ## Commands ``` node $SKILL_ROOT/scripts/query.js search "<query>" [--wiki <slug>] [--limit 10] [--json] node $SKILL_ROOT/scripts/query.js related <slug> <rel-path> [--limit 5] node $SKILL_ROOT/scripts/query.js show <slug> <rel-path> ``` `search` with no `--wiki` ranks across all wikis. `related` finds adjacent pages by reusing the page's title + summary as the query. ## Output JSON-friendly. Each hit: ``` { "page_id": 12, "wiki_slug": "agent-memory", "rel_path": "wiki/concepts/episodic-memory.md", "title": "Episodic Memory", "snippet": "... [time-stamped] traces, distinct from semantic ...", "rank": -3.21 } ``` Lower (more negative) rank = better BM25 match. ## Citing back Every wiki hit must be cited as: ``` [wiki:<slug>] <title> — `<rel_path>` ``` Do not paraphrase a hit without showing the source. ## SessionStart integration When `pro-workflow`'s SessionStart hook detects wiki-relevant terms in the user prompt, it runs `query.js search "<prompt>" --limit 3` and injects top hits into the session as a hint: ``` [wiki-query] 3 relevant pages: - agent-memory · wiki/concepts/episodic-memory.md - agent-memory · wiki/papers/park-2023-generative-agents.md - ... ``` Helps Claude recall existing knowledge instead of redoing research. ## Limits (Phase 3.3.0) - BM25 only. Vector search arrives 3.3.2 with sqlite-vec. - No re-ranking. MMR diversity arrives with the research loop in 3.3.1. - Snippet window is 16 tokens around match — tune via `--snippet-len`.