agent-bober 0.1.0

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

@@ -0,0 +1,15 @@
+import type { BoberConfig } from "../config/schema.js";
+import type { ContextHandoff } from "./context-handoff.js";
+import type { EvaluationRunResult } from "../evaluators/registry.js";
+export type { EvaluationRunResult } from "../evaluators/registry.js";
+/**
+ * Run the evaluator agent, combining programmatic evaluation (plugins)
+ * with agent-based qualitative evaluation.
+ *
+ * @param handoff  Context handoff for the current sprint.
+ * @param projectRoot  Absolute path to the project.
+ * @param config  The resolved bober configuration.
+ * @returns A combined EvaluationRunResult.
+ */
+export declare function runEvaluatorAgent(handoff: ContextHandoff, projectRoot: string, config: BoberConfig): Promise<EvaluationRunResult>;
+//# sourceMappingURL=evaluator-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/evaluator-agent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAwDrE;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA0E9B"}

package/dist/orchestrator/evaluator-agent.js

@@ -0,0 +1,233 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { serializeHandoff } from "./context-handoff.js";
+import { createDefaultRegistry, runEvaluation, } from "../evaluators/registry.js";
+import { getChangedFiles } from "../utils/git.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";
+    }
+}
+// ── Agent Evaluation System Prompt ─────────────────────────────────
+const EVALUATOR_SYSTEM_PROMPT = `You are the Bober Evaluator agent. Your job is to qualitatively assess whether a sprint's implementation meets its contract criteria.
+
+You will receive:
+- The sprint contract with success criteria
+- The context handoff with implementation notes
+- Results from automated checks (typecheck, lint, tests, etc.)
+
+For each success criterion that cannot be automatically verified, assess whether it has been met based on the implementation description and changed files.
+
+Output format — respond with a JSON object:
+{
+  "evaluator": "Agent Evaluation",
+  "passed": true/false,
+  "score": 0-100,
+  "details": [
+    {
+      "criterion": "criterion id or description",
+      "passed": true/false,
+      "message": "explanation",
+      "severity": "error" | "warning" | "info"
+    }
+  ],
+  "summary": "Overall assessment",
+  "feedback": "Actionable feedback for the generator if anything needs fixing",
+  "timestamp": "<ISO datetime>"
+}
+
+Guidelines:
+- Be thorough but fair. If the implementation reasonably meets a criterion, mark it as passed.
+- If automated checks already cover a criterion, you can defer to their results.
+- Focus on criteria that require human-like judgment: code quality, architectural decisions, completeness.
+- Provide specific, actionable feedback when something fails.
+
+Output ONLY the JSON object. No markdown fences, no explanation.`;
+// ── Main ───────────────────────────────────────────────────────────
+/**
+ * Run the evaluator agent, combining programmatic evaluation (plugins)
+ * with agent-based qualitative evaluation.
+ *
+ * @param handoff  Context handoff for the current sprint.
+ * @param projectRoot  Absolute path to the project.
+ * @param config  The resolved bober configuration.
+ * @returns A combined EvaluationRunResult.
+ */
+export async function runEvaluatorAgent(handoff, projectRoot, config) {
+    const contract = handoff.currentContract;
+    if (!contract) {
+        throw new Error("No current contract in handoff for evaluation.");
+    }
+    const sprintId = contract.id;
+    logger.sprint(sprintId, `Evaluating: ${contract.feature}`);
+    // 1. Programmatic evaluation — run registered evaluator plugins
+    logger.info("Running programmatic evaluations...");
+    const registry = await createDefaultRegistry(config);
+    let changedFiles;
+    try {
+        changedFiles = handoff.changedFiles.length > 0
+            ? handoff.changedFiles
+            : await getChangedFiles(projectRoot);
+    }
+    catch {
+        changedFiles = handoff.changedFiles;
+    }
+    const programmaticEval = await runEvaluation(registry, projectRoot, config, contract, changedFiles);
+    for (const result of programmaticEval.results) {
+        const icon = result.passed ? "PASS" : "FAIL";
+        logger.debug(`  [${icon}] ${result.evaluator}: ${result.summary}`);
+    }
+    // 2. Agent evaluation — qualitative assessment via Claude
+    logger.info("Running agent evaluation...");
+    const agentResult = await runAgentEvaluation(handoff, programmaticEval.results, config);
+    // 3. Combine results: merge the agent result into the programmatic evaluation
+    const allResults = [...programmaticEval.results, agentResult];
+    const scoredResults = allResults.filter((r) => r.score !== undefined);
+    const avgScore = scoredResults.length > 0
+        ? Math.round(scoredResults.reduce((sum, r) => sum + (r.score ?? 0), 0) /
+            scoredResults.length)
+        : 0;
+    const passedCount = allResults.filter((r) => r.passed).length;
+    const summaryParts = [
+        `Evaluation complete: ${passedCount}/${allResults.length} evaluators passed`,
+        `Score: ${avgScore}/100`,
+    ];
+    const evaluation = {
+        passed: programmaticEval.passed && agentResult.passed,
+        score: avgScore,
+        results: allResults,
+        summary: summaryParts.join(". "),
+        timestamp: new Date().toISOString(),
+    };
+    const statusLabel = evaluation.passed ? "PASSED" : "FAILED";
+    logger.sprint(sprintId, `Evaluation ${statusLabel}`);
+    return evaluation;
+}
+/**
+ * Run the agent-based qualitative evaluation.
+ */
+async function runAgentEvaluation(handoff, programmaticResults, config) {
+    const model = resolveModel(config.evaluator.model);
+    const client = new Anthropic();
+    const timestamp = new Date().toISOString();
+    const handoffJson = serializeHandoff(handoff);
+    const programmaticSummary = programmaticResults
+        .map((r) => `[${r.passed ? "PASS" : "FAIL"}] ${r.evaluator}: ${r.summary}`)
+        .join("\n");
+    const userMessage = `# Context Handoff
+${handoffJson}
+
+# Automated Check Results
+${programmaticSummary}
+
+Evaluate whether the sprint contract criteria have been met. Focus on criteria that automated checks cannot verify.
+
+Output ONLY a JSON object matching the EvalResult schema. No markdown fences.`;
+    try {
+        const response = await client.messages.create({
+            model,
+            max_tokens: 4096,
+            system: EVALUATOR_SYSTEM_PROMPT,
+            messages: [
+                {
+                    role: "user",
+                    content: userMessage,
+                },
+            ],
+        });
+        let responseText = "";
+        for (const block of response.content) {
+            if (block.type === "text") {
+                responseText += block.text;
+            }
+        }
+        return parseEvalResult(responseText, timestamp);
+    }
+    catch (err) {
+        logger.warn(`Agent evaluation failed: ${err instanceof Error ? err.message : String(err)}`);
+        return {
+            evaluator: "Agent Evaluation",
+            passed: true, // Don't block on agent eval failure
+            score: undefined,
+            details: [],
+            summary: "Agent evaluation could not be performed.",
+            feedback: `Agent evaluation error: ${err instanceof Error ? err.message : String(err)}`,
+            timestamp,
+        };
+    }
+}
+/**
+ * Parse the evaluator agent's response into an EvalResult.
+ */
+function parseEvalResult(text, fallbackTimestamp) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text.trim());
+    }
+    catch {
+        const fenceMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/.exec(text);
+        if (fenceMatch) {
+            try {
+                parsed = JSON.parse(fenceMatch[1].trim());
+            }
+            catch {
+                // Fall through
+            }
+        }
+        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 {
+                    // Fall through
+                }
+            }
+        }
+    }
+    if (parsed && typeof parsed === "object" && parsed !== null) {
+        const obj = parsed;
+        const details = Array.isArray(obj.details)
+            ? obj.details
+                .filter((d) => typeof d === "object" && d !== null)
+                .map((d) => ({
+                criterion: String(d.criterion ?? "unknown"),
+                passed: Boolean(d.passed),
+                message: String(d.message ?? ""),
+                severity: (["error", "warning", "info"].includes(String(d.severity))
+                    ? String(d.severity)
+                    : "info"),
+                ...(typeof d.file === "string" ? { file: d.file } : {}),
+                ...(typeof d.line === "number" ? { line: d.line } : {}),
+            }))
+            : [];
+        return {
+            evaluator: String(obj.evaluator ?? "Agent Evaluation"),
+            passed: Boolean(obj.passed),
+            score: typeof obj.score === "number" ? obj.score : undefined,
+            details,
+            summary: String(obj.summary ?? "No summary provided."),
+            feedback: String(obj.feedback ?? "No feedback provided."),
+            timestamp: typeof obj.timestamp === "string" ? obj.timestamp : fallbackTimestamp,
+        };
+    }
+    return {
+        evaluator: "Agent Evaluation",
+        passed: false,
+        details: [],
+        summary: "Failed to parse agent evaluation response.",
+        feedback: `Raw response:\n${text.slice(0, 500)}`,
+        timestamp: fallbackTimestamp,
+    };
+}
+//# sourceMappingURL=evaluator-agent.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { BoberConfig } from "../config/schema.js";
+import type { ContextHandoff } from "./context-handoff.js";
+export interface GeneratorResult {
+    success: boolean;
+    notes: string;
+    filesChanged: string[];
+    commitHash?: string;
+}
+/**
+ * Run the generator agent to implement changes for a sprint.
+ *
+ * Each invocation is a FRESH call (context reset). The handoff
+ * document carries all necessary context from previous phases.
+ */
+export declare function runGenerator(handoff: ContextHandoff, projectRoot: string, config: BoberConfig): Promise<GeneratorResult>;
+//# sourceMappingURL=generator-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/generator-agent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmDD;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CA8C1B"}

