@interf/compiler 0.22.2 → 0.33.0

package/dist/packages/runtime/schemas/build-plans.d.ts

@@ -0,0 +1,959 @@
+import { z } from "zod";
+import { BuildPlanAuthoringArtifactRequirementSchema, BuildPlanContextCheckDraftSchema } from "../../build-plans/authoring/brief.js";
+export { BuildPlanAuthoringArtifactRequirementSchema, BuildPlanAuthoringBriefInputSchema, BuildPlanAuthoringBriefSchema, BuildPlanContextCheckDraftSchema, RequestedArtifactSchema, SourceContextSchema, } from "../../build-plans/authoring/brief.js";
+/** Body of `POST /v1/build-plans` — save a Build Plan definition by path. */
+export declare const BuildPlanSaveRequestSchema: z.ZodObject<{
+    source_path: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const BuildPlanResourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    build_plan_id: z.ZodString;
+    path: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+    purpose: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        task_hint: z.ZodString;
+    }, z.core.$strict>>;
+    brief: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+        intent: z.ZodString;
+        requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            purpose: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                label: z.ZodString;
+            }, z.core.$strict>]>>>;
+            output: z.ZodOptional<z.ZodObject<{
+                path: z.ZodOptional<z.ZodString>;
+                shape: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                    artifact_kind: z.ZodEnum<{
+                        file: "file";
+                        directory: "directory";
+                    }>;
+                }, z.core.$strict>>;
+                checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    kind: z.ZodEnum<{
+                        file_exists: "file_exists";
+                        source_manifest_valid: "source_manifest_valid";
+                        min_file_count: "min_file_count";
+                        min_file_count_matches_source: "min_file_count_matches_source";
+                        source_summary_folders: "source_summary_folders";
+                        source_page_coverage: "source_page_coverage";
+                        frontmatter_valid: "frontmatter_valid";
+                        frontmatter_required_keys: "frontmatter_required_keys";
+                        frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                        source_refs_required: "source_refs_required";
+                        wikilinks_valid: "wikilinks_valid";
+                        must_not_contain: "must_not_contain";
+                        must_contain: "must_contain";
+                        qa_match: "qa_match";
+                    }>;
+                    description: z.ZodOptional<z.ZodString>;
+                    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                stage_hint: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>>>;
+        checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodOptional<z.ZodString>;
+            evidence_expectation: z.ZodOptional<z.ZodString>;
+            backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        context_checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodOptional<z.ZodString>;
+            evidence_expectation: z.ZodOptional<z.ZodString>;
+            backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        user_prep_instructions: z.ZodOptional<z.ZodString>;
+        source_context: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            summary: z.ZodOptional<z.ZodString>;
+            items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                kind: z.ZodOptional<z.ZodString>;
+                page_count: z.ZodOptional<z.ZodNumber>;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+        artifact_requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            shape: z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+                artifact_kind: z.ZodEnum<{
+                    file: "file";
+                    directory: "directory";
+                }>;
+            }, z.core.$strict>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    file_exists: "file_exists";
+                    source_manifest_valid: "source_manifest_valid";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    source_summary_folders: "source_summary_folders";
+                    source_page_coverage: "source_page_coverage";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                    source_refs_required: "source_refs_required";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                description: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            stage_hint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodTransform<{
+        requested_artifacts: {
+            title: string;
+            checks: (string | {
+                label: string;
+            })[];
+            id?: string | undefined;
+            purpose?: string | undefined;
+            description?: string | undefined;
+            output?: {
+                checks: {
+                    id: string;
+                    kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                    required: boolean;
+                    description?: string | undefined;
+                    params?: Record<string, unknown> | undefined;
+                }[];
+                path?: string | undefined;
+                shape?: {
+                    kind: "path";
+                    path: string;
+                    artifact_kind: "file" | "directory";
+                } | undefined;
+                stage_hint?: string | undefined;
+            } | undefined;
+        }[];
+        checks: {
+            label: string;
+            backed_by_artifact_ids: string[];
+            required: boolean;
+            id?: string | undefined;
+            description?: string | undefined;
+            evidence?: string | undefined;
+            evidence_expectation?: string | undefined;
+        }[];
+        artifact_requirements: {
+            id: string;
+            shape: {
+                kind: "path";
+                path: string;
+                artifact_kind: "file" | "directory";
+            };
+            checks: {
+                id: string;
+                kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                required: boolean;
+                description?: string | undefined;
+                params?: Record<string, unknown> | undefined;
+            }[];
+            description?: string | undefined;
+            stage_hint?: string | undefined;
+        }[];
+        intent: string;
+        user_prep_instructions?: string | undefined;
+        source_context?: {
+            items: {
+                name?: string | undefined;
+                path?: string | undefined;
+                kind?: string | undefined;
+                page_count?: number | undefined;
+                note?: string | undefined;
+            }[];
+            observations: string[];
+            limitations: string[];
+            summary?: string | undefined;
+        } | null | undefined;
+    }, {
+        intent: string;
+        requested_artifacts?: {
+            title: string;
+            checks: (string | {
+                label: string;
+            })[];
+            id?: string | undefined;
+            purpose?: string | undefined;
+            description?: string | undefined;
+            output?: {
+                checks: {
+                    id: string;
+                    kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                    required: boolean;
+                    description?: string | undefined;
+                    params?: Record<string, unknown> | undefined;
+                }[];
+                path?: string | undefined;
+                shape?: {
+                    kind: "path";
+                    path: string;
+                    artifact_kind: "file" | "directory";
+                } | undefined;
+                stage_hint?: string | undefined;
+            } | undefined;
+        }[] | undefined;
+        checks?: {
+            label: string;
+            backed_by_artifact_ids: string[];
+            required: boolean;
+            id?: string | undefined;
+            description?: string | undefined;
+            evidence?: string | undefined;
+            evidence_expectation?: string | undefined;
+        }[] | undefined;
+        context_checks?: {
+            label: string;
+            backed_by_artifact_ids: string[];
+            required: boolean;
+            id?: string | undefined;
+            description?: string | undefined;
+            evidence?: string | undefined;
+            evidence_expectation?: string | undefined;
+        }[] | undefined;
+        user_prep_instructions?: string | undefined;
+        source_context?: {
+            items: {
+                name?: string | undefined;
+                path?: string | undefined;
+                kind?: string | undefined;
+                page_count?: number | undefined;
+                note?: string | undefined;
+            }[];
+            observations: string[];
+            limitations: string[];
+            summary?: string | undefined;
+        } | null | undefined;
+        artifact_requirements?: {
+            id: string;
+            shape: {
+                kind: "path";
+                path: string;
+                artifact_kind: "file" | "directory";
+            };
+            checks: {
+                id: string;
+                kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                required: boolean;
+                description?: string | undefined;
+                params?: Record<string, unknown> | undefined;
+            }[];
+            description?: string | undefined;
+            stage_hint?: string | undefined;
+        }[] | undefined;
+    }>>>;
+    inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    source_kind: z.ZodDefault<z.ZodEnum<{
+        builtin: "builtin";
+        local: "local";
+    }>>;
+    built_in: z.ZodDefault<z.ZodBoolean>;
+    active_for_projects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    context_checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        shape: z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            artifact_kind: z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                file_exists: "file_exists";
+                source_manifest_valid: "source_manifest_valid";
+                min_file_count: "min_file_count";
+                min_file_count_matches_source: "min_file_count_matches_source";
+                source_summary_folders: "source_summary_folders";
+                source_page_coverage: "source_page_coverage";
+                frontmatter_valid: "frontmatter_valid";
+                frontmatter_required_keys: "frontmatter_required_keys";
+                frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                source_refs_required: "source_refs_required";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        contract_type: z.ZodString;
+        skill_dir: z.ZodString;
+        role: z.ZodDefault<z.ZodString>;
+        reads: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const BuildPlanChangeCreateRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action_type: z.ZodOptional<z.ZodLiteral<"build-plan-change">>;
+    operation: z.ZodLiteral<"duplicate">;
+    build_plan: z.ZodString;
+    new_build_plan_id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    action_type: z.ZodOptional<z.ZodLiteral<"build-plan-change">>;
+    operation: z.ZodLiteral<"remove">;
+    build_plan: z.ZodString;
+    confirmation: z.ZodString;
+}, z.core.$strict>], "operation">;
+export declare const BuildPlanChangeResultSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-build-plan-change-result">;
+    version: z.ZodLiteral<1>;
+    operation: z.ZodEnum<{
+        remove: "remove";
+        duplicate: "duplicate";
+    }>;
+    build_plan: z.ZodString;
+    new_build_plan_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updated_projects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    build_plan_path: z.ZodString;
+    changed: z.ZodBoolean;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const BuildPlanAuthoringCreateRequestSchema: z.ZodObject<{
+    intent: z.ZodString;
+    requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        purpose: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+        }, z.core.$strict>]>>>;
+        output: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            shape: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+                artifact_kind: z.ZodEnum<{
+                    file: "file";
+                    directory: "directory";
+                }>;
+            }, z.core.$strict>>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    file_exists: "file_exists";
+                    source_manifest_valid: "source_manifest_valid";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    source_summary_folders: "source_summary_folders";
+                    source_page_coverage: "source_page_coverage";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                    source_refs_required: "source_refs_required";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                description: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            stage_hint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>>;
+    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    context_checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    user_prep_instructions: z.ZodOptional<z.ZodString>;
+    source_context: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodString>;
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
+            page_count: z.ZodOptional<z.ZodNumber>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    artifact_requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        shape: z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            artifact_kind: z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                file_exists: "file_exists";
+                source_manifest_valid: "source_manifest_valid";
+                min_file_count: "min_file_count";
+                min_file_count_matches_source: "min_file_count_matches_source";
+                source_summary_folders: "source_summary_folders";
+                source_page_coverage: "source_page_coverage";
+                frontmatter_valid: "frontmatter_valid";
+                frontmatter_required_keys: "frontmatter_required_keys";
+                frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                source_refs_required: "source_refs_required";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        stage_hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source_folder_path: z.ZodOptional<z.ZodString>;
+    base_build_plan_id: z.ZodOptional<z.ZodString>;
+    reference_build_plan_id: z.ZodOptional<z.ZodString>;
+    build_plan_id: z.ZodString;
+    label: z.ZodString;
+    hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const BuildPlanAuthoringRuntimeRequestSchema: z.ZodObject<{
+    intent: z.ZodString;
+    requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        purpose: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+        }, z.core.$strict>]>>>;
+        output: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            shape: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+                artifact_kind: z.ZodEnum<{
+                    file: "file";
+                    directory: "directory";
+                }>;
+            }, z.core.$strict>>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    file_exists: "file_exists";
+                    source_manifest_valid: "source_manifest_valid";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    source_summary_folders: "source_summary_folders";
+                    source_page_coverage: "source_page_coverage";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                    source_refs_required: "source_refs_required";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                description: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            stage_hint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>>;
+    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    context_checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    user_prep_instructions: z.ZodOptional<z.ZodString>;
+    source_context: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodString>;
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
+            page_count: z.ZodOptional<z.ZodNumber>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    artifact_requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        shape: z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            artifact_kind: z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                file_exists: "file_exists";
+                source_manifest_valid: "source_manifest_valid";
+                min_file_count: "min_file_count";
+                min_file_count_matches_source: "min_file_count_matches_source";
+                source_summary_folders: "source_summary_folders";
+                source_page_coverage: "source_page_coverage";
+                frontmatter_valid: "frontmatter_valid";
+                frontmatter_required_keys: "frontmatter_required_keys";
+                frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                source_refs_required: "source_refs_required";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        stage_hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    base_build_plan_id: z.ZodOptional<z.ZodString>;
+    reference_build_plan_id: z.ZodOptional<z.ZodString>;
+    build_plan_id: z.ZodString;
+    label: z.ZodString;
+    hint: z.ZodOptional<z.ZodString>;
+    source_folder_path: z.ZodString;
+}, z.core.$strict>;
+export declare const BuildPlanAuthoringResultSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        updated: "updated";
+        "no-change": "no-change";
+        invalid: "invalid";
+        "executor-failed": "executor-failed";
+    }>;
+    changed: z.ZodBoolean;
+    summary: z.ZodString;
+    build_plan_path: z.ZodString;
+    shell_path: z.ZodString;
+    validation: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const BuildPlanListResponseSchema: z.ZodObject<{
+    build_plans: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        build_plan_id: z.ZodString;
+        path: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        hint: z.ZodOptional<z.ZodString>;
+        purpose: z.ZodOptional<z.ZodObject<{
+            label: z.ZodString;
+            task_hint: z.ZodString;
+        }, z.core.$strict>>;
+        brief: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+            intent: z.ZodString;
+            requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                title: z.ZodString;
+                purpose: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    label: z.ZodString;
+                }, z.core.$strict>]>>>;
+                output: z.ZodOptional<z.ZodObject<{
+                    path: z.ZodOptional<z.ZodString>;
+                    shape: z.ZodOptional<z.ZodObject<{
+                        kind: z.ZodLiteral<"path">;
+                        path: z.ZodString;
+                        artifact_kind: z.ZodEnum<{
+                            file: "file";
+                            directory: "directory";
+                        }>;
+                    }, z.core.$strict>>;
+                    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        kind: z.ZodEnum<{
+                            file_exists: "file_exists";
+                            source_manifest_valid: "source_manifest_valid";
+                            min_file_count: "min_file_count";
+                            min_file_count_matches_source: "min_file_count_matches_source";
+                            source_summary_folders: "source_summary_folders";
+                            source_page_coverage: "source_page_coverage";
+                            frontmatter_valid: "frontmatter_valid";
+                            frontmatter_required_keys: "frontmatter_required_keys";
+                            frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                            source_refs_required: "source_refs_required";
+                            wikilinks_valid: "wikilinks_valid";
+                            must_not_contain: "must_not_contain";
+                            must_contain: "must_contain";
+                            qa_match: "qa_match";
+                        }>;
+                        description: z.ZodOptional<z.ZodString>;
+                        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        required: z.ZodDefault<z.ZodBoolean>;
+                    }, z.core.$strict>>>;
+                    stage_hint: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>>>;
+            checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                evidence: z.ZodOptional<z.ZodString>;
+                evidence_expectation: z.ZodOptional<z.ZodString>;
+                backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            context_checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                evidence: z.ZodOptional<z.ZodString>;
+                evidence_expectation: z.ZodOptional<z.ZodString>;
+                backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            user_prep_instructions: z.ZodOptional<z.ZodString>;
+            source_context: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                summary: z.ZodOptional<z.ZodString>;
+                items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    path: z.ZodOptional<z.ZodString>;
+                    kind: z.ZodOptional<z.ZodString>;
+                    page_count: z.ZodOptional<z.ZodNumber>;
+                    note: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>>;
+            artifact_requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                shape: z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                    artifact_kind: z.ZodEnum<{
+                        file: "file";
+                        directory: "directory";
+                    }>;
+                }, z.core.$strict>;
+                checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    kind: z.ZodEnum<{
+                        file_exists: "file_exists";
+                        source_manifest_valid: "source_manifest_valid";
+                        min_file_count: "min_file_count";
+                        min_file_count_matches_source: "min_file_count_matches_source";
+                        source_summary_folders: "source_summary_folders";
+                        source_page_coverage: "source_page_coverage";
+                        frontmatter_valid: "frontmatter_valid";
+                        frontmatter_required_keys: "frontmatter_required_keys";
+                        frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                        source_refs_required: "source_refs_required";
+                        wikilinks_valid: "wikilinks_valid";
+                        must_not_contain: "must_not_contain";
+                        must_contain: "must_contain";
+                        qa_match: "qa_match";
+                    }>;
+                    description: z.ZodOptional<z.ZodString>;
+                    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                stage_hint: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodTransform<{
+            requested_artifacts: {
+                title: string;
+                checks: (string | {
+                    label: string;
+                })[];
+                id?: string | undefined;
+                purpose?: string | undefined;
+                description?: string | undefined;
+                output?: {
+                    checks: {
+                        id: string;
+                        kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                        required: boolean;
+                        description?: string | undefined;
+                        params?: Record<string, unknown> | undefined;
+                    }[];
+                    path?: string | undefined;
+                    shape?: {
+                        kind: "path";
+                        path: string;
+                        artifact_kind: "file" | "directory";
+                    } | undefined;
+                    stage_hint?: string | undefined;
+                } | undefined;
+            }[];
+            checks: {
+                label: string;
+                backed_by_artifact_ids: string[];
+                required: boolean;
+                id?: string | undefined;
+                description?: string | undefined;
+                evidence?: string | undefined;
+                evidence_expectation?: string | undefined;
+            }[];
+            artifact_requirements: {
+                id: string;
+                shape: {
+                    kind: "path";
+                    path: string;
+                    artifact_kind: "file" | "directory";
+                };
+                checks: {
+                    id: string;
+                    kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                    required: boolean;
+                    description?: string | undefined;
+                    params?: Record<string, unknown> | undefined;
+                }[];
+                description?: string | undefined;
+                stage_hint?: string | undefined;
+            }[];
+            intent: string;
+            user_prep_instructions?: string | undefined;
+            source_context?: {
+                items: {
+                    name?: string | undefined;
+                    path?: string | undefined;
+                    kind?: string | undefined;
+                    page_count?: number | undefined;
+                    note?: string | undefined;
+                }[];
+                observations: string[];
+                limitations: string[];
+                summary?: string | undefined;
+            } | null | undefined;
+        }, {
+            intent: string;
+            requested_artifacts?: {
+                title: string;
+                checks: (string | {
+                    label: string;
+                })[];
+                id?: string | undefined;
+                purpose?: string | undefined;
+                description?: string | undefined;
+                output?: {
+                    checks: {
+                        id: string;
+                        kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                        required: boolean;
+                        description?: string | undefined;
+                        params?: Record<string, unknown> | undefined;
+                    }[];
+                    path?: string | undefined;
+                    shape?: {
+                        kind: "path";
+                        path: string;
+                        artifact_kind: "file" | "directory";
+                    } | undefined;
+                    stage_hint?: string | undefined;
+                } | undefined;
+            }[] | undefined;
+            checks?: {
+                label: string;
+                backed_by_artifact_ids: string[];
+                required: boolean;
+                id?: string | undefined;
+                description?: string | undefined;
+                evidence?: string | undefined;
+                evidence_expectation?: string | undefined;
+            }[] | undefined;
+            context_checks?: {
+                label: string;
+                backed_by_artifact_ids: string[];
+                required: boolean;
+                id?: string | undefined;
+                description?: string | undefined;
+                evidence?: string | undefined;
+                evidence_expectation?: string | undefined;
+            }[] | undefined;
+            user_prep_instructions?: string | undefined;
+            source_context?: {
+                items: {
+                    name?: string | undefined;
+                    path?: string | undefined;
+                    kind?: string | undefined;
+                    page_count?: number | undefined;
+                    note?: string | undefined;
+                }[];
+                observations: string[];
+                limitations: string[];
+                summary?: string | undefined;
+            } | null | undefined;
+            artifact_requirements?: {
+                id: string;
+                shape: {
+                    kind: "path";
+                    path: string;
+                    artifact_kind: "file" | "directory";
+                };
+                checks: {
+                    id: string;
+                    kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                    required: boolean;
+                    description?: string | undefined;
+                    params?: Record<string, unknown> | undefined;
+                }[];
+                description?: string | undefined;
+                stage_hint?: string | undefined;
+            }[] | undefined;
+        }>>>;
+        inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+        source_kind: z.ZodDefault<z.ZodEnum<{
+            builtin: "builtin";
+            local: "local";
+        }>>;
+        built_in: z.ZodDefault<z.ZodBoolean>;
+        active_for_projects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        context_checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            evidence_expectation: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodString;
+            shape: z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+                artifact_kind: z.ZodEnum<{
+                    file: "file";
+                    directory: "directory";
+                }>;
+            }, z.core.$strict>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    file_exists: "file_exists";
+                    source_manifest_valid: "source_manifest_valid";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    source_summary_folders: "source_summary_folders";
+                    source_page_coverage: "source_page_coverage";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                    source_refs_required: "source_refs_required";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                description: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+        stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            contract_type: z.ZodString;
+            skill_dir: z.ZodString;
+            role: z.ZodDefault<z.ZodString>;
+            reads: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type BuildPlanSaveRequest = z.infer<typeof BuildPlanSaveRequestSchema>;
+export type BuildPlanResource = z.infer<typeof BuildPlanResourceSchema>;
+export type BuildPlanChangeCreateRequest = z.infer<typeof BuildPlanChangeCreateRequestSchema>;
+export type BuildPlanChangeResult = z.infer<typeof BuildPlanChangeResultSchema>;
+export type BuildPlanAuthoringArtifactRequirement = z.infer<typeof BuildPlanAuthoringArtifactRequirementSchema>;
+export type BuildPlanContextCheckDraft = z.infer<typeof BuildPlanContextCheckDraftSchema>;
+export type BuildPlanAuthoringCreateRequest = z.infer<typeof BuildPlanAuthoringCreateRequestSchema>;
+export type BuildPlanAuthoringRuntimeRequest = z.infer<typeof BuildPlanAuthoringRuntimeRequestSchema>;
+export type BuildPlanAuthoringResult = z.infer<typeof BuildPlanAuthoringResultSchema>;
+export type BuildPlanListResponse = z.infer<typeof BuildPlanListResponseSchema>;