@gordon.gan/specflow 1.8.0-beta → 1.8.2-beta

package/dist/core/document/schemas.d.ts

@@ -0,0 +1,1111 @@
+/**
+ * Document Engine — zod schemas (data model)
+ *
+ * Source of truth for the Generic LongDoc Engine (design doc
+ * docs/GENERIC_LONGDOC_ENGINE_DESIGN.md §6.2, decisions 1–9).
+ *
+ * Layered source of truth:
+ *  - Contract entities (interfaces/tables/decisions) → structured, zod-validated
+ *  - Narrative content → controlled Markdown fragments
+ *  - Outline is the two-pass core IR (replaces ACP index.yaml/parts_order)
+ */
+import { z } from 'zod';
+export declare const FieldSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    desc: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    required: boolean;
+    default?: string | undefined;
+    desc?: string | undefined;
+}, {
+    type: string;
+    name: string;
+    default?: string | undefined;
+    required?: boolean | undefined;
+    desc?: string | undefined;
+}>;
+export type Field = z.infer<typeof FieldSchema>;
+export declare const ErrorSpecSchema: z.ZodObject<{
+    condition: z.ZodString;
+    status: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    condition: string;
+    note?: string | undefined;
+}, {
+    status: string;
+    condition: string;
+    note?: string | undefined;
+}>;
+export declare const InterfaceEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+    path: z.ZodString;
+    request_fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        desc: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        required: boolean;
+        default?: string | undefined;
+        desc?: string | undefined;
+    }, {
+        type: string;
+        name: string;
+        default?: string | undefined;
+        required?: boolean | undefined;
+        desc?: string | undefined;
+    }>, "many">>;
+    response_fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        desc: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        required: boolean;
+        default?: string | undefined;
+        desc?: string | undefined;
+    }, {
+        type: string;
+        name: string;
+        default?: string | undefined;
+        required?: boolean | undefined;
+        desc?: string | undefined;
+    }>, "many">>;
+    errors: z.ZodArray<z.ZodObject<{
+        condition: z.ZodString;
+        status: z.ZodString;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        condition: string;
+        note?: string | undefined;
+    }, {
+        status: string;
+        condition: string;
+        note?: string | undefined;
+    }>, "many">;
+    failure_examples: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    id: string;
+    name: string;
+    errors: {
+        status: string;
+        condition: string;
+        note?: string | undefined;
+    }[];
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    failure_examples: string[];
+    request_fields?: {
+        type: string;
+        name: string;
+        required: boolean;
+        default?: string | undefined;
+        desc?: string | undefined;
+    }[] | undefined;
+    response_fields?: {
+        type: string;
+        name: string;
+        required: boolean;
+        default?: string | undefined;
+        desc?: string | undefined;
+    }[] | undefined;
+}, {
+    path: string;
+    id: string;
+    name: string;
+    errors: {
+        status: string;
+        condition: string;
+        note?: string | undefined;
+    }[];
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    failure_examples: string[];
+    request_fields?: {
+        type: string;
+        name: string;
+        default?: string | undefined;
+        required?: boolean | undefined;
+        desc?: string | undefined;
+    }[] | undefined;
+    response_fields?: {
+        type: string;
+        name: string;
+        default?: string | undefined;
+        required?: boolean | undefined;
+        desc?: string | undefined;
+    }[] | undefined;
+}>;
+export type InterfaceEntity = z.infer<typeof InterfaceEntitySchema>;
+export declare const TableEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    ddl: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        desc: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        required: boolean;
+        default?: string | undefined;
+        desc?: string | undefined;
+    }, {
+        type: string;
+        name: string;
+        default?: string | undefined;
+        required?: boolean | undefined;
+        desc?: string | undefined;
+    }>, "many">>;
+    migration: z.ZodOptional<z.ZodString>;
+    rollback: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    ddl: string;
+    fields?: {
+        type: string;
+        name: string;
+        required: boolean;
+        default?: string | undefined;
+        desc?: string | undefined;
+    }[] | undefined;
+    migration?: string | undefined;
+    rollback?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    ddl: string;
+    fields?: {
+        type: string;
+        name: string;
+        default?: string | undefined;
+        required?: boolean | undefined;
+        desc?: string | undefined;
+    }[] | undefined;
+    migration?: string | undefined;
+    rollback?: string | undefined;
+}>;
+export type TableEntity = z.infer<typeof TableEntitySchema>;
+export declare const DecisionEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    text: string;
+}, {
+    id: string;
+    text: string;
+}>;
+export type DecisionEntity = z.infer<typeof DecisionEntitySchema>;
+export declare const EntitiesSchema: z.ZodObject<{
+    interfaces: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+        path: z.ZodString;
+        request_fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            desc: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }, {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }>, "many">>;
+        response_fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            desc: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }, {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }>, "many">>;
+        errors: z.ZodArray<z.ZodObject<{
+            condition: z.ZodString;
+            status: z.ZodString;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }, {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }>, "many">;
+        failure_examples: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        id: string;
+        name: string;
+        errors: {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }[];
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        failure_examples: string[];
+        request_fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        response_fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+    }, {
+        path: string;
+        id: string;
+        name: string;
+        errors: {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }[];
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        failure_examples: string[];
+        request_fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        response_fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+    }>, "many">>, {
+        path: string;
+        id: string;
+        name: string;
+        errors: {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }[];
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        failure_examples: string[];
+        request_fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        response_fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+    }[], {
+        path: string;
+        id: string;
+        name: string;
+        errors: {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }[];
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        failure_examples: string[];
+        request_fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        response_fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+    }[] | undefined>;
+    tables: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        ddl: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            desc: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }, {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }>, "many">>;
+        migration: z.ZodOptional<z.ZodString>;
+        rollback: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        ddl: string;
+        fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        migration?: string | undefined;
+        rollback?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        ddl: string;
+        fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        migration?: string | undefined;
+        rollback?: string | undefined;
+    }>, "many">>, {
+        id: string;
+        name: string;
+        ddl: string;
+        fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        migration?: string | undefined;
+        rollback?: string | undefined;
+    }[], {
+        id: string;
+        name: string;
+        ddl: string;
+        fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        migration?: string | undefined;
+        rollback?: string | undefined;
+    }[] | undefined>;
+    decisions: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        text: string;
+    }, {
+        id: string;
+        text: string;
+    }>, "many">>, {
+        id: string;
+        text: string;
+    }[], {
+        id: string;
+        text: string;
+    }[] | undefined>;
+}, "strip", z.ZodTypeAny, {
+    interfaces: {
+        path: string;
+        id: string;
+        name: string;
+        errors: {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }[];
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        failure_examples: string[];
+        request_fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        response_fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+    }[];
+    tables: {
+        id: string;
+        name: string;
+        ddl: string;
+        fields?: {
+            type: string;
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        migration?: string | undefined;
+        rollback?: string | undefined;
+    }[];
+    decisions: {
+        id: string;
+        text: string;
+    }[];
+}, {
+    interfaces?: {
+        path: string;
+        id: string;
+        name: string;
+        errors: {
+            status: string;
+            condition: string;
+            note?: string | undefined;
+        }[];
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        failure_examples: string[];
+        request_fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        response_fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    tables?: {
+        id: string;
+        name: string;
+        ddl: string;
+        fields?: {
+            type: string;
+            name: string;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            desc?: string | undefined;
+        }[] | undefined;
+        migration?: string | undefined;
+        rollback?: string | undefined;
+    }[] | undefined;
+    decisions?: {
+        id: string;
+        text: string;
+    }[] | undefined;
+}>;
+export type Entities = z.infer<typeof EntitiesSchema>;
+export declare const OutlinePointKindSchema: z.ZodEnum<["entity", "narrative", "mixed"]>;
+export declare const OutlinePointSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    kind: z.ZodDefault<z.ZodEnum<["entity", "narrative", "mixed"]>>;
+    references: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    source_segments: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    references: string[];
+    kind: "entity" | "narrative" | "mixed";
+    required: boolean;
+    text: string;
+    source_segments: string[];
+}, {
+    id: string;
+    text: string;
+    references?: string[] | undefined;
+    kind?: "entity" | "narrative" | "mixed" | undefined;
+    required?: boolean | undefined;
+    source_segments?: string[] | undefined;
+}>;
+export type OutlinePoint = z.infer<typeof OutlinePointSchema>;
+export declare const OutlineChapterSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    points: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        kind: z.ZodDefault<z.ZodEnum<["entity", "narrative", "mixed"]>>;
+        references: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+        source_segments: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        references: string[];
+        kind: "entity" | "narrative" | "mixed";
+        required: boolean;
+        text: string;
+        source_segments: string[];
+    }, {
+        id: string;
+        text: string;
+        references?: string[] | undefined;
+        kind?: "entity" | "narrative" | "mixed" | undefined;
+        required?: boolean | undefined;
+        source_segments?: string[] | undefined;
+    }>, "many">;
+    optional: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    points: {
+        id: string;
+        references: string[];
+        kind: "entity" | "narrative" | "mixed";
+        required: boolean;
+        text: string;
+        source_segments: string[];
+    }[];
+    optional: boolean;
+}, {
+    id: string;
+    title: string;
+    points: {
+        id: string;
+        text: string;
+        references?: string[] | undefined;
+        kind?: "entity" | "narrative" | "mixed" | undefined;
+        required?: boolean | undefined;
+        source_segments?: string[] | undefined;
+    }[];
+    optional?: boolean | undefined;
+}>;
+export type OutlineChapter = z.infer<typeof OutlineChapterSchema>;
+export declare const OutlineEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    frozen: z.ZodString;
+    standalone: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    standalone: boolean;
+    id: string;
+    frozen: string;
+}, {
+    id: string;
+    frozen: string;
+    standalone?: boolean | undefined;
+}>;
+export declare const FillOnceSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    input_budget_tokens: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    input_budget_tokens: number;
+}, {
+    enabled?: boolean | undefined;
+    input_budget_tokens?: number | undefined;
+}>;
+export declare const OutlineSchema: z.ZodObject<{
+    profile: z.ZodString;
+    chapters: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        points: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            kind: z.ZodDefault<z.ZodEnum<["entity", "narrative", "mixed"]>>;
+            references: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+            source_segments: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            references: string[];
+            kind: "entity" | "narrative" | "mixed";
+            required: boolean;
+            text: string;
+            source_segments: string[];
+        }, {
+            id: string;
+            text: string;
+            references?: string[] | undefined;
+            kind?: "entity" | "narrative" | "mixed" | undefined;
+            required?: boolean | undefined;
+            source_segments?: string[] | undefined;
+        }>, "many">;
+        optional: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        points: {
+            id: string;
+            references: string[];
+            kind: "entity" | "narrative" | "mixed";
+            required: boolean;
+            text: string;
+            source_segments: string[];
+        }[];
+        optional: boolean;
+    }, {
+        id: string;
+        title: string;
+        points: {
+            id: string;
+            text: string;
+            references?: string[] | undefined;
+            kind?: "entity" | "narrative" | "mixed" | undefined;
+            required?: boolean | undefined;
+            source_segments?: string[] | undefined;
+        }[];
+        optional?: boolean | undefined;
+    }>, "many">;
+    entities: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        frozen: z.ZodString;
+        standalone: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        standalone: boolean;
+        id: string;
+        frozen: string;
+    }, {
+        id: string;
+        frozen: string;
+        standalone?: boolean | undefined;
+    }>, "many">>, {
+        standalone: boolean;
+        id: string;
+        frozen: string;
+    }[], {
+        id: string;
+        frozen: string;
+        standalone?: boolean | undefined;
+    }[] | undefined>;
+    decisions: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    fill_once: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        input_budget_tokens: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        input_budget_tokens: number;
+    }, {
+        enabled?: boolean | undefined;
+        input_budget_tokens?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    profile: string;
+    decisions: string[];
+    chapters: {
+        id: string;
+        title: string;
+        points: {
+            id: string;
+            references: string[];
+            kind: "entity" | "narrative" | "mixed";
+            required: boolean;
+            text: string;
+            source_segments: string[];
+        }[];
+        optional: boolean;
+    }[];
+    entities: {
+        standalone: boolean;
+        id: string;
+        frozen: string;
+    }[];
+    fill_once?: {
+        enabled: boolean;
+        input_budget_tokens: number;
+    } | undefined;
+}, {
+    profile: string;
+    chapters: {
+        id: string;
+        title: string;
+        points: {
+            id: string;
+            text: string;
+            references?: string[] | undefined;
+            kind?: "entity" | "narrative" | "mixed" | undefined;
+            required?: boolean | undefined;
+            source_segments?: string[] | undefined;
+        }[];
+        optional?: boolean | undefined;
+    }[];
+    decisions?: string[] | undefined;
+    entities?: {
+        id: string;
+        frozen: string;
+        standalone?: boolean | undefined;
+    }[] | undefined;
+    fill_once?: {
+        enabled?: boolean | undefined;
+        input_budget_tokens?: number | undefined;
+    } | undefined;
+}>;
+export type Outline = z.infer<typeof OutlineSchema>;
+export declare const ConstraintItemKindSchema: z.ZodEnum<["entity", "decision", "point"]>;
+export declare const ConstraintItemSchema: z.ZodObject<{
+    kind: z.ZodEnum<["entity", "decision", "point"]>;
+    id: z.ZodString;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: "entity" | "decision" | "point";
+    label: string;
+}, {
+    id: string;
+    kind: "entity" | "decision" | "point";
+    label: string;
+}>;
+export type ConstraintItem = z.infer<typeof ConstraintItemSchema>;
+export declare const ChapterComponentSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    when: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
+    depends_on: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    outline_points: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        kind: z.ZodDefault<z.ZodEnum<["entity", "narrative", "mixed"]>>;
+        references: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+        source_segments: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        references: string[];
+        kind: "entity" | "narrative" | "mixed";
+        required: boolean;
+        text: string;
+        source_segments: string[];
+    }, {
+        id: string;
+        text: string;
+        references?: string[] | undefined;
+        kind?: "entity" | "narrative" | "mixed" | undefined;
+        required?: boolean | undefined;
+        source_segments?: string[] | undefined;
+    }>, "many">>, {
+        id: string;
+        references: string[];
+        kind: "entity" | "narrative" | "mixed";
+        required: boolean;
+        text: string;
+        source_segments: string[];
+    }[], {
+        id: string;
+        text: string;
+        references?: string[] | undefined;
+        kind?: "entity" | "narrative" | "mixed" | undefined;
+        required?: boolean | undefined;
+        source_segments?: string[] | undefined;
+    }[] | undefined>;
+    entities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    narratives: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    gates: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    map_prompt: z.ZodOptional<z.ZodString>;
+    output_budget_tokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    depends_on: string[];
+    outline_points: {
+        id: string;
+        references: string[];
+        kind: "entity" | "narrative" | "mixed";
+        required: boolean;
+        text: string;
+        source_segments: string[];
+    }[];
+    gates: string[];
+    when?: string | undefined;
+    entities?: Record<string, any> | undefined;
+    narratives?: Record<string, any> | undefined;
+    map_prompt?: string | undefined;
+    output_budget_tokens?: number | undefined;
+}, {
+    id: string;
+    title: string;
+    when?: unknown;
+    entities?: Record<string, any> | undefined;
+    depends_on?: string[] | undefined;
+    outline_points?: {
+        id: string;
+        text: string;
+        references?: string[] | undefined;
+        kind?: "entity" | "narrative" | "mixed" | undefined;
+        required?: boolean | undefined;
+        source_segments?: string[] | undefined;
+    }[] | undefined;
+    narratives?: Record<string, any> | undefined;
+    gates?: string[] | undefined;
+    map_prompt?: string | undefined;
+    output_budget_tokens?: number | undefined;
+}>;
+export type ChapterComponent = z.infer<typeof ChapterComponentSchema>;
+export declare const ScenarioProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodArray<z.ZodString, "many">;
+    optional_candidates: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    forbidden: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    shared: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], string[] | undefined>;
+    appendices: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodEnum<["anti-ai", "handoff"]>, "many">>, ("handoff" | "anti-ai")[], ("handoff" | "anti-ai")[] | undefined>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    required: string[];
+    optional_candidates: string[];
+    forbidden: string[];
+    shared: string[];
+    appendices: ("handoff" | "anti-ai")[];
+}, {
+    id: string;
+    name: string;
+    required: string[];
+    optional_candidates?: string[] | undefined;
+    forbidden?: string[] | undefined;
+    shared?: string[] | undefined;
+    appendices?: ("handoff" | "anti-ai")[] | undefined;
+}>;
+export type ScenarioProfile = z.infer<typeof ScenarioProfileSchema>;
+export declare const ReviewTargetSchema: z.ZodEnum<["entity", "narrative", "mixed"]>;
+export declare const ReviewFindingSchema: z.ZodObject<{
+    id: z.ZodString;
+    severity: z.ZodEnum<["critical", "important", "minor"]>;
+    category: z.ZodString;
+    message: z.ZodString;
+    target: z.ZodDefault<z.ZodEnum<["entity", "narrative", "mixed"]>>;
+    chapter: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["open", "fixed", "waived"]>>;
+    waiver_reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "fixed" | "open" | "waived";
+    message: string;
+    id: string;
+    severity: "critical" | "important" | "minor";
+    target: "entity" | "narrative" | "mixed";
+    category: string;
+    chapter?: string | undefined;
+    waiver_reason?: string | undefined;
+}, {
+    message: string;
+    id: string;
+    severity: "critical" | "important" | "minor";
+    category: string;
+    status?: "fixed" | "open" | "waived" | undefined;
+    target?: "entity" | "narrative" | "mixed" | undefined;
+    chapter?: string | undefined;
+    waiver_reason?: string | undefined;
+}>;
+export type ReviewFinding = z.infer<typeof ReviewFindingSchema>;
+export declare const ReviewResultSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"specflow.document.review/v1">;
+    change: z.ZodString;
+    reviewed_at: z.ZodString;
+    reviewer: z.ZodDefault<z.ZodEnum<["ai", "human"]>>;
+    verdict: z.ZodEnum<["pass", "fail", "pass_with_waivers"]>;
+    summary: z.ZodOptional<z.ZodString>;
+    findings: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        severity: z.ZodEnum<["critical", "important", "minor"]>;
+        category: z.ZodString;
+        message: z.ZodString;
+        target: z.ZodDefault<z.ZodEnum<["entity", "narrative", "mixed"]>>;
+        chapter: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<["open", "fixed", "waived"]>>;
+        waiver_reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "fixed" | "open" | "waived";
+        message: string;
+        id: string;
+        severity: "critical" | "important" | "minor";
+        target: "entity" | "narrative" | "mixed";
+        category: string;
+        chapter?: string | undefined;
+        waiver_reason?: string | undefined;
+    }, {
+        message: string;
+        id: string;
+        severity: "critical" | "important" | "minor";
+        category: string;
+        status?: "fixed" | "open" | "waived" | undefined;
+        target?: "entity" | "narrative" | "mixed" | undefined;
+        chapter?: string | undefined;
+        waiver_reason?: string | undefined;
+    }>, "many">>, {
+        status: "fixed" | "open" | "waived";
+        message: string;
+        id: string;
+        severity: "critical" | "important" | "minor";
+        target: "entity" | "narrative" | "mixed";
+        category: string;
+        chapter?: string | undefined;
+        waiver_reason?: string | undefined;
+    }[], {
+        message: string;
+        id: string;
+        severity: "critical" | "important" | "minor";
+        category: string;
+        status?: "fixed" | "open" | "waived" | undefined;
+        target?: "entity" | "narrative" | "mixed" | undefined;
+        chapter?: string | undefined;
+        waiver_reason?: string | undefined;
+    }[] | undefined>;
+    part_hashes: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sha256: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        sha256: string;
+    }, {
+        id: string;
+        sha256: string;
+    }>, "many">>, {
+        id: string;
+        sha256: string;
+    }[], {
+        id: string;
+        sha256: string;
+    }[] | undefined>;
+    /** decision 9 · tamper semantics: chapters the ENGINE legitimately changed after the review
+     *  snapshot (entity refill / narrative fix notes). The tamper check exempts these from the
+     *  post-review "stale" verdict — every other chapter must still match the reviewer-time
+     *  `part_hashes` snapshot. */
+    post_review_repairs: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        chapter: z.ZodString;
+        at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        chapter: string;
+    }, {
+        at: string;
+        chapter: string;
+    }>, "many">>, {
+        at: string;
+        chapter: string;
+    }[], {
+        at: string;
+        chapter: string;
+    }[] | undefined>;
+}, "strip", z.ZodTypeAny, {
+    schema: "specflow.document.review/v1";
+    change: string;
+    reviewed_at: string;
+    reviewer: "ai" | "human";
+    verdict: "fail" | "pass" | "pass_with_waivers";
+    findings: {
+        status: "fixed" | "open" | "waived";
+        message: string;
+        id: string;
+        severity: "critical" | "important" | "minor";
+        target: "entity" | "narrative" | "mixed";
+        category: string;
+        chapter?: string | undefined;
+        waiver_reason?: string | undefined;
+    }[];
+    part_hashes: {
+        id: string;
+        sha256: string;
+    }[];
+    post_review_repairs: {
+        at: string;
+        chapter: string;
+    }[];
+    summary?: string | undefined;
+}, {
+    schema: "specflow.document.review/v1";
+    change: string;
+    reviewed_at: string;
+    verdict: "fail" | "pass" | "pass_with_waivers";
+    reviewer?: "ai" | "human" | undefined;
+    summary?: string | undefined;
+    findings?: {
+        message: string;
+        id: string;
+        severity: "critical" | "important" | "minor";
+        category: string;
+        status?: "fixed" | "open" | "waived" | undefined;
+        target?: "entity" | "narrative" | "mixed" | undefined;
+        chapter?: string | undefined;
+        waiver_reason?: string | undefined;
+    }[] | undefined;
+    part_hashes?: {
+        id: string;
+        sha256: string;
+    }[] | undefined;
+    post_review_repairs?: {
+        at: string;
+        chapter: string;
+    }[] | undefined;
+}>;
+export type ReviewResult = z.infer<typeof ReviewResultSchema>;
+export declare function parseReviewResult(raw: unknown): ReviewResult;
+export declare function parseInterfaceEntity(raw: unknown): InterfaceEntity;
+export declare function parseTableEntity(raw: unknown): TableEntity;
+export declare function parseDecisionEntity(raw: unknown): DecisionEntity;
+export declare function parseEntities(raw: unknown): Entities;
+/**
+ * 兼容两种章节 JSON 块格式的实体解析：
+ *   - 未包装：`{"interfaces": [...], "tables": [...], "decisions": [...]}`（引擎推荐，validate 期望）
+ *   - 包装：`{"entities": {"interfaces": [...]}}`（部分 map 提示词曾要求，Agent 可能照此写）
+ * zod 默认 strip 未知 key，若顶层只有 `entities` 会被剥成空实体——这里显式解包后再解析，
+ * 避免「提示词包装格式 → 实体被剥空 → validate 报缺失 → Agent 反复返工」。
+ */
+export declare function parseEntitiesLenient(raw: unknown): Entities;
+export declare function parseOutline(raw: unknown): Outline;
+export declare function parseChapterComponent(raw: unknown): ChapterComponent;
+export declare function parseScenarioProfile(raw: unknown): ScenarioProfile;