pi-harness-runtime 1.1.236 → 1.1.237

package/packages/jev-judge/dist/task-intake.js

@@ -0,0 +1,217 @@
+/**
+ * Task Intake - Automatic todo capture from user requests
+ *
+ * Uses Jev Yes/No judgments to determine:
+ * - Whether a user request should be tracked as work
+ * - Whether it duplicates existing work
+ * - Whether it modifies an existing requirement
+ */
+import { JevJudge } from "./index.js";
+/**
+ * Task Intake Controller
+ *
+ * Evaluates user requests with Jev to determine if they should be
+ * captured as todos for automatic tracking.
+ */
+export class TaskIntakeController {
+    jev = null;
+    config;
+    lastRequest = null;
+    lastResult = null;
+    constructor(config) {
+        this.config = {
+            actionableThreshold: 0.7,
+            ...config,
+        };
+        // Initialize Jev if API key is available
+        if (config.apiKey) {
+            this.jev = new JevJudge(config);
+        }
+    }
+    /**
+     * Check if Jev is available
+     */
+    isAvailable() {
+        return this.jev !== null;
+    }
+    /**
+     * Evaluate a user request for task capture
+     */
+    async evaluate(userMessage, existingTodos = []) {
+        // Deduplicate identical requests
+        if (userMessage === this.lastRequest && this.lastResult) {
+            return this.lastResult;
+        }
+        // Build state for Jev evaluation
+        const state = {
+            userMessage,
+            existingTodos,
+            requestCount: existingTodos.length,
+        };
+        // If Jev is not available, use simple heuristic
+        if (!this.jev) {
+            const result = this.simpleHeuristic(userMessage, existingTodos);
+            this.lastRequest = userMessage;
+            this.lastResult = result;
+            return result;
+        }
+        try {
+            // Ask Jev multiple questions
+            const result = await this.jev.evaluate(state, {
+                is_actionable: {
+                    type: "noul",
+                    instructions: "Does the user message request concrete work or a specific outcome? Ignore greetings, thanks, or status questions.",
+                },
+                is_duplicate: {
+                    type: "noul",
+                    instructions: "Does the user message duplicate work already listed in existingTodos? Check for similar task names or goals.",
+                },
+                modifies_existing: {
+                    type: "noul",
+                    instructions: "Does the user message modify or clarify an existing requirement rather than add new work?",
+                },
+            });
+            const actionable = result.decisions.is_actionable.response.type === "noul"
+                ? result.decisions.is_actionable.response.noul >= this.config.actionableThreshold
+                : false;
+            const isDuplicate = result.decisions.is_duplicate.response.type === "noul"
+                ? result.decisions.is_duplicate.response.noul >= 0.5
+                : false;
+            const modifiesExisting = result.decisions.modifies_existing.response.type === "noul"
+                ? result.decisions.modifies_existing.response.noul >= 0.5
+                : false;
+            // Determine recommended action
+            let action;
+            if (!actionable) {
+                action = "skip";
+            }
+            else if (modifiesExisting) {
+                action = "amend";
+            }
+            else if (isDuplicate) {
+                action = "skip";
+            }
+            else {
+                action = "create";
+            }
+            const finalResult = {
+                actionable,
+                probability: result.decisions.is_actionable.response.type === "noul"
+                    ? result.decisions.is_actionable.response.noul
+                    : 0,
+                isDuplicate,
+                modifiesExisting,
+                action,
+            };
+            this.lastRequest = userMessage;
+            this.lastResult = finalResult;
+            return finalResult;
+        }
+        catch (err) {
+            // On Jev error, fall back to simple heuristic
+            const result = this.simpleHeuristic(userMessage, existingTodos);
+            this.lastRequest = userMessage;
+            this.lastResult = result;
+            return result;
+        }
+    }
+    /**
+     * Simple heuristic when Jev is not available
+     */
+    simpleHeuristic(userMessage, existingTodos) {
+        const lower = userMessage.toLowerCase();
+        // Check for non-actionable patterns
+        const nonActionable = [
+            /^(hi|hello|hey|thanks?|thank you)/i,
+            /how are you/i,
+            /what('s| is) the status/i,
+            /can you help me/i,
+            /just checking/i,
+        ];
+        for (const pattern of nonActionable) {
+            if (pattern.test(lower)) {
+                return {
+                    actionable: false,
+                    probability: 0,
+                    isDuplicate: false,
+                    modifiesExisting: false,
+                    action: "skip",
+                };
+            }
+        }
+        // Check for actionable patterns
+        const actionablePatterns = [
+            /\bfix\b/i,
+            /\bimplement\b/i,
+            /\badd\b/i,
+            /\bremove\b/i,
+            /\bcreate\b/i,
+            /\bupdate\b/i,
+            /\bchange\b/i,
+            /\bplease\b/i,
+            /\bi need\b/i,
+            /\bi want\b/i,
+            /\bcan you\b/i,
+            /\bcould you\b/i,
+        ];
+        let probability = 0;
+        for (const pattern of actionablePatterns) {
+            if (pattern.test(lower)) {
+                probability = Math.min(probability + 0.2, 0.8);
+            }
+        }
+        // Check for duplicates
+        let isDuplicate = false;
+        for (const todo of existingTodos) {
+            const todoLower = todo.toLowerCase();
+            // Simple word overlap check
+            const words = lower.split(/\s+/).filter(w => w.length > 3);
+            const overlap = words.filter(w => todoLower.includes(w)).length;
+            if (overlap >= 2) {
+                isDuplicate = true;
+                break;
+            }
+        }
+        const actionable = probability >= 0.3 && !isDuplicate;
+        return {
+            actionable,
+            probability,
+            isDuplicate,
+            modifiesExisting: false,
+            action: actionable ? "create" : "skip",
+        };
+    }
+    /**
+     * Dispatch a capture request to the agent
+     */
+    async requestCapture(userMessage, existingTodos = []) {
+        const result = await this.evaluate(userMessage, existingTodos);
+        if (result.action === "skip") {
+            return;
+        }
+        // Build a message to prompt the agent to create todos
+        let message = "Work detected in user request. ";
+        if (result.isDuplicate) {
+            message += "Potential duplicate detected. ";
+        }
+        if (result.modifiesExisting) {
+            message += "Existing task modification detected. ";
+        }
+        message += `Please capture this work in the todo list if not already tracked.`;
+        await this.config.dispatch(message);
+    }
+    /**
+     * Reset state
+     */
+    reset() {
+        this.lastRequest = null;
+        this.lastResult = null;
+    }
+}
+/**
+ * Create a task intake controller
+ */
+export function createTaskIntake(config) {
+    return new TaskIntakeController(config);
+}
+//# sourceMappingURL=task-intake.js.map

package/packages/jev-judge/dist/task-intake.js.map

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

package/packages/jev-judge/package.json

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

package/packages/jev-judge/src/index.ts

@@ -39,7 +39,6 @@ import type {
   JevEvaluationResult,
   JevNoulResponse,
   JevChoiceResponse,
-  JevScoreResponse,
   ThresholdDecision,
 } from "./types.js";
 
@@ -427,7 +426,7 @@ export type { TaskState, AutoContinueDecision, AutoContinueConfig } from "./auto
 
 // Export WrapUpJudge
 export { checkWrapUp, getTodoSummary } from "./wrap-up-judge.js";
-export type { TodoItem, WrapUpResult } from "./wrap-up-judge.js";
+export type { WrapUpResult } from "./wrap-up-judge.js";
 
 // Export EnvironmentJudge
 export { EnvironmentJudge } from "./environment-judge.js";
@@ -442,5 +441,9 @@ export { TodoContinuationController, createTodoContinuation } from "./continuati
 export type { ContinuationConfig, ContinuationState, ContinuationResult } from "./continuation-controller.js";
 
 // Export TodoProvider
-export { createTodoProvider, PiUnavailableTodoProvider } from "./todo-provider.js";
-export type { TodoProvider, TodoProviderAvailability } from "./todo-provider.js";
+export { createTodoProvider } from "./todo-provider.js";
+export type { TodoProvider, TodoAvailability, TodoItem, TodoStatus, TodoSnapshot, TodoContext } from "./todo-provider.js";
+
+// Export Task Intake
+export { TaskIntakeController, createTaskIntake } from "./task-intake.js";
+export type { TaskIntakeConfig, TaskIntakeResult } from "./task-intake.js";

package/packages/jev-judge/src/task-intake.ts

@@ -0,0 +1,281 @@
+/**
+ * Task Intake - Automatic todo capture from user requests
+ *
+ * Uses Jev Yes/No judgments to determine:
+ * - Whether a user request should be tracked as work
+ * - Whether it duplicates existing work
+ * - Whether it modifies an existing requirement
+ */
+
+import { JevJudge } from "./index.js";
+import type { JevJudgeConfig } from "./types.js";
+
+/**
+ * Task intake configuration
+ */
+export interface TaskIntakeConfig extends JevJudgeConfig {
+	/** Minimum noul threshold for capturing as actionable */
+	actionableThreshold?: number;
+	/** Dispatch function to send messages to the agent */
+	dispatch: (content: string) => Promise<void>;
+}
+
+/**
+ * Result of task intake evaluation
+ */
+export interface TaskIntakeResult {
+	/** Whether the request should be captured as actionable work */
+	actionable: boolean;
+	/** Probability that it's actionable (0-1) */
+	probability: number;
+	/** Whether it duplicates existing work */
+	isDuplicate: boolean;
+	/** Whether it modifies an existing requirement */
+	modifiesExisting: boolean;
+	/** Recommended action */
+	action: "create" | "skip" | "amend" | "investigate";
+}
+
+/**
+ * Task Intake Controller
+ *
+ * Evaluates user requests with Jev to determine if they should be
+ * captured as todos for automatic tracking.
+ */
+export class TaskIntakeController {
+	private jev: JevJudge | null = null;
+	private config: Required<TaskIntakeConfig>;
+	private lastRequest: string | null = null;
+	private lastResult: TaskIntakeResult | null = null;
+
+	constructor(config: TaskIntakeConfig) {
+		this.config = {
+			actionableThreshold: 0.7,
+			...config,
+		} as Required<TaskIntakeConfig>;
+
+		// Initialize Jev if API key is available
+		if (config.apiKey) {
+			this.jev = new JevJudge(config as JevJudgeConfig);
+		}
+	}
+
+	/**
+	 * Check if Jev is available
+	 */
+	isAvailable(): boolean {
+		return this.jev !== null;
+	}
+
+	/**
+	 * Evaluate a user request for task capture
+	 */
+	async evaluate(
+		userMessage: string,
+		existingTodos: string[] = []
+	): Promise<TaskIntakeResult> {
+		// Deduplicate identical requests
+		if (userMessage === this.lastRequest && this.lastResult) {
+			return this.lastResult;
+		}
+
+		// Build state for Jev evaluation
+		const state = {
+			userMessage,
+			existingTodos,
+			requestCount: existingTodos.length,
+		};
+
+		// If Jev is not available, use simple heuristic
+		if (!this.jev) {
+			const result = this.simpleHeuristic(userMessage, existingTodos);
+			this.lastRequest = userMessage;
+			this.lastResult = result;
+			return result;
+		}
+
+		try {
+			// Ask Jev multiple questions
+			const result = await this.jev.evaluate(state, {
+				is_actionable: {
+					type: "noul",
+					instructions:
+						"Does the user message request concrete work or a specific outcome? Ignore greetings, thanks, or status questions.",
+				},
+				is_duplicate: {
+					type: "noul",
+					instructions:
+						"Does the user message duplicate work already listed in existingTodos? Check for similar task names or goals.",
+				},
+				modifies_existing: {
+					type: "noul",
+					instructions:
+						"Does the user message modify or clarify an existing requirement rather than add new work?",
+				},
+			});
+
+			const actionable = result.decisions.is_actionable.response.type === "noul"
+				? result.decisions.is_actionable.response.noul >= this.config.actionableThreshold
+				: false;
+			const isDuplicate = result.decisions.is_duplicate.response.type === "noul"
+				? result.decisions.is_duplicate.response.noul >= 0.5
+				: false;
+			const modifiesExisting = result.decisions.modifies_existing.response.type === "noul"
+				? result.decisions.modifies_existing.response.noul >= 0.5
+				: false;
+
+			// Determine recommended action
+			let action: TaskIntakeResult["action"];
+			if (!actionable) {
+				action = "skip";
+			} else if (modifiesExisting) {
+				action = "amend";
+			} else if (isDuplicate) {
+				action = "skip";
+			} else {
+				action = "create";
+			}
+
+			const finalResult: TaskIntakeResult = {
+				actionable,
+				probability: result.decisions.is_actionable.response.type === "noul"
+					? result.decisions.is_actionable.response.noul
+					: 0,
+				isDuplicate,
+				modifiesExisting,
+				action,
+			};
+
+			this.lastRequest = userMessage;
+			this.lastResult = finalResult;
+			return finalResult;
+		} catch (err) {
+			// On Jev error, fall back to simple heuristic
+			const result = this.simpleHeuristic(userMessage, existingTodos);
+			this.lastRequest = userMessage;
+			this.lastResult = result;
+			return result;
+		}
+	}
+
+	/**
+	 * Simple heuristic when Jev is not available
+	 */
+	private simpleHeuristic(
+		userMessage: string,
+		existingTodos: string[]
+	): TaskIntakeResult {
+		const lower = userMessage.toLowerCase();
+
+		// Check for non-actionable patterns
+		const nonActionable = [
+			/^(hi|hello|hey|thanks?|thank you)/i,
+			/how are you/i,
+			/what('s| is) the status/i,
+			/can you help me/i,
+			/just checking/i,
+		];
+
+		for (const pattern of nonActionable) {
+			if (pattern.test(lower)) {
+				return {
+					actionable: false,
+					probability: 0,
+					isDuplicate: false,
+					modifiesExisting: false,
+					action: "skip",
+				};
+			}
+		}
+
+		// Check for actionable patterns
+		const actionablePatterns = [
+			/\bfix\b/i,
+			/\bimplement\b/i,
+			/\badd\b/i,
+			/\bremove\b/i,
+			/\bcreate\b/i,
+			/\bupdate\b/i,
+			/\bchange\b/i,
+			/\bplease\b/i,
+			/\bi need\b/i,
+			/\bi want\b/i,
+			/\bcan you\b/i,
+			/\bcould you\b/i,
+		];
+
+		let probability = 0;
+		for (const pattern of actionablePatterns) {
+			if (pattern.test(lower)) {
+				probability = Math.min(probability + 0.2, 0.8);
+			}
+		}
+
+		// Check for duplicates
+		let isDuplicate = false;
+		for (const todo of existingTodos) {
+			const todoLower = todo.toLowerCase();
+			// Simple word overlap check
+			const words = lower.split(/\s+/).filter(w => w.length > 3);
+			const overlap = words.filter(w => todoLower.includes(w)).length;
+			if (overlap >= 2) {
+				isDuplicate = true;
+				break;
+			}
+		}
+
+		const actionable = probability >= 0.3 && !isDuplicate;
+
+		return {
+			actionable,
+			probability,
+			isDuplicate,
+			modifiesExisting: false,
+			action: actionable ? "create" : "skip",
+		};
+	}
+
+	/**
+	 * Dispatch a capture request to the agent
+	 */
+	async requestCapture(
+		userMessage: string,
+		existingTodos: string[] = []
+	): Promise<void> {
+		const result = await this.evaluate(userMessage, existingTodos);
+
+		if (result.action === "skip") {
+			return;
+		}
+
+		// Build a message to prompt the agent to create todos
+		let message = "Work detected in user request. ";
+
+		if (result.isDuplicate) {
+			message += "Potential duplicate detected. ";
+		}
+
+		if (result.modifiesExisting) {
+			message += "Existing task modification detected. ";
+		}
+
+		message += `Please capture this work in the todo list if not already tracked.`;
+
+		await this.config.dispatch(message);
+	}
+
+	/**
+	 * Reset state
+	 */
+	reset(): void {
+		this.lastRequest = null;
+		this.lastResult = null;
+	}
+}
+
+/**
+ * Create a task intake controller
+ */
+export function createTaskIntake(config: TaskIntakeConfig): TaskIntakeController {
+	return new TaskIntakeController(config);
+}

package/packages/knowledge-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-graph",
-  "version": "1.1.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "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.236",
+  "version": "1.1.237",
   "description": "Performance optimization analyzer for pi-harness runtime (RFC-0056)",
   "type": "module",
   "main": "./dist/index.js",