@structured-vibe-coding/core 0.2.2

package/dist/index.d.ts

@@ -0,0 +1,1224 @@
+import { z } from 'zod';
+
+declare const GateSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
+    mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
+    checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    overridable: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "none" | "soft" | "hard";
+    checklist: string[];
+    mode: "none" | "human_approval" | "checklist";
+    overridable: boolean;
+}, {
+    type?: "none" | "soft" | "hard" | undefined;
+    checklist?: string[] | undefined;
+    mode?: "none" | "human_approval" | "checklist" | undefined;
+    overridable?: boolean | undefined;
+}>;
+declare const ArtifactDefSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    template: z.ZodOptional<z.ZodString>;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    id: string;
+    required: boolean;
+    template?: string | undefined;
+}, {
+    path: string;
+    id: string;
+    template?: string | undefined;
+    required?: boolean | undefined;
+}>;
+declare const VerifyCommandSchema: z.ZodObject<{
+    name: z.ZodString;
+    run: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    required: boolean;
+    name: string;
+    run: string;
+}, {
+    name: string;
+    run: string;
+    required?: boolean | undefined;
+}>;
+declare const StageSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        template: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        id: string;
+        required: boolean;
+        template?: string | undefined;
+    }, {
+        path: string;
+        id: string;
+        template?: string | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+    gate: z.ZodDefault<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
+        mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
+        checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        overridable: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "none" | "soft" | "hard";
+        checklist: string[];
+        mode: "none" | "human_approval" | "checklist";
+        overridable: boolean;
+    }, {
+        type?: "none" | "soft" | "hard" | undefined;
+        checklist?: string[] | undefined;
+        mode?: "none" | "human_approval" | "checklist" | undefined;
+        overridable?: boolean | undefined;
+    }>>;
+    skippable: z.ZodDefault<z.ZodBoolean>;
+    skip_when: z.ZodOptional<z.ZodObject<{
+        flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        flags?: string[] | undefined;
+    }, {
+        flags?: string[] | undefined;
+    }>>;
+    verify: z.ZodOptional<z.ZodObject<{
+        commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            run: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            required: boolean;
+            name: string;
+            run: string;
+        }, {
+            name: string;
+            run: string;
+            required?: boolean | undefined;
+        }>, "many">>;
+        evidence_dir: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        commands: {
+            required: boolean;
+            name: string;
+            run: string;
+        }[];
+        evidence_dir?: string | undefined;
+    }, {
+        commands?: {
+            name: string;
+            run: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        evidence_dir?: string | undefined;
+    }>>;
+    agent_context: z.ZodOptional<z.ZodObject<{
+        include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        include: string[];
+        instructions?: string | undefined;
+    }, {
+        include?: string[] | undefined;
+        instructions?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    artifacts: {
+        path: string;
+        id: string;
+        required: boolean;
+        template?: string | undefined;
+    }[];
+    gate: {
+        type: "none" | "soft" | "hard";
+        checklist: string[];
+        mode: "none" | "human_approval" | "checklist";
+        overridable: boolean;
+    };
+    skippable: boolean;
+    title?: string | undefined;
+    summary?: string | undefined;
+    skip_when?: {
+        flags?: string[] | undefined;
+    } | undefined;
+    verify?: {
+        commands: {
+            required: boolean;
+            name: string;
+            run: string;
+        }[];
+        evidence_dir?: string | undefined;
+    } | undefined;
+    agent_context?: {
+        include: string[];
+        instructions?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    title?: string | undefined;
+    summary?: string | undefined;
+    artifacts?: {
+        path: string;
+        id: string;
+        template?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+    gate?: {
+        type?: "none" | "soft" | "hard" | undefined;
+        checklist?: string[] | undefined;
+        mode?: "none" | "human_approval" | "checklist" | undefined;
+        overridable?: boolean | undefined;
+    } | undefined;
+    skippable?: boolean | undefined;
+    skip_when?: {
+        flags?: string[] | undefined;
+    } | undefined;
+    verify?: {
+        commands?: {
+            name: string;
+            run: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        evidence_dir?: string | undefined;
+    } | undefined;
+    agent_context?: {
+        include?: string[] | undefined;
+        instructions?: string | undefined;
+    } | undefined;
+}>;
+declare const WorkflowSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodNumber>;
+    stages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            path: z.ZodString;
+            template: z.ZodOptional<z.ZodString>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            id: string;
+            required: boolean;
+            template?: string | undefined;
+        }, {
+            path: string;
+            id: string;
+            template?: string | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        gate: z.ZodDefault<z.ZodObject<{
+            type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
+            mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
+            checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            overridable: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: "none" | "soft" | "hard";
+            checklist: string[];
+            mode: "none" | "human_approval" | "checklist";
+            overridable: boolean;
+        }, {
+            type?: "none" | "soft" | "hard" | undefined;
+            checklist?: string[] | undefined;
+            mode?: "none" | "human_approval" | "checklist" | undefined;
+            overridable?: boolean | undefined;
+        }>>;
+        skippable: z.ZodDefault<z.ZodBoolean>;
+        skip_when: z.ZodOptional<z.ZodObject<{
+            flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            flags?: string[] | undefined;
+        }, {
+            flags?: string[] | undefined;
+        }>>;
+        verify: z.ZodOptional<z.ZodObject<{
+            commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                run: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                required: boolean;
+                name: string;
+                run: string;
+            }, {
+                name: string;
+                run: string;
+                required?: boolean | undefined;
+            }>, "many">>;
+            evidence_dir: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            commands: {
+                required: boolean;
+                name: string;
+                run: string;
+            }[];
+            evidence_dir?: string | undefined;
+        }, {
+            commands?: {
+                name: string;
+                run: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+            evidence_dir?: string | undefined;
+        }>>;
+        agent_context: z.ZodOptional<z.ZodObject<{
+            include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            instructions: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            include: string[];
+            instructions?: string | undefined;
+        }, {
+            include?: string[] | undefined;
+            instructions?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        artifacts: {
+            path: string;
+            id: string;
+            required: boolean;
+            template?: string | undefined;
+        }[];
+        gate: {
+            type: "none" | "soft" | "hard";
+            checklist: string[];
+            mode: "none" | "human_approval" | "checklist";
+            overridable: boolean;
+        };
+        skippable: boolean;
+        title?: string | undefined;
+        summary?: string | undefined;
+        skip_when?: {
+            flags?: string[] | undefined;
+        } | undefined;
+        verify?: {
+            commands: {
+                required: boolean;
+                name: string;
+                run: string;
+            }[];
+            evidence_dir?: string | undefined;
+        } | undefined;
+        agent_context?: {
+            include: string[];
+            instructions?: string | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        title?: string | undefined;
+        summary?: string | undefined;
+        artifacts?: {
+            path: string;
+            id: string;
+            template?: string | undefined;
+            required?: boolean | undefined;
+        }[] | undefined;
+        gate?: {
+            type?: "none" | "soft" | "hard" | undefined;
+            checklist?: string[] | undefined;
+            mode?: "none" | "human_approval" | "checklist" | undefined;
+            overridable?: boolean | undefined;
+        } | undefined;
+        skippable?: boolean | undefined;
+        skip_when?: {
+            flags?: string[] | undefined;
+        } | undefined;
+        verify?: {
+            commands?: {
+                name: string;
+                run: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+            evidence_dir?: string | undefined;
+        } | undefined;
+        agent_context?: {
+            include?: string[] | undefined;
+            instructions?: string | undefined;
+        } | undefined;
+    }>, "many">;
+    recommendation: z.ZodOptional<z.ZodObject<{
+        when: z.ZodOptional<z.ZodObject<{
+            labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            max_complexity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+            min_complexity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+        }, "strip", z.ZodTypeAny, {
+            labels?: string[] | undefined;
+            keywords?: string[] | undefined;
+            max_complexity?: "low" | "medium" | "high" | undefined;
+            min_complexity?: "low" | "medium" | "high" | undefined;
+        }, {
+            labels?: string[] | undefined;
+            keywords?: string[] | undefined;
+            max_complexity?: "low" | "medium" | "high" | undefined;
+            min_complexity?: "low" | "medium" | "high" | undefined;
+        }>>;
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        priority: number;
+        when?: {
+            labels?: string[] | undefined;
+            keywords?: string[] | undefined;
+            max_complexity?: "low" | "medium" | "high" | undefined;
+            min_complexity?: "low" | "medium" | "high" | undefined;
+        } | undefined;
+    }, {
+        when?: {
+            labels?: string[] | undefined;
+            keywords?: string[] | undefined;
+            max_complexity?: "low" | "medium" | "high" | undefined;
+            min_complexity?: "low" | "medium" | "high" | undefined;
+        } | undefined;
+        priority?: number | undefined;
+    }>>;
+    on_complete: z.ZodOptional<z.ZodObject<{
+        archive: z.ZodDefault<z.ZodBoolean>;
+        domain_sync: z.ZodDefault<z.ZodEnum<["never", "recommend", "require"]>>;
+    }, "strip", z.ZodTypeAny, {
+        archive: boolean;
+        domain_sync: "never" | "recommend" | "require";
+    }, {
+        archive?: boolean | undefined;
+        domain_sync?: "never" | "recommend" | "require" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: number;
+    stages: {
+        id: string;
+        artifacts: {
+            path: string;
+            id: string;
+            required: boolean;
+            template?: string | undefined;
+        }[];
+        gate: {
+            type: "none" | "soft" | "hard";
+            checklist: string[];
+            mode: "none" | "human_approval" | "checklist";
+            overridable: boolean;
+        };
+        skippable: boolean;
+        title?: string | undefined;
+        summary?: string | undefined;
+        skip_when?: {
+            flags?: string[] | undefined;
+        } | undefined;
+        verify?: {
+            commands: {
+                required: boolean;
+                name: string;
+                run: string;
+            }[];
+            evidence_dir?: string | undefined;
+        } | undefined;
+        agent_context?: {
+            include: string[];
+            instructions?: string | undefined;
+        } | undefined;
+    }[];
+    description?: string | undefined;
+    recommendation?: {
+        priority: number;
+        when?: {
+            labels?: string[] | undefined;
+            keywords?: string[] | undefined;
+            max_complexity?: "low" | "medium" | "high" | undefined;
+            min_complexity?: "low" | "medium" | "high" | undefined;
+        } | undefined;
+    } | undefined;
+    on_complete?: {
+        archive: boolean;
+        domain_sync: "never" | "recommend" | "require";
+    } | undefined;
+}, {
+    name: string;
+    stages: {
+        id: string;
+        title?: string | undefined;
+        summary?: string | undefined;
+        artifacts?: {
+            path: string;
+            id: string;
+            template?: string | undefined;
+            required?: boolean | undefined;
+        }[] | undefined;
+        gate?: {
+            type?: "none" | "soft" | "hard" | undefined;
+            checklist?: string[] | undefined;
+            mode?: "none" | "human_approval" | "checklist" | undefined;
+            overridable?: boolean | undefined;
+        } | undefined;
+        skippable?: boolean | undefined;
+        skip_when?: {
+            flags?: string[] | undefined;
+        } | undefined;
+        verify?: {
+            commands?: {
+                name: string;
+                run: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+            evidence_dir?: string | undefined;
+        } | undefined;
+        agent_context?: {
+            include?: string[] | undefined;
+            instructions?: string | undefined;
+        } | undefined;
+    }[];
+    description?: string | undefined;
+    version?: number | undefined;
+    recommendation?: {
+        when?: {
+            labels?: string[] | undefined;
+            keywords?: string[] | undefined;
+            max_complexity?: "low" | "medium" | "high" | undefined;
+            min_complexity?: "low" | "medium" | "high" | undefined;
+        } | undefined;
+        priority?: number | undefined;
+    } | undefined;
+    on_complete?: {
+        archive?: boolean | undefined;
+        domain_sync?: "never" | "recommend" | "require" | undefined;
+    } | undefined;
+}>;
+declare const ConfigSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    memory_path: z.ZodDefault<z.ZodString>;
+    changes_path: z.ZodDefault<z.ZodString>;
+    archive_path: z.ZodDefault<z.ZodString>;
+    domains_path: z.ZodDefault<z.ZodString>;
+    default_workflow: z.ZodDefault<z.ZodString>;
+    allowed_workflows: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    per_change: z.ZodDefault<z.ZodObject<{
+        allow_skip: z.ZodDefault<z.ZodBoolean>;
+        allow_gate_override: z.ZodDefault<z.ZodEnum<["true", "false", "soft_only"]>>;
+        allow_custom_stages: z.ZodDefault<z.ZodBoolean>;
+        require_reason_on_skip: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        allow_skip: boolean;
+        allow_gate_override: "true" | "false" | "soft_only";
+        allow_custom_stages: boolean;
+        require_reason_on_skip: boolean;
+    }, {
+        allow_skip?: boolean | undefined;
+        allow_gate_override?: "true" | "false" | "soft_only" | undefined;
+        allow_custom_stages?: boolean | undefined;
+        require_reason_on_skip?: boolean | undefined;
+    }>>;
+    persistence: z.ZodDefault<z.ZodObject<{
+        default: z.ZodDefault<z.ZodEnum<["change_only", "domain_sync"]>>;
+        archive_on_complete: z.ZodDefault<z.ZodBoolean>;
+        domain_sync: z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<["never", "recommend", "require"]>>;
+            anchored_domains: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "never" | "recommend" | "require";
+            anchored_domains: string[];
+        }, {
+            mode?: "never" | "recommend" | "require" | undefined;
+            anchored_domains?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        domain_sync: {
+            mode: "never" | "recommend" | "require";
+            anchored_domains: string[];
+        };
+        default: "domain_sync" | "change_only";
+        archive_on_complete: boolean;
+    }, {
+        domain_sync?: {
+            mode?: "never" | "recommend" | "require" | undefined;
+            anchored_domains?: string[] | undefined;
+        } | undefined;
+        default?: "domain_sync" | "change_only" | undefined;
+        archive_on_complete?: boolean | undefined;
+    }>>;
+    policy: z.ZodDefault<z.ZodObject<{
+        gates: z.ZodDefault<z.ZodEnum<["soft", "hard"]>>;
+    }, "strip", z.ZodTypeAny, {
+        gates: "soft" | "hard";
+    }, {
+        gates?: "soft" | "hard" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    memory_path: string;
+    changes_path: string;
+    archive_path: string;
+    domains_path: string;
+    default_workflow: string;
+    per_change: {
+        allow_skip: boolean;
+        allow_gate_override: "true" | "false" | "soft_only";
+        allow_custom_stages: boolean;
+        require_reason_on_skip: boolean;
+    };
+    persistence: {
+        domain_sync: {
+            mode: "never" | "recommend" | "require";
+            anchored_domains: string[];
+        };
+        default: "domain_sync" | "change_only";
+        archive_on_complete: boolean;
+    };
+    policy: {
+        gates: "soft" | "hard";
+    };
+    allowed_workflows?: string[] | undefined;
+}, {
+    version?: number | undefined;
+    memory_path?: string | undefined;
+    changes_path?: string | undefined;
+    archive_path?: string | undefined;
+    domains_path?: string | undefined;
+    default_workflow?: string | undefined;
+    allowed_workflows?: string[] | undefined;
+    per_change?: {
+        allow_skip?: boolean | undefined;
+        allow_gate_override?: "true" | "false" | "soft_only" | undefined;
+        allow_custom_stages?: boolean | undefined;
+        require_reason_on_skip?: boolean | undefined;
+    } | undefined;
+    persistence?: {
+        domain_sync?: {
+            mode?: "never" | "recommend" | "require" | undefined;
+            anchored_domains?: string[] | undefined;
+        } | undefined;
+        default?: "domain_sync" | "change_only" | undefined;
+        archive_on_complete?: boolean | undefined;
+    } | undefined;
+    policy?: {
+        gates?: "soft" | "hard" | undefined;
+    } | undefined;
+}>;
+declare const ChangeMetaSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    workflow: z.ZodString;
+    created: z.ZodString;
+    updated: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["in_progress", "blocked", "completed", "abandoned"]>>;
+    stage: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    flags: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodBoolean, z.ZodString, z.ZodNumber]>>>;
+    overrides: z.ZodDefault<z.ZodObject<{
+        skip_stages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        gates: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["none", "soft", "hard"]>>>;
+        extra_stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                path: z.ZodString;
+                template: z.ZodOptional<z.ZodString>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                id: string;
+                required: boolean;
+                template?: string | undefined;
+            }, {
+                path: string;
+                id: string;
+                template?: string | undefined;
+                required?: boolean | undefined;
+            }>, "many">>;
+            gate: z.ZodDefault<z.ZodObject<{
+                type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
+                mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
+                checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                overridable: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                type: "none" | "soft" | "hard";
+                checklist: string[];
+                mode: "none" | "human_approval" | "checklist";
+                overridable: boolean;
+            }, {
+                type?: "none" | "soft" | "hard" | undefined;
+                checklist?: string[] | undefined;
+                mode?: "none" | "human_approval" | "checklist" | undefined;
+                overridable?: boolean | undefined;
+            }>>;
+            skippable: z.ZodDefault<z.ZodBoolean>;
+            skip_when: z.ZodOptional<z.ZodObject<{
+                flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                flags?: string[] | undefined;
+            }, {
+                flags?: string[] | undefined;
+            }>>;
+            verify: z.ZodOptional<z.ZodObject<{
+                commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    run: z.ZodString;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, "strip", z.ZodTypeAny, {
+                    required: boolean;
+                    name: string;
+                    run: string;
+                }, {
+                    name: string;
+                    run: string;
+                    required?: boolean | undefined;
+                }>, "many">>;
+                evidence_dir: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                commands: {
+                    required: boolean;
+                    name: string;
+                    run: string;
+                }[];
+                evidence_dir?: string | undefined;
+            }, {
+                commands?: {
+                    name: string;
+                    run: string;
+                    required?: boolean | undefined;
+                }[] | undefined;
+                evidence_dir?: string | undefined;
+            }>>;
+            agent_context: z.ZodOptional<z.ZodObject<{
+                include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                instructions: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                include: string[];
+                instructions?: string | undefined;
+            }, {
+                include?: string[] | undefined;
+                instructions?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            artifacts: {
+                path: string;
+                id: string;
+                required: boolean;
+                template?: string | undefined;
+            }[];
+            gate: {
+                type: "none" | "soft" | "hard";
+                checklist: string[];
+                mode: "none" | "human_approval" | "checklist";
+                overridable: boolean;
+            };
+            skippable: boolean;
+            title?: string | undefined;
+            summary?: string | undefined;
+            skip_when?: {
+                flags?: string[] | undefined;
+            } | undefined;
+            verify?: {
+                commands: {
+                    required: boolean;
+                    name: string;
+                    run: string;
+                }[];
+                evidence_dir?: string | undefined;
+            } | undefined;
+            agent_context?: {
+                include: string[];
+                instructions?: string | undefined;
+            } | undefined;
+        }, {
+            id: string;
+            title?: string | undefined;
+            summary?: string | undefined;
+            artifacts?: {
+                path: string;
+                id: string;
+                template?: string | undefined;
+                required?: boolean | undefined;
+            }[] | undefined;
+            gate?: {
+                type?: "none" | "soft" | "hard" | undefined;
+                checklist?: string[] | undefined;
+                mode?: "none" | "human_approval" | "checklist" | undefined;
+                overridable?: boolean | undefined;
+            } | undefined;
+            skippable?: boolean | undefined;
+            skip_when?: {
+                flags?: string[] | undefined;
+            } | undefined;
+            verify?: {
+                commands?: {
+                    name: string;
+                    run: string;
+                    required?: boolean | undefined;
+                }[] | undefined;
+                evidence_dir?: string | undefined;
+            } | undefined;
+            agent_context?: {
+                include?: string[] | undefined;
+                instructions?: string | undefined;
+            } | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        gates: Record<string, "none" | "soft" | "hard">;
+        skip_stages: string[];
+        extra_stages: {
+            id: string;
+            artifacts: {
+                path: string;
+                id: string;
+                required: boolean;
+                template?: string | undefined;
+            }[];
+            gate: {
+                type: "none" | "soft" | "hard";
+                checklist: string[];
+                mode: "none" | "human_approval" | "checklist";
+                overridable: boolean;
+            };
+            skippable: boolean;
+            title?: string | undefined;
+            summary?: string | undefined;
+            skip_when?: {
+                flags?: string[] | undefined;
+            } | undefined;
+            verify?: {
+                commands: {
+                    required: boolean;
+                    name: string;
+                    run: string;
+                }[];
+                evidence_dir?: string | undefined;
+            } | undefined;
+            agent_context?: {
+                include: string[];
+                instructions?: string | undefined;
+            } | undefined;
+        }[];
+    }, {
+        gates?: Record<string, "none" | "soft" | "hard"> | undefined;
+        skip_stages?: string[] | undefined;
+        extra_stages?: {
+            id: string;
+            title?: string | undefined;
+            summary?: string | undefined;
+            artifacts?: {
+                path: string;
+                id: string;
+                template?: string | undefined;
+                required?: boolean | undefined;
+            }[] | undefined;
+            gate?: {
+                type?: "none" | "soft" | "hard" | undefined;
+                checklist?: string[] | undefined;
+                mode?: "none" | "human_approval" | "checklist" | undefined;
+                overridable?: boolean | undefined;
+            } | undefined;
+            skippable?: boolean | undefined;
+            skip_when?: {
+                flags?: string[] | undefined;
+            } | undefined;
+            verify?: {
+                commands?: {
+                    name: string;
+                    run: string;
+                    required?: boolean | undefined;
+                }[] | undefined;
+                evidence_dir?: string | undefined;
+            } | undefined;
+            agent_context?: {
+                include?: string[] | undefined;
+                instructions?: string | undefined;
+            } | undefined;
+        }[] | undefined;
+    }>>;
+    skipped: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        stage: z.ZodString;
+        reason: z.ZodString;
+        at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        stage: string;
+        reason: string;
+    }, {
+        at: string;
+        stage: string;
+        reason: string;
+    }>, "many">>;
+    gates: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<["pending", "approved", "failed", "waived"]>;
+        note: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "approved" | "failed" | "waived";
+        at?: string | undefined;
+        note?: string | undefined;
+    }, {
+        status: "pending" | "approved" | "failed" | "waived";
+        at?: string | undefined;
+        note?: string | undefined;
+    }>>>;
+    /** Results from `sdd verify` keyed by stage id */
+    verify_results: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        ok: z.ZodBoolean;
+        at: z.ZodString;
+        results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            exitCode: number | null;
+        }, {
+            name: string;
+            exitCode: number | null;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        ok: boolean;
+        results: {
+            name: string;
+            exitCode: number | null;
+        }[];
+    }, {
+        at: string;
+        ok: boolean;
+        results?: {
+            name: string;
+            exitCode: number | null;
+        }[] | undefined;
+    }>>>;
+    pr: z.ZodOptional<z.ZodObject<{
+        number: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        number?: number | undefined;
+        url?: string | undefined;
+    }, {
+        number?: number | undefined;
+        url?: string | undefined;
+    }>>;
+    completed_at: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "in_progress" | "blocked" | "completed" | "abandoned";
+    id: string;
+    title: string;
+    flags: Record<string, string | number | boolean>;
+    gates: Record<string, {
+        status: "pending" | "approved" | "failed" | "waived";
+        at?: string | undefined;
+        note?: string | undefined;
+    }>;
+    workflow: string;
+    created: string;
+    stage: string;
+    overrides: {
+        gates: Record<string, "none" | "soft" | "hard">;
+        skip_stages: string[];
+        extra_stages: {
+            id: string;
+            artifacts: {
+                path: string;
+                id: string;
+                required: boolean;
+                template?: string | undefined;
+            }[];
+            gate: {
+                type: "none" | "soft" | "hard";
+                checklist: string[];
+                mode: "none" | "human_approval" | "checklist";
+                overridable: boolean;
+            };
+            skippable: boolean;
+            title?: string | undefined;
+            summary?: string | undefined;
+            skip_when?: {
+                flags?: string[] | undefined;
+            } | undefined;
+            verify?: {
+                commands: {
+                    required: boolean;
+                    name: string;
+                    run: string;
+                }[];
+                evidence_dir?: string | undefined;
+            } | undefined;
+            agent_context?: {
+                include: string[];
+                instructions?: string | undefined;
+            } | undefined;
+        }[];
+    };
+    skipped: {
+        at: string;
+        stage: string;
+        reason: string;
+    }[];
+    verify_results: Record<string, {
+        at: string;
+        ok: boolean;
+        results: {
+            name: string;
+            exitCode: number | null;
+        }[];
+    }>;
+    updated?: string | undefined;
+    branch?: string | undefined;
+    domain?: string | undefined;
+    pr?: {
+        number?: number | undefined;
+        url?: string | undefined;
+    } | undefined;
+    completed_at?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    workflow: string;
+    created: string;
+    stage: string;
+    status?: "in_progress" | "blocked" | "completed" | "abandoned" | undefined;
+    flags?: Record<string, string | number | boolean> | undefined;
+    gates?: Record<string, {
+        status: "pending" | "approved" | "failed" | "waived";
+        at?: string | undefined;
+        note?: string | undefined;
+    }> | undefined;
+    updated?: string | undefined;
+    branch?: string | undefined;
+    domain?: string | undefined;
+    overrides?: {
+        gates?: Record<string, "none" | "soft" | "hard"> | undefined;
+        skip_stages?: string[] | undefined;
+        extra_stages?: {
+            id: string;
+            title?: string | undefined;
+            summary?: string | undefined;
+            artifacts?: {
+                path: string;
+                id: string;
+                template?: string | undefined;
+                required?: boolean | undefined;
+            }[] | undefined;
+            gate?: {
+                type?: "none" | "soft" | "hard" | undefined;
+                checklist?: string[] | undefined;
+                mode?: "none" | "human_approval" | "checklist" | undefined;
+                overridable?: boolean | undefined;
+            } | undefined;
+            skippable?: boolean | undefined;
+            skip_when?: {
+                flags?: string[] | undefined;
+            } | undefined;
+            verify?: {
+                commands?: {
+                    name: string;
+                    run: string;
+                    required?: boolean | undefined;
+                }[] | undefined;
+                evidence_dir?: string | undefined;
+            } | undefined;
+            agent_context?: {
+                include?: string[] | undefined;
+                instructions?: string | undefined;
+            } | undefined;
+        }[] | undefined;
+    } | undefined;
+    skipped?: {
+        at: string;
+        stage: string;
+        reason: string;
+    }[] | undefined;
+    verify_results?: Record<string, {
+        at: string;
+        ok: boolean;
+        results?: {
+            name: string;
+            exitCode: number | null;
+        }[] | undefined;
+    }> | undefined;
+    pr?: {
+        number?: number | undefined;
+        url?: string | undefined;
+    } | undefined;
+    completed_at?: string | undefined;
+}>;
+type Gate = z.infer<typeof GateSchema>;
+type ArtifactDef = z.infer<typeof ArtifactDefSchema>;
+type Stage = z.infer<typeof StageSchema>;
+type Workflow = z.infer<typeof WorkflowSchema>;
+type Config = z.infer<typeof ConfigSchema>;
+type ChangeMeta = z.infer<typeof ChangeMetaSchema>;
+type Complexity = "low" | "medium" | "high";
+
+declare const SDD_DIR = ".sdd";
+declare function sddRoot(projectRoot: string): string;
+declare function configPath(projectRoot: string): string;
+declare function workflowsDir(projectRoot: string): string;
+declare function templatesDir(projectRoot: string): string;
+declare function memoryDir(projectRoot: string, config: Config): string;
+declare function changesDir(projectRoot: string, config: Config): string;
+declare function archiveDir(projectRoot: string, config: Config): string;
+declare function domainsDir(projectRoot: string, config: Config): string;
+declare function changePath(projectRoot: string, config: Config, changeId: string): string;
+declare function changeMetaPath(projectRoot: string, config: Config, changeId: string): string;
+declare function activePointerPath(projectRoot: string, config: Config): string;
+
+declare function isInitialized(projectRoot: string): Promise<boolean>;
+declare function loadConfig(projectRoot: string): Promise<Config>;
+declare function saveConfig(projectRoot: string, config: Config): Promise<void>;
+declare function defaultConfig(): Config;
+declare function projectPaths(projectRoot: string, config: Config): {
+    sdd: string;
+    config: string;
+    workflows: string;
+    templates: string;
+    memory: string;
+};
+
+declare function listWorkflowNames(projectRoot: string): Promise<string[]>;
+declare function loadWorkflow(projectRoot: string, name: string): Promise<Workflow>;
+/** Resolve effective stages for a change (workflow + per-change overrides). */
+declare function resolveStages(workflow: Workflow, meta: ChangeMeta): Stage[];
+declare function isStageSkipped(meta: ChangeMeta, stageId: string): boolean;
+declare function shouldAutoSkip(stage: Stage, meta: ChangeMeta): boolean;
+/** Ordered list of active (non-skipped) stages for navigation. */
+declare function activeStages(workflow: Workflow, meta: ChangeMeta): Stage[];
+declare function getStage(workflow: Workflow, meta: ChangeMeta, stageId: string): Stage | undefined;
+/**
+ * Next *active* stage after the current one in full workflow order.
+ * If the current stage is skipped/missing from the active list, still walks
+ * forward from its position in the full stage list (does not jump back to first).
+ */
+declare function nextStageId(workflow: Workflow, meta: ChangeMeta): string | null;
+declare function previousStageId(workflow: Workflow, meta: ChangeMeta): string | null;
+/** First active stage (honors skip / skip_when). */
+declare function firstActiveStageId(workflow: Workflow, meta: ChangeMeta): string | null;
+declare function inferComplexity(title: string, hints?: {
+    keywords?: string[];
+}): Complexity;
+declare function recommendWorkflow(projectRoot: string, title: string, config: Config, opts?: {
+    preferred?: string;
+    complexity?: Complexity;
+}): Promise<{
+    name: string;
+    reason: string;
+    alternatives: string[];
+}>;
+
+interface CreateChangeInput {
+    projectRoot: string;
+    config: Config;
+    title: string;
+    workflowName: string;
+    domain?: string;
+    flags?: Record<string, boolean | string | number>;
+    branch?: string;
+}
+interface ChangeContext {
+    id: string;
+    path: string;
+    meta: ChangeMeta;
+    workflow: Workflow;
+    stages: Stage[];
+    active: Stage[];
+}
+declare function createChange(input: CreateChangeInput): Promise<ChangeContext>;
+declare function loadChangeMeta(projectRoot: string, config: Config, changeId: string): Promise<ChangeMeta>;
+declare function saveChangeMeta(projectRoot: string, config: Config, meta: ChangeMeta): Promise<void>;
+declare function buildContext(projectRoot: string, config: Config, changeId: string): Promise<ChangeContext>;
+declare function listChanges(projectRoot: string, config: Config): Promise<string[]>;
+declare function getActiveChangeId(projectRoot: string, config: Config): Promise<string | null>;
+/** Clear active pointer if it points at this change id (does not re-resolve). */
+declare function clearActiveIf(projectRoot: string, config: Config, changeId: string): Promise<void>;
+declare function setActiveChange(projectRoot: string, config: Config, changeId: string): Promise<void>;
+declare function resolveChangeId(projectRoot: string, config: Config, changeId?: string): Promise<string>;
+interface AdvanceResult {
+    ctx: ChangeContext;
+    from: string;
+    to: string | null;
+    completed: boolean;
+    artifactsCreated: string[];
+    warnings: string[];
+}
+declare function canLeaveStage(ctx: ChangeContext, config: Config): Promise<{
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+}>;
+declare function advanceStage(projectRoot: string, config: Config, changeId: string, opts?: {
+    force?: boolean;
+}): Promise<AdvanceResult>;
+declare function skipStage(projectRoot: string, config: Config, changeId: string, stageId: string, reason: string): Promise<ChangeContext>;
+declare function switchWorkflow(projectRoot: string, config: Config, changeId: string, workflowName: string, reason?: string): Promise<ChangeContext>;
+declare function approveGate(projectRoot: string, config: Config, changeId: string, stageId: string | undefined, note?: string, status?: "approved" | "waived" | "failed"): Promise<ChangeContext>;
+declare function completeChange(projectRoot: string, config: Config, changeId: string): Promise<{
+    archivedTo: string | null;
+    ctx: ChangeContext;
+}>;
+declare function formatStatus(ctx: ChangeContext): string;
+declare function buildAgentPrompt(ctx: ChangeContext, config: Config, projectRoot: string): Promise<string>;
+
+interface InitOptions {
+    projectRoot: string;
+    force?: boolean;
+    pack?: "default" | "enterprise";
+}
+interface InitResult {
+    created: string[];
+    config: Config;
+}
+declare function initProject(opts: InitOptions): Promise<InitResult>;
+
+interface VerifyResult {
+    stageId: string;
+    results: {
+        name: string;
+        command: string;
+        exitCode: number | null;
+        output: string;
+    }[];
+    checklist: string[];
+    evidencePath: string;
+    /** False if any required command failed or was not run when required */
+    ok: boolean;
+}
+declare function runLocalVerify(projectRoot: string, config: Config, changeId: string, opts?: {
+    runCommands?: boolean;
+}): Promise<VerifyResult>;
+
+declare function slugify(input: string): string;
+declare function todayIsoDate(d?: Date): string;
+declare function nowIso(d?: Date): string;
+declare function changeDirName(title: string, d?: Date): string;
+/** Append -2, -3, … when base id is already taken. */
+declare function uniqueChangeDirName(base: string, taken: Set<string>): string;
+
+/**
+ * Packaged default assets shipped with @structured-vibe-coding/core.
+ * Resolves correctly for:
+ * - package layout: packages/core/dist/index.js → ../defaults
+ * - VS Code bundle: packages/vscode/dist/extension.js → ./defaults (copied at build)
+ */
+declare function defaultsRoot(): string;
+declare function defaultWorkflowsDir(): string;
+declare function defaultTemplatesDir(): string;
+declare function defaultMemoryDir(): string;
+
+declare function pathExists(path: string): Promise<boolean>;
+declare function ensureDir(path: string): Promise<void>;
+declare function readText(path: string): Promise<string>;
+declare function writeText(path: string, content: string): Promise<void>;
+declare function readYaml<T = unknown>(path: string): Promise<T>;
+declare function writeYaml(path: string, data: unknown): Promise<void>;
+declare function listDirs(path: string): Promise<string[]>;
+declare function listFiles(path: string): Promise<string[]>;
+declare function copyDir(src: string, dest: string): Promise<void>;
+declare function removePath(path: string): Promise<void>;
+
+export { type AdvanceResult, type ArtifactDef, ArtifactDefSchema, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type Complexity, type Config, ConfigSchema, type CreateChangeInput, type Gate, GateSchema, type InitOptions, type InitResult, SDD_DIR, type Stage, StageSchema, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, advanceStage, approveGate, archiveDir, buildAgentPrompt, buildContext, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, clearActiveIf, completeChange, configPath, copyDir, createChange, defaultConfig, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, firstActiveStageId, formatStatus, getActiveChangeId, getStage, inferComplexity, initProject, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadWorkflow, memoryDir, nextStageId, nowIso, pathExists, previousStageId, projectPaths, readText, readYaml, recommendWorkflow, removePath, resolveChangeId, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, switchWorkflow, templatesDir, todayIsoDate, uniqueChangeDirName, workflowsDir, writeText, writeYaml };