agent-bober 0.1.0

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

@@ -0,0 +1,543 @@
+import { z } from "zod";
+import { type PlanSpec } from "../contracts/spec.js";
+import { type SprintContract } from "../contracts/sprint-contract.js";
+export declare const AgentRoleSchema: z.ZodEnum<["planner", "generator", "evaluator", "human"]>;
+export type AgentRole = z.infer<typeof AgentRoleSchema>;
+export declare const DecisionSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    description: z.ZodString;
+    rationale: z.ZodString;
+    madeBy: z.ZodEnum<["planner", "generator", "evaluator", "human"]>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    timestamp: string;
+    rationale: string;
+    madeBy: "planner" | "generator" | "evaluator" | "human";
+}, {
+    description: string;
+    timestamp: string;
+    rationale: string;
+    madeBy: "planner" | "generator" | "evaluator" | "human";
+}>;
+export type Decision = z.infer<typeof DecisionSchema>;
+export declare const ProjectContextSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    techStack: z.ZodArray<z.ZodString, "many">;
+    entryPoints: z.ZodArray<z.ZodString, "many">;
+    currentBranch: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: string;
+    techStack: string[];
+    entryPoints: string[];
+    currentBranch: string;
+}, {
+    name: string;
+    type: string;
+    techStack: string[];
+    entryPoints: string[];
+    currentBranch: string;
+}>;
+export type ProjectContext = z.infer<typeof ProjectContextSchema>;
+export declare const ContextHandoffSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    from: z.ZodEnum<["planner", "generator", "evaluator", "human"]>;
+    to: z.ZodEnum<["planner", "generator", "evaluator", "human"]>;
+    projectContext: z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        techStack: z.ZodArray<z.ZodString, "many">;
+        entryPoints: z.ZodArray<z.ZodString, "many">;
+        currentBranch: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: string;
+        techStack: string[];
+        entryPoints: string[];
+        currentBranch: string;
+    }, {
+        name: string;
+        type: string;
+        techStack: string[];
+        entryPoints: string[];
+        currentBranch: string;
+    }>;
+    spec: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        projectType: z.ZodString;
+        techStack: z.ZodArray<z.ZodString, "many">;
+        features: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            priority: z.ZodEnum<["must", "should", "could"]>;
+            estimatedSprints: z.ZodNumber;
+            acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            id: string;
+            title: string;
+            priority: "must" | "should" | "could";
+            estimatedSprints: number;
+            acceptanceCriteria: string[];
+        }, {
+            description: string;
+            id: string;
+            title: string;
+            priority: "must" | "should" | "could";
+            estimatedSprints: number;
+            acceptanceCriteria: string[];
+        }>, "many">;
+        nonFunctional: z.ZodArray<z.ZodString, "many">;
+        constraints: z.ZodArray<z.ZodString, "many">;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        id: string;
+        title: string;
+        projectType: string;
+        techStack: string[];
+        features: {
+            description: string;
+            id: string;
+            title: string;
+            priority: "must" | "should" | "could";
+            estimatedSprints: number;
+            acceptanceCriteria: string[];
+        }[];
+        nonFunctional: string[];
+        constraints: string[];
+        createdAt: string;
+        updatedAt: string;
+    }, {
+        description: string;
+        id: string;
+        title: string;
+        projectType: string;
+        techStack: string[];
+        features: {
+            description: string;
+            id: string;
+            title: string;
+            priority: "must" | "should" | "could";
+            estimatedSprints: number;
+            acceptanceCriteria: string[];
+        }[];
+        nonFunctional: string[];
+        constraints: string[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    currentContract: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        feature: z.ZodString;
+        description: z.ZodString;
+        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"]>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }, {
+            description: string;
+            path: 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">>;
+        generatorNotes: z.ZodOptional<z.ZodString>;
+        evaluatorFeedback: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }, {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }>>;
+    sprintHistory: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        feature: z.ZodString;
+        description: z.ZodString;
+        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"]>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }, {
+            description: string;
+            path: 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">>;
+        generatorNotes: z.ZodOptional<z.ZodString>;
+        evaluatorFeedback: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }, {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }>, "many">;
+    instructions: z.ZodString;
+    changedFiles: z.ZodArray<z.ZodString, "many">;
+    decisions: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        description: z.ZodString;
+        rationale: z.ZodString;
+        madeBy: z.ZodEnum<["planner", "generator", "evaluator", "human"]>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        timestamp: string;
+        rationale: string;
+        madeBy: "planner" | "generator" | "evaluator" | "human";
+    }, {
+        description: string;
+        timestamp: string;
+        rationale: string;
+        madeBy: "planner" | "generator" | "evaluator" | "human";
+    }>, "many">;
+    issues: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    issues: string[];
+    timestamp: string;
+    from: "planner" | "generator" | "evaluator" | "human";
+    to: "planner" | "generator" | "evaluator" | "human";
+    projectContext: {
+        name: string;
+        type: string;
+        techStack: string[];
+        entryPoints: string[];
+        currentBranch: string;
+    };
+    spec: {
+        description: string;
+        id: string;
+        title: string;
+        projectType: string;
+        techStack: string[];
+        features: {
+            description: string;
+            id: string;
+            title: string;
+            priority: "must" | "should" | "could";
+            estimatedSprints: number;
+            acceptanceCriteria: string[];
+        }[];
+        nonFunctional: string[];
+        constraints: string[];
+        createdAt: string;
+        updatedAt: string;
+    };
+    sprintHistory: {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }[];
+    instructions: string;
+    changedFiles: string[];
+    decisions: {
+        description: string;
+        timestamp: string;
+        rationale: string;
+        madeBy: "planner" | "generator" | "evaluator" | "human";
+    }[];
+    currentContract?: {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    } | undefined;
+}, {
+    issues: string[];
+    timestamp: string;
+    from: "planner" | "generator" | "evaluator" | "human";
+    to: "planner" | "generator" | "evaluator" | "human";
+    projectContext: {
+        name: string;
+        type: string;
+        techStack: string[];
+        entryPoints: string[];
+        currentBranch: string;
+    };
+    spec: {
+        description: string;
+        id: string;
+        title: string;
+        projectType: string;
+        techStack: string[];
+        features: {
+            description: string;
+            id: string;
+            title: string;
+            priority: "must" | "should" | "could";
+            estimatedSprints: number;
+            acceptanceCriteria: string[];
+        }[];
+        nonFunctional: string[];
+        constraints: string[];
+        createdAt: string;
+        updatedAt: string;
+    };
+    sprintHistory: {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }[];
+    instructions: string;
+    changedFiles: string[];
+    decisions: {
+        description: string;
+        timestamp: string;
+        rationale: string;
+        madeBy: "planner" | "generator" | "evaluator" | "human";
+    }[];
+    currentContract?: {
+        description: string;
+        status: "passed" | "proposed" | "negotiating" | "agreed" | "in-progress" | "evaluating" | "failed" | "needs-rework";
+        id: string;
+        feature: string;
+        successCriteria: {
+            description: string;
+            id: string;
+            verificationMethod: string;
+            passed: boolean;
+            notes?: string | undefined;
+        }[];
+        expectedChanges: {
+            description: string;
+            path: string;
+            action: "create" | "modify" | "delete";
+        }[];
+        dependsOn: string[];
+        evalResults?: unknown[] | undefined;
+        generatorNotes?: string | undefined;
+        evaluatorFeedback?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    } | undefined;
+}>;
+export type ContextHandoff = z.infer<typeof ContextHandoffSchema>;
+/**
+ * Create a new context handoff document.
+ */
+export declare function createHandoff(params: {
+    from: AgentRole;
+    to: AgentRole;
+    projectContext: ProjectContext;
+    spec: PlanSpec;
+    currentContract?: SprintContract;
+    sprintHistory: SprintContract[];
+    instructions: string;
+    changedFiles?: string[];
+    decisions?: Decision[];
+    issues?: string[];
+}): ContextHandoff;
+/**
+ * Serialize a handoff document to a JSON string.
+ */
+export declare function serializeHandoff(handoff: ContextHandoff): string;
+/**
+ * Deserialize and validate a JSON string into a ContextHandoff.
+ * Throws on invalid input.
+ */
+export declare function deserializeHandoff(json: string): ContextHandoff;
+/**
+ * Summarize older sprints in the handoff to keep document size manageable.
+ *
+ * Keeps the `keepRecent` most recent sprints in full detail,
+ * and replaces older sprints with minimal summary contracts.
+ *
+ * Returns a new handoff with compacted sprint history.
+ */
+export declare function summarizeOlderSprints(handoff: ContextHandoff, keepRecent: number): ContextHandoff;
+//# sourceMappingURL=context-handoff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-handoff.d.ts","sourceRoot":"","sources":["../../src/orchestrator/context-handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,iCAAiC,CAAC;AAIzC,eAAO,MAAM,eAAe,2DAK1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAwBlE;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,CAAC;IACd,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,cAAc,CAcjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAoB/D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,GACjB,cAAc,CAiChB"}

package/dist/orchestrator/context-handoff.js

@@ -0,0 +1,133 @@
+import { z } from "zod";
+import { PlanSpecSchema } from "../contracts/spec.js";
+import { SprintContractSchema, } from "../contracts/sprint-contract.js";
+// ── Enums ───────────────────────────────────────────────────────────
+export const AgentRoleSchema = z.enum([
+    "planner",
+    "generator",
+    "evaluator",
+    "human",
+]);
+// ── Decision ────────────────────────────────────────────────────────
+export const DecisionSchema = z.object({
+    timestamp: z.string().datetime(),
+    description: z.string().min(1),
+    rationale: z.string().min(1),
+    madeBy: AgentRoleSchema,
+});
+// ── Project Context ─────────────────────────────────────────────────
+export const ProjectContextSchema = z.object({
+    name: z.string().min(1),
+    type: z.string().min(1),
+    techStack: z.array(z.string()),
+    entryPoints: z.array(z.string()),
+    currentBranch: z.string(),
+});
+// ── Context Handoff ─────────────────────────────────────────────────
+export const ContextHandoffSchema = z.object({
+    timestamp: z.string().datetime(),
+    from: AgentRoleSchema,
+    to: AgentRoleSchema,
+    projectContext: ProjectContextSchema,
+    spec: PlanSpecSchema,
+    currentContract: SprintContractSchema.optional(),
+    sprintHistory: z.array(SprintContractSchema),
+    instructions: z.string(),
+    changedFiles: z.array(z.string()),
+    decisions: z.array(DecisionSchema),
+    issues: z.array(z.string()),
+});
+function summarizeSprint(contract) {
+    return {
+        id: contract.id,
+        feature: contract.feature,
+        status: contract.status,
+        startedAt: contract.startedAt,
+        completedAt: contract.completedAt,
+    };
+}
+// ── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Create a new context handoff document.
+ */
+export function createHandoff(params) {
+    return {
+        timestamp: new Date().toISOString(),
+        from: params.from,
+        to: params.to,
+        projectContext: params.projectContext,
+        spec: params.spec,
+        currentContract: params.currentContract,
+        sprintHistory: params.sprintHistory,
+        instructions: params.instructions,
+        changedFiles: params.changedFiles ?? [],
+        decisions: params.decisions ?? [],
+        issues: params.issues ?? [],
+    };
+}
+/**
+ * Serialize a handoff document to a JSON string.
+ */
+export function serializeHandoff(handoff) {
+    return JSON.stringify(handoff, null, 2);
+}
+/**
+ * Deserialize and validate a JSON string into a ContextHandoff.
+ * Throws on invalid input.
+ */
+export function deserializeHandoff(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse handoff JSON: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    const result = ContextHandoffSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid handoff document:\n${issues}`);
+    }
+    return result.data;
+}
+/**
+ * Summarize older sprints in the handoff to keep document size manageable.
+ *
+ * Keeps the `keepRecent` most recent sprints in full detail,
+ * and replaces older sprints with minimal summary contracts.
+ *
+ * Returns a new handoff with compacted sprint history.
+ */
+export function summarizeOlderSprints(handoff, keepRecent) {
+    const history = handoff.sprintHistory;
+    if (history.length <= keepRecent) {
+        return handoff;
+    }
+    const cutoff = history.length - keepRecent;
+    const olderSprints = history.slice(0, cutoff);
+    const recentSprints = history.slice(cutoff);
+    // Build summary entries as minimal SprintContract objects
+    const summarized = olderSprints.map((contract) => {
+        const summary = summarizeSprint(contract);
+        return {
+            id: summary.id,
+            feature: summary.feature,
+            description: `[Summarized] ${contract.description}`,
+            successCriteria: [],
+            expectedChanges: [],
+            dependsOn: [],
+            status: contract.status,
+            generatorNotes: undefined,
+            evaluatorFeedback: undefined,
+            startedAt: summary.startedAt,
+            completedAt: summary.completedAt,
+        };
+    });
+    return {
+        ...handoff,
+        sprintHistory: [...summarized, ...recentSprints],
+    };
+}
+//# sourceMappingURL=context-handoff.js.map

package/dist/orchestrator/context-handoff.js.map

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