@specforge/cli 0.1.0 → 0.2.4

package/node_modules/@specforge/spec-types/dist/schema/epic.d.ts

@@ -0,0 +1,955 @@
+import { z } from 'zod';
+export declare const EpicStatusEnum: z.ZodEnum<["todo", "in_progress", "completed"]>;
+export type EpicStatus = z.infer<typeof EpicStatusEnum>;
+export declare const EpicSchema: z.ZodObject<{
+    id: z.ZodString;
+    specificationId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    objective: z.ZodString;
+    order: z.ZodOptional<z.ZodNumber>;
+    estimatedMinutes: z.ZodOptional<z.ZodNumber>;
+    architecture: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodObject<{
+        inScope: z.ZodArray<z.ZodString, "many">;
+        outOfScope: z.ZodArray<z.ZodString, "many">;
+        assumptions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        externalDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        inScope: string[];
+        outOfScope: string[];
+        assumptions?: string[] | undefined;
+        externalDependencies?: string[] | undefined;
+    }, {
+        inScope: string[];
+        outOfScope: string[];
+        assumptions?: string[] | undefined;
+        externalDependencies?: string[] | undefined;
+    }>>;
+    goals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        type: z.ZodEnum<["business", "technical", "user", "operational"]>;
+        successCriteria: z.ZodArray<z.ZodString, "many">;
+        kpi: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "business" | "technical" | "user" | "operational";
+        id: string;
+        description: string;
+        title: string;
+        successCriteria: string[];
+        kpi?: string | undefined;
+    }, {
+        type: "business" | "technical" | "user" | "operational";
+        id: string;
+        description: string;
+        title: string;
+        successCriteria: string[];
+        kpi?: string | undefined;
+    }>, "many">>;
+    acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        given: z.ZodString;
+        when: z.ZodString;
+        then: z.ZodString;
+        order: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        given: string;
+        when: string;
+        then: string;
+        order: number;
+    }, {
+        id: string;
+        given: string;
+        when: string;
+        then: string;
+        order: number;
+    }>, "many">>;
+    validationCommands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    apiContracts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<["rest", "graphql", "rpc", "event", "cli"]>;
+        description: z.ZodOptional<z.ZodString>;
+        blueprintReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            blueprintId: z.ZodString;
+            context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            section: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }, {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "rest" | "graphql" | "rpc" | "event" | "cli";
+        id: string;
+        name: string;
+        description?: string | undefined;
+        blueprintReferences?: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[] | undefined;
+    }, {
+        type: "rest" | "graphql" | "rpc" | "event" | "cli";
+        id: string;
+        name: string;
+        description?: string | undefined;
+        blueprintReferences?: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    sharedPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        codeStandards: z.ZodOptional<z.ZodObject<{
+            errorHandling: z.ZodOptional<z.ZodString>;
+            naming: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodString, z.objectOutputType<{
+            errorHandling: z.ZodOptional<z.ZodString>;
+            naming: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+        }, z.ZodString, "strip">, z.objectInputType<{
+            errorHandling: z.ZodOptional<z.ZodString>;
+            naming: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+        }, z.ZodString, "strip">>>;
+        commonImports: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        returnTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        additionalImports: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        commonFiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        description: string;
+        name: string;
+        codeStandards?: z.objectOutputType<{
+            errorHandling: z.ZodOptional<z.ZodString>;
+            naming: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+        }, z.ZodString, "strip"> | undefined;
+        commonImports?: string[] | undefined;
+        returnTypes?: Record<string, string> | undefined;
+        additionalImports?: string[] | undefined;
+        commonFiles?: Record<string, string> | undefined;
+    }, {
+        id: string;
+        description: string;
+        name: string;
+        codeStandards?: z.objectInputType<{
+            errorHandling: z.ZodOptional<z.ZodString>;
+            naming: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+        }, z.ZodString, "strip"> | undefined;
+        commonImports?: string[] | undefined;
+        returnTypes?: Record<string, string> | undefined;
+        additionalImports?: string[] | undefined;
+        commonFiles?: Record<string, string> | undefined;
+    }>, "many">>;
+    fileStructures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        scope: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        content: string;
+        scope: string;
+        description?: string | undefined;
+    }, {
+        id: string;
+        content: string;
+        scope: string;
+        description?: string | undefined;
+    }>, "many">>;
+    requirementsCovered: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    nfrsCovered: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    goalsCovered: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tickets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        epicId: z.ZodString;
+        ticketNumber: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        ticketType: z.ZodEnum<["implementation", "verification"]>;
+        complexity: z.ZodEnum<["small", "medium", "large", "xlarge"]>;
+        estimatedMinutes: z.ZodNumber;
+        order: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        acceptanceCriteria: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            given: z.ZodString;
+            when: z.ZodString;
+            then: z.ZodString;
+            order: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            given: string;
+            when: string;
+            then: string;
+            order: number;
+        }, {
+            id: string;
+            given: string;
+            when: string;
+            then: string;
+            order: number;
+        }>, "many">;
+        implementationSteps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            order: z.ZodNumber;
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                role: z.ZodString;
+                symbol: z.ZodOptional<z.ZodString>;
+                why: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }, {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }>, "many">>;
+            linkedFileIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            linkedCodeSnippetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            linkedTypeSnippetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            order: number;
+            text: string;
+            files?: {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }[] | undefined;
+            linkedFileIds?: string[] | undefined;
+            linkedCodeSnippetIds?: string[] | undefined;
+            linkedTypeSnippetIds?: string[] | undefined;
+        }, {
+            id: string;
+            order: number;
+            text: string;
+            files?: {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }[] | undefined;
+            linkedFileIds?: string[] | undefined;
+            linkedCodeSnippetIds?: string[] | undefined;
+            linkedTypeSnippetIds?: string[] | undefined;
+        }>, "many">;
+        filesToBeCreated: z.ZodArray<z.ZodString, "many">;
+        filesToBeModified: z.ZodArray<z.ZodString, "many">;
+        filesToBeDeleted: z.ZodArray<z.ZodString, "many">;
+        filesToBeReferenced: z.ZodArray<z.ZodString, "many">;
+        testSpecification: z.ZodOptional<z.ZodObject<{
+            testTypes: z.ZodArray<z.ZodEnum<["unit", "integration", "e2e", "typecheck", "lint", "build", "contract", "structural", "layout", "a11y", "performance"]>, "many">;
+            qualityGates: z.ZodArray<z.ZodString, "many">;
+            testCommands: z.ZodArray<z.ZodString, "many">;
+            coverageTarget: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+            qualityGates: string[];
+            testCommands: string[];
+            coverageTarget?: number | null | undefined;
+        }, {
+            testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+            qualityGates: string[];
+            testCommands: string[];
+            coverageTarget?: number | null | undefined;
+        }>>;
+        guardrails: z.ZodArray<z.ZodString, "many">;
+        codeReferences: z.ZodArray<z.ZodObject<{
+            filePath: z.ZodString;
+            symbol: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            filePath: string;
+            symbol?: string | undefined;
+            description?: string | undefined;
+        }, {
+            filePath: string;
+            symbol?: string | undefined;
+            description?: string | undefined;
+        }>, "many">;
+        typeReferences: z.ZodArray<z.ZodObject<{
+            filePath: z.ZodString;
+            typeName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            filePath: string;
+            typeName: string;
+            description?: string | undefined;
+        }, {
+            filePath: string;
+            typeName: string;
+            description?: string | undefined;
+        }>, "many">;
+        codeSnippets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            language: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            content: z.ZodString;
+            order: z.ZodOptional<z.ZodNumber>;
+            sourcePath: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }, {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }>, "many">>;
+        typeSnippets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            language: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            content: z.ZodString;
+            order: z.ZodOptional<z.ZodNumber>;
+            sourcePath: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }, {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }>, "many">>;
+        blueprintReferences: z.ZodArray<z.ZodObject<{
+            blueprintId: z.ZodString;
+            context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            section: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }, {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }>, "many">;
+        dependencies: z.ZodArray<z.ZodObject<{
+            ticketId: z.ZodString;
+            type: z.ZodEnum<["requires", "blocks"]>;
+            origin: z.ZodOptional<z.ZodObject<{
+                provenance: z.ZodOptional<z.ZodBoolean>;
+                scaffold: z.ZodOptional<z.ZodBoolean>;
+                semantic: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            }, {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "requires" | "blocks";
+            ticketId: string;
+            origin?: {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            } | undefined;
+        }, {
+            type: "requires" | "blocks";
+            ticketId: string;
+            origin?: {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            } | undefined;
+        }>, "many">;
+        fieldDeclarations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            value: z.ZodLiteral<"N/A">;
+            reason: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: "N/A";
+            reason: string;
+        }, {
+            value: "N/A";
+            reason: string;
+        }>>>;
+        fileChangeRefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            path: z.ZodString;
+            kind: z.ZodString;
+            symbol: z.ZodOptional<z.ZodString>;
+            why: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            id: string;
+            kind: string;
+            symbol?: string | undefined;
+            why?: string | undefined;
+        }, {
+            path: string;
+            id: string;
+            kind: string;
+            symbol?: string | undefined;
+            why?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        epicId: string;
+        ticketType: "implementation" | "verification";
+        complexity: "small" | "medium" | "large" | "xlarge";
+        estimatedMinutes: number;
+        acceptanceCriteria: {
+            id: string;
+            given: string;
+            when: string;
+            then: string;
+            order: number;
+        }[];
+        implementationSteps: {
+            id: string;
+            order: number;
+            text: string;
+            files?: {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }[] | undefined;
+            linkedFileIds?: string[] | undefined;
+            linkedCodeSnippetIds?: string[] | undefined;
+            linkedTypeSnippetIds?: string[] | undefined;
+        }[];
+        filesToBeCreated: string[];
+        filesToBeModified: string[];
+        filesToBeDeleted: string[];
+        filesToBeReferenced: string[];
+        guardrails: string[];
+        codeReferences: {
+            filePath: string;
+            symbol?: string | undefined;
+            description?: string | undefined;
+        }[];
+        typeReferences: {
+            filePath: string;
+            typeName: string;
+            description?: string | undefined;
+        }[];
+        blueprintReferences: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[];
+        dependencies: {
+            type: "requires" | "blocks";
+            ticketId: string;
+            origin?: {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            } | undefined;
+        }[];
+        order?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+        ticketNumber?: number | undefined;
+        testSpecification?: {
+            testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+            qualityGates: string[];
+            testCommands: string[];
+            coverageTarget?: number | null | undefined;
+        } | undefined;
+        codeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        typeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        fieldDeclarations?: Record<string, {
+            value: "N/A";
+            reason: string;
+        }> | undefined;
+        fileChangeRefs?: {
+            path: string;
+            id: string;
+            kind: string;
+            symbol?: string | undefined;
+            why?: string | undefined;
+        }[] | undefined;
+    }, {
+        id: string;
+        title: string;
+        epicId: string;
+        ticketType: "implementation" | "verification";
+        complexity: "small" | "medium" | "large" | "xlarge";
+        estimatedMinutes: number;
+        acceptanceCriteria: {
+            id: string;
+            given: string;
+            when: string;
+            then: string;
+            order: number;
+        }[];
+        implementationSteps: {
+            id: string;
+            order: number;
+            text: string;
+            files?: {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }[] | undefined;
+            linkedFileIds?: string[] | undefined;
+            linkedCodeSnippetIds?: string[] | undefined;
+            linkedTypeSnippetIds?: string[] | undefined;
+        }[];
+        filesToBeCreated: string[];
+        filesToBeModified: string[];
+        filesToBeDeleted: string[];
+        filesToBeReferenced: string[];
+        guardrails: string[];
+        codeReferences: {
+            filePath: string;
+            symbol?: string | undefined;
+            description?: string | undefined;
+        }[];
+        typeReferences: {
+            filePath: string;
+            typeName: string;
+            description?: string | undefined;
+        }[];
+        blueprintReferences: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[];
+        dependencies: {
+            type: "requires" | "blocks";
+            ticketId: string;
+            origin?: {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            } | undefined;
+        }[];
+        order?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+        ticketNumber?: number | undefined;
+        testSpecification?: {
+            testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+            qualityGates: string[];
+            testCommands: string[];
+            coverageTarget?: number | null | undefined;
+        } | undefined;
+        codeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        typeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        fieldDeclarations?: Record<string, {
+            value: "N/A";
+            reason: string;
+        }> | undefined;
+        fileChangeRefs?: {
+            path: string;
+            id: string;
+            kind: string;
+            symbol?: string | undefined;
+            why?: string | undefined;
+        }[] | undefined;
+    }>, "many">;
+    fieldDeclarations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        value: z.ZodLiteral<"N/A">;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: "N/A";
+        reason: string;
+    }, {
+        value: "N/A";
+        reason: string;
+    }>>>;
+    category: z.ZodOptional<z.ZodEnum<["foundation", "functional", "non_functional", "verification"]>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    description: string;
+    title: string;
+    specificationId: string;
+    objective: string;
+    tickets: {
+        id: string;
+        title: string;
+        epicId: string;
+        ticketType: "implementation" | "verification";
+        complexity: "small" | "medium" | "large" | "xlarge";
+        estimatedMinutes: number;
+        acceptanceCriteria: {
+            id: string;
+            given: string;
+            when: string;
+            then: string;
+            order: number;
+        }[];
+        implementationSteps: {
+            id: string;
+            order: number;
+            text: string;
+            files?: {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }[] | undefined;
+            linkedFileIds?: string[] | undefined;
+            linkedCodeSnippetIds?: string[] | undefined;
+            linkedTypeSnippetIds?: string[] | undefined;
+        }[];
+        filesToBeCreated: string[];
+        filesToBeModified: string[];
+        filesToBeDeleted: string[];
+        filesToBeReferenced: string[];
+        guardrails: string[];
+        codeReferences: {
+            filePath: string;
+            symbol?: string | undefined;
+            description?: string | undefined;
+        }[];
+        typeReferences: {
+            filePath: string;
+            typeName: string;
+            description?: string | undefined;
+        }[];
+        blueprintReferences: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[];
+        dependencies: {
+            type: "requires" | "blocks";
+            ticketId: string;
+            origin?: {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            } | undefined;
+        }[];
+        order?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+        ticketNumber?: number | undefined;
+        testSpecification?: {
+            testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+            qualityGates: string[];
+            testCommands: string[];
+            coverageTarget?: number | null | undefined;
+        } | undefined;
+        codeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        typeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        fieldDeclarations?: Record<string, {
+            value: "N/A";
+            reason: string;
+        }> | undefined;
+        fileChangeRefs?: {
+            path: string;
+            id: string;
+            kind: string;
+            symbol?: string | undefined;
+            why?: string | undefined;
+        }[] | undefined;
+    }[];
+    order?: number | undefined;
+    architecture?: string | undefined;
+    category?: "verification" | "functional" | "foundation" | "non_functional" | undefined;
+    estimatedMinutes?: number | undefined;
+    acceptanceCriteria?: {
+        id: string;
+        given: string;
+        when: string;
+        then: string;
+        order: number;
+    }[] | undefined;
+    fieldDeclarations?: Record<string, {
+        value: "N/A";
+        reason: string;
+    }> | undefined;
+    scope?: {
+        inScope: string[];
+        outOfScope: string[];
+        assumptions?: string[] | undefined;
+        externalDependencies?: string[] | undefined;
+    } | undefined;
+    goals?: {
+        type: "business" | "technical" | "user" | "operational";
+        id: string;
+        description: string;
+        title: string;
+        successCriteria: string[];
+        kpi?: string | undefined;
+    }[] | undefined;
+    validationCommands?: string[] | undefined;
+    apiContracts?: {
+        type: "rest" | "graphql" | "rpc" | "event" | "cli";
+        id: string;
+        name: string;
+        description?: string | undefined;
+        blueprintReferences?: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    sharedPatterns?: {
+        id: string;
+        description: string;
+        name: string;
+        codeStandards?: z.objectOutputType<{
+            errorHandling: z.ZodOptional<z.ZodString>;
+            naming: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+        }, z.ZodString, "strip"> | undefined;
+        commonImports?: string[] | undefined;
+        returnTypes?: Record<string, string> | undefined;
+        additionalImports?: string[] | undefined;
+        commonFiles?: Record<string, string> | undefined;
+    }[] | undefined;
+    fileStructures?: {
+        id: string;
+        content: string;
+        scope: string;
+        description?: string | undefined;
+    }[] | undefined;
+    requirementsCovered?: string[] | undefined;
+    nfrsCovered?: string[] | undefined;
+    goalsCovered?: string[] | undefined;
+}, {
+    id: string;
+    description: string;
+    title: string;
+    specificationId: string;
+    objective: string;
+    tickets: {
+        id: string;
+        title: string;
+        epicId: string;
+        ticketType: "implementation" | "verification";
+        complexity: "small" | "medium" | "large" | "xlarge";
+        estimatedMinutes: number;
+        acceptanceCriteria: {
+            id: string;
+            given: string;
+            when: string;
+            then: string;
+            order: number;
+        }[];
+        implementationSteps: {
+            id: string;
+            order: number;
+            text: string;
+            files?: {
+                path: string;
+                role: string;
+                symbol?: string | undefined;
+                why?: string | undefined;
+            }[] | undefined;
+            linkedFileIds?: string[] | undefined;
+            linkedCodeSnippetIds?: string[] | undefined;
+            linkedTypeSnippetIds?: string[] | undefined;
+        }[];
+        filesToBeCreated: string[];
+        filesToBeModified: string[];
+        filesToBeDeleted: string[];
+        filesToBeReferenced: string[];
+        guardrails: string[];
+        codeReferences: {
+            filePath: string;
+            symbol?: string | undefined;
+            description?: string | undefined;
+        }[];
+        typeReferences: {
+            filePath: string;
+            typeName: string;
+            description?: string | undefined;
+        }[];
+        blueprintReferences: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[];
+        dependencies: {
+            type: "requires" | "blocks";
+            ticketId: string;
+            origin?: {
+                provenance?: boolean | undefined;
+                scaffold?: boolean | undefined;
+                semantic?: boolean | undefined;
+            } | undefined;
+        }[];
+        order?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+        ticketNumber?: number | undefined;
+        testSpecification?: {
+            testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+            qualityGates: string[];
+            testCommands: string[];
+            coverageTarget?: number | null | undefined;
+        } | undefined;
+        codeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        typeSnippets?: {
+            id: string;
+            language: string;
+            content: string;
+            order?: number | undefined;
+            description?: string | undefined;
+            sourcePath?: string | undefined;
+        }[] | undefined;
+        fieldDeclarations?: Record<string, {
+            value: "N/A";
+            reason: string;
+        }> | undefined;
+        fileChangeRefs?: {
+            path: string;
+            id: string;
+            kind: string;
+            symbol?: string | undefined;
+            why?: string | undefined;
+        }[] | undefined;
+    }[];
+    order?: number | undefined;
+    architecture?: string | undefined;
+    category?: "verification" | "functional" | "foundation" | "non_functional" | undefined;
+    estimatedMinutes?: number | undefined;
+    acceptanceCriteria?: {
+        id: string;
+        given: string;
+        when: string;
+        then: string;
+        order: number;
+    }[] | undefined;
+    fieldDeclarations?: Record<string, {
+        value: "N/A";
+        reason: string;
+    }> | undefined;
+    scope?: {
+        inScope: string[];
+        outOfScope: string[];
+        assumptions?: string[] | undefined;
+        externalDependencies?: string[] | undefined;
+    } | undefined;
+    goals?: {
+        type: "business" | "technical" | "user" | "operational";
+        id: string;
+        description: string;
+        title: string;
+        successCriteria: string[];
+        kpi?: string | undefined;
+    }[] | undefined;
+    validationCommands?: string[] | undefined;
+    apiContracts?: {
+        type: "rest" | "graphql" | "rpc" | "event" | "cli";
+        id: string;
+        name: string;
+        description?: string | undefined;
+        blueprintReferences?: {
+            blueprintId: string;
+            context?: string | null | undefined;
+            section?: string | null | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    sharedPatterns?: {
+        id: string;
+        description: string;
+        name: string;
+        codeStandards?: z.objectInputType<{
+            errorHandling: z.ZodOptional<z.ZodString>;
+            naming: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+        }, z.ZodString, "strip"> | undefined;
+        commonImports?: string[] | undefined;
+        returnTypes?: Record<string, string> | undefined;
+        additionalImports?: string[] | undefined;
+        commonFiles?: Record<string, string> | undefined;
+    }[] | undefined;
+    fileStructures?: {
+        id: string;
+        content: string;
+        scope: string;
+        description?: string | undefined;
+    }[] | undefined;
+    requirementsCovered?: string[] | undefined;
+    nfrsCovered?: string[] | undefined;
+    goalsCovered?: string[] | undefined;
+}>;
+export type Epic = z.infer<typeof EpicSchema>;
+//# sourceMappingURL=epic.d.ts.map