agent-bober 0.17.1 → 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/context-handoff.d.ts

@@ -9,13 +9,13 @@ export declare const DecisionSchema: z.ZodObject<{
     rationale: z.ZodString;
     madeBy: z.ZodEnum<["planner", "generator", "evaluator", "human"]>;
 }, "strip", z.ZodTypeAny, {
-    description: string;
     timestamp: string;
+    description: string;
     rationale: string;
     madeBy: "planner" | "generator" | "evaluator" | "human";
 }, {
-    description: string;
     timestamp: string;
+    description: string;
     rationale: string;
     madeBy: "planner" | "generator" | "evaluator" | "human";
 }>;
@@ -27,14 +27,14 @@ export declare const ProjectContextSchema: z.ZodObject<{
     entryPoints: z.ZodArray<z.ZodString, "many">;
     currentBranch: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     type: string;
+    name: string;
     techStack: string[];
     entryPoints: string[];
     currentBranch: string;
 }, {
-    name: string;
     type: string;
+    name: string;
     techStack: string[];
     entryPoints: string[];
     currentBranch: string;
@@ -51,14 +51,14 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         entryPoints: z.ZodArray<z.ZodString, "many">;
         currentBranch: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        name: string;
         type: string;
+        name: string;
         techStack: string[];
         entryPoints: string[];
         currentBranch: string;
     }, {
-        name: string;
         type: string;
+        name: string;
         techStack: string[];
         entryPoints: string[];
         currentBranch: string;
@@ -86,7 +86,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
             dependencies: string[];
-            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedComplexity?: "high" | "medium" | "low" | undefined;
             estimatedSprints?: number | undefined;
         }, {
             description: string;
@@ -95,7 +95,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
             dependencies?: string[] | undefined;
-            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedComplexity?: "high" | "medium" | "low" | undefined;
             estimatedSprints?: number | undefined;
         }>, "many">;
         assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -118,8 +118,8 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             recommendation: z.ZodOptional<z.ZodString>;
             ambiguityWeight: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            questionId: string;
             category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+            questionId: string;
             question: string;
             options?: {
                 description: string;
@@ -128,8 +128,8 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             recommendation?: string | undefined;
             ambiguityWeight?: number | undefined;
         }, {
-            questionId: string;
             category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+            questionId: string;
             question: string;
             options?: {
                 description: string;
@@ -144,15 +144,15 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             resolvedAt: z.ZodString;
             resolvedBy: z.ZodDefault<z.ZodEnum<["user", "planner"]>>;
         }, "strip", z.ZodTypeAny, {
-            questionId: string;
             answer: string;
+            questionId: string;
             resolvedAt: string;
-            resolvedBy: "planner" | "user";
+            resolvedBy: "user" | "planner";
         }, {
-            questionId: string;
             answer: string;
+            questionId: string;
             resolvedAt: string;
-            resolvedBy?: "planner" | "user" | undefined;
+            resolvedBy?: "user" | "planner" | undefined;
         }>, "many">>;
         techStack: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         techNotes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -164,8 +164,9 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         updatedAt: z.ZodString;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        createdAt: string;
+        status: "completed" | "draft" | "needs-clarification" | "ready" | "in-progress" | "abandoned";
         mode: "greenfield" | "brownfield";
-        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
         specId: string;
         version: number;
@@ -177,14 +178,14 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
             dependencies: string[];
-            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedComplexity?: "high" | "medium" | "low" | undefined;
             estimatedSprints?: number | undefined;
         }[];
         assumptions: string[];
         outOfScope: string[];
         clarificationQuestions: {
-            questionId: string;
             category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+            questionId: string;
             question: string;
             options?: {
                 description: string;
@@ -194,15 +195,14 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             ambiguityWeight?: number | undefined;
         }[];
         resolvedClarifications: {
-            questionId: string;
             answer: string;
+            questionId: string;
             resolvedAt: string;
-            resolvedBy: "planner" | "user";
+            resolvedBy: "user" | "planner";
         }[];
         techStack: string[];
         nonFunctionalRequirements: unknown[];
         constraints: string[];
-        createdAt: string;
         updatedAt: string;
         ambiguityScore?: number | undefined;
         techNotes?: Record<string, unknown> | undefined;
@@ -210,8 +210,9 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         metadata?: Record<string, unknown> | undefined;
         completedAt?: string | undefined;
     }, {
+        createdAt: string;
+        status: "completed" | "draft" | "needs-clarification" | "ready" | "in-progress" | "abandoned";
         mode: "greenfield" | "brownfield";
-        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
         specId: string;
         title: string;
@@ -222,18 +223,17 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
             dependencies?: string[] | undefined;
-            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedComplexity?: "high" | "medium" | "low" | undefined;
             estimatedSprints?: number | undefined;
         }[];
