import { z } from "zod"; /** * The accepted scope and intent for a run, confirmed by the host before * planning. Single-sourced so both orchestrators share one shape: audit-code * uses `excluded_scope`/`must_not_touch`/`free_form_intent`; remediate-code * additionally uses `filters` to narrow findings. `scope_summary`/ * `intent_summary` are human renders; the structured fields are what downstream * planning, worker prompts, and reports actually consume. */ export declare const IntentCheckpointSchema: z.ZodObject<{ schema_version: z.ZodLiteral<"intent-checkpoint/v1">; confirmed_at: z.ZodString; /** * `"host"` — checkpoint has been reviewed and confirmed by the host agent. * `"draft"` — preliminary checkpoint pre-populated by synthesize_intake worker; * not yet confirmed; planning must not begin and filtering must not apply. */ confirmed_by: z.ZodEnum<["host", "draft"]>; /** Human-readable description of the confirmed scope. */ scope_summary: z.ZodString; /** Human-readable description of the goal (e.g. full-audit / delta). */ intent_summary: z.ZodString; /** * Free-form intent; interpreted into priority/lens/scope signals at planning * time via freeFormIntentInterpreter. Never threaded verbatim into worker or * dispatch prompts (see freeFormIntentInterpreter, INV-S04). */ free_form_intent: z.ZodOptional; /** Paths intentionally excluded from the run, each with a reason. */ excluded_scope: z.ZodOptional, "many">>; /** Path globs that must never be written to. */ must_not_touch: z.ZodOptional>; /** Remediate-only finding filters; audit-code ignores these. */ filters: z.ZodOptional>; lenses: z.ZodOptional>; packages: z.ZodOptional>; themes: z.ZodOptional>; }, "strict", z.ZodTypeAny, { lenses?: string[] | undefined; severity?: string[] | undefined; themes?: string[] | undefined; packages?: string[] | undefined; }, { lenses?: string[] | undefined; severity?: string[] | undefined; themes?: string[] | undefined; packages?: string[] | undefined; }>>; /** * Clauses from free_form_intent that could not be encoded as lens-weight, * priority, or scope signals. Each entry carries the original clause text, * the blocking checkpoint question raised for it, and the optional host * answer once resolved. These survive as explicit machine-checkable * contract constraints threaded into planning and worker prompts. */ constraint_clauses: z.ZodOptional; /** The original unencodable clause text. */ text: z.ZodString; /** The blocking checkpoint question generated for this clause. */ checkpoint_question: z.ZodString; /** The host's answer to the checkpoint question once resolved. */ host_answer: z.ZodOptional; }, "strict", z.ZodTypeAny, { text: string; checkpoint_question: string; clause_id?: string | undefined; host_answer?: string | undefined; }, { text: string; checkpoint_question: string; clause_id?: string | undefined; host_answer?: string | undefined; }>, "many">>; /** * Per-file or per-prefix status corrections accepted by the host. Applied * before coverage initialization so overridden files never become audit * tasks. Typically sourced from `disposition_override_proposals` in the * scope pre-digest shown during the `confirm_intent` step. */ disposition_overrides: z.ZodOptional; reason: z.ZodString; }, "strict", z.ZodTypeAny, { path: string; status: "included" | "excluded" | "generated" | "vendor" | "binary" | "doc_only"; reason: string; }, { path: string; status: "included" | "excluded" | "generated" | "vendor" | "binary" | "doc_only"; reason: string; }>, "many">>; /** * Accepted or modified lens set from the host, derived from the * lens proposition table in the scope pre-digest. `include` is additive (always * merged with mandatory lenses); `exclude` removes non-mandatory lenses. */ lens_selection: z.ZodOptional>; exclude: z.ZodOptional>; }, "strict", z.ZodTypeAny, { include?: string[] | undefined; exclude?: string[] | undefined; }, { include?: string[] | undefined; exclude?: string[] | undefined; }>>; /** * Conceptual design-review depth, confirmed by the host during * `confirm_intent`. It records *how much* conceptual review to do, never how * the host chooses to execute that work. * - `conceptual_depth: "shallow"` (default when omitted) — a single conceptual * reviewer. * - `conceptual_depth: "deep"` — fan out `perspectives` independent reviewers * with maximally dissimilar perspectives, then compile via an independent * judge. * `perspectives` bounds the deep fan-out count; ignored when shallow. */ design_review: z.ZodOptional>; perspectives: z.ZodOptional; /** * The premise-height consent dial (how far up a finding may reach), * captured at `confirm_intent`. Optional and additive — a legacy * checkpoint carrying only `conceptual_depth`/`perspectives` stays * valid. NOTE: the checkpoint deliberately carries the ceiling as * INPUT only — charters/teleologies/goal graph live on * `charter_register.json` (the OUTPUT artifact), never here; embedding * them would create a staleness cycle with the checkpoint the register * depends on. (Never-written `charters`/`goal_graph` embeds were * deleted 2026-08-06, design resolution 4.) */ ceiling: z.ZodOptional; explicit_opt_in: z.ZodOptional; }, "strict", z.ZodTypeAny, { rung: "shallow" | "deep" | "deepest"; explicit_opt_in?: boolean | undefined; }, { rung: "shallow" | "deep" | "deepest"; explicit_opt_in?: boolean | undefined; }>>; /** * The ATTENTION dial (Phase D control surface, currency #3) — how much the * user will converse to align the charters: how many VOI-ranked * charter-clarification questions they answer this round. `0` is the * autonomous mode (every charter-delta becomes a written finding, nothing * interactive); a finite N takes the top-N of the VOI queue; `"all"` takes * every interactive question. Attended and unattended are two settings of * ONE dial, not a forked path. Optional + additive; defaults to `0` * (conversation-first: no human loop unless the user opts in). */ attention: z.ZodOptional]>>; }, "strict", z.ZodTypeAny, { conceptual_depth?: "shallow" | "deep" | undefined; perspectives?: number | undefined; ceiling?: { rung: "shallow" | "deep" | "deepest"; explicit_opt_in?: boolean | undefined; } | undefined; attention?: number | "all" | undefined; }, { conceptual_depth?: "shallow" | "deep" | undefined; perspectives?: number | undefined; ceiling?: { rung: "shallow" | "deep" | "deepest"; explicit_opt_in?: boolean | undefined; } | undefined; attention?: number | "all" | undefined; }>>; }, "strict", z.ZodTypeAny, { schema_version: "intent-checkpoint/v1"; confirmed_at: string; confirmed_by: "host" | "draft"; scope_summary: string; intent_summary: string; excluded_scope?: { path: string; reason: string; }[] | undefined; free_form_intent?: string | undefined; must_not_touch?: string[] | undefined; filters?: { lenses?: string[] | undefined; severity?: string[] | undefined; themes?: string[] | undefined; packages?: string[] | undefined; } | undefined; constraint_clauses?: { text: string; checkpoint_question: string; clause_id?: string | undefined; host_answer?: string | undefined; }[] | undefined; disposition_overrides?: { path: string; status: "included" | "excluded" | "generated" | "vendor" | "binary" | "doc_only"; reason: string; }[] | undefined; lens_selection?: { include?: string[] | undefined; exclude?: string[] | undefined; } | undefined; design_review?: { conceptual_depth?: "shallow" | "deep" | undefined; perspectives?: number | undefined; ceiling?: { rung: "shallow" | "deep" | "deepest"; explicit_opt_in?: boolean | undefined; } | undefined; attention?: number | "all" | undefined; } | undefined; }, { schema_version: "intent-checkpoint/v1"; confirmed_at: string; confirmed_by: "host" | "draft"; scope_summary: string; intent_summary: string; excluded_scope?: { path: string; reason: string; }[] | undefined; free_form_intent?: string | undefined; must_not_touch?: string[] | undefined; filters?: { lenses?: string[] | undefined; severity?: string[] | undefined; themes?: string[] | undefined; packages?: string[] | undefined; } | undefined; constraint_clauses?: { text: string; checkpoint_question: string; clause_id?: string | undefined; host_answer?: string | undefined; }[] | undefined; disposition_overrides?: { path: string; status: "included" | "excluded" | "generated" | "vendor" | "binary" | "doc_only"; reason: string; }[] | undefined; lens_selection?: { include?: string[] | undefined; exclude?: string[] | undefined; } | undefined; design_review?: { conceptual_depth?: "shallow" | "deep" | undefined; perspectives?: number | undefined; ceiling?: { rung: "shallow" | "deep" | "deepest"; explicit_opt_in?: boolean | undefined; } | undefined; attention?: number | "all" | undefined; } | undefined; }>; export type IntentCheckpoint = z.infer; //# sourceMappingURL=intentCheckpoint.d.ts.map