pi-harness-runtime 1.1.236 → 1.1.238

package/packages/jev-judge/src/continuation-controller.ts

@@ -45,6 +45,7 @@ export interface ContinuationState {
 	lastMessageId: string | null;
 	continuationQueued: boolean;
 	userPaused: boolean;
+	explicitPause: boolean;  // True when user explicitly paused
 	lastSteerMessage: string | null;
 	steerAttemptsForCurrentItem: number;
 	lastItemContinued: number | null;
@@ -80,12 +81,15 @@ export class TodoContinuationController {
 		lastMessageId: null,
 		continuationQueued: false,
 		userPaused: false,
+		explicitPause: false,
 		lastSteerMessage: null,
 		steerAttemptsForCurrentItem: 0,
 		lastItemContinued: null,
 		lastEvaluationResult: null,
 	};
 
+	private _inFlight = false;  // Guard against concurrent dispatches
+
 	constructor(ctx: TodoContext, config?: ContinuationConfig) {
 		this.ctx = ctx;
 		this.todoProvider = createTodoProvider(ctx);
@@ -102,8 +106,9 @@ export class TodoContinuationController {
 	 * Check if continuation is allowed (not paused, session idle)
 	 */
 	private canContinue(): boolean {
-		if (this.state.userPaused) {
-			debugLog("TodoContinuation", "User paused, not continuing");
+		// Only blocked by explicit pause, not by temporary user input pause
+		if (this.state.explicitPause) {
+			debugLog("TodoContinuation", "Explicitly paused, not continuing");
 			return false;
 		}
 		if (this.ctx.isIdle?.() === false) {
@@ -117,6 +122,45 @@ export class TodoContinuationController {
 		return true;
 	}
 
+	/**
+	 * User explicitly paused - only this clears on explicit resume
+	 */
+	explicitPause(): void {
+		debugLog("TodoContinuation", "Explicit pause requested");
+		this.state.explicitPause = true;
+		this.state.userPaused = true;
+	}
+
+	/**
+	 * Resume from explicit pause
+	 */
+	resume(): void {
+		if (this.state.explicitPause) {
+			debugLog("TodoContinuation", "Resuming from explicit pause");
+			this.state.explicitPause = false;
+			this.state.userPaused = false;
+			this.clearQueue();
+		}
+	}
+
+	/**
+	 * Temporary pause for user input processing
+	 * Does not require explicit resume
+	 */
+	tempPause(): void {
+		debugLog("TodoContinuation", "Temporary pause for user input");
+		this.state.userPaused = true;
+	}
+
+	/**
+	 * Clear continuation queue (called when work completes or starts)
+	 */
+	clearQueue(): void {
+		this.state.continuationQueued = false;
+		this._inFlight = false;
+		debugLog("TodoContinuation", "Continuation queue cleared");
+	}
+
 	/**
 	 * Public method to evaluate and execute continuation
 	 * Called by external handlers (e.g., agent_settled)
@@ -244,11 +288,18 @@ export class TodoContinuationController {
 
 	/**
 	 * Guarded dispatch - checks all conditions before sending
+	 * Uses in-flight guard to prevent race conditions
 	 */
 	private async guardedDispatch(itemId: number, message: string): Promise<boolean> {
-		// 1. Check if paused by user
-		if (this.state.userPaused) {
-			debugLog("TodoContinuation", "Guarded dispatch: user paused, skipping");
+		// 0. Acquire in-flight guard to prevent concurrent dispatches
+		if (this._inFlight) {
+			debugLog("TodoContinuation", "Guarded dispatch: already in-flight, skipping");
+			return false;
+		}
+
+		// 1. Check if paused by explicit user pause
+		if (this.state.explicitPause) {
+			debugLog("TodoContinuation", "Guarded dispatch: explicitly paused, skipping");
 			return false;
 		}
 
@@ -264,17 +315,20 @@ export class TodoContinuationController {
 			return false;
 		}
 
-		// 4. Verify item still needs work (not completed)
+		// 4. Verify item still needs work (not completed) - acquire guard BEFORE await
+		this._inFlight = true;
 		try {
 			const snapshot = await this.todoProvider.getSnapshot();
 			const item = snapshot.items.find((i) => i.id === itemId);
 			if (item?.status === "completed") {
 				debugLog("TodoContinuation", "Guarded dispatch: item completed, skipping");
+				this._inFlight = false;
 				return false;
 			}
 		} catch {
 			// If we can't read todos, skip dispatch
 			debugLog("TodoContinuation", "Guarded dispatch: failed to read todos, skipping");
+			this._inFlight = false;
 			return false;
 		}
 
@@ -284,10 +338,12 @@ export class TodoContinuationController {
 
 		try {
 			await this.config.dispatch(message);
+			// Queue stays set while agent processes - cleared on agent_settled
 			return true;
 		} catch (err) {
 			debugLog("TodoContinuation", "Guarded dispatch failed:", String(err));
 			this.state.continuationQueued = false;
+			this._inFlight = false;
 			return false;
 		}
 	}
@@ -350,11 +406,13 @@ export class TodoContinuationController {
 			lastMessageId: null,
 			continuationQueued: false,
 			userPaused: false,
+			explicitPause: false,
 			lastSteerMessage: null,
 			steerAttemptsForCurrentItem: 0,
 			lastItemContinued: null,
 			lastEvaluationResult: null,
 		};
+		this._inFlight = false;
 	}
 
 	/**

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,302 @@
+/**
+ * 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";
+	/** Existing todo ID if duplicate/modifies */
+	existingTodoId?: number;
+}
+
+/**
+ * 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> {
+		return this._evaluate(userMessage, existingTodos);
+	}
+
+	/**
+	 * Evaluate with actual todo items from continuation controller
+	 */
+	async evaluateWithTodos(
+		userMessage: string,
+		controller: { getSnapshot: () => Promise<{ items: Array<{ id: number; subject: string; status: string }> }> }
+	): Promise<TaskIntakeResult> {
+		// Get actual todos from the continuation controller
+		let existingTodos: string[] = [];
+		try {
+			const snapshot = await controller.getSnapshot();
+			existingTodos = snapshot.items
+				.filter((i) => i.status !== "completed" && i.status !== "deleted")
+				.map((i) => i.subject);
+		} catch {
+			// Ignore errors, use empty list
+		}
+
+		return this._evaluate(userMessage, existingTodos);
+	}
+
+	/**
+	 * Internal evaluation logic
+	 */
+	private 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
+	 * @param userMessage - The original user message to capture
+	 * @param customType - Optional custom type for the message (default: "task-capture")
+	 */
+	async requestCapture(
+		userMessage: string,
+		customType: string = "task-capture"
+	): Promise<void> {
+		// Build a message to prompt the agent to create todos
+		let message = `[${customType}] Work detected in user request: "${userMessage.slice(0, 200)}"`;
+
+		message += "\n\nPlease 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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.238",
   "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.236",
+  "version": "1.1.238",
   "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.236",
+  "version": "1.1.238",
   "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.236",
+  "version": "1.1.238",
   "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.236",
+  "version": "1.1.238",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/prompt-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-compiler",
-  "version": "1.1.236",
+  "version": "1.1.238",
   "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.236",
+  "version": "1.1.238",
   "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.236",
+  "version": "1.1.238",
   "description": "SDK for building, testing, and registering AI provider adapters",
   "type": "module",
   "main": "./dist/index.js",