pi-harness-runtime 1.1.95 → 1.1.97

package/packages/write-review/dist/blackboard.js

@@ -0,0 +1,289 @@
+/**
+ * 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";
+const DEFAULT_DIR = ".write-review";
+const STATUS_FILE = "status.json";
+export class WriteReviewBlackboard {
+    projectPath;
+    dir;
+    status = null;
+    constructor(projectPath, dir = DEFAULT_DIR) {
+        this.projectPath = projectPath;
+        this.dir = join(projectPath, dir);
+    }
+    /**
+     * Initialize a new write-review session
+     */
+    init() {
+        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() {
+        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() {
+        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() {
+        return this.status;
+    }
+    /**
+     * Record the automatic decision that selected or skipped PING-PONG.
+     * This is the durable middleware state shared by separate agent terminals.
+     */
+    recordPingPongDecision(snapshot) {
+        if (!this.status)
+            this.init();
+        this.status.mode = "ping_pong";
+        this.status.pingPong = snapshot;
+        this.status.writerMessage = snapshot.request;
+        if (snapshot.decision === "run_ping_pong") {
+            this.status.phase = "writing";
+            this.status.writerDone = false;
+        }
+        else {
+            this.status.phase = "idle";
+        }
+        this.save();
+    }
+    /**
+     * Start a new write session
+     */
+    startWriting() {
+        if (!this.status)
+            this.init();
+        this.status.phase = "writing";
+        this.status.writerDone = false;
+        this.status.iteration++;
+        this.save();
+    }
+    /**
+     * Mark writer as done
+     */
+    writerDone(message) {
+        if (!this.status)
+            return;
+        this.status.writerDone = true;
+        this.status.writerMessage = message;
+        this.status.phase = "pending_review";
+        this.save();
+    }
+    /**
+     * Start reviewing
+     */
+    startReview() {
+        if (!this.status)
+            return;
+        this.status.phase = "reviewing";
+        this.status.reviewerStarted = new Date().toISOString();
+        this.save();
+    }
+    /**
+     * Record verdict
+     */
+    setVerdict(verdict, message) {
+        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) {
+        if (!this.status)
+            return;
+        this.status.codeFiles = files;
+        this.save();
+    }
+    /**
+     * Record requested changes
+     */
+    setChangesRequested(changes) {
+        if (!this.status)
+            return;
+        this.status.changesRequested = changes;
+        this.save();
+    }
+    /**
+     * Get current phase
+     */
+    getPhase() {
+        return this.status?.phase ?? "idle";
+    }
+    /**
+     * Get iteration number
+     */
+    getIteration() {
+        return this.status?.iteration ?? 0;
+    }
+    /**
+     * Check if build is allowed
+     */
+    canBuild() {
+        return this.status?.phase === "approved";
+    }
+    /**
+     * Get blackboard directory path
+     */
+    getPath() {
+        return this.dir;
+    }
+    /**
+     * Reset to idle
+     */
+    reset() {
+        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() {
+        const path = join(this.dir, STATUS_FILE);
+        return existsSync(path);
+    }
+    /**
+     * Export status as markdown for display.
+     * Injected into every agent prompt so each agent sees the shared scoreboard.
+     * Matches the pi-lens pattern: persistent artifact encountered naturally.
+     */
+    toMarkdown() {
+        if (!this.status)
+            return "No active write-review session.";
+        const { phase, iteration, verdict, verdictMessage, codeFiles, changesRequested, } = this.status;
+        const verdictIcon = verdict === "approved"
+            ? "✅"
+            : verdict === "blocked"
+                ? "⛔"
+                : verdict === "changes_requested"
+                    ? "🔄"
+                    : "⏳";
+        const lines = [
+            `## Write-Review Scoreboard`,
+            ``,
+            `| Field | Value |`,
+            `|-------|-------|`,
+            `| Phase | ${verdictIcon} ${phase} |`,
+            `| Iteration | ${iteration} |`,
+            `| Verdict | ${verdict ?? "(none yet)"} |`,
+        ];
+        if (verdictMessage) {
+            lines.push(`| Summary | ${verdictMessage} |`);
+        }
+        if (codeFiles && codeFiles.length > 0) {
+            lines.push(``, `### Code Files Written`);
+            for (const file of codeFiles) {
+                lines.push(`- ${file}`);
+            }
+        }
+        if (changesRequested && changesRequested.length > 0) {
+            lines.push(``, `### Changes Requested (${changesRequested.length})`);
+            for (const change of changesRequested) {
+                lines.push(`- ${change}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Extract file paths from a fenced code block string.
+     * Looks for common patterns: ```path/to/file
+     */
+    extractFilePaths(code) {
+        const files = new Set();
+        // Match ```<whitespace>path (with optional language tag)
+        const fencedRe = /^```(?:\w+)?\s+([^\n]+)/gm;
+        let match;
+        while ((match = fencedRe.exec(code)) !== null) {
+            const path = match[1].trim();
+            // Skip if it looks like a filename with spaces (not a path)
+            if (path &&
+                !path.includes(" ") &&
+                (path.includes("/") ||
+                    path.includes("\\") ||
+                    path.endsWith(".ts") ||
+                    path.endsWith(".js") ||
+                    path.endsWith(".tsx") ||
+                    path.endsWith(".json") ||
+                    path.endsWith(".md"))) {
+                files.add(path);
+            }
+        }
+        return [...files];
+    }
+}
+/**
+ * Create or get blackboard for project
+ */
+export function createBlackboard(projectPath, dir) {
+    const bb = new WriteReviewBlackboard(projectPath, dir);
+    if (bb.exists()) {
+        bb.load();
+    }
+    else {
+        bb.init();
+    }
+    return bb;
+}
+//# sourceMappingURL=blackboard.js.map

package/packages/write-review/dist/blackboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blackboard.js","sourceRoot":"","sources":["../src/blackboard.ts"],"names":[],"mappings":"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"}

package/packages/write-review/dist/event-bus.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Ping-Pong Event Bus
+ *
+ * Lightweight event bus for two-agent coordination.
+ * Watches blackboard status.json for state changes.
+ * Emits events and notifies agents via ExtensionAPI.
+ *
+ * NO AI NEEDED - deterministic file watching + state machine.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * Ping-Pong Events
+ */
+export declare enum PingPongEvent {
+    SESSION_STARTED = "session_started",
+    WRITING_STARTED = "writing_started",
+    WRITER_DONE = "writer_done",
+    REVIEW_NEEDED = "review_needed",
+    REVIEW_STARTED = "review_started",
+    REVIEW_COMPLETE = "review_complete",
+    APPROVED = "approved",
+    CHANGES_REQUESTED = "changes_requested",
+    BLOCKED = "blocked",
+    SESSION_ENDED = "session_ended"
+}
+/**
+ * Event payload
+ */
+export interface PingPongEventPayload {
+    event: PingPongEvent;
+    phase: string;
+    iteration: number;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Event listener callback
+ */
+export type PingPongListener = (payload: PingPongEventPayload) => void | Promise<void>;
+/**
+ * Simple Event Bus for ping-pong coordination
+ */
+export declare class PingPongEventBus {
+    private listeners;
+    private watchers;
+    private lastStatusHash;
+    private pi;
+    private projectPath;
+    /**
+     * Register an event listener
+     */
+    on(event: PingPongEvent, listener: PingPongListener): () => void;
+    /**
+     * Register a listener for all events
+     */
+    onAny(listener: PingPongListener): () => void;
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Notify agents via ExtensionAPI
+     */
+    private notifyAgents;
+    /**
+     * Start watching a blackboard status.json
+     */
+    startWatching(blackboardPath: string): void;
+    /**
+     * Read status.json and emit events if changed
+     */
+    private readAndEmit;
+    /**
+     * Stop watching
+     */
+    stopWatching(): void;
+    /**
+     * Set ExtensionAPI for notifications
+     */
+    setExtensionAPI(pi: ExtensionAPI): void;
+    /**
+     * Get current status hash
+     */
+    getLastStatusHash(): string | null;
+    /**
+     * Clean up
+     */
+    destroy(): void;
+}
+/**
+ * Get global event bus instance
+ */
+export declare function getPingPongEventBus(): PingPongEventBus;
+/**
+ * Create a new event bus instance
+ */
+export declare function createPingPongEventBus(): PingPongEventBus;
+/**
+ * Helper: Check if status changed from previous
+ */
+export declare function hasStatusChanged(current: Record<string, unknown>, previous: string | null): boolean;
+/**
+ * Helper: Format event for logging
+ */
+export declare function formatPingPongEvent(event: PingPongEventPayload): string;
+//# sourceMappingURL=event-bus.d.ts.map

package/packages/write-review/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;GAEG;AACH,oBAAY,aAAa;IACvB,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,QAAQ,aAAa;IACrB,iBAAiB,sBAAsB;IACvC,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAevF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAwD;IACzE,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,EAAE,CAA6B;IACvC,OAAO,CAAC,WAAW,CAAuB;IAE1C;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAU/D;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAgB5C;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IAkCZ;;OAEG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CA4B1C;IAED;;OAEG;IACH,OAAO,CAAC,WAAW;IAmDnB;;OAEG;IACH,YAAY,IAAI,IAAI,CAMnB;IAED;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEtC;IAED;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAId;CACF;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAST;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEvE"}