pi-harness-runtime 1.1.198 → 1.1.199

package/packages/file-copy-helper/src/intent-detector.ts

@@ -0,0 +1,393 @@
+/**
+ * Intent Detector - Routes user requests to appropriate modules
+ *
+ * Detects user intent from keywords and activates relevant modules.
+ * DEBUG: All events logged to /tmp/intent-detector-debug.log (NOT TUI)
+ */
+
+import type { ExtensionAPI, InputEvent, InputEventResult } from "@earendil-works/pi-coding-agent";
+import * as fs from "fs";
+
+// Debug log file
+const DEBUG_LOG = "/tmp/intent-detector-debug.log";
+
+function debugLog(label: string, data?: unknown): void {
+	const timestamp = new Date().toISOString();
+	const entry = `[${timestamp}] [${label}] ${data ? JSON.stringify(data, null, 2) : ""}\n`;
+	try {
+		fs.appendFileSync(DEBUG_LOG, entry);
+	} catch {
+		// Silently fail
+	}
+}
+
+// Intent types
+export type IntentType =
+	| "rea"           // Reverse engineering / app analysis
+	| "file_copy"     // Mimic, clone, copy files
+	| "code_review"   // Review code
+	| "security"      // Security audit
+	| "general";      // Default
+
+// Intent result
+export interface IntentResult {
+	type: IntentType;
+	confidence: number;  // 0-1
+	keywords: string[];  // Matched keywords
+	module: string;      // Module to activate
+	guidance?: string;   // Optional brief guidance
+}
+
+// REA Keywords - Reverse Engineering / App Analysis
+const REA_KEYWORDS = [
+	// English
+	"reverse engineer",
+	"reverse engineering",
+	"rea",
+	"analyze binary",
+	"decompile",
+	"disassemble",
+	"inspect binary",
+	"understand how",
+	"replicate app",
+	"clone app",
+	"copy app",
+	"mimic app",
+	// Chinese
+	"逆向",
+	"逆向工程",
+	"反编译",
+	"分析二进制",
+	"克隆应用",
+	"复制应用",
+	// Common patterns
+	"see a feature",
+	"understand.*binary",
+];
+
+// File Copy Keywords
+const FILE_COPY_KEYWORDS = [
+	// English
+	"mimic",
+	"clone",
+	"replicate",
+	"copy file",
+	"copy folder",
+	"copy from",
+	"migrate",
+	"deploy",
+	"sync to",
+	// Chinese
+	"克隆",
+	"复制",
+	"迁移",
+	// Code patterns
+	"cp -r",
+	"sudo cp",
+];
+
+// Code Review Keywords
+const CODE_REVIEW_KEYWORDS = [
+	"review code",
+	"review this",
+	"audit",
+	"check for bugs",
+	"security audit",
+	"find vulnerabilities",
+];
+
+// Security Keywords
+const SECURITY_KEYWORDS = [
+	"security",
+	"vulnerability",
+	"exploit",
+	"attack",
+	"pentest",
+	"penetration test",
+];
+
+/**
+ * Detect user intent from text using keyword matching
+ */
+function keywordDetect(text: string): { type: IntentType; keywords: string[] } {
+	const lower = text.toLowerCase();
+	const matchedKeywords: string[] = [];
+
+	// Check REA keywords (highest priority for reverse engineering)
+	for (const keyword of REA_KEYWORDS) {
+		if (keyword.startsWith("^")) {
+			if (new RegExp(keyword, "i").test(text)) {
+				matchedKeywords.push(keyword);
+			}
+		} else if (lower.includes(keyword.toLowerCase())) {
+			matchedKeywords.push(keyword);
+		}
+	}
+	if (matchedKeywords.length > 0) {
+		return { type: "rea", keywords: matchedKeywords };
+	}
+
+	// Check File Copy keywords
+	matchedKeywords.length = 0;
+	for (const keyword of FILE_COPY_KEYWORDS) {
+		if (lower.includes(keyword.toLowerCase())) {
+			matchedKeywords.push(keyword);
+		}
+	}
+	if (matchedKeywords.length > 0) {
+		return { type: "file_copy", keywords: matchedKeywords };
+	}
+
+	// Check Code Review keywords
+	matchedKeywords.length = 0;
+	for (const keyword of CODE_REVIEW_KEYWORDS) {
+		if (lower.includes(keyword.toLowerCase())) {
+			matchedKeywords.push(keyword);
+		}
+	}
+	if (matchedKeywords.length > 0) {
+		return { type: "code_review", keywords: matchedKeywords };
+	}
+
+	// Check Security keywords
+	matchedKeywords.length = 0;
+	for (const keyword of SECURITY_KEYWORDS) {
+		if (lower.includes(keyword.toLowerCase())) {
+			matchedKeywords.push(keyword);
+		}
+	}
+	if (matchedKeywords.length > 0) {
+		return { type: "security", keywords: matchedKeywords };
+	}
+
+	return { type: "general", keywords: [] };
+}
+
+/**
+ * Jev-based intent classifier for ambiguous cases
+ */
+async function jevClassify(
+	_text: string,
+	baseIntent: IntentType,
+	keywords: string[],
+): Promise<{ confirmed: boolean; confidence: number; reasoning: string }> {
+	// For clear cases (high keyword count), skip Jev
+	if (keywords.length >= 2) {
+		return {
+			confirmed: true,
+			confidence: Math.min(1, keywords.length * 0.3),
+			reasoning: `Strong keyword match: ${keywords.join(", ")}`,
+		};
+	}
+
+	// For ambiguous cases, use Jev judgment
+	// This would integrate with the JevJudge from jev-judge package
+	// For now, return based on single keyword presence
+	
+	if (baseIntent === "rea") {
+		return {
+			confirmed: keywords.length >= 1,
+			confidence: 0.5,
+			reasoning: "Single REA keyword detected - confirming with context",
+		};
+	}
+
+	if (baseIntent === "file_copy") {
+		return {
+			confirmed: keywords.length >= 1,
+			confidence: 0.5,
+			reasoning: "Single file copy keyword detected - confirming with context",
+		};
+	}
+
+	return {
+		confirmed: false,
+		confidence: 0,
+		reasoning: "No clear intent detected",
+	};
+}
+
+/**
+ * Detect user intent from text
+ */
+async function detectIntent(text: string): Promise<IntentResult> {
+	// Step 1: Keyword-based detection
+	const { type, keywords } = keywordDetect(text);
+
+	// Step 2: Jev-based confirmation for ambiguous cases
+	const jevResult = await jevClassify(text, type, keywords);
+
+	if (!jevResult.confirmed) {
+		return {
+			type: "general",
+			confidence: 0,
+			keywords: [],
+			module: "default",
+		};
+	}
+
+	// Step 3: Build result based on confirmed intent
+	const confidence = jevResult.confidence || Math.min(1, keywords.length * 0.3);
+
+	if (type === "rea") {
+		return {
+			type: "rea",
+			confidence,
+			keywords,
+			module: "@pi-harness/rea",
+			guidance: "REA: Use Hopper/Ghidra/IDA for binary analysis. Check https://github.com/morluto/rea",
+		};
+	}
+
+	if (type === "file_copy") {
+		return {
+			type: "file_copy",
+			confidence,
+			keywords,
+			module: "@pi-harness/file-copy-helper",
+			guidance: "COPY: Use sudo cp instead of reading files first",
+		};
+	}
+
+	if (type === "code_review") {
+		return {
+			type: "code_review",
+			confidence,
+			keywords,
+			module: "@pi-harness/code-review",
+		};
+	}
+
+	if (type === "security") {
+		return {
+			type: "security",
+			confidence,
+			keywords,
+			module: "@pi-harness/security-auditor",
+		};
+	}
+
+	return {
+		type: "general",
+		confidence: 0,
+		keywords: [],
+		module: "default",
+	};
+}
+
+/**
+ * Get REA knowledge base reference
+ */
+function getREAKnowledge(): string {
+	return `
+## REA Integration - Reverse Engineering
+
+When user requests reverse engineering or app analysis:
+
+1. **Check REA capabilities**: https://github.com/morluto/rea
+
+2. **Analysis Providers Available**:
+   - Hopper Disassembler (macOS native)
+   - Ghidra (cross-platform)
+   - IDA Pro (commercial)
+   - Pwntools (ELF/binary analysis)
+   - Browser CDP (web app inspection)
+   - Android APK (JADX decompilation)
+
+3. **Key REA Workflow**:
+   - Setup REA MCP server with agent
+   - Agent asks "analyze this binary"
+   - REA routes to appropriate provider
+   - Evidence recorded to InvestigationRecords
+   - Agent summarizes findings
+
+4. **No binary?** Use browser inspection:
+   - CDP for web apps
+   - Source maps for JS
+   - AST analysis for bundles
+`;
+}
+
+/**
+ * Get file copy guidance
+ */
+function getFileCopyGuidance(): string {
+	return `
+## File Copy - Use sudo cp
+
+When user asks to mimic/clone/copy files:
+
+1. **DO NOT read source files** - just copy directly
+2. **Use sudo cp** - preserves permissions
+3. **Copy recursively** with -r for folders
+
+Examples:
+\`\`\`bash
+sudo cp /source/file.ts /dest/file.ts
+sudo cp -r /source/folder/ /dest/folder/
+\`\`\`
+
+**STOP**: No read/cat/expand needed. Copy preserves everything.
+`;
+}
+
+/**
+ * Register the intent detector extension
+ */
+export function registerIntentDetector(pi: ExtensionAPI): void {
+	// Clear debug log on startup
+	fs.writeFileSync(DEBUG_LOG, `[${new Date().toISOString()}] === INTENT DETECTOR STARTED ===\n`);
+
+	debugLog("INIT", "Intent detector registered");
+
+	// Listen to input events
+	pi.on("input", async (event: InputEvent): Promise<InputEventResult | undefined> => {
+		// Only process user input
+		if (event.source !== "interactive") {
+			return;
+		}
+
+		const text = event.text.trim();
+		if (!text || text.length < 5) {
+			return;
+		}
+
+		// Detect intent with Jev classification
+		const intent = await detectIntent(text);
+		debugLog("DETECTED", intent);
+
+		// If high confidence, inject guidance
+		if (intent.confidence >= 0.5 && intent.type !== "general") {
+			let guidance = "";
+
+			if (intent.type === "rea") {
+				guidance = getREAKnowledge();
+			} else if (intent.type === "file_copy") {
+				guidance = getFileCopyGuidance();
+			}
+
+			if (guidance) {
+				debugLog("INJECT_GUIDANCE", { type: intent.type, confidence: intent.confidence });
+				return {
+					action: "transform",
+					text: text + guidance,
+				};
+			}
+		}
+
+		return;
+	});
+
+	// Broadcast intent for other modules
+	pi.on("input", async (event: InputEvent) => {
+		if (event.source !== "interactive") return;
+
+		const intent = await detectIntent(event.text);
+		debugLog("BROADCAST_INTENT", intent);
+	});
+}
+
+// Default export
+export default function intentDetectorExtension(pi: ExtensionAPI): void {
+	registerIntentDetector(pi);
+}

