pi-harness-runtime 0.10.6 → 0.10.7

package/packages/session-export/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/session-export",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/shared-context/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/shared-context",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "pi-harness-runtime — shared-context",
   "type": "module",
   "main": "./dist/index.js",

package/packages/skill-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/skill-registry",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Skill Registry for pi-harness-runtime — dynamic skill discovery and invocation",
   "type": "module",
   "main": "./dist/index.js",

package/packages/sprint-planner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/sprint-planner",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "type": "module",
   "description": "Sprint planning engine for pi-harness",
   "main": "dist/index.js",

package/packages/subscription-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/subscription-engine",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/task-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/task-compiler",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Task Compiler for pi-harness-runtime — produces deterministic task DAG from CompiledRequirement",
   "type": "module",
   "main": "./dist/index.js",

package/packages/test-data-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/test-data-generator",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Test data generation for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/test-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/test-generator",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Auto-Test Generator — generate unit and E2E tests from source code (RFC-0013)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/todo-bd-sync/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/todo-bd-sync",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Two-way sync between rpiv-todo overlay and bd issue tracker",
   "type": "module",
   "main": "src/index.ts",

package/packages/token-estimation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/token-estimation",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "pi-harness-runtime — token-estimation",
   "type": "module",
   "main": "./dist/index.js",

package/packages/token-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/token-optimizer",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Token Budget Optimizer — maximize prompt value within token limits (RFC-0011)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/tui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/tui",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "pi-harness-runtime — tui",
   "type": "module",
   "main": "./dist/index.js",

package/packages/types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/types",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Shared TypeScript types for pi-harness-runtime packages",
   "type": "module",
   "main": "./src/index.js",

package/packages/workflow-events/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workflow-events",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/workspace-scanner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workspace-scanner",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/worktree/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/worktree",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "pi-harness-runtime — worktree",
   "type": "module",
   "main": "./dist/index.js",

package/packages/write-review/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@moocoding/write-review",
+  "version": "0.10.7",
+  "description": "Two-agent write-review loop with blackboard coordination",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "keywords": [
+    "pi-extension",
+    "write-review",
+    "blackboard",
+    "multi-agent"
+  ],
+  "author": "MooCoding",
+  "license": "MIT"
+}

package/packages/write-review/src/blackboard.ts

