@zosmaai/pi-llm-wiki 0.1.2 → 0.2.0

package/README.md

@@ -1,372 +1,72 @@
-# 🧠 @zosmaai/pi-llm-wiki
+# @zosmaai/pi-llm-wiki
 
-> **Self-maintaining, Obsidian-compatible knowledge base for your pi coding agent.**
-> Following Andrej Karpathy's LLM Wiki pattern — drop in sources, let the LLM build and maintain the wiki.
+[![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
+[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 
-[![Pi Package](https://img.shields.io/badge/pi-package-8B5CF6?style=flat&logo=pinboard)](https://pi.dev/packages)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
-[![Follow Karpathy Pattern](https://img.shields.io/badge/pattern-Karpathy%20LLM%20Wiki-blue)](https://gist.github.com/karpathy/442a6bf555914893e9891c19de94f)
-[![Obsidian Ready](https://img.shields.io/badge/Obsidian-ready-7C3AED?logo=obsidian)](https://obsidian.md)
+Self-maintaining, Obsidian-compatible knowledge base for [pi](https://pi.dev). Following Andrej Karpathy's LLM Wiki pattern.
 
----
-
-## ✨ Features
-
-| Capability        | Description                                                                                                        |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------ |
-| **📥 Ingest**     | Drop any source into `raw/` — the LLM reads, summarizes, extracts entities & concepts, cross-references everything |
-| **🔍 Query**      | Ask questions against a persistent, interlinked knowledge base — not raw chunks                                    |
-| **🧹 Lint**       | Health-check the wiki: contradictions, orphans, missing pages, stale claims, knowledge gaps                        |
-| **🌐 Discover**   | Auto-find new sources from the web based on your topics and known gaps                                             |
-| **🔄 Full Cycle** | `run` = discover → ingest → lint. One command to refresh everything                                                |
-| **⏰ Watch**      | Schedule automatic updates (daily/weekly/hourly) via pi's cron system                                              |
-| **📊 Status**     | Quick dashboard showing wiki size, health, and last activity                                                       |
-| **📓 Digest**     | Daily/weekly summaries of what changed in the wiki                                                                 |
-
-### Two Modes
-
-- **👤 Personal Wiki** — Learning, journaling, book notes, health, goals, reflections
-- **🏢 Company Wiki** — Competitor tracking, market research, customer calls, internal docs, change detection
-
-### Obsidian Integration
-
-Every `[[wikilink]]` the LLM creates becomes a visible connection in Obsidian's graph view. Includes Dataview dashboard, frontmatter for structured queries, and Marp-ready slide decks.
-
-> "The wiki stays maintained because the cost of maintenance is near zero." — Andrej Karpathy
-
----
-
-## 📦 What's Included
-
-```
-@zosmaai/pi-llm-wiki/
-├── 📜 skills/llm-wiki/SKILL.md        ← Core schema: architecture, workflows, conventions
-│   ├── templates/INDEX.md             ← Master catalog template
-│   ├── templates/LOG.md               ← Activity log template
-│   ├── templates/DASHBOARD.md         ← Obsidian Dataview dashboard
-│   ├── templates/config.yaml          ← Default configuration
-│   └── templates/pages/               ← Page templates (entity, concept, source, synthesis)
-├── 🔧 extensions/llm-wiki-tools.ts    ← 5 custom tools for the LLM:
-│   ├── wiki_ingest                    Process new sources and update wiki pages
-│   ├── wiki_status_report             Report wiki health and statistics
-│   ├── wiki_lint_report               Scan for contradictions, orphans, gaps
-│   ├── wiki_discover_sources          Find new source material from the web
-│   └── wiki_watch                     Schedule auto-updates
-└── 💬 prompts/                        ← 8 slash commands:
-    ├── /wiki:init                     Initialize a new wiki
-    ├── /wiki:ingest                   Process new sources
-    ├── /wiki:query                    Ask questions against the wiki
-    ├── /wiki:lint                     Health check
-    ├── /wiki:discover                 Auto-discover sources
-    ├── /wiki:run                      Full cycle (discover → ingest → lint)
-    ├── /wiki:status                   Wiki health overview
-    └── /wiki:digest                   Daily/weekly summary
-```
-
----
-
-## 🚀 Installation
-
-### Prerequisites
-
-- [pi coding agent](https://pi.dev) installed
-- Node.js 20+
-
-### Via npm (recommended)
-
-```bash
-pi install npm:@zosmaai/pi-llm-wiki@latest
-```
-
-### Via git
-
-```bash
-pi install git:github.com/zosmaai/pi-llm-wiki@v0.1.0
-```
-
-### Via local path (development)
-
-```bash
-git clone https://github.com/zosmaai/pi-llm-wiki.git
-pi install ./pi-llm-wiki
-```
-
-### Verify Installation
-
-```bash
-pi list
-# Should show: @zosmaai/pi-llm-wiki
-
-# Check loaded resources:
-pi --list-skills | grep llm-wiki
-pi --list-tools | grep wiki
-# Should show: wiki_ingest, wiki_status_report, wiki_lint_report, wiki_discover_sources, wiki_watch
-```
-
----
-
-## 🎯 Quick Start
-
-### 1️⃣ Initialize a new wiki
+## Install
 
 ```bash
-pi
+pi install npm:@zosmaai/pi-llm-wiki
 ```
 
-Then inside pi:
+## Quick Start
 
 ```
-/wiki:init "AI Engineering"
+/wiki-init "AI Engineering"
 ```
 
-This creates your wiki directory structure and template files.
-
-### 2️⃣ Add your first sources
-
-Drop content into `raw/`:
-
-- Use [Obsidian Web Clipper](https://obsidian.md/clipper) to save articles
-- Save meeting notes, transcripts, or research papers
-- Export Slack threads or email threads
-
-### 3️⃣ Ingest
+Drop sources into `raw/`, then:
 
 ```
-/wiki:ingest
+/wiki-ingest
+/wiki-query What are the key patterns?
 ```
 
-The LLM reads every new source, creates wiki pages, cross-references everything, and builds the index. A single source typically generates 5-15 wiki pages (summary + entities + concepts + cross-refs).
+## What It Does
 
-### 4️⃣ Query
+| Tool                  | Purpose                                       |
+| --------------------- | --------------------------------------------- |
+| `wiki_bootstrap`      | Initialize a new wiki vault                   |
+| `wiki_capture_source` | Capture URL/file/text into immutable packet   |
+| `wiki_ingest`         | Process sources into wiki pages               |
+| `wiki_ensure_page`    | Create entity/concept/synthesis/analysis page |
+| `wiki_search`         | Search the wiki registry                      |
+| `wiki_lint`           | Health check (orphans, gaps, contradictions)  |
+| `wiki_status`         | Stats dashboard                               |
+| `wiki_rebuild_meta`   | Force metadata rebuild                        |
+| `wiki_log_event`      | Record custom event                           |
+| `wiki_watch`          | Schedule auto-updates                         |
 
-```
-/wiki:query What are the key patterns in modern AI engineering?
-```
-
-The LLM answers from your wiki, not from general knowledge — giving you answers grounded in your curated sources.
+## Architecture
 
-### 5️⃣ Keep it fresh
-
-```bash
-# Auto-update daily at 8 AM
-/wiki:run --schedule daily
+Four layers with clear ownership:
 
-# Or run manually anytime
-/wiki:run
 ```
-
----
-
-## 🏗️ Architecture
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/master/assets/screenshot.png" alt="LLM Wiki Architecture" width="90%">
-</p>
-
-<p align="center">
-  <em>Three-layer architecture: raw sources → LLM-managed wiki → Obsidian frontend</em>
-</p>
-
-The LLM Wiki follows a three-layer architecture:
-
+raw/sources/SRC-*/     # Immutable source packets (extension-owned)
+wiki/                   # Editable knowledge pages (you + LLM)
+meta/                   # Auto-generated registry, backlinks, index, log
+.wiki/                  # Config and templates
 ```
-┌─────────────────────────────────────────────────────────┐
-│                    YOU (curate & ask)                     │
-├──────────────┬──────────────────────┬────────────────────┤
-│   wiki/      │     outputs/         │   Obsidian vault    │
-│  (read only) │  (reports, digests)  │  (graph view, UI)   │
-├──────────────┴──────────────────────┴────────────────────┤
-│              LLM (writes & maintains)                     │
-├──────────────────────┬───────────────────────────────────┤
-│      raw/            │         schema/SKILL.md            │
-│  (immutable sources) │     (rules & conventions)          │
-└──────────────────────┴───────────────────────────────────┘
-```
-
-### Directory Structure
 
-```
-my-wiki/
-├── raw/                       ← You add sources here (immutable)
-│   ├── articles/              Web articles (markdown)
-│   ├── papers/                Research papers
-│   ├── notes/                 Personal notes
-│   ├── slack/                 Slack thread exports
-│   └── assets/                Downloaded images
-├── wiki/                      ← LLM manages this entirely
-│   ├── INDEX.md               Master catalog
-│   ├── LOG.md                 Activity log
-│   ├── DASHBOARD.md           Obsidian Dataview dashboard
-│   ├── entities/              People, orgs, tools, products
-│   ├── concepts/              Ideas, patterns, frameworks
-│   ├── sources/               One summary per source
-│   ├── syntheses/             Cross-cutting analyses
-│   └── changes/               Change detection records
-├── outputs/                   Reports and digests
-├── config.yaml                Wiki configuration
-└── .discoveries/              Auto-discovery metadata
-```
-
----
-
-## 💬 All Commands
-
-| Command          | Description         | Example                                   |
-| ---------------- | ------------------- | ----------------------------------------- |
-| `/wiki:init`     | Create a new wiki   | `/wiki:init "Rust Programming"`           |
-| `/wiki:ingest`   | Process new sources | `/wiki:ingest raw/articles/my-article.md` |
-| `/wiki:query`    | Ask a question      | `/wiki:query "Compare RAG vs LLM Wiki"`   |
-| `/wiki:lint`     | Health check        | `/wiki:lint --fix`                        |
-| `/wiki:discover` | Find new sources    | `/wiki:discover --topic "AI agents"`      |
-| `/wiki:run`      | Full cycle          | `/wiki:run --schedule daily`              |
-| `/wiki:status`   | Show health         | `/wiki:status`                            |
-| `/wiki:digest`   | Daily summary       | `/wiki:digest --period weekly`            |
-
----
-
-## 🔧 Custom Tools (Extension)
-
-The included TypeScript extension registers 5 tools the LLM can call directly:
-
-| Tool                    | Purpose                                         |
-| ----------------------- | ----------------------------------------------- |
-| `wiki_ingest`           | Prepare and track files for ingestion           |
-| `wiki_status_report`    | Gather wiki statistics and health metrics       |
-| `wiki_lint_report`      | Scan for issues (orphans, contradictions, gaps) |
-| `wiki_discover_sources` | Prepare discovery parameters from config        |
-| `wiki_watch`            | Generate schedule commands                      |
-
-These tools handle the scaffolding and bookkeeping so the LLM can focus on the actual knowledge work — reading, synthesizing, and writing wiki pages.
-
----
-
-## 📓 Using with Obsidian
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/master/assets/knowledge-graph.png" alt="Knowledge Graph" width="90%">
-</p>
-
-<p align="center">
-  <em>The LLM automatically connects entities, concepts, and sources with [[wikilinks]] — viewable in Obsidian's graph view</em>
-</p>
-
-1. Open the `wiki/` directory as an Obsidian vault
-2. Install these plugins:
-   - [Dataview](https://github.com/blacksmithgu/obsidian-dataview) — Query pages by frontmatter
-   - [Graph View](https://obsidian.md) (built-in) — Visualize [[wikilink]] connections
-   - [Spaced Repetition](https://github.com/st3v3nmw/obsidian-spaced-repetition) — Flashcards
-   - [Charts View](https://github.com/caronchen/obsidian-chartsview-plugin) — Dashboard analytics
-   - [Marp](https://marp.app/) — Markdown slide decks
-3. Browse the graph view to discover connections the LLM found
-4. Use the `DASHBOARD.md` for live analytics
-
-### Obsidian Web Clipper
-
-Use the [Obsidian Web Clipper](https://obsidian.md/clipper) browser extension to save articles directly into `raw/articles/`. Set attachment folder to `raw/assets/` in Obsidian settings.
-
----
-
-## 🏢 Personal vs. Company Wiki
-
-### Personal Wiki (`config.yaml: mode: personal`)
-
-Best for: Learning, research, journaling, book notes, health tracking, goals.
-
-- Extra folders: `wiki/journal/`, `wiki/goals/`
-- Daily journal entries can be ingested as raw sources
-- Track people you meet, books you read, courses you take
-
-### Company Wiki (`config.yaml: mode: company`)
-
-Best for: Competitive intelligence, market research, customer insights, internal documentation.
-
-- Extra folders: `wiki/decisions/`, `wiki/changes/`
-- **Change detection** — Re-check competitor sources for pricing, feature, and positioning changes
-- Confidence levels in frontmatter: `high | medium | low`
-- Slack/email thread exports as sources
-- Generate battlecards with `/wiki:query "Create a battlecard for Competitor X"`
-
----
-
-## ⏰ Scheduling (Auto-Update)
-
-Keep your wiki current without thinking about it:
-
-```bash
-# Inside pi
-/wiki:run --schedule daily    # Discover → ingest → lint every day at 8 AM
-/wiki:run --schedule weekly   # Every Monday at 9 AM
-/wiki:run --schedule hourly   # Every hour (for fast-moving topics)
-```
-
-The scheduler uses pi's built-in `schedule_prompt` system. All operations run in the background and the wiki stays updated.
-
----
-
-## 📚 Examples
-
-### Research Wiki
-
-```bash
-/wiki:init "LLM Agents"
-# Drop 5 papers into raw/papers/
-/wiki:ingest
-# Creates ~30-50 wiki pages (entities, concepts, cross-refs)
-/wiki:query "What are the main approaches to tool use in LLM agents?"
-/wiki:lint
-```
-
-### Book Companion
-
-```bash
-/wiki:init "Dune" --mode personal
-# Drop chapter notes into raw/notes/
-/wiki:ingest raw/notes/ch01-opening-test.md
-/wiki:query "Who are the main factions and what do they want?"
-/wiki:query "Create a timeline of events up to Chapter 5"
-```
-
-### Competitive Intelligence
-
-```bash
-/wiki:init "PM Tool Market" --mode company
-# Drop competitor landing pages, reviews, pricing pages
-/wiki:ingest
-/wiki:query "Create a comparison table of Linear, Notion, and Jira"
-/wiki:run --schedule weekly
-```
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! This package is maintained at [zosmaai/pi-llm-wiki](https://github.com/zosmaai/pi-llm-wiki).
-
-1. Fork the repo
-2. Create a feature branch
-3. Make your changes
-4. Submit a PR
-
-### Development
-
-```bash
-git clone https://github.com/zosmaai/pi-llm-wiki.git
-cd pi-llm-wiki
-npm install
-pi install ./
-```
+Read [docs/architecture.md](docs/architecture.md) for details.
 
----
+## Documentation
 
-## 📄 License
+- [Architecture](docs/architecture.md) — How the four layers work
+- [Commands](docs/commands.md) — All slash commands and tools
+- [Obsidian Integration](docs/obsidian.md) — Vault setup and recommended plugins
+- [Configuration](docs/configuration.md) — Wiki modes, topics, settings
+- [API](docs/api.md) — Extension tool reference
 
-MIT © zosmaai
+## Contributing
 
----
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
-## 🙏 Acknowledgments
+## License
 
-- **Andrej Karpathy** — For the [LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) that inspired this package
-- **mduongvandinh** — For the comprehensive [llm-wiki](https://github.com/mduongvandinh/llm-wiki) reference implementation
-- **tonbistudio** — For the [clean template](https://github.com/tonbistudio/llm-wiki) this draws from
-- **Vannevar Bush** — For imagining the Memex in 1945. LLMs finally make it practical.
+MIT

package/assets/README.md

@@ -4,10 +4,10 @@ Placeholder for gallery screenshots.
 
 To generate a screenshot:
 
-1. Create a wiki using `/wiki:init`
-2. Add a few sources and run `/wiki:ingest`
+1. Create a wiki using `/wiki-init`
+2. Add a few sources and run `/wiki-ingest`
 3. Open `wiki/` in Obsidian for the graph view screenshot
 4. Save as `assets/screenshot.png`
 
 The screenshot URL in package.json should point to:
-`https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/master/assets/screenshot.png`
+`https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/main/assets/screenshot.png`

package/assets/architecture.md

@@ -71,7 +71,7 @@ flowchart TB
 | ---------- | -------------------- | ------------------------------------------------------------------------------------------- |
 | **Ingest** | Add source to `raw/` | LLM reads, creates summary, updates 5-15 wiki pages, cross-references, flags contradictions |
 | **Query**  | Ask any question     | LLM searches index, reads relevant pages, synthesizes answer with `[[citations]]`           |
-| **Lint**   | `/wiki:lint`         | Health check: contradictions, orphans, missing pages, stale claims, knowledge gaps          |
+| **Lint**   | `/wiki-lint`         | Health check: contradictions, orphans, missing pages, stale claims, knowledge gaps          |
 
 ## Two Modes
 

package/biome.json

@@ -1,5 +1,8 @@
 {
   "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "files": {
+    "ignore": ["coverage", "dist", "node_modules"]
+  },
   "organizeImports": {
     "enabled": true
   },

package/docs/api.md

@@ -0,0 +1,105 @@
+# API Reference
+
+## Extension Tools
+
+### wiki_bootstrap
+
+Initialize a new LLM Wiki vault.
+
+```
+wiki_bootstrap(topic: string, mode?: "personal" | "company", root?: string)
+```
+
+### wiki_capture_source
+
+Capture a URL, file, or text into an immutable source packet.
+
+```
+wiki_capture_source(
+  inputType: "url" | "file" | "text",
+  value: string,
+  title?: string,
+  kind?: string,
+  tags?: string[],
+  createSourcePage?: boolean
+)
+```
+
+### wiki_ingest
+
+Get a batch of sources needing synthesis.
+
+```
+wiki_ingest(batch_size?: number)
+```
+
+### wiki_ensure_page
+
+Create or resolve a canonical page.
+
+```
+wiki_ensure_page(
+  type: "concept" | "entity" | "synthesis" | "analysis",
+  title: string,
+  aliases?: string[],
+  tags?: string[],
+  summary?: string,
+  createIfMissing?: boolean
+)
+```
+
+### wiki_search
+
+Search the wiki registry.
+
+```
+wiki_search(query: string, type?: string, limit?: number)
+```
+
+### wiki_lint
+
+Health check the wiki.
+
+```
+wiki_lint(mode?: string, writeReport?: boolean, limit?: number)
+```
+
+### wiki_status
+
+Show wiki statistics.
+
+```
+wiki_status()
+```
+
+### wiki_rebuild_meta
+
+Force metadata rebuild.
+
+```
+wiki_rebuild_meta()
+```
+
+### wiki_log_event
+
+Record a structured event.
+
+```
+wiki_log_event(
+  kind: string,
+  title: string,
+  summary?: string,
+  sourceIds?: string[],
+  pagePaths?: string[],
+  notes?: string[],
+  actor?: "agent" | "user" | "extension"
+)
+```
+
+### wiki_watch
+
+Schedule auto-updates.
+
+```
+wiki_watch(schedule: string, command: string)
+```

package/docs/architecture.md

@@ -0,0 +1,65 @@
+# Architecture
+
+## Four Layers
+
+```
+WIKI_ROOT/
+├── raw/sources/SRC-*/       # Immutable source packets (extension-owned)
+│   ├── manifest.json         # Capture metadata
+│   ├── original/             # Original artifact
+│   ├── extracted.md          # Normalized markdown
+│   └── attachments/          # Downloaded images, PDFs
+├── wiki/                     # Editable knowledge pages (you + LLM)
+│   ├── sources/              # One summary per source
+│   ├── entities/             # People, orgs, tools, products
+│   ├── concepts/             # Ideas, patterns, frameworks
+│   ├── syntheses/            # Cross-cutting analyses
+│   └── analyses/             # Durable query answers
+├── meta/                     # Auto-generated (extension-owned)
+│   ├── registry.json         # Master page catalog
+│   ├── backlinks.json        # Inbound link map
+│   ├── index.md              # Human-readable catalog
+│   ├── log.md                # Activity log
+│   └── events.jsonl          # Structured event stream
+└── .wiki/                    # Config and templates
+    ├── config.json
+    └── templates/
+```
+
+## Ownership Rules
+
+| Path      | Owner                    | Rule                     |
+| --------- | ------------------------ | ------------------------ |
+| `raw/**`  | Extension                | Immutable after capture  |
+| `wiki/**` | Model + user             | Editable knowledge pages |
+| `meta/*`  | Extension                | Auto-generated           |
+| `.wiki/*` | Human + explicit request | Operating rules          |
+
+## Source Packet Format
+
+Each captured source becomes a packet:
+
+```
+raw/sources/SRC-YYYY-MM-DD-NNN/
+  manifest.json
+  original/
+  extracted.md
+  attachments/
+```
+
+## Page Types
+
+- **source** — what this specific source says
+- **entity** — people, orgs, tools, products
+- **concept** — ideas, patterns, frameworks
+- **synthesis** — cross-source theses and tensions
+- **analysis** — durable filed answers from queries
+
+## Linking Style
+
+- Internal: `[[folder/page-name]]`
+- Citation: `[[sources/SRC-YYYY-MM-DD-NNN]]`
+
+## Guardrails
+
+The extension blocks direct edits to `raw/**` and `meta/**`. Metadata rebuilds automatically after `wiki/**` edits.

package/docs/commands.md

@@ -0,0 +1,51 @@
+# Commands
+
+## Slash Commands
+
+| Command          | Description                           |
+| ---------------- | ------------------------------------- |
+| `/wiki-init`     | Create a new wiki vault               |
+| `/wiki-ingest`   | Process new sources                   |
+| `/wiki-query`    | Ask questions against the wiki        |
+| `/wiki-lint`     | Health check                          |
+| `/wiki-discover` | Auto-discover sources                 |
+| `/wiki-run`      | Full cycle (discover → ingest → lint) |
+| `/wiki-status`   | Show wiki health                      |
+| `/wiki-digest`   | Daily/weekly summary                  |
+
+## Extension Tools
+
+The extension registers 10 tools the LLM can call directly:
+
+| Tool                  | Purpose                                     |
+| --------------------- | ------------------------------------------- |
+| `wiki_bootstrap`      | Initialize a new vault                      |
+| `wiki_capture_source` | Capture URL/file/text into immutable packet |
+| `wiki_ingest`         | Get batch of uningested sources             |
+| `wiki_ensure_page`    | Create canonical page from template         |
+| `wiki_search`         | Search the wiki registry                    |
+| `wiki_lint`           | Health check with auto-fix                  |
+| `wiki_status`         | Instant stats                               |
+| `wiki_rebuild_meta`   | Force metadata rebuild                      |
+| `wiki_log_event`      | Record custom event                         |
+| `wiki_watch`          | Schedule auto-updates                       |
+
+## Workflows
+
+### Capture → Ingest → Synthesize
+
+1. `wiki_capture_source(url="...")` — creates packet + skeleton
+2. `wiki_ingest()` — get batch of sources needing synthesis
+3. Read `raw/sources/SRC-*/extracted.md`
+4. Update skeleton source page with summary, entities, concepts
+5. `wiki_ensure_page(type="entity", title="...")` for each entity
+6. Add `[[wikilinks]]` between related pages
+7. Extension auto-rebuilds metadata
+
+### Query → Answer → File
+
+1. `wiki_search(query="...")` to find relevant pages
+2. Read those pages
+3. Synthesize answer with `[[wikilink]]` citations
+4. If novel: create analysis page via `wiki_ensure_page(type="analysis")`
+5. Extension auto-updates metadata