@bookedsolid/rea 0.29.0 → 0.30.1

package/dist/config/settings-schema.d.ts

@@ -0,0 +1,2099 @@
+/**
+ * Class M — `.claude/settings.json` zod schema (0.30.0+).
+ *
+ * Consumer-side validation for the Claude Code harness `settings.json`
+ * file. The harness itself accepts a JSON object with a documented
+ * shape; rea adds a strict subset of that shape so a typo in a hook
+ * registration ("statusMessasge", "PreToolUze") doesn't silently
+ * disable a load-bearing rea hook on a consumer's install.
+ *
+ * Two modes:
+ *   - Default (`mode: 'warn'`) — `rea doctor` logs a warn for any
+ *     unknown top-level key, unknown hook event, or unrecognized
+ *     matcher pattern. Existing consumer files that haven't seen the
+ *     schema before keep working without action.
+ *   - Strict (`mode: 'strict'`) — `rea doctor --strict` fails on any
+ *     zod failure, on path-traversal in a `command` value, and when
+ *     a rea-shipped hook (`EXPECTED_HOOKS`) is missing from the
+ *     PreToolUse / PostToolUse registrations. Used by CI gates that
+ *     want a hard floor.
+ *
+ * Path-traversal is checked OUTSIDE zod (see `validateNoTraversal`)
+ * — zod's job is shape; ours is to make sure a `command` literally
+ * cannot reference `..` after stripping `$CLAUDE_PROJECT_DIR`. The
+ * harness expands the variable at exec time, so the on-disk value
+ * is the right anchor for the check.
+ */
+import { z } from 'zod';
+/**
+ * Hook event names the harness honors. Strict union so a typo
+ * ("PreToolUze") fails closed. The union mirrors Anthropic's
+ * published list as of 2026-05; new events get added here as the
+ * harness ships them.
+ */
+export declare const HOOK_EVENT_NAMES: readonly ["PreToolUse", "PostToolUse", "UserPromptSubmit", "Stop", "SubagentStop", "PreCompact", "Notification", "SessionStart"];
+export type HookEventName = (typeof HOOK_EVENT_NAMES)[number];
+/**
+ * Hook-command entry. `statusMessage` is REQUIRED to ALLOW (not to
+ * require) because every canonical entry rea ships carries one — the
+ * harness uses it for the spinner status line, and omitting it would
+ * be technically valid but degrade UX. `timeout` is optional; when
+ * present must be a positive int up to the harness ceiling of
+ * 600_000 ms (10 minutes).
+ */
+export declare const HookCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"command">;
+    command: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    statusMessage: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "command";
+    command: string;
+    timeout?: number | undefined;
+    statusMessage?: string | undefined;
+}, {
+    type: "command";
+    command: string;
+    timeout?: number | undefined;
+    statusMessage?: string | undefined;
+}>;
+export type HookCommand = z.infer<typeof HookCommandSchema>;
+/**
+ * Hook entry group: a matcher pattern (string like `Bash` or
+ * `Write|Edit|MultiEdit|NotebookEdit`) plus its list of hook commands.
+ * The matcher is opaque to the schema — the harness parses it as a
+ * pipe-separated tool-name list. Empty matcher is rejected.
+ */
+export declare const HookEntrySchema: z.ZodObject<{
+    matcher: z.ZodString;
+    hooks: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"command">;
+        command: z.ZodString;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        statusMessage: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "command";
+        command: string;
+        timeout?: number | undefined;
+        statusMessage?: string | undefined;
+    }, {
+        type: "command";
+        command: string;
+        timeout?: number | undefined;
+        statusMessage?: string | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    hooks: {
+        type: "command";
+        command: string;
+        timeout?: number | undefined;
+        statusMessage?: string | undefined;
+    }[];
+    matcher: string;
+}, {
+    hooks: {
+        type: "command";
+        command: string;
+        timeout?: number | undefined;
+        statusMessage?: string | undefined;
+    }[];
+    matcher: string;
+}>;
+export type HookEntry = z.infer<typeof HookEntrySchema>;
+/**
+ * Top-level `.claude/settings.json` shape.
+ *
+ * `permissions` is pass-through (`z.record`) because it carries
+ * harness-defined structure that rea is not the source of truth for.
+ * `env` is a string-to-string map. `model` is a free string (the
+ * harness validates the model name at runtime).
+ *
+ * Each hook-event field is strict — a typo in the event name fails
+ * the parse instead of silently registering on a phantom event.
+ */
+export declare const SettingsSchema: z.ZodObject<{
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    permissions: z.ZodOptional<z.ZodUnknown>;
+    model: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PostToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        UserPromptSubmit: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Stop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SubagentStop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PreCompact: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Notification: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SessionStart: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    permissions: z.ZodOptional<z.ZodUnknown>;
+    model: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PostToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        UserPromptSubmit: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Stop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SubagentStop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PreCompact: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Notification: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SessionStart: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    permissions: z.ZodOptional<z.ZodUnknown>;
+    model: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PostToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        UserPromptSubmit: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Stop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SubagentStop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PreCompact: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Notification: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SessionStart: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Strict variant for `rea doctor --strict`. Same shape as `SettingsSchema`
+ * but rejects unknown top-level keys. Used only by the CI-gate path,
+ * never by `rea upgrade`. Exported so the doctor can opt into stricter
+ * validation when consumers explicitly request it.
+ */
+export declare const SettingsSchemaStrict: z.ZodObject<{
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    permissions: z.ZodOptional<z.ZodUnknown>;
+    model: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PostToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        UserPromptSubmit: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Stop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SubagentStop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        PreCompact: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        Notification: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+        SessionStart: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodString;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }, {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }, {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    env?: Record<string, string> | undefined;
+    hooks?: {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    } | undefined;
+    permissions?: unknown;
+    model?: string | undefined;
+}, {
+    env?: Record<string, string> | undefined;
+    hooks?: {
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Notification?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        UserPromptSubmit?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SubagentStop?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        PreCompact?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+                timeout?: number | undefined;
+                statusMessage?: string | undefined;
+            }[];
+            matcher: string;
+        }[] | undefined;
+    } | undefined;
+    permissions?: unknown;
+    model?: string | undefined;
+}>;
+export type Settings = z.infer<typeof SettingsSchema>;
+/**
+ * Path-traversal check on every `command` value. Zod's job is shape;
+ * this lives OUTSIDE the schema so the rule is auditable separately.
+ *
+ * Algorithm:
+ *   1. Strip `$CLAUDE_PROJECT_DIR` (the harness expands this at exec).
+ *   2. Strip `"$CLAUDE_PROJECT_DIR"` (the canonical quoted form rea
+ *      itself emits).
+ *   3. Search for `..<sep>` segments in what remains. A literal `..`
+ *      anywhere in the path is treated as traversal.
+ *
+ * Returns a list of `{ event, matcher, index, command, reason }`
+ * tuples. Empty list = clean.
+ */
+export interface TraversalFinding {
+    event: string;
+    matcher: string;
+    index: number;
+    command: string;
+    reason: string;
+}
+export declare function validateNoTraversal(settings: Settings): TraversalFinding[];
+/**
+ * Result of validating a consumer `.claude/settings.json`.
+ *
+ *   - `parsed: true`  — zod parse succeeded; the schema-typed value is
+ *     `settings`.
+ *   - `parsed: false` — zod failed; `errors` is the list of
+ *     `z.ZodIssue` strings.
+ *
+ * Findings are accumulated regardless of zod success:
+ *   - `traversalFindings` — `..` segments inside `command` values.
+ *   - `missingReaHooks` — rea-shipped hooks (`EXPECTED_HOOKS`) that do
+ *     not appear in any `command` value across PreToolUse +
+ *     PostToolUse. Strict-mode `rea doctor` fails on a non-empty
+ *     list.
+ *
+ * Lossy-but-useful: when zod fails, we still try the traversal +
+ * missing-hooks checks against the raw input so the operator sees as
+ * much information as possible per `rea doctor` invocation.
+ */
+export interface SettingsValidationResult {
+    parsed: boolean;
+    settings: Settings | null;
+    errors: string[];
+    traversalFindings: TraversalFinding[];
+    missingReaHooks: string[];
+    /**
+     * Schema-passes-but-not-strict warnings: unknown top-level keys,
+     * unknown hook event names that we recognized as strings but didn't
+     * match the union. Empty when nothing surprising lurks.
+     */
+    warnings: string[];
+}
+/**
+ * Validate a parsed JSON object against the settings schema.
+ *
+ * Strategy: try `SettingsSchema.parse(input)`. On success run the
+ * traversal + missing-hooks checks. On failure fall back to a
+ * best-effort scan of any `hooks: { PreToolUse: [...] }` shape we
+ * recognize, so the operator still sees traversal + missing-hooks
+ * findings.
+ *
+ * `strict` selects the schema:
+ *   - `false` (default) — `SettingsSchema`, top-level `.passthrough()`.
+ *     Unknown harness keys pass. Used by `rea upgrade` and advisory
+ *     `rea doctor`.
+ *   - `true` — `SettingsSchemaStrict`, top-level `.strict()`. Unknown
+ *     keys fail the parse. Used only by `rea doctor --strict` (the CI
+ *     gate path). 0.30.1 round-5 P2: the strict schema existed since
+ *     0.30.0 but `validateSettings` never accepted the selector, so
+ *     `rea doctor --strict` silently ran the lenient schema.
+ */
+export declare function validateSettings(input: unknown, options?: {
+    strict?: boolean;
+}): SettingsValidationResult;
+/**
+ * Cross-check: every name in `EXPECTED_HOOKS` should appear as the
+ * basename of at least one `command` across PreToolUse + PostToolUse.
+ * Returns the missing list (empty when complete).
+ *
+ * Defensive: `EXPECTED_HOOKS` is sourced from `doctor.ts` so the
+ * single edit-point is preserved (new hook adds → both doctor's
+ * file-existence check AND this schema check pick it up).
+ */
+export declare function findMissingReaHooks(settings: Settings): string[];
+/**
+ * Compute the desired-hooks registration that `rea init` would emit
+ * for a fresh install. Exported so `rea doctor --strict` can show the
+ * operator the exact set the schema is enforcing without forcing them
+ * to dig through source.
+ */
+export declare function expectedHookNames(): string[];