agents-harness 0.1.0

package/dist/core/orchestrator.js

@@ -0,0 +1,238 @@
+import { EventEmitter } from "node:events";
+import { ContextManager } from "./context-manager.js";
+import { FileProtocol } from "./file-protocol.js";
+import { buildProjectContext } from "../discovery/project-context.js";
+export class Harness extends EventEmitter {
+    contextManager;
+    fileProtocol;
+    progress;
+    aborted = false;
+    options;
+    constructor(opts) {
+        super();
+        const projectContext = buildProjectContext(opts.root, opts.scope ?? null);
+        // Apply config overrides from .harness/config.yaml
+        const config = projectContext.config;
+        this.options = {
+            maxAttemptsPerSprint: opts.maxAttemptsPerSprint ?? config?.maxAttemptsPerSprint ?? 3,
+            maxBudgetPerSprintUsd: opts.maxBudgetPerSprintUsd ?? config?.maxBudgetPerSprintUsd ?? 5,
+            maxTotalBudgetUsd: opts.maxTotalBudgetUsd ?? config?.maxTotalBudgetUsd ?? 50,
+        };
+        this.contextManager = new ContextManager(opts.apiKey, projectContext);
+        this.fileProtocol = new FileProtocol(opts.root);
+        this.progress = this.initProgress("");
+    }
+    initProgress(runSpec) {
+        return {
+            status: "running",
+            runSpec,
+            currentSprint: 0,
+            totalSprints: 0,
+            currentAttempt: 0,
+            currentPhase: "plan",
+            startedAt: new Date().toISOString(),
+            costUsd: 0,
+            maxBudgetUsd: this.options.maxTotalBudgetUsd,
+            sprints: {},
+        };
+    }
+    emitEvent(event) {
+        this.emit(event.type, event.data);
+        this.emit("event", event);
+    }
+    updatePhase(phase, sprint = 0, attempt = 0) {
+        this.progress.currentPhase = phase;
+        this.progress.currentSprint = sprint;
+        this.progress.currentAttempt = attempt;
+        this.emitEvent({
+            type: "phase:start",
+            data: { sprint, phase, attempt },
+        });
+    }
+    async runAgentPhase(role, prompt, sprint) {
+        const result = await this.contextManager.runAgent({
+            role,
+            prompt,
+            onActivity: (tool, summary) => {
+                this.emitEvent({
+                    type: "agent:activity",
+                    data: { sprint, role, tool, summary, timestamp: Date.now() },
+                });
+            },
+        });
+        this.progress.costUsd += result.costUsd;
+        if (this.progress.sprints[sprint]) {
+            this.progress.sprints[sprint].costUsd += result.costUsd;
+        }
+        this.emitEvent({
+            type: "cost:update",
+            data: {
+                sprintCostUsd: this.progress.sprints[sprint]?.costUsd ?? 0,
+                totalCostUsd: this.progress.costUsd,
+                budgetUsd: this.options.maxTotalBudgetUsd,
+            },
+        });
+        this.fileProtocol.writeProgress(this.progress);
+        return result.response;
+    }
+    isBudgetExceeded() {
+        return this.progress.costUsd >= this.options.maxTotalBudgetUsd;
+    }
+    parseTotalSprints(_plannerResponse) {
+        // Read sprints.md to count how many sprints were planned
+        const sprints = this.fileProtocol.readFile("sprints.md");
+        if (!sprints)
+            return 1;
+        // Count sprint headers (## Sprint N or ### Sprint N)
+        const matches = sprints.match(/^#{2,3}\s+Sprint\s+\d+/gim);
+        return matches ? matches.length : 1;
+    }
+    async run(spec) {
+        this.fileProtocol.ensureDir();
+        this.fileProtocol.ensureGitignore();
+        this.progress = this.initProgress(spec);
+        this.aborted = false;
+        try {
+            // Phase 1: Plan — write spec to file, have planner create full spec
+            this.updatePhase("plan");
+            this.fileProtocol.writeFile("spec.md", spec);
+            await this.runAgentPhase("planner", `Read .harness/spec.md. Create a comprehensive product specification. Write the full specification back to .harness/spec.md — expand and refine the user's original request into a complete spec.`, 0);
+            if (this.aborted || this.isBudgetExceeded())
+                return this.finalize();
+            // Phase 2: Decompose — break spec into sprints
+            this.updatePhase("decompose");
+            await this.runAgentPhase("planner", `Read .harness/spec.md. Decompose this specification into ordered sprints. Each sprint must be independently testable. Write the sprint plan to .harness/sprints.md.`, 0);
+            if (this.aborted || this.isBudgetExceeded())
+                return this.finalize();
+            const totalSprints = this.parseTotalSprints("");
+            this.progress.totalSprints = totalSprints;
+            // Execute sprints
+            for (let s = 1; s <= totalSprints; s++) {
+                if (this.aborted || this.isBudgetExceeded())
+                    break;
+                await this.executeSprint(s);
+            }
+        }
+        catch (error) {
+            this.progress.status = "failed";
+            this.fileProtocol.writeProgress(this.progress);
+            throw error;
+        }
+        return this.finalize();
+    }
+    async executeSprint(sprintNum) {
+        this.progress.sprints[sprintNum] = {
+            status: "in_progress",
+            attempts: 0,
+            costUsd: 0,
+        };
+        // Contract phase — have planner write a contract for this sprint
+        this.updatePhase("contract", sprintNum, 0);
+        await this.runAgentPhase("planner", `Read .harness/sprints.md. Write a sprint contract for Sprint ${sprintNum} to .harness/contract.md. Include specific, testable success criteria.`, sprintNum);
+        // Attempt loop
+        const maxAttempts = this.options.maxAttemptsPerSprint;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            if (this.aborted || this.isBudgetExceeded())
+                break;
+            this.progress.sprints[sprintNum].attempts = attempt;
+            // Generate phase
+            this.updatePhase("generate", sprintNum, attempt);
+            await this.runAgentPhase("generator", `Implement the sprint contract. Read .harness/contract.md for requirements.${attempt > 1 ? " Read .harness/evaluation.md for feedback from your previous attempt." : ""}`, sprintNum);
+            if (this.aborted || this.isBudgetExceeded())
+                break;
+            // Evaluate phase
+            this.updatePhase("evaluate", sprintNum, attempt);
+            await this.runAgentPhase("evaluator", `Evaluate the implementation against the sprint contract. Read .harness/contract.md for requirements. Write your evaluation to .harness/evaluation.md.`, sprintNum);
+            // Parse evaluation
+            const evalResult = this.fileProtocol.parseEvaluation();
+            this.emitEvent({
+                type: "evaluation",
+                data: { sprint: sprintNum, attempt, result: evalResult },
+            });
+            if (evalResult.passed) {
+                this.progress.sprints[sprintNum].status = "passed";
+                this.emitEvent({
+                    type: "sprint:complete",
+                    data: {
+                        sprint: sprintNum,
+                        status: "passed",
+                        attempts: attempt,
+                        costUsd: this.progress.sprints[sprintNum].costUsd,
+                    },
+                });
+                // Handoff phase — write context for next sprint
+                if (sprintNum < this.progress.totalSprints) {
+                    this.updatePhase("handoff", sprintNum);
+                    await this.runAgentPhase("planner", `Sprint ${sprintNum} passed. Write a handoff document to .harness/handoff.md summarizing what was done, what changed, and key context the next sprint needs.`, sprintNum);
+                }
+                return; // sprint passed, move to next
+            }
+            // If last attempt and still failing
+            if (attempt === maxAttempts) {
+                this.progress.sprints[sprintNum].status = "failed";
+                this.emitEvent({
+                    type: "sprint:complete",
+                    data: {
+                        sprint: sprintNum,
+                        status: "failed",
+                        attempts: attempt,
+                        costUsd: this.progress.sprints[sprintNum].costUsd,
+                    },
+                });
+            }
+        }
+    }
+    finalize() {
+        if (this.aborted) {
+            this.progress.status = "stopped";
+            this.progress.stoppedAt = new Date().toISOString();
+        }
+        else {
+            // Check if all sprints passed
+            const allPassed = Object.values(this.progress.sprints).every((s) => s.status === "passed");
+            this.progress.status = allPassed ? "completed" : "failed";
+        }
+        this.fileProtocol.writeProgress(this.progress);
+        const startMs = new Date(this.progress.startedAt).getTime();
+        const endMs = Date.now();
+        this.emitEvent({
+            type: "run:complete",
+            data: {
+                status: this.progress.status,
+                totalSprints: this.progress.totalSprints,
+                totalCostUsd: this.progress.costUsd,
+                durationMs: endMs - startMs,
+            },
+        });
+    }
+    async resume() {
+        const saved = this.fileProtocol.readProgress();
+        if (!saved) {
+            throw new Error("No progress file found. Nothing to resume.");
+        }
+        this.progress = { ...saved, status: "running" };
+        this.aborted = false;
+        delete this.progress.stoppedAt;
+        // Resume from the current sprint
+        const startSprint = this.progress.currentSprint || 1;
+        for (let s = startSprint; s <= this.progress.totalSprints; s++) {
+            if (this.aborted || this.isBudgetExceeded())
+                break;
+            const sprintProgress = this.progress.sprints[s];
+            if (sprintProgress?.status === "passed")
+                continue; // skip completed sprints
+            await this.executeSprint(s);
+        }
+        return this.finalize();
+    }
+    stop() {
+        this.aborted = true;
+        this.progress.status = "stopped";
+        this.progress.stoppedAt = new Date().toISOString();
+        this.fileProtocol.writeProgress(this.progress);
+    }
+    getProgress() {
+        return { ...this.progress };
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/core/orchestrator.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,136 @@
+export interface Stack {
+    language: string;
+    framework: string | null;
+    testRunner: string | null;
+    testCommand: string;
+    lintCommand: string | null;
+    buildCommand: string | null;
+    devServer: string | null;
+}
+export interface Workspace {
+    path: string;
+    stack: Stack;
+    claudeMd: string | null;
+}
+export interface ProjectContext {
+    repoType: "single" | "monorepo";
+    workspaces: Workspace[];
+    rootClaudeMd: string | null;
+    config: HarnessConfig | null;
+    criteria: string | null;
+    scope: string[] | null;
+    root: string;
+}
+export interface AgentConfig {
+    model?: string;
+    maxTurns?: number;
+    systemPromptAppend?: string;
+}
+export interface WorkspaceConfig {
+    path: string;
+    language?: string;
+    framework?: string;
+    testCommand?: string;
+    lintCommand?: string;
+    buildCommand?: string;
+    devServer?: string;
+}
+export interface HarnessConfig {
+    agents?: {
+        planner?: AgentConfig;
+        generator?: AgentConfig;
+        evaluator?: AgentConfig;
+    };
+    workspaces?: Record<string, WorkspaceConfig>;
+    maxAttemptsPerSprint?: number;
+    maxBudgetPerSprintUsd?: number;
+    maxTotalBudgetUsd?: number;
+}
+export type SprintStatus = "pending" | "in_progress" | "passed" | "failed";
+export type RunStatus = "running" | "stopped" | "completed" | "failed";
+export type Phase = "plan" | "decompose" | "contract" | "generate" | "evaluate" | "handoff";
+export interface SprintProgress {
+    status: SprintStatus;
+    attempts: number;
+    costUsd: number;
+}
+export interface Progress {
+    status: RunStatus;
+    runSpec: string;
+    currentSprint: number;
+    totalSprints: number;
+    currentAttempt: number;
+    currentPhase: Phase;
+    startedAt: string;
+    stoppedAt?: string;
+    costUsd: number;
+    maxBudgetUsd: number;
+    sprints: Record<number, SprintProgress>;
+}
+export interface EvalResult {
+    passed: boolean;
+    critique: string;
+    failedCriteria: string[];
+    passedCriteria: string[];
+}
+export type AgentRole = "planner" | "generator" | "evaluator";
+export interface AgentDefinition {
+    role: AgentRole;
+    systemPrompt: string;
+    tools: string[];
+    model: string;
+    maxTurns: number;
+}
+export interface PhaseStartEvent {
+    sprint: number;
+    phase: Phase;
+    attempt: number;
+}
+export interface AgentActivityEvent {
+    sprint: number;
+    role: AgentRole;
+    tool: string;
+    summary: string;
+    timestamp: number;
+}
+export interface EvaluationEvent {
+    sprint: number;
+    attempt: number;
+    result: EvalResult;
+}
+export interface CostUpdateEvent {
+    sprintCostUsd: number;
+    totalCostUsd: number;
+    budgetUsd: number;
+}
+export interface SprintCompleteEvent {
+    sprint: number;
+    status: SprintStatus;
+    attempts: number;
+    costUsd: number;
+}
+export interface RunCompleteEvent {
+    status: RunStatus;
+    totalSprints: number;
+    totalCostUsd: number;
+    durationMs: number;
+}
+export type HarnessEvent = {
+    type: "phase:start";
+    data: PhaseStartEvent;
+} | {
+    type: "agent:activity";
+    data: AgentActivityEvent;
+} | {
+    type: "evaluation";
+    data: EvaluationEvent;
+} | {
+    type: "cost:update";
+    data: CostUpdateEvent;
+} | {
+    type: "sprint:complete";
+    data: SprintCompleteEvent;
+} | {
+    type: "run:complete";
+    data: RunCompleteEvent;
+};

package/dist/core/types.js

@@ -0,0 +1,3 @@
+// --- Project Discovery Types ---
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,kCAAkC"}

package/dist/dashboard/server.d.ts

@@ -0,0 +1,15 @@
+import type { HarnessEvent } from "../core/types.js";
+export declare class DashboardServer {
+    private server;
+    private broadcaster;
+    private port;
+    private running;
+    constructor(port?: number);
+    private handleRequest;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getUrl(): string;
+    getPort(): number;
+    broadcast(event: HarnessEvent): void;
+}

package/dist/dashboard/server.js

@@ -0,0 +1,61 @@
+import { createServer } from "node:http";
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { WebSocketBroadcaster } from "./socket.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export class DashboardServer {
+    server;
+    broadcaster;
+    port;
+    running = false;
+    constructor(port = 3117) {
+        this.port = port;
+        this.server = createServer(this.handleRequest.bind(this));
+        this.broadcaster = new WebSocketBroadcaster(this.server);
+    }
+    handleRequest(req, res) {
+        // Serve the dashboard HTML for any request
+        try {
+            const htmlPath = join(__dirname, "static", "index.html");
+            const html = readFileSync(htmlPath, "utf-8");
+            res.writeHead(200, { "Content-Type": "text/html" });
+            res.end(html);
+        }
+        catch {
+            res.writeHead(500, { "Content-Type": "text/plain" });
+            res.end("Dashboard file not found");
+        }
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server.listen(this.port, () => {
+                this.running = true;
+                resolve();
+            });
+            this.server.on("error", reject);
+        });
+    }
+    async stop() {
+        return new Promise((resolve) => {
+            this.broadcaster.close();
+            this.server.close(() => {
+                this.running = false;
+                resolve();
+            });
+        });
+    }
+    isRunning() {
+        return this.running;
+    }
+    getUrl() {
+        return `http://localhost:${this.port}`;
+    }
+    getPort() {
+        return this.port;
+    }
+    broadcast(event) {
+        this.broadcaster.broadcast(event);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/dashboard/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0D,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,OAAO,eAAe;IAClB,MAAM,CAAS;IACf,WAAW,CAAuB;IAClC,IAAI,CAAS;IACb,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,IAAI,GAAG,IAAI;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,WAAW,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAEO,aAAa,CAAC,GAAoB,EAAE,GAAmB;QAC7D,2CAA2C;QAC3C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;YACpD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;YACrD,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;gBACjC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBACrB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;gBACrB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,MAAM;QACJ,OAAO,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,SAAS,CAAC,KAAmB;QAC3B,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/dashboard/socket.d.ts

@@ -0,0 +1,8 @@
+import type { Server } from "node:http";
+import type { HarnessEvent } from "../core/types.js";
+export declare class WebSocketBroadcaster {
+    private wss;
+    constructor(server: Server);
+    broadcast(event: HarnessEvent): void;
+    close(): void;
+}

package/dist/dashboard/socket.js

@@ -0,0 +1,22 @@
+import { WebSocketServer, WebSocket } from "ws";
+export class WebSocketBroadcaster {
+    wss;
+    constructor(server) {
+        this.wss = new WebSocketServer({ server });
+    }
+    broadcast(event) {
+        const data = JSON.stringify(event);
+        for (const client of this.wss.clients) {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(data);
+            }
+        }
+    }
+    close() {
+        for (const client of this.wss.clients) {
+            client.close();
+        }
+        this.wss.close();
+    }
+}
+//# sourceMappingURL=socket.js.map

