import { z } from "zod";
/** Resolved runtime settings (env defaults overlaid with CLI flags). */
export interface Settings {
    apply: boolean;
    verify: boolean;
    json: boolean;
    contextDir: string;
    root: string;
    caPattern: string;
}
/**
 * A canonical context-dir name: a simple, repo-relative path with no traversal.
 * Exported so {@link readAihConfig} validates the committed `.aih-config.json`
 * marker against the SAME constraints settings enforce — a marker can never carry
 * a dir that a flag/env value would have rejected.
 */
export declare const ContextDir: z.ZodString;
/**
 * Resolve settings fail-closed: env provides defaults (`AIH_*`), `overrides`
 * (CLI flags) win, and any malformed value throws {@link SettingsError} before a
 * command runs. Dry-run (`apply=false`) is the safe default.
 */
export declare function loadSettings(env: NodeJS.ProcessEnv, overrides?: Partial<Settings>): Settings;