pi-harness-runtime 1.1.397 → 1.1.402

package/packages/file-copy-helper/dist/intent-detector.js

@@ -0,0 +1,348 @@
+/**
+ * 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 * as fs from "fs";
+// Debug log file
+const DEBUG_LOG = "/tmp/intent-detector-debug.log";
+function debugLog(label, data) {
+    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
+    }
+}
+// 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 (简体中文)
+    "逆向",
+    "逆向工程",
+    "反编译",
+    "分析二进制",
+    "克隆应用",
+    "复制应用",
+    "理解如何运作",
+    // Thai (ภาษาไทย)
+    "วิเคราะห์ย้อนกลับ",
+    "ย้อนวิศวกรรม",
+    "แกะโค้ด",
+    "ถอดรหัส",
+    "เข้าใจการทำงาน",
+    "คัดลอกแอป",
+    "โคลนแอป",
+    "ทำซ้ำแอป",
+    // 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
+    "克隆",
+    "复制",
+    "迁移",
+    // Thai
+    "คัดลอก",
+    "โคลน",
+    "ทำซ้ำ",
+    "ย้าย",
+    // 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) {
+    const lower = text.toLowerCase();
+    const matchedKeywords = [];
+    // 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, baseIntent, keywords) {
+    // 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
+    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) {
+    // 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() {
+    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() {
+    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) {
+    // 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) => {
+        // 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) => {
+        if (event.source !== "interactive")
+            return;
+        const intent = await detectIntent(event.text);
+        debugLog("BROADCAST_INTENT", intent);
+    });
+}
+// Default export
+export default function intentDetectorExtension(pi) {
+    registerIntentDetector(pi);
+}
+//# sourceMappingURL=intent-detector.js.map

package/packages/file-copy-helper/dist/intent-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-detector.js","sourceRoot":"","sources":["../src/intent-detector.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/file-copy-helper",
-  "version": "1.1.397",
+  "version": "1.1.402",
   "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.397",
+  "version": "1.1.402",
   "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.397",
+  "version": "1.1.402",
   "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.397",
+  "version": "1.1.402",
   "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.397",
+  "version": "1.1.402",
   "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.397",
+  "version": "1.1.402",
   "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.397",
+  "version": "1.1.402",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/jev-judge/dist/auto-continue.d.ts

@@ -19,12 +19,147 @@ export interface TaskState {
     userResponded: boolean;
     lastUserActivity?: Date;
     sessionStartTime: Date;
+    /** The bounded decision context (question, risk, task state). */
+    context?: DecisionContext;
 }
