agent-bober 0.18.0 → 0.19.0

package/dist/orchestrator/compaction.js

@@ -0,0 +1,75 @@
+/**
+ * In-context auto-compaction (agent-loop-capability-port sprint 7).
+ *
+ * A pure, testable helper that summarizes the older ("head") messages of a
+ * conversation into a single replacement message via ONE extra `client.chat`
+ * call, so `runAgenticLoop` can keep long runs inside the context window
+ * without the coarse sprint-boundary reset (`summarizeOlderSprints` /
+ * `contextReset` — a different, unrelated layer; see `context-handoff.ts`).
+ *
+ * Fails open: any error from the summarization call is caught, logged, and
+ * surfaced as `undefined` so the caller can skip compaction for that turn
+ * and continue uncompacted (sc-7-4). Never throws.
+ */
+import { logger } from "../utils/logger.js";
+const SUMMARY_SYSTEM = "Summarize this conversation preserving: task objective, file paths touched, " +
+    "decisions made, errors seen. Be concise and factual.";
+// ── Serialize head so we never send tool_use/tool_result blocks without tools ──
+/**
+ * Render the head messages to a single plain-text transcript. The head may
+ * contain `AssistantMessage`/`ToolResultMessage` entries (tool_use/tool_result
+ * content), which the main loop only ever sends alongside `tools`. Sending
+ * them to a no-tools summarization call risks a provider 400, so we flatten
+ * everything to plain text instead.
+ */
+function renderTranscript(messages) {
+    return messages
+        .map((m) => {
+        if ("toolResults" in m) {
+            return `[tool results] ${m.toolResults.map((r) => r.content).join("\n")}`;
+        }
+        if ("toolCalls" in m) {
+            const calls = m.toolCalls.map((c) => c.name).join(", ");
+            return calls.length > 0
+                ? `[assistant] ${m.content}\n[tool calls] ${calls}`
+                : `[assistant] ${m.content}`;
+        }
+        if ("systemUpdate" in m) {
+            return `[system update] ${m.systemUpdate}`;
+        }
+        return `[${m.role}] ${m.content}`;
+    })
+        .join("\n\n");
+}
+// ── Pure helper: one summarization chat, fail-open ─────────────────
+/**
+ * Summarize `head` into a single replacement message via ONE `client.chat`
+ * call. Passes NO `tools` and a bounded `maxTokens` — mirrors the existing
+ * one-shot `coerceJsonOutput` precedent (`agentic-loop.ts`).
+ *
+ * @returns `undefined` on any failure (fail-open, sc-7-4) — the caller must
+ *   skip compaction for that turn and continue uncompacted, never throw.
+ */
+export async function summarizeMessages(params) {
+    const { client, model, head, instructions, maxTokens = 4096 } = params;
+    const system = instructions ? `${SUMMARY_SYSTEM}\n\n${instructions}` : SUMMARY_SYSTEM;
+    const messages = [{ role: "user", content: renderTranscript(head) }];
+    try {
+        const response = await client.chat({ model, system, messages, maxTokens });
+        const summaryMessage = {
+            role: "user",
+            content: `[Conversation summary] ${response.text}`,
+        };
+        return {
+            summaryMessage,
+            usage: response.usage,
+            ...(response.costUsd !== undefined ? { costUsd: response.costUsd } : {}),
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.warn(`Compaction summarization failed (skipped, continuing uncompacted): ${message}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=compaction.js.map

package/dist/orchestrator/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/orchestrator/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA0B5C,MAAM,cAAc,GAClB,8EAA8E;IAC9E,sDAAsD,CAAC;AAEzD,kFAAkF;AAElF;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,QAAmB;IAC3C,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,kBAAkB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,CAAC;QACD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;gBACrB,CAAC,CAAC,eAAe,CAAC,CAAC,OAAO,kBAAkB,KAAK,EAAE;gBACnD,CAAC,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QACD,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,mBAAmB,CAAC,CAAC,YAAY,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,IAAI,KAAM,CAAiB,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,sEAAsE;AAEtE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,cAAc,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IACtF,MAAM,QAAQ,GAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEhF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3E,MAAM,cAAc,GAAY;YAC9B,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,0BAA0B,QAAQ,CAAC,IAAI,EAAE;SACnD,CAAC;QACF,OAAO;YACL,cAAc;YACd,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,sEAAsE,OAAO,EAAE,CAAC,CAAC;QAC7F,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -14,6 +14,8 @@ export interface GeneratorResult {
         inputTokens: number;
         outputTokens: number;
     };
+    /** Cumulative USD cost for this generation run, when known. Absent otherwise. */
+    costUsd?: number;
 }
 /**
  * Run the generator agent to implement changes for a sprint.
@@ -25,4 +27,21 @@ export interface GeneratorResult {
  * The system prompt is loaded from `agents/bober-generator.md`.
  */
 export declare function runGenerator(handoff: ContextHandoff, projectRoot: string, config: BoberConfig): Promise<GeneratorResult>;
+/**
+ * Parse the generator response text into a GeneratorResult.
+ *
+ * Exported for direct unit testing of the refusal fail-closed guard (sc-1-4).
+ */
+export declare function parseGeneratorResult(text: string, filesWritten: Set<string>, loopResult: {
+    turnsUsed: number;
+    toolsCalled: string[];
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** Set by runAgenticLoop when the provider refused (ADR-5). */
+    refused?: boolean;
+    /** Set by runAgenticLoop when at least one turn reported a cost. */
+    costUsd?: number;
+}): GeneratorResult;
 //# sourceMappingURL=generator-agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generator-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/generator-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAc3D,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;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB;IACnB,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAID;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CA4G1B"}
+{"version":3,"file":"generator-agent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/generator-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAe3D,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;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB;IACnB,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CAkH1B;AA0BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,UAAU,EAAE;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,eAAe,CAgHjB"}

package/dist/orchestrator/generator-agent.js

@@ -5,6 +5,7 @@ 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 { budgetFromMaxUsd } from "./workflow/budget.js";
 import { PreflightContextInjector } from "../graph/preflight-injector.js";
 import { graphPipelineLifecycle } from "../graph/pipeline-lifecycle.js";
 import { emit } from "../telemetry/emit.js";
@@ -26,6 +27,9 @@ export async function runGenerator(handoff, projectRoot, config) {
     void emit(projectRoot, config, "agent-spawn", { agentName: "generator", contractId });
     const model = resolveModel(config.generator.model);
     const maxTurns = config.generator.maxTurnsPerSprint;
+    const effort = config.generator.effort;
+    const budget = budgetFromMaxUsd(config.generator.budget?.maxUsd);
+    const parallelReadOnly = config.generator.parallelReadOnlyTools;
     // Build tool set (generator gets full access — UNION mode when gated:
     // all original tools retained AND graph_* tools added).
     const graphState = getGraphState(config);
@@ -79,6 +83,9 @@ When you are done, your final response must contain ONLY a JSON object with this
         toolHandlers: toolSet.handlers,
         maxTurns,
         maxTokens: 16384,
+        ...(effort !== undefined ? { effort } : {}),
+        ...(budget !== undefined ? { budget } : {}),
+        ...(parallelReadOnly !== undefined ? { parallelReadOnlyTools: parallelReadOnly } : {}),
         onToolUse: (name, input) => {
             const inp = input;
             if (name === "write_file" || name === "edit_file") {
@@ -128,8 +135,24 @@ function looksLikeGeneratorReport(text) {
 // ── JSON parser ────────────────────────────────────────────────────
 /**
  * Parse the generator response text into a GeneratorResult.
+ *
+ * Exported for direct unit testing of the refusal fail-closed guard (sc-1-4).
  */
-function parseGeneratorResult(text, filesWritten, loopResult) {
+export function parseGeneratorResult(text, filesWritten, loopResult) {
+    // Fail closed on a refusal BEFORE any JSON parsing or the filesWritten
+    // success shortcut below — a refusal after partial writes must never be
+    // reported as success:true (ADR-5).
+    if (loopResult.refused === true) {
+        return {
+            success: false,
+            notes: `model refused: ${text.slice(0, 300)}`,
+            filesChanged: [...filesWritten],
+            turnsUsed: loopResult.turnsUsed,
+            toolsCalled: loopResult.toolsCalled,
+            usage: loopResult.usage,
+            ...(loopResult.costUsd !== undefined ? { costUsd: loopResult.costUsd } : {}),
+        };
+    }
     let parsed;
     // Try direct parse
     try {
@@ -192,6 +215,7 @@ function parseGeneratorResult(text, filesWritten, loopResult) {
             turnsUsed: loopResult.turnsUsed,
             toolsCalled: loopResult.toolsCalled,
             usage: loopResult.usage,
+            ...(loopResult.costUsd !== undefined ? { costUsd: loopResult.costUsd } : {}),
         };
     }
     // If parsing failed entirely, check if we at least wrote files
@@ -203,6 +227,7 @@ function parseGeneratorResult(text, filesWritten, loopResult) {
             turnsUsed: loopResult.turnsUsed,
             toolsCalled: loopResult.toolsCalled,
             usage: loopResult.usage,
+            ...(loopResult.costUsd !== undefined ? { costUsd: loopResult.costUsd } : {}),
         };
     }
     return {
@@ -212,6 +237,7 @@ function parseGeneratorResult(text, filesWritten, loopResult) {
         turnsUsed: loopResult.turnsUsed,
         toolsCalled: loopResult.toolsCalled,
         usage: loopResult.usage,
+        ...(loopResult.costUsd !== undefined ? { costUsd: loopResult.costUsd } : {}),
     };
 }
 //# sourceMappingURL=generator-agent.js.map

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

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

package/dist/orchestrator/loop-events.d.ts

@@ -0,0 +1,98 @@
+import type { AgenticLoopResult } from "./agentic-loop.js";
+import type { ToolResult } from "../providers/types.js";
+/**
+ * Structured observability + interception surface for `runAgenticLoop`
+ * (agent-loop-capability-port sprint 5). Own, provider-agnostic types —
+ * never SDK types (principles.md: "Provider-agnostic interfaces"). Hooks and
+ * events run host-side and add zero tokens to the conversation.
+ */
+/**
+ * The subset of a model-requested tool call surfaced to hooks/events. Named
+ * `toolUseId` (not `id`) to read naturally alongside `ToolResult.toolUseId`,
+ * which it correlates with.
+ */
+export interface LoopToolCallInfo {
+    name: string;
+    input: unknown;
+    toolUseId: string;
+}
+/**
+ * Host-side observability event stream emitted (in order) via the optional
+ * `onEvent` callback on `AgenticLoopParams`. Consuming this stream never
+ * changes loop behavior — it is a pure observation channel.
+ */
+export type LoopEvent = {
+    type: "init";
+    model: string;
+    maxTurns: number;
+} | {
+    type: "turn-start";
+    turn: number;
+} | {
+    type: "text-delta";
+    turn: number;
+    delta: string;
+} | {
+    type: "tool-start";
+    turn: number;
+    name: string;
+    input: unknown;
+    toolUseId: string;
+} | {
+    type: "tool-end";
+    turn: number;
+    name: string;
+    toolUseId: string;
+    isError: boolean;
+} | {
+    type: "turn-end";
+    turn: number;
+    toolsCalled: string[];
+} | {
+    type: "compact-boundary";
+    turn: number;
+    /** Message count in the transcript immediately before compaction. */
+    messagesBefore: number;
+    /** Message count immediately after (head replaced by one summary). */
+    messagesAfter: number;
+    /** The per-request `response.usage.inputTokens` that crossed the threshold. */
+    inputTokensAtTrigger: number;
+} | {
+    type: "result";
+    stopReason: string;
+    turnsUsed: number;
+};
+/** Veto/allow decision returned by `LoopHooks.preToolUse`. */
+export interface HookDecision {
+    allow: boolean;
+    reason?: string;
+}
+/**
+ * Optional host-side hooks. All are plain callbacks run in the orchestrating
+ * process — never SDK types, never remote calls implied by this interface.
+ *
+ * Veto-only this sprint: `preToolUse` may deny a call, but MUST NOT mutate
+ * `call.input` (input transformation is out of scope — contract nonGoal).
+ */
+export interface LoopHooks {
+    /**
+     * Veto gate evaluated BEFORE a tool handler runs. A `{allow:false}`
+     * decision skips the handler entirely; the model receives an `isError`
+     * rejection `ToolResult` containing `reason`, and the loop continues to
+     * the next turn rather than stopping. The caller treats a throwing
+     * `preToolUse` as a deny (fail-closed) — see `runAgenticLoop`.
+     */
+    preToolUse?: (call: LoopToolCallInfo) => HookDecision | Promise<HookDecision>;
+    /**
+     * Observes a tool result after execution (allowed, denied, or errored).
+     * The caller catches and logs a throw — it never crashes the loop.
+     */
+    postToolUse?: (call: LoopToolCallInfo, result: ToolResult) => void | Promise<void>;
+    /**
+     * Observes the final `AgenticLoopResult` exactly once, on every stop path
+     * (completion, refusal, budget_exceeded, max_turns_exceeded, error). The
+     * caller catches and logs a throw — it never crashes the loop.
+     */
+    onStop?: (result: AgenticLoopResult) => void | Promise<void>;
+}
+//# sourceMappingURL=loop-events.d.ts.map

package/dist/orchestrator/loop-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-events.d.ts","sourceRoot":"","sources":["../../src/orchestrator/loop-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,CAAC;CAC9B,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9D,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9E;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}

package/dist/orchestrator/loop-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loop-events.js.map

package/dist/orchestrator/loop-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-events.js","sourceRoot":"","sources":["../../src/orchestrator/loop-events.ts"],"names":[],"mappings":""}

package/dist/orchestrator/model-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/orchestrator/model-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA2BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,gBAAgB,CAAC,EAAE,MAAM,GACxB,aAAa,CAgCf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnD"}
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/orchestrator/model-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,gBAAgB,CAAC,EAAE,MAAM,GACxB,aAAa,CAgCf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/dist/orchestrator/model-resolver.js

@@ -28,6 +28,10 @@ const SHORTHAND_MAP = {
     deepseek: { provider: "openai-compat", modelId: "deepseek-v4-pro" },
     "deepseek-v4-pro": { provider: "openai-compat", modelId: "deepseek-v4-pro" },
     "deepseek-v4-flash": { provider: "openai-compat", modelId: "deepseek-v4-flash" },
+    // Grok / xAI — resolved via openai-compat adapter at api.x.ai/v1
+    grok: { provider: "openai-compat", modelId: "grok-4" },
+    "grok-4": { provider: "openai-compat", modelId: "grok-4" },
+    "grok-4-fast": { provider: "openai-compat", modelId: "grok-4-fast" },
 };
 /**
  * Resolve a model string and optional explicit provider into a ResolvedModel.
@@ -61,12 +65,12 @@ export function resolveProviderModel(model, explicitProvider) {
     const mapped = SHORTHAND_MAP[model];
     if (mapped) {
         if (mapped.provider === "openai-compat") {
-            // openai-compat shorthands (e.g. deepseek) need an endpoint attached.
-            return {
-                provider: mapped.provider,
-                modelId: mapped.modelId,
-                endpoint: "https://api.deepseek.com",
-            };
+            // openai-compat shorthands need an endpoint attached.
+            // Grok/xAI shorthands resolve to api.x.ai/v1; DeepSeek to api.deepseek.com.
+            const endpoint = mapped.modelId.startsWith("grok")
+                ? "https://api.x.ai/v1"
+                : "https://api.deepseek.com";
+            return { provider: mapped.provider, modelId: mapped.modelId, endpoint };
         }
         return { provider: mapped.provider, modelId: mapped.modelId };
     }

package/dist/orchestrator/model-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/orchestrator/model-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;GAGG;AACH,MAAM,aAAa,GAA0D;IAC3E,YAAY;IACZ,IAAI,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE;IAC3D,UAAU,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,iBAAiB;IACpF,UAAU,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,qBAAqB;IACxF,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,EAAE;IAC/D,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE;IAC7D,SAAS;IACT,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;IACrD,cAAc,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE;IAC/D,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;IACzC,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;IACrD,SAAS;IACT,YAAY,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE;IAC/D,cAAc,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;IACnE,oEAAoE;IACpE,QAAQ,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,EAAE;IACnE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,EAAE;IAC5E,mBAAmB,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,EAAE;CACjF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,gBAAyB;IAEzB,oEAAoE;IACpE,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACxD,CAAC;IAED,qDAAqD;IACrD,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO;YACL,QAAQ,EAAE,eAAe;YACzB,OAAO;YACP,QAAQ,EAAE,2BAA2B;SACtC,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;YACxC,sEAAsE;YACtE,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,0BAA0B;aACrC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAChE,CAAC;IAED,+DAA+D;IAC/D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/orchestrator/model-resolver.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/pipeline.d.ts

@@ -43,7 +43,16 @@ export interface SprintCycleResult {
  * Exported for direct unit testing (sc-4-6/sc-4-7).
  */
 export declare function injectGuidanceIntoHandoff(handoff: ContextHandoff, guidanceTexts: string[]): ContextHandoff;
-export declare function runSprintCycle(contract: SprintContract, spec: PlanSpec, completedContracts: SprintContract[], projectRoot: string, config: BoberConfig, projectContext: ProjectContext, pipelineRunId?: string): Promise<SprintCycleResult>;
+export interface RunSprintCycleParams {
+    contract: SprintContract;
+    spec: PlanSpec;
+    completedContracts: SprintContract[];
+    projectRoot: string;
+    config: BoberConfig;
+    projectContext: ProjectContext;
+    pipelineRunId?: string;
+}
+export declare function runSprintCycle(params: RunSprintCycleParams): Promise<SprintCycleResult>;
 /**
  * Run the complete orchestration pipeline:
  *

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/orchestrator/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAMrE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA+B5D,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;IACjB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAiDD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,EAAE,GACtB,cAAc,CAShB;AAID,wBAAsB,cAAc,CAClC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,kBAAkB,EAAE,cAAc,EAAE,EACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,cAAc,EAC9B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CA4a5B;AAID;;;;;;;;;;GAUG;AACH;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,cAAc,CAAC,CA6UzB;AAQD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,cAAc,CAAC,CAezB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/orchestrator/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAMrE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiC5D,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;IACjB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAiDD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,EAAE,GACtB,cAAc,CAShB;AAID,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAmhB5B;AAID;;;;;;;;;;GAUG;AACH;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,cAAc,CAAC,CA6UzB;AAQD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,cAAc,CAAC,CAezB"}

package/dist/orchestrator/pipeline.js

@@ -12,6 +12,7 @@ import { runGenerator } from "./generator-agent.js";
 import { runEvaluatorAgent } from "./evaluator-agent.js";
 import { runCodeReviewer } from "./code-reviewer-agent.js";
 import { runDocumenter } from "./documenter-agent.js";
+import { evaluateSecurityGate, renderSecurityFeedback } from "./security-gate.js";
 import { getCheckpointMechanismFor } from "./checkpoints/index.js";
 // NOTE (Sprint 12): The feedback-router (src/orchestrator/checkpoints/feedback-router.ts)
 // provides runCheckpointWithFeedback() for full iteration + abort semantics.
@@ -83,8 +84,8 @@ export function injectGuidanceIntoHandoff(handoff, guidanceTexts) {
         ],
     };
 }
-// ── Sprint cycle ───────────────────────────────────────────────────
-export async function runSprintCycle(contract, spec, completedContracts, projectRoot, config, projectContext, pipelineRunId) {
+export async function runSprintCycle(params) {
+    const { contract, spec, completedContracts, projectRoot, config, projectContext, pipelineRunId } = params;
     const maxIterations = config.evaluator.maxIterations;
     let currentContract = updateContractStatus(contract, "in-progress");
     await updateContract(projectRoot, currentContract);
@@ -96,6 +97,10 @@ export async function runSprintCycle(contract, spec, completedContracts, project
     const configuredMechanismName = config.pipeline?.checkpointMechanism ?? "noop";
     let lastEvaluation;
     let lastGeneratorResult;
+    // Sprint 3 — security-audit-agent-team: findings from a blocked security
+    // round, routed into the NEXT iteration's evalFeedbackParts (ADR-5). Stays
+    // empty when the gate never runs (config.security absent/disabled).
+    let pendingSecurityFeedback = [];
     // ── Curate (once, before the first generator attempt) ─────────
     // The curator explores the codebase and saves a Sprint Briefing to
     // .bober/briefings/<contractId>-briefing.md. The generator reads it
@@ -164,6 +169,13 @@ export async function runSprintCycle(contract, spec, completedContracts, project
                 }
             }
         }
+        // Sprint 3 — feed a prior blocked security round's findings into THIS
+        // iteration's generator handoff via the same channel evaluator feedback
+        // uses (ADR-5). No-op when the gate has never blocked.
+        if (pendingSecurityFeedback.length > 0) {
+            evalFeedbackParts.push(...pendingSecurityFeedback);
+            pendingSecurityFeedback = [];
+        }
         // Summarize older sprints to save context
         const completedSummaryHandoff = createHandoff({
             from: iteration === 1 ? "planner" : "evaluator",
@@ -287,6 +299,78 @@ export async function runSprintCycle(contract, spec, completedContracts, project
         // of only surfacing the aggregate "N/M evaluators passed" summary. Best-effort.
         await persistEvalResult(projectRoot, currentContract.contractId, iteration, evaluation);
         if (evaluation.passed) {
+            // Sprint 3 — fail-closed SecurityAuditGate (ADR-2). Attached BEFORE the
+            // sprint is marked passed. When config.security is absent (the common
+            // case) or enabled !== true, this branch never executes — the pipeline
+            // is byte-identical to the pre-gate behavior (sc-3-4).
+            if (config.security?.enabled === true) {
+                const securityVerdict = await evaluateSecurityGate({
+                    contract: currentContract,
+                    evaluation,
+                    projectRoot,
+                    config,
+                });
+                if (securityVerdict.blocked) {
+                    logger.error(`Sprint ${currentContract.contractId} blocked by security audit (${securityVerdict.reason}).`);
+                    const securityFeedback = renderSecurityFeedback(securityVerdict);
+                    currentContract = {
+                        ...currentContract,
+                        evaluatorFeedback: securityFeedback.join("\n") ||
+                            `Security audit blocked this sprint (${securityVerdict.reason}).`,
+                    };
+                    await updateContract(projectRoot, currentContract);
+                    // The auditor always constructs review.critical from SecurityFinding
+                    // objects (security-auditor-agent.ts), a superset of the locked
+                    // ReviewFinding shape — safe to narrow here to read vulnClass.
+                    const criticalFindings = (securityVerdict.result?.review.critical ??
+                        []);
+                    await appendHistory(projectRoot, {
+                        timestamp: new Date().toISOString(),
+                        event: "security-audit-blocked",
+                        phase: "rework",
+                        sprintId: currentContract.contractId,
+                        details: {
+                            reason: securityVerdict.reason,
+                            critical: criticalFindings.length,
+                            findings: criticalFindings.slice(0, 20).map((f) => ({
+                                path: f.evidence[0]?.path ?? "unknown",
+                                line: f.evidence[0]?.line ?? 0,
+                                ...(f.vulnClass ? { vulnClass: f.vulnClass } : {}),
+                            })),
+                        },
+                    });
+                    // ADR-5: route findings into the generator's NEXT iteration via the
+                    // same feedback channel evaluator feedback uses (evalFeedbackParts).
+                    pendingSecurityFeedback = securityFeedback;
+                    // Mirror the evaluation-failed retry tail (pipeline.ts eval-failed
+                    // block below): retry telemetry when iterations remain, otherwise
+                    // needs-rework at maxIterations. Documenter/code-review are NEVER
+                    // reached on a block — control returns/continues before :465 (ADR-6).
+                    if (iteration < maxIterations) {
+                        void emit(projectRoot, config, "sprint-fail-retry", {
+                            runId: sprintRunId,
+                            sprintId: currentContract.contractId,
+                            iteration,
+                            retryCount: iteration,
+                        });
+                    }
+                    if (iteration >= maxIterations) {
+                        currentContract = updateContractStatus(currentContract, "needs-rework");
+                        await updateContract(projectRoot, currentContract);
+                        return { contract: currentContract, evaluation, generatorResult: lastGeneratorResult };
+                    }
+                    logger.info("Feeding security audit feedback into next iteration...");
+                    continue;
+                }
+                // Clean — record and fall through to the existing passed block.
+                await appendHistory(projectRoot, {
+                    timestamp: new Date().toISOString(),
+                    event: "security-audit-clean",
+                    phase: "complete",
+                    sprintId: currentContract.contractId,
+                    details: { reason: securityVerdict.reason },
+                });
+            }
             logger.success(`Sprint ${currentContract.contractId} passed all evaluations!`);
             currentContract = updateContractStatus(currentContract, "passed");
             currentContract = {
@@ -299,7 +383,13 @@ export async function runSprintCycle(contract, spec, completedContracts, project
                 event: "sprint-passed",
                 phase: "complete",
                 sprintId: currentContract.contractId,
-                details: { iteration, feedback: evaluation.summary },
+                details: {
+                    iteration,
+                    feedback: evaluation.summary,
+                    ...(lastGeneratorResult?.costUsd !== undefined
+                        ? { costUsd: lastGeneratorResult.costUsd }
+                        : {}),
+                },
             });
             // Sprint 28 — telemetry (fire-and-forget, never throws to pipeline)
             void emit(projectRoot, config, "sprint-pass", {
@@ -660,7 +750,15 @@ export async function runTsPipeline(userPrompt, projectRoot, config, opts) {
             }
             const contract = contracts[i];
             logger.progress(i + 1, maxSprints, contract.title);
-            const result = await runSprintCycle(contract, spec, completedSprints, projectRoot, config, projectContext, pipelineRunId);
+            const result = await runSprintCycle({
+                contract,
+                spec,
+                completedContracts: completedSprints,
+                projectRoot,
+                config,
+                projectContext,
+                pipelineRunId,
+            });
             if (result.contract.status === "passed") {
                 completedSprints.push(result.contract);
             }