pi-harness-runtime 0.9.25 → 0.10.0

package/harness/herdr-agents.ts

@@ -0,0 +1,91 @@
+/**
+ * Herdr Agent Commands
+ */
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { join } from "path";
+import {
+	createHerdrBus,
+	getHerdrWorkspacePaths,
+	ensureHerdrWorkspace,
+} from "../packages/event-bus/src/herdr-bus.js";
+
+async function startReviewAgent(): Promise<void> {
+	console.log("[herdr:review] Starting review agent...");
+	const bus = createHerdrBus("review-agent");
+	ensureHerdrWorkspace();
+	bus.subscribe("code.written");
+	bus.startPolling(async (payload) => {
+		if (payload.topic === "code.written") {
+			const data = payload.data as { taskId: string; files: string[] };
+			console.log(
+				`[herdr:review] code.written: task=${data.taskId} files=${data.files.length}`,
+			);
+			for (const file of data.files ?? []) {
+				console.log(`[herdr:review] Reviewing: ${file}`);
+			}
+		}
+	});
+	console.log(`[herdr:review] Workspace: ${bus.getWorkspace()}`);
+	await new Promise(() => {});
+}
+
+async function startCodeAgent(): Promise<void> {
+	console.log("[herdr:code] Starting code agent...");
+	const bus = createHerdrBus("code-agent");
+	ensureHerdrWorkspace();
+	bus.subscribe("review.completed");
+	bus.startPolling(async (payload) => {
+		if (payload.topic === "review.completed") {
+			const data = payload.data as {
+				taskId: string;
+				reportFile: string;
+				status: string;
+			};
+			console.log(
+				`[herdr:code] Review done: task=${data.taskId} status=${data.status} report=${data.reportFile}`,
+			);
+		}
+	});
+	console.log(`[herdr:code] Workspace: ${bus.getWorkspace()}`);
+	await new Promise(() => {});
+}
+
+function showStatus(): void {
+	const paths = getHerdrWorkspacePaths();
+	console.log(`Workspace: ${paths.root}`);
+	const evPath = join(paths.root, "events.jsonl");
+	if (existsSync(evPath)) {
+		const lines = readFileSync(evPath, "utf-8")
+			.split("\n")
+			.filter(Boolean)
+			.slice(-10);
+		console.log("Recent events:");
+		for (const line of lines) {
+			try {
+				const { topic, ts } = JSON.parse(line);
+				console.log(`  ${ts} ${topic}`);
+			} catch {
+				/* skip */
+			}
+		}
+	}
+	if (existsSync(paths.subscriptions)) {
+		const agents = readdirSync(paths.subscriptions);
+		console.log(`Active agents: ${agents.join(", ") || "none"}`);
+	}
+}
+
+const [command] = process.argv.slice(2);
+switch (command) {
+	case "review":
+		startReviewAgent().catch(console.error);
+		break;
+	case "code":
+		startCodeAgent().catch(console.error);
+		break;
+	case "status":
+		showStatus();
+		break;
+	default:
+		console.log("Usage: bun harness/herdr-agents.ts <review|code|status>");
+}

package/harness/index.ts

@@ -178,7 +178,7 @@ export type { QuotaStatus, QuotaDisplayConfig } from "./e2e/quota-status.js";
 // Project Detector
 export { ProjectDetector } from "./project-detector/detector.js";
 
