pi-harness-runtime 1.1.330 → 1.1.332

package/harness/wiki-integration.ts

@@ -1,10 +1,61 @@
 /**
  * Wiki Integration for Pi
  *
- * Implements wiki commands per wiki/llm-wiki-integration-minimax-plan.md
+ * Implements wiki commands and tools per wiki/llm-wiki-integration-minimax-plan.md
  */
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { realpathSync } from "node:fs";
+import path from "node:path";
+
+// Cache managers by workspace root to avoid recreating
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+// Cache managers by workspace root to avoid recreating
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const wikiManagers = new Map<string, any>();
+
+// Pre-load the wiki module for ESM compatibility
+let wikiModule: typeof import("../packages/wiki/dist/index.js") | null = null;
+async function getWikiModule() {
+  if (!wikiModule) {
+    wikiModule = await import("../packages/wiki/dist/index.js");
+  }
+  return wikiModule;
+}
+
+/**
+ * Get or create wiki manager for a workspace
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function getWiki(workspaceRoot: string): Promise<any> {
+  let manager = wikiManagers.get(workspaceRoot);
+  if (!manager) {
+    const mod = await getWikiModule();
+    const projectId = path.basename(workspaceRoot) || "unknown";
+    manager = mod.createWikiManager(workspaceRoot, projectId);
+    wikiManagers.set(workspaceRoot, manager);
+  }
+  return manager;
+}
+
+/**
+ * Get current workspace from Pi context
+ */
+function getCurrentWorkspace(ctx?: ExtensionContext): string {
+  if (ctx?.cwd) {
+    try {
+      return realpathSync(ctx.cwd);
+    } catch {
+      return ctx.cwd;
+    }
+  }
+  try {
+    return realpathSync(process.cwd());
+  } catch {
+    return process.cwd();
+  }
+}
 
 /**
  * Initialize wiki integration
@@ -16,33 +67,181 @@ export async function initWiki(pi: ExtensionAPI): Promise<void> {
   }
 
   try {
-    const { createWikiManager, isWikiEnabled } = await import(
-      "../packages/wiki/dist/index.js"
-    );
+    const { isWikiEnabled } = await import("../packages/wiki/dist/index.js");
 
-    // Get workspace from environment
-    const workspaceRoot = process.env.PWD || process.cwd();
+    // ========================================================================
+    // Register Tools (for LLM use)
+    // ========================================================================
 
-    // Create wiki manager lazily
-    let wikiManager: ReturnType<typeof createWikiManager> | null = null;
+    // Tool: wiki_search - Search pages by query
+    pi.registerTool({
+      name: "wiki_search",
+      label: "Wiki Search",
+      description: "Search wiki pages by query. Returns page titles, IDs, status, and snippets.",
+      parameters: Type.Object({
+        query: Type.String({ description: "Search query" }),
+        limit: Type.Optional(Type.Number({ description: "Max results (default 5)", default: 5 })),
+      }),
+      async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+        if (!isWikiEnabled()) {
+          return { content: [{ type: "text", text: "Wiki feature is disabled." }], details: {} };
+        }
+        try {
+          const wiki = getWiki(getCurrentWorkspace(ctx));
+          const results = wiki.search(params.query, undefined, params.limit ?? 5);
+          if (results.length === 0) {
+            return { content: [{ type: "text", text: "No results found." }], details: {} };
+          }
+          const lines = results.map((r: { page: { status: string; title: string; kind: string; id: string } }) =>
+            `[${r.page.status}] ${r.page.title} (${r.page.kind}): ${r.page.id}`
+          );
+          return { content: [{ type: "text", text: `Found ${results.length} result(s):\n${lines.join("\n")}` }], details: {} };
+        } catch (err) {
+          return { content: [{ type: "text", text: `Search failed: ${err}` }], details: {} };
+        }
+      },
+    });
 
-    function getWiki() {
-      if (!wikiManager) {
-        wikiManager = createWikiManager(workspaceRoot, "pi-harness-runtime");
-      }
-      return wikiManager;
-    }
+    // Tool: wiki_read - Read a specific page
+    pi.registerTool({
+      name: "wiki_read",
+      label: "Wiki Read",
+      description: "Read a wiki page by ID. Returns frontmatter and body content.",
+      parameters: Type.Object({
+        pageId: Type.String({ description: "Page ID to read" }),
+      }),
+      async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+        if (!isWikiEnabled()) {
+          return { content: [{ type: "text", text: "Wiki feature is disabled." }], details: {} };
+        }
+        try {
+          const wiki = getWiki(getCurrentWorkspace(ctx));
+          const page = wiki.loadPage(params.pageId);
+          if (!page) {
+            return { content: [{ type: "text", text: `Page not found: ${params.pageId}` }], details: {} };
+          }
+          const lines = [
+            `# ${page.frontmatter.title}`,
+            `ID: ${page.frontmatter.id}`,
+            `Status: ${page.frontmatter.status}`,
+            `Kind: ${page.frontmatter.kind}`,
+            `Updated: ${page.frontmatter.updatedAt}`,
+            ``,
+            `---`,
+            page.body,
+          ];
+          return { content: [{ type: "text", text: lines.join("\n") }], details: {} };
+        } catch (err) {
+          return { content: [{ type: "text", text: `Read failed: ${err}` }], details: {} };
+        }
+      },
+    });
+
+    // Tool: wiki_ingest - Ingest a source file
+    pi.registerTool({
+      name: "wiki_ingest",
+      label: "Wiki Ingest",
+      description: "Ingest a source file into the wiki. Creates a snapshot and returns the snapshot ID.",
+      parameters: Type.Object({
+        sourcePath: Type.String({ description: "Path to source file to ingest" }),
+      }),
+      async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+        if (!isWikiEnabled()) {
+          return { content: [{ type: "text", text: "Wiki feature is disabled." }], details: {} };
+        }
+        try {
+          const wiki = getWiki(getCurrentWorkspace(ctx));
+          const { page, snapshot, existing } = wiki.ingestAndCreatePage(params.sourcePath);
+          if (existing) {
+            return { content: [{ type: "text", text: `Already ingested: ${snapshot.id}` }], details: {} };
+          }
+          return {
+            content: [{
+              type: "text",
+              text: `Ingested: ${snapshot.id}\nPage: ${page.frontmatter.id}\nTitle: ${page.frontmatter.title}\nPath: ${snapshot.originalPath}\nHash: ${snapshot.contentHash.slice(0, 16)}...`,
+            }],
+            details: { pageId: page.frontmatter.id },
+          };
+        } catch (err) {
+          return { content: [{ type: "text", text: `Ingest failed: ${err}` }], details: {} };
+        }
+      },
+    });
+
+    // Tool: wiki_lint - Run lint checks
+    pi.registerTool({
+      name: "wiki_lint",
+      label: "Wiki Lint",
+      description: "Run lint checks on the wiki. Returns structural and semantic issues.",
+      parameters: Type.Object({}),
+      async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
+        if (!isWikiEnabled()) {
+          return { content: [{ type: "text", text: "Wiki feature is disabled." }], details: {} };
+        }
+        try {
+          const wiki = getWiki(getCurrentWorkspace(ctx));
+          const findings = wiki.lint();
+          if (findings.length === 0) {
+            return { content: [{ type: "text", text: "No issues found." }], details: {} };
+          }
+          const lines = findings.slice(0, 20).map((f: { severity: string; category: string; message: string }) =>
+            `[${f.severity}] ${f.category}: ${f.message}`
+          );
+          return { content: [{ type: "text", text: `${findings.length} issue(s):\n${lines.join("\n")}` }], details: {} };
+        } catch (err) {
+          return { content: [{ type: "text", text: `Lint failed: ${err}` }], details: {} };
+        }
+      },
+    });
+
+    // Tool: wiki_status - Show wiki stats
+    pi.registerTool({
+      name: "wiki_status",
+      label: "Wiki Status",
+      description: "Show wiki statistics: page count, kinds, statuses.",
+      parameters: Type.Object({}),
+      async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
+        if (!isWikiEnabled()) {
+          return { content: [{ type: "text", text: "Wiki feature is disabled." }], details: {} };
+        }
+        try {
+          const wiki = getWiki(getCurrentWorkspace(ctx));
+          const pages = wiki.getAllPages();
+          const kinds: Record<string, number> = {};
+          const statuses: Record<string, number> = {};
+          for (const p of pages) {
+            kinds[p.frontmatter.kind] = (kinds[p.frontmatter.kind] || 0) + 1;
+            statuses[p.frontmatter.status] = (statuses[p.frontmatter.status] || 0) + 1;
+          }
+          return {
+            content: [{
+              type: "text",
+              text: `Wiki Status\nPages: ${pages.length}\nKinds: ${JSON.stringify(kinds)}\nStatuses: ${JSON.stringify(statuses)}`,
+            }],
+            details: {},
+          };
+        } catch (err) {
+          return { content: [{ type: "text", text: `Status failed: ${err}` }], details: {} };
+        }
+      },
+    });
+
+    // ========================================================================
+    // Register Command (for user use)
+    // ========================================================================
 
-    // Register /harness-wiki command
     pi.registerCommand("harness-wiki", {
       description: "Manage project wiki: search, read, ingest, lint",
-      handler: async (args: string, _ctx: unknown) => {
+      handler: async (args: string, ctx: unknown) => {
         if (!isWikiEnabled()) {
           console.log("Wiki feature is disabled. Set HARNESS_KNOWLEDGE_WIKI=1 to enable.");
           return;
         }
 
-        const wiki = getWiki();
+        // Get workspace from context
+        const extCtx = ctx as ExtensionContext | undefined;
+        const workspace = getCurrentWorkspace(extCtx);
+        const wiki = getWiki(workspace);
         const parts = args.trim().split(/\s+/);
         const subcommand = parts[0] || "help";
         const subargs = parts.slice(1).join(" ");
@@ -110,11 +309,12 @@ export async function initWiki(pi: ExtensionAPI): Promise<void> {
               return;
             }
             try {
-              const { snapshot, existing } = wiki.ingestSource(subargs);
+              const { page, snapshot, existing } = wiki.ingestAndCreatePage(subargs);
               if (existing) {
                 console.log(`Already ingested: ${snapshot.id}`);
               } else {
                 console.log(`Ingested: ${snapshot.id}`);
+                console.log(`  Page: ${page.frontmatter.id} - ${page.frontmatter.title}`);
                 console.log(`  Path: ${snapshot.originalPath}`);
                 console.log(`  Hash: ${snapshot.contentHash.slice(0, 16)}...`);
               }
@@ -129,8 +329,8 @@ export async function initWiki(pi: ExtensionAPI): Promise<void> {
               if (findings.length === 0) {
                 console.log("No issues found.");
               } else {
-                const errors = findings.filter((f) => f.severity === "error");
-                const warnings = findings.filter((f) => f.severity === "warning");
+                const errors = findings.filter((f: { severity: string }) => f.severity === "error");
+                const warnings = findings.filter((f: { severity: string }) => f.severity === "warning");
                 console.log(`${errors.length} error(s), ${warnings.length} warning(s):`);
                 for (const f of findings.slice(0, 10)) {
                   console.log(`  [${f.severity}] ${f.category}: ${f.message}`);
@@ -189,10 +389,12 @@ export function getWikiInstruction(): string {
   return `
 ## Project Wiki
 
-Project knowledge is available via the wiki. Use /harness-wiki to:
-- Search: /harness-wiki search <query>
-- Read: /harness-wiki read <page-id>
-- Ingest: /harness-wiki ingest <source-path>
+Project knowledge is available via wiki tools:
+- wiki_search: Search pages by query
+- wiki_read: Read a page by ID
+- wiki_ingest: Ingest a source file
+- wiki_lint: Check for issues
+- wiki_status: Show statistics
 
 The wiki contains:
 - Design decisions with rationale

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {

package/packages/a2a-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/a2a-adapter",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
   "main": "dist/index.js",

package/packages/agent-policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/agent-policy",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Agent policy runtime for pi-harness - enforces mandatory rule delivery and mutation gating",
   "type": "module",
   "main": "./dist/index.js",

package/packages/architecture-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/architecture-generator",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Generate ADR and Mermaid diagrams from project analysis",
   "type": "module",
   "main": "./dist/index.js",

package/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/auth",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "pi-harness-runtime — auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/autonomous-refactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-refactor",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "description": "Autonomous refactoring engine",
   "main": "dist/index.js",

package/packages/autonomous-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-runtime",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cache-strategy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cache-strategy",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "description": "Smart caching with TTL and invalidation strategies (RFC-0022)",
   "main": "dist/index.js",

package/packages/capability-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/capability-registry",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Capability Registry for pi-harness-runtime — tracks model capabilities and enables capability-based routing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/checkpoint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/checkpoint",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cli-plugin-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cli-plugin-sdk",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "description": "CLI Plugin SDK for pi-harness — install, list, remove, update, invoke plugins",
   "main": "dist/index.js",

package/packages/clipboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard-plugin",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Code generation pipeline for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/code-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-review",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Automated code review engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/codex-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/codex-adapter",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "description": "OpenAI Codex provider adapter for pi-harness",
   "main": "dist/index.js",

package/packages/codex-watcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/codex-watcher",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Watches Codex CLI sessions and emits visible messages for PING-PONG monitoring",
   "type": "module",
   "main": "./dist/src/index.js",

package/packages/config-capture/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/config-capture",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Bounded context selection engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/context-discovery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-discovery",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/context-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/context-manager",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cookie-sanitizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "pi-harness-runtime — cookie sanitizer (provider-quota cookie file normaliser)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cost-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cost-optimizer",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Cost Optimizer for pi-harness-runtime — budget tracking, forecasting, and model selection optimization",
   "type": "module",
   "main": "./dist/index.js",

package/packages/dependency-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/dependency-analyzer",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Django framework analysis — models, management commands, settings",
   "type": "module",
   "main": "./dist/index.js",

package/packages/doc-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/doc-generator",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Auto-Doc Generator — generate documentation from source code (RFC-0014)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/durable-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/durable-review",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "SQLite-backed durable reviewer using @earendil-works/pi-durable",
   "type": "module",
   "main": "src/index.ts",

package/packages/e2e-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/e2e-tester",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "WebMCP-powered E2E testing for pi-harness - natural language test scenarios",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/evaluation-engine",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Evaluation engine for pi-harness runtime (RFC-0057)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-runner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/evaluation-runner",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "description": "Framework-agnostic evaluation framework for AI outputs (RFC-0020)",
   "main": "dist/index.js",

package/packages/event-bus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-bus",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/experience-replay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/experience-replay",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Experience replay for debugging and reproducibility (RFC-0059)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/feedback-collector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/feedback-collector",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "type": "module",
   "description": "Collect and aggregate human/automated feedback (RFC-0021)",
   "main": "dist/index.js",

package/packages/file-copy-helper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/file-copy-helper",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Injects cp/sudo cp rule when user asks to mimic/copy files",
   "type": "module",
   "main": "dist/index.js",

package/packages/framework-detector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-detector",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Framework detection system for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/framework-plugin-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-plugin-sdk",
-  "version": "1.1.330",
+  "version": "1.1.332",
   "description": "Framework plugin SDK for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",