package/dist/orchestrator/generator-agent.js

@@ -0,0 +1,147 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { serializeHandoff } from "./context-handoff.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 GENERATOR_SYSTEM_PROMPT = `You are the Bober Generator agent. Your job is to implement code changes according to a sprint contract.
+
+You will receive a context handoff document containing:
+- The overall plan specification
+- The current sprint contract with success criteria
+- History of completed sprints
+- Any feedback from prior evaluation rounds
+
+Your responsibilities:
+1. Implement the changes described in the sprint contract.
+2. Follow the success criteria exactly — each criterion must be met.
+3. Work incrementally: make small, testable changes.
+4. Self-verify before reporting completion.
+5. If you received evaluation feedback, address every issue mentioned.
+
+Output format — respond with a JSON object:
+{
+  "success": true/false,
+  "notes": "Description of what was implemented and any issues encountered",
+  "filesChanged": ["list", "of", "changed", "file", "paths"]
+}
+
+Guidelines:
+- Follow existing code style and conventions in the project.
+- Do not break existing functionality.
+- If a task cannot be completed, set success to false and explain why in notes.
+- List ALL files that were created, modified, or deleted.
+
+Output ONLY the JSON object. No markdown fences, no explanation.`;
+// ── Main ───────────────────────────────────────────────────────────
+/**
+ * Run the generator agent to implement changes for a sprint.
+ *
+ * Each invocation is a FRESH call (context reset). The handoff
+ * document carries all necessary context from previous phases.
+ */
+export async function runGenerator(handoff, projectRoot, config) {
+    const contractId = handoff.currentContract?.id ?? "unknown";
+    const feature = handoff.currentContract?.feature ?? "unknown";
+    logger.sprint(contractId, `Generating: ${feature}`);
+    const model = resolveModel(config.generator.model);
+    const client = new Anthropic();
+    const handoffJson = serializeHandoff(handoff);
+    const userMessage = `# Context Handoff
+${handoffJson}
+
+# Project Root
+${projectRoot}
+
+Implement the changes described in the sprint contract. Follow every success criterion.
+${handoff.issues.length > 0 ? `\n# Previous Issues to Fix\n${handoff.issues.join("\n")}` : ""}
+
+Output ONLY a JSON object with { success, notes, filesChanged }. No markdown fences.`;
+    logger.debug(`Calling generator model (${config.generator.model})...`);
+    const response = await client.messages.create({
+        model,
+        max_tokens: 8192,
+        system: GENERATOR_SYSTEM_PROMPT,
+        messages: [
+            {
+                role: "user",
+                content: userMessage,
+            },
+        ],
+    });
+    let responseText = "";
+    for (const block of response.content) {
+        if (block.type === "text") {
+            responseText += block.text;
+        }
+    }
+    logger.debug("Generator response received, parsing...");
+    return parseGeneratorResult(responseText);
+}
+/**
+ * Parse the generator response text into a GeneratorResult.
+ */
+function parseGeneratorResult(text) {
+    let parsed;
+    // Try direct parse
+    try {
+        parsed = JSON.parse(text.trim());
+    }
+    catch {
+        // Try extracting from markdown fences
+        const fenceMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/.exec(text);
+        if (fenceMatch) {
+            try {
+                parsed = JSON.parse(fenceMatch[1].trim());
+            }
+            catch {
+                // Fall through
+            }
+        }
+        // Try finding { ... }
+        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 {
+                    // Fall through to default
+                }
+            }
+        }
+    }
+    if (parsed &&
+        typeof parsed === "object" &&
+        parsed !== null &&
+        "success" in parsed) {
+        const obj = parsed;
+        return {
+            success: Boolean(obj.success),
+            notes: typeof obj.notes === "string" ? obj.notes : "No notes provided.",
+            filesChanged: Array.isArray(obj.filesChanged)
+                ? obj.filesChanged.filter((f) => typeof f === "string")
+                : [],
+            commitHash: typeof obj.commitHash === "string" ? obj.commitHash : undefined,
+        };
+    }
+    // If parsing failed entirely, return a failure result
+    return {
+        success: false,
+        notes: `Failed to parse generator response. Raw output:\n${text.slice(0, 500)}`,
+        filesChanged: [],
+    };
+}
+//# sourceMappingURL=generator-agent.js.map

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

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

package/dist/orchestrator/pipeline.d.ts

@@ -0,0 +1,24 @@
+import type { BoberConfig } from "../config/schema.js";
+import type { PlanSpec } from "../contracts/spec.js";
+import type { SprintContract } from "../contracts/sprint-contract.js";
+export interface PipelineResult {
+    success: boolean;
+    spec: PlanSpec;
+    completedSprints: SprintContract[];
+    failedSprints: SprintContract[];
+    totalCost?: number;
+    duration: number;
+}
+/**
+ * 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 declare function runPipeline(userPrompt: string, projectRoot: string, config: BoberConfig): Promise<PipelineResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/orchestrator/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/orchestrator/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AA0BtE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+PD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC,CAuHzB"}