@zosmaai/pi-llm-wiki 0.4.0 → 0.6.0

package/package.json

@@ -1,17 +1,26 @@
 {
   "name": "@zosmaai/pi-llm-wiki",
-  "version": "0.4.0",
-  "description": "LLM Wiki for Pi — self-maintaining knowledge base following Karpathy's pattern. Obsidian-friendly, auto-updating, personal & company wiki.",
+  "version": "0.6.0",
+  "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",
     "pi-package",
-    "pi-skill",
     "pi-extension",
+    "pi-skill",
     "llm-wiki",
     "karpathy",
     "knowledge-base",
     "obsidian",
     "second-brain",
     "wiki",
+    "memory",
+    "markdown",
+    "pkm",
+    "personal-knowledge-management",
+    "research",
+    "vault",
+    "zettelkasten",
+    "rag",
     "zosmaai"
   ],
   "license": "MIT",
@@ -24,6 +33,20 @@
     "url": "https://github.com/zosmaai/pi-llm-wiki/issues"
   },
   "homepage": "https://github.com/zosmaai/pi-llm-wiki#readme",
+  "files": [
+    "extensions",
+    "skills",
+    "prompts",
+    "mcp",
+    "docs",
+    "assets",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
@@ -40,7 +63,10 @@
     "extensions": ["./extensions"],
     "skills": ["./skills"],
     "prompts": ["./prompts"],
-    "image": "https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/main/assets/screenshot.png"
+    "image": "https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/main/assets/screenshot.png",
+    "mcpservers": {
+      "llm-wiki": "node ./mcp/index.js"
+    }
   },
   "peerDependencies": {
     "@mariozechner/pi-coding-agent": "*",
@@ -49,6 +75,9 @@
   "engines": {
     "node": ">=18"
   },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0-alpha.2"
+  },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@mariozechner/pi-coding-agent": "^0.70.2",

package/skills/llm-wiki/SKILL.md

@@ -45,21 +45,48 @@ WIKI_ROOT/
 
 ## How the Extension Helps You
 
-| Task               | Before (skill-only)          | Now (extension-backed)                |
-| ------------------ | ---------------------------- | ------------------------------------- |
-| Track ingestion    | Manual `history.json`        | Automatic via `meta/registry.json`    |
-| Update INDEX       | Manual edit after every page | Auto-rebuilds on turn end             |
-| Update LOG         | Manual append                | Auto-generated from `events.jsonl`    |
-| Find orphans       | Shell `grep` scans           | Instant from `backlinks.json`         |
-| Block raw edits    | Skill says "don't"           | Extension **enforces** immutability   |
-| Create source page | 8 tool calls                 | `wiki_capture_source` + LLM synthesis |
+| Task                        | Before (skill-only)          | Now (extension-backed)                |
+| --------------------------- | ---------------------------- | ------------------------------------- |
+| Track ingestion             | Manual `history.json`        | Automatic via `meta/registry.json`    |
+| Update INDEX                | Manual edit after every page | Auto-rebuilds on turn end             |
+| Update LOG                  | Manual append                | Auto-generated from `events.jsonl`    |
+| Find orphans                | Shell `grep` scans           | Instant from `backlinks.json`         |
+| Block raw edits             | Skill says "don't"           | Extension **enforces** immutability   |
+| Create source page          | 8 tool calls                 | `wiki_capture_source` + LLM synthesis |
+| **Recall wiki knowledge**   | Never happens                | **Auto-search before every turn**     |
+| **Save task insights**      | Manual capture               | `wiki_retro` — one tool call          |
+
+## 🔄 Auto-Recall (New)
+
+**The extension now automatically searches the wiki before every user turn.**
+
+When you send a prompt, the extension:
+1. Extracts key terms from your request
+2. Searches the wiki registry for matching pages
+3. Injects matching page titles + summaries into context
+4. You see this as "Relevant Wiki Knowledge" in your system prompt
+
+**This means the wiki works as an automatic second brain.**
+You don't need to remember to search — relevant knowledge is surfaced automatically.
+
+### Manual recall for deeper searches
+
+If the auto-recall doesn't find enough context, call `wiki_recall` explicitly:
+
+```
+wiki_recall(query="specific terms...", max_results=10)
+```
+
+This gives you more control over the search terms and returns content previews.
 
 ## Available Tools
 