-        createdAt: string;
         updatedAt: string;
         version?: number | undefined;
         assumptions?: string[] | undefined;
         outOfScope?: string[] | undefined;
         ambiguityScore?: number | undefined;
         clarificationQuestions?: {
-            questionId: string;
             category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+            questionId: string;
             question: string;
             options?: {
                 description: string;
@@ -243,10 +243,10 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             ambiguityWeight?: number | undefined;
         }[] | undefined;
         resolvedClarifications?: {
-            questionId: string;
             answer: string;
+            questionId: string;
             resolvedAt: string;
-            resolvedBy?: "planner" | "user" | undefined;
+            resolvedBy?: "user" | "planner" | undefined;
         }[] | undefined;
         techStack?: string[] | undefined;
         techNotes?: Record<string, unknown> | undefined;
@@ -300,7 +300,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         startedAt: z.ZodOptional<z.ZodString>;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -321,8 +321,8 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         definitionOfDone: string;
         estimatedFiles: string[];
         iterationHistory: unknown[];
-        ambiguityScore?: number | undefined;
         createdAt?: string | undefined;
+        ambiguityScore?: number | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         generatorNotes?: string | undefined;
@@ -333,7 +333,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
     }, {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -348,11 +348,11 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         nonGoals: string[];
         stopConditions: string[];
         definitionOfDone: string;
+        createdAt?: string | undefined;
         features?: string[] | undefined;
         assumptions?: string[] | undefined;
         outOfScope?: string[] | undefined;
         ambiguityScore?: number | undefined;
-        createdAt?: string | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         dependsOn?: string[] | undefined;
@@ -410,7 +410,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         startedAt: z.ZodOptional<z.ZodString>;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -431,8 +431,8 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         definitionOfDone: string;
         estimatedFiles: string[];
         iterationHistory: unknown[];
-        ambiguityScore?: number | undefined;
         createdAt?: string | undefined;
+        ambiguityScore?: number | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         generatorNotes?: string | undefined;
@@ -443,7 +443,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
     }, {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -458,11 +458,11 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         nonGoals: string[];
         stopConditions: string[];
         definitionOfDone: string;
+        createdAt?: string | undefined;
         features?: string[] | undefined;
         assumptions?: string[] | undefined;
         outOfScope?: string[] | undefined;
         ambiguityScore?: number | undefined;
-        createdAt?: string | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         dependsOn?: string[] | undefined;
@@ -484,13 +484,13 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         rationale: z.ZodString;
         madeBy: z.ZodEnum<["planner", "generator", "evaluator", "human"]>;
     }, "strip", z.ZodTypeAny, {
-        description: string;
         timestamp: string;
+        description: string;
         rationale: string;
         madeBy: "planner" | "generator" | "evaluator" | "human";
     }, {
-        description: string;
         timestamp: string;
+        description: string;
         rationale: string;
         madeBy: "planner" | "generator" | "evaluator" | "human";
     }>, "many">;
