pi-harness-runtime 0.10.13 → 0.10.15

package/packages/write-review/src/review.js

@@ -0,0 +1,153 @@
+/**
+ * Review Integration
+ *
+ * Uses pi-subagents review-loop for multi-round code review.
+ */
+/**
+ * Build review task for pi-subagents
+ */
+export function buildReviewTask(status, projectPath) {
+    const codeFiles = status.codeFiles ?? [];
+    const iteration = status.iteration;
+    const task = `## Review Task - Iteration ${iteration}
+
+Review the code written in this iteration.
+
+### Code Files to Review:
+${codeFiles.map((f) => `- ${f}`).join("\n") || "No files recorded yet."}
+
+### Project Path: ${projectPath}
+
+### Review Instructions:
+1. Read the code files listed above.
+2. Run the review-loop workflow using pi-subagents.
+3. Focus on: correctness, security, performance, tests, and code style.
+4. Return a verdict: APPROVED, CHANGES_REQUESTED, or BLOCKED.
+
+### Verdict Format:
+\`\`\`
+## Verdict: [APPROVED|CHANGES_REQUESTED|BLOCKED]
+[Your detailed review message]
+\`\`\`
+
+For CHANGES_REQUESTED, list specific changes needed:
+\`\`\`
+## Changes Needed:
+1. [Issue description] - [File:Line]
+2. [Issue description] - [File:Line]
+\`\`\`
+`;
+    return task;
+}
+/**
+ * Parse verdict from review output
+ */
+export function parseVerdict(output) {
+    const lines = output.split("\n");
+    let verdict = null;
+    let message = "";
+    const changes = [];
+    let inChanges = false;
+    for (const line of lines) {
+        const lower = line.toLowerCase();
+        if (lower.includes("## verdict:")) {
+            if (lower.includes("approved")) {
+                verdict = "approved";
+            }
+            else if (lower.includes("changes_requested") ||
+                lower.includes("changes requested")) {
+                verdict = "changes_requested";
+            }
+            else if (lower.includes("blocked")) {
+                verdict = "blocked";
+            }
+            continue;
+        }
+        if (lower.includes("## changes needed:") || lower.includes("changes:")) {
+            inChanges = true;
+            continue;
+        }
+        if (inChanges && line.trim().match(/^\d+\./)) {
+            changes.push(line.trim());
+            continue;
+        }
+        if (verdict && line.trim()) {
+            message += line + "\n";
+        }
+    }
+    if (!verdict)
+        return null;
+    return {
+        verdict,
+        message: message.trim(),
+        changes: changes.length > 0 ? changes : undefined,
+    };
+}
+/**
+ * Review angles for parallel review
+ */
+export const REVIEW_ANGLES = [
+    {
+        name: "correctness",
+        description: "Verify implementation matches requirements and handles edge cases",
+    },
+    {
+        name: "tests",
+        description: "Check test coverage and validity",
+    },
+    {
+        name: "complexity",
+        description: "Look for unnecessary complexity and opportunities to simplify",
+    },
+];
+/**
+ * Build parallel review prompt
+ */
+export function buildParallelReviewPrompt(codeFiles, projectPath) {
+    return `Run parallel reviewers on this code:
+
+1. **correctness** - Verify implementation matches requirements and handles edge cases
+2. **tests** - Check test coverage and validity
+3. **complexity** - Look for unnecessary complexity
+
+Files: ${codeFiles.join(", ")}
+Project: ${projectPath}
+
+Use pi-subagents to spawn 3 parallel reviewers. Wait for all results, then synthesize into a final verdict.`;
+}
+/**
+ * Format review summary for blackboard
+ */
+export function formatReviewSummary(result) {
+    const lines = [
+        `## Review Result - Iteration ${result.iteration}`,
+        "",
+        `**Verdict:** ${result.verdict.toUpperCase()}`,
+        "",
+    ];
+    if (result.message) {
+        lines.push("### Message");
+        lines.push(result.message);
+        lines.push("");
+    }
+    if (result.changesNeeded && result.changesNeeded.length > 0) {
+        lines.push("### Changes Needed");
+        for (const change of result.changesNeeded) {
+            lines.push(`- ${change}`);
+        }
+        lines.push("");
+    }
+    if (result.issues && result.issues.length > 0) {
+        lines.push("### Issues Found");
+        for (const issue of result.issues) {
+            lines.push(`- [${issue.severity}] ${issue.type}: ${issue.description}`);
+            if (issue.location) {
+                lines.push(`  Location: ${issue.location}`);
+            }
+            if (issue.suggestion) {
+                lines.push(`  Suggestion: ${issue.suggestion}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}

package/packages/write-review/src/trigger.js

@@ -0,0 +1,106 @@
+/**
+ * Wiki Prompt Trigger
+ *
+ * Detects when an agent reads a prompt from {project}/wiki/*
+ * This triggers the write-review loop.
+ */
+import { existsSync } from "fs";
+import { join, relative } from "path";
+const DEFAULT_WIKI_DIR = "wiki";
+/**
+ * Detect if a file path is a wiki prompt
+ */
+export function isWikiPrompt(filePath, projectPath) {
+    const wikiDir = join(projectPath, DEFAULT_WIKI_DIR);
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    const normalizedWiki = wikiDir.replace(/\\/g, "/");
+    return (normalizedPath.startsWith(normalizedWiki + "/") ||
+        normalizedPath.startsWith(normalizedWiki + "\\"));
+}
+/**
+ * Extract prompt metadata from wiki path
+ */
+export function parseWikiPrompt(filePath, projectPath) {
+    const wikiDir = join(projectPath, DEFAULT_WIKI_DIR);
+    const rel = relative(wikiDir, filePath).replace(/\\/g, "/");
+    if (!rel || rel.startsWith(".."))
+        return null;
+    const parts = rel.split("/");
+    if (parts.length >= 2) {
+        return {
+            category: parts[0],
+            filename: parts.slice(1).join("/"),
+        };
+    }
+    return {
+        category: "root",
+        filename: parts[0],
+    };
+}
+/**
+ * Get all wiki prompt files in a project
+ */
+export function getWikiPrompts(projectPath) {
+    const wikiDir = join(projectPath, DEFAULT_WIKI_DIR);
+    if (!existsSync(wikiDir)) {
+        return [];
+    }
+    const prompts = [];
+    function scanDir(dir) {
+        const { readdirSync, statSync } = require("fs");
+        try {
+            for (const entry of readdirSync(dir)) {
+                const fullPath = join(dir, entry);
+                const stat = statSync(fullPath);
+                if (stat.isDirectory()) {
+                    scanDir(fullPath);
+                }
+                else if (stat.isFile() &&
+                    (entry.endsWith(".md") || entry.endsWith(".txt"))) {
+                    const relPath = relative(wikiDir, fullPath).replace(/\\/g, "/");
+                    const parts = relPath.split("/");
+                    prompts.push({
+                        path: fullPath,
+                        category: parts[0],
+                        filename: parts.slice(1).join("/"),
+                    });
+                }
+            }
+        }
+        catch {
+            // Ignore permission errors
+        }
+    }
+    scanDir(wikiDir);
+    return prompts;
+}
+/**
+ * Create trigger context from a wiki read event
+ */
+export function createTriggerContext(filePath, projectPath, triggerType = "wiki_read") {
+    if (!isWikiPrompt(filePath, projectPath)) {
+        return null;
+    }
+    const parsed = parseWikiPrompt(filePath, projectPath);
+    if (!parsed)
+        return null;
+    return {
+        projectPath,
+        promptFile: filePath,
+        promptContent: "", // Will be filled by caller
+        triggerType,
+    };
+}
+/**
+ * Check if current working directory has wiki prompts
+ */
+export function hasWikiPrompts(projectPath) {
+    const wikiDir = join(projectPath, DEFAULT_WIKI_DIR);
+    return existsSync(wikiDir);
+}
+/**
+ * Get wiki directory path
+ */
+export function getWikiDir(projectPath) {
+    return join(projectPath, DEFAULT_WIKI_DIR);
+}

package/packages/write-review/src/types.js

@@ -0,0 +1,25 @@
+/**
+ * Write-Review Loop Types
+ *
+ * State machine for two-agent write-review coordination.
+ */
+/**
+ * Agent roles
+ */
+export const AGENT_ROLES = {
+    WRITER: "writer", // Minimax - reads wiki, writes code
+    REVIEWER: "reviewer", // Uses pi-subagents review-loop
+    HELPER: "helper", // worker - notes tasks to todo
+};
+/**
+ * State transition helpers
+ */
+export function isTerminalPhase(phase) {
+    return phase === "approved" || phase === "blocked";
+}
+export function needsReview(phase) {
+    return phase === "pending_review" || phase === "reviewing";
+}
+export function canWrite(phase) {
+    return (phase === "idle" || phase === "writing" || phase === "changes_requested");
+}

package/IMPLEMENTATION/RFC-0010/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria - RFC 0010
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Human is not required as message bus.
-- Failures produce explicit records.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0010/AI_BRIEF.md

@@ -1,20 +0,0 @@
-# AI Brief — Context Manager (RFC-0010)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/context-manager/`
-- `DEFAULT_POLICY`, `estimatePressure`, `getPressureLevel`, `createSessionScope`, `setTTL`, `addToScope`, `evictExpired`, `prioritize`, `estimateTokens`, `calculateTotalTokens` from core
-- `compactContext`, `generateResumePrompt`, `formatResumeMarkdown` from compaction
-
-## Features
-
-- Memory context management with TTL and prioritization
-- Session scope creation and management
-- Token pressure estimation
-- Context compaction with resume generation
-
-## Tests
-
-- Subagent-implemented; integration with context-compiler package

package/IMPLEMENTATION/RFC-0010/FILES.md

@@ -1,11 +0,0 @@
-# Suggested Files
-
-```text
-packages/
-  runtime/
-  blackboard/
-  shared-context/
-  context-window/
-  e2e-test-engine/
-  project-detector/
-```

package/IMPLEMENTATION/RFC-0010/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0010 - Context Window Manager
-
-- [ ] Read and confirm RFC scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schemas if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add validation.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Write usage example.

package/IMPLEMENTATION/RFC-0010/TESTS.md

@@ -1,6 +0,0 @@
-# Test Plan
-
-- Unit test schema validation.
-- Unit test state transition.
-- Integration test using sample harness folder.
-- Failure-mode test for malformed or missing files.

package/IMPLEMENTATION/RFC-0011/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria - RFC 0011
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Human is not required as message bus.
-- Failures produce explicit records.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0011/AI_BRIEF.md

@@ -1,19 +0,0 @@
-# AI Brief — Token Optimizer (RFC-0011)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/token-optimizer/`
-- `estimateTokens`, `estimateMessageTokens`, `buildBudget`, `splitByPriority`, `optimizeBudget`, `calculateCost`, `trimToTokens`, `DEFAULT_PRICING` from optimizer
-
-## Features
-
-- Token budget optimization
-- Priority-based splitting of content
-- Cost calculation with pricing data
-- Token trimming to fit budgets
-
-## Tests
-
-- Subagent-implemented; optimizer tests pass

package/IMPLEMENTATION/RFC-0011/FILES.md

@@ -1,11 +0,0 @@
-# Suggested Files
-
-```text
-packages/
-  runtime/
-  blackboard/
-  shared-context/
-  context-window/
-  e2e-test-engine/
-  project-detector/
-```

package/IMPLEMENTATION/RFC-0011/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0011 - Shared Blackboard
-
-- [ ] Read and confirm RFC scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schemas if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add validation.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Write usage example.

package/IMPLEMENTATION/RFC-0011/TESTS.md

@@ -1,6 +0,0 @@
-# Test Plan
-
-- Unit test schema validation.
-- Unit test state transition.
-- Integration test using sample harness folder.
-- Failure-mode test for malformed or missing files.

package/IMPLEMENTATION/RFC-0012/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria - RFC 0012
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Human is not required as message bus.
-- Failures produce explicit records.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0012/AI_BRIEF.md

@@ -1,18 +0,0 @@
-# AI Brief — Provider Selector (RFC-0012)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/provider-selector/`
-- `selectProvider`, `rank`, `compareCost`, `compareLatency`, `filterByCapability`, `filterByRegion` from selector
-
-## Features
-
-- Multi-provider routing with cost/quality tradeoffs
-- Provider ranking by cost, latency, capability
-- Capability-based and region-based filtering
-
-## Tests
-
-- Subagent-implemented; selector tests pass

package/IMPLEMENTATION/RFC-0012/FILES.md

@@ -1,11 +0,0 @@
-# Suggested Files
-
-```text
-packages/
-  runtime/
-  blackboard/
-  shared-context/
-  context-window/
-  e2e-test-engine/
-  project-detector/
-```

package/IMPLEMENTATION/RFC-0012/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0012 - Agent Handoff Protocol
-
-- [ ] Read and confirm RFC scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schemas if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add validation.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Write usage example.

package/IMPLEMENTATION/RFC-0012/TESTS.md

@@ -1,6 +0,0 @@
-# Test Plan
-
-- Unit test schema validation.
-- Unit test state transition.
-- Integration test using sample harness folder.
-- Failure-mode test for malformed or missing files.

package/IMPLEMENTATION/RFC-0013/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria - RFC 0013
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Human is not required as message bus.
-- Failures produce explicit records.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0013/AI_BRIEF.md

@@ -1,19 +0,0 @@
-# AI Brief — Test Generator (RFC-0013)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/test-generator/`
-- `detectAssertions`, `generateUnitTests`, `generateE2ETests`, `generateMockFixtures` from generator
-
-## Features
-
-- Auto-generate unit tests from source code
-- E2E test generation
-- Mock fixture generation
-- Assertion detection from source
-
-## Tests
-
-- Subagent-implemented; generator tests pass

package/IMPLEMENTATION/RFC-0013/FILES.md

@@ -1,11 +0,0 @@
-# Suggested Files
-
-```text
-packages/
-  runtime/
-  blackboard/
-  shared-context/
-  context-window/
-  e2e-test-engine/
-  project-detector/
-```

package/IMPLEMENTATION/RFC-0013/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0013 - E2E Test Engine
-
-- [ ] Read and confirm RFC scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schemas if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add validation.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Write usage example.

package/IMPLEMENTATION/RFC-0013/TESTS.md

@@ -1,6 +0,0 @@
-# Test Plan
-
-- Unit test schema validation.
-- Unit test state transition.
-- Integration test using sample harness folder.
-- Failure-mode test for malformed or missing files.

package/IMPLEMENTATION/RFC-0014/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria - RFC 0014
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Human is not required as message bus.
-- Failures produce explicit records.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0014/AI_BRIEF.md

@@ -1,20 +0,0 @@
-# AI Brief — Doc Generator (RFC-0014)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/doc-generator/`
-- `detectProjectType`, `parseSignals` from detector
-- `detectSymbols`, `generateDocs` from docs
-
-## Features
-
-- Auto-generate documentation from code
-- Project type detection
-- Symbol detection from source
-- Documentation generation from code analysis
-
-## Tests
-
-- Subagent-implemented; docs tests pass

package/IMPLEMENTATION/RFC-0014/FILES.md

@@ -1,11 +0,0 @@
-# Suggested Files
-
-```text
-packages/
-  runtime/
-  blackboard/
-  shared-context/
-  context-window/
-  e2e-test-engine/
-  project-detector/
-```

package/IMPLEMENTATION/RFC-0014/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0014 - Project Detector and Test Data Engine
-
-- [ ] Read and confirm RFC scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schemas if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add validation.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Write usage example.

package/IMPLEMENTATION/RFC-0014/TESTS.md

@@ -1,6 +0,0 @@
-# Test Plan
-
-- Unit test schema validation.
-- Unit test state transition.
-- Integration test using sample harness folder.
-- Failure-mode test for malformed or missing files.

package/IMPLEMENTATION/RFC-0015/ACCEPTANCE_CRITERIA.md

@@ -1,2 +0,0 @@
-- Pass tests
-- Match RFC

package/IMPLEMENTATION/RFC-0015/AI_BRIEF.md

@@ -1,2 +0,0 @@
-# AI Brief
-Implement RFC-0015.

package/IMPLEMENTATION/RFC-0015/FILES.md

@@ -1,2 +0,0 @@
-# Files
-packages/

package/IMPLEMENTATION/RFC-0015/TASKS.md

@@ -1,4 +0,0 @@
-# Job State Machine
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0015/TESTS.md

@@ -1,3 +0,0 @@
-# Tests
-Happy path
-Failure path

package/IMPLEMENTATION/RFC-0016/ACCEPTANCE_CRITERIA.md

@@ -1,2 +0,0 @@
-- Pass tests
-- Match RFC

package/IMPLEMENTATION/RFC-0016/AI_BRIEF.md

@@ -1,2 +0,0 @@
-# AI Brief
-Implement RFC-0016.

package/IMPLEMENTATION/RFC-0016/FILES.md

@@ -1,2 +0,0 @@
-# Files
-packages/

package/IMPLEMENTATION/RFC-0016/TASKS.md

@@ -1,4 +0,0 @@
-# Task Graph
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0016/TESTS.md

@@ -1,3 +0,0 @@
-# Tests
-Happy path
-Failure path

package/IMPLEMENTATION/RFC-0017/ACCEPTANCE_CRITERIA.md

@@ -1,2 +0,0 @@
-- Pass tests
-- Match RFC

package/IMPLEMENTATION/RFC-0017/AI_BRIEF.md

@@ -1,2 +0,0 @@
-# AI Brief
-Implement RFC-0017.

package/IMPLEMENTATION/RFC-0017/FILES.md

@@ -1,2 +0,0 @@
-# Files
-packages/

package/IMPLEMENTATION/RFC-0017/TASKS.md

@@ -1,4 +0,0 @@
-# Master Planner
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0017/TESTS.md

@@ -1,3 +0,0 @@
-# Tests
-Happy path
-Failure path

package/IMPLEMENTATION/RFC-0018/ACCEPTANCE_CRITERIA.md

@@ -1,2 +0,0 @@
-- Pass tests
-- Match RFC