import { z } from "zod";
import { type Spec, type SpecIndex, type SpecIndexEntry, type ForgeAdapter } from "@slowcook-ai/core";
/** Where specs live, relative to repo root. */
export declare const SPECS_DIR = "specs";
export declare const INDEX_FILE: string;
export declare const SpecProposalsSchema: z.ZodObject<{
    schema: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        sql: z.ZodString;
    }, z.core.$strip>>;
    ui_layout: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        viewport_coverage: z.ZodOptional<z.ZodArray<z.ZodString>>;
        components_to_reuse: z.ZodOptional<z.ZodArray<z.ZodString>>;
        tokens_to_reuse: z.ZodOptional<z.ZodArray<z.ZodString>>;
        tokens_to_add: z.ZodOptional<z.ZodArray<z.ZodString>>;
    }, z.core.$strip>>;
    routes: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        paths: z.ZodArray<z.ZodObject<{
            path: z.ZodString;
            file: z.ZodString;
        }, z.core.$strip>>;
    }, z.core.$strip>>;
    auth: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        requirements: z.ZodOptional<z.ZodArray<z.ZodString>>;
    }, z.core.$strip>>;
    perf_budget: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        budgets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
    }, z.core.$strip>>;
    observability: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        log_events: z.ZodOptional<z.ZodArray<z.ZodString>>;
        metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
            name: z.ZodString;
            type: z.ZodString;
        }, z.core.$strip>>>;
    }, z.core.$strip>>;
    infra: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        runtime: z.ZodOptional<z.ZodString>;
        deploy_target: z.ZodOptional<z.ZodString>;
        notes: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>>;
    api_shape: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        endpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
            method: z.ZodString;
            path: z.ZodString;
            request_schema: z.ZodOptional<z.ZodUnknown>;
            responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        }, z.core.$strip>>>;
    }, z.core.$strip>>;
    fixtures: z.ZodOptional<z.ZodObject<{
        status: z.ZodEnum<{
            pending: "pending";
            approved: "approved";
            rejected: "rejected";
            deferred: "deferred";
            blocked_on_clarification: "blocked_on_clarification";
        }>;
        proposed_by: z.ZodString;
        approved_by: z.ZodOptional<z.ZodString>;
        approved_at: z.ZodOptional<z.ZodString>;
        rationale: z.ZodOptional<z.ZodString>;
        by_domain: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
            seed: z.ZodRecord<z.ZodString, z.ZodUnknown>;
        }, z.core.$strip>>>;
    }, z.core.$strip>>;
}, z.core.$strip>;
export declare function readIndex(repoRoot: string): SpecIndex;
export declare function writeIndex(repoRoot: string, index: SpecIndex): void;
export declare function readSpec(repoRoot: string, storyId: string): Spec;
export declare function writeSpec(repoRoot: string, spec: Spec): string;
/**
 * Coerce "helpfully structured" array entries back to strings, matching the
 * Spec schema (acceptance_scenarios et al. are `string[]`). Agents — menu AND
 * refine — emit a {given,when,then} BDD object for an entry even when told to
 * emit strings; normalise at ingestion. Shared so both producers agree.
 * Non-breaking: well-formed string entries pass through unchanged.
 */
export declare function normalizeScenarioArrays<T extends Record<string, unknown>>(doc: T): T;
export declare function listActiveSpecs(repoRoot: string): Spec[];
/**
 * Allocate the next unused story ID (zero-padded 3 digits).
 *
 * Considers BOTH the local index (specs/_index.yaml on the checked-out branch)
 * AND remote branches matching `slowcook/spec/story-*`. This prevents story-ID
 * collisions when a spec PR is in flight (branch exists on remote but index on
 * main doesn't reflect it yet) or when two refinement runs overlap.
 *
 * `forge` is optional so callers without a forge (e.g., local tooling) can still
 * use the function — they just get a weaker guarantee (index-only).
 */
