agent-bober 0.1.0

package/dist/orchestrator/pipeline.js

@@ -0,0 +1,290 @@
+import { createContract, updateContractStatus, } from "../contracts/sprint-contract.js";
+import { createHandoff, summarizeOlderSprints, } from "./context-handoff.js";
+import { runPlanner } from "./planner-agent.js";
+import { runGenerator } from "./generator-agent.js";
+import { runEvaluatorAgent } from "./evaluator-agent.js";
+import { ensureBoberDir, saveContract, updateContract, appendHistory, } from "../state/index.js";
+import { commitAll, getCurrentBranch, getChangedFiles } from "../utils/git.js";
+import { logger } from "../utils/logger.js";
+// ── Interrupt handling ─────────────────────────────────────────────
+let interrupted = false;
+function setupInterruptHandler() {
+    interrupted = false;
+    const handler = () => {
+        if (interrupted) {
+            // Second SIGINT — force exit
+            logger.error("Force interrupted. Exiting immediately.");
+            process.exit(1);
+        }
+        interrupted = true;
+        logger.warn("Interrupt received. Finishing current sprint, then stopping...");
+    };
+    process.on("SIGINT", handler);
+    return () => {
+        process.removeListener("SIGINT", handler);
+    };
+}
+// ── Project context helper ─────────────────────────────────────────
+async function buildProjectContext(projectRoot, config) {
+    let currentBranch;
+    try {
+        currentBranch = await getCurrentBranch(projectRoot);
+    }
+    catch {
+        currentBranch = "unknown";
+    }
+    return {
+        name: config.project.name,
+        type: config.project.mode,
+        techStack: [],
+        entryPoints: [],
+        currentBranch,
+    };
+}
+// ── Sprint cycle ───────────────────────────────────────────────────
+async function runSprintCycle(contract, spec, completedContracts, projectRoot, config, projectContext) {
+    const maxIterations = config.evaluator.maxIterations;
+    let currentContract = updateContractStatus(contract, "in-progress");
+    await updateContract(projectRoot, currentContract);
+    let lastEvaluation;
+    let lastGeneratorResult;
+    for (let iteration = 1; iteration <= maxIterations; iteration++) {
+        if (interrupted) {
+            logger.warn(`Sprint ${currentContract.id} interrupted at iteration ${iteration}.`);
+            break;
+        }
+        logger.progress(iteration, maxIterations, `Sprint ${currentContract.id} iteration`);
+        // Build evaluation feedback from prior round
+        const evalFeedback = lastEvaluation
+            ? lastEvaluation.summary
+            : "";
+        // Summarize older sprints to save context
+        const completedSummaryHandoff = createHandoff({
+            from: iteration === 1 ? "planner" : "evaluator",
+            to: "generator",
+            projectContext,
+            spec,
+            currentContract,
+            sprintHistory: completedContracts,
+            instructions: `Implement sprint: ${currentContract.feature}\n\n${currentContract.description}`,
+            changedFiles: lastGeneratorResult?.filesChanged ?? [],
+            issues: evalFeedback ? [evalFeedback] : [],
+        });
+        // Compact older sprint history if needed
+        const compactedHandoff = summarizeOlderSprints(completedSummaryHandoff, 3);
+        // ── Generate ───────────────────────────────────────────────
+        logger.phase(`Sprint ${currentContract.id} - Generate (Round ${iteration})`);
+        await appendHistory(projectRoot, {
+            timestamp: new Date().toISOString(),
+            event: "generator-start",
+            phase: "generating",
+            sprintId: currentContract.id,
+            details: { iteration },
+        });
+        const generatorResult = await runGenerator(compactedHandoff, projectRoot, config);
+        lastGeneratorResult = generatorResult;
+        if (!generatorResult.success) {
+            logger.warn(`Generator reported failure: ${generatorResult.notes}`);
+            currentContract = {
+                ...currentContract,
+                generatorNotes: generatorResult.notes,
+            };
+            await updateContract(projectRoot, currentContract);
+            if (iteration < maxIterations) {
+                logger.info("Retrying generation...");
+                continue;
+            }
+            // Max iterations reached, mark as needs-rework
+            currentContract = updateContractStatus(currentContract, "needs-rework");
+            currentContract = {
+                ...currentContract,
+                evaluatorFeedback: "Generator failed to complete the implementation.",
+            };
+            await updateContract(projectRoot, currentContract);
+            return { contract: currentContract, generatorResult };
+        }
+        currentContract = {
+            ...currentContract,
+            generatorNotes: generatorResult.notes,
+        };
+        // Auto-commit if enabled
+        if (config.generator.autoCommit) {
+            try {
+                const commitHash = await commitAll(projectRoot, `bober: ${currentContract.feature} (sprint ${currentContract.id}, round ${iteration})`);
+                logger.success(`Committed: ${commitHash}`);
+                lastGeneratorResult = { ...generatorResult, commitHash };
+            }
+            catch (err) {
+                logger.debug(`Auto-commit skipped: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // ── Evaluate ──────────────────────────────────────────────
+        logger.phase(`Sprint ${currentContract.id} - Evaluate (Round ${iteration})`);
+        currentContract = updateContractStatus(currentContract, "evaluating");
+        await updateContract(projectRoot, currentContract);
+        await appendHistory(projectRoot, {
+            timestamp: new Date().toISOString(),
+            event: "evaluator-start",
+            phase: "evaluating",
+            sprintId: currentContract.id,
+            details: { iteration },
+        });
+        // Build handoff for evaluator
+        let changedFiles;
+        try {
+            changedFiles = await getChangedFiles(projectRoot);
+        }
+        catch {
+            changedFiles = generatorResult.filesChanged;
+        }
+        const evalHandoff = {
+            ...compactedHandoff,
+            from: "generator",
+            to: "evaluator",
+            changedFiles,
+        };
+        const evaluation = await runEvaluatorAgent(evalHandoff, projectRoot, config);
+        lastEvaluation = evaluation;
+        if (evaluation.passed) {
+            logger.success(`Sprint ${currentContract.id} passed all evaluations!`);
+            currentContract = updateContractStatus(currentContract, "passed");
+            currentContract = {
+                ...currentContract,
+                evaluatorFeedback: evaluation.summary,
+            };
+            await updateContract(projectRoot, currentContract);
+            await appendHistory(projectRoot, {
+                timestamp: new Date().toISOString(),
+                event: "sprint-passed",
+                phase: "complete",
+                sprintId: currentContract.id,
+                details: { iteration, feedback: evaluation.summary },
+            });
+            return { contract: currentContract, evaluation, generatorResult: lastGeneratorResult };
+        }
+        // Evaluation failed
+        logger.warn(`Evaluation failed (round ${iteration}/${maxIterations}): ${evaluation.summary.slice(0, 200)}`);
+        currentContract = {
+            ...currentContract,
+            evaluatorFeedback: evaluation.summary,
+        };
+        await updateContract(projectRoot, currentContract);
+        await appendHistory(projectRoot, {
+            timestamp: new Date().toISOString(),
+            event: "evaluation-failed",
+            phase: "rework",
+            sprintId: currentContract.id,
+            details: { iteration, feedback: evaluation.summary },
+        });
+        if (iteration >= maxIterations) {
+            logger.error(`Sprint ${currentContract.id} exceeded max iterations (${maxIterations}).`);
+            currentContract = updateContractStatus(currentContract, "needs-rework");
+            await updateContract(projectRoot, currentContract);
+            return { contract: currentContract, evaluation };
+        }
+        logger.info("Feeding evaluation feedback into next iteration...");
+    }
+    // Should not normally reach here
+    return { contract: currentContract, evaluation: lastEvaluation };
+}
+// ── Main pipeline ──────────────────────────────────────────────────
+/**
+ * Run the complete orchestration pipeline:
+ *
+ * 1. **Plan** — Call the planner agent to produce a PlanSpec
+ * 2. **Sprint loop** — For each feature, create sprint contracts and
+ *    run the generate-evaluate-iterate cycle
+ * 3. **Result** — Return aggregated results
+ *
+ * Each agent invocation is a FRESH call (new message thread). Context
+ * is carried via the ContextHandoff document.
+ */
+export async function runPipeline(userPrompt, projectRoot, config) {
+    const startTime = Date.now();
+    const cleanup = setupInterruptHandler();
+    try {
+        // Ensure .bober/ directory structure exists
+        await ensureBoberDir(projectRoot);
+        await appendHistory(projectRoot, {
+            timestamp: new Date().toISOString(),
+            event: "pipeline-start",
+            phase: "init",
+            details: { userPrompt: userPrompt.slice(0, 200) },
+        });
+        // ── Phase 1: Planning ────────────────────────────────────────
+        const spec = await runPlanner(userPrompt, projectRoot, config);
+        logger.info(`Plan: "${spec.title}" with ${spec.features.length} features`);
+        await appendHistory(projectRoot, {
+            timestamp: new Date().toISOString(),
+            event: "planning-complete",
+            phase: "planning",
+            details: {
+                specId: spec.id,
+                featureCount: spec.features.length,
+            },
+        });
+        // ── Phase 2: Sprint loop ─────────────────────────────────────
+        logger.phase("Sprint Execution");
+        // Create sprint contracts from features
+        const contracts = [];
+        for (const feature of spec.features) {
+            const contract = createContract(feature.title, feature.description, feature.acceptanceCriteria.map((ac, idx) => ({
+                id: `${feature.id}-criterion-${idx + 1}`,
+                description: ac,
+                verificationMethod: "agent-evaluation",
+            })));
+            contracts.push(contract);
+            await saveContract(projectRoot, contract);
+        }
+        const completedSprints = [];
+        const failedSprints = [];
+        const projectContext = await buildProjectContext(projectRoot, config);
+        const maxSprints = Math.min(contracts.length, config.sprint.maxSprints);
+        for (let i = 0; i < maxSprints; i++) {
+            if (interrupted) {
+                logger.warn("Pipeline interrupted by user.");
+                break;
+            }
+            const contract = contracts[i];
+            logger.progress(i + 1, maxSprints, contract.feature);
+            const result = await runSprintCycle(contract, spec, completedSprints, projectRoot, config, projectContext);
+            if (result.contract.status === "passed") {
+                completedSprints.push(result.contract);
+            }
+            else {
+                failedSprints.push(result.contract);
+                // Check if we should continue after failure
+                if (config.sprint.requireContracts &&
+                    result.contract.status !== "needs-rework") {
+                    logger.error(`Sprint ${result.contract.id} failed and contracts are required. Stopping pipeline.`);
+                    break;
+                }
+            }
+        }
+        // ── Phase 3: Results ─────────────────────────────────────────
+        logger.phase("Pipeline Complete");
+        const duration = Date.now() - startTime;
+        const success = failedSprints.length === 0 && completedSprints.length > 0;
+        await appendHistory(projectRoot, {
+            timestamp: new Date().toISOString(),
+            event: "pipeline-complete",
+            phase: success ? "complete" : "failed",
+            details: {
+                completed: completedSprints.length,
+                failed: failedSprints.length,
+                durationMs: duration,
+            },
+        });
+        return {
+            success,
+            spec,
+            completedSprints,
+            failedSprints,
+            duration,
+        };
+    }
+    finally {
+        cleanup();
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/orchestrator/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/orchestrator/pipeline.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,aAAa,EACb,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAmB5C,sEAAsE;AAEtE,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,SAAS,qBAAqB;IAC5B,WAAW,GAAG,KAAK,CAAC;IAEpB,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,WAAW,EAAE,CAAC;YAChB,6BAA6B;YAC7B,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAChF,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC;AAED,sEAAsE;AAEtE,KAAK,UAAU,mBAAmB,CAChC,WAAmB,EACnB,MAAmB;IAEnB,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;QACzB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;QACzB,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,EAAE;QACf,aAAa;KACd,CAAC;AACJ,CAAC;AAED,sEAAsE;AAEtE,KAAK,UAAU,cAAc,CAC3B,QAAwB,EACxB,IAAc,EACd,kBAAoC,EACpC,WAAmB,EACnB,MAAmB,EACnB,cAA8B;IAE9B,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC;IACrD,IAAI,eAAe,GAAG,oBAAoB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACpE,MAAM,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,cAA+C,CAAC;IACpD,IAAI,mBAAgD,CAAC;IAErD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;QAChE,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,UAAU,eAAe,CAAC,EAAE,6BAA6B,SAAS,GAAG,CAAC,CAAC;YACnF,MAAM;QACR,CAAC;QAED,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,UAAU,eAAe,CAAC,EAAE,YAAY,CAAC,CAAC;QAEpF,6CAA6C;QAC7C,MAAM,YAAY,GAAG,cAAc;YACjC,CAAC,CAAC,cAAc,CAAC,OAAO;YACxB,CAAC,CAAC,EAAE,CAAC;QAEP,0CAA0C;QAC1C,MAAM,uBAAuB,GAAG,aAAa,CAAC;YAC5C,IAAI,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YAC/C,EAAE,EAAE,WAAW;YACf,cAAc;YACd,IAAI;YACJ,eAAe;YACf,aAAa,EAAE,kBAAkB;YACjC,YAAY,EAAE,qBAAqB,eAAe,CAAC,OAAO,OAAO,eAAe,CAAC,WAAW,EAAE;YAC9F,YAAY,EAAE,mBAAmB,EAAE,YAAY,IAAI,EAAE;YACrD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE;SAC3C,CAAC,CAAC;QAEH,yCAAyC;QACzC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;QAE3E,8DAA8D;QAC9D,MAAM,CAAC,KAAK,CAAC,UAAU,eAAe,CAAC,EAAE,sBAAsB,SAAS,GAAG,CAAC,CAAC;QAE7E,MAAM,aAAa,CAAC,WAAW,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,eAAe,CAAC,EAAE;YAC5B,OAAO,EAAE,EAAE,SAAS,EAAE;SACvB,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,MAAM,YAAY,CACxC,gBAAgB,EAChB,WAAW,EACX,MAAM,CACP,CAAC;QACF,mBAAmB,GAAG,eAAe,CAAC;QAEtC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,+BAA+B,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC;YACpE,eAAe,GAAG;gBAChB,GAAG,eAAe;gBAClB,cAAc,EAAE,eAAe,CAAC,KAAK;aACtC,CAAC;YACF,MAAM,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAEnD,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;gBACtC,SAAS;YACX,CAAC;YAED,+CAA+C;YAC/C,eAAe,GAAG,oBAAoB,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;YACxE,eAAe,GAAG;gBAChB,GAAG,eAAe;gBAClB,iBAAiB,EAAE,kDAAkD;aACtE,CAAC;YACF,MAAM,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC;QACxD,CAAC;QAED,eAAe,GAAG;YAChB,GAAG,eAAe;YAClB,cAAc,EAAE,eAAe,CAAC,KAAK;SACtC,CAAC;QAEF,yBAAyB;QACzB,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,SAAS,CAChC,WAAW,EACX,UAAU,eAAe,CAAC,OAAO,YAAY,eAAe,CAAC,EAAE,WAAW,SAAS,GAAG,CACvF,CAAC;gBACF,MAAM,CAAC,OAAO,CAAC,cAAc,UAAU,EAAE,CAAC,CAAC;gBAC3C,mBAAmB,GAAG,EAAE,GAAG,eAAe,EAAE,UAAU,EAAE,CAAC;YAC3D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CACV,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,6DAA6D;QAC7D,MAAM,CAAC,KAAK,CAAC,UAAU,eAAe,CAAC,EAAE,sBAAsB,SAAS,GAAG,CAAC,CAAC;QAE7E,eAAe,GAAG,oBAAoB,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACtE,MAAM,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QAEnD,MAAM,aAAa,CAAC,WAAW,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,eAAe,CAAC,EAAE;YAC5B,OAAO,EAAE,EAAE,SAAS,EAAE;SACvB,CAAC,CAAC;QAEH,8BAA8B;QAC9B,IAAI,YAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,eAAe,CAAC,YAAY,CAAC;QAC9C,CAAC;QAED,MAAM,WAAW,GAAmB;YAClC,GAAG,gBAAgB;YACnB,IAAI,EAAE,WAAW;YACjB,EAAE,EAAE,WAAW;YACf,YAAY;SACb,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CACxC,WAAW,EACX,WAAW,EACX,MAAM,CACP,CAAC;QACF,cAAc,GAAG,UAAU,CAAC;QAE5B,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,OAAO,CAAC,UAAU,eAAe,CAAC,EAAE,0BAA0B,CAAC,CAAC;YAEvE,eAAe,GAAG,oBAAoB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;YAClE,eAAe,GAAG;gBAChB,GAAG,eAAe;gBAClB,iBAAiB,EAAE,UAAU,CAAC,OAAO;aACtC,CAAC;YACF,MAAM,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAEnD,MAAM,aAAa,CAAC,WAAW,EAAE;gBAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,eAAe;gBACtB,KAAK,EAAE,UAAU;gBACjB,QAAQ,EAAE,eAAe,CAAC,EAAE;gBAC5B,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,OAAO,EAAE;aACrD,CAAC,CAAC;YAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC;QACzF,CAAC;QAED,oBAAoB;QACpB,MAAM,CAAC,IAAI,CACT,4BAA4B,SAAS,IAAI,aAAa,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC/F,CAAC;QAEF,eAAe,GAAG;YAChB,GAAG,eAAe;YAClB,iBAAiB,EAAE,UAAU,CAAC,OAAO;SACtC,CAAC;QACF,MAAM,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QAEnD,MAAM,aAAa,CAAC,WAAW,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,eAAe,CAAC,EAAE;YAC5B,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,OAAO,EAAE;SACrD,CAAC,CAAC;QAEH,IAAI,SAAS,IAAI,aAAa,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CACV,UAAU,eAAe,CAAC,EAAE,6BAA6B,aAAa,IAAI,CAC3E,CAAC;YACF,eAAe,GAAG,oBAAoB,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;YACxE,MAAM,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACpE,CAAC;IAED,iCAAiC;IACjC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AACnE,CAAC;AAED,sEAAsE;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAkB,EAClB,WAAmB,EACnB,MAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IAExC,IAAI,CAAC;QACH,4CAA4C;QAC5C,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAElC,MAAM,aAAa,CAAC,WAAW,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;SAClD,CAAC,CAAC;QAEH,gEAAgE;QAChE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAE/D,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;QAE3E,MAAM,aAAa,CAAC,WAAW,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE;gBACP,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;aACnC;SACF,CAAC,CAAC;QAEH,gEAAgE;QAChE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAEjC,wCAAwC;QACxC,MAAM,SAAS,GAAqB,EAAE,CAAC;QACvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,cAAc,CAC7B,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC3C,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,cAAc,GAAG,GAAG,CAAC,EAAE;gBACxC,WAAW,EAAE,EAAE;gBACf,kBAAkB,EAAE,kBAAkB;aACvC,CAAC,CAAC,CACJ,CAAC;YACF,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,MAAM,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,gBAAgB,GAAqB,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAqB,EAAE,CAAC;QAE3C,MAAM,cAAc,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAExE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;gBAC7C,MAAM;YACR,CAAC;YAED,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;YAErD,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,QAAQ,EACR,IAAI,EACJ,gBAAgB,EAChB,WAAW,EACX,MAAM,EACN,cAAc,CACf,CAAC;YAEF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAEpC,4CAA4C;gBAC5C,IACE,MAAM,CAAC,MAAM,CAAC,gBAAgB;oBAC9B,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,cAAc,EACzC,CAAC;oBACD,MAAM,CAAC,KAAK,CACV,UAAU,MAAM,CAAC,QAAQ,CAAC,EAAE,wDAAwD,CACrF,CAAC;oBACF,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,gEAAgE;QAChE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,MAAM,OAAO,GACX,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;QAE5D,MAAM,aAAa,CAAC,WAAW,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;YACtC,OAAO,EAAE;gBACP,SAAS,EAAE,gBAAgB,CAAC,MAAM;gBAClC,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,UAAU,EAAE,QAAQ;aACrB;SACF,CAAC,CAAC;QAEH,OAAO;YACL,OAAO;YACP,IAAI;YACJ,gBAAgB;YAChB,aAAa;YACb,QAAQ;SACT,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/orchestrator/planner-agent.d.ts

@@ -0,0 +1,10 @@
+import type { BoberConfig } from "../config/schema.js";
+import type { PlanSpec } from "../contracts/spec.js";
+/**
+ * Run the planner agent to produce a PlanSpec from a user prompt.
+ *
+ * Uses the Anthropic SDK to create a single-turn message with the
+ * planner system prompt and project context.
+ */
+export declare function runPlanner(userPrompt: string, projectRoot: string, config: BoberConfig): Promise<PlanSpec>;
+//# sourceMappingURL=planner-agent.d.ts.map

package/dist/orchestrator/planner-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/planner-agent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AA0GrD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,QAAQ,CAAC,CAkDnB"}

package/dist/orchestrator/planner-agent.js

@@ -0,0 +1,187 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { PlanSpecSchema } from "../contracts/spec.js";
+import { saveSpec } from "../state/index.js";
+import { fileExists } from "../utils/fs.js";
+import { logger } from "../utils/logger.js";
+// ── Model mapping ──────────────────────────────────────────────────
+function resolveModel(choice) {
+    switch (choice) {
+        case "opus":
+            return "claude-sonnet-4-20250514";
+        case "sonnet":
+            return "claude-sonnet-4-20250514";
+        case "haiku":
+            return "claude-haiku-4-20250414";
+        default:
+            return "claude-sonnet-4-20250514";
+    }
+}
+// ── System prompt ──────────────────────────────────────────────────
+const PLANNER_SYSTEM_PROMPT = `You are the Bober Planner agent. Your job is to take a user's project description and produce a detailed plan specification (PlanSpec) as JSON.
+
+You must output ONLY valid JSON matching this schema:
+{
+  "id": "spec-<timestamp>",
+  "title": "Short plan title",
+  "description": "Detailed description of what will be built",
+  "projectType": "<mode>[ / <preset>]",
+  "techStack": ["list", "of", "technologies"],
+  "features": [
+    {
+      "id": "feature-1",
+      "title": "Feature title",
+      "description": "What this feature does",
+      "priority": "must" | "should" | "could",
+      "estimatedSprints": 1,
+      "acceptanceCriteria": ["Criterion 1", "Criterion 2"]
+    }
+  ],
+  "nonFunctional": ["NFR 1", "NFR 2"],
+  "constraints": ["Constraint 1"],
+  "createdAt": "<ISO datetime>",
+  "updatedAt": "<ISO datetime>"
+}
+
+Guidelines:
+- Break the project into small, independently testable features.
+- Each feature should be completable in 1-3 sprints.
+- Order features by dependency — foundational features first.
+- "must" priority features are the MVP. "should" are important. "could" are nice-to-have.
+- Acceptance criteria must be specific and verifiable.
+- Consider the project's existing tech stack and configuration.
+- Keep sprint sizes reasonable — each sprint should produce a working increment.
+
+Output ONLY the JSON object. No markdown fences, no explanation, just the JSON.`;
+// ── Context gathering ──────────────────────────────────────────────
+async function gatherProjectContext(projectRoot, config) {
+    const sections = [];
+    // Package.json
+    const pkgPath = join(projectRoot, "package.json");
+    if (await fileExists(pkgPath)) {
+        const content = await readFile(pkgPath, "utf-8");
+        sections.push(`## package.json\n\`\`\`json\n${content}\n\`\`\``);
+    }
+    // CLAUDE.md
+    const claudeMdPath = join(projectRoot, "CLAUDE.md");
+    if (await fileExists(claudeMdPath)) {
+        const content = await readFile(claudeMdPath, "utf-8");
+        sections.push(`## CLAUDE.md\n${content}`);
+    }
+    // bober.config.json
+    sections.push(`## bober.config.json\n\`\`\`json\n${JSON.stringify(config, null, 2)}\n\`\`\``);
+    // Additional context files from config
+    if (config.planner.contextFiles) {
+        for (const relPath of config.planner.contextFiles) {
+            const fullPath = join(projectRoot, relPath);
+            if (await fileExists(fullPath)) {
+                try {
+                    const content = await readFile(fullPath, "utf-8");
+                    sections.push(`## ${relPath}\n\`\`\`\n${content}\n\`\`\``);
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+    }
+    return sections.join("\n\n");
+}
+// ── Main ───────────────────────────────────────────────────────────
+/**
+ * Run the planner agent to produce a PlanSpec from a user prompt.
+ *
+ * Uses the Anthropic SDK to create a single-turn message with the
+ * planner system prompt and project context.
+ */
+export async function runPlanner(userPrompt, projectRoot, config) {
+    logger.phase("Planning Phase");
+    logger.info("Gathering project context...");
+    const context = await gatherProjectContext(projectRoot, config);
+    const model = resolveModel(config.planner.model);
+    const client = new Anthropic();
+    const userMessage = `# Task Description
+${userPrompt}
+
+# Project Context
+${context}
+
+Produce a PlanSpec JSON for this project. Remember: output ONLY valid JSON, no markdown fences.`;
+    logger.info(`Calling planner model (${config.planner.model})...`);
+    logger.debug(`Using model: ${model}`);
+    const response = await client.messages.create({
+        model,
+        max_tokens: 8192,
+        system: PLANNER_SYSTEM_PROMPT,
+        messages: [
+            {
+                role: "user",
+                content: userMessage,
+            },
+        ],
+    });
+    // Extract text content from the response
+    let responseText = "";
+    for (const block of response.content) {
+        if (block.type === "text") {
+            responseText += block.text;
+        }
+    }
+    logger.debug("Raw planner response received, parsing...");
+    // Try to extract JSON from the response
+    const spec = parsePlanSpec(responseText);
+    // Save to .bober/specs/
+    await saveSpec(projectRoot, spec);
+    logger.success(`Plan saved: ${spec.title} (${spec.features.length} features)`);
+    return spec;
+}
+/**
+ * Parse the planner response text into a validated PlanSpec.
+ */
+function parsePlanSpec(text) {
+    // Try direct parse first
+    let parsed;
+    try {
+        parsed = JSON.parse(text.trim());
+    }
+    catch {
+        // Try extracting JSON from markdown code fences
+        const fenceMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/.exec(text);
+        if (fenceMatch) {
+            try {
+                parsed = JSON.parse(fenceMatch[1].trim());
+            }
+            catch {
+                // Fall through to error
+            }
+        }
+        // Try finding the first { ... } block
+        if (!parsed) {
+            const braceStart = text.indexOf("{");
+            const braceEnd = text.lastIndexOf("}");
+            if (braceStart !== -1 && braceEnd > braceStart) {
+                try {
+                    parsed = JSON.parse(text.slice(braceStart, braceEnd + 1));
+                }
+                catch {
+                    throw new Error("Failed to parse planner response as JSON. Raw response:\n" +
+                        text.slice(0, 500));
+                }
+            }
+            else {
+                throw new Error("No JSON object found in planner response. Raw response:\n" +
+                    text.slice(0, 500));
+            }
+        }
+    }
+    const result = PlanSpecSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Planner produced invalid PlanSpec:\n${issues}\n\nRaw:\n${JSON.stringify(parsed, null, 2).slice(0, 1000)}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=planner-agent.js.map

package/dist/orchestrator/planner-agent.js.map

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

package/dist/state/helpers.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/state/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/state/helpers.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D"}

package/dist/state/helpers.js

@@ -0,0 +1,8 @@
+import { mkdir } from "node:fs/promises";
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+export async function ensureDir(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/state/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/state/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/state/history.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import type { SprintContract } from "../contracts/sprint-contract.js";
+import type { PlanSpec } from "../contracts/spec.js";
+export declare const PhaseSchema: z.ZodEnum<["init", "planning", "generating", "evaluating", "rework", "complete", "failed"]>;
+export type Phase = z.infer<typeof PhaseSchema>;
+export declare const HistoryEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    event: z.ZodString;
+    phase: z.ZodEnum<["init", "planning", "generating", "evaluating", "rework", "complete", "failed"]>;
+    sprintId: z.ZodOptional<z.ZodString>;
+    details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    details: Record<string, unknown>;
+    event: string;
+    phase: "evaluating" | "failed" | "init" | "planning" | "generating" | "rework" | "complete";
+    sprintId?: string | undefined;
+}, {
+    timestamp: string;
+    details: Record<string, unknown>;
+    event: string;
+    phase: "evaluating" | "failed" | "init" | "planning" | "generating" | "rework" | "complete";
+    sprintId?: string | undefined;
+}>;
+export type HistoryEntry = z.infer<typeof HistoryEntrySchema>;
+/**
+ * Append a history entry to the JSONL log file.
+ */
+export declare function appendHistory(projectRoot: string, entry: HistoryEntry): Promise<void>;
+/**
+ * Load all history entries from the JSONL log.
+ * Skips malformed lines.
+ */
+export declare function loadHistory(projectRoot: string): Promise<HistoryEntry[]>;
+/**
+ * Update the human-readable progress.md file with current state.
+ */
+export declare function updateProgress(projectRoot: string, contracts: SprintContract[], spec: PlanSpec | null): Promise<void>;
+//# sourceMappingURL=history.d.ts.map

package/dist/state/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/state/history.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAmBrD,eAAO,MAAM,WAAW,6FAQtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAyBzB;AAID;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc,EAAE,EAC3B,IAAI,EAAE,QAAQ,GAAG,IAAI,GACpB,OAAO,CAAC,IAAI,CAAC,CAqFf"}