+/**
+ * The typed outcome of a decision.
+ *
+ * It is not the same shape as a human answer: an autonomous decision is
+ * never reported as a user "yes".
+ */
+export type DecisionOutcome = "approve" | "reject" | "wait" | "proceed_with_caution";
+/**
+ * The pending question Jev has to decide about.
+ *
+ * Without it Jev can only see progress, not what the agent asked permission
+ * to do.
+ */
+export interface PendingQuestionContext {
+    /** The canonical request ID. */
+    requestId: string;
+    /** The complete question text. */
+    text: string;
+    /** The detected kind of the question. */
+    kind: "routine" | "approval" | "clarification" | "explicit";
+    /** The exact action the agent proposes. */
+    proposedAction?: string;
+    /** What happens when the question is approved. */
+    consequence?: string;
+    /** Does the action need an explicit human authorization? */
+    requiresExplicitAuthorization?: boolean;
+    /** Does the action destroy or overwrite something? */
+    destructive?: boolean;
+    /** Does the action leave the machine (network, mail, deploy)? */
+    external?: boolean;
+    /** Can the action be undone? */
+    reversible?: boolean;
+}
+/**
+ * The bounded context of a decision.
+ *
+ * Everything is bounded on purpose: an unbounded todo transcript makes the
+ * evaluation input large and expensive without making it better.
+ */
+export interface DecisionContext {
+    question?: PendingQuestionContext;
+    /** The task the session is working on right now. */
+    currentTask?: string;
+    /** 0..1 */
+    completionRatio?: number;
+    totalTasks?: number;
+    completedTasks?: number;
+    /** What blocks the work. */
+    blockers?: string[];
+    /** The next relevant tasks. */
+    nextTasks?: string[];
+    /** The state of the last validation run. */
+    validationStatus?: string;
+    /** How long the question is already waiting. */
+    waitedMinutes?: number;
+    /** When the decision has to be made. */
+    deadlineMinutes?: number;
+    /** When the user was last active. */
+    lastUserActivity?: Date;
+}
+/** How many task titles reach the evaluation. */
+export declare const MAX_LISTED_TASKS = 10;
+/** How much of the question text reaches the evaluation. */
+export declare const MAX_QUESTION_CHARS = 2000;
+/**
+ * The deterministic part of a decision.
+ *
+ * Jev proposes an outcome, this function decides what is actually allowed.
+ * The rules live in code and not in a prompt: a clarification is never
+ * turned into an approval of a guessed interpretation, and an action that
+ * needs an explicit human authorization or that cannot be undone is never
+ * approved autonomously.
+ */
+export interface DecisionPolicyResult {
+    outcome: DecisionOutcome;
+    /** The rule that changed the outcome, when one did. */
+    appliedRule?: string;
+    reason: string;
+}
+export interface DecisionPolicyOptions {
+    /** The confidence an autonomous approval needs. */
+    confidenceThreshold?: number;
+    /** The confidence of the proposed outcome. */
+    confidence?: number;
+}
+/**
+ * Is the value a known outcome?
+ *
+ * The evaluation returns the outcome as a free-text choice: an unknown
+ * value is ignored instead of being guessed.
+ */
+export declare function isDecisionOutcome(value: unknown): value is DecisionOutcome;
+/**
+ * Combine the threshold outcome with the structured outcome of the
+ * evaluation.
+ *
+ * The evaluation may only tighten the decision: a rejection stays a
+ * rejection, a wait stays a wait, and an approval never beats the
+ * thresholds.
+ */
+export declare function tightenOutcome(thresholdOutcome: DecisionOutcome, proposed: DecisionOutcome | undefined): DecisionOutcome;
+/**
+ * Are the risk facts of the proposed action unknown?
+ *
+ * A question without a kind and without a single known risk fact cannot be
+ * judged: the policy waits for the human instead of continuing on a guess.
+ */
+export declare function hasUnknownRiskFacts(question: PendingQuestionContext): boolean;
+export declare function applyDecisionPolicy(proposed: DecisionOutcome, context: DecisionContext | undefined, options?: DecisionPolicyOptions): DecisionPolicyResult;
+/**
+ * What the runtime does with a Jev outcome.
+ *
+ * - `continue`: the work resumes with a steer to the agent.
+ * - `pause`: the work stops and waits for a human.
+ * - `discard`: the decision was stale and must not change anything.
+ * - `wait`: the question stays open for a later decision.
+ */
+export type OutcomeApplication = "continue" | "pause" | "discard" | "wait";
+/**
+ * Decide what a Jev outcome means for the running work.
+ *
+ * `requestClosed` tells whether the pending question was still open and
+ * could be closed with the Jev decision. A closed question is the only
+ * proof that nobody answered in the meantime: when the request was already
+ * answered by a human the Jev decision is stale, and a stale decision must
+ * never continue the work.
+ *
+ * The rule is deterministic: only a successfully closed request may continue
+ * or pause the work, and a rejection never continues it.
+ */
+export declare function decideOutcomeApplication(outcome: DecisionOutcome, requestClosed: boolean): OutcomeApplication;
 /**
  * Auto-continue decision
  */
 export interface AutoContinueDecision {
-    action: "proceed" | "wait" | "proceed_with_caution";
+    action: "proceed" | "wait" | "proceed_with_caution" | "reject";
+    /** The typed outcome after the policy was applied. */
+    outcome: DecisionOutcome;
     probability: number;
     riskLevel: "minimal" | "low" | "medium" | "high" | "critical";
     reasoning: string;
@@ -32,6 +167,8 @@ export interface AutoContinueDecision {
     estimatedImpact: "minimal" | "moderate" | "significant" | "major";
     confidence: "high" | "medium" | "low";
     waitRecommendation?: number;
+    /** The policy rule that changed the outcome, when one did. */
+    policyApplied?: string;
 }
 /**
  * Auto-Continue Judge configuration
@@ -60,6 +197,13 @@ export declare class AutoContinueJudge {
      * Judge whether to continue or wait
      */
     decide(taskState: TaskState): Promise<AutoContinueDecision>;
+    /**
+     * Apply the deterministic policy to a proposed decision.
+     *
+     * The policy is code, not a prompt: it decides what is actually allowed,
+     * and it records which rule changed the outcome.
+     */
+    private applyPolicy;
     /**
      * Quick decision - simple yes/no to proceed
      */
@@ -85,8 +229,23 @@ export declare class AutoContinueJudge {
      */
     private fallbackDecision;
 }
+/**
+ * Is the question old enough for an autonomous decision?
+ *
+ * The threshold belongs to the caller: the judge is only asked once the
+ * question waited long enough.
+ */
+export declare function isEligibleForDecision(waitedMinutes: number, minWaitMinutes: number): boolean;
+/**
+ * The bounded evaluation input of a decision.
+ *
+ * It carries the question Jev has to decide about, the risk of the proposed
+ * action and the relevant task state - and nothing that grows without a
+ * bound.
+ */
+export declare function buildDecisionState(taskState: TaskState): Record<string, unknown>;
 /**
  * Helper: Create task state from todo list
  */
-export declare function createTaskState(completedTasks: string[], remainingTasks: string[], lastUserActivity?: Date, sessionStartTime?: Date): TaskState;
+export declare function createTaskState(completedTasks: string[], remainingTasks: string[], lastUserActivity?: Date, sessionStartTime?: Date, context?: DecisionContext): TaskState;
 //# sourceMappingURL=auto-continue.d.ts.map

package/packages/jev-judge/dist/auto-continue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-continue.d.ts","sourceRoot":"","sources":["../src/auto-continue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACxB,gBAAgB,EAAE,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,sBAAsB,CAAC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChD,eAAe,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,CAAC;IAClE,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,sBAAsB,CAAC;CAC9D;AAYD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAA+B;IAE7C,YAAY,MAAM,EAAE,kBAAkB,EAOrC;IAED;;OAEG;IACG,MAAM,CACV,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAuE/B;IAED;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC;QAAE,cAAc,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAQ/E;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;IA2BlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmErB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA4BzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EAAE,EACxB,cAAc,EAAE,MAAM,EAAE,EACxB,gBAAgB,CAAC,EAAE,IAAI,EACvB,gBAAgB,CAAC,EAAE,IAAI,GACtB,SAAS,CAcX"}
+{"version":3,"file":"auto-continue.d.ts","sourceRoot":"","sources":["../src/auto-continue.ts"],"names":[],"mappings":"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"}