@iloom/cli 0.9.2 → 0.10.1

package/dist/index.d.ts

@@ -267,26 +267,69 @@ declare const IloomSettingsSchema: z.ZodObject<{
     }>>;
     agents: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         model: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+        swarmModel: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["claude", "gemini", "codex"]>, z.ZodString>>;
         review: z.ZodOptional<z.ZodBoolean>;
+    } & {
+        agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            model: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+            swarmModel: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["claude", "gemini", "codex"]>, z.ZodString>>;
+            review: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            model?: "opus" | "sonnet" | "haiku" | undefined;
+            swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }, {
+            model?: "opus" | "sonnet" | "haiku" | undefined;
+            swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }>>>;
+        subAgentTimeout: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
+        subAgentTimeout: number;
         model?: "opus" | "sonnet" | "haiku" | undefined;
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
         enabled?: boolean | undefined;
         providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
         review?: boolean | undefined;
+        agents?: Record<string, {
+            model?: "opus" | "sonnet" | "haiku" | undefined;
+            swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
     }, {
         model?: "opus" | "sonnet" | "haiku" | undefined;
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
         enabled?: boolean | undefined;
         providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
         review?: boolean | undefined;
+        agents?: Record<string, {
+            model?: "opus" | "sonnet" | "haiku" | undefined;
+            swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
+        subAgentTimeout?: number | undefined;
     }>>>>;
     spin: z.ZodOptional<z.ZodObject<{
         model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+        swarmModel: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
     }, "strip", z.ZodTypeAny, {
         model: "opus" | "sonnet" | "haiku";
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
     }, {
         model?: "opus" | "sonnet" | "haiku" | undefined;
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
     }>>;
     plan: z.ZodOptional<z.ZodObject<{
         model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
@@ -309,7 +352,6 @@ declare const IloomSettingsSchema: z.ZodObject<{
         model?: "opus" | "sonnet" | "haiku" | undefined;
     }>>;
     capabilities: z.ZodOptional<z.ZodObject<{
-        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<["cli", "web"]>, "many">>;
         web: z.ZodOptional<z.ZodObject<{
             basePort: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
@@ -331,7 +373,6 @@ declare const IloomSettingsSchema: z.ZodObject<{
         database?: {
             databaseUrlEnvVarName: string;
         } | undefined;
-        capabilities?: ("cli" | "web")[] | undefined;
     }, {
         web?: {
             basePort?: number | undefined;
@@ -339,7 +380,6 @@ declare const IloomSettingsSchema: z.ZodObject<{
         database?: {
             databaseUrlEnvVarName?: string | undefined;
         } | undefined;
-        capabilities?: ("cli" | "web")[] | undefined;
     }>>;
     databaseProviders: z.ZodOptional<z.ZodObject<{
         neon: z.ZodOptional<z.ZodObject<{
@@ -364,7 +404,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         } | undefined;
     }>>;
     issueManagement: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<["github", "linear"]>>>;
+        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<["github", "linear", "jira"]>>>;
         github: z.ZodOptional<z.ZodObject<{
             remote: z.ZodString;
         }, "strip", z.ZodTypeAny, {
@@ -385,8 +425,39 @@ declare const IloomSettingsSchema: z.ZodObject<{
             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";
+        provider: "github" | "linear" | "jira";
         github?: {
             remote: string;
         } | undefined;
@@ -395,6 +466,17 @@ declare const IloomSettingsSchema: z.ZodObject<{
             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;
@@ -404,20 +486,34 @@ declare const IloomSettingsSchema: z.ZodObject<{
             branchFormat?: string | undefined;
             apiToken?: string | undefined;
         } | undefined;
-        provider?: "github" | "linear" | 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;
     }>>;
     mergeBehavior: z.ZodOptional<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<["local", "github-pr", "github-draft-pr"]>>;
         remote: z.ZodOptional<z.ZodString>;
         autoCommitPush: z.ZodOptional<z.ZodBoolean>;
+        openBrowserOnFinish: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         mode: "local" | "github-pr" | "github-draft-pr";
+        openBrowserOnFinish: boolean;
         remote?: string | undefined;
         autoCommitPush?: boolean | undefined;
     }, {
         remote?: string | undefined;
         mode?: "local" | "github-pr" | "github-draft-pr" | undefined;
         autoCommitPush?: boolean | undefined;
+        openBrowserOnFinish?: boolean | undefined;
     }>>;
     ide: z.ZodOptional<z.ZodObject<{
         type: z.ZodDefault<z.ZodEnum<["vscode", "cursor", "webstorm", "sublime", "intellij", "windsurf", "antigravity"]>>;
@@ -455,15 +551,25 @@ declare const IloomSettingsSchema: z.ZodObject<{
         planner: "claude" | "gemini" | "codex";
         reviewer: "claude" | "gemini" | "codex" | "none";
     } | undefined;
-    capabilities?: {
-        web?: {
-            basePort?: number | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName: string;
-        } | undefined;
-        capabilities?: ("cli" | "web")[] | undefined;
+    spin?: {
+        model: "opus" | "sonnet" | "haiku";
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
     } | undefined;
+    agents?: Record<string, {
+        subAgentTimeout: number;
+        model?: "opus" | "sonnet" | "haiku" | undefined;
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+        enabled?: boolean | undefined;
+        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
+        agents?: Record<string, {
+            model?: "opus" | "sonnet" | "haiku" | undefined;
+            swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
+    }> | null | undefined;
     mainBranch?: string | undefined;
     worktreePrefix?: string | undefined;
     protectedBranches?: string[] | undefined;
@@ -497,18 +603,17 @@ declare const IloomSettingsSchema: z.ZodObject<{
             noVerify?: boolean | undefined;
         } | undefined;
     } | undefined;
-    agents?: Record<string, {
-        model?: "opus" | "sonnet" | "haiku" | undefined;
-        enabled?: boolean | undefined;
-        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
-        review?: boolean | undefined;
-    }> | null | undefined;
-    spin?: {
-        model: "opus" | "sonnet" | "haiku";
-    } | undefined;
     summary?: {
         model: "opus" | "sonnet" | "haiku";
     } | undefined;
+    capabilities?: {
+        web?: {
+            basePort?: number | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName: string;
+        } | undefined;
+    } | undefined;
     databaseProviders?: {
         neon?: {
             projectId: string;
@@ -516,7 +621,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
     issueManagement?: {
-        provider: "github" | "linear";
+        provider: "github" | "linear" | "jira";
         github?: {
             remote: string;
         } | undefined;
@@ -525,9 +630,21 @@ declare const IloomSettingsSchema: z.ZodObject<{
             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;
     mergeBehavior?: {
         mode: "local" | "github-pr" | "github-draft-pr";
+        openBrowserOnFinish: boolean;
         remote?: string | undefined;
         autoCommitPush?: boolean | undefined;
     } | undefined;
@@ -544,15 +661,25 @@ declare const IloomSettingsSchema: z.ZodObject<{
         planner?: "claude" | "gemini" | "codex" | undefined;
         reviewer?: "claude" | "gemini" | "codex" | "none" | undefined;
     } | undefined;
-    capabilities?: {
-        web?: {
-            basePort?: number | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName?: string | undefined;
-        } | undefined;
-        capabilities?: ("cli" | "web")[] | undefined;
+    spin?: {
+        model?: "opus" | "sonnet" | "haiku" | undefined;
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
     } | undefined;
+    agents?: Record<string, {
+        model?: "opus" | "sonnet" | "haiku" | undefined;
+        swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+        enabled?: boolean | undefined;
+        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
+        agents?: Record<string, {
+            model?: "opus" | "sonnet" | "haiku" | undefined;
+            swarmModel?: "opus" | "sonnet" | "haiku" | undefined;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
+        subAgentTimeout?: number | undefined;
+    }> | null | undefined;
     mainBranch?: string | undefined;
     sourceEnvOnStart?: boolean | undefined;
     worktreePrefix?: string | undefined;
@@ -587,18 +714,17 @@ declare const IloomSettingsSchema: z.ZodObject<{
             generateSummary?: boolean | undefined;
         } | undefined;
     } | undefined;
-    agents?: Record<string, {
-        model?: "opus" | "sonnet" | "haiku" | undefined;
-        enabled?: boolean | undefined;
-        providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
-        review?: boolean | undefined;
-    }> | null | undefined;
-    spin?: {
-        model?: "opus" | "sonnet" | "haiku" | undefined;
-    } | undefined;
     summary?: {
         model?: "opus" | "sonnet" | "haiku" | undefined;
     } | undefined;
+    capabilities?: {
+        web?: {
+            basePort?: number | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName?: string | undefined;
+        } | undefined;
+    } | undefined;
     databaseProviders?: {
         neon?: {
             projectId: string;
@@ -614,12 +740,24 @@ declare const IloomSettingsSchema: z.ZodObject<{
             branchFormat?: string | undefined;
             apiToken?: string | undefined;
         } | undefined;
-        provider?: "github" | "linear" | 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;
     mergeBehavior?: {
         remote?: string | undefined;
         mode?: "local" | "github-pr" | "github-draft-pr" | undefined;
         autoCommitPush?: boolean | undefined;
+        openBrowserOnFinish?: boolean | undefined;
     } | undefined;
     ide?: {
         type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity" | undefined;
@@ -713,7 +851,7 @@ declare class SettingsManager {
      * @param settings - Pre-loaded settings object
      * @returns Model shorthand ('opus', 'sonnet', or 'haiku')
      */
-    getSpinModel(settings?: IloomSettings): 'sonnet' | 'opus' | 'haiku';
+    getSpinModel(settings?: IloomSettings, mode?: 'swarm'): 'sonnet' | 'opus' | 'haiku';
     /**
      * Get the plan command model with default applied
      * Default is defined in PlanCommandSettingsSchema
@@ -914,6 +1052,13 @@ interface ResourceCleanupOptions {
     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
@@ -1054,7 +1199,7 @@ interface Loom {
     id: string;
     path: string;
     branch: string;
-    type: 'issue' | 'pr' | 'branch';
+    type: 'issue' | 'pr' | 'branch' | 'epic';
     identifier: string | number;
     port: number;
     databaseBranch?: string;
@@ -1072,12 +1217,12 @@ interface Loom {
     cliSymlinks?: string[];
 }
 interface CreateLoomInput {
-    type: 'issue' | 'pr' | 'branch';
+    type: 'issue' | 'pr' | 'branch' | 'epic';
     identifier: string | number;
     originalInput: string;
     baseBranch?: string;
     parentLoom?: {
-        type: 'issue' | 'pr' | 'branch';
+        type: 'issue' | 'pr' | 'branch' | 'epic';
         identifier: string | number;
         branchName: string;
         worktreePath: string;
@@ -1095,12 +1240,20 @@ interface CreateLoomInput {
         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';
+    type: 'issue' | 'pr' | 'branch' | 'epic';
     identifier: string | number;
     title?: string;
     branch: string;
@@ -1125,6 +1278,112 @@ interface ProcessInfo {
     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';
+}
+interface LoomFinishedProperties {
+    merge_behavior: 'local' | 'github-pr' | 'github-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 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;
+}
+type TelemetryEventName = keyof TelemetryEventMap;
+
 interface Workspace {
     id: string;
     path: string;
@@ -1243,6 +1502,7 @@ interface StartOptions {
     devServer?: boolean;
     terminal?: boolean;
     childLoom?: boolean;
+    epic?: boolean;
     oneShot?: OneShotMode;
     body?: string;
     json?: boolean;
@@ -1266,6 +1526,9 @@ interface FinishOptions {
     noBrowser?: boolean;
     cleanup?: boolean;
     json?: boolean;
+    skipToPr?: boolean;
+    jsonStream?: boolean;
+    review?: boolean;
 }
 /**
  * Options for the cleanup command
@@ -1286,6 +1549,8 @@ interface CleanupOptions {
     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;
@@ -1308,14 +1573,15 @@ interface StartResult {
     path: string;
     branch: string;
     port?: number;
-    type: 'issue' | 'pr' | 'branch';
+    type: 'issue' | 'pr' | 'branch' | 'epic';
     identifier: string | number;
     title?: string;
     capabilities?: string[];
+    childIssueNumbers?: string[];
 }
 interface FinishResult {
     success: boolean;
-    type: 'issue' | 'pr' | 'branch';
+    type: 'issue' | 'pr' | 'branch' | 'epic';
     identifier: string | number;
     /** Whether this was a dry-run operation */
     dryRun?: boolean;
@@ -1333,7 +1599,19 @@ interface SummaryResult {
     sessionId: string;
     issueNumber?: string | number;
     branchName: string;
-    loomType: 'issue' | 'pr' | 'branch';
+    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';
@@ -1356,6 +1634,7 @@ interface ValidationOptions {
     skipTypecheck?: boolean;
     skipLint?: boolean;
     skipTests?: boolean;
+    jsonStream?: boolean;
 }
 interface ValidationStepResult {
     step: 'typecheck' | 'compile' | 'lint' | 'test';
@@ -1392,6 +1671,7 @@ interface MergeOptions {
     dryRun?: boolean;
     force?: boolean;
     repoRoot?: string;
+    jsonStream?: boolean;
 }
 interface MergeResult {
     success: boolean;
@@ -1433,10 +1713,18 @@ interface IssueTracker {
         url: string;
     }>;
     getIssueUrl(identifier: string | number, repo?: string): Promise<string>;
+    getChildIssues(parentIdentifier: string, repo?: string): Promise<Array<{
+        id: string;
+        title: string;
+        url: string;
+        state: string;
+    }>>;
     fetchPR?(identifier: string | number, repo?: string): Promise<PullRequest>;
     isValidPR?(identifier: string | number, repo?: string): Promise<PullRequest | false>;
     validatePRState?(pr: PullRequest): Promise<void>;
     moveIssueToInProgress?(identifier: string | number): Promise<void>;
+    moveIssueToReadyForReview?(identifier: string | number): Promise<void>;
+    normalizeIdentifier(identifier: string | number): string;
     extractContext(entity: Issue | PullRequest): string;
 }
 
@@ -1466,15 +1754,23 @@ declare class GitHubService implements IssueTracker {
         url: string;
     }>;
     getIssueUrl(issueNumber: number, repo?: string): Promise<string>;
+    getChildIssues(parentIdentifier: string, repo?: string): Promise<Array<{
+        id: string;
+        title: string;
+        url: string;
+        state: string;
+    }>>;
     moveIssueToInProgress(issueNumber: number): Promise<void>;
+    moveIssueToReadyForReview(issueNumber: number): Promise<void>;
     private updateIssueStatusInProject;
+    normalizeIdentifier(identifier: string | number): string;
     extractContext(entity: Issue | PullRequest): string;
     private mapGitHubIssueToIssue;
     private mapGitHubPRToPullRequest;
     private promptUserConfirmation;
 }
 
-type IssueTrackerProviderType = 'github' | 'linear';
+type IssueTrackerProviderType = 'github' | 'linear' | 'jira';
 /**
  * Factory for creating IssueTracker instances based on settings
  * Provides a single point of provider instantiation
@@ -1649,6 +1945,7 @@ interface TemplateVariables {
     AUTO_COMMIT_PUSH?: boolean;
     STANDARD_ISSUE_MODE?: boolean;
     STANDARD_BRANCH_MODE?: boolean;
+    DIRECT_PROMPT_MODE?: boolean;
     IS_VSCODE_MODE?: boolean;
     HAS_PACKAGE_JSON?: boolean;
     NO_PACKAGE_JSON?: boolean;
@@ -1689,6 +1986,17 @@ interface TemplateVariables {
     USE_CODEX_REVIEWER?: boolean;
     HAS_REVIEWER?: boolean;
     GIT_REMOTE?: string;
+    EPIC_ISSUE_NUMBER?: string | number;
+    EPIC_WORKTREE_PATH?: string;
+    EPIC_METADATA_PATH?: string;
+    CHILD_ISSUES?: string;
+    DEPENDENCY_MAP?: string;
+    SWARM_MODE?: boolean;
+    AUTO_SWARM_MODE?: boolean;
+    SWARM_AGENT_METADATA?: string;
+    SWARM_SUB_AGENT_TIMEOUT_MS?: number;
+    NO_CLEANUP?: boolean;
+    ISSUE_PREFIX?: string;
 }
 declare class PromptTemplateManager {
     private templateDir;
@@ -1696,7 +2004,7 @@ declare class PromptTemplateManager {
     /**
      * Load a template file by name
      */
-    loadTemplate(templateName: 'issue' | 'pr' | 'regular' | 'init' | 'session-summary' | 'plan'): Promise<string>;
+    loadTemplate(templateName: 'issue' | 'pr' | 'regular' | 'init' | 'session-summary' | 'plan' | 'swarm-orchestrator'): Promise<string>;
     /**
      * Substitute variables in a template string using Handlebars
      */
@@ -1704,7 +2012,7 @@ declare class PromptTemplateManager {
     /**
      * Get a fully processed prompt for a workflow type
      */
-    getPrompt(type: 'issue' | 'pr' | 'regular' | 'init' | 'session-summary' | 'plan', variables: TemplateVariables): Promise<string>;
+    getPrompt(type: 'issue' | 'pr' | 'regular' | 'init' | 'session-summary' | 'plan' | 'swarm-orchestrator', variables: TemplateVariables): Promise<string>;
 }
 
 interface ClaudeWorkflowOptions {
@@ -1764,6 +2072,48 @@ declare class ClaudeContextManager {
     launchWithContext(context: ClaudeContext, headless?: boolean): Promise<string | void>;
 }
 
+type SwarmState = 'pending' | 'in_progress' | 'code_review' | 'done' | 'failed';
+/**
+ * Schema for metadata JSON file
+ * Stored in ~/.config/iloom-ai/looms/
+ */
+interface MetadataFile {
+    description: string;
+    created_at?: string;
+    version: number;
+    branchName?: string;
+    worktreePath?: string;
+    issueType?: 'branch' | 'issue' | 'pr' | 'epic';
+    issueKey?: string;
+    issue_numbers?: string[];
+    pr_numbers?: string[];
+    issueTracker?: string;
+    colorHex?: string;
+    sessionId?: string;
+    projectPath?: string;
+    issueUrls?: Record<string, string>;
+    prUrls?: Record<string, string>;
+    draftPrNumber?: number;
+    oneShot?: OneShotMode;
+    capabilities?: ProjectCapability[];
+    state?: SwarmState;
+    childIssueNumbers?: string[];
+    parentLoom?: {
+        type: 'issue' | 'pr' | 'branch' | 'epic';
+        identifier: string | number;
+        branchName: string;
+        worktreePath: string;
+        databaseBranch?: string;
+    };
+    childIssues?: Array<{
+        number: string;
+        title: string;
+        body: string;
+        url: string;
+    }>;
+    dependencyMap?: Record<string, string[]>;
+    mcpConfigPath?: string;
+}
 /**
  * Input for writing metadata (all fields except version and created_at)
  * Note: issueTracker is required because every loom should have an associated
@@ -1773,7 +2123,8 @@ interface WriteMetadataInput {
     description: string;
     branchName: string;
     worktreePath: string;
-    issueType: 'branch' | 'issue' | 'pr';
+    issueType: 'branch' | 'issue' | 'pr' | 'epic';
+    issueKey?: string;
     issue_numbers: string[];
     pr_numbers: string[];
     issueTracker: string;
@@ -1785,13 +2136,23 @@ interface WriteMetadataInput {
     draftPrNumber?: number;
     oneShot?: OneShotMode;
     capabilities: ProjectCapability[];
+    state?: SwarmState;
+    childIssueNumbers?: string[];
     parentLoom?: {
-        type: 'issue' | 'pr' | 'branch';
+        type: 'issue' | 'pr' | 'branch' | 'epic';
         identifier: string | number;
         branchName: string;
         worktreePath: string;
         databaseBranch?: string;
     };
+    childIssues?: Array<{
+        number: string;
+        title: string;
+        body: string;
+        url: string;
+    }>;
+    dependencyMap?: Record<string, string[]>;
+    mcpConfigPath?: string;
 }
 /**
  * Result of reading metadata for a worktree
@@ -1803,7 +2164,8 @@ interface LoomMetadata {
     created_at: string | null;
     branchName: string | null;
     worktreePath: string | null;
-    issueType: 'branch' | 'issue' | 'pr' | null;
+    issueType: 'branch' | 'issue' | 'pr' | 'epic' | null;
+    issueKey: string | null;
     issue_numbers: string[];
     pr_numbers: string[];
     issueTracker: string | null;
@@ -1815,13 +2177,23 @@ interface LoomMetadata {
     draftPrNumber: number | null;
     oneShot: OneShotMode | null;
     capabilities: ProjectCapability[];
+    state: SwarmState | null;
+    childIssueNumbers: string[];
     parentLoom: {
-        type: 'issue' | 'pr' | 'branch';
+        type: 'issue' | 'pr' | 'branch' | 'epic';
         identifier: string | number;
         branchName: string;
         worktreePath: string;
         databaseBranch?: string;
     } | null;
+    childIssues: Array<{
+        number: string;
+        title: string;
+        body: string;
+        url: string;
+    }>;
+    dependencyMap: Record<string, string[]>;
+    mcpConfigPath: string | null;
 }
 /**
  * MetadataManager: Manage loom metadata persistence
@@ -1889,6 +2261,16 @@ declare class MetadataManager {
      * @returns Array of LoomMetadata objects from all stored files
      */
     listAllMetadata(): Promise<LoomMetadata[]>;
+    /**
+     * Update existing metadata for a worktree by merging new fields
+     *
+     * Reads the existing metadata file, merges the provided updates,
+     * and writes back. Only provided fields are overwritten.
+     *
+     * @param worktreePath - Absolute path to the worktree
+     * @param updates - Partial metadata fields to merge
+     */
+    updateMetadata(worktreePath: string, updates: Partial<MetadataFile>): Promise<void>;
     /**
      * Delete metadata for a worktree (spec section 3.3)
      *
@@ -2254,6 +2636,48 @@ declare function setThemeMode(mode: ThemeMode): void;
  */
 declare function getThemeMode(): ThemeMode;
 
+/**
+ * Utility class for detecting and converting Jira Wiki markup to GitHub-Flavored Markdown.
+ * Applied at the MCP layer to prevent malformed content from reaching issue tracker providers.
+ *
+ * IMPORTANT: Only converts UNAMBIGUOUS Jira Wiki patterns.
+ * Patterns that overlap with valid Markdown (e.g., *bold*, _italic_) are
+ * intentionally NOT converted to avoid corrupting valid Markdown content.
+ *
+ * Safe conversions (unambiguous):
+ * - h1. through h6. headings at line start -> # through ######
+ * - {code}...{code} and {code:lang}...{code} -> fenced code blocks
+ * - {quote}...{quote} -> > blockquotes
+ * - [text|url] -> [text](url) (only when url looks like http/https)
+ *
+ * Intentionally NOT converted (ambiguous):
+ * - *text* (could be Markdown italic)
+ * - _text_ (could be Markdown italic or snake_case)
+ */
+declare class JiraWikiSanitizer {
+    /**
+     * Sanitize body text by converting unambiguous Jira Wiki patterns to Markdown.
+     * Preserves content inside backtick-fenced code blocks.
+     * Returns text unchanged if no Wiki patterns detected.
+     */
+    static sanitize(text: string): string;
+    /**
+     * Check if text contains unambiguous Jira Wiki patterns.
+     * Only checks for patterns that are safe to convert.
+     */
+    static hasJiraWikiPatterns(text: string): boolean;
+    /**
+     * Split text into segments, separating existing Markdown fenced code blocks
+     * from the rest of the content. This ensures we don't modify content inside
+     * code blocks (e.g., Jira Wiki examples shown in a Markdown code block).
+     */
+    private static splitByCodeBlocks;
+    /**
+     * Apply all safe Jira Wiki -> Markdown conversions to a text segment.
+     */
+    private static convertSegment;
+}
+
 /**
  * Utility class for converting HTML details/summary format to Linear's collapsible format
  *
@@ -2403,4 +2827,4 @@ declare class TableFormatter {
     static previewFormatting(headers: string[], options?: TableFormatterOptions): string;
 }
 
-export { type AddIssueOptions, type AddIssueResult, type BatchCleanupResult, type BranchCleanupTarget, type BranchDeleteOptions, type BranchGenerationOptions, type BranchNameStrategy, type Capability, type ClaudeContext, ClaudeContextManager, type CleanupOptions, type CleanupResult, type ColorData, type CommitOptions, type Config, type CreateLoomInput, type DatabaseDeletionResult, DatabaseManager, type DatabaseProvider, type EnhanceOptions, type EnhanceResult, type EnvFileOptions, type EnvOperationResult, type EnvVariable, EnvironmentManager, type FeedbackOptions, type FinishOptions, type FinishResult, GitCommandError, GitHubService, type GitStatus, type GitWorktree, GitWorktreeManager, type InstallationMethod, type Issue, type IssueTracker, IssueTrackerFactory, type IssueTrackerInputDetection, type IssueTrackerProviderType, type LaunchMode, LinearMarkupConverter, type ListOptions, type Logger, type LoggerOptions, type Loom, 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 RemoteBranchStatus, type ResourceCleanupOptions, type RgbColor, type SafetyCheck, type StartOptions, type StartResult, type SummaryResult, TableFormatter, type TableFormatterOptions, type TableGenerationOptions, 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 Config, type ContributeStartedProperties, type CreateLoomInput, type DatabaseDeletionResult, DatabaseManager, type DatabaseProvider, type DemoCompletedProperties, type DemoStartedProperties, type EnhanceOptions, type EnhanceResult, type EnvFileOptions, type EnvOperationResult, type EnvVariable, EnvironmentManager, type EpicPlannedProperties, 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 };