pi-harness-runtime 1.1.356 → 1.1.358

package/packages/jev-judge/dist/delegation-harness.js

@@ -0,0 +1,208 @@
+/**
+ * Delegation Harness Integration
+ *
+ * Connects delegation assessment to the harness runtime.
+ * Uses inline types to avoid cross-package dependency.
+ */
+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
+ */
+function getReceiptPath(workspacePath, taskId) {
+    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
+ */
+function saveReceipt(receipt) {
+    ensureStoreDir();
+    const path = getReceiptPath(receipt.workspacePath, receipt.parentTaskId);
+    writeFileSync(path, JSON.stringify(receipt, null, 2), "utf8");
+}
+/**
+ * Load delegation receipt
+ */
+function loadReceipt(workspacePath, taskId) {
+    const path = getReceiptPath(workspacePath, taskId);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if receipt exists
+ */
+function hasReceipt(workspacePath, taskId) {
+    return existsSync(getReceiptPath(workspacePath, taskId));
+}
+/**
+ * Sub-agent tool names
+ */
+const SUBAGENT_TOOLS = ["subagent", "spawn", "delegate", "run_subagent"];
+/**
+ * Create delegation harness integration
+ */
+export function createDelegationHarness(pi, config = {}) {
+    const state = {
+        currentReceipt: null,
+        capability: null,
+        lastAssessment: null,
+    };
+    const minFiles = config.minFiles ?? 10;
+    const minCallSites = config.minCallSites ?? 50;
+    const minComponents = config.minComponents ?? 2;
+    /**
+     * Discover and cache delegation capability
+     */
+    async function discoverCapability() {
+        if (state.capability)
+            return state.capability;
+        try {
+            const allTools = pi.getAllTools();
+            const toolNames = allTools.map((t) => t.name);
+            const activeTools = pi.getActiveTools();
+            const hasSubagentTool = SUBAGENT_TOOLS.some((tool) => toolNames.includes(tool) || activeTools.includes(tool));
+            if (hasSubagentTool) {
+                state.capability = {
+                    name: "subagent-extension",
+                    supportsSubagents: true,
+                    supportsWorkIsolation: true,
+                    supportsCancellation: true,
+                    availableTools: activeTools.filter((t) => SUBAGENT_TOOLS.some((st) => t.includes(st))),
+                    verified: true,
+                };
+                return state.capability;
+            }
+        }
+        catch {
+            // Discovery failed
+        }
+        return null;
+    }
+    /**
+     * Check if delegation assessment should be triggered
+     */
+    function shouldAssess(facts) {
+        if (facts.observedFiles >= minFiles)
+            return true;
+        if (facts.observedCallSites >= minCallSites)
+            return true;
+        if (facts.independentComponents >= minComponents)
+            return true;
+        return false;
+    }
+    /**
+     * Make deterministic assessment
+     */
+    function makeDeterministicAssessment(facts, capability) {
+        if (!capability?.verified) {
+            return {
+                strategy: "unavailable",
+                reason: "No verified sub-agent capability",
+                workGroups: [],
+                validationExpectations: "Parent handles validation",
+                confidence: "high",
+                jevUsed: false,
+                reassessmentTriggers: ["Extension available"],
+            };
+        }
+        if (facts.isMechanical && !facts.isComplex) {
+            return {
+                strategy: "script_only",
+                reason: "Mechanical transformation",
+                workGroups: [],
+                validationExpectations: "Script output validation",
+                confidence: "high",
+                jevUsed: false,
+                reassessmentTriggers: ["Transformation unreliable"],
+            };
+        }
+        if (facts.independentComponents >= 2 && !facts.tightlyCoupled) {
+            return {
+                strategy: "delegate",
+                reason: `${facts.independentComponents} independent components`,
+                workGroups: [],
+                validationExpectations: "Each group validated, then integrated",
+                confidence: "medium",
+                jevUsed: false,
+                reassessmentTriggers: ["Scope expands", "Coupling discovered"],
+            };
+        }
+        return {
+            strategy: "single_agent",
+            reason: "Default to single agent",
+            workGroups: [],
+            validationExpectations: "Parent validates",
+            confidence: "low",
+            jevUsed: false,
+            reassessmentTriggers: ["Scope exceeds threshold"],
+        };
+    }
+    /**
+     * Assess delegation for given scope facts
+     */
+    async function assess(facts, parentTaskId) {
+        if (!shouldAssess(facts))
+            return null;
+        const workspacePath = process.cwd();
+        // Check existing receipt
+        if (hasReceipt(workspacePath, parentTaskId)) {
+            const existing = loadReceipt(workspacePath, parentTaskId);
+            if (existing && existing.scopeFingerprint === facts.fingerprint) {
+                state.currentReceipt = existing;
+                return existing.decision;
+            }
+        }
+        const capability = await discoverCapability();
+        const decision = makeDeterministicAssessment(facts, capability);
+        state.lastAssessment = decision;
+        const receipt = {
+            version: 1,
+            workspacePath,
+            sessionId: pi.getSessionName?.() ?? "unknown",
+            parentTaskId,
+            scopeFingerprint: facts.fingerprint,
+            decision,
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            status: "assessing",
+            childIds: [],
+            pendingValidation: [],
+            userConstraints: [],
+        };
+        saveReceipt(receipt);
+        state.currentReceipt = receipt;
+        return decision;
+    }
+    return {
+        discoverCapability,
+        shouldAssess,
+        assess,
+        getReceipt: () => state.currentReceipt,
+        getLastDecision: () => state.lastAssessment,
+        clear: () => {
+            state.currentReceipt = null;
+            state.lastAssessment = null;
+        },
+    };
+}
+//# sourceMappingURL=delegation-harness.js.map

package/packages/jev-judge/dist/delegation-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-harness.js","sourceRoot":"","sources":["../src/delegation-harness.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.356",
+  "version": "1.1.358",
   "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/delegation-harness.ts

@@ -0,0 +1,329 @@
+/**
+ * Delegation Harness Integration
+ * 
+ * Connects delegation assessment to the harness runtime.
+ * Uses inline types to avoid cross-package dependency.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+
+/**
+ * Extension capability for delegation (inline to avoid dependency)
+ */
+export interface ExtensionCapability {
+  name: string;
+  supportsSubagents: boolean;
+  supportsWorkIsolation: boolean;
+  supportsCancellation: boolean;
+  availableTools: string[];
+  verified: boolean;
+}
+
+/**
+ * Delegation strategy decision
+ */
+export type DelegationStrategy =
+  | "delegate"
+  | "script_then_delegate"
+  | "script_only"
+  | "single_agent"
+  | "unavailable";
+
+/**
+ * Delegation decision
+ */
+export interface DelegationDecision {
+  strategy: DelegationStrategy;
+  reason: string;
+  workGroups: unknown[];
+  validationExpectations: string;
+  confidence: "high" | "medium" | "low";
+  jevUsed: boolean;
+  reassessmentTriggers: string[];
+}
+
+/**
+ * Scope facts
+ */
+export interface ScopeFacts {
+  estimatedFiles: number;
+  observedFiles: number;
+  estimatedCallSites: number;
+  observedCallSites: number;
+  independentComponents: number;
+  tightlyCoupled: boolean;
+  isMechanical: boolean;
+  isComplex: boolean;
+  fileTypes: Record<string, number>;
+  fingerprint: string;
+}
+
+/**
+ * Delegation receipt
+ */
+export interface DelegationReceipt {
+  version: number;
+  workspacePath: string;
+  sessionId: string;
+  parentTaskId: string;
+  scopeFingerprint: string;
+  decision: DelegationDecision;
+  createdAt: number;
+  updatedAt: number;
+  status: "assessing" | "in_progress" | "completed" | "failed" | "cancelled";
+  childIds: string[];
+  pendingValidation: string[];
+  userConstraints: string[];
+}
+
+/**
+ * Store directory path
+ */
+const STORE_DIR = join(process.env.HOME || "/home/frappe", ".pi-harness-runtime", "delegation-state");
+
+/**
+ * Ensure store directory exists
+ */
+function ensureStoreDir(): void {
+  if (!existsSync(STORE_DIR)) {
+    mkdirSync(STORE_DIR, { recursive: true });
+  }
+}
+
+/**
+ * Get receipt file path
+ */
+function getReceiptPath(workspacePath: string, taskId: string): string {
+  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
+ */
+function saveReceipt(receipt: DelegationReceipt): void {
+  ensureStoreDir();
+  const path = getReceiptPath(receipt.workspacePath, receipt.parentTaskId);
+  writeFileSync(path, JSON.stringify(receipt, null, 2), "utf8");
+}
+
+/**
+ * Load delegation receipt
+ */
+function loadReceipt(workspacePath: string, taskId: string): DelegationReceipt | null {
+  const path = getReceiptPath(workspacePath, taskId);
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf8")) as DelegationReceipt;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check if receipt exists
+ */
+function hasReceipt(workspacePath: string, taskId: string): boolean {
+  return existsSync(getReceiptPath(workspacePath, taskId));
+}
+
+/**
+ * Delegation harness configuration
+ */
+export interface DelegationHarnessConfig {
+  minFiles?: number;
+  minCallSites?: number;
+  minComponents?: number;
+}
+
+/**
+ * Delegation harness state
+ */
+interface DelegationState {
+  currentReceipt: DelegationReceipt | null;
+  capability: ExtensionCapability | null;
+  lastAssessment: DelegationDecision | null;
+}
+
+/**
+ * Sub-agent tool names
+ */
+const SUBAGENT_TOOLS = ["subagent", "spawn", "delegate", "run_subagent"];
+
+/**
+ * Create delegation harness integration
+ */
+export function createDelegationHarness(
+  pi: ExtensionAPI,
+  config: DelegationHarnessConfig = {}
+) {
+  const state: DelegationState = {
+    currentReceipt: null,
+    capability: null,
+    lastAssessment: null,
+  };
+
+  const minFiles = config.minFiles ?? 10;
+  const minCallSites = config.minCallSites ?? 50;
+  const minComponents = config.minComponents ?? 2;
+
+  /**
+   * Discover and cache delegation capability
+   */
+  async function discoverCapability(): Promise<ExtensionCapability | null> {
+    if (state.capability) return state.capability;
+
+    try {
+      const allTools = pi.getAllTools();
+      const toolNames = allTools.map((t) => t.name);
+      const activeTools = pi.getActiveTools();
+
+      const hasSubagentTool = SUBAGENT_TOOLS.some(
+        (tool) => toolNames.includes(tool) || activeTools.includes(tool)
+      );
+
+      if (hasSubagentTool) {
+        state.capability = {
+          name: "subagent-extension",
+          supportsSubagents: true,
+          supportsWorkIsolation: true,
+          supportsCancellation: true,
+          availableTools: activeTools.filter((t) =>
+            SUBAGENT_TOOLS.some((st) => t.includes(st))
+          ),
+          verified: true,
+        };
+        return state.capability;
+      }
+    } catch {
+      // Discovery failed
+    }
+
+    return null;
+  }
+
+  /**
+   * Check if delegation assessment should be triggered
+   */
+  function shouldAssess(facts: ScopeFacts): boolean {
+    if (facts.observedFiles >= minFiles) return true;
+    if (facts.observedCallSites >= minCallSites) return true;
+    if (facts.independentComponents >= minComponents) return true;
+    return false;
+  }
+
+  /**
+   * Make deterministic assessment
+   */
+  function makeDeterministicAssessment(
+    facts: ScopeFacts,
+    capability: ExtensionCapability | null
+  ): DelegationDecision {
+    if (!capability?.verified) {
+      return {
+        strategy: "unavailable",
+        reason: "No verified sub-agent capability",
+        workGroups: [],
+        validationExpectations: "Parent handles validation",
+        confidence: "high",
+        jevUsed: false,
+        reassessmentTriggers: ["Extension available"],
+      };
+    }
+
+    if (facts.isMechanical && !facts.isComplex) {
+      return {
+        strategy: "script_only",
+        reason: "Mechanical transformation",
+        workGroups: [],
+        validationExpectations: "Script output validation",
+        confidence: "high",
+        jevUsed: false,
+        reassessmentTriggers: ["Transformation unreliable"],
+      };
+    }
+
+    if (facts.independentComponents >= 2 && !facts.tightlyCoupled) {
+      return {
+        strategy: "delegate",
+        reason: `${facts.independentComponents} independent components`,
+        workGroups: [],
+        validationExpectations: "Each group validated, then integrated",
+        confidence: "medium",
+        jevUsed: false,
+        reassessmentTriggers: ["Scope expands", "Coupling discovered"],
+      };
+    }
+
+    return {
+      strategy: "single_agent",
+      reason: "Default to single agent",
+      workGroups: [],
+      validationExpectations: "Parent validates",
+      confidence: "low",
+      jevUsed: false,
+      reassessmentTriggers: ["Scope exceeds threshold"],
+    };
+  }
+
+  /**
+   * Assess delegation for given scope facts
+   */
+  async function assess(
+    facts: ScopeFacts,
+    parentTaskId: string
+  ): Promise<DelegationDecision | null> {
+    if (!shouldAssess(facts)) return null;
+
+    const workspacePath = process.cwd();
+
+    // Check existing receipt
+    if (hasReceipt(workspacePath, parentTaskId)) {
+      const existing = loadReceipt(workspacePath, parentTaskId);
+      if (existing && existing.scopeFingerprint === facts.fingerprint) {
+        state.currentReceipt = existing;
+        return existing.decision;
+      }
+    }
+
+    const capability = await discoverCapability();
+    const decision = makeDeterministicAssessment(facts, capability);
+    state.lastAssessment = decision;
+
+    const receipt: DelegationReceipt = {
+      version: 1,
+      workspacePath,
+      sessionId: pi.getSessionName?.() ?? "unknown",
+      parentTaskId,
+      scopeFingerprint: facts.fingerprint,
+      decision,
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+      status: "assessing",
+      childIds: [],
+      pendingValidation: [],
+      userConstraints: [],
+    };
+
+    saveReceipt(receipt);
+    state.currentReceipt = receipt;
+    return decision;
+  }
+
+  return {
+    discoverCapability,
+    shouldAssess,
+    assess,
+    getReceipt: () => state.currentReceipt,
+    getLastDecision: () => state.lastAssessment,
+    clear: () => {
+      state.currentReceipt = null;
+      state.lastAssessment = null;
+    },
+  };
+}
+
+export type DelegationHarness = ReturnType<typeof createDelegationHarness>;

package/packages/knowledge-graph/package.json

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