package/packages/framework-detector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-detector",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "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.198",
+  "version": "1.1.199",
   "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.198",
+  "version": "1.1.199",
   "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.198",
+  "version": "1.1.199",
   "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.198",
+  "version": "1.1.199",
   "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.198",
+  "version": "1.1.199",
   "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.198",
+  "version": "1.1.199",
   "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.198",
+  "version": "1.1.199",
   "description": "Knowledge Graph extraction and provenance linking for SKILL.md files",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-retrieval/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-retrieval",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Knowledge retrieval via TencentDB-Agent-Memory MCP (RFC-0105)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/laravel-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/laravel-plugin",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Laravel framework analysis — artisan commands, Eloquent models, Blade",
   "type": "module",
   "main": "./dist/index.js",

package/packages/learning-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/learning-engine",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Learning engine for extracting lessons from runtime execution (RFC-0058)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/mcp-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/mcp-adapter",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "type": "module",
   "description": "MCP server adapter for pi-harness — exposes harness capabilities as MCP tools/resources/prompts (RFC-0068)",
   "main": "dist/index.js",

package/packages/memory-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/memory-engine",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Memory engine with OKF integration for durable knowledge management (RFC-0060)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/milestone-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/milestone-manager",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Track milestones and alerts when items are at risk",
   "type": "module",
   "main": "./dist/index.js",

