@iloom/cli 0.9.2 → 0.10.0

package/dist/index.d.ts

@@ -270,16 +270,45 @@ declare const IloomSettingsSchema: z.ZodObject<{
         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"]>>;
+            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;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }, {
+            model?: "opus" | "sonnet" | "haiku" | undefined;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         model?: "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;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
     }, {
         model?: "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;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
     }>>>>;
     spin: z.ZodOptional<z.ZodObject<{
         model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
@@ -309,7 +338,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 +359,6 @@ declare const IloomSettingsSchema: z.ZodObject<{
         database?: {
             databaseUrlEnvVarName: string;
         } | undefined;
-        capabilities?: ("cli" | "web")[] | undefined;
     }, {
         web?: {
             basePort?: number | undefined;
@@ -339,7 +366,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 +390,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 +411,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 +452,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 +472,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"]>>;
@@ -450,20 +532,23 @@ declare const IloomSettingsSchema: z.ZodObject<{
     git: {
         commitTimeout: number;
     };
+    agents?: Record<string, {
+        model?: "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;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
+    }> | null | undefined;
     plan?: {
         model: "opus" | "sonnet" | "haiku";
         planner: "claude" | "gemini" | "codex";
         reviewer: "claude" | "gemini" | "codex" | "none";
     } | undefined;
-    capabilities?: {
-        web?: {
-            basePort?: number | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName: string;
-        } | undefined;
-        capabilities?: ("cli" | "web")[] | undefined;
-    } | undefined;
     mainBranch?: string | undefined;
     worktreePrefix?: string | undefined;
     protectedBranches?: string[] | undefined;
@@ -497,18 +582,20 @@ 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 +603,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
     issueManagement?: {
-        provider: "github" | "linear";
+        provider: "github" | "linear" | "jira";
         github?: {
             remote: string;
         } | undefined;
@@ -525,9 +612,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;
@@ -539,20 +638,23 @@ declare const IloomSettingsSchema: z.ZodObject<{
         vscode: boolean;
     } | undefined;
 }, {
+    agents?: Record<string, {
+        model?: "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;
+            enabled?: boolean | undefined;
+            providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+            review?: boolean | undefined;
+        }> | undefined;
+    }> | null | undefined;
     plan?: {
         model?: "opus" | "sonnet" | "haiku" | undefined;
         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;
-    } | undefined;
     mainBranch?: string | undefined;
     sourceEnvOnStart?: boolean | undefined;
     worktreePrefix?: string | undefined;
@@ -587,18 +689,20 @@ 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 +718,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;
@@ -914,6 +1030,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 +1177,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 +1195,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 +1218,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 +1256,98 @@ 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 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;
+}
+type TelemetryEventName = keyof TelemetryEventMap;
+
 interface Workspace {
     id: string;
     path: string;
@@ -1243,6 +1466,7 @@ interface StartOptions {
     devServer?: boolean;
     terminal?: boolean;
     childLoom?: boolean;
+    epic?: boolean;
     oneShot?: OneShotMode;
     body?: string;
     json?: boolean;
@@ -1266,6 +1490,8 @@ interface FinishOptions {
     noBrowser?: boolean;
     cleanup?: boolean;
     json?: boolean;
+    skipToPr?: boolean;
+    review?: boolean;
 }
 /**
  * Options for the cleanup command
@@ -1286,6 +1512,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 +1536,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 +1562,7 @@ interface SummaryResult {
     sessionId: string;
     issueNumber?: string | number;
     branchName: string;
-    loomType: 'issue' | 'pr' | 'branch';
+    loomType: 'issue' | 'pr' | 'branch' | 'epic';
 }
 interface MockOptions {
     scenario: 'empty' | 'existing' | 'conflicts' | 'error';
@@ -1433,10 +1662,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 +1703,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 +1894,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 +1935,15 @@ 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;
+    SWARM_AGENT_METADATA?: string;
+    NO_CLEANUP?: boolean;
+    ISSUE_PREFIX?: string;
 }
 declare class PromptTemplateManager {
     private templateDir;
@@ -1696,7 +1951,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 +1959,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 +2019,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 +2070,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 +2083,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 +2111,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 +2124,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 +2208,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)
      *
@@ -2403,4 +2732,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 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, 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 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 };