@zosmaai/pi-llm-wiki 0.6.1 → 0.6.3

package/README.md

@@ -84,9 +84,15 @@ The result is a wiki that **compounds** as you capture sources, ask questions, a
 
 | Command | Description |
 |---------|-------------|
+| `/wiki-init <topic>` | Initialize a new LLM Wiki vault |
+| `/wiki-ingest [path]` | Process new source files and update the wiki |
+| `/wiki-query <question>` | Ask questions against the wiki with citations |
+| `/wiki-discover [--topic <topic>]` | Auto-discover new sources from the web |
+| `/wiki-run [--schedule daily\|weekly]` | Full cycle: discover → ingest → lint |
+| `/wiki-lint [--fix]` | Health check (orphans, contradictions, gaps) |
 | `/wiki-status` | Show a concise operational summary |
-| `/wiki-lint [mode]` | Run mechanical lint (`all`, `links`, `orphans`, `frontmatter`, `duplicates`, `coverage`, `staleness`) |
-| `/wiki-rebuild` | Force a full metadata rebuild |
+| `/wiki-digest [--period daily\|weekly]` | Generate a digest of recent activity |
+| `/wiki-retro` | Save atomic insights from completed tasks |
 
 ---
 

package/docs/commands.md

@@ -12,15 +12,18 @@
 | `/wiki-run`      | Full cycle (discover → ingest → lint) |
 | `/wiki-status`   | Show wiki health                      |
 | `/wiki-digest`   | Daily/weekly summary                  |
+| `/wiki-retro`    | Save atomic insights from tasks        |
 
 ## Extension Tools
 
-The extension registers 10 tools the LLM can call directly:
+The extension registers 12 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_recall`         | 🔄 Auto-called at turn start — search wiki  |
+| `wiki_retro`          | Save atomic insights from completed tasks   |
 | `wiki_ingest`         | Get batch of uningested sources             |
 | `wiki_ensure_page`    | Create canonical page from template         |
 | `wiki_search`         | Search the wiki registry                    |

package/extensions/llm-wiki/index.ts

@@ -51,7 +51,7 @@ export default function (pi: ExtensionAPI) {
   installGuardrails(pi);
 
   pi.on("session_start", async (_event, ctx) => {
-    ctx.ui.setStatus("llm-wiki", "🧠 LLM Wiki (11 tools, auto-recall active)");
+    ctx.ui.setStatus("llm-wiki", "🧠 LLM Wiki (12 tools, auto-recall active)");
   });
 
   // ─── Auto-recall hook ──────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zosmaai/pi-llm-wiki",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Self-maintaining LLM Wiki for Pi — Karpathy-pattern knowledge base with immutable source capture, automated ingestion, search, linting, and Obsidian-compatible vault. auto-updating personal & company wiki.",
   "keywords": [
     "pi",

package/prompts/wiki-ingest.md

@@ -19,7 +19,7 @@ Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first to understand th
 
 1. Read `.llm-wiki/config.yaml` and `.llm-wiki/.discoveries/history.json`
 2. If a specific path is given (e.g., `/wiki-ingest .llm-wiki/raw/articles/my-file.md`), process just that file
-3. If no path given, scan all files in `.llm-wiki/raw/` and find ones not in history
+3. If no path given, scan all files in `.llm-wiki/raw/` (respecting `.gitignore` — skip any matched files) and find ones not in history
 4. For each new source:
    a. Read the full content
    b. Briefly discuss with the user: "This is about [topic]. Key points: [summary]. Any specific emphasis?"

package/prompts/wiki-lint.md

@@ -17,7 +17,7 @@ Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first to understand th
 
 ## Steps
 
-1. Scan all files in `.llm-wiki/wiki/`
+1. Scan all files in `.llm-wiki/wiki/` (respecting `.gitignore` — skip any matched files)
 2. Check for:
    - **Contradictions:** Conflicting claims between pages
    - **Orphans:** Pages with zero inbound `[[wikilinks]]`

package/prompts/wiki-retro.md

@@ -0,0 +1,34 @@
+---
+description: Save an atomic insight from the current task into the wiki. Creates a source packet and source page for future auto-recall.
+argument-hint: "<title> [--category <category>]"
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki-retro
+
+Save an atomic insight from a completed task into the wiki.
+
+Captures what you learned as an immutable source packet + wiki source page so that `wiki_recall` automatically surfaces it in future sessions.
+
+## User Arguments
+
+$ARGUMENTS
+
+Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first to understand the wiki conventions.
+
+## Steps
+
+1. Identify the key insight(s) from the current task — non-obvious learnings, patterns, or decisions worth preserving
+2. For each insight, call `wiki_retro` with:
+   - `slug`: unique kebab-case identifier (e.g., `jwt-revocation-pattern`)
+   - `title`: short descriptive phrase, ≤60 chars, noun phrase not a sentence
+   - `body`: markdown explanation with `[[wikilinks]]` to related wiki pages
+   - `category`: optional (frontend, architecture, devops, bugfix, design, etc.)
+3. Confirm the insight was saved and will be auto-surfaced in future sessions
+4. If the insight relates to existing wiki pages, update those pages with cross-references
+
+**Rules:**
+- One atomic insight per `wiki_retro` call. Use multiple calls for multiple insights.
+- Don't save obvious things. Save non-obvious patterns, tradeoffs, and design decisions.
+- Always add `[[wikilinks]]` to connect the new insight with existing wiki knowledge.

package/prompts/wiki-status.md

@@ -11,8 +11,8 @@ Show a quick overview of wiki health and statistics.
 
 ## Steps
 
-1. Count sources in `.llm-wiki/raw/` (recursive)
-2. Count pages in `.llm-wiki/wiki/` (by type: entities, concepts, sources, syntheses)
+1. Count sources in `.llm-wiki/raw/` (recursive, respecting `.gitignore`)
+2. Count pages in `.llm-wiki/wiki/` (by type: entities, concepts, sources, syntheses, respecting `.gitignore`)
 3. Check `.llm-wiki/wiki/LOG.md` for last ingest, lint, and discover dates
 4. Check for orphan pages (zero inbound links)
 5. Read `.llm-wiki/.discoveries/gaps.json` for known gaps

package/skills/llm-wiki/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: llm-wiki
-description: Build and maintain a persistent, interlinked Obsidian-compatible markdown wiki using Karpathy's LLM Wiki pattern. Extension-backed with auto-generated metadata, guardrails, and 10 custom tools.
+description: Build and maintain a persistent, interlinked Obsidian-compatible markdown wiki using Karpathy's LLM Wiki pattern. Extension-backed with auto-generated metadata, guardrails, and 12 custom tools.
 ---
 
 # LLM Wiki for Pi