export declare function nextStoryId(repoRoot: string, forge?: ForgeAdapter): Promise<string>;
/** Public accessors for tests. */
export declare const schemas: {
    SpecIndex: z.ZodObject<{
        $schema: z.ZodOptional<z.ZodString>;
        schema_version: z.ZodLiteral<1>;
        stories: z.ZodRecord<z.ZodString, z.ZodObject<{
            title: z.ZodString;
            status: z.ZodEnum<{
                draft: "draft";
                active: "active";
                superseded: "superseded";
            }>;
            source_issue: z.ZodOptional<z.ZodString>;
            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
            summary: z.ZodOptional<z.ZodString>;
            supersedes: z.ZodOptional<z.ZodArray<z.ZodString>>;
            superseded_by: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
        }, z.core.$strip>>;
    }, z.core.$strip>;
    Spec: z.ZodObject<{
        $schema: z.ZodOptional<z.ZodString>;
        story_id: z.ZodString;
        title: z.ZodString;
        status: z.ZodEnum<{
            draft: "draft";
            active: "active";
            superseded: "superseded";
        }>;
        created_at: z.ZodString;
        supersedes: z.ZodArray<z.ZodString>;
        superseded_by: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
        token_budget_usd: z.ZodOptional<z.ZodNumber>;
        estimate: z.ZodOptional<z.ZodEnum<{
            small: "small";
            medium: "medium";
            large: "large";
        }>>;
        source_issue: z.ZodOptional<z.ZodString>;
        refined_by: z.ZodOptional<z.ZodString>;
        actors: z.ZodArray<z.ZodObject<{
            name: z.ZodString;
            notes: z.ZodOptional<z.ZodString>;
        }, z.core.$strip>>;
        preconditions: z.ZodArray<z.ZodString>;
        invariants: z.ZodArray<z.ZodString>;
        api_contract: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
        ui_behavior: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
        fidelity: z.ZodOptional<z.ZodObject<{
            modes: z.ZodArray<z.ZodString>;
        }, z.core.$strip>>;
        epic: z.ZodOptional<z.ZodString>;
        persona: z.ZodOptional<z.ZodObject<{
            id: z.ZodString;
            label: z.ZodOptional<z.ZodString>;
            chrome: z.ZodOptional<z.ZodEnum<{
                member: "member";
                public: "public";
                admin: "admin";
            }>>;
        }, z.core.$strip>>;
        surfaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
            route: z.ZodString;
            name: z.ZodOptional<z.ZodString>;
            persona: z.ZodOptional<z.ZodString>;
            home: z.ZodOptional<z.ZodBoolean>;
            states: z.ZodOptional<z.ZodArray<z.ZodString>>;
        }, z.core.$strip>>>;
        prd_ref: z.ZodOptional<z.ZodObject<{
            file: z.ZodString;
            anchor: z.ZodString;
            sha: z.ZodOptional<z.ZodString>;
        }, z.core.$strip>>;
        data_contract: z.ZodOptional<z.ZodObject<{
            entities: z.ZodOptional<z.ZodArray<z.ZodObject<{
                name: z.ZodString;
                fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                    name: z.ZodString;
                    type: z.ZodString;
                }, z.core.$strip>>>;
                relations: z.ZodOptional<z.ZodArray<z.ZodString>>;
            }, z.core.$strip>>>;
            api: z.ZodOptional<z.ZodArray<z.ZodObject<{
                method: z.ZodString;
                path: z.ZodString;
                note: z.ZodOptional<z.ZodString>;
            }, z.core.$strip>>>;
        }, z.core.$strip>>;
        open_questions: z.ZodOptional<z.ZodObject<{
            addressable: z.ZodArray<z.ZodString>;
            deferred: z.ZodArray<z.ZodString>;
        }, z.core.$strip>>;
        acceptance_scenarios: z.ZodArray<z.ZodString>;
        non_goals: z.ZodArray<z.ZodString>;
        related_specs: z.ZodOptional<z.ZodArray<z.ZodObject<{
            id: z.ZodString;
            relationship: z.ZodEnum<{
                superseded: "superseded";
                overlap: "overlap";
                related: "related";
            }>;
            note: z.ZodOptional<z.ZodString>;
        }, z.core.$strip>>>;
        proposals: z.ZodOptional<z.ZodObject<{
            schema: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                sql: z.ZodString;
            }, z.core.$strip>>;
            ui_layout: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                viewport_coverage: z.ZodOptional<z.ZodArray<z.ZodString>>;
                components_to_reuse: z.ZodOptional<z.ZodArray<z.ZodString>>;
                tokens_to_reuse: z.ZodOptional<z.ZodArray<z.ZodString>>;
                tokens_to_add: z.ZodOptional<z.ZodArray<z.ZodString>>;
            }, z.core.$strip>>;
            routes: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                paths: z.ZodArray<z.ZodObject<{
                    path: z.ZodString;
                    file: z.ZodString;
                }, z.core.$strip>>;
            }, z.core.$strip>>;
            auth: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                requirements: z.ZodOptional<z.ZodArray<z.ZodString>>;
            }, z.core.$strip>>;
            perf_budget: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                budgets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
            }, z.core.$strip>>;
            observability: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                log_events: z.ZodOptional<z.ZodArray<z.ZodString>>;
                metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
                    name: z.ZodString;
                    type: z.ZodString;
                }, z.core.$strip>>>;
            }, z.core.$strip>>;
            infra: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                runtime: z.ZodOptional<z.ZodString>;
                deploy_target: z.ZodOptional<z.ZodString>;
                notes: z.ZodOptional<z.ZodString>;
            }, z.core.$strip>>;
            api_shape: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                endpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
                    method: z.ZodString;
                    path: z.ZodString;
                    request_schema: z.ZodOptional<z.ZodUnknown>;
                    responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                }, z.core.$strip>>>;
            }, z.core.$strip>>;
            fixtures: z.ZodOptional<z.ZodObject<{
                status: z.ZodEnum<{
                    pending: "pending";
                    approved: "approved";
                    rejected: "rejected";
                    deferred: "deferred";
                    blocked_on_clarification: "blocked_on_clarification";
                }>;
                proposed_by: z.ZodString;
                approved_by: z.ZodOptional<z.ZodString>;
                approved_at: z.ZodOptional<z.ZodString>;
                rationale: z.ZodOptional<z.ZodString>;
                by_domain: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                    seed: z.ZodRecord<z.ZodString, z.ZodUnknown>;
                }, z.core.$strip>>>;
            }, z.core.$strip>>;
        }, z.core.$strip>>;
        cost: z.ZodOptional<z.ZodObject<{
            total_usd: z.ZodNumber;
            last_updated: z.ZodString;
        }, z.core.$strip>>;
    }, z.core.$loose>;
    SpecIndexEntry: z.ZodObject<{
        title: z.ZodString;
        status: z.ZodEnum<{
            draft: "draft";
            active: "active";
            superseded: "superseded";
        }>;
        source_issue: z.ZodOptional<z.ZodString>;
        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
        summary: z.ZodOptional<z.ZodString>;
        supersedes: z.ZodOptional<z.ZodArray<z.ZodString>>;
        superseded_by: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
    }, z.core.$strip>;
};
/** Minimal helper for the agent to build a SpecIndexEntry from a Spec. */
export declare function entryFromSpec(spec: Spec): SpecIndexEntry;
//# sourceMappingURL=spec-yaml.d.ts.map