@zosmaai/pi-llm-wiki 0.1.0

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@zosmaai/pi-llm-wiki",
+  "version": "0.1.0",
+  "description": "LLM Wiki for Pi — self-maintaining knowledge base following Karpathy's pattern. Obsidian-friendly, auto-updating, personal & company wiki.",
+  "keywords": [
+    "pi-package",
+    "pi-skill",
+    "pi-extension",
+    "llm-wiki",
+    "karpathy",
+    "knowledge-base",
+    "obsidian",
+    "second-brain",
+    "wiki",
+    "zosmaai"
+  ],
+  "license": "MIT",
+  "author": "zosmaai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zosmaai/pi-llm-wiki.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zosmaai/pi-llm-wiki/issues"
+  },
+  "homepage": "https://github.com/zosmaai/pi-llm-wiki#readme",
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --apply .",
+    "prepare": "node -e \"try { require('husky').install() } catch {}\""
+  },
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ],
+    "skills": [
+      "./skills"
+    ],
+    "prompts": [
+      "./prompts"
+    ],
+    "image": "https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/main/assets/screenshot.png"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@mariozechner/pi-coding-agent": "^0.70.2",
+    "typebox": "^1.1.34",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/prompts/wiki-digest.md

@@ -0,0 +1,23 @@
+---
+description: Generate a daily or weekly digest of wiki changes — new sources, pages, insights, and gaps.
+args: [--period daily|weekly]
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:digest
+
+Generate a digest of recent wiki activity.
+
+## Steps
+
+1. Read `wiki/LOG.md` — filter entries since last digest
+2. Read pages created/updated in that period
+3. Summarize:
+   - New sources ingested
+   - New pages created
+   - Key insights or connections
+   - Knowledge gaps identified
+   - Health trends
+4. Save → `outputs/digest-YYYY-MM-DD.md`
+5. Report concise digest

package/prompts/wiki-discover.md

@@ -0,0 +1,29 @@
+---
+description: Auto-discover new sources from the web. Searches based on config topics and known knowledge gaps.
+args: [--topic <topic>]
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:discover
+
+Find new source material for the wiki by searching the web.
+
+Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first. Also read `config.yaml` for topics and feeds.
+
+## Steps
+
+1. Read `config.yaml` → extract topics, keywords, feeds
+2. Read `.discoveries/gaps.json` → knowledge gaps to fill
+3. Read `.discoveries/history.json` → already-fetched URLs
+4. Search for new sources:
+   - Web search each topic + latest keywords
+   - Search for gaps from `.discoveries/gaps.json`
+   - If `--topic` specified, focus search on that topic
+5. For each promising result:
+   a. Fetch full content
+   b. Save to `raw/articles/YYYY-MM-DD-slug.md` with frontmatter (title, url, discovered, topic)
+6. Update `.discoveries/history.json`
+7. Report: "Discovered [N] new sources. Run `/wiki:ingest` to process them."
+
+**Rules:** Max 5-10 sources. Skip ads, listicles, duplicates. Prefer in-depth analysis.

package/prompts/wiki-ingest.md

@@ -0,0 +1,30 @@
+---
+description: Process new source files in raw/ and update the wiki. Creates summaries, entities, concepts, and cross-references.
+args: [path]
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:ingest
+
+Process new files in `raw/` and integrate them into the wiki.
+
+Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first to understand the full schema, page formats, and conventions.
+
+## Steps
+
+1. Read `config.yaml` and `.discoveries/history.json`
+2. If a specific path is given (e.g., `/wiki:ingest raw/articles/my-file.md`), process just that file
+3. If no path given, scan all files in `raw/` 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?"
+   c. Create/update pages in `wiki/sources/`, `wiki/entities/`, `wiki/concepts/`
+   d. Add `[[wikilinks]]` cross-references between related pages
+   e. Flag any contradictions with existing wiki content
+5. Update `wiki/INDEX.md` with all new/updated pages
+6. Append to `wiki/LOG.md`
+7. Update `.discoveries/history.json`
+8. Report: "Ingested [N] sources → [M] pages created/updated. [X] contradictions flagged."
+
+**Rules:** Never modify raw/ files. Never fabricate information. Always cite sources.

package/prompts/wiki-init.md