@@ -0,0 +1,245 @@
+/**
+ * Write-Review Blackboard
+ *
+ * File-based coordination between writer and reviewer agents.
+ * Location: {project}/.write-review/status.json
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import type { WriteReviewStatus, ReviewPhase, Verdict } from "./types.js";
+
+const DEFAULT_DIR = ".write-review";
+const STATUS_FILE = "status.json";
+
+export class WriteReviewBlackboard {
+  private readonly projectPath: string;
+  private readonly dir: string;
+  private status: WriteReviewStatus | null = null;
+
+  constructor(projectPath: string, dir: string = DEFAULT_DIR) {
+    this.projectPath = projectPath;
+    this.dir = join(projectPath, dir);
+  }
+
+  /**
+   * Initialize a new write-review session
+   */
+  init(): void {
+    mkdirSync(this.dir, { recursive: true });
+    this.status = {
+      projectPath: this.projectPath,
+      phase: "idle",
+      writerDone: false,
+      iteration: 0,
+      createdAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString(),
+    };
+    this.save();
+  }
+
+  /**
+   * Load status from disk
+   */
+  load(): WriteReviewStatus | null {
+    const path = join(this.dir, STATUS_FILE);
+    if (!existsSync(path)) {
+      return null;
+    }
+    try {
+      this.status = JSON.parse(readFileSync(path, "utf-8"));
+      return this.status;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Save status to disk
+   */
+  save(): void {
+    if (!this.status) return;
+    this.status.updatedAt = new Date().toISOString();
+    mkdirSync(this.dir, { recursive: true });
+    const path = join(this.dir, STATUS_FILE);
+    writeFileSync(path, JSON.stringify(this.status, null, 2));
+  }
+
+  /**
+   * Get current status
+   */
+  getStatus(): WriteReviewStatus | null {
+    return this.status;
+  }
+
+  /**
+   * Start a new write session
+   */
+  startWriting(): void {
+    if (!this.status) this.init();
+    this.status!.phase = "writing";
+    this.status!.writerDone = false;
+    this.status!.iteration++;
+    this.save();
+  }
+
+  /**
+   * Mark writer as done
+   */
+  writerDone(message?: string): void {
+    if (!this.status) return;
+    this.status.writerDone = true;
+    this.status.writerMessage = message;
+    this.status.phase = "pending_review";
+    this.save();
+  }
+
+  /**
+   * Start reviewing
+   */
+  startReview(): void {
+    if (!this.status) return;
+    this.status.phase = "reviewing";
+    this.status.reviewerStarted = new Date().toISOString();
+    this.save();
+  }
+
+  /**
+   * Record verdict
+   */
+  setVerdict(verdict: Verdict, message?: string): void {
+    if (!this.status) return;
+    this.status.verdict = verdict;
+    this.status.verdictMessage = message;
+
+    switch (verdict) {
+      case "approved":
+        this.status.phase = "approved";
+        this.status.approvedAt = new Date().toISOString();
+        break;
+      case "blocked":
+        this.status.phase = "blocked";
+        this.status.blockedAt = new Date().toISOString();
+        break;
+      case "changes_requested":
+        this.status.phase = "changes_requested";
+        break;
+    }
+    this.save();
+  }
+
+  /**
+   * Record code files written
+   */
+  setCodeFiles(files: string[]): void {
+    if (!this.status) return;
+    this.status.codeFiles = files;
+    this.save();
+  }
+
+  /**
+   * Record requested changes
+   */
+  setChangesRequested(changes: string[]): void {
+    if (!this.status) return;
+    this.status.changesRequested = changes;
+    this.save();
+  }
+
+  /**
+   * Get current phase
+   */
+  getPhase(): ReviewPhase {
+    return this.status?.phase ?? "idle";
+  }
+
+  /**
+   * Get iteration number
+   */
+  getIteration(): number {
+    return this.status?.iteration ?? 0;
+  }
+
+  /**
+   * Check if build is allowed
+   */
+  canBuild(): boolean {
+    return this.status?.phase === "approved";
+  }
+
+  /**
+   * Get blackboard directory path
+   */
+  getPath(): string {
+    return this.dir;
+  }
+
+  /**
+   * Reset to idle
+   */
+  reset(): void {
+    if (!this.status) return;
+    this.status.phase = "idle";
+    this.status.writerDone = false;
+    this.status.verdict = undefined;
+    this.status.verdictMessage = undefined;
+    this.status.reviewerStarted = undefined;
+    this.status.approvedAt = undefined;
+    this.status.blockedAt = undefined;
+    this.status.codeFiles = undefined;
+    this.status.changesRequested = undefined;
+    this.save();
+  }
+
+  /**
+   * Check if a review session exists for this project
+   */
+  exists(): boolean {
+    const path = join(this.dir, STATUS_FILE);
+    return existsSync(path);
+  }
+
+  /**
+   * Export status as markdown for display
+   */
+  toMarkdown(): string {
+    if (!this.status) return "No active write-review session.";
+
+    const { phase, iteration, verdict, verdictMessage, codeFiles } = this.status;
+    const lines = [
+      `## Write-Review Status`,
+      ``,
+      `| Field | Value |`,
+      `|-------|-------|`,
+      `| Phase | ${phase} |`,
+      `| Iteration | ${iteration} |`,
+      `| Verdict | ${verdict ?? "pending"} |`,
+    ];
+
+    if (verdictMessage) {
+      lines.push(`| Message | ${verdictMessage} |`);
+    }
+
+    if (codeFiles && codeFiles.length > 0) {
+      lines.push(``, `### Code Files`);
+      for (const file of codeFiles) {
+        lines.push(`- ${file}`);
+      }
+    }
+
+    return lines.join("\n");
+  }
+}
+
+/**
+ * Create or get blackboard for project
+ */
+export function createBlackboard(projectPath: string, dir?: string): WriteReviewBlackboard {
+  const bb = new WriteReviewBlackboard(projectPath, dir);
+  if (!bb.exists()) {
+    bb.init();
+  } else {
+    bb.load();
+  }
+  return bb;
+}

package/packages/write-review/src/gate.ts

@@ -0,0 +1,167 @@
+/**
+ * No-Build Gate
+ *
+ * Blocks build commands until review is approved.
+ */
+
+import type { WriteReviewBlackboard } from "./blackboard.js";
+import type { WriteReviewStatus } from "./types.js";
+
+/**
+ * Commands that trigger build gate
+ */
+const BUILD_COMMANDS = [
+  "bench build",
+  "npm run build",
+  "yarn build",
+  "pnpm build",
+  "bun run build",
+  "npm run dev",
+  "yarn dev",
+  "pnpm dev",
+  "./build",
+  "make build",
+  "gradle build",
+  "mvn package",
+  "dotnet build",
+  "cargo build",
+  "go build",
+  "python manage.py migrate",
+  "bench migrate",
+  "bench --site",
+];
+
+/**
+ * Check if a command is a build command
+ */
+export function isBuildCommand(command: string): boolean {
+  const lower = command.toLowerCase().trim();
+  return BUILD_COMMANDS.some((cmd) => lower.includes(cmd.toLowerCase()));
+}
+
+/**
+ * Gate result
+ */
+export interface GateResult {
+  allowed: boolean;
+  reason?: string;
+  currentPhase?: string;
+  message?: string;
+}
+
+/**
+ * Check if build is allowed
+ */
+export function checkBuildGate(
+  command: string,
+  blackboard: WriteReviewBlackboard
+): GateResult {
+  if (!isBuildCommand(command)) {
+    return { allowed: true };
+  }
+
+  const status = blackboard.load();
+  if (!status) {
+    // No review session - allow build
+    return { allowed: true };
+  }
+
+  if (status.phase === "approved") {
+    return {
+      allowed: true,
+      currentPhase: status.phase,
+      message: "Build allowed - review approved.",
+    };
+  }
+
+  return {
+    allowed: false,
+    reason: "REVIEW_NOT_APPROVED",
+    currentPhase: status.phase,
+    message: `Build blocked. Current review phase: ${status.phase}. Wait for "APPROVED" verdict.`,
+  };
+}
+
+/**
+ * Format gate rejection message
+ */
+export function formatGateRejection(result: GateResult): string {
+  if (result.allowed) {
+    return "";
+  }
+
+  const lines = [
+    "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
+    "⚠️  BUILD BLOCKED",
+    "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
+    "",
+    `Current Phase: ${result.currentPhase}`,
+    "",
+    "The code is under review. Build is only allowed after APPROVED verdict.",
+    "",
+    "To check status:",
+    `  cat {project}/.write-review/status.json`,
+    "",
+    "To wait for approval, do nothing. The reviewer will post the verdict.",
+    "",
+  ];
+
+  if (result.currentPhase === "changes_requested") {
+    lines.push("Reviewer requested changes. Writer agent should update the code.");
+  } else if (result.currentPhase === "reviewing") {
+    lines.push("Review is in progress. Please wait...");
+  } else if (result.currentPhase === "pending_review") {
+    lines.push("Review not started yet. Waiting for reviewer...");
+  }
+
+  return lines.join("\n");
+}
+
+/**
+ * Get phase emoji
+ */
+export function getPhaseEmoji(phase: string): string {
+  const emojis: Record<string, string> = {
+    idle: "💤",
+    writing: "✍️",
+    pending_review: "⏳",
+    reviewing: "🔍",
+    approved: "✅",
+    blocked: "🚫",
+    changes_requested: "🔄",
+  };
+  return emojis[phase] ?? "❓";
+}
+
+/**
+ * Format status for display
+ */
+export function formatStatusDisplay(status: WriteReviewStatus): string {
+  const emoji = getPhaseEmoji(status.phase);
+  const lines = [
+    `${emoji} Write-Review Status`,
+    "",
+    `Phase: ${status.phase}`,
+    `Iteration: ${status.iteration}`,
+  ];
+
+  if (status.verdict) {
+    lines.push(`Verdict: ${status.verdict}`);
+  }
+
+  if (status.verdictMessage) {
+    lines.push("");
+    lines.push("Message:");
+    lines.push(status.verdictMessage);
+  }
+
+  if (status.codeFiles && status.codeFiles.length > 0) {
+    lines.push("");
+    lines.push("Code Files:");
+    for (const file of status.codeFiles) {
+      lines.push(`  - ${file}`);
+    }
+  }
+
+  return lines.join("\n");
+}

package/packages/write-review/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * write-review - Two-agent code writing with review loop
+ *
+ * Integrates with pi-harness-runtime via:
+ * - Smart trigger detection (prompt files in wiki/)
+ * - System prompt injection for writer agent
+ * - Subagent integration for reviewer agent
+ *
+ * Directory structure: {project}/.write-review/
+ */
+
+// Re-export all public APIs
+export * from "./types.js";
+export * from "./blackboard.js";
+export * from "./trigger.js";
+export * from "./injection.js";
+export * from "./gate.js";
+export * from "./review.js";