agent-bober 0.12.0 → 0.17.0

package/dist/orchestrator/checkpoints/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Checkpoint type definitions for Tier 2 careful-flow plumbing.
+ *
+ * Sprint 7: establishes the type infrastructure used by Sprints 8-10
+ * to plug in real mechanisms (cli, disk, pr). Only the noop mechanism
+ * is registered in this sprint.
+ */
+/**
+ * One of the 9 pipeline decision points. Sprints 8-14 may add overrides per id;
+ * the registry resolves an id → mechanism.
+ */
+export type CheckpointId = "post-research" | "post-plan" | "post-sprint-contract" | "pre-curator" | "pre-generator" | "pre-evaluator" | "pre-code-reviewer" | "post-sprint" | "end-of-pipeline";
+/**
+ * Opaque artifact passed to a mechanism. The shape varies per CheckpointId.
+ * Sprints 8-10 may narrow this via the id discriminator; this sprint treats it
+ * as `unknown` because the only mechanism (noop) ignores it.
+ */
+export type CheckpointArtifact = unknown;
+/**
+ * Discriminated union of the three outcomes a mechanism can return.
+ *
+ * - approved:true                        → proceed unchanged (autopilot / accept)
+ * - approved:false + feedback            → reject; Sprint 12 will propagate
+ *                                          `feedback` back into the prior agent
+ * - edit:true + editDelta                → user mutated the artifact in place
+ *                                          (CLI edit, disk file rewrite, PR commit)
+ *                                          and the coordinator must consume the
+ *                                          delta before proceeding.
+ *
+ * Why all three exist now (per evaluatorNotes): "The Checkpoint types must be
+ * exhaustive enough to support all three mechanisms (CLI/disk/PR) without
+ * re-shaping in Sprints 8-10."
+ */
+export type CheckpointOutcome = {
+    approved: true;
+    editDelta?: unknown;
+} | {
+    approved: false;
+    feedback: string;
+} | {
+    edit: true;
+    editDelta: unknown;
+};
+/**
+ * A pluggable approval mechanism. Sprints 8-10 implement `cli`, `disk`, `pr`.
+ * This sprint registers ONLY `noop`.
+ */
+export interface CheckpointMechanism {
+    request(checkpoint: CheckpointId, artifact: CheckpointArtifact): Promise<CheckpointOutcome>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/orchestrator/checkpoints/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/checkpoints/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,WAAW,GACX,sBAAsB,GACtB,aAAa,GACb,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,aAAa,GACb,iBAAiB,CAAC;AAEtB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CACL,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B"}

package/dist/orchestrator/checkpoints/types.js

@@ -0,0 +1,9 @@
+/**
+ * Checkpoint type definitions for Tier 2 careful-flow plumbing.
+ *
+ * Sprint 7: establishes the type infrastructure used by Sprints 8-10
+ * to plug in real mechanisms (cli, disk, pr). Only the noop mechanism
+ * is registered in this sprint.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/orchestrator/checkpoints/types.js.map

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

package/dist/orchestrator/code-reviewer-agent.d.ts

@@ -0,0 +1,50 @@
+import type { BoberConfig } from "../config/schema.js";
+import type { SprintContract } from "../contracts/sprint-contract.js";
+import type { EvaluationRunResult } from "../evaluators/registry.js";
+/**
+ * A finding in the ReviewResult — one entry in critical, important, or minor arrays.
+ */
+export interface ReviewFinding {
+    description: string;
+    evidence: Array<{
+        path: string;
+        line: number;
+        snippet: string;
+    }>;
+    antiPattern?: string;
+    source?: string;
+}
+/**
+ * The structured result emitted by the bober-code-reviewer subagent.
+ */
+export interface ReviewResult {
+    reviewId: string;
+    contractId: string;
+    specId: string;
+    timestamp: string;
+    summary: string;
+    critical: ReviewFinding[];
+    important: ReviewFinding[];
+    minor: ReviewFinding[];
+    approvedAreas: string[];
+}
+/**
+ * Run the bober-code-reviewer subagent for advisory code review.
+ *
+ * Runs AFTER the evaluator returns passed=true. The review is advisory:
+ * findings surface in the run history but do NOT block sprint completion,
+ * do NOT trigger generator retry, and do NOT mutate contract status.
+ *
+ * @param contract    The sprint contract that just passed.
+ * @param evaluation  The evaluation result (passed=true) from runEvaluatorAgent.
+ * @param projectRoot Absolute path to the project root.
+ * @param config      The resolved bober configuration.
+ * @returns A ReviewResult with structured findings.
+ */
+export declare function runCodeReviewer(contract: SprintContract, evaluation: EvaluationRunResult, projectRoot: string, config: BoberConfig): Promise<ReviewResult>;
+/**
+ * Render a ReviewResult into the 6-section markdown format required by s5-c5.
+ * Exported for direct unit testing of the renderer.
+ */
+export declare function renderReviewMarkdown(review: ReviewResult): string;
+//# sourceMappingURL=code-reviewer-agent.d.ts.map

package/dist/orchestrator/code-reviewer-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-reviewer-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/code-reviewer-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAWrE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,mBAAmB,EAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAoHvB;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA0EjE"}

package/dist/orchestrator/code-reviewer-agent.js

@@ -0,0 +1,283 @@
+import { createClient } from "../providers/factory.js";
+import { logger } from "../utils/logger.js";
+import { resolveModel } from "./model-resolver.js";
+import { assembleSystemPrompt } from "./agent-loader.js";
+import { resolveRoleTools, getGraphState, getGraphDeps } from "./tools/index.js";
+import { runAgenticLoop } from "./agentic-loop.js";
+import { saveReview } from "../state/review-state.js";
+// ── Main ───────────────────────────────────────────────────────────
+/**
+ * Run the bober-code-reviewer subagent for advisory code review.
+ *
+ * Runs AFTER the evaluator returns passed=true. The review is advisory:
+ * findings surface in the run history but do NOT block sprint completion,
+ * do NOT trigger generator retry, and do NOT mutate contract status.
+ *
+ * @param contract    The sprint contract that just passed.
+ * @param evaluation  The evaluation result (passed=true) from runEvaluatorAgent.
+ * @param projectRoot Absolute path to the project root.
+ * @param config      The resolved bober configuration.
+ * @returns A ReviewResult with structured findings.
+ */
+export async function runCodeReviewer(contract, evaluation, projectRoot, config) {
+    const contractId = contract.contractId;
+    logger.sprint(contractId, `Code review: ${contract.title}`);
+    const reviewerModel = config.codeReview?.model ?? config.evaluator.model;
+    const model = resolveModel(reviewerModel);
+    const maxTurns = config.codeReview?.maxTurns ?? 15;
+    // Code reviewer reuses the "evaluator" role tool set — read-only (bash, read, grep, glob).
+    // Adding a distinct role is a separate refactor — out of scope per contract s5-c9.
+    const graphState = getGraphState(config);
+    const graphDeps = graphState.engineHealth === "ready" ? getGraphDeps() : undefined;
+    const toolSet = resolveRoleTools("evaluator", projectRoot, graphState, graphDeps ?? undefined);
+    const systemPrompt = await assembleSystemPrompt("evaluator", "bober-code-reviewer", projectRoot, graphState);
+    const client = createClient(config.codeReview?.provider ?? config.evaluator.provider ?? null, config.codeReview?.endpoint ?? config.evaluator.endpoint ?? null, config.codeReview?.providerConfig ?? config.evaluator.providerConfig, reviewerModel, "CodeReviewer");
+    const contractJson = JSON.stringify(contract, null, 2);
+    const evalSummary = JSON.stringify({
+        passed: evaluation.passed,
+        score: evaluation.score,
+        summary: evaluation.summary,
+        timestamp: evaluation.timestamp,
+    }, null, 2);
+    const userMessage = `# Sprint Contract
+
+${contractJson}
+
+# Evaluation Result (Already Passed)
+
+${evalSummary}
+
+# Project Root
+
+${projectRoot}
+
+# Context
+
+- Contract ID: ${contractId}
+- Spec ID: ${contract.specId}
+- Review is ADVISORY ONLY — findings do NOT block completion or trigger retries
+
+# Anti-Pattern Catalog
+
+The catalog index is at .bober/anti-patterns/README.md. Consult it BEFORE classifying severity.
+Catalogued anti-patterns:
+- Testing anti-patterns → .bober/anti-patterns/testing-anti-patterns.md
+- Condition-based waiting → .bober/anti-patterns/condition-based-waiting.md
+- Root-cause tracing → .bober/anti-patterns/root-cause-tracing.md
+- Defense in depth → .bober/anti-patterns/defense-in-depth.md
+
+# Your Task
+
+Review the sprint diff. Use your tools to:
+1. Read .bober/contracts/${contractId}.json and .bober/anti-patterns/README.md
+2. Run git diff HEAD~1 --stat to see what changed
+3. Review each changed file for DRY violations, YAGNI, dead code, missing tests, anti-patterns
+4. Produce a ReviewResult JSON
+
+Output ONLY a JSON object (no markdown fences):
+{
+  "reviewId": "review-${contractId}-<ISO-timestamp>",
+  "contractId": "${contractId}",
+  "specId": "${contract.specId}",
+  "timestamp": "<ISO-8601>",
+  "summary": "<2-3 sentence overall assessment>",
+  "critical": [],
+  "important": [],
+  "minor": [],
+  "approvedAreas": []
+}`;
+    logger.info(`Calling code reviewer model (${reviewerModel} → ${model})...`);
+    const result = await runAgenticLoop({
+        client,
+        model,
+        systemPrompt,
+        userMessage,
+        tools: toolSet.schemas,
+        toolHandlers: toolSet.handlers,
+        maxTurns,
+        maxTokens: 16384,
+        onToolUse: (name, input) => {
+            const inp = input;
+            const inputStr = JSON.stringify(inp).slice(0, 120);
+            logger.debug(`  [code-reviewer] ${name}(${inputStr})`);
+        },
+    });
+    logger.debug(`Code reviewer completed in ${result.turnsUsed} turns (${result.toolsCalled.length} tool calls)`);
+    const reviewResult = parseReviewResult(result.finalText, contractId, contract.specId);
+    // Write the review markdown to .bober/reviews/<contractId>-review.md
+    const markdown = renderReviewMarkdown(reviewResult);
+    await saveReview(projectRoot, contractId, markdown);
+    logger.info(`Code review complete: ${reviewResult.critical.length} critical, ${reviewResult.important.length} important, ${reviewResult.minor.length} minor findings`);
+    return reviewResult;
+}
+// ── Markdown renderer ──────────────────────────────────────────────
+/**
+ * Render a ReviewResult into the 6-section markdown format required by s5-c5.
+ * Exported for direct unit testing of the renderer.
+ */
+export function renderReviewMarkdown(review) {
+    const lines = [];
+    lines.push(`# Code Review: ${review.contractId}`);
+    lines.push("");
+    lines.push("## Summary");
+    lines.push("");
+    lines.push(review.summary);
+    lines.push("");
+    lines.push("## Critical");
+    lines.push("");
+    if (review.critical.length === 0) {
+        lines.push("No critical findings.");
+    }
+    else {
+        for (const finding of review.critical) {
+            lines.push(`- **${finding.description}**`);
+            for (const ev of finding.evidence) {
+                lines.push(`  - \`${ev.path}:${ev.line}\`: ${ev.snippet}`);
+            }
+            if (finding.antiPattern) {
+                lines.push(`  - Anti-pattern: ${finding.antiPattern} (${finding.source ?? ""})`);
+            }
+        }
+    }
+    lines.push("");
+    lines.push("## Important");
+    lines.push("");
+    if (review.important.length === 0) {
+        lines.push("No important findings.");
+    }
+    else {
+        for (const finding of review.important) {
+            lines.push(`- **${finding.description}**`);
+            for (const ev of finding.evidence) {
+                lines.push(`  - \`${ev.path}:${ev.line}\`: ${ev.snippet}`);
+            }
+        }
+    }
+    lines.push("");
+    lines.push("## Minor");
+    lines.push("");
+    if (review.minor.length === 0) {
+        lines.push("No minor findings.");
+    }
+    else {
+        for (const finding of review.minor) {
+            lines.push(`- **${finding.description}**`);
+            for (const ev of finding.evidence) {
+                lines.push(`  - \`${ev.path}:${ev.line}\`: ${ev.snippet}`);
+            }
+        }
+    }
+    lines.push("");
+    lines.push("## Approved Areas");
+    lines.push("");
+    if (review.approvedAreas.length === 0) {
+        lines.push("No areas specifically called out.");
+    }
+    else {
+        for (const area of review.approvedAreas) {
+            lines.push(`- ${area}`);
+        }
+    }
+    lines.push("");
+    lines.push(`---`);
+    lines.push(`*Review ID: ${review.reviewId} — ${review.timestamp}*`);
+    lines.push("");
+    return lines.join("\n");
+}
+// ── JSON parser ────────────────────────────────────────────────────
+/**
+ * Parse the code reviewer's response into a ReviewResult.
+ * Mirrors the resilient JSON-parsing pattern from evaluator-agent.ts:parseEvalResult.
+ */
+function parseReviewResult(text, contractId, specId) {
+    const timestamp = new Date().toISOString();
+    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) {
+        const obj = parsed;
+        return {
+            reviewId: typeof obj.reviewId === "string"
+                ? obj.reviewId
+                : `review-${contractId}-${timestamp}`,
+            contractId: typeof obj.contractId === "string" ? obj.contractId : contractId,
+            specId: typeof obj.specId === "string" ? obj.specId : specId,
+            timestamp: typeof obj.timestamp === "string" ? obj.timestamp : timestamp,
+            summary: typeof obj.summary === "string"
+                ? obj.summary
+                : "No summary provided.",
+            critical: parseFindingArray(obj.critical),
+            important: parseFindingArray(obj.important),
+            minor: parseFindingArray(obj.minor),
+            approvedAreas: parseStringArray(obj.approvedAreas),
+        };
+    }
+    // Fallback — reviewer ran but response wasn't parseable
+    return {
+        reviewId: `review-${contractId}-${timestamp}`,
+        contractId,
+        specId,
+        timestamp,
+        summary: "Code reviewer response could not be parsed.",
+        critical: [],
+        important: [],
+        minor: [],
+        approvedAreas: [],
+    };
+}
+function parseFindingArray(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .filter((item) => typeof item === "object" && item !== null)
+        .map((item) => ({
+        description: typeof item.description === "string" ? item.description : "Unknown finding",
+        evidence: parseEvidenceArray(item.evidence),
+        ...(typeof item.antiPattern === "string" ? { antiPattern: item.antiPattern } : {}),
+        ...(typeof item.source === "string" ? { source: item.source } : {}),
+    }));
+}
+function parseEvidenceArray(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .filter((item) => typeof item === "object" && item !== null)
+        .map((item) => ({
+        path: typeof item.path === "string" ? item.path : "unknown",
+        line: typeof item.line === "number" ? item.line : 0,
+        snippet: typeof item.snippet === "string" ? item.snippet : "",
+    }));
+}
+function parseStringArray(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.filter((item) => typeof item === "string");
+}
+//# sourceMappingURL=code-reviewer-agent.js.map

