@iloom/cli 0.3.4 → 0.4.1

package/dist/index.d.ts

@@ -139,20 +139,23 @@ declare const IloomSettingsSchema: z.ZodObject<{
             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;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         }, {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | 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"]>>;
@@ -161,20 +164,23 @@ declare const IloomSettingsSchema: z.ZodObject<{
             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;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         }, {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | 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"]>>;
@@ -183,20 +189,23 @@ declare const IloomSettingsSchema: z.ZodObject<{
             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;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         }, {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
             startIde?: boolean | undefined;
             startDevServer?: boolean | undefined;
             startAiAgent?: boolean | undefined;
             startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         issue?: {
@@ -204,7 +213,8 @@ declare const IloomSettingsSchema: z.ZodObject<{
             startDevServer: boolean;
             startAiAgent: boolean;
             startTerminal: boolean;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         } | undefined;
         pr?: {
@@ -212,7 +222,8 @@ declare const IloomSettingsSchema: z.ZodObject<{
             startDevServer: boolean;
             startAiAgent: boolean;
             startTerminal: boolean;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         } | undefined;
         regular?: {
@@ -220,33 +231,37 @@ declare const IloomSettingsSchema: z.ZodObject<{
             startDevServer: boolean;
             startAiAgent: boolean;
             startTerminal: boolean;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         } | undefined;
     }, {
         issue?: {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
             startIde?: boolean | undefined;
             startDevServer?: boolean | undefined;
             startAiAgent?: boolean | undefined;
             startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
         } | undefined;
         pr?: {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
             startIde?: boolean | undefined;
             startDevServer?: boolean | undefined;
             startAiAgent?: boolean | undefined;
             startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
         } | undefined;
         regular?: {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | 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<{
@@ -256,6 +271,20 @@ declare const IloomSettingsSchema: z.ZodObject<{
     }, {
         model?: "sonnet" | "opus" | "haiku" | undefined;
     }>>>>;
+    spin: z.ZodOptional<z.ZodObject<{
+        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+    }, "strip", z.ZodTypeAny, {
+        model: "sonnet" | "opus" | "haiku";
+    }, {
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+    }>>;
+    summary: z.ZodOptional<z.ZodObject<{
+        model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+    }, "strip", z.ZodTypeAny, {
+        model: "sonnet" | "opus" | "haiku";
+    }, {
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+    }>>;
     capabilities: z.ZodOptional<z.ZodObject<{
         web: z.ZodOptional<z.ZodObject<{
             basePort: z.ZodOptional<z.ZodNumber>;
@@ -389,7 +418,8 @@ declare const IloomSettingsSchema: z.ZodObject<{
             startDevServer: boolean;
             startAiAgent: boolean;
             startTerminal: boolean;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         } | undefined;
         pr?: {
@@ -397,7 +427,8 @@ declare const IloomSettingsSchema: z.ZodObject<{
             startDevServer: boolean;
             startAiAgent: boolean;
             startTerminal: boolean;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         } | undefined;
         regular?: {
@@ -405,13 +436,20 @@ declare const IloomSettingsSchema: z.ZodObject<{
             startDevServer: boolean;
             startAiAgent: boolean;
             startTerminal: boolean;
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            generateSummary: boolean;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
         } | undefined;
     } | undefined;
     agents?: Record<string, {
         model?: "sonnet" | "opus" | "haiku" | undefined;
     }> | null | undefined;
+    spin?: {
+        model: "sonnet" | "opus" | "haiku";
+    } | undefined;
+    summary?: {
+        model: "sonnet" | "opus" | "haiku";
+    } | undefined;
     capabilities?: {
         web?: {
             basePort?: number | undefined;
@@ -455,33 +493,42 @@ declare const IloomSettingsSchema: z.ZodObject<{
     protectedBranches?: string[] | undefined;
     workflows?: {
         issue?: {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
             startIde?: boolean | undefined;
             startDevServer?: boolean | undefined;
             startAiAgent?: boolean | undefined;
             startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
         } | undefined;
         pr?: {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | undefined;
             noVerify?: boolean | undefined;
             startIde?: boolean | undefined;
             startDevServer?: boolean | undefined;
             startAiAgent?: boolean | undefined;
             startTerminal?: boolean | undefined;
+            generateSummary?: boolean | undefined;
         } | undefined;
         regular?: {
-            permissionMode?: "plan" | "acceptEdits" | "bypassPermissions" | "default" | undefined;
+            permissionMode?: "default" | "plan" | "acceptEdits" | "bypassPermissions" | 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" | undefined;
     }> | null | undefined;
+    spin?: {
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+    } | undefined;
+    summary?: {
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+    } | undefined;
     capabilities?: {
         web?: {
             basePort?: number | undefined;
@@ -592,6 +639,22 @@ declare class SettingsManager {
      * @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 ('opus', 'sonnet', or 'haiku')
+     */
+    getSpinModel(settings?: IloomSettings): 'sonnet' | 'opus' | 'haiku';
+    /**
+     * Get the session summary model with default applied
+     * Default is defined in SummarySettingsSchema
+     *
+     * @param settings - Pre-loaded settings object
+     * @returns Model shorthand ('opus', 'sonnet', or 'haiku')
+     */
+    getSummaryModel(settings?: IloomSettings): 'sonnet' | 'opus' | 'haiku';
 }
 
 /**
@@ -742,6 +805,115 @@ declare class GitWorktreeManager {
     };
 }
 
+/**
+ * Options for ResourceCleanup operations
+ */
+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;
+}
+/**
+ * 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';
+    /** 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;
+}
+/**
+ * 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;
+}
+/**
+ * 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[];
+}
+
 /**
  * Strategy interface for generating branch names from issue information
  */
@@ -843,104 +1015,6 @@ interface LoomSummary {
     lastAccessed: string;
 }
 
-/**
- * Options for ResourceCleanup operations
- */
-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;
-}
-/**
- * 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;
-    /** 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';
-    /** 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;
-}
-/**
- * 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;
-}
-/**
- * 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[];
-}
-
 /**
  * Information about a running process
  */
@@ -1076,15 +1150,18 @@ interface StartOptions {
     childLoom?: boolean;
     oneShot?: OneShotMode;
     body?: string;
+    json?: boolean;
 }
 interface AddIssueOptions {
     body?: string;
+    json?: boolean;
 }
 interface FeedbackOptions {
     body?: string;
 }
 interface EnhanceOptions {
     noBrowser?: boolean;
+    json?: boolean;
 }
 interface FinishOptions {
     force?: boolean;
@@ -1093,6 +1170,7 @@ interface FinishOptions {
     skipBuild?: boolean;
     noBrowser?: boolean;
     cleanup?: boolean;
+    json?: boolean;
 }
 /**
  * Options for the cleanup command
@@ -1109,10 +1187,57 @@ interface CleanupOptions {
     force?: boolean;
     /** Show what would be done without actually doing it */
     dryRun?: boolean;
+    /** Output result as JSON */
+    json?: 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';
+    identifier: string | number;
+    title?: string;
+    capabilities?: string[];
+}
+interface FinishResult {
+    success: boolean;
+    type: 'issue' | 'pr' | 'branch';
+    identifier: string | number;
+    /** Whether this was a dry-run operation */
+    dryRun?: boolean;
+    operations: Array<{
+        type: 'validation' | 'commit' | 'rebase' | 'merge' | 'cleanup' | 'pr-creation' | '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';
+}
 interface MockOptions {
     scenario: 'empty' | 'existing' | 'conflicts' | 'error';
     data?: unknown;
@@ -1136,7 +1261,7 @@ interface ValidationOptions {
     skipTests?: boolean;
 }
 interface ValidationStepResult {
-    step: 'typecheck' | 'lint' | 'test';
+    step: 'typecheck' | 'compile' | 'lint' | 'test';
     passed: boolean;
     skipped: boolean;
     output?: string;
@@ -1279,6 +1404,7 @@ declare class IssueTrackerFactory {
 
 declare class EnvironmentManager {
     private readonly backupSuffix;
+    constructor();
     /**
      * Set or update an environment variable in a .env file
      * Ports functionality from bash/utils/env-utils.sh:setEnvVar()
@@ -1392,6 +1518,7 @@ interface TemplateVariables {
     WORKSPACE_PATH?: string;
     PORT?: number;
     ONE_SHOT_MODE?: boolean;
+    INTERACTIVE_MODE?: boolean;
     SETTINGS_SCHEMA?: string;
     SETTINGS_GLOBAL_JSON?: string;
     SETTINGS_JSON?: string;
@@ -1409,6 +1536,10 @@ interface TemplateVariables {
     SETTINGS_SCHEMA_CONTENT?: string;
     FIRST_TIME_USER?: boolean;
     VSCODE_SETTINGS_GITIGNORED?: string;
+    SESSION_CONTEXT?: string;
+    BRANCH_NAME?: string;
+    LOOM_TYPE?: string;
+    COMPACT_SUMMARIES?: string;
 }
 declare class PromptTemplateManager {
     private templateDir;
@@ -1416,7 +1547,7 @@ declare class PromptTemplateManager {
     /**
      * Load a template file by name
      */
-    loadTemplate(templateName: 'issue' | 'pr' | 'regular' | 'init'): Promise<string>;
+    loadTemplate(templateName: 'issue' | 'pr' | 'regular' | 'init' | 'session-summary'): Promise<string>;
     /**
      * Substitute variables in a template string
      */
@@ -1431,7 +1562,7 @@ declare class PromptTemplateManager {
     /**
      * Get a fully processed prompt for a workflow type
      */
-    getPrompt(type: 'issue' | 'pr' | 'regular' | 'init', variables: TemplateVariables): Promise<string>;
+    getPrompt(type: 'issue' | 'pr' | 'regular' | 'init' | 'session-summary', variables: TemplateVariables): Promise<string>;
 }
 
 interface ClaudeWorkflowOptions {
@@ -1456,10 +1587,6 @@ declare class ClaudeService {
      * Check if Claude CLI is available
      */
     isAvailable(): Promise<boolean>;
-    /**
-     * Get the appropriate model for a workflow type
-     */
-    private getModelForWorkflow;
     /**
      * Get the appropriate permission mode for a workflow type
      */
@@ -1495,6 +1622,119 @@ declare class ClaudeContextManager {
     launchWithContext(context: ClaudeContext, headless?: boolean): Promise<string | void>;
 }
 
+/**
+ * Input for writing metadata (all fields except version and created_at)
+ * Note: issueTracker is required because every loom should have an associated
+ * issue tracker provider (defaults to 'github' via IssueTrackerFactory)
+ */
+interface WriteMetadataInput {
+    description: string;
+    branchName: string;
+    worktreePath: string;
+    issueType: 'branch' | 'issue' | 'pr';
+    issue_numbers: string[];
+    pr_numbers: string[];
+    issueTracker: string;
+    colorHex: string;
+    sessionId: string;
+    projectPath: string;
+    parentLoom?: {
+        type: 'issue' | 'pr' | 'branch';
+        identifier: string | number;
+        branchName: string;
+        worktreePath: string;
+        databaseBranch?: string;
+    };
+}
+/**
+ * Result of reading metadata for a worktree
+ */
+interface LoomMetadata {
+    description: string;
+    created_at: string | null;
+    branchName: string | null;
+    worktreePath: string | null;
+    issueType: 'branch' | 'issue' | 'pr' | null;
+    issue_numbers: string[];
+    pr_numbers: string[];
+    issueTracker: string | null;
+    colorHex: string | null;
+    sessionId: string | null;
+    projectPath: string | null;
+    parentLoom: {
+        type: 'issue' | 'pr' | 'branch';
+        identifier: string | number;
+        branchName: string;
+        worktreePath: string;
+        databaseBranch?: string;
+    } | null;
+}
+/**
+ * MetadataManager: Manage loom metadata persistence
+ *
+ * Stores loom metadata in ~/.config/iloom-ai/looms/ directory.
+ * Each worktree gets a JSON file named by slugifying its absolute path.
+ *
+ * Per spec section 2.2:
+ * - Filename derived from worktree absolute path
+ * - Path separators replaced with double underscores
+ * - Non-alphanumeric chars (except _ and -) replaced with hyphens
+ */
+declare class MetadataManager {
+    private readonly loomsDir;
+    constructor();
+    /**
+     * Convert worktree path to filename slug per spec section 2.2
+     *
+     * Algorithm:
+     * 1. Trim trailing slashes
+     * 2. Replace all path separators (/ or \) with __ (double underscore)
+     * 3. Replace any other non-alphanumeric characters (except _ and -) with -
+     * 4. Append .json
+     *
+     * Example:
+     * - Worktree: /Users/jane/dev/repo
+     * - Filename: _Users__jane__dev__repo.json
+     */
+    slugifyPath(worktreePath: string): string;
+    /**
+     * Get the full path to the metadata file for a worktree
+     */
+    private getFilePath;
+    /**
+     * Write metadata for a worktree (spec section 3.1)
+     *
+     * @param worktreePath - Absolute path to the worktree (used for file naming)
+     * @param input - Metadata to write (description plus additional fields)
+     */
+    writeMetadata(worktreePath: string, input: WriteMetadataInput): Promise<void>;
+    /**
+     * Read metadata for a worktree (spec section 3.2)
+     *
+     * @param worktreePath - Absolute path to the worktree
+     * @returns The metadata object with all fields, or null if not found/invalid
+     */
+    readMetadata(worktreePath: string): Promise<LoomMetadata | null>;
+    /**
+     * List all stored loom metadata files
+     *
+     * Returns an array of LoomMetadata objects for all valid metadata files
+     * in the looms directory. Invalid or unreadable files are skipped.
+     *
+     * @returns Array of LoomMetadata objects from all stored files
+     */
+    listAllMetadata(): Promise<LoomMetadata[]>;
+    /**
+     * Delete metadata for a worktree (spec section 3.3)
+     *
+     * Idempotent: silently succeeds if file doesn't exist
+     * Non-fatal: logs warning on permission errors but doesn't throw
+     *
+     * @param worktreePath - Absolute path to the worktree
+     */
+    deleteMetadata(worktreePath: string): Promise<void>;
+}
+
 /**
  * Execute a Git command and return the stdout result
  * Throws an error if the command fails
@@ -1503,6 +1743,7 @@ declare function executeGitCommand(args: string[], options?: {
     cwd?: string;
     timeout?: number;
     stdio?: 'inherit' | 'pipe';
+    env?: NodeJS.ProcessEnv;
 }): Promise<string>;
 /**
  * Parse git worktree list output into structured data
@@ -1580,6 +1821,19 @@ declare function findMainWorktreePath(path?: string, options?: {
  * @throws Error if main worktree cannot be found
  */
 declare function findMainWorktreePathWithSettings(path?: string, settingsManager?: SettingsManager): Promise<string>;
+/**
+ * Find the worktree path where a specific branch is checked out
+ *
+ * Used by MergeManager to find the correct worktree for child loom merges.
+ * When finishing a child loom, we need to find where the PARENT branch is
+ * checked out (the merge target), not where settings.mainBranch is checked out.
+ *
+ * @param branchName - The branch name to find
+ * @param path - Path to search from (defaults to process.cwd())
+ * @returns Path to worktree where the branch is checked out
+ * @throws Error if no worktree has the specified branch checked out
+ */
+declare function findWorktreeForBranch(branchName: string, path?: string): Promise<string>;
 /**
  * Check if there are uncommitted changes in a repository
  */
@@ -1642,6 +1896,82 @@ declare function isFileTrackedByGit(filePath: string, cwd?: string): Promise<boo
  * @returns true if file IS ignored, false if NOT ignored or on error
  */
 declare function isFileGitignored(filePath: string, cwd?: string): Promise<boolean>;
+/**
+ * Check if a branch is merged into the main branch
+ *
+ * Uses `git merge-base --is-ancestor` which is more reliable than `git branch -d`'s check.
+ * The `-d` flag checks against current HEAD, which can give false positives when:
+ * - Running from a worktree where main isn't checked out
+ * - Squash or rebase merges were used
+ *
+ * This function explicitly checks if the branch tip is an ancestor of the main branch,
+ * providing consistent results regardless of which worktree the command runs from.
+ *
+ * @param branchName - The branch to check
+ * @param mainBranch - The main branch to check against (defaults to 'main')
+ * @param cwd - Working directory (defaults to process.cwd())
+ * @returns true if branch is merged into main, false otherwise
+ */
+declare function isBranchMergedIntoMain(branchName: string, mainBranch?: string, cwd?: string): Promise<boolean>;
+/**
+ * Check if a branch exists on the remote (origin) and is up-to-date with local
+ * Useful for GitHub-PR workflows to ensure branch has been pushed and is current
+ *
+ * @param branchName - Name of the branch to check
+ * @param cwd - Working directory to run git command in
+ * @returns Promise<boolean> - true if remote branch exists and matches local HEAD, false otherwise
+ */
+declare function isRemoteBranchUpToDate(branchName: string, cwd: string): Promise<boolean>;
+/**
+ * Result of checking remote branch status for safety validation
+ */
+interface RemoteBranchStatus {
+    /** Whether the remote branch exists */
+    exists: boolean;
+    /** Whether the remote is ahead of local (has commits not present locally) */
+    remoteAhead: boolean;
+    /** Whether local is ahead of remote (has unpushed commits) */
+    localAhead: boolean;
+    /** Whether a network error occurred during the check */
+    networkError: boolean;
+    /** Error message if network error occurred */
+    errorMessage?: string;
+}
+/**
+ * Check the status of a remote branch for safety validation during cleanup
+ * This function provides detailed status needed for the 5-point safety check:
+ *
+ * The key insight: we care about DATA LOSS, not about remote state
+ * - Remote ahead of local is SAFE (commits exist on remote, no data loss)
+ * - Local ahead of remote is DANGEROUS (unpushed commits would be lost)
+ *
+ * 5-point safety logic:
+ * 1. Network error -> BLOCK (can't verify safety)
+ * 2. Remote ahead of local -> OK (no data loss - commits exist on remote)
+ * 3. Local ahead of remote (unpushed commits) -> BLOCK (data loss risk)
+ * 4. No remote, merged to main -> OK (work is in main)
+ * 5. No remote, NOT merged to main -> BLOCK (unmerged work would be lost)
+ *
+ * @param branchName - Name of the branch to check
+ * @param cwd - Working directory to run git command in
+ * @returns Promise<RemoteBranchStatus> - Detailed status of the remote branch
+ */
+declare function checkRemoteBranchStatus(branchName: string, cwd: string): Promise<RemoteBranchStatus>;
+/**
+ * Get the merge target branch for a loom
+ * Priority: parent loom metadata (parentLoom.branchName) > configured main branch > 'main'
+ *
+ * This is the shared utility for determining where a branch should merge to.
+ * Child looms merge to their parent branch, standalone looms merge to main.
+ *
+ * @param worktreePath - Path to load metadata/settings from (defaults to process.cwd())
+ * @param options - Optional dependency injection for testing
+ * @returns The branch name to merge into
+ */
+declare function getMergeTargetBranch(worktreePath?: string, options?: {
+    settingsManager?: SettingsManager;
+    metadataManager?: MetadataManager;
+}): Promise<string>;
 
 interface LoggerOptions {
     prefix?: string;
@@ -1658,9 +1988,16 @@ interface Logger {
     debug: (message: string, ...args: unknown[]) => void;
     setDebug: (enabled: boolean) => void;
     isDebugEnabled: () => boolean;
+    stdout: NodeJS.WriteStream;
 }
 declare const logger: Logger;
 declare function createLogger(options?: LoggerOptions): Logger;
+/**
+ * Creates a logger that redirects all output to stderr.
+ * Use this in JSON mode so progress messages don't pollute stdout.
+ * The JSON output can then be cleanly piped.
+ */
+declare function createStderrLogger(options?: LoggerOptions): Logger;
 
 /**
  * Utility class for converting HTML details/summary format to Linear's collapsible format
@@ -1811,4 +2148,4 @@ declare class TableFormatter {
     static previewFormatting(headers: string[], options?: TableFormatterOptions): string;
 }
 
-export { type AddIssueOptions, 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 EnvFileOptions, type EnvOperationResult, type EnvVariable, EnvironmentManager, type FeedbackOptions, type FinishOptions, 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, type PRWorktreePattern, type Platform, type PortAssignmentOptions, type ProcessInfo, type ProjectCapability, type PullRequest, type ResourceCleanupOptions, type RgbColor, type SafetyCheck, type StartOptions, 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, createLogger, ensureRepositoryHasCommits, executeGitCommand, extractIssueNumber, extractPRNumber, findAllBranchesForIssue, findMainWorktreePath, findMainWorktreePathWithSettings, generateWorktreePath, getCurrentBranch, getDefaultBranch, getRepoRoot, getWorktreeRoot, hasUncommittedChanges, isEmptyRepository, isFileGitignored, isFileTrackedByGit, isPRBranch, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote };
+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, 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, 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, findAllBranchesForIssue, findMainWorktreePath, findMainWorktreePathWithSettings, findWorktreeForBranch, generateWorktreePath, getCurrentBranch, getDefaultBranch, getMergeTargetBranch, getRepoRoot, getWorktreeRoot, hasUncommittedChanges, isBranchMergedIntoMain, isEmptyRepository, isFileGitignored, isFileTrackedByGit, isPRBranch, isRemoteBranchUpToDate, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote };