agent-bober 0.11.6 → 0.12.0

package/dist/orchestrator/context-handoff.d.ts

@@ -64,253 +64,417 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         currentBranch: string;
     }>;
     spec: z.ZodObject<{
-        id: z.ZodString;
+        specId: z.ZodString;
+        version: z.ZodDefault<z.ZodNumber>;
         title: z.ZodString;
         description: z.ZodString;
-        projectType: z.ZodString;
-        techStack: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<["draft", "needs-clarification", "ready", "in-progress", "completed", "abandoned"]>;
+        mode: z.ZodEnum<["greenfield", "brownfield"]>;
         features: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
+            featureId: z.ZodString;
             title: z.ZodString;
             description: z.ZodString;
-            priority: z.ZodEnum<["must", "should", "could"]>;
-            estimatedSprints: z.ZodNumber;
+            priority: z.ZodEnum<["must-have", "should-have", "nice-to-have"]>;
             acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
+            dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            estimatedComplexity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+            estimatedSprints: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             description: string;
-            id: string;
             title: string;
-            priority: "must" | "should" | "could";
-            estimatedSprints: number;
+            featureId: string;
+            priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
+            dependencies: string[];
+            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedSprints?: number | undefined;
         }, {
             description: string;
-            id: string;
             title: string;
-            priority: "must" | "should" | "could";
-            estimatedSprints: number;
+            featureId: string;
+            priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
+            dependencies?: string[] | undefined;
+            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedSprints?: number | undefined;
         }>, "many">;
-        nonFunctional: z.ZodArray<z.ZodString, "many">;
-        constraints: z.ZodArray<z.ZodString, "many">;
+        assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        outOfScope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        ambiguityScore: z.ZodOptional<z.ZodNumber>;
+        clarificationQuestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            questionId: z.ZodString;
+            category: z.ZodEnum<["scope", "user-personas", "data-model", "tech-constraints", "design-ux", "integrations", "non-functional", "error-handling", "integration-risk", "pattern-conflict", "regression-risk", "other"]>;
+            question: z.ZodString;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                description: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                label: string;
+            }, {
+                description: string;
+                label: string;
+            }>, "many">>;
+            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";
+            question: string;
+            options?: {
+                description: string;
+                label: string;
+            }[] | undefined;
+            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";
+            question: string;
+            options?: {
+                description: string;
+                label: string;
+            }[] | undefined;
+            recommendation?: string | undefined;
+            ambiguityWeight?: number | undefined;
+        }>, "many">>;
+        resolvedClarifications: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            questionId: z.ZodString;
+            answer: z.ZodString;
+            resolvedAt: z.ZodString;
+            resolvedBy: z.ZodDefault<z.ZodEnum<["user", "planner"]>>;
+        }, "strip", z.ZodTypeAny, {
+            questionId: string;
+            answer: string;
+            resolvedAt: string;
+            resolvedBy: "planner" | "user";
+        }, {
+            questionId: string;
+            answer: string;
+            resolvedAt: string;
+            resolvedBy?: "planner" | "user" | undefined;
+        }>, "many">>;
+        techStack: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        techNotes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        nonFunctionalRequirements: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+        constraints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        sprints: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
+        completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        mode: "greenfield" | "brownfield";
+        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
-        id: string;
+        specId: string;
+        version: number;
         title: string;
-        projectType: string;
-        techStack: string[];
         features: {
             description: string;
-            id: string;
             title: string;
-            priority: "must" | "should" | "could";
-            estimatedSprints: number;
+            featureId: string;
+            priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
+            dependencies: string[];
+            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedSprints?: number | undefined;
         }[];
-        nonFunctional: string[];
+        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";
+            question: string;
+            options?: {
+                description: string;
+                label: string;
+            }[] | undefined;
+            recommendation?: string | undefined;
+            ambiguityWeight?: number | undefined;
+        }[];
+        resolvedClarifications: {
+            questionId: string;
+            answer: string;
+            resolvedAt: string;
+            resolvedBy: "planner" | "user";
+        }[];
+        techStack: string[];
+        nonFunctionalRequirements: unknown[];
         constraints: string[];
         createdAt: string;
         updatedAt: string;
+        ambiguityScore?: number | undefined;
+        techNotes?: Record<string, unknown> | undefined;
+        sprints?: unknown[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        completedAt?: string | undefined;
     }, {
+        mode: "greenfield" | "brownfield";
+        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
-        id: string;
+        specId: string;
         title: string;
-        projectType: string;
-        techStack: string[];
         features: {
             description: string;
-            id: string;
             title: string;
-            priority: "must" | "should" | "could";
-            estimatedSprints: number;
+            featureId: string;
+            priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
+            dependencies?: string[] | undefined;
+            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedSprints?: number | undefined;
         }[];
-        nonFunctional: string[];
-        constraints: string[];
         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";
+            question: string;
+            options?: {
+                description: string;
+                label: string;
+            }[] | undefined;
+            recommendation?: string | undefined;
+            ambiguityWeight?: number | undefined;
+        }[] | undefined;
+        resolvedClarifications?: {
+            questionId: string;
+            answer: string;
+            resolvedAt: string;
+            resolvedBy?: "planner" | "user" | undefined;
+        }[] | undefined;
+        techStack?: string[] | undefined;
+        techNotes?: Record<string, unknown> | undefined;
+        nonFunctionalRequirements?: unknown[] | undefined;
+        constraints?: string[] | undefined;
+        sprints?: unknown[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        completedAt?: string | undefined;
     }>;
     currentContract: z.ZodOptional<z.ZodObject<{
-        id: z.ZodString;
-        feature: z.ZodString;
+        contractId: z.ZodString;
+        specId: z.ZodString;
+        sprintNumber: z.ZodNumber;
+        title: z.ZodString;
         description: z.ZodString;
+        status: z.ZodEnum<["proposed", "negotiating", "agreed", "in-progress", "evaluating", "passed", "failed", "needs-rework", "completed"]>;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        features: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         successCriteria: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            description: z.ZodString;
-            verificationMethod: z.ZodString;
-            passed: z.ZodBoolean;
-            notes: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }, {
-            description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }>, "many">;
-        expectedChanges: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            action: z.ZodEnum<["create", "modify", "delete"]>;
+            criterionId: z.ZodString;
             description: z.ZodString;
+            verificationMethod: z.ZodEnum<["manual", "typecheck", "lint", "unit-test", "playwright", "api-check", "build", "agent-evaluation"]>;
+            required: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
-            path: string;
             description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }, {
-            path: string;
             description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }>, "many">;
-        dependsOn: z.ZodArray<z.ZodString, "many">;
-        status: z.ZodEnum<["proposed", "negotiating", "agreed", "in-progress", "evaluating", "passed", "failed", "needs-rework"]>;
-        evalResults: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        nonGoals: z.ZodArray<z.ZodString, "many">;
+        stopConditions: z.ZodArray<z.ZodString, "many">;
+        definitionOfDone: z.ZodString;
+        assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        outOfScope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        ambiguityScore: z.ZodOptional<z.ZodNumber>;
         generatorNotes: z.ZodOptional<z.ZodString>;
+        evaluatorNotes: z.ZodOptional<z.ZodString>;
+        estimatedFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        estimatedDuration: z.ZodOptional<z.ZodEnum<["small", "medium", "large"]>>;
         evaluatorFeedback: z.ZodOptional<z.ZodString>;
+        iterationHistory: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+        lastEvalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        evalResults: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
         startedAt: z.ZodOptional<z.ZodString>;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        features: string[];
+        assumptions: string[];
+        outOfScope: string[];
+        contractId: string;
+        sprintNumber: number;
+        dependsOn: string[];
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        estimatedFiles: string[];
+        iterationHistory: unknown[];
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     }, {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        contractId: string;
+        sprintNumber: number;
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        features?: string[] | undefined;
+        assumptions?: string[] | undefined;
+        outOfScope?: string[] | undefined;
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
+        dependsOn?: string[] | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedFiles?: string[] | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        iterationHistory?: unknown[] | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     }>>;
     sprintHistory: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        feature: z.ZodString;
+        contractId: z.ZodString;
+        specId: z.ZodString;
+        sprintNumber: z.ZodNumber;
+        title: z.ZodString;
         description: z.ZodString;
+        status: z.ZodEnum<["proposed", "negotiating", "agreed", "in-progress", "evaluating", "passed", "failed", "needs-rework", "completed"]>;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        features: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         successCriteria: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
+            criterionId: z.ZodString;
             description: z.ZodString;
-            verificationMethod: z.ZodString;
-            passed: z.ZodBoolean;
-            notes: z.ZodOptional<z.ZodString>;
+            verificationMethod: z.ZodEnum<["manual", "typecheck", "lint", "unit-test", "playwright", "api-check", "build", "agent-evaluation"]>;
+            required: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }, {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }>, "many">;
-        expectedChanges: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            action: z.ZodEnum<["create", "modify", "delete"]>;
-            description: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
-        }, {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
-        }>, "many">;
-        dependsOn: z.ZodArray<z.ZodString, "many">;
-        status: z.ZodEnum<["proposed", "negotiating", "agreed", "in-progress", "evaluating", "passed", "failed", "needs-rework"]>;
-        evalResults: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        nonGoals: z.ZodArray<z.ZodString, "many">;
+        stopConditions: z.ZodArray<z.ZodString, "many">;
+        definitionOfDone: z.ZodString;
+        assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        outOfScope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        ambiguityScore: z.ZodOptional<z.ZodNumber>;
         generatorNotes: z.ZodOptional<z.ZodString>;
+        evaluatorNotes: z.ZodOptional<z.ZodString>;
+        estimatedFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        estimatedDuration: z.ZodOptional<z.ZodEnum<["small", "medium", "large"]>>;
         evaluatorFeedback: z.ZodOptional<z.ZodString>;
+        iterationHistory: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+        lastEvalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        evalResults: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
         startedAt: z.ZodOptional<z.ZodString>;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        features: string[];
+        assumptions: string[];
+        outOfScope: string[];
+        contractId: string;
+        sprintNumber: number;
+        dependsOn: string[];
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
-        }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        estimatedFiles: string[];
+        iterationHistory: unknown[];
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     }, {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        contractId: string;
+        sprintNumber: number;
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        features?: string[] | undefined;
+        assumptions?: string[] | undefined;
+        outOfScope?: string[] | undefined;
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
+        dependsOn?: string[] | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedFiles?: string[] | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        iterationHistory?: unknown[] | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     }>, "many">;
     instructions: z.ZodString;
     changedFiles: z.ZodArray<z.ZodString, "many">;
@@ -344,47 +508,85 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         currentBranch: string;
     };
     spec: {
+        mode: "greenfield" | "brownfield";
+        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
-        id: string;
+        specId: string;
+        version: number;
         title: string;
-        projectType: string;
-        techStack: string[];
         features: {
             description: string;
-            id: string;
             title: string;
-            priority: "must" | "should" | "could";
-            estimatedSprints: number;
+            featureId: string;
+            priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
+            dependencies: string[];
+            estimatedComplexity?: "medium" | "low" | "high" | 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";
+            question: string;
+            options?: {
+                description: string;
+                label: string;
+            }[] | undefined;
+            recommendation?: string | undefined;
+            ambiguityWeight?: number | undefined;
         }[];
-        nonFunctional: string[];
+        resolvedClarifications: {
+            questionId: string;
+            answer: string;
+            resolvedAt: string;
+            resolvedBy: "planner" | "user";
+        }[];
+        techStack: string[];
+        nonFunctionalRequirements: unknown[];
         constraints: string[];
         createdAt: string;
         updatedAt: string;
+        ambiguityScore?: number | undefined;
+        techNotes?: Record<string, unknown> | undefined;
+        sprints?: unknown[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        completedAt?: string | undefined;
     };
     sprintHistory: {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        features: string[];
+        assumptions: string[];
+        outOfScope: string[];
+        contractId: string;
+        sprintNumber: number;
+        dependsOn: string[];
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        estimatedFiles: string[];
+        iterationHistory: unknown[];
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     }[];
     instructions: string;
     changedFiles: string[];
@@ -395,28 +597,38 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         madeBy: "planner" | "generator" | "evaluator" | "human";
     }[];
     currentContract?: {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        features: string[];
+        assumptions: string[];
+        outOfScope: string[];
+        contractId: string;
+        sprintNumber: number;
+        dependsOn: string[];
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        estimatedFiles: string[];
+        iterationHistory: unknown[];
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     } | undefined;
 }, {
     issues: string[];
@@ -431,47 +643,85 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         currentBranch: string;
     };
     spec: {
+        mode: "greenfield" | "brownfield";
+        status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
         description: string;
-        id: string;
+        specId: string;
         title: string;
-        projectType: string;
-        techStack: string[];
         features: {
             description: string;
-            id: string;
             title: string;
-            priority: "must" | "should" | "could";
-            estimatedSprints: number;
+            featureId: string;
+            priority: "must-have" | "should-have" | "nice-to-have";
             acceptanceCriteria: string[];
+            dependencies?: string[] | undefined;
+            estimatedComplexity?: "medium" | "low" | "high" | undefined;
+            estimatedSprints?: number | undefined;
         }[];
-        nonFunctional: string[];
-        constraints: string[];
         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";
+            question: string;
+            options?: {
+                description: string;
+                label: string;
+            }[] | undefined;
+            recommendation?: string | undefined;
+            ambiguityWeight?: number | undefined;
+        }[] | undefined;
+        resolvedClarifications?: {
+            questionId: string;
+            answer: string;
+            resolvedAt: string;
+            resolvedBy?: "planner" | "user" | undefined;
+        }[] | undefined;
+        techStack?: string[] | undefined;
+        techNotes?: Record<string, unknown> | undefined;
+        nonFunctionalRequirements?: unknown[] | undefined;
+        constraints?: string[] | undefined;
+        sprints?: unknown[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        completedAt?: string | undefined;
     };
     sprintHistory: {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        contractId: string;
+        sprintNumber: number;
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
-        }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        features?: string[] | undefined;
+        assumptions?: string[] | undefined;
+        outOfScope?: string[] | undefined;
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
+        dependsOn?: string[] | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedFiles?: string[] | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        iterationHistory?: unknown[] | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     }[];
     instructions: string;
     changedFiles: string[];
@@ -482,28 +732,38 @@ export declare const ContextHandoffSchema: z.ZodObject<{
         madeBy: "planner" | "generator" | "evaluator" | "human";
     }[];
     currentContract?: {
-        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
         description: string;
-        id: string;
-        feature: string;
+        specId: string;
+        title: string;
+        contractId: string;
+        sprintNumber: number;
         successCriteria: {
             description: string;
-            id: string;
-            verificationMethod: string;
-            passed: boolean;
-            notes?: string | undefined;
+            required: boolean;
+            criterionId: string;
+            verificationMethod: "build" | "lint" | "typecheck" | "manual" | "unit-test" | "playwright" | "api-check" | "agent-evaluation";
         }[];
-        expectedChanges: {
-            path: string;
-            description: string;
-            action: "create" | "modify" | "delete";
-        }[];
-        dependsOn: string[];
-        evalResults?: unknown[] | undefined;
+        nonGoals: string[];
+        stopConditions: string[];
+        definitionOfDone: string;
+        features?: string[] | undefined;
+        assumptions?: string[] | undefined;
+        outOfScope?: string[] | undefined;
+        ambiguityScore?: number | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        completedAt?: string | undefined;
+        dependsOn?: string[] | undefined;
         generatorNotes?: string | undefined;
+        evaluatorNotes?: string | undefined;
+        estimatedFiles?: string[] | undefined;
+        estimatedDuration?: "small" | "medium" | "large" | undefined;
         evaluatorFeedback?: string | undefined;
+        iterationHistory?: unknown[] | undefined;
+        lastEvalId?: string | null | undefined;
+        evalResults?: unknown[] | undefined;
         startedAt?: string | undefined;
-        completedAt?: string | undefined;
     } | undefined;
 }>;
 export type ContextHandoff = z.infer<typeof ContextHandoffSchema>;