@h-rig/contracts 0.0.6-alpha.18 → 0.0.6-alpha.180

package/dist/src/config.d.ts

@@ -0,0 +1,553 @@
+import { Schema } from "effect";
+export declare const WorkspaceIsolation: Schema.Literals<readonly ["worktree", "directory"]>;
+export type WorkspaceIsolation = typeof WorkspaceIsolation.Type;
+/**
+ * Git checkout strategy for agent workspaces. This is git HYGIENE (parallel
+ * runs don't trample each other), NOT a security boundary — the security
+ * boundary is `workspace.sandbox`.
+ */
+export declare const WorkspaceCheckout: Schema.Literals<readonly ["worktree", "directory"]>;
+export type WorkspaceCheckout = typeof WorkspaceCheckout.Type;
+/**
+ * Security sandbox mode for agent processes (macOS seatbelt / Linux bwrap).
+ * "enforce" (the default) refuses to run unsandboxed when no backend is
+ * available; "auto" degrades to unsandboxed with a warning; "off" opts out
+ * explicitly.
+ */
+export declare const WorkspaceSandbox: Schema.Literals<readonly ["enforce", "auto", "off"]>;
+export type WorkspaceSandbox = typeof WorkspaceSandbox.Type;
+export declare const ScopeSearchPrefix: Schema.Struct<{
+    readonly prefix: Schema.String;
+    readonly matchStartsWith: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly matchExact: Schema.optional<Schema.$Array<Schema.String>>;
+}>;
+export type ScopeSearchPrefix = typeof ScopeSearchPrefix.Type;
+export declare const ScopeNormalizationRules: Schema.Struct<{
+    readonly stripPrefixes: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly searchPrefixes: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly prefix: Schema.String;
+        readonly matchStartsWith: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly matchExact: Schema.optional<Schema.$Array<Schema.String>>;
+    }>>>;
+}>;
+export type ScopeNormalizationRules = typeof ScopeNormalizationRules.Type;
+export declare const WorkspaceConfig: Schema.Struct<{
+    readonly mainRepo: Schema.String;
+    /** Canonical name for the checkout axis; `isolation` is the deprecated alias. */
+    readonly checkout: Schema.optional<Schema.Literals<readonly ["worktree", "directory"]>>;
+    /** @deprecated Renamed to `checkout` — worktrees are git hygiene, not isolation. */
+    readonly isolation: Schema.optional<Schema.Literals<readonly ["worktree", "directory"]>>;
+    readonly sandbox: Schema.optional<Schema.Literals<readonly ["enforce", "auto", "off"]>>;
+    readonly scopeNormalization: Schema.optional<Schema.Struct<{
+        readonly stripPrefixes: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly searchPrefixes: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly prefix: Schema.String;
+            readonly matchStartsWith: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly matchExact: Schema.optional<Schema.$Array<Schema.String>>;
+        }>>>;
+    }>>;
+}>;
+export type WorkspaceConfig = typeof WorkspaceConfig.Type;
+export declare const TaskSourceConfig: Schema.Struct<{
+    readonly kind: Schema.String;
+    readonly path: Schema.optional<Schema.String>;
+    readonly owner: Schema.optional<Schema.String>;
+    readonly repo: Schema.optional<Schema.String>;
+    readonly labels: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly state: Schema.optional<Schema.Literals<readonly ["open", "closed", "all"]>>;
+    readonly url: Schema.optional<Schema.String>;
+    readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+}>;
+export type TaskSourceConfig = typeof TaskSourceConfig.Type;
+export declare const RuntimeHarness: Schema.Literal<"pi">;
+export type RuntimeHarness = typeof RuntimeHarness.Type;
+export declare const RigRuntimeMode: Schema.Literals<readonly ["yolo", "approval-required"]>;
+export type RigRuntimeMode = typeof RigRuntimeMode.Type;
+/**
+ * Pi harness configuration. `packages` lists Pi extension packages (npm
+ * specifiers like "pi-subagents" or "pi-web-access@1.2.0", or git sources)
+ * that Rig materializes into the workspace's `.pi/settings.json`. Pi
+ * auto-installs missing packages at session start, so worker sessions on
+ * remote hosts pick them up with no extra provisioning.
+ */
+export declare const PiRuntimeConfig: Schema.Struct<{
+    readonly packages: Schema.optional<Schema.$Array<Schema.String>>;
+}>;
+export type PiRuntimeConfig = typeof PiRuntimeConfig.Type;
+/**
+ * Rig backbone + placement, surfaced so EVERY value Rig would otherwise compute
+ * or hardcode is settable from `rig.config.ts`. Resolution order everywhere is
+ * ambient env → `rig.config.ts` → computed default (the default is the value Rig
+ * computes today, e.g. host `where.rig-does.work`). All optional: omit and you get
+ * the computed default with zero config.
+ *
+ * - `host`     : the shared collab/discovery backbone host. relayUrl + registryUrl
+ *                derive from it (`wss://<host>`, `https://<host>/registry`) unless
+ *                set explicitly below.
+ * - `relayUrl`/`registryUrl` : explicit overrides of the derived backbone
+ *                endpoints.
+ * - `sshTarget`/`checkout` : remote run PLACEMENT (which machine executes a run,
+ *                and the checkout dir there) — formerly only in endpoints.toml /
+ *                connection.json, now surfaceable here too.
+ */
+export declare const RigServerConfig: Schema.Struct<{
+    readonly host: Schema.optional<Schema.String>;
+    readonly relayUrl: Schema.optional<Schema.String>;
+    readonly registryUrl: Schema.optional<Schema.String>;
+    readonly sshTarget: Schema.optional<Schema.String>;
+    readonly checkout: Schema.optional<Schema.String>;
+}>;
+export type RigServerConfig = typeof RigServerConfig.Type;
+export declare const RuntimeSupervisorConfig: Schema.Struct<{
+    readonly concurrency: Schema.optional<Schema.Int>;
+    readonly pauseOnAttention: Schema.optional<Schema.Boolean>;
+    readonly stopWhen: Schema.optional<Schema.$Array<Schema.Literals<readonly ["all-done", "all-human-blocked", "blocked", "work-pending", "max-tasks", "budget", "judge-stop", "operator-stop", "source-error"]>>>;
+    readonly maxTasks: Schema.optional<Schema.Int>;
+    readonly selectionPolicy: Schema.optional<Schema.Literals<readonly ["rank", "max-unblock", "blocking-only"]>>;
+    readonly failFast: Schema.optional<Schema.Boolean>;
+}>;
+export type RuntimeSupervisorConfig = typeof RuntimeSupervisorConfig.Type;
+export declare const RuntimeDriftConfig: Schema.Struct<{
+    readonly enabled: Schema.optional<Schema.Boolean>;
+    readonly failOnDrift: Schema.optional<Schema.Boolean>;
+    readonly docsGlobs: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly ignoreGlobs: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly judge: Schema.optional<Schema.Boolean>;
+}>;
+export type RuntimeDriftConfig = typeof RuntimeDriftConfig.Type;
+export declare const RuntimePlanningConfig: Schema.Struct<{
+    readonly architectRole: Schema.optional<Schema.String>;
+    readonly autoResolveFromCode: Schema.optional<Schema.Boolean>;
+    readonly materialize: Schema.optional<Schema.Literals<readonly ["dry-run", "create"]>>;
+}>;
+export type RuntimePlanningConfig = typeof RuntimePlanningConfig.Type;
+export declare const RuntimeConfig: Schema.Struct<{
+    readonly agentRoles: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly timeouts: Schema.optional<Schema.$Record<Schema.String, Schema.Number>>;
+    readonly harness: Schema.optional<Schema.Literal<"pi">>;
+    readonly model: Schema.optional<Schema.String>;
+    readonly mode: Schema.optional<Schema.Literals<readonly ["yolo", "approval-required"]>>;
+    readonly pi: Schema.optional<Schema.Struct<{
+        readonly packages: Schema.optional<Schema.$Array<Schema.String>>;
+    }>>;
+    /** Backbone (relay/registry) + remote placement; computed defaults under the hood. */
+    readonly server: Schema.optional<Schema.Struct<{
+        readonly host: Schema.optional<Schema.String>;
+        readonly relayUrl: Schema.optional<Schema.String>;
+        readonly registryUrl: Schema.optional<Schema.String>;
+        readonly sshTarget: Schema.optional<Schema.String>;
+        readonly checkout: Schema.optional<Schema.String>;
+    }>>;
+    readonly capabilities: Schema.optional<Schema.Struct<{
+        readonly capabilityPrecedence: Schema.optional<Schema.$Record<Schema.String, Schema.$Array<Schema.Trim>>>;
+        readonly kernelReplacementGrants: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly pluginId: Schema.Trim;
+            readonly grantedBy: Schema.optional<Schema.Trim>;
+            readonly reason: Schema.optional<Schema.String>;
+        }>>>;
+    }>>;
+    readonly supervisor: Schema.optional<Schema.Struct<{
+        readonly concurrency: Schema.optional<Schema.Int>;
+        readonly pauseOnAttention: Schema.optional<Schema.Boolean>;
+        readonly stopWhen: Schema.optional<Schema.$Array<Schema.Literals<readonly ["all-done", "all-human-blocked", "blocked", "work-pending", "max-tasks", "budget", "judge-stop", "operator-stop", "source-error"]>>>;
+        readonly maxTasks: Schema.optional<Schema.Int>;
+        readonly selectionPolicy: Schema.optional<Schema.Literals<readonly ["rank", "max-unblock", "blocking-only"]>>;
+        readonly failFast: Schema.optional<Schema.Boolean>;
+    }>>;
+    readonly drift: Schema.optional<Schema.Struct<{
+        readonly enabled: Schema.optional<Schema.Boolean>;
+        readonly failOnDrift: Schema.optional<Schema.Boolean>;
+        readonly docsGlobs: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly ignoreGlobs: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly judge: Schema.optional<Schema.Boolean>;
+    }>>;
+    readonly planning: Schema.optional<Schema.Struct<{
+        readonly architectRole: Schema.optional<Schema.String>;
+        readonly autoResolveFromCode: Schema.optional<Schema.Boolean>;
+        readonly materialize: Schema.optional<Schema.Literals<readonly ["dry-run", "create"]>>;
+    }>>;
+}>;
+export type RuntimeConfig = typeof RuntimeConfig.Type;
+export declare const ProjectIdentity: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly repo: Schema.optional<Schema.String>;
+}>;
+export type ProjectIdentity = typeof ProjectIdentity.Type;
+export declare const PlanningConfig: Schema.Struct<{
+    readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "always", "off"]>>;
+    readonly requireForLabels: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly skipForLabels: Schema.optional<Schema.$Array<Schema.String>>;
+}>;
+export type PlanningConfig = typeof PlanningConfig.Type;
+export declare const GitHubProjectStatusConfig: Schema.Struct<{
+    readonly enabled: Schema.optional<Schema.Boolean>;
+    readonly projectId: Schema.optional<Schema.String>;
+    readonly statusFieldId: Schema.optional<Schema.String>;
+    readonly statuses: Schema.optional<Schema.Struct<{
+        readonly running: Schema.optional<Schema.String>;
+        readonly prOpen: Schema.optional<Schema.String>;
+        readonly ciFixing: Schema.optional<Schema.String>;
+        readonly merging: Schema.optional<Schema.String>;
+        readonly done: Schema.optional<Schema.String>;
+        readonly needsAttention: Schema.optional<Schema.String>;
+    }>>;
+}>;
+export type GitHubProjectStatusConfig = typeof GitHubProjectStatusConfig.Type;
+export declare const GitHubConfig: Schema.Struct<{
+    /** @deprecated Ignored. Source adapters perform mechanical IO only; lifecycle/reflection owns issue-update policy. */
+    readonly issueUpdates: Schema.optional<Schema.String>;
+    readonly projects: Schema.optional<Schema.Struct<{
+        readonly enabled: Schema.optional<Schema.Boolean>;
+        readonly projectId: Schema.optional<Schema.String>;
+        readonly statusFieldId: Schema.optional<Schema.String>;
+        readonly statuses: Schema.optional<Schema.Struct<{
+            readonly running: Schema.optional<Schema.String>;
+            readonly prOpen: Schema.optional<Schema.String>;
+            readonly ciFixing: Schema.optional<Schema.String>;
+            readonly merging: Schema.optional<Schema.String>;
+            readonly done: Schema.optional<Schema.String>;
+            readonly needsAttention: Schema.optional<Schema.String>;
+        }>>;
+    }>>;
+}>;
+export type GitHubConfig = typeof GitHubConfig.Type;
+export declare const AutomationConfig: Schema.Struct<{
+    readonly maxValidationAttempts: Schema.optional<Schema.Number>;
+    readonly maxPrFixIterations: Schema.optional<Schema.Number>;
+}>;
+export type AutomationConfig = typeof AutomationConfig.Type;
+export declare const PullRequestConfig: Schema.Struct<{
+    readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "ask", "off"]>>;
+    readonly watchChecks: Schema.optional<Schema.Boolean>;
+    readonly autoFixChecks: Schema.optional<Schema.Boolean>;
+    readonly autoFixReview: Schema.optional<Schema.Boolean>;
+    readonly pendingTimeoutMs: Schema.optional<Schema.Number>;
+    readonly pendingPollMs: Schema.optional<Schema.Number>;
+}>;
+export type PullRequestConfig = typeof PullRequestConfig.Type;
+export declare const MergeConfig: Schema.Struct<{
+    readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "off", "pr-ready"]>>;
+    readonly method: Schema.optional<Schema.Literals<readonly ["repo-default", "squash", "merge", "rebase"]>>;
+    readonly deleteBranch: Schema.optional<Schema.Union<readonly [Schema.Literal<"repo-default">, Schema.Boolean]>>;
+    readonly allowedFailures: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly bypass: Schema.optional<Schema.Boolean>;
+}>;
+export type MergeConfig = typeof MergeConfig.Type;
+export declare const IssueAnalysisConfig: Schema.Struct<{
+    readonly enabled: Schema.optional<Schema.Boolean>;
+    readonly harness: Schema.optional<Schema.Literal<"pi">>;
+    readonly model: Schema.optional<Schema.String>;
+    readonly mode: Schema.optional<Schema.Literals<readonly ["continuous", "off"]>>;
+}>;
+export type IssueAnalysisConfig = typeof IssueAnalysisConfig.Type;
+export declare const ReviewConfig: Schema.Struct<{
+    readonly mode: Schema.optional<Schema.Literals<readonly ["off", "advisory", "required"]>>;
+    readonly provider: Schema.optional<Schema.Literals<readonly ["greptile", "github"]>>;
+}>;
+export type ReviewConfig = typeof ReviewConfig.Type;
+export declare const RigConfig: Schema.Struct<{
+    readonly project: Schema.Struct<{
+        readonly name: Schema.String;
+        readonly repo: Schema.optional<Schema.String>;
+    }>;
+    readonly plugins: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly provides: Schema.optional<Schema.$Array<Schema.Literals<readonly ["kernel", "journal", "stage-runner", "transport", "loader-policy"]>>>;
+        readonly requires: Schema.optional<Schema.$Array<Schema.Literals<readonly ["kernel", "journal", "stage-runner", "transport", "loader-policy"]>>>;
+        readonly replaces: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly capability: Schema.Literals<readonly ["kernel", "journal", "stage-runner", "transport", "loader-policy"]>;
+            readonly providerPluginId: Schema.Trim;
+        }>, Schema.Trim]>>>;
+        readonly contributes: Schema.optional<Schema.Struct<{
+            readonly validators: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly category: Schema.Literals<readonly ["boundary", "contract", "integration", "regression", "external", "custom"]>;
+                readonly description: Schema.optional<Schema.String>;
+            }>>>;
+            readonly hooks: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly event: Schema.Literals<readonly ["PreToolUse", "PostToolUse", "UserPromptSubmit", "Stop", "SessionStart", "SessionEnd"]>;
+                readonly matcher: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"all">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"tool">;
+                    readonly name: Schema.String;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"glob">;
+                    readonly pattern: Schema.String;
+                }>]>;
+                readonly command: Schema.optional<Schema.String>;
+                readonly description: Schema.optional<Schema.String>;
+            }>>>;
+            readonly skills: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly path: Schema.String;
+                readonly description: Schema.optional<Schema.String>;
+            }>>>;
+            readonly repoSources: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly url: Schema.String;
+                readonly defaultPath: Schema.optional<Schema.String>;
+                readonly description: Schema.optional<Schema.String>;
+                readonly defaultBranch: Schema.optional<Schema.String>;
+                readonly remoteEnvVar: Schema.optional<Schema.String>;
+                readonly checkoutEnvVar: Schema.optional<Schema.String>;
+            }>>>;
+            readonly agentRoles: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly defaultModel: Schema.optional<Schema.String>;
+                readonly description: Schema.optional<Schema.String>;
+            }>>>;
+            readonly taskFieldSchemas: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly fieldName: Schema.String;
+                readonly schemaJson: Schema.String;
+            }>>>;
+            readonly taskSources: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.String;
+                readonly description: Schema.optional<Schema.String>;
+            }>>>;
+            readonly cliCommands: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly family: Schema.optional<Schema.String>;
+                readonly command: Schema.optional<Schema.String>;
+                readonly description: Schema.optional<Schema.String>;
+                readonly usage: Schema.optional<Schema.String>;
+                readonly aliases: Schema.optional<Schema.$Array<Schema.String>>;
+                readonly projectRequired: Schema.optional<Schema.Boolean>;
+                readonly rootDefault: Schema.optional<Schema.Boolean>;
+                readonly productRoot: Schema.optional<Schema.Boolean>;
+                readonly subcommands: Schema.optional<Schema.$Array<Schema.String>>;
+            }>>>;
+            readonly stages: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.brand<Schema.Trim, "StageId">;
+                readonly kind: Schema.Literals<readonly ["transform", "gate", "observe"]>;
+                readonly before: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                readonly after: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                readonly priority: Schema.withDecodingDefault<Schema.Number>;
+                readonly protected: Schema.withDecodingDefault<Schema.Boolean>;
+            }>>>;
+            readonly stageMutations: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly op: Schema.Literal<"insert">;
+                readonly stage: Schema.Struct<{
+                    readonly id: Schema.brand<Schema.Trim, "StageId">;
+                    readonly kind: Schema.Literals<readonly ["transform", "gate", "observe"]>;
+                    readonly before: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                    readonly after: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                    readonly priority: Schema.withDecodingDefault<Schema.Number>;
+                    readonly protected: Schema.withDecodingDefault<Schema.Boolean>;
+                }>;
+                readonly contributedBy: Schema.optional<Schema.Trim>;
+            }>, Schema.Struct<{
+                readonly op: Schema.Literal<"remove">;
+                readonly id: Schema.brand<Schema.Trim, "StageId">;
+                readonly contributedBy: Schema.optional<Schema.Trim>;
+            }>, Schema.Struct<{
+                readonly op: Schema.Literal<"replace">;
+                readonly id: Schema.brand<Schema.Trim, "StageId">;
+                readonly stage: Schema.Struct<{
+                    readonly id: Schema.brand<Schema.Trim, "StageId">;
+                    readonly kind: Schema.Literals<readonly ["transform", "gate", "observe"]>;
+                    readonly before: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                    readonly after: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                    readonly priority: Schema.withDecodingDefault<Schema.Number>;
+                    readonly protected: Schema.withDecodingDefault<Schema.Boolean>;
+                }>;
+                readonly contributedBy: Schema.optional<Schema.Trim>;
+            }>, Schema.Struct<{
+                readonly op: Schema.Literal<"wrap">;
+                readonly id: Schema.brand<Schema.Trim, "StageId">;
+                readonly around: Schema.Struct<{
+                    readonly id: Schema.Trim;
+                    readonly priority: Schema.withDecodingDefault<Schema.Number>;
+                }>;
+                readonly contributedBy: Schema.optional<Schema.Trim>;
+            }>, Schema.Struct<{
+                readonly op: Schema.Literal<"reorder">;
+                readonly id: Schema.brand<Schema.Trim, "StageId">;
+                readonly before: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                readonly after: Schema.optional<Schema.$Array<Schema.brand<Schema.Trim, "StageId">>>;
+                readonly contributedBy: Schema.optional<Schema.Trim>;
+            }>]>>>;
+            readonly capabilities: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly title: Schema.String;
+                readonly description: Schema.optional<Schema.String>;
+                readonly commandId: Schema.optional<Schema.String>;
+                readonly panelId: Schema.optional<Schema.String>;
+                readonly run: Schema.optional<Schema.declare<import("./plugin").CapabilityRun, import("./plugin").CapabilityRun>>;
+            }>>>;
+            readonly panels: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly slot: Schema.String;
+                readonly title: Schema.String;
+                readonly capabilityId: Schema.optional<Schema.String>;
+                readonly badge: Schema.optional<Schema.String>;
+                readonly disabled: Schema.optional<Schema.Boolean>;
+                readonly description: Schema.optional<Schema.String>;
+            }>>>;
+            readonly blockerClassifiers: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly description: Schema.optional<Schema.String>;
+                readonly priority: Schema.optional<Schema.Number>;
+            }>>>;
+            readonly sessionExtensions: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly description: Schema.optional<Schema.String>;
+            }>>>;
+            readonly seedEntrypoints: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly description: Schema.optional<Schema.String>;
+                readonly basename: Schema.optional<Schema.String>;
+                readonly workerArg: Schema.optional<Schema.String>;
+                readonly insidePty: Schema.optional<Schema.Boolean>;
+            }>>>;
+        }>>;
+    }>>;
+    readonly taskSource: Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly path: Schema.optional<Schema.String>;
+        readonly owner: Schema.optional<Schema.String>;
+        readonly repo: Schema.optional<Schema.String>;
+        readonly labels: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly state: Schema.optional<Schema.Literals<readonly ["open", "closed", "all"]>>;
+        readonly url: Schema.optional<Schema.String>;
+        readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+    readonly workspace: Schema.Struct<{
+        readonly mainRepo: Schema.String;
+        /** Canonical name for the checkout axis; `isolation` is the deprecated alias. */
+        readonly checkout: Schema.optional<Schema.Literals<readonly ["worktree", "directory"]>>;
+        /** @deprecated Renamed to `checkout` — worktrees are git hygiene, not isolation. */
+        readonly isolation: Schema.optional<Schema.Literals<readonly ["worktree", "directory"]>>;
+        readonly sandbox: Schema.optional<Schema.Literals<readonly ["enforce", "auto", "off"]>>;
+        readonly scopeNormalization: Schema.optional<Schema.Struct<{
+            readonly stripPrefixes: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly searchPrefixes: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly prefix: Schema.String;
+                readonly matchStartsWith: Schema.optional<Schema.$Array<Schema.String>>;
+                readonly matchExact: Schema.optional<Schema.$Array<Schema.String>>;
+            }>>>;
+        }>>;
+    }>;
+    readonly runtime: Schema.optional<Schema.Struct<{
+        readonly agentRoles: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+        readonly timeouts: Schema.optional<Schema.$Record<Schema.String, Schema.Number>>;
+        readonly harness: Schema.optional<Schema.Literal<"pi">>;
+        readonly model: Schema.optional<Schema.String>;
+        readonly mode: Schema.optional<Schema.Literals<readonly ["yolo", "approval-required"]>>;
+        readonly pi: Schema.optional<Schema.Struct<{
+            readonly packages: Schema.optional<Schema.$Array<Schema.String>>;
+        }>>;
+        /** Backbone (relay/registry) + remote placement; computed defaults under the hood. */
+        readonly server: Schema.optional<Schema.Struct<{
+            readonly host: Schema.optional<Schema.String>;
+            readonly relayUrl: Schema.optional<Schema.String>;
+            readonly registryUrl: Schema.optional<Schema.String>;
+            readonly sshTarget: Schema.optional<Schema.String>;
+            readonly checkout: Schema.optional<Schema.String>;
+        }>>;
+        readonly capabilities: Schema.optional<Schema.Struct<{
+            readonly capabilityPrecedence: Schema.optional<Schema.$Record<Schema.String, Schema.$Array<Schema.Trim>>>;
+            readonly kernelReplacementGrants: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly pluginId: Schema.Trim;
+                readonly grantedBy: Schema.optional<Schema.Trim>;
+                readonly reason: Schema.optional<Schema.String>;
+            }>>>;
+        }>>;
+        readonly supervisor: Schema.optional<Schema.Struct<{
+            readonly concurrency: Schema.optional<Schema.Int>;
+            readonly pauseOnAttention: Schema.optional<Schema.Boolean>;
+            readonly stopWhen: Schema.optional<Schema.$Array<Schema.Literals<readonly ["all-done", "all-human-blocked", "blocked", "work-pending", "max-tasks", "budget", "judge-stop", "operator-stop", "source-error"]>>>;
+            readonly maxTasks: Schema.optional<Schema.Int>;
+            readonly selectionPolicy: Schema.optional<Schema.Literals<readonly ["rank", "max-unblock", "blocking-only"]>>;
+            readonly failFast: Schema.optional<Schema.Boolean>;
+        }>>;
+        readonly drift: Schema.optional<Schema.Struct<{
+            readonly enabled: Schema.optional<Schema.Boolean>;
+            readonly failOnDrift: Schema.optional<Schema.Boolean>;
+            readonly docsGlobs: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly ignoreGlobs: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly judge: Schema.optional<Schema.Boolean>;
+        }>>;
+        readonly planning: Schema.optional<Schema.Struct<{
+            readonly architectRole: Schema.optional<Schema.String>;
+            readonly autoResolveFromCode: Schema.optional<Schema.Boolean>;
+            readonly materialize: Schema.optional<Schema.Literals<readonly ["dry-run", "create"]>>;
+        }>>;
+    }>>;
+    readonly planning: Schema.optional<Schema.Struct<{
+        readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "always", "off"]>>;
+        readonly requireForLabels: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly skipForLabels: Schema.optional<Schema.$Array<Schema.String>>;
+    }>>;
+    readonly github: Schema.optional<Schema.Struct<{
+        /** @deprecated Ignored. Source adapters perform mechanical IO only; lifecycle/reflection owns issue-update policy. */
+        readonly issueUpdates: Schema.optional<Schema.String>;
+        readonly projects: Schema.optional<Schema.Struct<{
+            readonly enabled: Schema.optional<Schema.Boolean>;
+            readonly projectId: Schema.optional<Schema.String>;
+            readonly statusFieldId: Schema.optional<Schema.String>;
+            readonly statuses: Schema.optional<Schema.Struct<{
+                readonly running: Schema.optional<Schema.String>;
+                readonly prOpen: Schema.optional<Schema.String>;
+                readonly ciFixing: Schema.optional<Schema.String>;
+                readonly merging: Schema.optional<Schema.String>;
+                readonly done: Schema.optional<Schema.String>;
+                readonly needsAttention: Schema.optional<Schema.String>;
+            }>>;
+        }>>;
+    }>>;
+    readonly automation: Schema.optional<Schema.Struct<{
+        readonly maxValidationAttempts: Schema.optional<Schema.Number>;
+        readonly maxPrFixIterations: Schema.optional<Schema.Number>;
+    }>>;
+    readonly pr: Schema.optional<Schema.Struct<{
+        readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "ask", "off"]>>;
+        readonly watchChecks: Schema.optional<Schema.Boolean>;
+        readonly autoFixChecks: Schema.optional<Schema.Boolean>;
+        readonly autoFixReview: Schema.optional<Schema.Boolean>;
+        readonly pendingTimeoutMs: Schema.optional<Schema.Number>;
+        readonly pendingPollMs: Schema.optional<Schema.Number>;
+    }>>;
+    readonly merge: Schema.optional<Schema.Struct<{
+        readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "off", "pr-ready"]>>;
+        readonly method: Schema.optional<Schema.Literals<readonly ["repo-default", "squash", "merge", "rebase"]>>;
+        readonly deleteBranch: Schema.optional<Schema.Union<readonly [Schema.Literal<"repo-default">, Schema.Boolean]>>;
+        readonly allowedFailures: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly bypass: Schema.optional<Schema.Boolean>;
+    }>>;
+    readonly review: Schema.optional<Schema.Struct<{
+        readonly mode: Schema.optional<Schema.Literals<readonly ["off", "advisory", "required"]>>;
+        readonly provider: Schema.optional<Schema.Literals<readonly ["greptile", "github"]>>;
+    }>>;
+    readonly issueAnalysis: Schema.optional<Schema.Struct<{
+        readonly enabled: Schema.optional<Schema.Boolean>;
+        readonly harness: Schema.optional<Schema.Literal<"pi">>;
+        readonly model: Schema.optional<Schema.String>;
+        readonly mode: Schema.optional<Schema.Literals<readonly ["continuous", "off"]>>;
+    }>>;
+    readonly capabilities: Schema.optional<Schema.Struct<{
+        readonly capabilityPrecedence: Schema.optional<Schema.$Record<Schema.String, Schema.$Array<Schema.Trim>>>;
+        readonly kernelReplacementGrants: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly pluginId: Schema.Trim;
+            readonly grantedBy: Schema.optional<Schema.Trim>;
+            readonly reason: Schema.optional<Schema.String>;
+        }>>>;
+    }>>;
+    /**
+     * Generic env-override map: the single escape hatch that makes EVERY env-driven
+     * value (the dozens of `RIG_*` / `RIG_BAKED_*` / `RIG_BROWSER_*` knobs, plus any
+     * computed value that reads an env var) settable from `rig.config.ts` without a
+     * typed field per knob. The CLI applies these to `process.env` at startup
+     * FILL-IF-UNSET, so the precedence is:
+     *   ambient process env at run time  (top winner)
+     *   → `rig.config.ts` (this `env` map + typed sections)
+     *   → computed default / derived value (under the hood).
+     * i.e. `RIG_X=… rig …` always beats the config; the config beats the default.
+     */
+    readonly env: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+}>;
+export type RigConfig = typeof RigConfig.Type;