pi-harness-runtime 1.1.328 → 1.1.329

package/harness/wiki-integration.ts

@@ -0,0 +1,205 @@
+/**
+ * Wiki Integration for Pi
+ *
+ * Implements wiki commands per wiki/llm-wiki-integration-minimax-plan.md
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+/**
+ * Initialize wiki integration
+ */
+export async function initWiki(pi: ExtensionAPI): Promise<void> {
+  // Only initialize if feature flag is set
+  if (process.env.HARNESS_KNOWLEDGE_WIKI !== "1") {
+    return;
+  }
+
+  try {
+    const { createWikiManager, isWikiEnabled } = await import(
+      "../packages/wiki/dist/index.js"
+    );
+
+    // Get workspace from environment
+    const workspaceRoot = process.env.PWD || process.cwd();
+
+    // Create wiki manager lazily
+    let wikiManager: ReturnType<typeof createWikiManager> | null = null;
+
+    function getWiki() {
+      if (!wikiManager) {
+        wikiManager = createWikiManager(workspaceRoot, "pi-harness-runtime");
+      }
+      return wikiManager;
+    }
+
+    // Register /harness-wiki command
+    pi.registerCommand("harness-wiki", {
+      description: "Manage project wiki: search, read, ingest, lint",
+      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();
+        const parts = args.trim().split(/\s+/);
+        const subcommand = parts[0] || "help";
+        const subargs = parts.slice(1).join(" ");
+
+        switch (subcommand) {
+          case "init":
+            try {
+              const result = wiki.initialize();
+              if (result.created) {
+                console.log("Wiki initialized.");
+              } else {
+                console.log("Wiki already exists.");
+              }
+              console.log(`  Root: ${result.config.wikiRoot}`);
+            } catch (err) {
+              console.log(`Init failed: ${err}`);
+            }
+            break;
+
+          case "search":
+            if (!subargs) {
+              console.log("Usage: /harness-wiki search <query>");
+              return;
+            }
+            try {
+              const results = wiki.search(subargs);
+              if (results.length === 0) {
+                console.log("No results found.");
+              } else {
+                console.log(`Found ${results.length} result(s):`);
+                for (const r of results.slice(0, 5)) {
+                  console.log(`  - [${r.page.status}] ${r.page.title} (${r.page.kind})`);
+                }
+              }
+            } catch (err) {
+              console.log(`Search failed: ${err}`);
+            }
+            break;
+
+          case "read":
+            if (!subargs) {
+              console.log("Usage: /harness-wiki read <page-id>");
+              return;
+            }
+            try {
+              const page = wiki.loadPage(subargs);
+              if (!page) {
+                console.log(`Page not found: ${subargs}`);
+              } else {
+                console.log(`# ${page.frontmatter.title}`);
+                console.log(`Status: ${page.frontmatter.status}`);
+                console.log(`Kind: ${page.frontmatter.kind}`);
+                console.log(`Updated: ${page.frontmatter.updatedAt}`);
+                console.log("");
+                console.log(page.body.slice(0, 500) + (page.body.length > 500 ? "..." : ""));
+              }
+            } catch (err) {
+              console.log(`Read failed: ${err}`);
+            }
+            break;
+
+          case "ingest":
+            if (!subargs) {
+              console.log("Usage: /harness-wiki ingest <source-path>");
+              return;
+            }
+            try {
+              const { snapshot, existing } = wiki.ingestSource(subargs);
+              if (existing) {
+                console.log(`Already ingested: ${snapshot.id}`);
+              } else {
+                console.log(`Ingested: ${snapshot.id}`);
+                console.log(`  Path: ${snapshot.originalPath}`);
+                console.log(`  Hash: ${snapshot.contentHash.slice(0, 16)}...`);
+              }
+            } catch (err) {
+              console.log(`Ingest failed: ${err}`);
+            }
+            break;
+
+          case "lint":
+            try {
+              const findings = wiki.lint();
+              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");
+                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}`);
+                }
+              }
+            } catch (err) {
+              console.log(`Lint failed: ${err}`);
+            }
+            break;
+
+          case "status":
+            try {
+              const pages = wiki.getAllPages();
+              const index = wiki.getIndex();
+              const kinds: Record<string, number> = {};
+              const statuses: Record<string, number> = {};
+              for (const p of index) {
+                kinds[p.kind] = (kinds[p.kind] || 0) + 1;
+                statuses[p.status] = (statuses[p.status] || 0) + 1;
+              }
+              console.log("Wiki Status");
+              console.log(`  Pages: ${pages.length}`);
+              console.log(`  Kinds: ${JSON.stringify(kinds)}`);
+              console.log(`  Statuses: ${JSON.stringify(statuses)}`);
+            } catch (err) {
+              console.log(`Status failed: ${err}`);
+            }
+            break;
+
+          case "help":
+          default:
+            console.log("Wiki Commands:");
+            console.log("  /harness-wiki init         - Initialize wiki");
+            console.log("  /harness-wiki search <q>  - Search pages");
+            console.log("  /harness-wiki read <id>   - Read page");
+            console.log("  /harness-wiki ingest <p> - Ingest source file");
+            console.log("  /harness-wiki lint        - Check for issues");
+            console.log("  /harness-wiki status      - Show stats");
+            break;
+        }
+      },
+    });
+  } catch {
+    // Silently fail - wiki is optional
+  }
+}
+
+/**
+ * Get wiki context for injection into system prompt
+ */
+export function getWikiInstruction(): string {
+  if (process.env.HARNESS_KNOWLEDGE_WIKI !== "1") {
+    return "";
+  }
+
+  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>
+
+The wiki contains:
+- Design decisions with rationale
+- Architecture concepts
+- Incident records and lessons
+- Implementation plans
+
+Always cite wiki sources when providing project-specific information.
+`;
+}

package/index.ts

@@ -70,6 +70,7 @@ import {
 	createBlackboard,
 } from "./harness/blackboard.ts";
 import { scheduleAutoResume, cancelAutoResume, getGLMQuotaCountdown } from "./harness/index.js";
+import { initWiki } from "./harness/wiki-integration.js";
 import { startWatcher, classifyMessage, detectReviewMarker } from "./packages/codex-watcher/dist/src/index.js";
 import {
 	getPaperclipConfig,
@@ -1998,7 +1999,7 @@ function processCompletionFile(filePath: string, pi: ExtensionAPI): void {
 // --- Debug logging (file only, no console override) ---------------
 // Logs written to file only. Real console output preserved for pi's TUI.
 import { homedir } from "node:os";
-import { existsSync, mkdirSync, readFileSync, symlinkSync, appendFileSync, realpathSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, symlinkSync, appendFileSync, realpathSync, statSync } from "node:fs";
 import { truncateToWidth } from "@earendil-works/pi-tui";
 import { join, dirname } from "node:path";
 
@@ -2411,6 +2412,9 @@ export default async function (pi: ExtensionAPI) {
 	// --- memory: Inject MEMORY.md and USER.md into system prompt -------------
 	void initMemory(pi);
 
+	// --- wiki: Knowledge wiki with search/ingest/lint commands ------------
+	void initWiki(pi);
+
 	// --- ssh-detach-interceptor: Auto-fix bare ssh & → nohup pattern ---------
 	void initSshDetachInterceptor(pi);
 
@@ -2553,7 +2557,7 @@ export default async function (pi: ExtensionAPI) {
 			// the first session to appear afterward is treated as new and greeted.
 			let firstPollDone = false;
 			try {
-				const { getLatestSession } = await import("./packages/codex-watcher/dist/index.js");
+				const { getLatestSession } = await import("./packages/codex-watcher/dist/src/index.js");
 				const baseline = getLatestSession();
 				if (baseline) {
 					codexSessionState.greetingBaselineSessionId = baseline.id;
@@ -2691,7 +2695,7 @@ export default async function (pi: ExtensionAPI) {
 					if (classification !== "plan" && classification !== "mixed" && !hasReviewMarker) continue;
 				
 				// Determine stage (for future use in event metadata)
-				const _stage = hasReviewMarker ? "review" : classification;
+				void classification; // used for classification only
 
 				// Only start settle timer for plans (not reviews)
 				// Reviews don't have a file to watch

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "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.328",
+  "version": "1.1.329",
   "description": "Framework plugin SDK for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/frappe-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/frappe-plugin",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "description": "Frappe/ERPNext framework analysis — DocTypes, hooks, bench sites, site config",
   "type": "module",
   "main": "./dist/index.js",

package/packages/generic-web-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/generic-web-plugin",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "description": "Generic web framework analysis — REST/GraphQL endpoints, OpenAPI, auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/health-monitor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/health-monitor",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "type": "module",
   "description": "Health monitoring and auto-healing",
   "main": "dist/index.js",

package/packages/intent-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/intent-analyzer",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/jev-judge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/jev-judge",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "description": "Jev Judge - Structured decision model for agent routing, E2E testing, and automated decisions",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-graph",
-  "version": "1.1.328",
+  "version": "1.1.329",
   "description": "Knowledge Graph extraction and provenance linking for SKILL.md files",
   "type": "module",
   "main": "./dist/index.js",