-// ─── RFC-0056: Performance Optimizer ────────────────────────────────────────
+// --- RFC-0056: Performance Optimizer ----------------------------------------
 export {
 	PerformanceOptimizer,
 	createPerformanceOptimizer,
@@ -189,7 +189,7 @@ export type {
 	PerformanceRecommendation,
 } from "../packages/performance-optimizer/src/types.js";
 
-// ─── RFC-0057: Evaluation Engine ───────────────────────────────────────────
+// --- RFC-0057: Evaluation Engine -------------------------------------------
 export {
 	EvaluationEngine,
 	createEvaluationEngine,
@@ -200,7 +200,7 @@ export type {
 	EvaluationFinding,
 } from "../packages/evaluation-engine/src/types.js";
 
-// ─── RFC-0058: Learning Engine ─────────────────────────────────────────────
+// --- RFC-0058: Learning Engine ---------------------------------------------
 export {
 	LearningEngine,
 	createLearningEngine,
@@ -210,7 +210,7 @@ export type {
 	LearnedExperience,
 } from "../packages/learning-engine/src/types.js";
 
-// ─── RFC-0059: Experience Replay ──────────────────────────────────────────
+// --- RFC-0059: Experience Replay ------------------------------------------
 export {
 	ExperienceReplay,
 	createExperienceReplay,
@@ -220,7 +220,7 @@ export type {
 	ReplayResult,
 } from "../packages/experience-replay/src/types.js";
 
-// ─── RFC-0060: Memory Engine ───────────────────────────────────────────────
+// --- RFC-0060: Memory Engine -----------------------------------------------
 export {
 	MemoryEngine,
 	createMemoryEngine,

package/harness/loop-code-agent.ts

@@ -0,0 +1,284 @@
+/**
+ * Loop Code Agent (Minimax) — coordinates via blackboard.
+ *
+ * Polls blackboard for nextAction where agentType="code".
+ * Writes code, updates node status, sets nextAction for review-agent.
+ *
+ * Usage:  bun harness/loop-code-agent.ts
+ */
+
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import {
+	createHerdrBus,
+	ensureHerdrWorkspace,
+} from "../packages/event-bus/src/herdr-bus.js";
+import { SharedBlackboard } from "./blackboard.js";
+import type { LoopNextAction, LoopAgentReport } from "./loop-types.js";
+import type { BlackboardRecord } from "../packages/types/src/runtime-types.js";
+
+const AGENT_ID = "code-agent";
+const AGENT_TYPE = "code";
+const POLL_MS = 1000;
+
+async function main(): Promise<void> {
+	console.log(`[${AGENT_ID}] Starting...`);
+	const paths = ensureHerdrWorkspace();
+
+	// Find active loop config
+	const loopId = await findActiveLoop(paths.root);
+	if (!loopId) {
+		console.log(`[${AGENT_ID}] No active loop found. Waiting...`);
+	}
+
+	const rootDir = paths.root;
+	const blackboard = new SharedBlackboard(loopId ?? "no-loop", rootDir);
+	blackboard.load();
+	blackboard.registerAgent(AGENT_ID, "Code Agent", "minimax", "minimax");
+	blackboard.updateAgentStatus(AGENT_ID, "idle");
+	console.log(`[${AGENT_ID}] Registered. Blackboard: ${blackboard.getPath()}`);
+
+	while (true) {
+		await sleep(POLL_MS);
+
+		blackboard.load();
+		const record = blackboard.getRecord();
+		if (!record) continue;
+
+		// Check for early exit
+		const earlyExit = checkEarlyExit(record);
+		if (earlyExit) {
+			console.log(`[${AGENT_ID}] Early exit: ${earlyExit}`);
+			blackboard.updateAgentStatus(AGENT_ID, "idle");
+			break;
+		}
+
+		// Check if this loop is ours (loopId matches)
+		if (record.jobId !== loopId) continue;
+
+		// Check nextAction for code agent
+		const action = parseNextAction(record.nextAction);
+		if (!action || action.agentType !== AGENT_TYPE) continue;
+
+		// Claim the task
+		const locked = blackboard.acquireLock(action.taskId, AGENT_ID);
+		if (!locked) continue;
+
+		blackboard.updateAgentStatus(AGENT_ID, "working", action.taskId);
+		console.log(`[${AGENT_ID}] Claimed: ${action.taskId}`);
+
+		// Do the work
+		const result = await writeCode(action, paths, record.jobId);
+
+		// Update task status
+		updateTaskStatus(blackboard, record, action.taskId, "done", result.files);
+
+		// Set nextAction for review agent
+		const nextTaskId = getNextReviewTask(record, action.iteration);
+		if (nextTaskId) {
+			blackboard.setNextAction(
+				encodeNextAction({
+					taskId: nextTaskId,
+					agentType: "review",
+					iteration: getReviewIteration(nextTaskId),
+					prompt: action.prompt,
+					codeFiles: result.files,
+				}),
+			);
+			console.log(`[${AGENT_ID}] -> nextAction: review ${nextTaskId}`);
+		} else {
+			// No review needed — go to report
+			const writeDone = getNextWriteTask(record, action.iteration);
+			if (writeDone) {
+				blackboard.setNextAction(
+					encodeNextAction({
+						taskId: writeDone,
+						agentType: "code",
+						iteration: getWriteIteration(writeDone),
+						prompt: action.prompt,
+					}),
+				);
+				console.log(`[${AGENT_ID}] -> nextAction: code ${writeDone}`);
+			} else {
+				// All done — go to report
+				blackboard.setNextAction(
+					encodeNextAction({
+						taskId: "report",
+						agentType: "review",
+						iteration: 0,
+					}),
+				);
+				console.log(`[${AGENT_ID}] -> nextAction: report`);
+			}
+		}
+
+		// Release lock and report
+		blackboard.releaseLock(action.taskId, AGENT_ID);
+		blackboard.writeReport({
+			agentId: AGENT_ID,
+			taskId: action.taskId,
+			status: "success",
+			files: result.files,
+		} satisfies LoopAgentReport);
+		blackboard.updateAgentStatus(AGENT_ID, "idle");
+	}
+}
+
+async function writeCode(
+	action: LoopNextAction,
+	paths: { code: string },
+	loopId: string,
+): Promise<{ files: string[] }> {
+	const iteration = action.iteration;
+	const outputDir = join(paths.code, loopId, `iteration-${iteration}`);
+	mkdirSync(outputDir, { recursive: true });
+
+	const codeFile = join(outputDir, `index.ts`);
+	// TODO: Replace with actual Minimax call
+	const code = `// Iteration ${iteration} — ${action.prompt}
+// TODO: Replace with actual Minimax code generation
+export const iteration = ${iteration};
+export const prompt = ${JSON.stringify(action.prompt)};
+`;
+	writeFileSync(codeFile, code);
+	console.log(`[${AGENT_ID}] Wrote: ${codeFile}`);
+	return { files: [codeFile] };
+}
+
+// ─── Helpers ────────────────────────────────────────────────────────────────
+
+async function findActiveLoop(rootDir: string): Promise<string | null> {
+	const { readdirSync, existsSync } = await import("fs");
+	try {
+		const files = readdirSync(rootDir).filter(
+			(f) => f.startsWith("loop-") && f.endsWith(".config.json"),
+		);
+		// Find most recent config that has an active blackboard
+		for (const configFile of files.slice(-1)) {
+			const config = JSON.parse(
+				readFileSync(join(rootDir, configFile), "utf-8"),
+			);
+			const bbPath = join(rootDir, "jobs", config.loopId, "blackboard");
+			if (existsSync(bbPath)) return config.loopId;
+		}
+	} catch {
+		// no loop yet
+	}
+	return null;
+}
+
+function encodeNextAction(action: Partial<LoopNextAction>) {
+	return {
+		taskId: action.taskId,
+		instruction: "LOOP:" + JSON.stringify(action),
+		priority: "high" as const,
+		createdAt: new Date().toISOString(),
+	};
+}
+
+function parseNextAction(nextAction: unknown): LoopNextAction | null {
+	if (!nextAction) return null;
+	const a = nextAction as Record<string, unknown>;
+	if (!a.taskId) return null;
+	if (typeof a.instruction === "string" && a.instruction.startsWith("LOOP:")) {
+		try {
+			return JSON.parse(a.instruction.slice(5)) as LoopNextAction;
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+
+function checkEarlyExit(record: BlackboardRecord): string | null {
+	const blocked = Object.values(record.tasks.nodes).find(
+		(n) => n.status === "blocked",
+	);
+	if (blocked) return `blocked at ${blocked.id}`;
+	const approved = Object.values(record.tasks.nodes).find(
+		(n) =>
+			n.status === "done" && (n as { result?: string }).result === "approved",
+	);
+	if (approved) return "approved";
+	return null;
+}
+
+function updateTaskStatus(
+	blackboard: SharedBlackboard,
+	record: BlackboardRecord,
+	taskId: string,
+	status: "done" | "running" | "blocked",
+	files?: string[],
+): void {
+	if (record.tasks.nodes[taskId]) {
+		(
+			record.tasks.nodes[taskId] as unknown as {
+				status: string;
+				result?: string;
+			}
+		).status = status;
+		if (files)
+			(record.tasks.nodes[taskId] as unknown as { result?: string }).result =
+				files.join(", ");
+		(
+			record.tasks.nodes[taskId] as unknown as { updatedAt?: string }
+		).updatedAt = new Date().toISOString();
+		blackboard.save();
+	}
+}
+
+function getNextReviewTask(
+	record: BlackboardRecord,
+	writeIteration: number,
+): string | null {
+	const reviewCount = Object.keys(record.tasks.nodes).filter((id) =>
+		id.startsWith("review-"),
+	).length;
+	const step = Math.max(
+		1,
+		Math.floor(
+			Object.keys(record.tasks.nodes).filter((id) => id.startsWith("write-"))
+				.length / (reviewCount || 1),
+		),
+	);
+	const targetReview = Math.ceil(writeIteration / step);
+	const taskId = `review-${targetReview}`;
+	if (
+		record.tasks.nodes[taskId] &&
+		record.tasks.nodes[taskId].status === "pending"
+	) {
+		return taskId;
+	}
+	return null;
+}
+
+function getNextWriteTask(
+	record: BlackboardRecord,
+	currentIteration: number,
+): string | null {
+	const nextWrite = currentIteration + 1;
+	const taskId = `write-${nextWrite}`;
+	if (
+		record.tasks.nodes[taskId] &&
+		record.tasks.nodes[taskId].status === "pending"
+	) {
+		return taskId;
+	}
+	return null;
+}
+
+function getReviewIteration(taskId: string): number {
+	const m = taskId.match(/^review-(\d+)$/);
+	return m ? parseInt(m[1], 10) : 0;
+}
+
+function getWriteIteration(taskId: string): number {
+	const m = taskId.match(/^write-(\d+)$/);
+	return m ? parseInt(m[1], 10) : 0;
+}
+
+function sleep(ms: number): Promise<void> {
+	return new Promise((r) => setTimeout(r, ms));
+}
+
+main().catch(console.error);

package/harness/loop-controller.ts

@@ -0,0 +1,201 @@
+/**
+ * Loop Controller — blackboard-coordinated write-review loops.
+ *
+ * Human types /review-loop <write_count> <review_count> --prompt="..."
+ * Controller creates blackboard, sets first nextAction, monitors progress.
+ */
+
+import { writeFileSync } from "fs";
+import { join } from "path";
+import { randomUUID } from "crypto";
+import {
+	createHerdrBus,
+	ensureHerdrWorkspace,
+	publishLoopStarted,
+	type LoopConfig,
+} from "../packages/event-bus/src/index.js";
+import { createBlackboard } from "./blackboard.js";
+import { buildLoopTaskGraph } from "./loop-types.js";
+import type { SharedBlackboard } from "./blackboard.js";
+
+function encodeNextAction(la: {
+	taskId: string;
+	agentType: string;
+	iteration: number;
+	prompt?: string;
+	codeFiles?: string[];
+}) {
+	return {
+		taskId: la.taskId,
+		instruction: "LOOP:" + JSON.stringify(la),
+		priority: "high" as const,
+		createdAt: new Date().toISOString(),
+	};
+}
+
+function sleep(ms: number): Promise<void> {
+	return new Promise((r) => setTimeout(r, ms));
+}
+
+// ─── Monitor ────────────────────────────────────────────────────────────────
+
+async function monitorLoop(
+	blackboard: SharedBlackboard,
+	loopId: string,
+): Promise<void> {
+	const paths = ensureHerdrWorkspace();
+
+	while (true) {
+		blackboard.load();
+		const record = blackboard.getRecord();
+		if (!record) {
+			await sleep(500);
+			continue;
+		}
+
+		// Check if report is done
+		const reportNode = record.tasks.nodes["report"];
+		if (reportNode?.status === "done") {
+			const reviews = Object.values(record.tasks.nodes).filter(
+				(n) => n.id.startsWith("review-") && n.status === "done",
+			);
+			const lastReview = reviews.sort((a, b) =>
+				(b.updatedAt ?? "").localeCompare(a.updatedAt ?? ""),
+			)[0];
+			const verdict = (lastReview as { result?: string }).result ?? "unknown";
+			const summary =
+				verdict !== "unknown" ? `Verdict: ${verdict}` : "Loop completed";
+
+			const reportPath = join(
+				paths.reviews,
+				`loop-${loopId.slice(0, 8)}-final.md`,
+			);
+			writeFileSync(
+				reportPath,
+				`# Loop Result — ${loopId.slice(0, 8)}
+
+## Result
+${summary}
+
+## Verdict: **${verdict.toUpperCase()}**
+`,
+			);
+			console.log(`[controller] VERDICT: ${verdict.toUpperCase()}`);
+			console.log(`[controller] Report: ${reportPath}`);
+			return;
+		}
+
+		// Check for blocked
+		const blocked = Object.values(record.tasks.nodes).find(
+			(n) => n.status === "blocked",
+		);
+		if (blocked) {
+			const reportPath = join(
+				paths.reviews,
+				`loop-${loopId.slice(0, 8)}-final.md`,
+			);
+			writeFileSync(
+				reportPath,
+				`# Loop Result — ${loopId.slice(0, 8)}
+
+## Result
+Blocked at: ${blocked.id}
+
+## Verdict: **BLOCKED**
+`,
+			);
+			console.log(`[controller] VERDICT: BLOCKED (${blocked.id})`);
+			return;
+		}
+
+		await sleep(500);
+	}
+}
+
+// ─── Run ──────────────────────────────────────────────────────────────────
+
+async function runLoop(args: string[]): Promise<void> {
+	const writeCount = parseInt(args[0] ?? "3", 10);
+	const reviewCount = parseInt(args[1] ?? "2", 10);
+	const prompt =
+		(args.find((a) => a.startsWith("--prompt=")) ?? "")
+			.slice("--prompt=".length)
+			.replace(/^["']|["']$/g, "") || "No prompt";
+
+	if (isNaN(writeCount) || writeCount < 1 || writeCount > 20) {
+		console.error("write_count must be 1-20");
+		process.exit(1);
+	}
+	if (isNaN(reviewCount) || reviewCount < 0 || reviewCount > 20) {
+		console.error("review_count must be 0-20");
+		process.exit(1);
+	}
+
+	const loopId = randomUUID();
+	const paths = ensureHerdrWorkspace();
+	const taskGraph = buildLoopTaskGraph(writeCount, reviewCount, loopId);
+
+	console.log("=".repeat(60));
+	console.log(`LOOP STARTED — ${loopId.slice(0, 8)}`);
+	console.log(`  Writes: ${writeCount}  Reviews: ${reviewCount}`);
+	console.log(`  Prompt: ${prompt}`);
+	console.log("=".repeat(60));
+
+	// Create blackboard
+	const blackboard = createBlackboard(loopId, paths.root, taskGraph);
+	console.log(`[controller] Blackboard: ${blackboard.getPath()}`);
+
+	// Event bus for cross-process signaling
+	const bus = createHerdrBus(`ctrl-${loopId.slice(0, 8)}`);
+
+	// Save config
+	// Clean old loop configs
+	for (const f of (await import("fs")).readdirSync(paths.root)) {
+		if (f.startsWith("loop-") && f.endsWith(".config.json")) {
+			(await import("fs")).unlinkSync(join(paths.root, f));
+		}
+	}
+
+	const config: LoopConfig = {
+		loopId,
+		writeCount,
+		reviewCount,
+		prompt,
+		nextReviewAfter: Math.max(1, Math.floor(writeCount / (reviewCount || 1))),
+		createdAt: new Date().toISOString(),
+	};
+	writeFileSync(
+		join(paths.root, `loop-${loopId}.config.json`),
+		JSON.stringify(config, null, 2),
+	);
+	publishLoopStarted(bus, config);
+
+	// Set first action: code agent writes iteration 1
+	blackboard.setNextAction(
+		encodeNextAction({
+			taskId: "write-1",
+			agentType: "code",
+			iteration: 1,
+			prompt,
+		}),
+	);
+	console.log("[controller] nextAction: code write-1");
+
+	// Monitor until done
+	await monitorLoop(blackboard, loopId);
+}
+
+// ─── CLI ──────────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+if (!args.length || args[0] === "--help" || args[0] === "-h") {
+	console.log(
+		'Usage: bun harness/loop-controller.ts <write_count> <review_count> --prompt="..."\nExample: bun harness/loop-controller.ts 3 2 --prompt="build REST API"',
+	);
+	process.exit(0);
+}
+
+runLoop(args).catch((err) => {
+	console.error("[controller] Fatal:", err);
+	process.exit(1);
+});