@@ -0,0 +1,30 @@
+---
+description: Initialize a new LLM Wiki in the current directory. Creates the full directory structure, config, and template files.
+args: <topic> [--mode personal|company]
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:init
+
+Initialize a new LLM Wiki in the current directory.
+
+Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` (or wherever the skill is installed) first to understand the full schema and conventions.
+
+## Steps
+
+1. Ask the user for the wiki topic and mode (`personal` or `company`)
+2. Create the directory structure:
+   - `raw/articles/`, `raw/papers/`, `raw/notes/`, `raw/assets/`
+   - `wiki/entities/`, `wiki/concepts/`, `wiki/sources/`, `wiki/syntheses/`, `wiki/changes/`
+   - `outputs/`
+   - `.discoveries/`
+3. Create `config.yaml` with the topic, mode, and default settings
+4. Create `wiki/INDEX.md` with section headings organized by page type
+5. Create `wiki/LOG.md` with initial entry
+6. Create `wiki/DASHBOARD.md` with Dataview queries for Obsidian
+7. Create `.gitignore` to exclude `outputs/` from version control if desired
+8. Initialize git repo if not already present
+9. Report the structure and suggest first steps: "Drop sources into `raw/` and run `/wiki:ingest`"
+
+If `--mode company`, add the `change_detection: true` flag to config.yaml and add a `wiki/decisions/` folder.

package/prompts/wiki-lint.md

@@ -0,0 +1,29 @@
+---
+description: Health check the wiki. Detects contradictions, orphans, missing pages, stale claims, and knowledge gaps.
+args: [--fix]
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:lint
+
+Run a comprehensive health check on the wiki.
+
+Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first to understand the full schema and conventions.
+
+## Steps
+
+1. Scan all files in `wiki/`
+2. Check for:
+   - **Contradictions:** Conflicting claims between pages
+   - **Orphans:** Pages with zero inbound `[[wikilinks]]`
+   - **Missing pages:** `[[links]]` pointing to non-existent files
+   - **Stale claims:** Info superseded by newer sources
+   - **Broken raw links:** References to `raw/` files that don't exist
+   - **Knowledge gaps:** Topics mentioned but lacking their own page
+   - **Quality:** Pages under 3 lines, pages with no sources or cross-refs
+3. If `--fix` flag is present: auto-fix broken links, create missing pages for frequently-linked concepts, add cross-refs to orphans. Flag contradictions for human decision.
+4. Save report → `outputs/lint-YYYY-MM-DD.md`
+5. Update `.discoveries/gaps.json`
+6. Append to `wiki/LOG.md`
+7. Report key findings

package/prompts/wiki-query.md

@@ -0,0 +1,32 @@
+---
+description: Ask questions against the wiki. Synthesizes answers from wiki pages with cross-reference citations.
+args: <question>
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:query
+
+Ask a question and get an answer synthesized from wiki content.
+
+Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first to understand the full schema and conventions.
+
+## Steps
+
+1. Read `wiki/INDEX.md` to find pages relevant to the question
+2. Read those pages in full (don't stop at 1-2 pages — get thorough context)
+3. Synthesize an answer with `[[wikilink]]` citations to specific wiki pages
+4. If the answer reveals a new connection or analysis, save it as a synthesis page in `wiki/syntheses/`
+5. Append to `wiki/LOG.md`
+
+**Rules:** Answer ONLY from wiki content, not from general knowledge. If the wiki lacks information, say so clearly and suggest what sources would help fill the gap.
+
+**Example:**
+
+```
+/wiki:query What are the key differences between RAG and LLM Wiki?
+→ Reads INDEX.md, finds pages on RAG and LLM Wiki patterns
+→ Reads both pages
+→ Synthesizes a comparison table with [[wikilink]] citations
+→ Saves as wiki/syntheses/rag-vs-llm-wiki.md
+```

package/prompts/wiki-run.md

@@ -0,0 +1,35 @@
+---
+description: Run the full wiki cycle: discover → ingest → lint. Optionally schedule for auto-updates.
+args: [--schedule daily|weekly]
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:run
+
+Run the complete wiki maintenance cycle: discover new sources, ingest them, and lint for health.
+
+Read the LLM Wiki skill at `.pi/skills/llm-wiki/SKILL.md` first.
+
+## Steps
+
+1. Run `/wiki:discover` → find new sources
+2. Run `/wiki:ingest` → process all new files
+3. Run `/wiki:lint` → health check
+4. If critical gaps found → optionally one more discover+ingest cycle
+5. Save summary → `outputs/run-YYYY-MM-DD.md`
+6. Report final summary
+
+### Scheduling
+
+If `--schedule daily` is used, use `schedule_prompt` to set up daily runs:
+
+```
+schedule_prompt action=add schedule="0 0 8 * * *" prompt="Run /wiki:run for the LLM Wiki"
+```
+
+If `--schedule weekly` is used:
+
+```
+schedule_prompt action=add schedule="0 0 9 * * 1" prompt="Run /wiki:run for the LLM Wiki"
+```

package/prompts/wiki-status.md

@@ -0,0 +1,33 @@
+---
+description: Show wiki health overview — source count, page stats, orphan count, last activity dates.
+args: []
+section: LLM Wiki
+topLevelCli: true
+---
+
+# /wiki:status
+
+Show a quick overview of wiki health and statistics.
+
+## Steps
+
+1. Count sources in `raw/` (recursive)
+2. Count pages in `wiki/` (by type: entities, concepts, sources, syntheses)
+3. Check `wiki/LOG.md` for last ingest, lint, and discover dates
+4. Check for orphan pages (zero inbound links)
+5. Read `.discoveries/gaps.json` for known gaps
+6. Report:
+
+```
+📊 LLM Wiki Status
+══════════════════
+Wiki Root: [topic1], [topic2]
+Mode: Personal | Company
+Sources: [N] files
+Wiki Pages: [N] total ([E] entities, [C] concepts, [S] sources, [Y] syntheses)
+Last Ingest: YYYY-MM-DD
+Last Lint: YYYY-MM-DD
+Orphans: [N]
+Knowledge Gaps: [N]
+Health: ✅ Good | ⚠️ Warning | 🔴 Needs Attention
+```