-Use these directly — they handle scaffolding and bookkeeping:
+Use these directly — they handle scaffolding, bookkeeping, recall, and capture:
 
 - `wiki_bootstrap` — Initialize a new vault
 - `wiki_capture_source` — Capture URL/file/text into immutable packet + skeleton page
+- `wiki_recall` — **Auto-called at turn start.** Search wiki for task-relevant pages
+- `wiki_retro` — Save an atomic insight from a completed task into the wiki
 - `wiki_ingest` — Get batch of uningested sources with extracted text
 - `wiki_ensure_page` — Create entity/concept/synthesis/analysis page from template
 - `wiki_search` — Search registry for existing pages
@@ -83,12 +110,20 @@ Use these directly — they handle scaffolding and bookkeeping:
 
 ### Query → Answer → File
 
-1. `wiki_search(query="...")` to find relevant pages
+1. **Auto-recall**: Extension surfaces relevant wiki pages automatically
 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
 
+### Task → Capture → Retro
+
+1. Complete a meaningful task
+2. Call `wiki_retro` to save key insights
+3. The insight is captured as a source packet
+4. Extension auto-updates metadata
+5. Next time, auto-recall surfaces your saved insight
+
 ## Page Conventions
 
 ### Naming

package/.coderabbit.yaml

@@ -1,43 +0,0 @@
-# CodeRabbit AI Code Review Configuration
-# Docs: https://docs.coderabbit.ai/guides/configure-coderabbit
-
-language: en-US
-early_access: false
-reviews:
-  profile: assertive
-  request_changes_workflow: true
-  high_level_summary: true
-  poem: false
-  review_status: true
-  collapse_walkthrough: false
-  auto_review:
-    enabled: true
-    ignore_title_keywords:
-      - "chore"
-      - "WIP"
-      - "wip"
-    drafts: false
-    base_branches:
-      - main
-  path_instructions:
-    - path: "extensions/**/*.ts"
-      instructions: |
-        Review TypeScript extension files for pi coding agent. Check that:
-        1. Tools use pi.registerTool() with TypeBox schemas
-        2. Error handling uses try/catch with proper messages
-        3. Unused parameters use underscore prefix or are removed
-        4. File exports a default function receiving ExtensionAPI
-    - path: "skills/**/SKILL.md"
-      instructions: |
-        Review SKILL.md for pi. Verify:
-        1. Frontmatter follows Agent Skills spec (name, description)
-        2. Workflows are clearly documented with steps
-        3. Golden rules and conventions are explicit
-    - path: "prompts/**/*.md"
-      instructions: |
-        Review prompt templates. Verify:
-        1. Frontmatter has description, args, section, topLevelCli
-        2. Instructions are actionable and clear
-
-chat:
-  auto_reply: true

package/.github/codeql/codeql-config.yml

@@ -1,12 +0,0 @@
-name: "CodeQL Config"
-
-queries:
-  - uses: security-and-quality
-
-# Suppress false positives for temporary file creation.
-# This is a single-user CLI tool — TOCTOU race conditions on temp directories
-# are not a valid threat model. The alerts only fire because tests pass
-# os.tmpdir() paths into production capture functions.
-query-filters:
-  - exclude:
-      id: js/insecure-temporary-file

package/.github/workflows/ci.yml

@@ -1,45 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  quality:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [20, 22, 23, 24, 25]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: npm
-
-      - run: npm ci
-
-      - name: Type Check
-        run: npm run typecheck
-
-      - name: Lint
-        run: npm run lint
-
-      - name: Run Tests with Coverage
-        run: npm run test:coverage
-
-      - name: Upload Coverage to Codecov
-        if: ${{ matrix.node-version == 22 && github.event_name == 'push' }}
-        uses: codecov/codecov-action@v5
-        with:
-          files: ./coverage/lcov.info
-          fail_ci_if_error: false
-          verbose: true

package/.github/workflows/codeql.yml

@@ -1,39 +0,0 @@
-name: "CodeQL"
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-  schedule:
-    - cron: "0 6 * * 1" # Every Monday at 6 AM
-
-jobs:
-  analyze:
-    name: Analyze (${{ matrix.language }})
-    runs-on: ubuntu-latest
-    permissions:
-      security-events: write
-      packages: read
-      actions: read
-      contents: read
-
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - language: javascript-typescript
-            build-mode: none
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: github/codeql-action/init@v3
-        with:
-          languages: ${{ matrix.language }}
-          build-mode: ${{ matrix.build-mode }}
-          config-file: ./.github/codeql/codeql-config.yml
-
-      - uses: github/codeql-action/analyze@v3
-        with:
-          category: "/language:${{ matrix.language }}"

