@iloom/cli 0.13.2 → 0.13.4

package/dist/index.d.ts

@@ -123,1767 +123,1819 @@ interface WorktreeCleanupOptions {
     dryRun?: boolean;
 }
 
-declare const VALID_CLAUDE_MODELS: readonly ["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"];
-type ClaudeModel = (typeof VALID_CLAUDE_MODELS)[number];
 /**
- * Zod schema for iloom settings
+ * Options for ResourceCleanup operations
  */
-declare const IloomSettingsSchema: z.ZodObject<{
-    mainBranch: z.ZodOptional<z.ZodString>;
-    sourceEnvOnStart: z.ZodDefault<z.ZodBoolean>;
-    worktreePrefix: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-    protectedBranches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    copyGitIgnoredPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    workflows: z.ZodOptional<z.ZodObject<{
-        issue: z.ZodOptional<z.ZodObject<{
-            permissionMode: z.ZodOptional<z.ZodEnum<["plan", "acceptEdits", "bypassPermissions", "default"]>>;
-            noVerify: z.ZodOptional<z.ZodBoolean>;
-            startIde: z.ZodDefault<z.ZodBoolean>;
-            startDevServer: z.ZodDefault<z.ZodBoolean>;
-            startAiAgent: z.ZodDefault<z.ZodBoolean>;
-            startTerminal: z.ZodDefault<z.ZodBoolean>;
-            generateSummary: z.ZodDefault<z.ZodBoolean>;
-        }, "strip", z.ZodTypeAny, {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        }, {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        }>>;
-        pr: z.ZodOptional<z.ZodObject<{
-            permissionMode: z.ZodOptional<z.ZodEnum<["plan", "acceptEdits", "bypassPermissions", "default"]>>;
-            noVerify: z.ZodOptional<z.ZodBoolean>;
-            startIde: z.ZodDefault<z.ZodBoolean>;
-            startDevServer: z.ZodDefault<z.ZodBoolean>;
-            startAiAgent: z.ZodDefault<z.ZodBoolean>;
-            startTerminal: z.ZodDefault<z.ZodBoolean>;
-            generateSummary: z.ZodDefault<z.ZodBoolean>;
-        }, "strip", z.ZodTypeAny, {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        }, {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        }>>;
-        regular: z.ZodOptional<z.ZodObject<{
-            permissionMode: z.ZodOptional<z.ZodEnum<["plan", "acceptEdits", "bypassPermissions", "default"]>>;
-            noVerify: z.ZodOptional<z.ZodBoolean>;
-            startIde: z.ZodDefault<z.ZodBoolean>;
-            startDevServer: z.ZodDefault<z.ZodBoolean>;
-            startAiAgent: z.ZodDefault<z.ZodBoolean>;
-            startTerminal: z.ZodDefault<z.ZodBoolean>;
-            generateSummary: z.ZodDefault<z.ZodBoolean>;
-        }, "strip", z.ZodTypeAny, {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        }, {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        issue?: {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        } | undefined;
-        pr?: {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        } | undefined;
-        regular?: {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        } | undefined;
-    }, {
-        issue?: {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        } | undefined;
-        pr?: {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        } | undefined;
-        regular?: {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        } | undefined;
-    }>>;
-    agents: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        model: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
-        swarmModel: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["claude", "gemini", "codex"]>, z.ZodString>>;
-        review: z.ZodOptional<z.ZodBoolean>;
-        swarmReview: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        enabled?: boolean | undefined;
-        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
-        review?: boolean | undefined;
-        swarmReview?: boolean | undefined;
-    }, {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        enabled?: boolean | undefined;
-        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
-        review?: boolean | undefined;
-        swarmReview?: boolean | undefined;
-    }>>>>;
-    spin: z.ZodOptional<z.ZodObject<{
-        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
-        swarmModel: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
-        postSwarmReview: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
-        postSwarmReview: boolean;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-    }, {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        postSwarmReview?: boolean | undefined;
-    }>>;
-    plan: z.ZodOptional<z.ZodObject<{
-        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
-        planner: z.ZodDefault<z.ZodEnum<["claude", "gemini", "codex"]>>;
-        reviewer: z.ZodDefault<z.ZodEnum<["claude", "gemini", "codex", "none"]>>;
-        waveVerification: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
-        planner: "claude" | "gemini" | "codex";
-        reviewer: "claude" | "gemini" | "codex" | "none";
-        waveVerification: boolean;
-    }, {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        planner?: "claude" | "gemini" | "codex" | undefined;
-        reviewer?: "claude" | "gemini" | "codex" | "none" | undefined;
-        waveVerification?: boolean | undefined;
-    }>>;
-    summary: z.ZodOptional<z.ZodObject<{
-        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
-    }, "strip", z.ZodTypeAny, {
-        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
-    }, {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-    }>>;
-    capabilities: z.ZodOptional<z.ZodObject<{
-        web: z.ZodOptional<z.ZodObject<{
-            basePort: z.ZodOptional<z.ZodNumber>;
-            protocol: z.ZodDefault<z.ZodEnum<["http", "https"]>>;
-            devServer: z.ZodDefault<z.ZodEnum<["process", "docker"]>>;
-            dockerFile: z.ZodDefault<z.ZodString>;
-            containerPort: z.ZodOptional<z.ZodNumber>;
-            dockerBuildArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            dockerBuildSecrets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            dockerRunArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            dockerRunEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            protocol: "http" | "https";
-            devServer: "docker" | "process";
-            dockerFile: string;
-            basePort?: number | undefined;
-            containerPort?: number | undefined;
-            dockerBuildArgs?: Record<string, string> | undefined;
-            dockerBuildSecrets?: Record<string, string> | undefined;
-            dockerRunArgs?: string[] | undefined;
-            dockerRunEnv?: Record<string, string> | undefined;
-        }, {
-            basePort?: number | undefined;
-            protocol?: "http" | "https" | undefined;
-            devServer?: "docker" | "process" | undefined;
-            dockerFile?: string | undefined;
-            containerPort?: number | undefined;
-            dockerBuildArgs?: Record<string, string> | undefined;
-            dockerBuildSecrets?: Record<string, string> | undefined;
-            dockerRunArgs?: string[] | undefined;
-            dockerRunEnv?: Record<string, string> | undefined;
-        }>>;
-        database: z.ZodOptional<z.ZodObject<{
-            databaseUrlEnvVarName: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            databaseUrlEnvVarName: string;
-        }, {
-            databaseUrlEnvVarName?: string | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        web?: {
-            protocol: "http" | "https";
-            devServer: "docker" | "process";
-            dockerFile: string;
-            basePort?: number | undefined;
-            containerPort?: number | undefined;
-            dockerBuildArgs?: Record<string, string> | undefined;
-            dockerBuildSecrets?: Record<string, string> | undefined;
-            dockerRunArgs?: string[] | undefined;
-            dockerRunEnv?: Record<string, string> | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName: string;
-        } | undefined;
-    }, {
-        web?: {
-            basePort?: number | undefined;
-            protocol?: "http" | "https" | undefined;
-            devServer?: "docker" | "process" | undefined;
-            dockerFile?: string | undefined;
-            containerPort?: number | undefined;
-            dockerBuildArgs?: Record<string, string> | undefined;
-            dockerBuildSecrets?: Record<string, string> | undefined;
-            dockerRunArgs?: string[] | undefined;
-            dockerRunEnv?: Record<string, string> | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName?: string | undefined;
-        } | undefined;
-    }>>;
-    devServer: z.ZodOptional<z.ZodObject<{
-        mode: z.ZodDefault<z.ZodEnum<["docker"]>>;
-        docker: z.ZodOptional<z.ZodObject<{
-            dockerFile: z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>;
-            containerPort: z.ZodOptional<z.ZodNumber>;
-            buildArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            runArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            runEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            dockerFile: string;
-            containerPort?: number | undefined;
-            buildArgs?: Record<string, string> | undefined;
-            runArgs?: string[] | undefined;
-            runEnv?: Record<string, string> | undefined;
-        }, {
-            dockerFile?: string | undefined;
-            containerPort?: number | undefined;
-            buildArgs?: Record<string, string> | undefined;
-            runArgs?: string[] | undefined;
-            runEnv?: Record<string, string> | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        mode: "docker";
-        docker?: {
-            dockerFile: string;
-            containerPort?: number | undefined;
-            buildArgs?: Record<string, string> | undefined;
-            runArgs?: string[] | undefined;
-            runEnv?: Record<string, string> | undefined;
-        } | undefined;
-    }, {
-        docker?: {
-            dockerFile?: string | undefined;
-            containerPort?: number | undefined;
-            buildArgs?: Record<string, string> | undefined;
-            runArgs?: string[] | undefined;
-            runEnv?: Record<string, string> | undefined;
-        } | undefined;
-        mode?: "docker" | undefined;
-    }>>;
-    databaseProviders: z.ZodOptional<z.ZodObject<{
-        neon: z.ZodOptional<z.ZodObject<{
-            projectId: z.ZodString;
-            parentBranch: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            projectId: string;
-            parentBranch: string;
-        }, {
-            projectId: string;
-            parentBranch: string;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        neon?: {
-            projectId: string;
-            parentBranch: string;
-        } | undefined;
-    }, {
-        neon?: {
-            projectId: string;
-            parentBranch: string;
-        } | undefined;
-    }>>;
-    issueManagement: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<["github", "linear", "jira"]>>>;
-        github: z.ZodOptional<z.ZodObject<{
-            remote: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            remote: string;
-        }, {
-            remote: string;
-        }>>;
-        linear: z.ZodOptional<z.ZodObject<{
-            teamId: z.ZodString;
-            branchFormat: z.ZodOptional<z.ZodString>;
-            apiToken: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            teamId: string;
-            branchFormat?: string | undefined;
-            apiToken?: string | undefined;
-        }, {
-            teamId: string;
-            branchFormat?: string | undefined;
-            apiToken?: string | undefined;
-        }>>;
-        jira: z.ZodOptional<z.ZodObject<{
-            host: z.ZodString;
-            username: z.ZodString;
-            apiToken: z.ZodOptional<z.ZodString>;
-            projectKey: z.ZodString;
-            boardId: z.ZodOptional<z.ZodString>;
-            transitionMappings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            defaultIssueType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            defaultSubtaskType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            doneStatuses: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
-        }, "strip", z.ZodTypeAny, {
-            host: string;
-            username: string;
-            projectKey: string;
-            defaultIssueType: string;
-            defaultSubtaskType: string;
-            doneStatuses: string[];
-            apiToken?: string | undefined;
-            boardId?: string | undefined;
-            transitionMappings?: Record<string, string> | undefined;
-        }, {
-            host: string;
-            username: string;
-            projectKey: string;
-            apiToken?: string | undefined;
-            boardId?: string | undefined;
-            transitionMappings?: Record<string, string> | undefined;
-            defaultIssueType?: string | undefined;
-            defaultSubtaskType?: string | undefined;
-            doneStatuses?: string[] | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        provider: "github" | "linear" | "jira";
-        github?: {
-            remote: string;
-        } | undefined;
-        linear?: {
-            teamId: string;
-            branchFormat?: string | undefined;
-            apiToken?: string | undefined;
-        } | undefined;
-        jira?: {
-            host: string;
-            username: string;
-            projectKey: string;
-            defaultIssueType: string;
-            defaultSubtaskType: string;
-            doneStatuses: string[];
-            apiToken?: string | undefined;
-            boardId?: string | undefined;
-            transitionMappings?: Record<string, string> | undefined;
-        } | undefined;
-    }, {
-        github?: {
-            remote: string;
-        } | undefined;
-        linear?: {
-            teamId: string;
-            branchFormat?: string | undefined;
-            apiToken?: string | undefined;
-        } | undefined;
-        jira?: {
-            host: string;
-            username: string;
-            projectKey: string;
-            apiToken?: string | undefined;
-            boardId?: string | undefined;
-            transitionMappings?: Record<string, string> | undefined;
-            defaultIssueType?: string | undefined;
-            defaultSubtaskType?: string | undefined;
-            doneStatuses?: string[] | undefined;
-        } | undefined;
-        provider?: "github" | "linear" | "jira" | undefined;
-    }>>;
-    versionControl: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<["github", "bitbucket"]>>>;
-        bitbucket: z.ZodOptional<z.ZodObject<{
-            username: z.ZodString;
-            apiToken: z.ZodOptional<z.ZodString>;
-            workspace: z.ZodOptional<z.ZodString>;
-            repoSlug: z.ZodOptional<z.ZodString>;
-            reviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            username: string;
-            apiToken?: string | undefined;
-            workspace?: string | undefined;
-            repoSlug?: string | undefined;
-            reviewers?: string[] | undefined;
-        }, {
-            username: string;
-            apiToken?: string | undefined;
-            workspace?: string | undefined;
-            repoSlug?: string | undefined;
-            reviewers?: string[] | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        provider: "github" | "bitbucket";
-        bitbucket?: {
-            username: string;
-            apiToken?: string | undefined;
-            workspace?: string | undefined;
-            repoSlug?: string | undefined;
-            reviewers?: string[] | undefined;
-        } | undefined;
-    }, {
-        provider?: "github" | "bitbucket" | undefined;
-        bitbucket?: {
-            username: string;
-            apiToken?: string | undefined;
-            workspace?: string | undefined;
-            repoSlug?: string | undefined;
-            reviewers?: string[] | undefined;
-        } | undefined;
-    }>>;
-    mergeBehavior: z.ZodOptional<z.ZodObject<{
-        mode: z.ZodEffects<z.ZodDefault<z.ZodEnum<["local", "pr", "draft-pr", "github-pr", "github-draft-pr", "bitbucket-pr"]>>, "pr" | "local" | "draft-pr", "pr" | "local" | "draft-pr" | "github-pr" | "github-draft-pr" | "bitbucket-pr" | undefined>;
-        remote: z.ZodOptional<z.ZodString>;
-        autoCommitPush: z.ZodOptional<z.ZodBoolean>;
-        prTitlePrefix: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
-        openBrowserOnFinish: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        mode: "pr" | "local" | "draft-pr";
-        openBrowserOnFinish: boolean;
-        remote?: string | undefined;
-        autoCommitPush?: boolean | undefined;
-        prTitlePrefix?: boolean | undefined;
-    }, {
-        mode?: "pr" | "local" | "draft-pr" | "github-pr" | "github-draft-pr" | "bitbucket-pr" | undefined;
-        remote?: string | undefined;
-        autoCommitPush?: boolean | undefined;
-        prTitlePrefix?: boolean | undefined;
-        openBrowserOnFinish?: boolean | undefined;
-    }>>;
-    ide: z.ZodOptional<z.ZodObject<{
-        type: z.ZodDefault<z.ZodEnum<["vscode", "cursor", "webstorm", "sublime", "intellij", "windsurf", "antigravity"]>>;
-    }, "strip", z.ZodTypeAny, {
-        type: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity";
-    }, {
-        type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity" | undefined;
-    }>>;
-    colors: z.ZodOptional<z.ZodObject<{
-        terminal: z.ZodDefault<z.ZodBoolean>;
-        vscode: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        terminal: boolean;
-        vscode: boolean;
-    }, {
-        terminal?: boolean | undefined;
-        vscode?: boolean | undefined;
-    }>>;
-    attribution: z.ZodDefault<z.ZodEnum<["off", "upstreamOnly", "on"]>>;
-    git: z.ZodDefault<z.ZodObject<{
-        commitTimeout: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        commitTimeout: number;
-    }, {
-        commitTimeout?: number | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    sourceEnvOnStart: boolean;
-    attribution: "off" | "upstreamOnly" | "on";
-    git: {
-        commitTimeout: number;
-    };
-    plan?: {
-        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
-        planner: "claude" | "gemini" | "codex";
-        reviewer: "claude" | "gemini" | "codex" | "none";
-        waveVerification: boolean;
-    } | undefined;
-    spin?: {
-        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
-        postSwarmReview: boolean;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-    } | undefined;
-    devServer?: {
-        mode: "docker";
-        docker?: {
-            dockerFile: string;
-            containerPort?: number | undefined;
-            buildArgs?: Record<string, string> | undefined;
-            runArgs?: string[] | undefined;
-            runEnv?: Record<string, string> | undefined;
-        } | undefined;
-    } | undefined;
-    mainBranch?: string | undefined;
-    worktreePrefix?: string | undefined;
-    protectedBranches?: string[] | undefined;
-    copyGitIgnoredPatterns?: string[] | undefined;
-    workflows?: {
-        issue?: {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        } | undefined;
-        pr?: {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        } | undefined;
-        regular?: {
-            startIde: boolean;
-            startDevServer: boolean;
-            startAiAgent: boolean;
-            startTerminal: boolean;
-            generateSummary: boolean;
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-        } | undefined;
-    } | undefined;
-    agents?: Record<string, {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        enabled?: boolean | undefined;
-        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
-        review?: boolean | undefined;
-        swarmReview?: boolean | undefined;
-    }> | null | undefined;
-    summary?: {
-        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
-    } | undefined;
-    capabilities?: {
-        web?: {
-            protocol: "http" | "https";
-            devServer: "docker" | "process";
-            dockerFile: string;
-            basePort?: number | undefined;
-            containerPort?: number | undefined;
-            dockerBuildArgs?: Record<string, string> | undefined;
-            dockerBuildSecrets?: Record<string, string> | undefined;
-            dockerRunArgs?: string[] | undefined;
-            dockerRunEnv?: Record<string, string> | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName: string;
-        } | undefined;
-    } | undefined;
-    databaseProviders?: {
-        neon?: {
-            projectId: string;
-            parentBranch: string;
-        } | undefined;
-    } | undefined;
-    issueManagement?: {
-        provider: "github" | "linear" | "jira";
-        github?: {
-            remote: string;
-        } | undefined;
-        linear?: {
-            teamId: string;
-            branchFormat?: string | undefined;
-            apiToken?: string | undefined;
-        } | undefined;
-        jira?: {
-            host: string;
-            username: string;
-            projectKey: string;
-            defaultIssueType: string;
-            defaultSubtaskType: string;
-            doneStatuses: string[];
-            apiToken?: string | undefined;
-            boardId?: string | undefined;
-            transitionMappings?: Record<string, string> | undefined;
-        } | undefined;
-    } | undefined;
-    versionControl?: {
-        provider: "github" | "bitbucket";
-        bitbucket?: {
-            username: string;
-            apiToken?: string | undefined;
-            workspace?: string | undefined;
-            repoSlug?: string | undefined;
-            reviewers?: string[] | undefined;
-        } | undefined;
-    } | undefined;
-    mergeBehavior?: {
-        mode: "pr" | "local" | "draft-pr";
-        openBrowserOnFinish: boolean;
-        remote?: string | undefined;
-        autoCommitPush?: boolean | undefined;
-        prTitlePrefix?: boolean | undefined;
-    } | undefined;
-    ide?: {
-        type: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity";
-    } | undefined;
-    colors?: {
-        terminal: boolean;
-        vscode: boolean;
-    } | undefined;
-}, {
-    plan?: {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        planner?: "claude" | "gemini" | "codex" | undefined;
-        reviewer?: "claude" | "gemini" | "codex" | "none" | undefined;
-        waveVerification?: boolean | undefined;
-    } | undefined;
-    spin?: {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        postSwarmReview?: boolean | undefined;
-    } | undefined;
-    devServer?: {
-        docker?: {
-            dockerFile?: string | undefined;
-            containerPort?: number | undefined;
-            buildArgs?: Record<string, string> | undefined;
-            runArgs?: string[] | undefined;
-            runEnv?: Record<string, string> | undefined;
-        } | undefined;
-        mode?: "docker" | undefined;
-    } | undefined;
-    mainBranch?: string | undefined;
-    sourceEnvOnStart?: boolean | undefined;
-    worktreePrefix?: string | undefined;
-    protectedBranches?: string[] | undefined;
-    copyGitIgnoredPatterns?: string[] | undefined;
-    workflows?: {
-        issue?: {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        } | undefined;
-        pr?: {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        } | undefined;
-        regular?: {
-            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
-            noVerify?: boolean | undefined;
-            startIde?: boolean | undefined;
-            startDevServer?: boolean | undefined;
-            startAiAgent?: boolean | undefined;
-            startTerminal?: boolean | undefined;
-            generateSummary?: boolean | undefined;
-        } | undefined;
-    } | undefined;
-    agents?: Record<string, {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-        enabled?: boolean | undefined;
-        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
-        review?: boolean | undefined;
-        swarmReview?: boolean | undefined;
-    }> | null | undefined;
-    summary?: {
-        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
-    } | undefined;
-    capabilities?: {
-        web?: {
-            basePort?: number | undefined;
-            protocol?: "http" | "https" | undefined;
-            devServer?: "docker" | "process" | undefined;
-            dockerFile?: string | undefined;
-            containerPort?: number | undefined;
-            dockerBuildArgs?: Record<string, string> | undefined;
-            dockerBuildSecrets?: Record<string, string> | undefined;
-            dockerRunArgs?: string[] | undefined;
-            dockerRunEnv?: Record<string, string> | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName?: string | undefined;
-        } | undefined;
-    } | undefined;
-    databaseProviders?: {
-        neon?: {
-            projectId: string;
-            parentBranch: string;
-        } | undefined;
-    } | undefined;
-    issueManagement?: {
-        github?: {
-            remote: string;
-        } | undefined;
-        linear?: {
-            teamId: string;
-            branchFormat?: string | undefined;
-            apiToken?: string | undefined;
-        } | undefined;
-        jira?: {
-            host: string;
-            username: string;
-            projectKey: string;
-            apiToken?: string | undefined;
-            boardId?: string | undefined;
-            transitionMappings?: Record<string, string> | undefined;
-            defaultIssueType?: string | undefined;
-            defaultSubtaskType?: string | undefined;
-            doneStatuses?: string[] | undefined;
-        } | undefined;
-        provider?: "github" | "linear" | "jira" | undefined;
-    } | undefined;
-    versionControl?: {
-        provider?: "github" | "bitbucket" | undefined;
-        bitbucket?: {
-            username: string;
-            apiToken?: string | undefined;
-            workspace?: string | undefined;
-            repoSlug?: string | undefined;
-            reviewers?: string[] | undefined;
-        } | undefined;
-    } | undefined;
-    mergeBehavior?: {
-        mode?: "pr" | "local" | "draft-pr" | "github-pr" | "github-draft-pr" | "bitbucket-pr" | undefined;
-        remote?: string | undefined;
-        autoCommitPush?: boolean | undefined;
-        prTitlePrefix?: boolean | undefined;
-        openBrowserOnFinish?: boolean | undefined;
-    } | undefined;
-    ide?: {
-        type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity" | undefined;
-    } | undefined;
-    colors?: {
-        terminal?: boolean | undefined;
-        vscode?: boolean | undefined;
-    } | undefined;
-    attribution?: "off" | "upstreamOnly" | "on" | undefined;
-    git?: {
-        commitTimeout?: number | undefined;
-    } | undefined;
-}>;
+interface ResourceCleanupOptions {
+    /** Preview operations without executing */
+    dryRun?: boolean;
+    /** Skip confirmations and safety checks */
+    force?: boolean;
+    /** Delete the associated branch */
+    deleteBranch?: boolean;
+    /** Keep database branch instead of deleting */
+    keepDatabase?: boolean;
+    /** Prompt for confirmation before operations */
+    interactive?: boolean;
+    /** Check if branch is merged before allowing cleanup (defaults to true when deleteBranch is true) */
+    checkMergeSafety?: boolean;
+    /** Check if branch exists on remote before allowing cleanup (useful for GitHub-PR mode) */
+    checkRemoteBranch?: boolean;
+    /** Pre-resolved worktree to clean up (skips the search step) */
+    worktree?: {
+        path: string;
+        branch: string;
+    };
+    /** Archive metadata instead of deleting (preserves loom in il list --finished) */
+    archive?: boolean;
+}
+/**
+ * Result of a cleanup operation
+ */
+interface CleanupResult {
+    /** Identifier that was cleaned up */
+    identifier: string;
+    /** Actual branch name that was found (will differ from identifier) */
+    branchName?: string;
+    /** Overall success status */
+    success: boolean;
+    /** Whether this was a dry-run operation */
+    dryRun?: boolean;
+    /** Individual operation results */
+    operations: OperationResult[];
+    /** Errors encountered during cleanup */
+    errors: Error[];
+    /** Whether rollback is required */
+    rollbackRequired?: boolean;
+}
+/**
+ * Result of an individual cleanup operation
+ */
+interface OperationResult {
+    /** Type of operation performed */
+    type: 'dev-server' | 'worktree' | 'branch' | 'database' | 'cli-symlinks' | 'recap' | 'metadata' | 'trust';
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Human-readable message */
+    message: string;
+    /** Error message if operation failed */
+    error?: string;
+    /** For database operations: whether branch was actually deleted (vs not found) */
+    deleted?: boolean;
+}
+/**
+ * Safety check result
+ */
+interface SafetyCheck {
+    /** Whether cleanup is safe to proceed */
+    isSafe: boolean;
+    /** Non-blocking warnings */
+    warnings: string[];
+    /** Blocking issues that prevent cleanup */
+    blockers: string[];
+}
+/**
+ * Options for branch deletion
+ */
+interface BranchDeleteOptions {
+    /** Force delete unmerged branch */
+    force?: boolean;
+    /** Also delete remote branch */
+    remote?: boolean;
+    /** Preview without executing */
+    dryRun?: boolean;
+    /** Path to the worktree being cleaned up (for merge target resolution) - DEPRECATED: use mergeTargetBranch instead */
+    worktreePath?: string;
+    /** Pre-fetched merge target branch (parent branch for child looms, main branch for others).
+     * This must be fetched BEFORE worktree deletion since metadata won't be readable after deletion. */
+    mergeTargetBranch?: string;
+    /** Safety check has verified no data loss risk. When true, allows force delete
+     * if git branch -d fails with "not fully merged" since safety is already confirmed. */
+    safetyVerified?: boolean;
+}
 /**
- * TypeScript type for iloom settings derived from Zod schema
+ * Target for batch cleanup - represents a branch that may or may not have a worktree
  */
-type IloomSettings = z.infer<typeof IloomSettingsSchema>;
+interface BranchCleanupTarget {
+    /** Branch name */
+    branchName: string;
+    /** Whether this branch has an associated worktree */
+    hasWorktree: boolean;
+    /** Path to worktree if it exists */
+    worktreePath?: string;
+}
 /**
- * Manages project-level settings from .iloom/settings.json
+ * Result of batch cleanup operation for an issue
  */
-declare class SettingsManager {
-    /**
-     * Load settings from global, project, and local sources with proper precedence
-     * Merge hierarchy (lowest to highest priority):
-     * 1. Global settings (~/.config/iloom-ai/settings.json)
-     * 2. Project settings (<PROJECT_ROOT>/.iloom/settings.json)
-     * 3. Local settings (<PROJECT_ROOT>/.iloom/settings.local.json)
-     * 4. CLI overrides (--set flags)
-     * Returns empty object if all files don't exist (not an error)
-     */
-    loadSettings(projectRoot?: string, cliOverrides?: Partial<IloomSettings>): Promise<IloomSettings>;
-    /**
-     * Log the final merged configuration for debugging
-     */
-    private logFinalConfiguration;
-    /**
-     * Load and parse a single settings file
-     * Returns empty object if file doesn't exist (not an error)
-     * Uses non-defaulting schema to prevent polluting partial settings with defaults before merge
-     */
-    private loadSettingsFile;
-    /**
-     * Deep merge two settings objects with priority to override
-     * Uses deepmerge library with array replacement strategy
-     */
-    private mergeSettings;
-    /**
-     * Format all Zod validation errors into a single error message
-     */
-    private formatAllZodErrors;
-    /**
-     * Validate settings structure and model names using Zod schema
-     * This method is kept for testing purposes but uses Zod internally
-     * @internal - Only used in tests via bracket notation
-     */
-    private validateSettings;
-    /**
-     * Get project root (defaults to process.cwd())
-     */
-    private getProjectRoot;
-    /**
-     * Get global config directory path (~/.config/iloom-ai)
-     */
-    private getGlobalConfigDir;
-    /**
-     * Get global settings file path (~/.config/iloom-ai/settings.json)
-     */
-    private getGlobalSettingsPath;
-    /**
-     * Load and parse global settings file
-     * Returns empty object if file doesn't exist (not an error)
-     * Warns but returns empty object on validation/parse errors (graceful degradation)
-     */
-    private loadGlobalSettingsFile;
-    /**
-     * Get effective protected branches list with mainBranch always included
-     *
-     * This method provides a single source of truth for protected branches logic:
-     * 1. Use configured protectedBranches if provided
-     * 2. Otherwise use defaults: [mainBranch, 'main', 'master', 'develop']
-     * 3. ALWAYS ensure mainBranch is included even if user configured custom list
-     *
-     * @param projectRoot - Optional project root directory (defaults to process.cwd())
-     * @returns Array of protected branch names with mainBranch guaranteed to be included
-     */
-    getProtectedBranches(projectRoot?: string): Promise<string[]>;
-    /**
-     * Get the spin orchestrator model with default applied
-     * Default is defined in SpinAgentSettingsSchema
-     *
-     * @param settings - Pre-loaded settings object
-     * @returns Model shorthand (e.g. 'opus', 'sonnet', 'haiku', 'sonnet[1m]', 'opus[1m]')
-     */
-    getSpinModel(settings?: IloomSettings, mode?: 'swarm'): ClaudeModel;
-    /**
-     * Get the plan command model with default applied
-     * Default is defined in PlanCommandSettingsSchema
-     *
-     * @param settings - Pre-loaded settings object
-     * @returns Model shorthand (e.g. 'opus', 'sonnet', 'haiku', 'sonnet[1m]', 'opus[1m]')
-     */
-    getPlanModel(settings?: IloomSettings): ClaudeModel;
-    /**
-     * Get the plan command planner with default applied
-     * Default is 'claude'
-     *
-     * @param settings - Pre-loaded settings object
-     * @returns Planner provider ('claude', 'gemini', or 'codex')
-     */
-    getPlanPlanner(settings?: IloomSettings): 'claude' | 'gemini' | 'codex';
-    /**
-     * Get the plan command reviewer with default applied
-     * Default is 'none' (no review step)
-     *
-     * @param settings - Pre-loaded settings object
-     * @returns Reviewer provider ('claude', 'gemini', 'codex', or 'none')
-     */
-    getPlanReviewer(settings?: IloomSettings): 'claude' | 'gemini' | 'codex' | 'none';
-    /**
-     * Get the plan command waveVerification setting with default applied
-     * Default is true (verification tasks are generated)
-     *
-     * @param settings - Pre-loaded settings object
-     * @returns Whether wave verification is enabled
-     */
-    getPlanWaveVerification(settings?: IloomSettings): boolean;
-    /**
-     * Get the session summary model with default applied
-     * Default is defined in SummarySettingsSchema
-     *
-     * @param settings - Pre-loaded settings object
-     * @returns Model shorthand (e.g. 'opus', 'sonnet', 'haiku', 'sonnet[1m]', 'opus[1m]')
-     */
-    getSummaryModel(settings?: IloomSettings): ClaudeModel;
+interface BatchCleanupResult {
+    /** Issue number that was cleaned up */
+    issueNumber: string | number;
+    /** Number of branches found matching the issue */
+    targetsFound: number;
+    /** Number of worktrees successfully removed */
+    worktreesRemoved: number;
+    /** Number of branches successfully deleted */
+    branchesDeleted: number;
+    /** Number of failed operations */
+    failed: number;
+    /** Individual cleanup results for each branch */
+    results: CleanupResult[];
+}
+
+/**
+ * Strategy interface for generating branch names from issue information
+ */
+interface BranchNameStrategy {
+    generate(issueNumber: string | number, title: string): Promise<string>;
+}
+/**
+ * Options for branch name generation
+ * Supports both simple generation and custom strategy override
+ */
+interface BranchGenerationOptions {
+    issueNumber: string | number;
+    title: string;
+    strategy?: BranchNameStrategy;
+}
+
+interface EnvVariable {
+    key: string;
+    value: string;
+}
+interface EnvFileOptions {
+    path: string;
+    backup?: boolean;
+    encoding?: BufferEncoding;
+}
+/**
+ * @deprecated Use exception-based error handling instead
+ */
+interface EnvOperationResult {
+    success: boolean;
+    backupPath?: string;
+    error?: string;
+}
+interface PortAssignmentOptions {
+    basePort?: number;
+    issueNumber?: string | number;
+    prNumber?: number;
+    branchName?: string;
+}
+
+type ProjectCapability = 'cli' | 'web';
+type Capability = ProjectCapability;
+interface Loom {
+    id: string;
+    path: string;
+    branch: string;
+    type: 'issue' | 'pr' | 'branch' | 'epic';
+    identifier: string | number;
+    port: number;
+    databaseBranch?: string;
+    description?: string;
+    createdAt: Date;
+    lastAccessed: Date;
+    issueData?: {
+        title?: string;
+        body?: string;
+        url?: string;
+        state?: string;
+    };
+    capabilities?: ProjectCapability[];
+    binEntries?: Record<string, string>;
+    cliSymlinks?: string[];
+}
+interface CreateLoomInput {
+    type: 'issue' | 'pr' | 'branch' | 'epic';
+    identifier: string | number;
+    originalInput: string;
+    baseBranch?: string;
+    parentLoom?: {
+        type: 'issue' | 'pr' | 'branch' | 'epic';
+        identifier: string | number;
+        branchName: string;
+        worktreePath: string;
+        databaseBranch?: string;
+    };
+    options?: {
+        skipDatabase?: boolean;
+        colorTerminal?: boolean;
+        colorVscode?: boolean;
+        enableClaude?: boolean;
+        enableCode?: boolean;
+        enableDevServer?: boolean;
+        enableTerminal?: boolean;
+        oneShot?: OneShotMode;
+        dangerouslySkipPermissions?: boolean;
+        complexity?: ComplexityOverride;
+        effort?: EffortLevel;
+        setArguments?: string[];
+        executablePath?: string;
+        sourceEnvOnStart?: boolean;
+        childIssueNumbers?: string[];
+        childIssues?: Array<{
+            number: string;
+            title: string;
+            body: string;
+            url: string;
+        }>;
+        dependencyMap?: Record<string, string[]>;
+    };
+}
+type LaunchMode = 'editor' | 'terminal' | 'both';
+interface LoomSummary {
+    id: string;
+    type: 'issue' | 'pr' | 'branch' | 'epic';
+    identifier: string | number;
+    title?: string;
+    branch: string;
+    port: number;
+    status: 'active' | 'stale' | 'error';
+    lastAccessed: string;
 }
 
 /**
- * Manages Git worktrees for the iloom CLI
- * Ports functionality from bash scripts into TypeScript
+ * Information about a running process
  */
-declare class GitWorktreeManager {
-    private readonly _workingDirectory;
-    constructor(workingDirectory?: string);
-    /**
-     * Get the working directory for git operations (main worktree path)
-     */
-    get workingDirectory(): string;
-    /**
-     * List all worktrees in the repository
-     * Defaults to porcelain format for reliable machine parsing
-     * Equivalent to: git worktree list --porcelain
-     */
-    listWorktrees(options?: WorktreeListOptions): Promise<GitWorktree[]>;
-    /**
-     * Find worktree for a specific branch
-     * Ports: find_worktree_for_branch() from find-worktree-for-branch.sh
-     */
-    findWorktreeForBranch(branchName: string): Promise<GitWorktree | null>;
-    /**
-     * Check if a worktree is the main repository worktree
-     * Uses findMainWorktreePathWithSettings to determine the main worktree based on settings.
-     *
-     * @param worktree - The worktree to check
-     * @param settingsManager - SettingsManager instance for loading settings
-     * @returns true if the worktree is the main worktree
-     */
-    isMainWorktree(worktree: GitWorktree, settingsManager: SettingsManager): Promise<boolean>;
-    /**
-     * Check if a worktree is a PR worktree based on naming patterns
-     * Ports: is_pr_worktree() from worktree-utils.sh
-     */
-    isPRWorktree(worktree: GitWorktree): boolean;
-    /**
-     * Get PR number from worktree branch name
-     * Ports: get_pr_number_from_worktree() from worktree-utils.sh
-     */
-    getPRNumberFromWorktree(worktree: GitWorktree): number | null;
-    /**
-     * Create a new worktree
-     * Ports worktree creation logic from new-branch-workflow.sh
-     * @returns The absolute path to the created worktree
-     */
-    createWorktree(options: WorktreeCreateOptions): Promise<string>;
-    /**
-     * Remove a worktree and optionally clean up associated files
-     * Ports worktree removal logic from cleanup-worktree.sh
-     * @returns A message describing what was done (for dry-run mode)
-     */
-    removeWorktree(worktreePath: string, options?: WorktreeCleanupOptions): Promise<string | void>;
-    /**
-     * Validate worktree state and integrity
-     */
-    validateWorktree(worktreePath: string): Promise<WorktreeValidation>;
-    /**
-     * Get detailed status information for a worktree
-     */
-    getWorktreeStatus(worktreePath: string): Promise<WorktreeStatus>;
-    /**
-     * Generate a suggested worktree path for a branch
-     */
-    generateWorktreePath(branchName: string, customRoot?: string, options?: {
-        isPR?: boolean;
-        prNumber?: number;
-        prefix?: string;
-    }): string;
-    /**
-     * Sanitize a branch name for use as a directory name
-     * Replaces slashes with dashes and removes invalid filesystem characters
-     * Ports logic from bash script line 593: ${BRANCH_NAME//\\//-}
-     */
-    sanitizeBranchName(branchName: string): string;
-    /**
-     * Check if repository is in a valid state for worktree operations
-     */
-    isRepoReady(): Promise<boolean>;
-    /**
-     * Get repository information
-     */
-    getRepoInfo(): Promise<{
-        root: string | null;
-        defaultBranch: string;
-        currentBranch: string | null;
-    }>;
-    /**
-     * Prune stale worktree entries (worktrees that no longer exist on disk)
-     */
-    pruneWorktrees(): Promise<void>;
-    /**
-     * Lock a worktree to prevent it from being pruned or moved
-     */
-    lockWorktree(worktreePath: string, reason?: string): Promise<void>;
-    /**
-     * Unlock a previously locked worktree
-     */
-    unlockWorktree(worktreePath: string): Promise<void>;
-    /**
-     * Find worktrees matching an identifier (branch name, path, or PR number)
-     */
-    findWorktreesByIdentifier(identifier: string): Promise<GitWorktree[]>;
-    /**
-     * Find worktree for a specific issue number using exact pattern matching
-     * Matches: issue-{N} at start OR after /, -, _ (but NOT issue-{N}X where X is a digit)
-     * Supports patterns like: issue-44, feat/issue-44-feature, feat-issue-44, bugfix_issue-44, etc.
-     * Avoids false matches like: tissue-44, myissue-44
-     * Ports: find_existing_worktree() from bash script lines 131-165
-     */
-    findWorktreeForIssue(issueNumber: string | number): Promise<GitWorktree | null>;
-    /**
-     * Find worktree for a specific PR by branch name
-     * Ports: find_existing_worktree() for PR type from bash script lines 149-160
-     */
-    findWorktreeForPR(prNumber: number, branchName: string): Promise<GitWorktree | null>;
+interface ProcessInfo {
+    /** Process ID */
+    pid: number;
+    /** Process name (e.g., "node", "pnpm") */
+    name: string;
+    /** Full command line */
+    command: string;
+    /** Port the process is listening on */
+    port: number;
+    /** Whether this appears to be a dev server */
+    isDevServer: boolean;
+}
+
+interface TelemetryConfig {
+    enabled: boolean;
+    disclosed_at?: string;
+    last_version?: string;
+}
+interface CliInstalledProperties {
+    version: string;
+    os: string;
+    node_version: string;
+}
+interface CliUpgradedProperties {
+    version: string;
+    previous_version: string;
+    os: string;
+}
+interface LoomCreatedProperties {
+    source_type: 'issue' | 'pr' | 'branch' | 'freeform';
+    tracker: string;
+    is_child_loom: boolean;
+    one_shot_mode: 'default' | 'skip-reviews' | 'yolo';
+    complexity_override: boolean;
+    create_only: boolean;
+}
+interface LoomFinishedProperties {
+    merge_behavior: 'local' | 'pr' | 'draft-pr';
+    duration_minutes: number;
+}
+interface LoomAbandonedProperties {
+    duration_minutes: number;
+    phase_reached: string;
+}
+interface EpicPlannedProperties {
+    child_count: number;
+    tracker: string;
+}
+interface SwarmStartedProperties {
+    child_count: number;
+    tracker: string;
+}
+interface SwarmChildCompletedProperties {
+    success: boolean;
+    duration_minutes: number;
+}
+interface SwarmCompletedProperties {
+    total_children: number;
+    succeeded: number;
+    failed: number;
+    duration_minutes: number;
+}
+interface DemoStartedProperties {
+    path: string;
+}
+interface DemoCompletedProperties {
+    path: string;
+    converted_to_real_project: boolean;
+}
+interface ContributeStartedProperties {
+    tracker: string;
+}
+interface SessionStartedProperties {
+    has_neon: boolean;
+    language: string;
+    effort?: EffortLevel;
+}
+interface ErrorOccurredProperties {
+    error_type: string;
+    command: string;
+    phase: string;
+}
+interface InitStartedProperties {
+    mode: 'accept-defaults' | 'guided' | 'guided-custom-prompt';
+}
+interface InitCompletedProperties {
+    mode: 'accept-defaults' | 'guided' | 'guided-custom-prompt';
+}
+interface AutoSwarmStartedProperties {
+    source: 'decomposition' | 'fresh';
+    planner: string;
+}
+interface AutoSwarmCompletedProperties {
+    source: 'decomposition' | 'fresh';
+    success: boolean;
+    child_count: number;
+    duration_minutes: number;
+    phase_reached: 'plan' | 'start' | 'spin';
+    fallback_to_normal: boolean;
+}
+interface EpicReportGeneratedProperties {
+    total_children: number;
+    succeeded: number;
+    failed: number;
+}
+interface DevServerStartedEvent {
+    /** Execution mode for the dev server */
+    mode: 'docker' | 'process';
+    /** Whether the dev server started successfully */
+    success: boolean;
     /**
-     * Remove multiple worktrees
-     * Returns a summary of successes and failures
-     * Automatically filters out the main worktree
-     *
-     * @param worktrees - Array of worktrees to remove
-     * @param settingsManager - SettingsManager instance for determining main worktree
-     * @param options - Cleanup options
+     * Time in milliseconds to build the Docker image.
+     * Only present when mode is 'docker'.
      */
-    removeWorktrees(worktrees: GitWorktree[], settingsManager: SettingsManager, options?: WorktreeCleanupOptions): Promise<{
-        successes: Array<{
-            worktree: GitWorktree;
-        }>;
-        failures: Array<{
-            worktree: GitWorktree;
-            error: string;
-        }>;
-        skipped: Array<{
-            worktree: GitWorktree;
-            reason: string;
-        }>;
-    }>;
+    buildDurationMs?: number;
+    /** Time in milliseconds from start to the server being ready */
+    startDurationMs: number;
     /**
-     * Format worktree information for display
+     * Number of BuildKit secrets mounted during docker build.
+     * Only present when mode is 'docker' and secrets are configured.
+     * Tracks feature adoption without exposing secret IDs or paths.
      */
-    formatWorktree(worktree: GitWorktree): {
-        title: string;
-        path: string;
-        commit: string;
-    };
+    docker_build_secrets_count?: number;
+}
+interface DevServerStoppedEvent {
+    /** Execution mode for the dev server */
+    mode: 'docker' | 'process';
+    /** Reason the dev server stopped */
+    reason: 'user' | 'cleanup' | 'error';
+}
+interface TelemetryEventMap {
+    'cli.installed': CliInstalledProperties;
+    'cli.upgraded': CliUpgradedProperties;
+    'loom.created': LoomCreatedProperties;
+    'loom.finished': LoomFinishedProperties;
+    'loom.abandoned': LoomAbandonedProperties;
+    'epic.planned': EpicPlannedProperties;
+    'swarm.started': SwarmStartedProperties;
+    'swarm.child_completed': SwarmChildCompletedProperties;
+    'swarm.completed': SwarmCompletedProperties;
+    'demo.started': DemoStartedProperties;
+    'demo.completed': DemoCompletedProperties;
+    'contribute.started': ContributeStartedProperties;
+    'session.started': SessionStartedProperties;
+    'error.occurred': ErrorOccurredProperties;
+    'init.started': InitStartedProperties;
+    'init.completed': InitCompletedProperties;
+    'auto_swarm.started': AutoSwarmStartedProperties;
+    'auto_swarm.completed': AutoSwarmCompletedProperties;
+    'epic.report_generated': EpicReportGeneratedProperties;
+    'devServer.started': DevServerStartedEvent;
+    'devServer.stopped': DevServerStoppedEvent;
+}
+type TelemetryEventName = keyof TelemetryEventMap;
+
+interface Workspace {
+    id: string;
+    path: string;
+    branch: string;
+    issueNumber?: string | number;
+    prNumber?: number;
+    port: number;
+    databaseBranch?: string;
+    createdAt: Date;
+    lastAccessed: Date;
+}
+interface WorkspaceInput {
+    identifier: string;
+    type: 'issue' | 'pr' | 'branch';
+    skipClaude?: boolean;
+}
+interface WorkspaceSummary {
+    id: string;
+    issueNumber?: string | number;
+    prNumber?: number;
+    title: string;
+    branch: string;
+    port: number;
+    status: 'active' | 'stale' | 'error';
+    lastAccessed: string;
+}
+interface Worktree {
+    path: string;
+    branch: string;
+    commit: string;
+    isPR: boolean;
+    prNumber?: number;
+    issueNumber?: string | number;
+    port?: number;
+}
+interface GitStatus {
+    hasUncommittedChanges: boolean;
+    unstagedFiles: string[];
+    stagedFiles: string[];
+    currentBranch: string;
+    isAheadOfRemote: boolean;
+    isBehindRemote: boolean;
+}
+interface Issue {
+    number: string | number;
+    title: string;
+    body: string;
+    state: 'open' | 'closed';
+    labels: string[];
+    assignees: string[];
+    url: string;
+}
+interface PullRequest {
+    number: number;
+    title: string;
+    body: string;
+    state: 'open' | 'closed' | 'merged';
+    branch: string;
+    baseBranch: string;
+    url: string;
+    isDraft: boolean;
+    isFork?: boolean;
+}
+/**
+ * Generic input detection result for issue trackers
+ * String-based identifier to support non-numeric IDs (e.g., Linear "ENG-123")
+ */
+interface IssueTrackerInputDetection {
+    type: 'issue' | 'pr' | 'unknown';
+    identifier: string | null;
+    rawInput: string;
 }
 
 /**
- * Options for ResourceCleanup operations
+ * Result of database branch deletion operation
+ * Distinguishes between successful deletion, branch not found, and errors
  */
-interface ResourceCleanupOptions {
-    /** Preview operations without executing */
+interface DatabaseDeletionResult {
+    /** Overall operation succeeded (true even if branch didn't exist) */
+    success: boolean;
+    /** True only if a branch was actually deleted */
+    deleted: boolean;
+    /** True if branch didn't exist (not an error, just nothing to do) */
+    notFound: boolean;
+    /** Error message if operation failed */
+    error?: string;
+    /** User declined deletion (for preview databases) */
+    userDeclined?: boolean;
+    /** Name of the branch that was processed */
+    branchName?: string;
+}
+interface DatabaseProvider {
+    createBranch(name: string, fromBranch?: string, cwd?: string): Promise<string>;
+    deleteBranch(name: string, isPreview?: boolean, cwd?: string): Promise<DatabaseDeletionResult>;
+    getConnectionString(branch: string, cwd?: string): Promise<string>;
+    listBranches(cwd?: string): Promise<string[]>;
+    branchExists(name: string, cwd?: string): Promise<boolean>;
+    findPreviewBranch(branchName: string, cwd?: string): Promise<string | null>;
+    getBranchNameFromEndpoint(endpointId: string, cwd?: string): Promise<string | null>;
+    sanitizeBranchName(branchName: string): string;
+    isAuthenticated(cwd?: string): Promise<boolean>;
+    isCliAvailable(): Promise<boolean>;
+    isConfigured(): boolean;
+}
+interface Config {
+    defaultPort: number;
+    databaseProvider?: 'neon' | 'supabase' | 'planetscale';
+    claudeModel?: ClaudeModel;
+    skipClaude?: boolean;
+    customWorkspaceRoot?: string;
+}
+type OneShotMode = 'default' | 'noReview' | 'bypassPermissions';
+type ComplexityOverride = 'trivial' | 'simple' | 'complex';
+declare const VALID_EFFORT_LEVELS: readonly ["low", "medium", "high", "max"];
+type EffortLevel = (typeof VALID_EFFORT_LEVELS)[number];
+/**
+ * Type guard for EffortLevel values
+ * Validates that a value is a valid effort level at runtime
+ */
+declare function isEffortLevel(value: unknown): value is EffortLevel;
+interface StartOptions {
+    claude?: boolean;
+    code?: boolean;
+    devServer?: boolean;
+    terminal?: boolean;
+    childLoom?: boolean;
+    epic?: boolean;
+    createOnly?: boolean;
+    oneShot?: OneShotMode;
+    dangerouslySkipPermissions?: boolean;
+    complexity?: ComplexityOverride;
+    effort?: EffortLevel;
+    body?: string;
+    json?: boolean;
+}
+interface AddIssueOptions {
+    body?: string;
+    json?: boolean;
+}
+interface FeedbackOptions {
+    body?: string;
+}
+interface EnhanceOptions {
+    noBrowser?: boolean;
+    json?: boolean;
+}
+interface FinishOptions {
+    force?: boolean;
     dryRun?: boolean;
-    /** Skip confirmations and safety checks */
+    pr?: number;
+    skipBuild?: boolean;
+    noBrowser?: boolean;
+    cleanup?: boolean;
+    json?: boolean;
+    skipToPr?: boolean;
+    jsonStream?: boolean;
+    review?: boolean;
+}
+/**
+ * Options for the cleanup command
+ * All flags are optional and can be combined (subject to validation)
+ */
+interface CleanupOptions {
+    /** List all worktrees without removing anything */
+    list?: boolean;
+    /** Remove all worktrees (interactive confirmation required unless --force) */
+    all?: boolean;
+    /** Cleanup by specific issue identifier (numeric or alphanumeric like RANDOM-13) */
+    issue?: string | number;
+    /** Skip confirmations and force removal */
     force?: boolean;
-    /** Delete the associated branch */
-    deleteBranch?: boolean;
-    /** Keep database branch instead of deleting */
-    keepDatabase?: boolean;
-    /** Prompt for confirmation before operations */
-    interactive?: boolean;
-    /** Check if branch is merged before allowing cleanup (defaults to true when deleteBranch is true) */
-    checkMergeSafety?: boolean;
-    /** Check if branch exists on remote before allowing cleanup (useful for GitHub-PR mode) */
-    checkRemoteBranch?: boolean;
-    /** Pre-resolved worktree to clean up (skips the search step) */
-    worktree?: {
-        path: string;
-        branch: string;
-    };
+    /** Show what would be done without actually doing it */
+    dryRun?: boolean;
+    /** Output result as JSON */
+    json?: boolean;
+    /** Wait specified milliseconds before cleanup execution */
+    defer?: number;
     /** Archive metadata instead of deleting (preserves loom in il list --finished) */
     archive?: boolean;
 }
-/**
- * Result of a cleanup operation
- */
-interface CleanupResult {
-    /** Identifier that was cleaned up */
-    identifier: string;
-    /** Actual branch name that was found (will differ from identifier) */
-    branchName?: string;
-    /** Overall success status */
+interface ListOptions {
+    json?: boolean;
+}
+interface AddIssueResult {
+    url: string;
+    id: number;
+    title: string;
+    created_at: string;
+}
+interface EnhanceResult {
+    url: string;
+    id: number;
+    title: string;
+    created_at: string;
+    enhanced: boolean;
+}
+interface StartResult {
+    id: string;
+    path: string;
+    branch: string;
+    port?: number;
+    type: 'issue' | 'pr' | 'branch' | 'epic';
+    identifier: string | number;
+    title?: string;
+    capabilities?: string[];
+    childIssueNumbers?: string[];
+}
+interface FinishResult {
     success: boolean;
+    type: 'issue' | 'pr' | 'branch' | 'epic';
+    identifier: string | number;
     /** Whether this was a dry-run operation */
     dryRun?: boolean;
-    /** Individual operation results */
-    operations: OperationResult[];
-    /** Errors encountered during cleanup */
-    errors: Error[];
-    /** Whether rollback is required */
-    rollbackRequired?: boolean;
+    operations: Array<{
+        type: 'validation' | 'commit' | 'rebase' | 'merge' | 'cleanup' | 'pr-creation' | 'pr-ready' | 'build';
+        message: string;
+        success: boolean;
+        error?: string;
+    }>;
+    prUrl?: string;
+    cleanupResult?: CleanupResult;
 }
-/**
- * Result of an individual cleanup operation
- */
-interface OperationResult {
-    /** Type of operation performed */
-    type: 'dev-server' | 'worktree' | 'branch' | 'database' | 'cli-symlinks' | 'recap' | 'metadata' | 'trust';
-    /** Whether operation succeeded */
+interface SummaryResult {
+    summary: string;
+    sessionId: string;
+    issueNumber?: string | number;
+    branchName: string;
+    loomType: 'issue' | 'pr' | 'branch' | 'epic';
+}
+interface RebaseResult {
     success: boolean;
-    /** Human-readable message */
-    message: string;
-    /** Error message if operation failed */
+    conflictsDetected: boolean;
+    claudeLaunched: boolean;
+    conflictsResolved?: boolean;
     error?: string;
-    /** For database operations: whether branch was actually deleted (vs not found) */
-    deleted?: boolean;
 }
-/**
- * Safety check result
- */
-interface SafetyCheck {
-    /** Whether cleanup is safe to proceed */
-    isSafe: boolean;
-    /** Non-blocking warnings */
-    warnings: string[];
-    /** Blocking issues that prevent cleanup */
-    blockers: string[];
+interface RebaseOutcome {
+    conflictsDetected: boolean;
+    claudeLaunched: boolean;
+    conflictsResolved: boolean;
 }
-/**
- * Options for branch deletion
- */
-interface BranchDeleteOptions {
-    /** Force delete unmerged branch */
-    force?: boolean;
-    /** Also delete remote branch */
-    remote?: boolean;
-    /** Preview without executing */
-    dryRun?: boolean;
-    /** Path to the worktree being cleaned up (for merge target resolution) - DEPRECATED: use mergeTargetBranch instead */
-    worktreePath?: string;
-    /** Pre-fetched merge target branch (parent branch for child looms, main branch for others).
-     * This must be fetched BEFORE worktree deletion since metadata won't be readable after deletion. */
-    mergeTargetBranch?: string;
-    /** Safety check has verified no data loss risk. When true, allows force delete
-     * if git branch -d fails with "not fully merged" since safety is already confirmed. */
-    safetyVerified?: boolean;
+interface MockOptions {
+    scenario: 'empty' | 'existing' | 'conflicts' | 'error';
+    data?: unknown;
 }
-/**
- * Target for batch cleanup - represents a branch that may or may not have a worktree
- */
-interface BranchCleanupTarget {
-    /** Branch name */
-    branchName: string;
-    /** Whether this branch has an associated worktree */
-    hasWorktree: boolean;
-    /** Path to worktree if it exists */
-    worktreePath?: string;
+
+interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
 }
-/**
- * Result of batch cleanup operation for an issue
- */
-interface BatchCleanupResult {
-    /** Issue number that was cleaned up */
-    issueNumber: string | number;
-    /** Number of branches found matching the issue */
-    targetsFound: number;
-    /** Number of worktrees successfully removed */
-    worktreesRemoved: number;
-    /** Number of branches successfully deleted */
-    branchesDeleted: number;
-    /** Number of failed operations */
-    failed: number;
-    /** Individual cleanup results for each branch */
-    results: CleanupResult[];
+interface ColorData {
+    rgb: RgbColor;
+    hex: string;
+    index: number;
 }
-
-/**
- * Strategy interface for generating branch names from issue information
- */
-interface BranchNameStrategy {
-    generate(issueNumber: string | number, title: string): Promise<string>;
+type Platform = 'darwin' | 'linux' | 'win32' | 'unsupported';
+interface ValidationOptions {
+    dryRun?: boolean;
+    skipTypecheck?: boolean;
+    skipLint?: boolean;
+    skipTests?: boolean;
+    jsonStream?: boolean;
 }
-/**
- * Options for branch name generation
- * Supports both simple generation and custom strategy override
- */
-interface BranchGenerationOptions {
-    issueNumber: string | number;
-    title: string;
-    strategy?: BranchNameStrategy;
+interface ValidationStepResult {
+    step: 'typecheck' | 'compile' | 'lint' | 'test';
+    passed: boolean;
+    skipped: boolean;
+    output?: string;
+    error?: string;
+    duration?: number;
 }
-
-interface EnvVariable {
-    key: string;
-    value: string;
+interface ValidationResult {
+    success: boolean;
+    steps: ValidationStepResult[];
+    totalDuration: number;
 }
-interface EnvFileOptions {
-    path: string;
-    backup?: boolean;
-    encoding?: BufferEncoding;
+interface CommitOptions {
+    dryRun?: boolean;
+    issueNumber?: string | number;
+    issuePrefix: string;
+    message?: string;
+    noReview?: boolean;
+    skipVerify?: boolean;
+    skipVerifySilent?: boolean;
+    trailerType?: 'Refs' | 'Fixes';
+    timeout?: number;
 }
 /**
- * @deprecated Use exception-based error handling instead
+ * Error thrown when user aborts a commit operation
+ * Used by CommitManager when user selects 'abort' at the commit prompt
  */
-interface EnvOperationResult {
-    success: boolean;
-    backupPath?: string;
-    error?: string;
+declare class UserAbortedCommitError extends Error {
+    constructor(message?: string);
 }
-interface PortAssignmentOptions {
-    basePort?: number;
-    issueNumber?: string | number;
-    prNumber?: number;
-    branchName?: string;
+interface MergeOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    repoRoot?: string;
+    jsonStream?: boolean;
 }
-
-type ProjectCapability = 'cli' | 'web';
-type Capability = ProjectCapability;
-interface Loom {
-    id: string;
-    path: string;
-    branch: string;
-    type: 'issue' | 'pr' | 'branch' | 'epic';
-    identifier: string | number;
-    port: number;
-    databaseBranch?: string;
-    description?: string;
-    createdAt: Date;
-    lastAccessed: Date;
-    issueData?: {
-        title?: string;
-        body?: string;
-        url?: string;
-        state?: string;
-    };
-    capabilities?: ProjectCapability[];
-    binEntries?: Record<string, string>;
-    cliSymlinks?: string[];
+interface MergeResult {
+    success: boolean;
+    branchName: string;
+    commitsMerged: number;
+    rebaseCompleted: boolean;
+    mergeCompleted: boolean;
 }
-interface CreateLoomInput {
-    type: 'issue' | 'pr' | 'branch' | 'epic';
-    identifier: string | number;
-    originalInput: string;
-    baseBranch?: string;
-    parentLoom?: {
-        type: 'issue' | 'pr' | 'branch' | 'epic';
-        identifier: string | number;
-        branchName: string;
-        worktreePath: string;
-        databaseBranch?: string;
-    };
-    options?: {
-        skipDatabase?: boolean;
-        colorTerminal?: boolean;
-        colorVscode?: boolean;
-        enableClaude?: boolean;
-        enableCode?: boolean;
-        enableDevServer?: boolean;
-        enableTerminal?: boolean;
-        oneShot?: OneShotMode;
-        dangerouslySkipPermissions?: boolean;
-        complexity?: ComplexityOverride;
-        setArguments?: string[];
-        executablePath?: string;
-        sourceEnvOnStart?: boolean;
-        childIssueNumbers?: string[];
-        childIssues?: Array<{
-            number: string;
-            title: string;
-            body: string;
-            url: string;
-        }>;
-        dependencyMap?: Record<string, string[]>;
+interface UpdateCheckCache {
+    lastCheck: number;
+    latestVersion: string;
+}
+interface UpdateCheckResult {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+}
+type InstallationMethod = 'global' | 'local' | 'linked' | 'unknown';
+
+declare const VALID_CLAUDE_MODELS: readonly ["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"];
+type ClaudeModel = (typeof VALID_CLAUDE_MODELS)[number];
+/**
+ * Zod schema for iloom settings
+ */
+declare const IloomSettingsSchema: z.ZodObject<{
+    mainBranch: z.ZodOptional<z.ZodString>;
+    sourceEnvOnStart: z.ZodDefault<z.ZodBoolean>;
+    worktreePrefix: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+    protectedBranches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    copyGitIgnoredPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    workflows: z.ZodOptional<z.ZodObject<{
+        issue: z.ZodOptional<z.ZodObject<{
+            permissionMode: z.ZodOptional<z.ZodEnum<["plan", "acceptEdits", "bypassPermissions", "default"]>>;
+            noVerify: z.ZodOptional<z.ZodBoolean>;
+            startIde: z.ZodDefault<z.ZodBoolean>;
+            startDevServer: z.ZodDefault<z.ZodBoolean>;
+            startAiAgent: z.ZodDefault<z.ZodBoolean>;
+            startTerminal: z.ZodDefault<z.ZodBoolean>;
+            generateSummary: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        }, {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        }>>;
+        pr: z.ZodOptional<z.ZodObject<{
+            permissionMode: z.ZodOptional<z.ZodEnum<["plan", "acceptEdits", "bypassPermissions", "default"]>>;
+            noVerify: z.ZodOptional<z.ZodBoolean>;
+            startIde: z.ZodDefault<z.ZodBoolean>;
+            startDevServer: z.ZodDefault<z.ZodBoolean>;
+            startAiAgent: z.ZodDefault<z.ZodBoolean>;
+            startTerminal: z.ZodDefault<z.ZodBoolean>;
+            generateSummary: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        }, {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        }>>;
+        regular: z.ZodOptional<z.ZodObject<{
+            permissionMode: z.ZodOptional<z.ZodEnum<["plan", "acceptEdits", "bypassPermissions", "default"]>>;
+            noVerify: z.ZodOptional<z.ZodBoolean>;
+            startIde: z.ZodDefault<z.ZodBoolean>;
+            startDevServer: z.ZodDefault<z.ZodBoolean>;
+            startAiAgent: z.ZodDefault<z.ZodBoolean>;
+            startTerminal: z.ZodDefault<z.ZodBoolean>;
+            generateSummary: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        }, {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        issue?: {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        } | undefined;
+        pr?: {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        } | undefined;
+        regular?: {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        } | undefined;
+    }, {
+        issue?: {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        } | undefined;
+        pr?: {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        } | undefined;
+        regular?: {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        } | undefined;
+    }>>;
+    agents: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
+        swarmModel: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
+        effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+        swarmEffort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["claude", "gemini", "codex"]>, z.ZodString>>;
+        review: z.ZodOptional<z.ZodBoolean>;
+        swarmReview: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+        enabled?: boolean | undefined;
+        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
+        swarmReview?: boolean | undefined;
+    }, {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+        enabled?: boolean | undefined;
+        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
+        swarmReview?: boolean | undefined;
+    }>>>>;
+    spin: z.ZodOptional<z.ZodObject<{
+        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
+        swarmModel: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
+        effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+        swarmEffort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+        postSwarmReview: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
+        postSwarmReview: boolean;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+    }, {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+        postSwarmReview?: boolean | undefined;
+    }>>;
+    plan: z.ZodOptional<z.ZodObject<{
+        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
+        effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+        planner: z.ZodDefault<z.ZodEnum<["claude", "gemini", "codex"]>>;
+        reviewer: z.ZodDefault<z.ZodEnum<["claude", "gemini", "codex", "none"]>>;
+        waveVerification: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
+        planner: "claude" | "gemini" | "codex";
+        reviewer: "claude" | "gemini" | "codex" | "none";
+        waveVerification: boolean;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+    }, {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        planner?: "claude" | "gemini" | "codex" | undefined;
+        reviewer?: "claude" | "gemini" | "codex" | "none" | undefined;
+        waveVerification?: boolean | undefined;
+    }>>;
+    summary: z.ZodOptional<z.ZodObject<{
+        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku", "sonnet[1m]", "opus[1m]"]>>;
+    }, "strip", z.ZodTypeAny, {
+        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
+    }, {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+    }>>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+        web: z.ZodOptional<z.ZodObject<{
+            basePort: z.ZodOptional<z.ZodNumber>;
+            protocol: z.ZodDefault<z.ZodEnum<["http", "https"]>>;
+            devServer: z.ZodDefault<z.ZodEnum<["process", "docker"]>>;
+            dockerFile: z.ZodDefault<z.ZodString>;
+            containerPort: z.ZodOptional<z.ZodNumber>;
+            dockerBuildArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            dockerBuildSecrets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            dockerRunArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            dockerRunEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            protocol: "http" | "https";
+            devServer: "docker" | "process";
+            dockerFile: string;
+            basePort?: number | undefined;
+            containerPort?: number | undefined;
+            dockerBuildArgs?: Record<string, string> | undefined;
+            dockerBuildSecrets?: Record<string, string> | undefined;
+            dockerRunArgs?: string[] | undefined;
+            dockerRunEnv?: Record<string, string> | undefined;
+        }, {
+            basePort?: number | undefined;
+            protocol?: "http" | "https" | undefined;
+            devServer?: "docker" | "process" | undefined;
+            dockerFile?: string | undefined;
+            containerPort?: number | undefined;
+            dockerBuildArgs?: Record<string, string> | undefined;
+            dockerBuildSecrets?: Record<string, string> | undefined;
+            dockerRunArgs?: string[] | undefined;
+            dockerRunEnv?: Record<string, string> | undefined;
+        }>>;
+        database: z.ZodOptional<z.ZodObject<{
+            databaseUrlEnvVarName: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            databaseUrlEnvVarName: string;
+        }, {
+            databaseUrlEnvVarName?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        web?: {
+            protocol: "http" | "https";
+            devServer: "docker" | "process";
+            dockerFile: string;
+            basePort?: number | undefined;
+            containerPort?: number | undefined;
+            dockerBuildArgs?: Record<string, string> | undefined;
+            dockerBuildSecrets?: Record<string, string> | undefined;
+            dockerRunArgs?: string[] | undefined;
+            dockerRunEnv?: Record<string, string> | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName: string;
+        } | undefined;
+    }, {
+        web?: {
+            basePort?: number | undefined;
+            protocol?: "http" | "https" | undefined;
+            devServer?: "docker" | "process" | undefined;
+            dockerFile?: string | undefined;
+            containerPort?: number | undefined;
+            dockerBuildArgs?: Record<string, string> | undefined;
+            dockerBuildSecrets?: Record<string, string> | undefined;
+            dockerRunArgs?: string[] | undefined;
+            dockerRunEnv?: Record<string, string> | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName?: string | undefined;
+        } | undefined;
+    }>>;
+    devServer: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<["docker"]>>;
+        docker: z.ZodOptional<z.ZodObject<{
+            dockerFile: z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>;
+            containerPort: z.ZodOptional<z.ZodNumber>;
+            buildArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            runArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            runEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            dockerFile: string;
+            containerPort?: number | undefined;
+            buildArgs?: Record<string, string> | undefined;
+            runArgs?: string[] | undefined;
+            runEnv?: Record<string, string> | undefined;
+        }, {
+            dockerFile?: string | undefined;
+            containerPort?: number | undefined;
+            buildArgs?: Record<string, string> | undefined;
+            runArgs?: string[] | undefined;
+            runEnv?: Record<string, string> | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "docker";
+        docker?: {
+            dockerFile: string;
+            containerPort?: number | undefined;
+            buildArgs?: Record<string, string> | undefined;
+            runArgs?: string[] | undefined;
+            runEnv?: Record<string, string> | undefined;
+        } | undefined;
+    }, {
+        docker?: {
+            dockerFile?: string | undefined;
+            containerPort?: number | undefined;
+            buildArgs?: Record<string, string> | undefined;
+            runArgs?: string[] | undefined;
+            runEnv?: Record<string, string> | undefined;
+        } | undefined;
+        mode?: "docker" | undefined;
+    }>>;
+    databaseProviders: z.ZodOptional<z.ZodObject<{
+        neon: z.ZodOptional<z.ZodObject<{
+            projectId: z.ZodString;
+            parentBranch: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            projectId: string;
+            parentBranch: string;
+        }, {
+            projectId: string;
+            parentBranch: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    }, {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    }>>;
+    issueManagement: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<["github", "linear", "jira"]>>>;
+        github: z.ZodOptional<z.ZodObject<{
+            remote: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            remote: string;
+        }, {
+            remote: string;
+        }>>;
+        linear: z.ZodOptional<z.ZodObject<{
+            teamId: z.ZodString;
+            branchFormat: z.ZodOptional<z.ZodString>;
+            apiToken: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        }, {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        }>>;
+        jira: z.ZodOptional<z.ZodObject<{
+            host: z.ZodString;
+            username: z.ZodString;
+            apiToken: z.ZodOptional<z.ZodString>;
+            projectKey: z.ZodString;
+            boardId: z.ZodOptional<z.ZodString>;
+            transitionMappings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            defaultIssueType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            defaultSubtaskType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            doneStatuses: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        }, "strip", z.ZodTypeAny, {
+            host: string;
+            username: string;
+            projectKey: string;
+            defaultIssueType: string;
+            defaultSubtaskType: string;
+            doneStatuses: string[];
+            apiToken?: string | undefined;
+            boardId?: string | undefined;
+            transitionMappings?: Record<string, string> | undefined;
+        }, {
+            host: string;
+            username: string;
+            projectKey: string;
+            apiToken?: string | undefined;
+            boardId?: string | undefined;
+            transitionMappings?: Record<string, string> | undefined;
+            defaultIssueType?: string | undefined;
+            defaultSubtaskType?: string | undefined;
+            doneStatuses?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "github" | "linear" | "jira";
+        github?: {
+            remote: string;
+        } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
+        jira?: {
+            host: string;
+            username: string;
+            projectKey: string;
+            defaultIssueType: string;
+            defaultSubtaskType: string;
+            doneStatuses: string[];
+            apiToken?: string | undefined;
+            boardId?: string | undefined;
+            transitionMappings?: Record<string, string> | undefined;
+        } | undefined;
+    }, {
+        github?: {
+            remote: string;
+        } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
+        jira?: {
+            host: string;
+            username: string;
+            projectKey: string;
+            apiToken?: string | undefined;
+            boardId?: string | undefined;
+            transitionMappings?: Record<string, string> | undefined;
+            defaultIssueType?: string | undefined;
+            defaultSubtaskType?: string | undefined;
+            doneStatuses?: string[] | undefined;
+        } | undefined;
+        provider?: "github" | "linear" | "jira" | undefined;
+    }>>;
+    versionControl: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<["github", "bitbucket"]>>>;
+        bitbucket: z.ZodOptional<z.ZodObject<{
+            username: z.ZodString;
+            apiToken: z.ZodOptional<z.ZodString>;
+            workspace: z.ZodOptional<z.ZodString>;
+            repoSlug: z.ZodOptional<z.ZodString>;
+            reviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            username: string;
+            apiToken?: string | undefined;
+            workspace?: string | undefined;
+            repoSlug?: string | undefined;
+            reviewers?: string[] | undefined;
+        }, {
+            username: string;
+            apiToken?: string | undefined;
+            workspace?: string | undefined;
+            repoSlug?: string | undefined;
+            reviewers?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "github" | "bitbucket";
+        bitbucket?: {
+            username: string;
+            apiToken?: string | undefined;
+            workspace?: string | undefined;
+            repoSlug?: string | undefined;
+            reviewers?: string[] | undefined;
+        } | undefined;
+    }, {
+        provider?: "github" | "bitbucket" | undefined;
+        bitbucket?: {
+            username: string;
+            apiToken?: string | undefined;
+            workspace?: string | undefined;
+            repoSlug?: string | undefined;
+            reviewers?: string[] | undefined;
+        } | undefined;
+    }>>;
+    mergeBehavior: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEffects<z.ZodDefault<z.ZodEnum<["local", "pr", "draft-pr", "github-pr", "github-draft-pr", "bitbucket-pr"]>>, "pr" | "local" | "draft-pr", "pr" | "local" | "draft-pr" | "github-pr" | "github-draft-pr" | "bitbucket-pr" | undefined>;
+        remote: z.ZodOptional<z.ZodString>;
+        autoCommitPush: z.ZodOptional<z.ZodBoolean>;
+        prTitlePrefix: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        openBrowserOnFinish: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "pr" | "local" | "draft-pr";
+        openBrowserOnFinish: boolean;
+        remote?: string | undefined;
+        autoCommitPush?: boolean | undefined;
+        prTitlePrefix?: boolean | undefined;
+    }, {
+        mode?: "pr" | "local" | "draft-pr" | "github-pr" | "github-draft-pr" | "bitbucket-pr" | undefined;
+        remote?: string | undefined;
+        autoCommitPush?: boolean | undefined;
+        prTitlePrefix?: boolean | undefined;
+        openBrowserOnFinish?: boolean | undefined;
+    }>>;
+    ide: z.ZodOptional<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<["vscode", "cursor", "webstorm", "sublime", "intellij", "windsurf", "antigravity"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity";
+    }, {
+        type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity" | undefined;
+    }>>;
+    colors: z.ZodOptional<z.ZodObject<{
+        terminal: z.ZodDefault<z.ZodBoolean>;
+        vscode: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        terminal: boolean;
+        vscode: boolean;
+    }, {
+        terminal?: boolean | undefined;
+        vscode?: boolean | undefined;
+    }>>;
+    attribution: z.ZodDefault<z.ZodEnum<["off", "upstreamOnly", "on"]>>;
+    git: z.ZodDefault<z.ZodObject<{
+        commitTimeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        commitTimeout: number;
+    }, {
+        commitTimeout?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    sourceEnvOnStart: boolean;
+    attribution: "off" | "upstreamOnly" | "on";
+    git: {
+        commitTimeout: number;
     };
-}
-type LaunchMode = 'editor' | 'terminal' | 'both';
-interface LoomSummary {
-    id: string;
-    type: 'issue' | 'pr' | 'branch' | 'epic';
-    identifier: string | number;
-    title?: string;
-    branch: string;
-    port: number;
-    status: 'active' | 'stale' | 'error';
-    lastAccessed: string;
-}
-
-/**
- * Information about a running process
- */
-interface ProcessInfo {
-    /** Process ID */
-    pid: number;
-    /** Process name (e.g., "node", "pnpm") */
-    name: string;
-    /** Full command line */
-    command: string;
-    /** Port the process is listening on */
-    port: number;
-    /** Whether this appears to be a dev server */
-    isDevServer: boolean;
-}
-
-interface TelemetryConfig {
-    enabled: boolean;
-    disclosed_at?: string;
-    last_version?: string;
-}
-interface CliInstalledProperties {
-    version: string;
-    os: string;
-    node_version: string;
-}
-interface CliUpgradedProperties {
-    version: string;
-    previous_version: string;
-    os: string;
-}
-interface LoomCreatedProperties {
-    source_type: 'issue' | 'pr' | 'branch' | 'freeform';
-    tracker: string;
-    is_child_loom: boolean;
-    one_shot_mode: 'default' | 'skip-reviews' | 'yolo';
-    complexity_override: boolean;
-    create_only: boolean;
-}
-interface LoomFinishedProperties {
-    merge_behavior: 'local' | 'pr' | 'draft-pr';
-    duration_minutes: number;
-}
-interface LoomAbandonedProperties {
-    duration_minutes: number;
-    phase_reached: string;
-}
-interface EpicPlannedProperties {
-    child_count: number;
-    tracker: string;
-}
-interface SwarmStartedProperties {
-    child_count: number;
-    tracker: string;
-}
-interface SwarmChildCompletedProperties {
-    success: boolean;
-    duration_minutes: number;
-}
-interface SwarmCompletedProperties {
-    total_children: number;
-    succeeded: number;
-    failed: number;
-    duration_minutes: number;
-}
-interface DemoStartedProperties {
-    path: string;
-}
-interface DemoCompletedProperties {
-    path: string;
-    converted_to_real_project: boolean;
-}
-interface ContributeStartedProperties {
-    tracker: string;
-}
-interface SessionStartedProperties {
-    has_neon: boolean;
-    language: string;
-}
-interface ErrorOccurredProperties {
-    error_type: string;
-    command: string;
-    phase: string;
-}
-interface InitStartedProperties {
-    mode: 'accept-defaults' | 'guided' | 'guided-custom-prompt';
-}
-interface InitCompletedProperties {
-    mode: 'accept-defaults' | 'guided' | 'guided-custom-prompt';
-}
-interface AutoSwarmStartedProperties {
-    source: 'decomposition' | 'fresh';
-    planner: string;
-}
-interface AutoSwarmCompletedProperties {
-    source: 'decomposition' | 'fresh';
-    success: boolean;
-    child_count: number;
-    duration_minutes: number;
-    phase_reached: 'plan' | 'start' | 'spin';
-    fallback_to_normal: boolean;
-}
-interface EpicReportGeneratedProperties {
-    total_children: number;
-    succeeded: number;
-    failed: number;
-}
-interface DevServerStartedEvent {
-    /** Execution mode for the dev server */
-    mode: 'docker' | 'process';
-    /** Whether the dev server started successfully */
-    success: boolean;
-    /**
-     * Time in milliseconds to build the Docker image.
-     * Only present when mode is 'docker'.
-     */
-    buildDurationMs?: number;
-    /** Time in milliseconds from start to the server being ready */
-    startDurationMs: number;
-    /**
-     * Number of BuildKit secrets mounted during docker build.
-     * Only present when mode is 'docker' and secrets are configured.
-     * Tracks feature adoption without exposing secret IDs or paths.
-     */
-    docker_build_secrets_count?: number;
-}
-interface DevServerStoppedEvent {
-    /** Execution mode for the dev server */
-    mode: 'docker' | 'process';
-    /** Reason the dev server stopped */
-    reason: 'user' | 'cleanup' | 'error';
-}
-interface TelemetryEventMap {
-    'cli.installed': CliInstalledProperties;
-    'cli.upgraded': CliUpgradedProperties;
-    'loom.created': LoomCreatedProperties;
-    'loom.finished': LoomFinishedProperties;
-    'loom.abandoned': LoomAbandonedProperties;
-    'epic.planned': EpicPlannedProperties;
-    'swarm.started': SwarmStartedProperties;
-    'swarm.child_completed': SwarmChildCompletedProperties;
-    'swarm.completed': SwarmCompletedProperties;
-    'demo.started': DemoStartedProperties;
-    'demo.completed': DemoCompletedProperties;
-    'contribute.started': ContributeStartedProperties;
-    'session.started': SessionStartedProperties;
-    'error.occurred': ErrorOccurredProperties;
-    'init.started': InitStartedProperties;
-    'init.completed': InitCompletedProperties;
-    'auto_swarm.started': AutoSwarmStartedProperties;
-    'auto_swarm.completed': AutoSwarmCompletedProperties;
-    'epic.report_generated': EpicReportGeneratedProperties;
-    'devServer.started': DevServerStartedEvent;
-    'devServer.stopped': DevServerStoppedEvent;
-}
-type TelemetryEventName = keyof TelemetryEventMap;
-
-interface Workspace {
-    id: string;
-    path: string;
-    branch: string;
-    issueNumber?: string | number;
-    prNumber?: number;
-    port: number;
-    databaseBranch?: string;
-    createdAt: Date;
-    lastAccessed: Date;
-}
-interface WorkspaceInput {
-    identifier: string;
-    type: 'issue' | 'pr' | 'branch';
-    skipClaude?: boolean;
-}
-interface WorkspaceSummary {
-    id: string;
-    issueNumber?: string | number;
-    prNumber?: number;
-    title: string;
-    branch: string;
-    port: number;
-    status: 'active' | 'stale' | 'error';
-    lastAccessed: string;
-}
-interface Worktree {
-    path: string;
-    branch: string;
-    commit: string;
-    isPR: boolean;
-    prNumber?: number;
-    issueNumber?: string | number;
-    port?: number;
-}
-interface GitStatus {
-    hasUncommittedChanges: boolean;
-    unstagedFiles: string[];
-    stagedFiles: string[];
-    currentBranch: string;
-    isAheadOfRemote: boolean;
-    isBehindRemote: boolean;
-}
-interface Issue {
-    number: string | number;
-    title: string;
-    body: string;
-    state: 'open' | 'closed';
-    labels: string[];
-    assignees: string[];
-    url: string;
-}
-interface PullRequest {
-    number: number;
-    title: string;
-    body: string;
-    state: 'open' | 'closed' | 'merged';
-    branch: string;
-    baseBranch: string;
-    url: string;
-    isDraft: boolean;
-    isFork?: boolean;
-}
-/**
- * Generic input detection result for issue trackers
- * String-based identifier to support non-numeric IDs (e.g., Linear "ENG-123")
- */
-interface IssueTrackerInputDetection {
-    type: 'issue' | 'pr' | 'unknown';
-    identifier: string | null;
-    rawInput: string;
-}
-
+    plan?: {
+        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
+        planner: "claude" | "gemini" | "codex";
+        reviewer: "claude" | "gemini" | "codex" | "none";
+        waveVerification: boolean;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+    } | undefined;
+    spin?: {
+        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
+        postSwarmReview: boolean;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+    } | undefined;
+    devServer?: {
+        mode: "docker";
+        docker?: {
+            dockerFile: string;
+            containerPort?: number | undefined;
+            buildArgs?: Record<string, string> | undefined;
+            runArgs?: string[] | undefined;
+            runEnv?: Record<string, string> | undefined;
+        } | undefined;
+    } | undefined;
+    mainBranch?: string | undefined;
+    worktreePrefix?: string | undefined;
+    protectedBranches?: string[] | undefined;
+    copyGitIgnoredPatterns?: string[] | undefined;
+    workflows?: {
+        issue?: {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        } | undefined;
+        pr?: {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        } | undefined;
+        regular?: {
+            startIde: boolean;
+            startDevServer: boolean;
+            startAiAgent: boolean;
+            startTerminal: boolean;
+            generateSummary: boolean;
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    agents?: Record<string, {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+        enabled?: boolean | undefined;
+        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
+        swarmReview?: boolean | undefined;
+    }> | null | undefined;
+    summary?: {
+        model: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]";
+    } | undefined;
+    capabilities?: {
+        web?: {
+            protocol: "http" | "https";
+            devServer: "docker" | "process";
+            dockerFile: string;
+            basePort?: number | undefined;
+            containerPort?: number | undefined;
+            dockerBuildArgs?: Record<string, string> | undefined;
+            dockerBuildSecrets?: Record<string, string> | undefined;
+            dockerRunArgs?: string[] | undefined;
+            dockerRunEnv?: Record<string, string> | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName: string;
+        } | undefined;
+    } | undefined;
+    databaseProviders?: {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    } | undefined;
+    issueManagement?: {
+        provider: "github" | "linear" | "jira";
+        github?: {
+            remote: string;
+        } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
+        jira?: {
+            host: string;
+            username: string;
+            projectKey: string;
+            defaultIssueType: string;
+            defaultSubtaskType: string;
+            doneStatuses: string[];
+            apiToken?: string | undefined;
+            boardId?: string | undefined;
+            transitionMappings?: Record<string, string> | undefined;
+        } | undefined;
+    } | undefined;
+    versionControl?: {
+        provider: "github" | "bitbucket";
+        bitbucket?: {
+            username: string;
+            apiToken?: string | undefined;
+            workspace?: string | undefined;
+            repoSlug?: string | undefined;
+            reviewers?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    mergeBehavior?: {
+        mode: "pr" | "local" | "draft-pr";
+        openBrowserOnFinish: boolean;
+        remote?: string | undefined;
+        autoCommitPush?: boolean | undefined;
+        prTitlePrefix?: boolean | undefined;
+    } | undefined;
+    ide?: {
+        type: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity";
+    } | undefined;
+    colors?: {
+        terminal: boolean;
+        vscode: boolean;
+    } | undefined;
+}, {
+    plan?: {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        planner?: "claude" | "gemini" | "codex" | undefined;
+        reviewer?: "claude" | "gemini" | "codex" | "none" | undefined;
+        waveVerification?: boolean | undefined;
+    } | undefined;
+    spin?: {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+        postSwarmReview?: boolean | undefined;
+    } | undefined;
+    devServer?: {
+        docker?: {
+            dockerFile?: string | undefined;
+            containerPort?: number | undefined;
+            buildArgs?: Record<string, string> | undefined;
+            runArgs?: string[] | undefined;
+            runEnv?: Record<string, string> | undefined;
+        } | undefined;
+        mode?: "docker" | undefined;
+    } | undefined;
+    mainBranch?: string | undefined;
+    sourceEnvOnStart?: boolean | undefined;
+    worktreePrefix?: string | undefined;
+    protectedBranches?: string[] | undefined;
+    copyGitIgnoredPatterns?: string[] | undefined;
+    workflows?: {
+        issue?: {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        } | undefined;
+        pr?: {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        } | undefined;
+        regular?: {
+            permissionMode?: "default" | "bypassPermissions" | "plan" | "acceptEdits" | undefined;
+            noVerify?: boolean | undefined;
+            startIde?: boolean | undefined;
+            startDevServer?: boolean | undefined;
+            startAiAgent?: boolean | undefined;
+            startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    agents?: Record<string, {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        swarmModel?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+        effort?: "low" | "medium" | "high" | "max" | undefined;
+        swarmEffort?: "low" | "medium" | "high" | "max" | undefined;
+        enabled?: boolean | undefined;
+        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
+        swarmReview?: boolean | undefined;
+    }> | null | undefined;
+    summary?: {
+        model?: "sonnet" | "opus" | "haiku" | "sonnet[1m]" | "opus[1m]" | undefined;
+    } | undefined;
+    capabilities?: {
+        web?: {
+            basePort?: number | undefined;
+            protocol?: "http" | "https" | undefined;
+            devServer?: "docker" | "process" | undefined;
+            dockerFile?: string | undefined;
+            containerPort?: number | undefined;
+            dockerBuildArgs?: Record<string, string> | undefined;
+            dockerBuildSecrets?: Record<string, string> | undefined;
+            dockerRunArgs?: string[] | undefined;
+            dockerRunEnv?: Record<string, string> | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName?: string | undefined;
+        } | undefined;
+    } | undefined;
+    databaseProviders?: {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    } | undefined;
+    issueManagement?: {
+        github?: {
+            remote: string;
+        } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
+        jira?: {
+            host: string;
+            username: string;
+            projectKey: string;
+            apiToken?: string | undefined;
+            boardId?: string | undefined;
+            transitionMappings?: Record<string, string> | undefined;
+            defaultIssueType?: string | undefined;
+            defaultSubtaskType?: string | undefined;
+            doneStatuses?: string[] | undefined;
+        } | undefined;
+        provider?: "github" | "linear" | "jira" | undefined;
+    } | undefined;
+    versionControl?: {
+        provider?: "github" | "bitbucket" | undefined;
+        bitbucket?: {
+            username: string;
+            apiToken?: string | undefined;
+            workspace?: string | undefined;
+            repoSlug?: string | undefined;
+            reviewers?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    mergeBehavior?: {
+        mode?: "pr" | "local" | "draft-pr" | "github-pr" | "github-draft-pr" | "bitbucket-pr" | undefined;
+        remote?: string | undefined;
+        autoCommitPush?: boolean | undefined;
+        prTitlePrefix?: boolean | undefined;
+        openBrowserOnFinish?: boolean | undefined;
+    } | undefined;
+    ide?: {
+        type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity" | undefined;
+    } | undefined;
+    colors?: {
+        terminal?: boolean | undefined;
+        vscode?: boolean | undefined;
+    } | undefined;
+    attribution?: "off" | "upstreamOnly" | "on" | undefined;
+    git?: {
+        commitTimeout?: number | undefined;
+    } | undefined;
+}>;
 /**
- * Result of database branch deletion operation
- * Distinguishes between successful deletion, branch not found, and errors
+ * TypeScript type for iloom settings derived from Zod schema
  */
-interface DatabaseDeletionResult {
-    /** Overall operation succeeded (true even if branch didn't exist) */
-    success: boolean;
-    /** True only if a branch was actually deleted */
-    deleted: boolean;
-    /** True if branch didn't exist (not an error, just nothing to do) */
-    notFound: boolean;
-    /** Error message if operation failed */
-    error?: string;
-    /** User declined deletion (for preview databases) */
-    userDeclined?: boolean;
-    /** Name of the branch that was processed */
-    branchName?: string;
-}
-interface DatabaseProvider {
-    createBranch(name: string, fromBranch?: string, cwd?: string): Promise<string>;
-    deleteBranch(name: string, isPreview?: boolean, cwd?: string): Promise<DatabaseDeletionResult>;
-    getConnectionString(branch: string, cwd?: string): Promise<string>;
-    listBranches(cwd?: string): Promise<string[]>;
-    branchExists(name: string, cwd?: string): Promise<boolean>;
-    findPreviewBranch(branchName: string, cwd?: string): Promise<string | null>;
-    getBranchNameFromEndpoint(endpointId: string, cwd?: string): Promise<string | null>;
-    sanitizeBranchName(branchName: string): string;
-    isAuthenticated(cwd?: string): Promise<boolean>;
-    isCliAvailable(): Promise<boolean>;
-    isConfigured(): boolean;
-}
-interface Config {
-    defaultPort: number;
-    databaseProvider?: 'neon' | 'supabase' | 'planetscale';
-    claudeModel?: ClaudeModel;
-    skipClaude?: boolean;
-    customWorkspaceRoot?: string;
-}
-type OneShotMode = 'default' | 'noReview' | 'bypassPermissions';
-type ComplexityOverride = 'trivial' | 'simple' | 'complex';
-interface StartOptions {
-    claude?: boolean;
-    code?: boolean;
-    devServer?: boolean;
-    terminal?: boolean;
-    childLoom?: boolean;
-    epic?: boolean;
-    createOnly?: boolean;
-    oneShot?: OneShotMode;
-    dangerouslySkipPermissions?: boolean;
-    complexity?: ComplexityOverride;
-    body?: string;
-    json?: boolean;
-}
-interface AddIssueOptions {
-    body?: string;
-    json?: boolean;
-}
-interface FeedbackOptions {
-    body?: string;
-}
-interface EnhanceOptions {
-    noBrowser?: boolean;
-    json?: boolean;
-}
-interface FinishOptions {
-    force?: boolean;
-    dryRun?: boolean;
-    pr?: number;
-    skipBuild?: boolean;
-    noBrowser?: boolean;
-    cleanup?: boolean;
-    json?: boolean;
-    skipToPr?: boolean;
-    jsonStream?: boolean;
-    review?: boolean;
-}
+type IloomSettings = z.infer<typeof IloomSettingsSchema>;
 /**
- * Options for the cleanup command
- * All flags are optional and can be combined (subject to validation)
+ * Manages project-level settings from .iloom/settings.json
  */
-interface CleanupOptions {
-    /** List all worktrees without removing anything */
-    list?: boolean;
-    /** Remove all worktrees (interactive confirmation required unless --force) */
-    all?: boolean;
-    /** Cleanup by specific issue identifier (numeric or alphanumeric like RANDOM-13) */
-    issue?: string | number;
-    /** Skip confirmations and force removal */
-    force?: boolean;
-    /** Show what would be done without actually doing it */
-    dryRun?: boolean;
-    /** Output result as JSON */
-    json?: boolean;
-    /** Wait specified milliseconds before cleanup execution */
-    defer?: number;
-    /** Archive metadata instead of deleting (preserves loom in il list --finished) */
-    archive?: boolean;
-}
-interface ListOptions {
-    json?: boolean;
-}
-interface AddIssueResult {
-    url: string;
-    id: number;
-    title: string;
-    created_at: string;
-}
-interface EnhanceResult {
-    url: string;
-    id: number;
-    title: string;
-    created_at: string;
-    enhanced: boolean;
-}
-interface StartResult {
-    id: string;
-    path: string;
-    branch: string;
-    port?: number;
-    type: 'issue' | 'pr' | 'branch' | 'epic';
-    identifier: string | number;
-    title?: string;
-    capabilities?: string[];
-    childIssueNumbers?: string[];
-}
-interface FinishResult {
-    success: boolean;
-    type: 'issue' | 'pr' | 'branch' | 'epic';
-    identifier: string | number;
-    /** Whether this was a dry-run operation */
-    dryRun?: boolean;
-    operations: Array<{
-        type: 'validation' | 'commit' | 'rebase' | 'merge' | 'cleanup' | 'pr-creation' | 'pr-ready' | 'build';
-        message: string;
-        success: boolean;
-        error?: string;
-    }>;
-    prUrl?: string;
-    cleanupResult?: CleanupResult;
-}
-interface SummaryResult {
-    summary: string;
-    sessionId: string;
-    issueNumber?: string | number;
-    branchName: string;
-    loomType: 'issue' | 'pr' | 'branch' | 'epic';
-}
-interface RebaseResult {
-    success: boolean;
-    conflictsDetected: boolean;
-    claudeLaunched: boolean;
-    conflictsResolved?: boolean;
-    error?: string;
-}
-interface RebaseOutcome {
-    conflictsDetected: boolean;
-    claudeLaunched: boolean;
-    conflictsResolved: boolean;
-}
-interface MockOptions {
-    scenario: 'empty' | 'existing' | 'conflicts' | 'error';
-    data?: unknown;
+declare class SettingsManager {
+    /**
+     * Load settings from global, project, and local sources with proper precedence
+     * Merge hierarchy (lowest to highest priority):
+     * 1. Global settings (~/.config/iloom-ai/settings.json)
+     * 2. Project settings (<PROJECT_ROOT>/.iloom/settings.json)
+     * 3. Local settings (<PROJECT_ROOT>/.iloom/settings.local.json)
+     * 4. CLI overrides (--set flags)
+     * Returns empty object if all files don't exist (not an error)
+     */
+    loadSettings(projectRoot?: string, cliOverrides?: Partial<IloomSettings>): Promise<IloomSettings>;
+    /**
+     * Log the final merged configuration for debugging
+     */
+    private logFinalConfiguration;
+    /**
+     * Load and parse a single settings file
+     * Returns empty object if file doesn't exist (not an error)
+     * Uses non-defaulting schema to prevent polluting partial settings with defaults before merge
+     */
+    private loadSettingsFile;
+    /**
+     * Deep merge two settings objects with priority to override
+     * Uses deepmerge library with array replacement strategy
+     */
+    private mergeSettings;
+    /**
+     * Format all Zod validation errors into a single error message
+     */
+    private formatAllZodErrors;
+    /**
+     * Validate settings structure and model names using Zod schema
+     * This method is kept for testing purposes but uses Zod internally
+     * @internal - Only used in tests via bracket notation
+     */
+    private validateSettings;
+    /**
+     * Get project root (defaults to process.cwd())
+     */
+    private getProjectRoot;
+    /**
+     * Get global config directory path (~/.config/iloom-ai)
+     */
+    private getGlobalConfigDir;
+    /**
+     * Get global settings file path (~/.config/iloom-ai/settings.json)
+     */
+    private getGlobalSettingsPath;
+    /**
+     * Load and parse global settings file
+     * Returns empty object if file doesn't exist (not an error)
+     * Warns but returns empty object on validation/parse errors (graceful degradation)
+     */
+    private loadGlobalSettingsFile;
+    /**
+     * Get effective protected branches list with mainBranch always included
+     *
+     * This method provides a single source of truth for protected branches logic:
+     * 1. Use configured protectedBranches if provided
+     * 2. Otherwise use defaults: [mainBranch, 'main', 'master', 'develop']
+     * 3. ALWAYS ensure mainBranch is included even if user configured custom list
+     *
+     * @param projectRoot - Optional project root directory (defaults to process.cwd())
+     * @returns Array of protected branch names with mainBranch guaranteed to be included
+     */
+    getProtectedBranches(projectRoot?: string): Promise<string[]>;
+    /**
+     * Get the spin orchestrator model with default applied
+     * Default is defined in SpinAgentSettingsSchema
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Model shorthand (e.g. 'opus', 'sonnet', 'haiku', 'sonnet[1m]', 'opus[1m]')
+     */
+    getSpinModel(settings?: IloomSettings, mode?: 'swarm'): ClaudeModel;
+    /**
+     * Get the plan command model with default applied
+     * Default is defined in PlanCommandSettingsSchema
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Model shorthand (e.g. 'opus', 'sonnet', 'haiku', 'sonnet[1m]', 'opus[1m]')
+     */
+    getPlanModel(settings?: IloomSettings): ClaudeModel;
+    /**
+     * Get the plan command planner with default applied
+     * Default is 'claude'
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Planner provider ('claude', 'gemini', or 'codex')
+     */
+    getPlanPlanner(settings?: IloomSettings): 'claude' | 'gemini' | 'codex';
+    /**
+     * Get the plan command reviewer with default applied
+     * Default is 'none' (no review step)
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Reviewer provider ('claude', 'gemini', 'codex', or 'none')
+     */
+    getPlanReviewer(settings?: IloomSettings): 'claude' | 'gemini' | 'codex' | 'none';
+    /**
+     * Get the plan command waveVerification setting with default applied
+     * Default is true (verification tasks are generated)
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Whether wave verification is enabled
+     */
+    getPlanWaveVerification(settings?: IloomSettings): boolean;
+    /**
+     * Get the spin effort level
+     * Defaults to 'high' when not configured
+     *
+     * @param settings - Pre-loaded settings object
+     * @param mode - When 'swarm', returns swarmEffort (defaults to 'high')
+     * @returns Effort level
+     */
+    getSpinEffort(settings?: IloomSettings, mode?: 'swarm'): EffortLevel;
+    /**
+     * Get the plan effort level
+     * Defaults to 'high' when not configured
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Effort level
+     */
+    getPlanEffort(settings?: IloomSettings): EffortLevel;
+    /**
+     * Get the session summary model with default applied
+     * Default is defined in SummarySettingsSchema
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Model shorthand (e.g. 'opus', 'sonnet', 'haiku', 'sonnet[1m]', 'opus[1m]')
+     */
+    getSummaryModel(settings?: IloomSettings): ClaudeModel;
 }
 
-interface RgbColor {
-    r: number;
-    g: number;
-    b: number;
-}
-interface ColorData {
-    rgb: RgbColor;
-    hex: string;
-    index: number;
-}
-type Platform = 'darwin' | 'linux' | 'win32' | 'unsupported';
-interface ValidationOptions {
-    dryRun?: boolean;
-    skipTypecheck?: boolean;
-    skipLint?: boolean;
-    skipTests?: boolean;
-    jsonStream?: boolean;
-}
-interface ValidationStepResult {
-    step: 'typecheck' | 'compile' | 'lint' | 'test';
-    passed: boolean;
-    skipped: boolean;
-    output?: string;
-    error?: string;
-    duration?: number;
-}
-interface ValidationResult {
-    success: boolean;
-    steps: ValidationStepResult[];
-    totalDuration: number;
-}
-interface CommitOptions {
-    dryRun?: boolean;
-    issueNumber?: string | number;
-    issuePrefix: string;
-    message?: string;
-    noReview?: boolean;
-    skipVerify?: boolean;
-    skipVerifySilent?: boolean;
-    trailerType?: 'Refs' | 'Fixes';
-    timeout?: number;
-}
 /**
- * Error thrown when user aborts a commit operation
- * Used by CommitManager when user selects 'abort' at the commit prompt
+ * Manages Git worktrees for the iloom CLI
+ * Ports functionality from bash scripts into TypeScript
  */
-declare class UserAbortedCommitError extends Error {
-    constructor(message?: string);
-}
-interface MergeOptions {
-    dryRun?: boolean;
-    force?: boolean;
-    repoRoot?: string;
-    jsonStream?: boolean;
-}
-interface MergeResult {
-    success: boolean;
-    branchName: string;
-    commitsMerged: number;
-    rebaseCompleted: boolean;
-    mergeCompleted: boolean;
-}
-interface UpdateCheckCache {
-    lastCheck: number;
-    latestVersion: string;
-}
-interface UpdateCheckResult {
-    currentVersion: string;
-    latestVersion: string;
-    updateAvailable: boolean;
+declare class GitWorktreeManager {
+    private readonly _workingDirectory;
+    constructor(workingDirectory?: string);
+    /**
+     * Get the working directory for git operations (main worktree path)
+     */
+    get workingDirectory(): string;
+    /**
+     * List all worktrees in the repository
+     * Defaults to porcelain format for reliable machine parsing
+     * Equivalent to: git worktree list --porcelain
+     */
+    listWorktrees(options?: WorktreeListOptions): Promise<GitWorktree[]>;
+    /**
+     * Find worktree for a specific branch
+     * Ports: find_worktree_for_branch() from find-worktree-for-branch.sh
+     */
+    findWorktreeForBranch(branchName: string): Promise<GitWorktree | null>;
+    /**
+     * Check if a worktree is the main repository worktree
+     * Uses findMainWorktreePathWithSettings to determine the main worktree based on settings.
+     *
+     * @param worktree - The worktree to check
+     * @param settingsManager - SettingsManager instance for loading settings
+     * @returns true if the worktree is the main worktree
+     */
+    isMainWorktree(worktree: GitWorktree, settingsManager: SettingsManager): Promise<boolean>;
+    /**
+     * Check if a worktree is a PR worktree based on naming patterns
+     * Ports: is_pr_worktree() from worktree-utils.sh
+     */
+    isPRWorktree(worktree: GitWorktree): boolean;
+    /**
+     * Get PR number from worktree branch name
+     * Ports: get_pr_number_from_worktree() from worktree-utils.sh
+     */
+    getPRNumberFromWorktree(worktree: GitWorktree): number | null;
+    /**
+     * Create a new worktree
+     * Ports worktree creation logic from new-branch-workflow.sh
+     * @returns The absolute path to the created worktree
+     */
+    createWorktree(options: WorktreeCreateOptions): Promise<string>;
+    /**
+     * Remove a worktree and optionally clean up associated files
+     * Ports worktree removal logic from cleanup-worktree.sh
+     * @returns A message describing what was done (for dry-run mode)
+     */
+    removeWorktree(worktreePath: string, options?: WorktreeCleanupOptions): Promise<string | void>;
+    /**
+     * Validate worktree state and integrity
+     */
+    validateWorktree(worktreePath: string): Promise<WorktreeValidation>;
+    /**
+     * Get detailed status information for a worktree
+     */
+    getWorktreeStatus(worktreePath: string): Promise<WorktreeStatus>;
+    /**
+     * Generate a suggested worktree path for a branch
+     */
+    generateWorktreePath(branchName: string, customRoot?: string, options?: {
+        isPR?: boolean;
+        prNumber?: number;
+        prefix?: string;
+    }): string;
+    /**
+     * Sanitize a branch name for use as a directory name
+     * Replaces slashes with dashes and removes invalid filesystem characters
+     * Ports logic from bash script line 593: ${BRANCH_NAME//\\//-}
+     */
+    sanitizeBranchName(branchName: string): string;
+    /**
+     * Check if repository is in a valid state for worktree operations
+     */
+    isRepoReady(): Promise<boolean>;
+    /**
+     * Get repository information
+     */
+    getRepoInfo(): Promise<{
+        root: string | null;
+        defaultBranch: string;
+        currentBranch: string | null;
+    }>;
+    /**
+     * Prune stale worktree entries (worktrees that no longer exist on disk)
+     */
+    pruneWorktrees(): Promise<void>;
+    /**
+     * Lock a worktree to prevent it from being pruned or moved
+     */
+    lockWorktree(worktreePath: string, reason?: string): Promise<void>;
+    /**
+     * Unlock a previously locked worktree
+     */
+    unlockWorktree(worktreePath: string): Promise<void>;
+    /**
+     * Find worktrees matching an identifier (branch name, path, or PR number)
+     */
+    findWorktreesByIdentifier(identifier: string): Promise<GitWorktree[]>;
+    /**
+     * Find worktree for a specific issue number using exact pattern matching
+     * Matches: issue-{N} at start OR after /, -, _ (but NOT issue-{N}X where X is a digit)
+     * Supports patterns like: issue-44, feat/issue-44-feature, feat-issue-44, bugfix_issue-44, etc.
+     * Avoids false matches like: tissue-44, myissue-44
+     * Ports: find_existing_worktree() from bash script lines 131-165
+     */
+    findWorktreeForIssue(issueNumber: string | number): Promise<GitWorktree | null>;
+    /**
+     * Find worktree for a specific PR by branch name
+     * Ports: find_existing_worktree() for PR type from bash script lines 149-160
+     */
+    findWorktreeForPR(prNumber: number, branchName: string): Promise<GitWorktree | null>;
+    /**
+     * Remove multiple worktrees
+     * Returns a summary of successes and failures
+     * Automatically filters out the main worktree
+     *
+     * @param worktrees - Array of worktrees to remove
+     * @param settingsManager - SettingsManager instance for determining main worktree
+     * @param options - Cleanup options
+     */
+    removeWorktrees(worktrees: GitWorktree[], settingsManager: SettingsManager, options?: WorktreeCleanupOptions): Promise<{
+        successes: Array<{
+            worktree: GitWorktree;
+        }>;
+        failures: Array<{
+            worktree: GitWorktree;
+            error: string;
+        }>;
+        skipped: Array<{
+            worktree: GitWorktree;
+            reason: string;
+        }>;
+    }>;
+    /**
+     * Format worktree information for display
+     */
+    formatWorktree(worktree: GitWorktree): {
+        title: string;
+        path: string;
+        commit: string;
+    };
 }
-type InstallationMethod = 'global' | 'local' | 'linked' | 'unknown';
 
 /**
  * IssueTracker interface - abstraction for issue tracking providers
@@ -2305,6 +2357,7 @@ interface MetadataFile {
     oneShot?: OneShotMode;
     dangerouslySkipPermissions?: boolean;
     complexity?: ComplexityOverride;
+    effort?: EffortLevel;
     capabilities?: ProjectCapability[];
     state?: SwarmState;
     childIssueNumbers?: string[];
@@ -2348,6 +2401,7 @@ interface WriteMetadataInput {
     oneShot?: OneShotMode;
     dangerouslySkipPermissions?: boolean;
     complexity?: ComplexityOverride;
+    effort?: EffortLevel;
     capabilities: ProjectCapability[];
     state?: SwarmState;
     childIssueNumbers?: string[];
@@ -2392,6 +2446,7 @@ interface LoomMetadata {
     oneShot: OneShotMode | null;
     dangerouslySkipPermissions: boolean;
     complexity: ComplexityOverride | null;
+    effort: EffortLevel | null;
     capabilities: ProjectCapability[];
     state: SwarmState | null;
     childIssueNumbers: string[];
@@ -3044,4 +3099,4 @@ declare class TableFormatter {
     static previewFormatting(headers: string[], options?: TableFormatterOptions): string;
 }
 
-export { type AddIssueOptions, type AddIssueResult, type AutoSwarmCompletedProperties, type AutoSwarmStartedProperties, type BatchCleanupResult, type BranchCleanupTarget, type BranchDeleteOptions, type BranchGenerationOptions, type BranchNameStrategy, type Capability, type ClaudeContext, ClaudeContextManager, type CleanupOptions, type CleanupResult, type CliInstalledProperties, type CliUpgradedProperties, type ColorData, type CommitOptions, type ComplexityOverride, type Config, type ContributeStartedProperties, type CreateLoomInput, type DatabaseDeletionResult, DatabaseManager, type DatabaseProvider, type DemoCompletedProperties, type DemoStartedProperties, type DevServerStartedEvent, type DevServerStoppedEvent, type EnhanceOptions, type EnhanceResult, type EnvFileOptions, type EnvOperationResult, type EnvVariable, EnvironmentManager, type EpicPlannedProperties, type EpicReportGeneratedProperties, type ErrorOccurredProperties, type FeedbackOptions, type FinishOptions, type FinishResult, GitCommandError, GitHubService, type GitStatus, type GitWorktree, GitWorktreeManager, type InitCompletedProperties, type InitStartedProperties, type InstallationMethod, type Issue, type IssueTracker, IssueTrackerFactory, type IssueTrackerInputDetection, type IssueTrackerProviderType, JiraWikiSanitizer, type LaunchMode, LinearMarkupConverter, type ListOptions, type Logger, type LoggerOptions, type Loom, type LoomAbandonedProperties, type LoomCreatedProperties, type LoomFinishedProperties, type LoomSummary, type MergeOptions, type MergeResult, type MockOptions, type OneShotMode, type OperationResult, PLACEHOLDER_COMMIT_PREFIX, type PRWorktreePattern, type Platform, type PortAssignmentOptions, type ProcessInfo, type ProjectCapability, type PullRequest, type RebaseOutcome, type RebaseResult, type RemoteBranchStatus, type ResourceCleanupOptions, type RgbColor, type SafetyCheck, type SessionStartedProperties, type StartOptions, type StartResult, type SummaryResult, type SwarmChildCompletedProperties, type SwarmCompletedProperties, type SwarmStartedProperties, TableFormatter, type TableFormatterOptions, type TableGenerationOptions, type TelemetryConfig, type TelemetryEventMap, type TelemetryEventName, type UpdateCheckCache, type UpdateCheckResult, UserAbortedCommitError, type ValidationOptions, type ValidationResult, type ValidationStepResult, type Workspace, type WorkspaceInput, WorkspaceManager, type WorkspaceSummary, type Worktree, type WorktreeCleanupOptions, type WorktreeCreateOptions, type WorktreeListOptions, type WorktreeOperationResult, type WorktreeStatus, type WorktreeValidation, branchExists, checkRemoteBranchStatus, createLogger, createStderrLogger, ensureRepositoryHasCommits, executeGitCommand, extractIssueNumber, extractPRNumber, fetchOrigin, findAllBranchesForIssue, findMainWorktreePath, findMainWorktreePathWithSettings, findPlaceholderCommitSha, findWorktreeForBranch, generateWorktreePath, getCurrentBranch, getDefaultBranch, getMergeTargetBranch, getRepoRoot, getThemeMode, getWorktreeRoot, hasUncommittedChanges, isBranchMergedIntoMain, isEmptyRepository, isFileGitignored, isFileTrackedByGit, isPRBranch, isPlaceholderCommit, isRemoteBranchUpToDate, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote, removePlaceholderCommitFromHead, removePlaceholderCommitFromHistory, setThemeMode };
+export { type AddIssueOptions, type AddIssueResult, type AutoSwarmCompletedProperties, type AutoSwarmStartedProperties, type BatchCleanupResult, type BranchCleanupTarget, type BranchDeleteOptions, type BranchGenerationOptions, type BranchNameStrategy, type Capability, type ClaudeContext, ClaudeContextManager, type CleanupOptions, type CleanupResult, type CliInstalledProperties, type CliUpgradedProperties, type ColorData, type CommitOptions, type ComplexityOverride, type Config, type ContributeStartedProperties, type CreateLoomInput, type DatabaseDeletionResult, DatabaseManager, type DatabaseProvider, type DemoCompletedProperties, type DemoStartedProperties, type DevServerStartedEvent, type DevServerStoppedEvent, type EffortLevel, type EnhanceOptions, type EnhanceResult, type EnvFileOptions, type EnvOperationResult, type EnvVariable, EnvironmentManager, type EpicPlannedProperties, type EpicReportGeneratedProperties, type ErrorOccurredProperties, type FeedbackOptions, type FinishOptions, type FinishResult, GitCommandError, GitHubService, type GitStatus, type GitWorktree, GitWorktreeManager, type InitCompletedProperties, type InitStartedProperties, type InstallationMethod, type Issue, type IssueTracker, IssueTrackerFactory, type IssueTrackerInputDetection, type IssueTrackerProviderType, JiraWikiSanitizer, type LaunchMode, LinearMarkupConverter, type ListOptions, type Logger, type LoggerOptions, type Loom, type LoomAbandonedProperties, type LoomCreatedProperties, type LoomFinishedProperties, type LoomSummary, type MergeOptions, type MergeResult, type MockOptions, type OneShotMode, type OperationResult, PLACEHOLDER_COMMIT_PREFIX, type PRWorktreePattern, type Platform, type PortAssignmentOptions, type ProcessInfo, type ProjectCapability, type PullRequest, type RebaseOutcome, type RebaseResult, type RemoteBranchStatus, type ResourceCleanupOptions, type RgbColor, type SafetyCheck, type SessionStartedProperties, type StartOptions, type StartResult, type SummaryResult, type SwarmChildCompletedProperties, type SwarmCompletedProperties, type SwarmStartedProperties, TableFormatter, type TableFormatterOptions, type TableGenerationOptions, type TelemetryConfig, type TelemetryEventMap, type TelemetryEventName, type UpdateCheckCache, type UpdateCheckResult, UserAbortedCommitError, VALID_EFFORT_LEVELS, type ValidationOptions, type ValidationResult, type ValidationStepResult, type Workspace, type WorkspaceInput, WorkspaceManager, type WorkspaceSummary, type Worktree, type WorktreeCleanupOptions, type WorktreeCreateOptions, type WorktreeListOptions, type WorktreeOperationResult, type WorktreeStatus, type WorktreeValidation, branchExists, checkRemoteBranchStatus, createLogger, createStderrLogger, ensureRepositoryHasCommits, executeGitCommand, extractIssueNumber, extractPRNumber, fetchOrigin, findAllBranchesForIssue, findMainWorktreePath, findMainWorktreePathWithSettings, findPlaceholderCommitSha, findWorktreeForBranch, generateWorktreePath, getCurrentBranch, getDefaultBranch, getMergeTargetBranch, getRepoRoot, getThemeMode, getWorktreeRoot, hasUncommittedChanges, isBranchMergedIntoMain, isEffortLevel, isEmptyRepository, isFileGitignored, isFileTrackedByGit, isPRBranch, isPlaceholderCommit, isRemoteBranchUpToDate, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote, removePlaceholderCommitFromHead, removePlaceholderCommitFromHistory, setThemeMode };