package/packages/model-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/model-registry",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Model Registry for pi-harness-runtime — centralized model metadata with pricing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/nextjs-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/nextjs-plugin",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Next.js framework detection and analysis for pi-harness-runtime (RFC-0062)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/notification/package.json

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

package/packages/observability/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/observability",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Comprehensive observability system with structured logging, tracing, metrics, and alerting",
   "type": "module",
   "main": "./dist/index.js",

package/packages/okf-indexer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/okf-indexer",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "OKF document indexer for SKILL.md files (RFC-0106)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/paperclip-integration/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/paperclip-integration",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Paperclip API integration: poll agent inbox, route tasks to pi.dev, Telegram alerts",
   "type": "module",
   "main": "./dist/index.js",

package/packages/performance-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/performance-optimizer",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Performance optimization analyzer for pi-harness runtime (RFC-0056)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/privilege-broker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/privilege-broker",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Privilege Broker — capability registry and command executor for autonomous runtime (RFC-0101 §7)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/project-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/project-analyzer",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Project analysis system for pi-harness-runtime - detects frameworks, rules, and project structure",
   "type": "module",
   "main": "./dist/index.js",

package/packages/project-bootstrap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/project-bootstrap",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Project scaffolding from typed ProjectSpec",
   "type": "module",
   "main": "./dist/index.js",

package/packages/projection-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/projection-engine",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/prompt-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-compiler",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Deterministic prompt compiler for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/prompt-versioning/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-versioning",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "type": "module",
   "description": "Version control for prompts with rollback support (RFC-0019)",
   "main": "dist/index.js",

package/packages/provider-adapter-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/provider-adapter-sdk",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "SDK for building, testing, and registering AI provider adapters",
   "type": "module",
   "main": "./dist/index.js",

package/packages/provider-router/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/provider-router",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Enhanced Provider Router for pi-harness-runtime — intelligent routing with capabilities, costs, and quotas",
   "type": "module",
   "main": "./dist/provider-router.js",

package/packages/provider-selector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/provider-selector",
-  "version": "1.1.198",
+  "version": "1.1.199",
   "description": "Multi-Provider Selector — route requests by cost, quality, and latency (RFC-0012)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/providers/package.json

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