package/.github/workflows/release.yml

@@ -1,86 +0,0 @@
-name: Release
-
-on:
-  push:
-    tags:
-      - "v*"
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org
-          cache: npm
-
-      - run: npm ci
-
-      - name: Type Check
-        run: npm run typecheck
-
-      - name: Lint
-        run: npm run lint
-
-      - name: Run Tests
-        run: npm test
-
-      - name: Extract Version from Tag
-        id: version
-        run: echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_OUTPUT
-
-      - name: Update package.json version
-        run: |
-          node -e "const p=require('./package.json'); p.version='${{ steps.version.outputs.VERSION }}'; require('fs').writeFileSync('./package.json', JSON.stringify(p, null, 2)+'\n')"
-          npx biome check --fix package.json 2>&1
-
-      - name: Commit version bump back to main
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add package.json
-          git commit -m "chore(release): v${{ steps.version.outputs.VERSION }}"
-          git push origin HEAD:main
-
-      - name: Generate Release Notes
-        id: notes
-        run: |
-          CHANGELOG=$(git log --pretty=format:"- %s (%h)" $(git describe --tags --abbrev=0 HEAD~1 2>/dev/null || git rev-list --max-parents=0 HEAD)..HEAD -- . 2>/dev/null || echo "- Initial release")
-          echo "NOTES<<EOF" >> $GITHUB_OUTPUT
-          echo "$CHANGELOG" >> $GITHUB_OUTPUT
-          echo "EOF" >> $GITHUB_OUTPUT
-
-      - name: Publish to npm
-        run: npm publish --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          name: "v${{ steps.version.outputs.VERSION }}"
-          body: |
-            ## 📦 @zosmaai/pi-llm-wiki v${{ steps.version.outputs.VERSION }}
-
-            ${{ steps.notes.outputs.NOTES }}
-
-            ### Install
-            \`\`\`bash
-            pi install npm:@zosmaai/pi-llm-wiki@${{ steps.version.outputs.VERSION }}
-            \`\`\`
-
-            ### What's Included
-            - **Skill**: Self-maintaining wiki schema (SKILL.md)
-            - **Extension**: 10 TypeScript tools (wiki_bootstrap, wiki_capture_source, wiki_ingest, wiki_ensure_page, wiki_search, wiki_lint, wiki_status, wiki_rebuild_meta, wiki_log_event, wiki_watch)
-            - **Prompt Templates**: 8 slash commands (/wiki:init, :ingest, :query, :lint, :discover, :run, :status, :digest)
-            - **Templates**: INDEX.md, LOG.md, DASHBOARD.md, config.yaml, 5 page templates
-          generate_release_notes: false

package/AGENTS.md

@@ -1,57 +0,0 @@
-# AGENTS.md
-
-Instructions for AI agents working on this codebase.
-
-## Project
-
-`@zosmaai/pi-llm-wiki` — A pi package that implements Andrej Karpathy's LLM Wiki pattern as a self-maintaining knowledge base.
-
-## Tech Stack
-
-- TypeScript (ES2022, ESM)
-- Vitest for testing
-- Biome for linting/formatting
-- GitHub Actions for CI
-- npm for publishing
-
-## File Layout
-
-```
-├── extensions/llm-wiki/     # TypeScript extension (10 tools + guardrails)
-│   ├── index.ts             # Entry point
-│   └── lib/                 # tools.ts, metadata.ts, guardrails.ts, utils.ts, source-packet.ts
-├── skills/llm-wiki/         # SKILL.md + templates
-├── prompts/                 # 8 slash command templates
-├── test/                    # Vitest tests
-├── docs/                    # Documentation
-└── scripts/                 # release.js
-```
-
-## Conventions
-
-- Use `node:fs/promises` for async file I/O, not sync
-- Prefer small, pure functions in `lib/`
-- Extension tools must have: name, label, description, promptSnippet, promptGuidelines, parameters (TypeBox), execute
-- Guardrails block `raw/**` and `meta/**` edits at the tool_call hook level
-- Metadata auto-rebuilds on `turn_end` after `wiki/**` edits
-- Source IDs: `SRC-YYYY-MM-DD-NNN`
-- Page filenames: `kebab-case.md`
-- Wikilinks: folder-qualified, e.g. `[[concepts/retrieval-augmented-generation]]`
-
-## Testing
-
-```bash
-npm test              # run tests
-npm run test:coverage # run with coverage
-npm run typecheck     # TypeScript check
-npm run lint          # biome check
-```
-
-## Release
-
-```bash
-npm run release:patch  # or minor/major
-npm run release:push   # push tags
-```
-
-Never edit `package.json` version manually — use the release script.

package/CONTRIBUTING.md

@@ -1,43 +0,0 @@
-# Contributing
-
-## Local Setup
-
-```bash
-git clone https://github.com/zosmaai/pi-llm-wiki.git
-cd pi-llm-wiki
-npm install
-pi install ./
-```
-
-## Development
-
-```bash
-npm run test           # run tests
-npm run test:coverage  # run tests with coverage report
-npm run typecheck      # TypeScript type check
-npm run lint           # biome lint check
-npm run lint:fix       # auto-fix lint issues
-```
-
-## Release Process
-
-```bash
-npm run release:patch  # bump patch version
-npm run release:minor  # bump minor version
-npm run release:major  # bump major version
-npm run release:push   # push to origin with tags
-```
-
-The release script:
-
-1. Verifies clean git tree and `main` branch
-2. Runs typecheck, lint, and tests
-3. Bumps version in `package.json`
-4. Updates `CHANGELOG.md`
-5. Commits and tags
-
-CI handles npm publish on tag push.
-
-## License
-
-MIT

package/biome.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "files": {
-    "ignore": ["coverage", "dist", "node_modules"]
-  },
-  "organizeImports": {
-    "enabled": true
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "style": {
-        "noNonNullAssertion": "off"
-      }
-    }
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 100
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double",
-      "semicolons": "always"
-    }
-  }
-}

package/scripts/release.js

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-/**
- * Semantic version release script.
- * Usage: node scripts/release.js [patch|minor|major]
- */
-
-const { execSync } = require("node:child_process");
-const fs = require("node:fs");
-const path = require("node:path");
-
-const bump = process.argv[2];
-if (!["patch", "minor", "major"].includes(bump)) {
-  console.error("Usage: node scripts/release.js [patch|minor|major]");
-  process.exit(1);
-}
-
-// Verify clean tree
-const status = execSync("git status --porcelain", { encoding: "utf-8" }).trim();
-if (status) {
-  console.error("Error: working tree is not clean");
-  process.exit(1);
-}
-
-// Verify main branch
-const branch = execSync("git branch --show-current", { encoding: "utf-8" }).trim();
-if (branch !== "main") {
-  console.error("Error: not on main branch");
-  process.exit(1);
-}
-
-// Run checks
-execSync("npm run typecheck", { stdio: "inherit" });
-execSync("npm run lint", { stdio: "inherit" });
-execSync("npm test", { stdio: "inherit" });
-
-// Read current version
-const pkgPath = path.join(__dirname, "..", "package.json");
-const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-const current = pkg.version;
-const [major, minor, patch] = current.split(".").map(Number);
-
-let next;
-if (bump === "major") next = `${major + 1}.0.0`;
-else if (bump === "minor") next = `${major}.${minor + 1}.0`;
-else next = `${major}.${minor}.${patch + 1}`;
-
-// Update package.json
-pkg.version = next;
-fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf-8");
-
-// Update CHANGELOG
-const changelogPath = path.join(__dirname, "..", "CHANGELOG.md");
-let changelog = "";
-if (fs.existsSync(changelogPath)) {
-  changelog = fs.readFileSync(changelogPath, "utf-8");
-}
-const today = new Date().toISOString().split("T")[0];
-const newSection = `## [${next}] - ${today}\n\n### Added\n- Release ${next}\n`;
-if (changelog.includes("## [Unreleased]")) {
-  changelog = changelog.replace("## [Unreleased]", `## [Unreleased]\n\n${newSection}`);
-} else {
-  changelog = `# Changelog\n\n## [Unreleased]\n\n${newSection}\n${changelog.replace("# Changelog\n\n", "")}`;
-}
-fs.writeFileSync(changelogPath, changelog, "utf-8");
-
-// Commit and tag
-execSync("git add package.json CHANGELOG.md", { stdio: "inherit" });
-execSync(`git commit -m "chore(release): v${next}"`, { stdio: "inherit" });
-execSync(`git tag v${next}`, { stdio: "inherit" });
-
-console.log(`\n✅ Released v${next}`);
-console.log(`Run "npm run release:push" to publish.`);