package/dist/orchestrator/code-reviewer-agent.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"curator-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/curator-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAcrD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;CACzB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,gBAAgB,EAAE,cAAc,EAAE,EAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC,CA4GzB"}
+{"version":3,"file":"curator-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/curator-agent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAkBrD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;CACzB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,gBAAgB,EAAE,cAAc,EAAE,EAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC,CAyJzB"}

package/dist/orchestrator/curator-agent.js

@@ -1,11 +1,17 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
 import { createClient } from "../providers/factory.js";
 import { logger } from "../utils/logger.js";
 import { resolveModel } from "./model-resolver.js";
-import { loadAgentDefinition } from "./agent-loader.js";
-import { buildToolSet } from "./tools/index.js";
+import { assembleSystemPrompt } from "./agent-loader.js";
+import { resolveRoleTools, getGraphState, getGraphDeps } from "./tools/index.js";
 import { runAgenticLoop } from "./agentic-loop.js";
+import { PreflightContextInjector } from "../graph/preflight-injector.js";
+import { graphPipelineLifecycle } from "../graph/pipeline-lifecycle.js";
+import { ensureDir } from "../utils/fs.js";
+import { emit } from "../telemetry/emit.js";
 // ── Constants ──────────────────────────────────────────────────────
-const CURATOR_MAX_TURNS = 25;
+const CURATOR_MAX_TURNS = 100;
 // ── Main ───────────────────────────────────────────────────────────
 /**
  * Run the curator agent to produce a Sprint Briefing for a contract.
@@ -24,15 +30,20 @@ const CURATOR_MAX_TURNS = 25;
 export async function runCurator(contract, spec, completedSprints, projectRoot, config) {
     const contractId = contract.contractId;
     logger.sprint(contractId, `Curating: ${contract.title}`);
-    // Load agent definition (system prompt from .md file)
-    const agentDef = await loadAgentDefinition("bober-curator", projectRoot);
+    // Sprint 28 — telemetry: emit agent-spawn at entry (fire-and-forget)
+    void emit(projectRoot, config, "agent-spawn", { agentName: "curator", contractId });
     // Curator uses its own model config, falling back to planner model
     const curatorConfig = config.curator;
     const curatorModel = curatorConfig?.model ?? config.planner.model;
     const model = resolveModel(curatorModel);
     const curatorMaxTurns = curatorConfig?.maxTurns ?? CURATOR_MAX_TURNS;
-    // Curator gets read-only tools (same as planner)
-    const toolSet = buildToolSet("planner", projectRoot);
+    // Curator gets read-only tools. When graph is enabled and ready,
+    // bash/grep/glob are removed and graph_* tools are added (ADR-8).
+    const graphState = getGraphState(config);
+    const graphDeps = graphState.engineHealth === "ready" ? getGraphDeps() : undefined;
+    const toolSet = resolveRoleTools("curator", projectRoot, graphState, graphDeps ?? undefined);
+    // Assemble system prompt with graph-prompt decoration (ADR-5, Sprint 7).
+    const systemPrompt = await assembleSystemPrompt("curator", "bober-curator", projectRoot, graphState);
     const client = createClient(curatorConfig?.provider ?? config.planner.provider ?? null, curatorConfig?.endpoint ?? config.planner.endpoint ?? null, curatorConfig?.providerConfig ?? config.planner.providerConfig, curatorModel, "Curator");
     // Build the completed sprints summary
     const completedSummary = completedSprints.length > 0
@@ -42,7 +53,7 @@ export async function runCurator(contract, spec, completedSprints, projectRoot,
         : "No prior sprints completed.";
     // Build the contract JSON for the curator's context
     const contractJson = JSON.stringify(contract, null, 2);
-    const userMessage = `# Sprint Contract
+    const baseUserMessage = `# Sprint Contract
 
 ${contractJson}
 
@@ -84,12 +95,35 @@ Your final response must contain ONLY a JSON object (no markdown fences):
   "utilsIdentified": <number>,
   "summary": "<2-3 sentence summary>"
 }`;
+    // Pre-flight graph context injection (ADR-9 — special Curator case).
+    // Curator: write pre-flight content to .bober/briefings/<contractId>-briefing.md
+    // and reference it in the user message. The curator's own exploration output
+    // appends to the same file during the agentic loop.
+    const graphClient = graphPipelineLifecycle.getGraphClient();
+    const preflightInjector = new PreflightContextInjector(graphClient, config.graph);
+    const preflightPath = `.bober/briefings/${contractId}-briefing.md`;
+    // Pass "" as firstMessage — we only want the pre-flight content itself (not prepended to anything).
+    const preflightContent = await preflightInjector.inject("curator", contract, "");
+    let preflightNotice = "";
+    if (preflightContent.trim().length > 0) {
+        try {
+            const absPath = resolve(projectRoot, preflightPath);
+            await ensureDir(resolve(absPath, ".."));
+            await writeFile(absPath, preflightContent, "utf-8");
+            preflightNotice = `\n\n# Graph Pre-Flight Context\n\nA graph pre-flight analysis has been prepared at ${preflightPath} — read it FIRST as part of your codebase exploration. It contains relevant graph queries (callers, tests, search results) to accelerate your analysis.\n`;
+            logger.debug(`[curator] Pre-flight graph context written to ${preflightPath}`);
+        }
+        catch (err) {
+            logger.debug(`[curator] Pre-flight write failed (non-blocking): ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const userMessage = `${baseUserMessage}${preflightNotice}`;
     logger.info(`Calling curator model (${curatorModel} → ${model})...`);
     const filesRead = new Set();
     const result = await runAgenticLoop({
         client,
         model,
-        systemPrompt: agentDef.systemPrompt,
+        systemPrompt,
         userMessage,
         tools: toolSet.schemas,
         toolHandlers: toolSet.handlers,
@@ -107,6 +141,23 @@ Your final response must contain ONLY a JSON object (no markdown fences):
         },
     });
     logger.debug(`Curator completed in ${result.turnsUsed} turns (${result.toolsCalled.length} tool calls)`);
+    // Token-usage capture (graph integration sprint 2, s2-c8).
+    // Mirrors the cumulative-usage pattern from src/orchestrator/agentic-loop.ts:117-118.
+    // Failure to write must NOT break curation — swallow errors.
+    try {
+        const { TokenUsageLog } = await import("../graph/token-usage.js");
+        await new TokenUsageLog(projectRoot).append({
+            agent: "curator",
+            runId: contractId,
+            timestamp: new Date().toISOString(),
+            inputTokens: result.usage.inputTokens,
+            outputTokens: result.usage.outputTokens,
+            graphEnabled: config.graph?.enabled === true,
+        });
+    }
+    catch (err) {
+        logger.debug(`Token usage capture failed (curator): ${err instanceof Error ? err.message : String(err)}`);
+    }
     return parseCuratorResult(result.finalText, contractId, filesRead);
 }
 // ── JSON parser ────────────────────────────────────────────────────

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

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

package/dist/orchestrator/deploy/classify.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Command classifier for the deploy module (Sprint 20).
+ *
+ * classifyCommand(commandText) returns 'safe' | 'risky' based solely on the
+ * COMMAND CONTENT — never on the agent's self-declared classification.
+ *
+ * This is the safety guarantee against multi-command Bash invocations such as
+ * `echo 'safe' && kubectl scale ...`. The classifier scans the entire command
+ * string for state-mutating verbs before any execution occurs.
+ *
+ * Pattern sources:
+ * - agents/bober-diagnoser.md:188-198 (forbidden command list)
+ * - skills/bober.runbook/SKILL.md (risky-step examples)
+ * - Sprint 20 contract evaluatorNotes: multi-command gate requirement.
+ *
+ * Default-deny: when in doubt, classify risky.
+ */
+/**
+ * Classify a command string by blast radius.
+ *
+ * Rules:
+ * 1. Scan the full command string for any risky pattern (takes priority over allowlist).
+ * 2. If no risky pattern matched AND the command has no chain operators (&&/||/;/|),
+ *    check if it matches the safe allowlist.
+ * 3. When in doubt → risky (default-deny).
+ *
+ * @param commandText - The raw shell command string.
+ * @returns 'safe' if the command is confirmed read-only/reversible; 'risky' otherwise.
+ */
+export declare function classifyCommand(commandText: string): "safe" | "risky";
+//# sourceMappingURL=classify.d.ts.map

package/dist/orchestrator/deploy/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/deploy/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyDH;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAyBrE"}