package/dist/dashboard/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../src/dashboard/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAIhD,MAAM,OAAO,oBAAoB;IACvB,GAAG,CAAkB;IAE7B,YAAY,MAAc;QACxB,IAAI,CAAC,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,CAAC,KAAmB;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK;QACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/defaults/criteria.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_CRITERIA = "## Default Evaluation Criteria\n\n### Correctness\n- All features specified in the contract are implemented and functional\n- No placeholder, stubbed, or mocked implementations in production code\n- Code runs without runtime errors\n\n### Testing\n- New features have corresponding tests\n- All tests pass when the test suite is run\n- Tests cover the primary success path and key edge cases\n\n### Code Quality\n- Code follows project conventions (from CLAUDE.md if present)\n- No leftover TODO or FIXME comments\n- No debug logging or commented-out code left in place\n- Imports are clean \u2014 no unused imports\n\n### Integration\n- New code integrates with existing codebase without breaking existing functionality\n- Existing tests still pass after changes\n";

package/dist/defaults/criteria.js

@@ -0,0 +1,23 @@
+export const DEFAULT_CRITERIA = `## Default Evaluation Criteria
+
+### Correctness
+- All features specified in the contract are implemented and functional
+- No placeholder, stubbed, or mocked implementations in production code
+- Code runs without runtime errors
+
+### Testing
+- New features have corresponding tests
+- All tests pass when the test suite is run
+- Tests cover the primary success path and key edge cases
+
+### Code Quality
+- Code follows project conventions (from CLAUDE.md if present)
+- No leftover TODO or FIXME comments
+- No debug logging or commented-out code left in place
+- Imports are clean — no unused imports
+
+### Integration
+- New code integrates with existing codebase without breaking existing functionality
+- Existing tests still pass after changes
+`;
+//# sourceMappingURL=criteria.js.map

package/dist/defaults/criteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria.js","sourceRoot":"","sources":["../../src/defaults/criteria.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqB/B,CAAC"}

package/dist/defaults/prompts.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectContext, AgentRole } from "../core/types.js";
+/**
+ * Format a ProjectContext into a readable text block for inclusion in system prompts.
+ */
+export declare function formatProjectContext(ctx: ProjectContext): string;
+/**
+ * Build a full system prompt for an agent role.
+ *
+ * Assembles:
+ * 1. Base prompt for the role
+ * 2. PROJECT CONTEXT section (formatted project context)
+ * 3. EVALUATION CRITERIA section (evaluator only — default + custom criteria)
+ * 4. ADDITIONAL INSTRUCTIONS section (appendPrompt if provided)
+ */
+export declare function buildSystemPrompt(role: AgentRole, ctx: ProjectContext, appendPrompt?: string): string;