pi-harness-runtime 1.1.350 → 1.1.351

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.350",
+  "version": "1.1.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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.351",
   "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[];

package/packages/contracts/dist/work-partitioner.js

@@ -0,0 +1,165 @@
+/**
+ * Work Partitioner
+ *
+ * Partitions work into disjoint file ownership groups.
+ */
+/**
+ * Default partition config
+ */
+export const DEFAULT_PARTITION_CONFIG = {
+    maxFilesPerGroup: 15,
+    groupByDirectory: true,
+    sharedPaths: [
+        "index.ts",
+        "index.js",
+        "main.ts",
+        "main.js",
+        "package.json",
+        "tsconfig.json",
+    ],
+};
+/**
+ * Partition files into ownership groups
+ */
+export function partitionWork(files, facts, config = {}) {
+    const cfg = { ...DEFAULT_PARTITION_CONFIG, ...config };
+    // Filter out shared paths
+    const ownedFiles = files.filter((f) => !cfg.sharedPaths.some((s) => f.endsWith(s)));
+    // Group files by directory
+    const dirGroups = groupByDirectory(ownedFiles);
+    // Further partition large groups
+    const groups = [];
+    let groupId = 1;
+    for (const [dir, dirFiles] of Object.entries(dirGroups)) {
+        if (dirFiles.length <= cfg.maxFilesPerGroup) {
+            groups.push(createGroup(groupId++, dir, dirFiles, facts.isMechanical));
+        }
+        else {
+            // Split large directories
+            const subGroups = splitGroup(dirFiles, cfg.maxFilesPerGroup);
+            for (const subFiles of subGroups) {
+                groups.push(createGroup(groupId++, dir, subFiles, facts.isMechanical));
+            }
+        }
+    }
+    return groups;
+}
+/**
+ * Group files by directory
+ */
+function groupByDirectory(files) {
+    const groups = {};
+    for (const file of files) {
+        // Get directory part of path
+        const parts = file.split("/");
+        const dir = parts.length > 1 ? parts.slice(0, -1).join("/") : ".";
+        if (!groups[dir]) {
+            groups[dir] = [];
+        }
+        groups[dir].push(file);
+    }
+    return groups;
+}
+/**
+ * Create a work group
+ */
+function createGroup(id, description, files, isMechanical) {
+    return {
+        groupId: `group-${id}`,
+        description: `${description} (${files.length} files)`,
+        ownedPaths: files,
+        isMechanical,
+        status: "pending",
+    };
+}
+/**
+ * Split a group into smaller subgroups
+ */
+function splitGroup(files, maxSize) {
+    const subgroups = [];
+    for (let i = 0; i < files.length; i += maxSize) {
+        subgroups.push(files.slice(i, i + maxSize));
+    }
+    return subgroups;
+}
+/**
+ * Detect ownership conflicts
+ */
+export function detectOwnershipConflicts(groups, newPaths) {
+    const conflicts = [];
+    for (const path of newPaths) {
+        for (const group of groups) {
+            if (group.status !== "cancelled" &&
+                group.status !== "failed" &&
+                group.ownedPaths.includes(path)) {
+                conflicts.push(`${path} already owned by ${group.groupId}`);
+            }
+        }
+    }
+    return conflicts;
+}
+/**
+ * Assign work to group
+ */
+export function assignWorkToGroup(groups, groupId, paths) {
+    const group = groups.find((g) => g.groupId === groupId);
+    if (!group) {
+        return null;
+    }
+    // Check for conflicts
+    const conflicts = detectOwnershipConflicts(groups.filter((g) => g.groupId !== groupId), paths);
+    if (conflicts.length > 0) {
+        // Return group with conflict info
+        return {
+            ...group,
+            status: "failed",
+        };
+    }
+    return {
+        ...group,
+        ownedPaths: [...new Set([...group.ownedPaths, ...paths])],
+    };
+}
+/**
+ * Get unowned files
+ */
+export function getUnownedFiles(allFiles, groups) {
+    const ownedFiles = new Set();
+    for (const group of groups) {
+        if (group.status !== "cancelled" && group.status !== "failed") {
+            for (const path of group.ownedPaths) {
+                ownedFiles.add(path);
+            }
+        }
+    }
+    return allFiles.filter((f) => !ownedFiles.has(f));
+}
+/**
+ * Update group status
+ */
+export function updateGroupStatus(groups, groupId, status, childId) {
+    return groups.map((g) => {
+        if (g.groupId !== groupId) {
+            return g;
+        }
+        return {
+            ...g,
+            status,
+            childId: childId || g.childId,
+        };
+    });
+}
+/**
+ * Check if all groups are complete
+ */
+export function areAllGroupsComplete(groups) {
+    return groups.every((g) => g.status === "completed" ||
+        g.status === "failed" ||
+        g.status === "cancelled");
+}
+/**
+ * Get pending groups
+ */
+export function getPendingGroups(groups) {
+    return groups.filter((g) => g.status === "pending");
+}

package/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/contracts",
-  "version": "1.1.350",
+  "version": "1.1.351",
   "type": "module",
   "description": "RPC schema definitions for pi-harness runtime",
   "main": "./dist/index.js",