@alevental/cccp 0.1.0

package/dist/mcp/mcp-server.js

@@ -0,0 +1,262 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { readFile, readdir } from "node:fs/promises";
+import { resolve } from "node:path";
+import { openDatabase } from "../db.js";
+import { GateNotifier } from "./gate-notifier.js";
+import { saveState, discoverRuns } from "../state.js";
+// ---------------------------------------------------------------------------
+// Run resolution
+// ---------------------------------------------------------------------------
+async function resolveRun(runIdPrefix) {
+    const projectDir = process.cwd();
+    // Reload DB from disk — the runner (separate process) may have written new state.
+    const db = await openDatabase(projectDir);
+    db.reload();
+    const runs = await discoverRuns(projectDir);
+    if (runs.length === 0) {
+        return { error: "No pipeline runs found. Start one with `cccp run`." };
+    }
+    if (!runIdPrefix) {
+        if (runs.length === 1) {
+            return { run: runs[0] };
+        }
+        const listing = formatRunList(runs);
+        return {
+            error: `${runs.length} runs found. Specify run_id to select one.\n\n${listing}`,
+        };
+    }
+    const matches = runs.filter((r) => r.state.runId.startsWith(runIdPrefix));
+    if (matches.length === 0) {
+        return { error: `No run matching "${runIdPrefix}".` };
+    }
+    if (matches.length > 1) {
+        return {
+            error: `Ambiguous run_id "${runIdPrefix}" matches ${matches.length} runs. Use more characters.`,
+        };
+    }
+    return { run: matches[0] };
+}
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+function formatRunList(runs) {
+    const lines = ["Runs:"];
+    for (const { state } of runs) {
+        const short = state.runId.slice(0, 8);
+        const gate = state.gate?.status === "pending"
+            ? ` | GATE: ${state.gate.stageName}`
+            : "";
+        lines.push(`  ${short}  ${state.pipeline} (${state.project})  ${state.status}${gate}  ${state.startedAt}`);
+    }
+    return lines.join("\n");
+}
+function formatStatus(state) {
+    const short = state.runId.slice(0, 8);
+    const lines = [
+        `Pipeline: ${state.pipeline} (run ${short})`,
+        `Project: ${state.project}`,
+        `Status: ${state.status}`,
+        `Started: ${state.startedAt}`,
+    ];
+    if (state.completedAt) {
+        lines.push(`Completed: ${state.completedAt}`);
+    }
+    lines.push("", "Stages:");
+    for (const name of state.stageOrder) {
+        const s = state.stages[name];
+        const icon = s.status === "passed"
+            ? "✓"
+            : s.status === "failed" || s.status === "error"
+                ? "✗"
+                : s.status === "in_progress"
+                    ? "⚙"
+                    : s.status === "skipped"
+                        ? "⏭"
+                        : "○";
+        const iterInfo = s.type === "pge" && s.iteration
+            ? ` (iter ${s.iteration})`
+            : "";
+        const duration = s.durationMs != null
+            ? ` ${(s.durationMs / 1000).toFixed(1)}s`
+            : "";
+        const artifacts = s.artifacts
+            ? ` [${Object.keys(s.artifacts).join(", ")}]`
+            : "";
+        lines.push(`  ${icon} ${name}: ${s.status}${iterInfo}${duration}${artifacts}`);
+    }
+    if (state.gate) {
+        lines.push("");
+        lines.push(`Gate: ${state.gate.stageName} — ${state.gate.status}`);
+        if (state.gate.prompt) {
+            lines.push(`  Prompt: ${state.gate.prompt}`);
+        }
+        if (state.gate.feedback) {
+            lines.push(`  Feedback: ${state.gate.feedback}`);
+        }
+    }
+    return lines.join("\n");
+}
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+// ---------------------------------------------------------------------------
+// MCP server
+// ---------------------------------------------------------------------------
+export async function startMcpServer() {
+    const server = new McpServer({
+        name: "cccp",
+        version: "0.1.0",
+    });
+    // --- cccp_runs ---
+    server.tool("cccp_runs", "List all pipeline runs (active and completed). Shows run ID, pipeline name, project, status, and any pending gates.", {}, async () => {
+        const runs = await discoverRuns(process.cwd());
+        if (runs.length === 0) {
+            return textResult("No pipeline runs found.");
+        }
+        return textResult(formatRunList(runs));
+    });
+    // --- cccp_status ---
+    server.tool("cccp_status", "Get detailed status for a pipeline run — stages, iterations, artifacts, and pending gates. If only one run exists, it is selected automatically.", {
+        run_id: z
+            .string()
+            .optional()
+            .describe("Run ID prefix (8+ chars). Omit if only one run exists."),
+    }, async ({ run_id }) => {
+        const result = await resolveRun(run_id);
+        if ("error" in result)
+            return textResult(result.error);
+        return textResult(formatStatus(result.run.state));
+    });
+    // --- cccp_gate_respond ---
+    server.tool("cccp_gate_respond", "Approve or reject a pending human gate. Use cccp_runs or cccp_status first to see pending gates.", {
+        run_id: z
+            .string()
+            .optional()
+            .describe("Run ID prefix (8+ chars). Omit if only one run exists."),
+        approved: z
+            .boolean()
+            .describe("Whether to approve (true) or reject (false) the gate."),
+        feedback: z
+            .string()
+            .optional()
+            .describe("Optional feedback. On rejection, passed to the generator for retry."),
+    }, async ({ run_id, approved, feedback }) => {
+        const result = await resolveRun(run_id);
+        if ("error" in result)
+            return textResult(result.error);
+        const { artifactDir, state } = result.run;
+        if (!state.gate || state.gate.status !== "pending") {
+            return textResult("No pending gate on this run.");
+        }
+        state.gate.status = approved ? "approved" : "rejected";
+        state.gate.feedback = feedback;
+        state.gate.respondedAt = new Date().toISOString();
+        await saveState(state);
+        const action = approved ? "approved" : "rejected";
+        return textResult(`Gate "${state.gate.stageName}" ${action}.${feedback ? ` Feedback: ${feedback}` : ""}`);
+    });
+    // --- cccp_logs ---
+    server.tool("cccp_logs", "View recent agent activity logs for a pipeline run.", {
+        run_id: z
+            .string()
+            .optional()
+            .describe("Run ID prefix (8+ chars). Omit if only one run exists."),
+        lines: z
+            .number()
+            .optional()
+            .default(50)
+            .describe("Number of recent log lines (default 50)."),
+    }, async ({ run_id, lines }) => {
+        const result = await resolveRun(run_id);
+        if ("error" in result)
+            return textResult(result.error);
+        const cccpDir = resolve(result.run.artifactDir, ".cccp");
+        let logContent = "No agent logs found.";
+        try {
+            const files = await readdir(cccpDir);
+            const logFiles = files
+                .filter((f) => f.endsWith(".stream.jsonl"))
+                .sort()
+                .reverse();
+            if (logFiles.length > 0) {
+                const latestLog = resolve(cccpDir, logFiles[0]);
+                const raw = await readFile(latestLog, "utf-8");
+                const allLines = raw.trim().split("\n");
+                const recent = allLines.slice(-lines);
+                logContent = `Log: ${logFiles[0]} (${allLines.length} total lines)\n\n${recent.join("\n")}`;
+            }
+        }
+        catch (err) {
+            logContent = `Could not read log files: ${err instanceof Error ? err.message : String(err)}`;
+        }
+        return textResult(logContent);
+    });
+    // --- cccp_artifacts ---
+    server.tool("cccp_artifacts", "List or read artifacts produced by a pipeline run.", {
+        run_id: z
+            .string()
+            .optional()
+            .describe("Run ID prefix (8+ chars). Omit if only one run exists."),
+        read: z
+            .string()
+            .optional()
+            .describe("Artifact key or file path to read. Omit to list all artifacts."),
+    }, async ({ run_id, read }) => {
+        const result = await resolveRun(run_id);
+        if ("error" in result)
+            return textResult(result.error);
+        const { state, artifactDir } = result.run;
+        // Collect all artifacts across stages.
+        const allArtifacts = [];
+        for (const name of state.stageOrder) {
+            const stage = state.stages[name];
+            if (stage.artifacts) {
+                for (const [key, path] of Object.entries(stage.artifacts)) {
+                    allArtifacts.push({ stage: name, key, path });
+                }
+            }
+        }
+        if (!read) {
+            // List mode.
+            if (allArtifacts.length === 0) {
+                return textResult("No artifacts recorded for this run.");
+            }
+            const lines = [`Artifacts for run ${state.runId.slice(0, 8)}:`, ""];
+            for (const a of allArtifacts) {
+                lines.push(`  [${a.stage}] ${a.key}: ${a.path}`);
+            }
+            return textResult(lines.join("\n"));
+        }
+        // Read mode — find by key or path.
+        const match = allArtifacts.find((a) => a.key === read || a.path === read || a.path.endsWith(read));
+        if (!match) {
+            // Try reading as a direct path relative to artifact dir.
+            try {
+                const content = await readFile(resolve(artifactDir, read), "utf-8");
+                return textResult(content);
+            }
+            catch (err) {
+                return textResult(`Artifact "${read}" not found: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        try {
+            const content = await readFile(match.path, "utf-8");
+            return textResult(`${match.key} (${match.stage}):\n\n${content}`);
+        }
+        catch (err) {
+            return textResult(`Could not read artifact at ${match.path}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+    // --- Start server ---
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // --- Start gate notifier ---
+    const notifier = new GateNotifier({
+        server,
+        projectDir: process.cwd(),
+    });
+    notifier.start();
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp/mcp-server.js.map

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

package/dist/pge.d.ts

@@ -0,0 +1,12 @@
+import type { PgeStage, PgeResult, RunContext, PipelineState } from "./types.js";
+/**
+ * Execute a full Plan-Generate-Evaluate cycle for a PGE stage.
+ *
+ * 0. Dispatch planner agent → task-plan.md
+ * 1. Dispatch evaluator agent (contract mode) → contract.md
+ * 2. Dispatch generator agent → deliverable
+ * 3. Dispatch evaluator agent (evaluation mode) → evaluation-N.md
+ * 4. Parse evaluation (regex on ### Overall: PASS/FAIL)
+ * 5. Route: PASS → done, FAIL + iters left → retry, FAIL + max → escalate
+ */
+export declare function runPgeCycle(stage: PgeStage, ctx: RunContext, state: PipelineState, onProgress?: (eventType?: string, eventData?: Record<string, unknown>) => Promise<void>): Promise<PgeResult>;

package/dist/pge.js

@@ -0,0 +1,361 @@
+import { resolve } from "node:path";
+import { mkdir, readFile } from "node:fs/promises";
+import { activityBus } from "./activity-bus.js";
+import { DefaultAgentDispatcher } from "./dispatcher.js";
+import { parseEvaluation } from "./evaluator.js";
+import { AgentCrashError, MissingOutputError } from "./errors.js";
+import { ConsoleLogger } from "./logger.js";
+import { interpolate, resolveTaskBody, buildTaskContext, writeSystemPromptFile, } from "./prompt.js";
+import { mergeInputs, resolveAndLoad } from "./stage-helpers.js";
+import { updatePgeProgress, setStageArtifact } from "./state.js";
+function getLogger(ctx) {
+    return ctx.logger ?? new ConsoleLogger();
+}
+function getDispatcher(ctx) {
+    return ctx.dispatcher ?? new DefaultAgentDispatcher();
+}
+// ---------------------------------------------------------------------------
+// PGE cycle
+// ---------------------------------------------------------------------------
+/**
+ * Execute a full Plan-Generate-Evaluate cycle for a PGE stage.
+ *
+ * 0. Dispatch planner agent → task-plan.md
+ * 1. Dispatch evaluator agent (contract mode) → contract.md
+ * 2. Dispatch generator agent → deliverable
+ * 3. Dispatch evaluator agent (evaluation mode) → evaluation-N.md
+ * 4. Parse evaluation (regex on ### Overall: PASS/FAIL)
+ * 5. Route: PASS → done, FAIL + iters left → retry, FAIL + max → escalate
+ */
+export async function runPgeCycle(stage, ctx, state, onProgress) {
+    const start = Date.now();
+    const vars = { ...ctx.variables, ...(stage.variables ?? {}) };
+    const maxIter = stage.contract.max_iterations;
+    // Resolve paths for contract, deliverable, task plan, and evaluations
+    const deliverable = interpolate(stage.contract.deliverable, vars);
+    const deliverablePath = resolve(ctx.projectDir, deliverable);
+    const stageDir = resolve(ctx.artifactDir, stage.name);
+    const contractPath = resolve(stageDir, "contract.md");
+    const taskPlanPath = resolve(stageDir, "task-plan.md");
+    await mkdir(stageDir, { recursive: true });
+    // --- Dry-run: show what would happen ---
+    if (ctx.dryRun) {
+        const logger = getLogger(ctx);
+        logger.log("\n[dry-run] PGE Stage:", stage.name);
+        logger.log("  task plan:   ", taskPlanPath);
+        logger.log("  contract:    ", contractPath);
+        logger.log("  deliverable: ", deliverablePath);
+        logger.log("  planner:     ", stage.planner.agent);
+        if (stage.planner.operation) {
+            logger.log("  plan operation:", stage.planner.operation);
+        }
+        if (stage.plan) {
+            logger.log("  plan file:   ", interpolate(stage.plan, vars));
+        }
+        logger.log("  generator:   ", stage.generator.agent);
+        if (stage.generator.operation) {
+            logger.log("  gen operation:", stage.generator.operation);
+        }
+        logger.log("  evaluator:   ", stage.evaluator.agent);
+        if (stage.evaluator.operation) {
+            logger.log("  eval operation:", stage.evaluator.operation);
+        }
+        logger.log("  max iters:   ", maxIter);
+        logger.log("  on_fail:     ", stage.on_fail ?? "stop");
+        if (stage.contract.guidance) {
+            logger.log("  guidance:     (present)");
+        }
+        if (stage.contract.template) {
+            logger.log("  template:    ", stage.contract.template);
+        }
+        return {
+            outcome: "pass",
+            iterations: 0,
+            maxIterations: maxIter,
+            contractPath,
+            taskPlanPath,
+            durationMs: 0,
+        };
+    }
+    // --- Resolve task body (file or inline) ---
+    const taskBody = await resolveTaskBody(stage, vars, `Generate deliverable for: ${stage.name}`);
+    // --- Resolve all agents via search paths ---
+    const plannerAgent = await resolveAndLoad(stage.planner, ctx, stage.mcp_profile);
+    const genAgent = await resolveAndLoad(stage.generator, ctx, stage.mcp_profile);
+    const evalAgent = await resolveAndLoad(stage.evaluator, ctx, stage.mcp_profile);
+    // --- Step 0: Dispatch planner ---
+    getLogger(ctx).log(`    dispatching planner: ${stage.planner.agent}`);
+    await onProgress?.("pge_planner_start", {
+        agent: stage.planner.agent,
+    });
+    const plannerInputs = mergeInputs(stage.inputs, stage.planner.inputs, vars);
+    const planFile = stage.plan ? interpolate(stage.plan, vars) : undefined;
+    const plannerPrompt = buildTaskContext({
+        task: taskBody,
+        planFile,
+        inputs: plannerInputs.length > 0 ? plannerInputs : undefined,
+        output: taskPlanPath,
+        guidance: stage.contract.guidance,
+    });
+    const plannerSystemFile = await writeSystemPromptFile(plannerAgent.markdown, ctx.tempTracker);
+    const plannerResult = await getDispatcher(ctx).dispatch({
+        userPrompt: plannerPrompt,
+        systemPromptFile: plannerSystemFile,
+        mcpConfigFile: plannerAgent.mcpFile,
+        expectedOutput: taskPlanPath,
+        cwd: ctx.projectDir,
+        allowedTools: stage.planner.allowed_tools,
+        claudeConfigDir: ctx.projectConfig?.claude_config_dir,
+        permissionMode: ctx.projectConfig?.permission_mode,
+        agentName: `${stage.name}-planner`,
+        streamLogDir: resolve(ctx.artifactDir, ".cccp"),
+        onActivity: (activity) => activityBus.emit("activity", activity),
+        quiet: ctx.quiet,
+    });
+    if (plannerResult.exitCode !== 0) {
+        throw new AgentCrashError(stage.planner.agent, plannerResult.exitCode);
+    }
+    if (!plannerResult.outputExists) {
+        throw new MissingOutputError(stage.planner.agent, taskPlanPath);
+    }
+    setStageArtifact(state, stage.name, "task-plan", taskPlanPath);
+    updatePgeProgress(state, stage.name, 0, "planner_dispatched");
+    getLogger(ctx).log(`    task plan written: ${taskPlanPath}`);
+    await onProgress?.("pge_planner_done", {
+        agent: stage.planner.agent, taskPlanPath,
+    });
+    // --- Step 1: Dispatch evaluator for contract writing ---
+    getLogger(ctx).log(`    dispatching contract writer: ${stage.evaluator.agent}`);
+    await onProgress?.("pge_contract_start", {
+        agent: stage.evaluator.agent,
+    });
+    const contractInputs = mergeInputs(stage.inputs, stage.evaluator.inputs, vars, [taskPlanPath]);
+    const templatePath = stage.contract.template
+        ? resolve(ctx.projectDir, interpolate(stage.contract.template, vars))
+        : undefined;
+    const contractPrompt = buildTaskContext({
+        task: `Write the acceptance criteria contract for: ${stage.name}`,
+        inputs: contractInputs.length > 0 ? contractInputs : undefined,
+        output: contractPath,
+        contractTemplate: templatePath,
+        guidance: stage.contract.guidance,
+        deliverableInfo: `The generator will produce: ${deliverable}\nWrite your contract criteria to verify this deliverable.\nMax iterations: ${maxIter}`,
+    });
+    const contractSystemFile = await writeSystemPromptFile(evalAgent.markdown, ctx.tempTracker);
+    const contractResult = await getDispatcher(ctx).dispatch({
+        userPrompt: contractPrompt,
+        systemPromptFile: contractSystemFile,
+        mcpConfigFile: evalAgent.mcpFile,
+        expectedOutput: contractPath,
+        cwd: ctx.projectDir,
+        allowedTools: stage.evaluator.allowed_tools,
+        claudeConfigDir: ctx.projectConfig?.claude_config_dir,
+        permissionMode: ctx.projectConfig?.permission_mode,
+        agentName: `${stage.name}-contract`,
+        streamLogDir: resolve(ctx.artifactDir, ".cccp"),
+        onActivity: (activity) => activityBus.emit("activity", activity),
+        quiet: ctx.quiet,
+    });
+    if (contractResult.exitCode !== 0) {
+        throw new AgentCrashError(stage.evaluator.agent, contractResult.exitCode);
+    }
+    if (!contractResult.outputExists) {
+        throw new MissingOutputError(stage.evaluator.agent, contractPath);
+    }
+    setStageArtifact(state, stage.name, "contract", contractPath);
+    updatePgeProgress(state, stage.name, 0, "contract_dispatched");
+    getLogger(ctx).log(`    contract written: ${contractPath}`);
+    let contractContent = "";
+    try {
+        contractContent = await readFile(contractPath, "utf-8");
+    }
+    catch { /* ignore */ }
+    await onProgress?.("pge_contract_done", {
+        agent: stage.evaluator.agent, contractPath, contractContent,
+    });
+    // Emit pge_start to signal the GE loop is beginning.
+    await onProgress?.("pge_start", {
+        planner: stage.planner.agent,
+        generator: stage.generator.agent,
+        evaluator: stage.evaluator.agent,
+        deliverable,
+        maxIterations: maxIter,
+        contractPath,
+        taskPlanPath,
+        contractContent,
+    });
+    // --- GE Iteration loop ---
+    let lastEvalPath;
+    for (let iter = 1; iter <= maxIter; iter++) {
+        getLogger(ctx).log(`    iteration ${iter}/${maxIter}`);
+        const evalPath = resolve(stageDir, `evaluation-${iter}.md`);
+        // --- Step 2: Dispatch generator ---
+        const genSystemFile = await writeSystemPromptFile(genAgent.markdown, ctx.tempTracker);
+        const genInputs = mergeInputs(stage.inputs, stage.generator.inputs, vars, [taskPlanPath]);
+        const genPrompt = buildTaskContext({
+            task: taskBody,
+            contractPath,
+            inputs: genInputs.length > 0 ? genInputs : undefined,
+            output: deliverable,
+            previousEvaluation: lastEvalPath,
+            iteration: iter,
+            maxIterations: maxIter,
+        });
+        getLogger(ctx).log(`    dispatching generator: ${stage.generator.agent}`);
+        await onProgress?.("pge_generator_start", {
+            iteration: iter, maxIterations: maxIter, agent: stage.generator.agent,
+        });
+        const genResult = await getDispatcher(ctx).dispatch({
+            userPrompt: genPrompt,
+            systemPromptFile: genSystemFile,
+            mcpConfigFile: genAgent.mcpFile,
+            expectedOutput: deliverablePath,
+            cwd: ctx.projectDir,
+            allowedTools: stage.generator.allowed_tools,
+            claudeConfigDir: ctx.projectConfig?.claude_config_dir,
+            permissionMode: ctx.projectConfig?.permission_mode,
+            agentName: `${stage.name}-generator`,
+            streamLogDir: resolve(ctx.artifactDir, ".cccp"),
+            onActivity: (activity) => activityBus.emit("activity", activity),
+            quiet: ctx.quiet,
+        });
+        if (genResult.exitCode !== 0) {
+            throw new AgentCrashError(stage.generator.agent, genResult.exitCode);
+        }
+        if (!genResult.outputExists) {
+            throw new MissingOutputError(stage.generator.agent, deliverable);
+        }
+        // Persist generator completion.
+        updatePgeProgress(state, stage.name, iter, "generator_dispatched");
+        setStageArtifact(state, stage.name, "deliverable", deliverablePath);
+        await onProgress?.("pge_generator_done", {
+            iteration: iter, maxIterations: maxIter,
+            agent: stage.generator.agent, deliverablePath,
+        });
+        // --- Step 3: Dispatch evaluator ---
+        const evalSystemFile = await writeSystemPromptFile(evalAgent.markdown, ctx.tempTracker);
+        const evalInputs = mergeInputs(stage.inputs, stage.evaluator.inputs, vars, [deliverable]);
+        const evalPrompt = buildTaskContext({
+            task: `Evaluate the deliverable against the contract for: ${stage.name}`,
+            contractPath,
+            inputs: evalInputs.length > 0 ? evalInputs : undefined,
+            output: evalPath,
+            iteration: iter,
+            maxIterations: maxIter,
+            evaluatorFormat: true,
+        });
+        getLogger(ctx).log(`    dispatching evaluator: ${stage.evaluator.agent}`);
+        await onProgress?.("pge_evaluator_start", {
+            iteration: iter, maxIterations: maxIter, agent: stage.evaluator.agent,
+        });
+        const evalResult = await getDispatcher(ctx).dispatch({
+            userPrompt: evalPrompt,
+            systemPromptFile: evalSystemFile,
+            mcpConfigFile: evalAgent.mcpFile,
+            expectedOutput: evalPath,
+            cwd: ctx.projectDir,
+            allowedTools: stage.evaluator.allowed_tools,
+            claudeConfigDir: ctx.projectConfig?.claude_config_dir,
+            permissionMode: ctx.projectConfig?.permission_mode,
+            agentName: `${stage.name}-evaluator`,
+            streamLogDir: resolve(ctx.artifactDir, ".cccp"),
+            onActivity: (activity) => activityBus.emit("activity", activity),
+            quiet: ctx.quiet,
+        });
+        if (evalResult.exitCode !== 0) {
+            throw new AgentCrashError(stage.evaluator.agent, evalResult.exitCode);
+        }
+        if (!evalResult.outputExists) {
+            throw new MissingOutputError(stage.evaluator.agent, evalPath);
+        }
+        // Persist evaluator completion.
+        updatePgeProgress(state, stage.name, iter, "evaluator_dispatched");
+        setStageArtifact(state, stage.name, `evaluation-${iter}`, evalPath);
+        await onProgress?.("pge_evaluator_done", {
+            iteration: iter, maxIterations: maxIter,
+            agent: stage.evaluator.agent, evaluationPath: evalPath,
+        });
+        // --- Step 4: Parse evaluation ---
+        const evaluation = await parseEvaluation(evalPath);
+        if (evaluation.outcome === "parse_error") {
+            getLogger(ctx).error(`    evaluation parse error: ${evaluation.error}`);
+            await onProgress?.("pge_evaluation", {
+                iteration: iter, maxIterations: maxIter,
+                outcome: "parse_error", error: evaluation.error,
+            });
+            return {
+                outcome: "error",
+                iterations: iter,
+                maxIterations: maxIter,
+                evaluationPath: evalPath,
+                contractPath,
+                taskPlanPath,
+                durationMs: Date.now() - start,
+            };
+        }
+        // --- Step 5: Route ---
+        updatePgeProgress(state, stage.name, iter, "routed");
+        if (evaluation.outcome === "pass") {
+            getLogger(ctx).log(`    evaluation: PASS`);
+            await onProgress?.("pge_evaluation", {
+                iteration: iter, maxIterations: maxIter,
+                outcome: "pass",
+                evaluationContent: evaluation.content ?? "",
+                evaluationPath: evalPath,
+                rawLine: evaluation.rawLine,
+            });
+            return {
+                outcome: "pass",
+                iterations: iter,
+                maxIterations: maxIter,
+                evaluationPath: evalPath,
+                contractPath,
+                taskPlanPath,
+                durationMs: Date.now() - start,
+            };
+        }
+        // FAIL — check if retries remain
+        getLogger(ctx).log(`    evaluation: FAIL`);
+        lastEvalPath = evalPath;
+        if (iter === maxIter) {
+            getLogger(ctx).log(`    max iterations reached — escalating (${stage.on_fail ?? "stop"})`);
+            await onProgress?.("pge_evaluation", {
+                iteration: iter, maxIterations: maxIter,
+                outcome: "fail",
+                evaluationContent: evaluation.content ?? "",
+                evaluationPath: evalPath,
+                rawLine: evaluation.rawLine,
+                willRetry: false,
+                escalation: stage.on_fail ?? "stop",
+            });
+            return {
+                outcome: "fail",
+                iterations: iter,
+                maxIterations: maxIter,
+                evaluationPath: evalPath,
+                contractPath,
+                taskPlanPath,
+                durationMs: Date.now() - start,
+            };
+        }
+        getLogger(ctx).log(`    retrying...`);
+        await onProgress?.("pge_evaluation", {
+            iteration: iter, maxIterations: maxIter,
+            outcome: "fail",
+            evaluationContent: evaluation.content ?? "",
+            evaluationPath: evalPath,
+            rawLine: evaluation.rawLine,
+            willRetry: true,
+        });
+    }
+    // Should never reach here, but TypeScript needs it
+    return {
+        outcome: "error",
+        iterations: maxIter,
+        maxIterations: maxIter,
+        contractPath,
+        taskPlanPath,
+        durationMs: Date.now() - start,
+    };
+}
+//# sourceMappingURL=pge.js.map