@@ -501,15 +501,16 @@ export declare const ContextHandoffSchema: z.ZodObject<{
     from: "planner" | "generator" | "evaluator" | "human";
     to: "planner" | "generator" | "evaluator" | "human";
     projectContext: {
-        name: string;
         type: string;
+        name: string;
         techStack: string[];
         entryPoints: string[];
         currentBranch: string;
     };
     spec: {
+        createdAt: string;
+        status: "completed" | "draft" | "needs-clarification" | "ready" | "in-progress" | "abandoned";
         mode: "greenfield" | "brownfield";
-        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
         specId: string;
         version: number;
@@ -521,14 +522,14 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
             dependencies: string[];
-            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedComplexity?: "high" | "medium" | "low" | undefined;
             estimatedSprints?: number | undefined;
         }[];
         assumptions: string[];
         outOfScope: string[];
         clarificationQuestions: {
-            questionId: string;
             category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+            questionId: string;
             question: string;
             options?: {
                 description: string;
@@ -538,15 +539,14 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             ambiguityWeight?: number | undefined;
         }[];
         resolvedClarifications: {
-            questionId: string;
             answer: string;
+            questionId: string;
             resolvedAt: string;
-            resolvedBy: "planner" | "user";
+            resolvedBy: "user" | "planner";
         }[];
         techStack: string[];
         nonFunctionalRequirements: unknown[];
         constraints: string[];
-        createdAt: string;
         updatedAt: string;
         ambiguityScore?: number | undefined;
         techNotes?: Record<string, unknown> | undefined;
@@ -555,7 +555,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         completedAt?: string | undefined;
     };
     sprintHistory: {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -576,8 +576,8 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         definitionOfDone: string;
         estimatedFiles: string[];
         iterationHistory: unknown[];
-        ambiguityScore?: number | undefined;
         createdAt?: string | undefined;
+        ambiguityScore?: number | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         generatorNotes?: string | undefined;
@@ -591,13 +591,13 @@ export declare const ContextHandoffSchema: z.ZodObject<{
     instructions: string;
     changedFiles: string[];
     decisions: {
-        description: string;
         timestamp: string;
+        description: string;
         rationale: string;
         madeBy: "planner" | "generator" | "evaluator" | "human";
     }[];
     currentContract?: {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -618,8 +618,8 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         definitionOfDone: string;
         estimatedFiles: string[];
         iterationHistory: unknown[];
-        ambiguityScore?: number | undefined;
         createdAt?: string | undefined;
+        ambiguityScore?: number | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         generatorNotes?: string | undefined;
@@ -636,15 +636,16 @@ export declare const ContextHandoffSchema: z.ZodObject<{
     from: "planner" | "generator" | "evaluator" | "human";
     to: "planner" | "generator" | "evaluator" | "human";
     projectContext: {
-        name: string;
         type: string;
+        name: string;
         techStack: string[];
         entryPoints: string[];
         currentBranch: string;
     };
     spec: {
+        createdAt: string;
+        status: "completed" | "draft" | "needs-clarification" | "ready" | "in-progress" | "abandoned";
         mode: "greenfield" | "brownfield";
-        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
         specId: string;
         title: string;
@@ -655,18 +656,17 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
             dependencies?: string[] | undefined;
-            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedComplexity?: "high" | "medium" | "low" | undefined;
             estimatedSprints?: number | undefined;
         }[];
-        createdAt: string;
         updatedAt: string;
         version?: number | undefined;
         assumptions?: string[] | undefined;
         outOfScope?: string[] | undefined;
         ambiguityScore?: number | undefined;
         clarificationQuestions?: {
-            questionId: string;
             category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+            questionId: string;
             question: string;
             options?: {
                 description: string;
@@ -676,10 +676,10 @@ export declare const ContextHandoffSchema: z.ZodObject<{
             ambiguityWeight?: number | undefined;
         }[] | undefined;
         resolvedClarifications?: {
-            questionId: string;
             answer: string;
+            questionId: string;
             resolvedAt: string;
-            resolvedBy?: "planner" | "user" | undefined;
+            resolvedBy?: "user" | "planner" | undefined;
         }[] | undefined;
         techStack?: string[] | undefined;
         techNotes?: Record<string, unknown> | undefined;
@@ -690,7 +690,7 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         completedAt?: string | undefined;
     };
     sprintHistory: {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -705,11 +705,11 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         nonGoals: string[];
         stopConditions: string[];
         definitionOfDone: string;
+        createdAt?: string | undefined;
         features?: string[] | undefined;
         assumptions?: string[] | undefined;
         outOfScope?: string[] | undefined;
         ambiguityScore?: number | undefined;
-        createdAt?: string | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         dependsOn?: string[] | undefined;
@@ -726,13 +726,13 @@ export declare const ContextHandoffSchema: z.ZodObject<{
     instructions: string;
     changedFiles: string[];
     decisions: {
-        description: string;
         timestamp: string;
+        description: string;
         rationale: string;
         madeBy: "planner" | "generator" | "evaluator" | "human";
     }[];
     currentContract?: {
-        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+        status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
         description: string;
         specId: string;
         title: string;
@@ -747,11 +747,11 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         nonGoals: string[];
         stopConditions: string[];
         definitionOfDone: string;
+        createdAt?: string | undefined;
         features?: string[] | undefined;
         assumptions?: string[] | undefined;
         outOfScope?: string[] | undefined;
         ambiguityScore?: number | undefined;
-        createdAt?: string | undefined;
         updatedAt?: string | undefined;
         completedAt?: string | undefined;
         dependsOn?: string[] | undefined;

package/dist/orchestrator/contract-materialization.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Materialize sprint contracts from a plan spec's feature list.
+ *
+ * Extracted verbatim from the runTsPipeline inline loop so that both the run
+ * pipeline AND the standalone `plan` command (Sprint 2) share one source of
+ * truth. Contract content is feature-derived; ids are deterministic and
+ * zero-padded as `sprint-<specId>-NN` so listContracts() lexical ordering
+ * matches sprint execution order.
+ *
+ * These auto-generated contracts use placeholder precision fields;
+ * a planner-authored contract (saved directly by the bober-planner
+ * subagent) supersedes them with substantive nonGoals, stopConditions,
+ * and definitionOfDone.
+ *
+ * The post-plan and post-sprint-contract audit checkpoints are pipeline
+ * concerns and live in pipeline.ts — NOT here. This helper has zero
+ * runWithAudit / appendHistory / checkpoint references.
+ */
+import type { BoberConfig } from "../config/schema.js";
+import type { PlanSpec } from "../contracts/spec.js";
+import type { SprintContract } from "../contracts/sprint-contract.js";
+/**
+ * Create and persist one SprintContract per feature in spec.features.
+ *
+ * Contract content is derived from feature fields. Ids are set to
+ * `sprint-<specId>-NN` (width-2 zero-padded) after construction so
+ * listContracts() lexical sort equals sprint execution order.
+ *
+ * Returns the contracts array in feature / sprintNumber order so the caller
+ * can pass it to the post-sprint-contract checkpoint and the sprint loop.
+ */
+export declare function materializeContracts(spec: PlanSpec, projectRoot: string, config: BoberConfig): Promise<SprintContract[]>;
+//# sourceMappingURL=contract-materialization.d.ts.map

package/dist/orchestrator/contract-materialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-materialization.d.ts","sourceRoot":"","sources":["../../src/orchestrator/contract-materialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,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;AAMtE;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CA6F3B"}