agent-bober 0.17.1 → 0.18.0

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"}

package/dist/orchestrator/contract-materialization.js

@@ -0,0 +1,113 @@
+/**
+ * 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 { createContract, SprintContractSchema } from "../contracts/sprint-contract.js";
+import { generateContractPrecision } from "./planner-agent.js";
+import { saveContract } from "../state/index.js";
+import { logger } from "../utils/logger.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 async function materializeContracts(spec, projectRoot, config) {
+    // ── Embedded branch: prefer valid spec.sprints when present ──────────
+    // Real bober-authored specs have string sprints (ids) — safeParse fails
+    // those and falls through to the feature-derived branch below.
+    // External/planner-authored specs may carry full contract objects here.
+    if (Array.isArray(spec.sprints) && spec.sprints.length > 0) {
+        const embedded = [];
+        let allParsed = true;
+        for (let i = 0; i < spec.sprints.length; i++) {
+            const parsed = SprintContractSchema.safeParse(spec.sprints[i]);
+            if (!parsed.success) {
+                allParsed = false;
+                logger.warn(`Embedded spec.sprints[${i}] failed schema validation; falling back to feature-derived contracts for the whole spec.`);
+                break;
+            }
+            const contract = parsed.data;
+            contract.status = "proposed";
+            contract.specId = spec.specId;
+            contract.sprintNumber = i + 1;
+            // bober: width-2 pad covers 1–99; widen to 3 if suite grows past 99.
+            contract.contractId = `sprint-${spec.specId}-${String(i + 1).padStart(2, "0")}`;
+            embedded.push(contract);
+        }
+        if (allParsed && embedded.length > 0) {
+            try {
+                for (const c of embedded) {
+                    await saveContract(projectRoot, c);
+                }
+                return embedded;
+            }
+            catch (err) {
+                logger.warn(`Embedded sprints failed the precision gate; falling back to feature-derived contracts: ${err instanceof Error ? err.message : String(err)}`);
+                // fall through to feature-derived loop
+            }
+        }
+    }
+    // ── Feature-derived branch (fallback and default path) ───────────────
+    const contracts = [];
+    for (let i = 0; i < spec.features.length; i++) {
+        const feature = spec.features[i];
+        // Generate substantive precision fields (nonGoals/stopConditions/
+        // definitionOfDone) so the contract passes the generator's BLOCKING
+        // precision preflight. Without this the standalone pipeline emits
+        // placeholder contracts that every generator (Claude or DeepSeek) refuses.
+        const precision = await generateContractPrecision(feature, spec, config);
+        if (precision) {
+            logger.info(`Generated precision fields for sprint ${i + 1} (${precision.nonGoals.length} non-goals, ${precision.stopConditions.length} stop conditions).`);
+        }
+        else {
+            logger.warn(`Could not generate precision fields for sprint ${i + 1}; contract will use placeholders and the generator may block it.`);
+        }
+        const contract = createContract(feature.title, feature.description, feature.acceptanceCriteria.map((ac, idx) => ({
+            criterionId: `${feature.featureId}-criterion-${idx + 1}`,
+            description: ac,
+            verificationMethod: "agent-evaluation",
+        })), {
+            specId: spec.specId,
+            sprintNumber: i + 1,
+            features: [feature.featureId],
+            ...(precision
+                ? {
+                    nonGoals: precision.nonGoals,
+                    stopConditions: precision.stopConditions,
+                    definitionOfDone: precision.definitionOfDone,
+                }
+                : {}),
+        });
+        // createContract doesn't take assumptions/outOfScope; set them directly.
+        if (precision) {
+            contract.assumptions = precision.assumptions;
+            contract.outOfScope = precision.outOfScope;
+        }
+        // Deterministic, zero-padded id: lexical order == execution order.
+        // bober: width-2 pad covers 1–99 sprints; widen to 3 if suite grows past 99.
+        contract.contractId = `sprint-${spec.specId}-${String(i + 1).padStart(2, "0")}`;
+        contracts.push(contract);
+        await saveContract(projectRoot, contract);
+    }
+    return contracts;
+}
+//# sourceMappingURL=contract-materialization.js.map

package/dist/orchestrator/contract-materialization.js.map

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