@zosmaai/pi-llm-wiki 0.12.1 → 0.12.2

package/mcp/operations.ts

@@ -15,6 +15,7 @@ import {
   type WikilinkValidationMode,
 } from "../extensions/llm-wiki/lib/knowledge-links.js";
 import { type ProjectionResult, rebuildMetadata } from "../extensions/llm-wiki/lib/metadata.js";
+import { reindexQmdVault } from "../extensions/llm-wiki/lib/qmd-indexing.js";
 import { type RecallResult, searchWikiLayered } from "../extensions/llm-wiki/lib/recall.js";
 import { saveInsight } from "../extensions/llm-wiki/lib/retro.js";
 import { captureFile, captureText, captureUrl } from "../extensions/llm-wiki/lib/source-packet.js";
@@ -25,7 +26,11 @@ import {
   inspectWritableVault,
   VaultWriteError,
 } from "../extensions/llm-wiki/lib/vault-format.js";
-import { getWikiStatus, searchRegistry } from "../extensions/llm-wiki/lib/wiki-service.js";
+import {
+  getWikiStatus,
+  reindexWiki,
+  searchRegistry,
+} from "../extensions/llm-wiki/lib/wiki-service.js";
 
 function projectionOutcome(
   projection: ProjectionResult,
@@ -38,6 +43,22 @@ function projectionOutcome(
       };
 }
 
+/**
+ * Enqueue a post-projection lexical QMD pass. Model-free and repairable; never
+ * fails the authoritative write. Goes through the per-vault in-process queue.
+ */
+async function scheduleLexicalQmd(paths: VaultPaths): Promise<void> {
+  try {
+    await reindexQmdVault(paths, {
+      scope: "changed",
+      components: ["lexical"],
+      force: false,
+    });
+  } catch {
+    // Generated QMD state is repairable; an authoritative write must not fail.
+  }
+}
+
 /**
  * Shared bootstrap operation: create (or update) the vault at `paths`.
  *
@@ -113,6 +134,20 @@ export async function searchOperation(
   };
 }
 
+/** Shared reindex operation: delegates to the shared reindexWiki operation. */
+export async function reindexOperation(
+  paths: VaultPaths,
+  input: {
+    scope?: "changed" | "all";
+    components?: Array<"lexical" | "vectors">;
+    force?: boolean;
+    vault?: "active" | "personal" | "project" | "all";
+    signal?: AbortSignal;
+  },
+): Promise<import("../extensions/llm-wiki/lib/wiki-service.js").WikiReindexResult> {
+  return reindexWiki(paths, input);
+}
+
 /** Shared status operation: delegates directly to wiki-service. */
 export async function statusOperation(paths: VaultPaths): Promise<{
   knowledgeFormat: string;
@@ -120,8 +155,9 @@ export async function statusOperation(paths: VaultPaths): Promise<{
   byType: Record<string, number>;
   blockingDiagnostics: Array<{ code: string; message: string }>;
   lastUpdated: string;
+  qmd: import("../extensions/llm-wiki/lib/qmd-indexing.js").QmdGeneratedStatus;
 }> {
-  const status = getWikiStatus(paths);
+  const status = await getWikiStatus(paths);
   return {
     knowledgeFormat: status.knowledgeFormat,
     totalPages: status.totalPages,
@@ -131,6 +167,7 @@ export async function statusOperation(paths: VaultPaths): Promise<{
       message: d.message,
     })),
     lastUpdated: status.lastUpdated,
+    qmd: status.qmd,
   };
 }
 
@@ -179,6 +216,7 @@ export async function retroOperation(
     const result = saveInsight(paths, slug, title, gateBody, category, { rebuild: false });
     const projection = projectionOutcome(rebuildMetadata(paths));
     if (!projection.ok) return projection;
+    await scheduleLexicalQmd(paths);
     return { ok: true, slug: result.slug, sourcePagePath: result.sourcePagePath };
   } catch (error: unknown) {
     if (error instanceof VaultWriteError) {
@@ -236,6 +274,7 @@ export async function captureSourceOperation(
 
     const projection = projectionOutcome(rebuildMetadata(paths));
     if (!projection.ok) return projection;
+    await scheduleLexicalQmd(paths);
     return { ok: true, sourceId };
   } catch (error: unknown) {
     if (error instanceof VaultWriteError) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zosmaai/pi-llm-wiki",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "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",
@@ -78,12 +78,13 @@
     "@earendil-works/pi-coding-agent": ">=0.78.1"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22.0.0"
   },
   "dependencies": {
     "@cfworker/json-schema": "^4.1.1",
-    "@earendil-works/pi-tui": "0.84.4",
+    "@earendil-works/pi-tui": "0.85.1",
     "@modelcontextprotocol/server": "^2.0.0",
+    "@tobilu/qmd": "2.5.3",
     "mdast-util-from-markdown": "^2.0.3",
     "node-html-markdown": "^2.0.0",
     "typebox": "^1.1.34",
@@ -93,9 +94,9 @@
   "devDependencies": {
     "@astrojs/starlight": "^0.41.10",
     "@biomejs/biome": "^2.5.11",
-    "@earendil-works/pi-agent-core": "^0.78.1",
-    "@earendil-works/pi-ai": "^0.78.1",
-    "@earendil-works/pi-coding-agent": "^0.78.1",
+    "@earendil-works/pi-agent-core": "^0.85.1",
+    "@earendil-works/pi-ai": "^0.85.1",
+    "@earendil-works/pi-coding-agent": "^0.85.1",
     "@mermaid-js/mermaid-cli": "^11.12.0",
     "@types/mdast": "^4.0.4",
     "@types/node": "^26",
@@ -117,6 +118,8 @@
     "release:minor": "node scripts/release.js minor",
     "release:major": "node scripts/release.js major",
     "release:push": "git push origin main --tags",
+    "benchmark:retrieval": "vitest run test/retrieval-benchmark.test.ts --reporter=verbose",
+    "benchmark:retrieval:update": "node scripts/update-retrieval-baseline.mjs",
     "docs:sync": "node scripts/sync-docs.js",
     "docs:dev": "astro dev",
     "docs:build": "node scripts/sync-docs.js && astro build"

package/skills/llm-wiki/SKILL.md

@@ -37,11 +37,17 @@ WIKI_ROOT/
     │   ├── backlinks.json     # Inbound link map
     │   ├── index.md           # Human-readable catalog
     │   ├── log.md             # Activity log
-    │   └── events.jsonl       # Structured event stream
+    │   ├── events.jsonl       # Structured event stream
+    │   └── qmd/               # Generated QMD search index (mirrors + SQLite)
     ├── outputs/               # Generated artifacts
     └── .discoveries/          # Discovery tracking
 ```
 
+> `meta/qmd/` is extension-owned, generated, and **rebuildable** with `wiki_reindex`. It never
+> scans `wiki/` directly — it indexes parser-valid mirrors. Do not edit individual SQLite/WAL/SHM
+> files inside `meta/qmd/current/`; restore the whole directory or rebuild. Active recall still uses
+> the legacy heuristic until Phase 3.
+
 ## Golden Rules
 
 1. **RAW IS IMMUTABLE.** Never edit `raw/`. Use `wiki_capture_source` to add sources.