pi-harness-runtime 1.1.350 → 1.1.352

package/README.md

@@ -30,10 +30,13 @@ pi install npm:pi-harness-runtime
 This runtime works best with these extensions (auto-installed by pi-harness-runtime):
 
 ```bash
+pi install npm:pi-subagents     # Sub-agent orchestration for large refactors
 pi install npm:pi-mcp-adapter    # MCP protocol adapter for external tools
 pi install npm:@juicesharp/rpiv-todo  # Task tracking with bd sync
 ```
 
+The `pi-subagents` extension enables delegation assessment and parallel task execution for large refactoring work (10+ files, 50+ call sites).
+
 Requires Pi v0.37.3+.
 
 ### Headless Server Setup (herdr clipboard bridge)

package/index.ts

@@ -276,22 +276,20 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 			return content;
 		}
 
-		// Detect actual confirmation requests (questions, not progress statements)
-		// Uses the pending question controller for detection with expanded patterns
-		function detectConfirmationRequest(text: string): string | null {
-			const result = pqController.detectQuestion(text);
-			if (result.detected && result.questionText) {
-				return result.questionText;
+		// Set up pending question callback to dispatch answers to Pi
+		pqController.onUserAnswer((question, answer) => {
+			logToFile("[PendingQuestion]", `User answered: ${answer} for question ${question.requestId}`);
+			// Dispatch answer to Pi if needed
+			if (answer === "yes") {
+				pi.sendUserMessage("yes", { deliverAs: "steer" }).catch((_e: unknown) =>
+					logToFile("[PendingQuestion]", "Failed to send yes to Pi")
+				);
+			} else if (answer === "no") {
+				pi.sendUserMessage("not yet", { deliverAs: "steer" }).catch((_e: unknown) =>
+					logToFile("[PendingQuestion]", "Failed to send no to Pi")
+				);
 			}
-			return null;
-		}
-
-		// Detect routine continuation questions ("Should I continue?")
-		// These should NOT block immediate continuation - let Jev/todo controller decide
-		function isRoutineContinuation(question: string): boolean {
-			const result = pqController.detectQuestion(question);
-			return result.isRoutine ?? false;
-		}
+		});
 
 		// Detect when agent asks for continuation
 		pi.on("message_end", async (event) => {
@@ -299,22 +297,33 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 			if (!msg || msg.role !== "assistant") return;
 
 			const content = extractAssistantText(msg);
-			const detectedQuestion = detectConfirmationRequest(content);
+			const result = pqController.detectQuestion(content);
 
 			// Only trigger if: we found a question AND it's different from last notification
 			// Skip routine continuation questions - let Jev/todo controller decide
-			if (detectedQuestion && detectedQuestion !== _lastNotifiedQuestion && !waitingForUserSince) {
+			if (result.detected && result.questionText && result.questionText !== _lastNotifiedQuestion && !waitingForUserSince) {
 				// Skip routine continuation - don't block automatic continuation
-				if (isRoutineContinuation(detectedQuestion)) {
-						logToFile("[auto-continue]", "Routine continuation detected, not blocking");
-						return;
+				if (result.isRoutine) {
+					logToFile("[auto-continue]", "Routine continuation detected, not blocking");
+					return;
 				}
-				_lastNotifiedQuestion = detectedQuestion;
+				
+				// Create question in controller
+				const question = pqController.createQuestion({
+					text: result.questionText,
+					sessionId: _sessionId,
+					workspacePath: _piSessionCwd || "/",
+					kind: result.kind || "approval",
+				});
+				
+				logToFile("[PendingQuestion]", `Question created: ${question.requestId} - ${result.questionText?.slice(0, 50)}`);
+
+				_lastNotifiedQuestion = result.questionText;
 				waitingForUserSince = new Date();
 
 				// Create stable jobId from question content hash (callback-safe: digits only)
 				const questionHash = Math.abs(
-					detectedQuestion.split("").reduce((a, c) => {
+					result.questionText.split("").reduce((a, c) => {
 						a = ((a << 5) - a) + c.charCodeAt(0);
 						return a & a;
 					}, 0)
@@ -336,7 +345,7 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 				// Emit WaitingForUserInput to Telegram with Yes/No buttons
 				_nc?.notifyWithApproval("WaitingForUserInput", {
 					jobId: `waiting-user-${questionHash}`,
-					requirement: detectedQuestion,
+					requirement: result.questionText,
 				}, {
 					approveLabel: "Continue",
 					rejectLabel: "Not yet",

package/package.json

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

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.350",
+  "version": "1.1.352",
   "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.350",
+  "version": "1.1.352",
   "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.350",
+  "version": "1.1.352",
   "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.350",
+  "version": "1.1.352",
   "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.350",
+  "version": "1.1.352",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/connection-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/connection-runtime",
-  "version": "1.1.350",
+  "version": "1.1.352",
   "type": "module",
   "description": "Connection management with jittered exponential backoff for pi-harness",
   "main": "./dist/index.js",

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "1.1.350",
+  "version": "1.1.352",
   "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.350",
+  "version": "1.1.352",
   "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.350",
+  "version": "1.1.352",
   "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/contracts/dist/delegation-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Delegation Store
+ *
+ * Durable storage for delegation receipts.
+ * Stores in ignored harness state directory.
+ */
+import type { DelegationReceipt } from "./delegation.js";
+/**
+ * Save delegation receipt
+ */
+export declare function saveDelegationReceipt(receipt: DelegationReceipt): void;
+/**
+ * Load delegation receipt
+ */
+export declare function loadDelegationReceipt(workspacePath: string, taskId: string): DelegationReceipt | null;
+/**
+ * Delete delegation receipt
+ */
+export declare function deleteDelegationReceipt(workspacePath: string, taskId: string): void;
+/**
+ * List all receipts for a workspace
+ */
+export declare function listDelegationReceipts(workspacePath: string): DelegationReceipt[];
+/**
+ * Update receipt status
+ */
+export declare function updateReceiptStatus(workspacePath: string, taskId: string, status: DelegationReceipt["status"], updates?: Partial<DelegationReceipt>): DelegationReceipt | null;
+/**
+ * Check if receipt exists for task
+ */
+export declare function hasReceipt(workspacePath: string, taskId: string): boolean;
+/**
+ * Compact receipt for storage after compaction
+ */
+export declare function compactReceipt(receipt: DelegationReceipt): DelegationReceipt;

package/packages/contracts/dist/delegation-store.js

@@ -0,0 +1,172 @@
+/**
+ * Delegation Store
+ *
+ * Durable storage for delegation receipts.
+ * Stores in ignored harness state directory.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+/**
+ * Store directory path
+ */
+const STORE_DIR = join(process.env.HOME || "/home/frappe", ".pi-harness-runtime", "delegation-state");
+/**
+ * Ensure store directory exists
+ */
+function ensureStoreDir() {
+    if (!existsSync(STORE_DIR)) {
+        mkdirSync(STORE_DIR, { recursive: true });
+    }
+}
+/**
+ * Get receipt file path for workspace + task
+ */
+function getReceiptPath(workspacePath, taskId) {
+    // Sanitize path for use as filename
+    const safePath = workspacePath.replace(/[^a-zA-Z0-9_-]/g, "_").slice(-100);
+    const safeTask = taskId.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(STORE_DIR, `${safePath}__${safeTask}.json`);
+}
+/**
+ * Save delegation receipt
+ */
+export function saveDelegationReceipt(receipt) {
+    ensureStoreDir();
+    const path = getReceiptPath(receipt.workspacePath, receipt.parentTaskId);
+    // Atomic write: write to temp, then rename
+    const tempPath = path + ".tmp";
+    writeFileSync(tempPath, JSON.stringify(receipt, null, 2), "utf8");
+    // Rename is atomic on POSIX
+    try {
+        const { renameSync } = require("fs");
+        renameSync(tempPath, path);
+    }
+    catch {
+        // Fallback: just move the file
+        try {
+            writeFileSync(path, JSON.stringify(receipt, null, 2), "utf8");
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+}
+/**
+ * Load delegation receipt
+ */
+export function loadDelegationReceipt(workspacePath, taskId) {
+    const path = getReceiptPath(workspacePath, taskId);
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(path, "utf8");
+        const receipt = JSON.parse(content);
+        // Validate version
+        if (receipt.version !== 1) {
+            // Future migration logic would go here
+            return null;
+        }
+        return receipt;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete delegation receipt
+ */
+export function deleteDelegationReceipt(workspacePath, taskId) {
+    const path = getReceiptPath(workspacePath, taskId);
+    if (existsSync(path)) {
+        try {
+            const { unlinkSync } = require("fs");
+            unlinkSync(path);
+        }
+        catch {
+            // Ignore delete errors
+        }
+    }
+}
+/**
+ * List all receipts for a workspace
+ */
+export function listDelegationReceipts(workspacePath) {
+    ensureStoreDir();
+    const receipts = [];
+    try {
+        const { readdirSync } = require("fs");
+        const files = readdirSync(STORE_DIR);
+        const safePathPrefix = workspacePath.replace(/[^a-zA-Z0-9_-]/g, "_").slice(-100) + "__";
+        for (const file of files) {
+            if (!file.startsWith(safePathPrefix) || !file.endsWith(".json")) {
+                continue;
+            }
+            try {
+                const content = readFileSync(join(STORE_DIR, file), "utf8");
+                const receipt = JSON.parse(content);
+                if (receipt.workspacePath === workspacePath) {
+                    receipts.push(receipt);
+                }
+            }
+            catch {
+                // Skip invalid files
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or not readable
+    }
+    return receipts;
+}
+/**
+ * Update receipt status
+ */
+export function updateReceiptStatus(workspacePath, taskId, status, updates) {
+    const receipt = loadDelegationReceipt(workspacePath, taskId);
+    if (!receipt) {
+        return null;
+    }
+    const updated = {
+        ...receipt,
+        ...updates,
+        status,
+        updatedAt: Date.now(),
+    };
+    saveDelegationReceipt(updated);
+    return updated;
+}
+/**
+ * Check if receipt exists for task
+ */
+export function hasReceipt(workspacePath, taskId) {
+    const path = getReceiptPath(workspacePath, taskId);
+    return existsSync(path);
+}
+/**
+ * Compact receipt for storage after compaction
+ */
+export function compactReceipt(receipt) {
+    return {
+        version: receipt.version,
+        workspacePath: receipt.workspacePath,
+        sessionId: receipt.sessionId,
+        parentTaskId: receipt.parentTaskId,
+        scopeFingerprint: receipt.scopeFingerprint,
+        decision: {
+            strategy: receipt.decision.strategy,
+            reason: receipt.decision.reason,
+            workGroups: receipt.decision.workGroups.filter((g) => g.status === "pending" || g.status === "dispatched" || g.status === "running"),
+            validationExpectations: receipt.decision.validationExpectations,
+            confidence: receipt.decision.confidence,
+            jevUsed: receipt.decision.jevUsed,
+            reassessmentTriggers: receipt.decision.reassessmentTriggers,
+        },
+        createdAt: receipt.createdAt,
+        updatedAt: Date.now(),
+        status: receipt.status,
+        childIds: receipt.childIds,
+        pendingValidation: receipt.pendingValidation,
+        userConstraints: receipt.userConstraints,
+    };
+}

package/packages/contracts/dist/index.d.ts

@@ -20,4 +20,6 @@ export * from './notifications.js';
 export * from './approvals.js';
 export * from './delegation.js';
 export * from './delegation-assessor.js';
+export * from './delegation-store.js';
 export * from './scope-discovery.js';
+export * from './work-partitioner.js';

package/packages/contracts/dist/index.js

@@ -20,4 +20,6 @@ export * from './notifications.js';
 export * from './approvals.js';
 export * from './delegation.js';
 export * from './delegation-assessor.js';
+export * from './delegation-store.js';
 export * from './scope-discovery.js';
+export * from './work-partitioner.js';

package/packages/contracts/dist/work-partitioner.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Work Partitioner
+ *
+ * Partitions work into disjoint file ownership groups.
+ */
+import type { WorkGroup, ScopeFacts } from "./delegation.js";
+/**
+ * File dependency info
+ */
+export interface FileDependency {
+    path: string;
+    imports: string[];
+    exports: string[];
+}
+/**
+ * Partition configuration
+ */
+export interface PartitionConfig {
+    /** Maximum files per group */
+    maxFilesPerGroup: number;
+    /** Whether to group by directory */
+    groupByDirectory: boolean;
+    /** Shared files that shouldn't be partitioned */
+    sharedPaths: string[];
+}
+/**
+ * Default partition config
+ */
+export declare const DEFAULT_PARTITION_CONFIG: PartitionConfig;
+/**
+ * Partition files into ownership groups
+ */
+export declare function partitionWork(files: string[], facts: ScopeFacts, config?: Partial<PartitionConfig>): WorkGroup[];
+/**
+ * Detect ownership conflicts
+ */
+export declare function detectOwnershipConflicts(groups: WorkGroup[], newPaths: string[]): string[];
+/**
+ * Assign work to group
+ */
+export declare function assignWorkToGroup(groups: WorkGroup[], groupId: string, paths: string[]): WorkGroup | null;
+/**
+ * Get unowned files
+ */
+export declare function getUnownedFiles(allFiles: string[], groups: WorkGroup[]): string[];
+/**
+ * Update group status
+ */
+export declare function updateGroupStatus(groups: WorkGroup[], groupId: string, status: WorkGroup["status"], childId?: string): WorkGroup[];
+/**
+ * Check if all groups are complete
+ */
+export declare function areAllGroupsComplete(groups: WorkGroup[]): boolean;
+/**
+ * Get pending groups
+ */
+export declare function getPendingGroups(groups: WorkGroup[]): WorkGroup[];