@iloom/cli 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -128,6 +128,7 @@ interface WorktreeCleanupOptions {
  */
 declare const IloomSettingsSchema: z.ZodObject<{
     mainBranch: z.ZodOptional<z.ZodString>;
+    sourceEnvOnStart: z.ZodDefault<z.ZodBoolean>;
     worktreePrefix: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
     protectedBranches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     workflows: z.ZodOptional<z.ZodObject<{
@@ -308,6 +309,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         } | undefined;
     }>>;
     issueManagement: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<["github", "linear"]>>>;
         github: z.ZodOptional<z.ZodObject<{
             remote: z.ZodString;
         }, "strip", z.ZodTypeAny, {
@@ -315,14 +317,39 @@ declare const IloomSettingsSchema: z.ZodObject<{
         }, {
             remote: string;
         }>>;
+        linear: z.ZodOptional<z.ZodObject<{
+            teamId: z.ZodString;
+            branchFormat: z.ZodOptional<z.ZodString>;
+            apiToken: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        }, {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
+        provider: "github" | "linear";
         github?: {
             remote: string;
         } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
     }, {
         github?: {
             remote: string;
         } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
+        provider?: "github" | "linear" | undefined;
     }>>;
     mergeBehavior: z.ZodOptional<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<["local", "github-pr"]>>;
@@ -334,7 +361,15 @@ declare const IloomSettingsSchema: z.ZodObject<{
         remote?: string | undefined;
         mode?: "local" | "github-pr" | undefined;
     }>>;
+    ide: z.ZodOptional<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<["vscode", "cursor", "webstorm", "sublime", "intellij", "windsurf"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf";
+    }, {
+        type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
+    sourceEnvOnStart: boolean;
     mainBranch?: string | undefined;
     worktreePrefix?: string | undefined;
     protectedBranches?: string[] | undefined;
@@ -382,16 +417,26 @@ declare const IloomSettingsSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
     issueManagement?: {
+        provider: "github" | "linear";
         github?: {
             remote: string;
         } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
     } | undefined;
     mergeBehavior?: {
         mode: "local" | "github-pr";
         remote?: string | undefined;
     } | undefined;
+    ide?: {
+        type: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf";
+    } | undefined;
 }, {
     mainBranch?: string | undefined;
+    sourceEnvOnStart?: boolean | undefined;
     worktreePrefix?: string | undefined;
     protectedBranches?: string[] | undefined;
     workflows?: {
@@ -441,11 +486,20 @@ declare const IloomSettingsSchema: z.ZodObject<{
         github?: {
             remote: string;
         } | undefined;
+        linear?: {
+            teamId: string;
+            branchFormat?: string | undefined;
+            apiToken?: string | undefined;
+        } | undefined;
+        provider?: "github" | "linear" | undefined;
     } | undefined;
     mergeBehavior?: {
         remote?: string | undefined;
         mode?: "local" | "github-pr" | undefined;
     } | undefined;
+    ide?: {
+        type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | undefined;
+    } | undefined;
 }>;
 /**
  * TypeScript type for iloom settings derived from Zod schema
@@ -456,10 +510,13 @@ type IloomSettings = z.infer<typeof IloomSettingsSchema>;
  */
 declare class SettingsManager {
     /**
-     * Load settings from <PROJECT_ROOT>/.iloom/settings.json and settings.local.json
-     * Merges settings.local.json over settings.json with priority
-     * CLI overrides have highest priority if provided
-     * Returns empty object if both files don't exist (not an error)
+     * Load settings from global, project, and local sources with proper precedence
+     * Merge hierarchy (lowest to highest priority):
+     * 1. Global settings (~/.config/iloom-ai/settings.json)
+     * 2. Project settings (<PROJECT_ROOT>/.iloom/settings.json)
+     * 3. Local settings (<PROJECT_ROOT>/.iloom/settings.local.json)
+     * 4. CLI overrides (--set flags)
+     * Returns empty object if all files don't exist (not an error)
      */
     loadSettings(projectRoot?: string, cliOverrides?: Partial<IloomSettings>): Promise<IloomSettings>;
     /**
@@ -469,6 +526,7 @@ declare class SettingsManager {
     /**
      * Load and parse a single settings file
      * Returns empty object if file doesn't exist (not an error)
+     * Uses non-defaulting schema to prevent polluting partial settings with defaults before merge
      */
     private loadSettingsFile;
     /**
@@ -490,6 +548,20 @@ declare class SettingsManager {
      * Get project root (defaults to process.cwd())
      */
     private getProjectRoot;
+    /**
+     * Get global config directory path (~/.config/iloom-ai)
+     */
+    private getGlobalConfigDir;
+    /**
+     * Get global settings file path (~/.config/iloom-ai/settings.json)
+     */
+    private getGlobalSettingsPath;
+    /**
+     * Load and parse global settings file
+     * Returns empty object if file doesn't exist (not an error)
+     * Warns but returns empty object on validation/parse errors (graceful degradation)
+     */
+    private loadGlobalSettingsFile;
     /**
      * Get effective protected branches list with mainBranch always included
      *
@@ -614,7 +686,7 @@ declare class GitWorktreeManager {
      * Avoids false matches like: tissue-44, myissue-44
      * Ports: find_existing_worktree() from bash script lines 131-165
      */
-    findWorktreeForIssue(issueNumber: number): Promise<GitWorktree | null>;
+    findWorktreeForIssue(issueNumber: string | number): Promise<GitWorktree | null>;
     /**
      * Find worktree for a specific PR by branch name
      * Ports: find_existing_worktree() for PR type from bash script lines 149-160
@@ -652,6 +724,22 @@ declare class GitWorktreeManager {
     };
 }
 
+/**
+ * Strategy interface for generating branch names from issue information
+ */
+interface BranchNameStrategy {
+    generate(issueNumber: string | number, title: string): Promise<string>;
+}
+/**
+ * Options for branch name generation
+ * Supports both simple generation and custom strategy override
+ */
+interface BranchGenerationOptions {
+    issueNumber: string | number;
+    title: string;
+    strategy?: BranchNameStrategy;
+}
+
 interface EnvVariable {
     key: string;
     value: string;
@@ -671,7 +759,7 @@ interface EnvOperationResult {
 }
 interface PortAssignmentOptions {
     basePort?: number;
-    issueNumber?: number;
+    issueNumber?: string | number;
     prNumber?: number;
     branchName?: string;
 }
@@ -688,7 +776,7 @@ interface Loom {
     databaseBranch?: string;
     createdAt: Date;
     lastAccessed: Date;
-    githubData?: {
+    issueData?: {
         title?: string;
         body?: string;
         url?: string;
@@ -703,6 +791,13 @@ interface CreateLoomInput {
     identifier: string | number;
     originalInput: string;
     baseBranch?: string;
+    parentLoom?: {
+        type: 'issue' | 'pr' | 'branch';
+        identifier: string | number;
+        branchName: string;
+        worktreePath: string;
+        databaseBranch?: string;
+    };
     options?: {
         skipDatabase?: boolean;
         skipColorSync?: boolean;
@@ -713,6 +808,7 @@ interface CreateLoomInput {
         oneShot?: OneShotMode;
         setArguments?: string[];
         executablePath?: string;
+        sourceEnvOnStart?: boolean;
     };
 }
 type LaunchMode = 'editor' | 'terminal' | 'both';
@@ -812,7 +908,7 @@ interface BranchCleanupTarget {
  */
 interface BatchCleanupResult {
     /** Issue number that was cleaned up */
-    issueNumber: number;
+    issueNumber: string | number;
     /** Number of branches found matching the issue */
     targetsFound: number;
     /** Number of worktrees successfully removed */
@@ -845,7 +941,7 @@ interface Workspace {
     id: string;
     path: string;
     branch: string;
-    issueNumber?: number;
+    issueNumber?: string | number;
     prNumber?: number;
     port: number;
     databaseBranch?: string;
@@ -859,7 +955,7 @@ interface WorkspaceInput {
 }
 interface WorkspaceSummary {
     id: string;
-    issueNumber?: number;
+    issueNumber?: string | number;
     prNumber?: number;
     title: string;
     branch: string;
@@ -873,7 +969,7 @@ interface Worktree {
     commit: string;
     isPR: boolean;
     prNumber?: number;
-    issueNumber?: number;
+    issueNumber?: string | number;
     port?: number;
 }
 interface GitStatus {
@@ -885,7 +981,7 @@ interface GitStatus {
     isBehindRemote: boolean;
 }
 interface Issue {
-    number: number;
+    number: string | number;
     title: string;
     body: string;
     state: 'open' | 'closed';
@@ -903,6 +999,16 @@ interface PullRequest {
     url: string;
     isDraft: boolean;
 }
+/**
+ * Generic input detection result for issue trackers
+ * String-based identifier to support non-numeric IDs (e.g., Linear "ENG-123")
+ */
+interface IssueTrackerInputDetection {
+    type: 'issue' | 'pr' | 'unknown';
+    identifier: string | null;
+    rawInput: string;
+}
+
 /**
  * Result of database branch deletion operation
  * Distinguishes between successful deletion, branch not found, and errors
@@ -947,11 +1053,14 @@ interface StartOptions {
     code?: boolean;
     devServer?: boolean;
     terminal?: boolean;
+    childLoom?: boolean;
     oneShot?: OneShotMode;
+    body?: string;
 }
 interface AddIssueOptions {
 }
 interface FeedbackOptions {
+    body?: string;
 }
 interface EnhanceOptions {
     noBrowser?: boolean;
@@ -1020,7 +1129,7 @@ interface ValidationResult {
 }
 interface CommitOptions {
     dryRun?: boolean;
-    issueNumber?: number;
+    issueNumber?: string | number;
     message?: string;
     noReview?: boolean;
     skipVerify?: boolean;
@@ -1048,30 +1157,43 @@ interface UpdateCheckResult {
 }
 type InstallationMethod = 'global' | 'local' | 'linked' | 'unknown';
 
-interface GitHubInputDetection {
-    type: 'issue' | 'pr' | 'unknown';
-    number: number | null;
-    rawInput: string;
-}
-interface BranchNameStrategy {
-    generate(issueNumber: number, title: string): Promise<string>;
-}
-interface BranchGenerationOptions {
-    issueNumber: number;
-    title: string;
-    strategy?: BranchNameStrategy;
+/**
+ * IssueTracker interface - abstraction for issue tracking providers
+ * Follows DatabaseProvider pattern from src/types/index.ts:94-111
+ *
+ * Design Philosophy:
+ * - Core methods are required and work with generic Issue/PullRequest types
+ * - PR methods are optional (not all trackers have PR concepts)
+ * - Identifiers use string | number to support both GitHub (#123) and Linear (ENG-123)
+ * - Providers expose capabilities via boolean flags (supportsPullRequests, etc.)
+ */
+interface IssueTracker {
+    readonly providerName: string;
+    readonly supportsPullRequests: boolean;
+    detectInputType(input: string, repo?: string): Promise<IssueTrackerInputDetection>;
+    fetchIssue(identifier: string | number, repo?: string): Promise<Issue>;
+    isValidIssue(identifier: string | number, repo?: string): Promise<Issue | false>;
+    validateIssueState(issue: Issue): Promise<void>;
+    createIssue(title: string, body: string, repository?: string, labels?: string[]): Promise<{
+        number: string | number;
+        url: string;
+    }>;
+    getIssueUrl(identifier: string | number, repo?: string): Promise<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>;
+    extractContext(entity: Issue | PullRequest): string;
 }
 
-declare class GitHubService {
-    private defaultBranchNameStrategy;
+declare class GitHubService implements IssueTracker {
+    readonly providerName = "github";
+    readonly supportsPullRequests = true;
     private prompter;
     constructor(options?: {
-        branchNameStrategy?: BranchNameStrategy;
-        useClaude?: boolean;
-        claudeModel?: string;
         prompter?: (message: string) => Promise<boolean>;
     });
-    detectInputType(input: string, repo?: string): Promise<GitHubInputDetection>;
+    detectInputType(input: string, repo?: string): Promise<IssueTrackerInputDetection>;
     fetchIssue(issueNumber: number, repo?: string): Promise<Issue>;
     isValidIssue(issueNumber: number, repo?: string): Promise<Issue | false>;
     private fetchIssueInternal;
@@ -1080,9 +1202,8 @@ declare class GitHubService {
     isValidPR(prNumber: number, repo?: string): Promise<PullRequest | false>;
     private fetchPRInternal;
     validatePRState(pr: PullRequest): Promise<void>;
-    generateBranchName(options: BranchGenerationOptions): Promise<string>;
     createIssue(title: string, body: string, repository?: string, labels?: string[]): Promise<{
-        number: number;
+        number: string | number;
         url: string;
     }>;
     getIssueUrl(issueNumber: number, repo?: string): Promise<string>;
@@ -1092,8 +1213,35 @@ declare class GitHubService {
     private mapGitHubIssueToIssue;
     private mapGitHubPRToPullRequest;
     private promptUserConfirmation;
-    setDefaultBranchNameStrategy(strategy: BranchNameStrategy): void;
-    getBranchNameStrategy(): BranchNameStrategy;
+}
+
+type IssueTrackerProviderType = 'github' | 'linear';
+/**
+ * Factory for creating IssueTracker instances based on settings
+ * Provides a single point of provider instantiation
+ *
+ * Usage:
+ *   const tracker = IssueTrackerFactory.create(settings, { useClaude: true })
+ *   const issue = await tracker.fetchIssue(123)
+ */
+declare class IssueTrackerFactory {
+    /**
+     * Create an IssueTracker instance based on settings configuration
+     * Defaults to GitHub if no provider specified
+     *
+     * @param settings - iloom settings containing issueManagement.provider
+     * @returns IssueTracker instance configured for the specified provider
+     * @throws Error if provider type is not supported
+     */
+    static create(settings: IloomSettings): IssueTracker;
+    /**
+     * Get the configured provider name from settings
+     * Defaults to 'github' if not configured
+     *
+     * @param settings - iloom settings
+     * @returns Provider type string
+     */
+    static getProviderName(settings: IloomSettings): IssueTrackerProviderType;
 }
 
 declare class EnvironmentManager {
@@ -1108,6 +1256,11 @@ declare class EnvironmentManager {
      * Read and parse a .env file
      */
     readEnvFile(filePath: string): Promise<Map<string, string>>;
+    /**
+     * Get a specific environment variable from a .env file
+     * Returns null if file doesn't exist or variable is not found
+     */
+    getEnvVariable(filePath: string, variableName: string): Promise<string | null>;
     /**
      * Generic file copy helper that only copies if source exists
      * Does not throw if source file doesn't exist - just logs and returns
@@ -1124,7 +1277,7 @@ declare class EnvironmentManager {
     /**
      * Set port environment variable for workspace
      */
-    setPortForWorkspace(envFilePath: string, issueNumber?: number, prNumber?: number, branchName?: string): Promise<number>;
+    setPortForWorkspace(envFilePath: string, issueNumber?: string | number, prNumber?: number, branchName?: string): Promise<number>;
     /**
      * Validate environment configuration
      */
@@ -1169,8 +1322,9 @@ declare class DatabaseManager {
      * @param branchName - Name of the branch to create
      * @param envFilePath - Path to .env file for configuration checks
      * @param cwd - Optional working directory to run commands from
+     * @param fromBranch - Optional parent branch to create from (for child looms)
      */
-    createBranchIfConfigured(branchName: string, envFilePath: string, cwd?: string): Promise<string | null>;
+    createBranchIfConfigured(branchName: string, envFilePath: string, cwd?: string, fromBranch?: string): Promise<string | null>;
     /**
      * Delete database branch only if configured
      * Returns result object indicating what happened
@@ -1181,6 +1335,14 @@ declare class DatabaseManager {
      * @param cwd - Optional working directory to run commands from (prevents issues with deleted directories)
      */
     deleteBranchIfConfigured(branchName: string, shouldCleanup: boolean, isPreview?: boolean, cwd?: string): Promise<DatabaseDeletionResult>;
+    /**
+     * Get database branch name from connection string (reverse lookup)
+     * Returns branch name if provider supports reverse lookup, null otherwise
+     *
+     * @param connectionString - Database connection string
+     * @param cwd - Optional working directory to run commands from
+     */
+    getBranchNameFromConnectionString(connectionString: string, cwd?: string): Promise<string | null>;
     /**
      * Check if .env has the configured database URL variable
      * CRITICAL: If user explicitly configured a custom variable name (not default),
@@ -1190,7 +1352,7 @@ declare class DatabaseManager {
 }
 
 interface TemplateVariables {
-    ISSUE_NUMBER?: number;
+    ISSUE_NUMBER?: string | number;
     PR_NUMBER?: number;
     ISSUE_TITLE?: string;
     PR_TITLE?: string;
@@ -1198,6 +1360,7 @@ interface TemplateVariables {
     PORT?: number;
     ONE_SHOT_MODE?: boolean;
     SETTINGS_SCHEMA?: string;
+    SETTINGS_GLOBAL_JSON?: string;
     SETTINGS_JSON?: string;
     SETTINGS_LOCAL_JSON?: string;
     SHELL_TYPE?: string;
@@ -1239,7 +1402,7 @@ declare class PromptTemplateManager {
 
 interface ClaudeWorkflowOptions {
     type: 'issue' | 'pr' | 'regular';
-    issueNumber?: number;
+    issueNumber?: string | number;
     prNumber?: number;
     title?: string;
     workspacePath: string;
@@ -1271,10 +1434,6 @@ declare class ClaudeService {
      * Launch Claude for a specific workflow
      */
     launchForWorkflow(options: ClaudeWorkflowOptions): Promise<string | void>;
-    /**
-     * Generate branch name with Claude, with fallback on failure
-     */
-    generateBranchNameWithFallback(issueTitle: string, issueNumber: number): Promise<string>;
 }
 
 interface ClaudeContext {
@@ -1325,6 +1484,12 @@ declare function isPRBranch(branchName: string): boolean;
  * Extract PR number from branch name
  */
 declare function extractPRNumber(branchName: string): number | null;
+/**
+ * Extract issue number from branch name
+ * Supports both new format (issue-{issueId}__{slug}) and old format (issue-{number}-{slug})
+ * @returns string issue ID (alphanumeric) or null if not found
+ */
+declare function extractIssueNumber(branchName: string): string | null;
 /**
  * Check if a path follows worktree naming patterns
  */
@@ -1395,7 +1560,7 @@ declare function getDefaultBranch(path?: string): Promise<string>;
  * @param path - Working directory to search from (defaults to process.cwd())
  * @param settingsManager - Optional SettingsManager instance (for DI/testing)
  */
-declare function findAllBranchesForIssue(issueNumber: number, path?: string, settingsManager?: SettingsManager): Promise<string[]>;
+declare function findAllBranchesForIssue(issueNumber: string | number, path?: string, settingsManager?: SettingsManager): Promise<string[]>;
 /**
  * Check if a repository is empty (has no commits yet)
  * @param path - Repository path to check (defaults to process.cwd())
@@ -1440,4 +1605,153 @@ interface Logger {
 declare const logger: Logger;
 declare function createLogger(options?: LoggerOptions): Logger;
 
-export { type AddIssueOptions, type BatchCleanupResult, type BranchCleanupTarget, type BranchDeleteOptions, 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 LaunchMode, 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, type UpdateCheckCache, type UpdateCheckResult, 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, extractPRNumber, findAllBranchesForIssue, findMainWorktreePath, findMainWorktreePathWithSettings, generateWorktreePath, getCurrentBranch, getDefaultBranch, getRepoRoot, hasUncommittedChanges, isEmptyRepository, isPRBranch, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote };
+/**
+ * Utility class for converting HTML details/summary format to Linear's collapsible format
+ *
+ * Converts:
+ * <details>
+ * <summary>Header</summary>
+ * CONTENT
+ * </details>
+ *
+ * Into Linear format:
+ * +++ Header
+ *
+ * CONTENT
+ *
+ * +++
+ */
+declare class LinearMarkupConverter {
+    /**
+     * Convert HTML details/summary blocks to Linear's collapsible format
+     * Handles nested details blocks recursively
+     *
+     * @param text - Text containing HTML details/summary blocks
+     * @returns Text with details/summary converted to Linear format
+     */
+    static convertDetailsToLinear(text: string): string;
+    /**
+     * Perform a single pass of details block conversion
+     * Converts the innermost details blocks first
+     */
+    private static convertSinglePass;
+    /**
+     * Clean text by trimming whitespace and decoding common HTML entities
+     */
+    private static cleanText;
+    /**
+     * Clean content while preserving internal structure
+     * - Removes leading/trailing whitespace
+     * - Normalizes internal blank lines (max 2 consecutive newlines)
+     * - Preserves code blocks and other formatting
+     */
+    private static cleanContent;
+    /**
+     * Check if text contains HTML details/summary blocks
+     * Useful for conditional conversion
+     */
+    static hasDetailsBlocks(text: string): boolean;
+    /**
+     * Remove wrapper tags from code sample details blocks
+     * Identifies details blocks where summary contains "X lines" pattern
+     * and removes the details/summary tags while preserving the content
+     *
+     * @param text - Text containing potential code sample details blocks
+     * @returns Text with code sample wrappers removed
+     */
+    static removeCodeSampleWrappers(text: string): string;
+    /**
+     * Convert text for Linear - applies all necessary conversions
+     * Currently only converts details/summary blocks, but can be extended
+     * for other HTML to Linear markdown conversions
+     */
+    static convertToLinear(text: string): string;
+    /**
+     * Log conversion input/output if LINEAR_MARKDOWN_LOG_FILE is set
+     */
+    private static logConversion;
+    /**
+     * Generate timestamped log file path
+     * Example: debug.log -> debug-20231202-161234.log
+     */
+    private static getTimestampedLogPath;
+}
+
+/**
+ * Table formatting utilities for creating markdown tables with controlled column widths
+ * Uses &nbsp; entities to force minimum column widths in markdown renderers like Linear
+ */
+interface TableFormatterOptions {
+    /** Target total width across all headers (default: 140) */
+    targetTotalWidth?: number;
+    /** Padding character to use (default: '&nbsp;') */
+    paddingChar?: string;
+    /** Maximum number of padding entities per column (default: 16) */
+    maxPadding?: number;
+}
+interface TableGenerationOptions extends TableFormatterOptions {
+    /** Table headers */
+    headers: string[];
+    /** Table rows data */
+    rows: string[][];
+}
+declare class TableFormatter {
+    private static readonly DEFAULT_TARGET_WIDTH;
+    private static readonly DEFAULT_PADDING_CHAR;
+    private static readonly DEFAULT_MAX_PADDING;
+    /**
+     * Pad table headers to achieve equal column widths
+     * @param headers Array of header text
+     * @param options Formatting options
+     * @returns Array of padded headers
+     */
+    static padHeaders(headers: string[], options?: TableFormatterOptions): string[];
+    /**
+     * Generate a complete markdown table with padded headers
+     * @param options Table generation options
+     * @returns Complete markdown table string
+     */
+    static generateTable(options: TableGenerationOptions): string;
+    /**
+     * Calculate the optimal width distribution for given headers
+     * @param headers Array of header text
+     * @param targetTotalWidth Target total width
+     * @param maxPadding Maximum padding entities per column
+     * @returns Width distribution information
+     */
+    static calculateWidthDistribution(headers: string[], targetTotalWidth?: number, maxPadding?: number): {
+        totalWidth: number;
+        widthPerColumn: number;
+        headers: Array<{
+            text: string;
+            currentLength: number;
+            targetLength: number;
+            paddingNeeded: number;
+            paddingUsed: number;
+        }>;
+    };
+    /**
+     * Create a simple two-column assessment table (common pattern)
+     * @param assessmentData Array of [question, answer] pairs
+     * @param options Formatting options
+     * @returns Formatted markdown table
+     */
+    static createAssessmentTable(assessmentData: Array<[string, string]>, options?: TableFormatterOptions): string;
+    /**
+     * Create a three-column status table (common pattern)
+     * @param statusData Array of [task, status, assignee] tuples
+     * @param options Formatting options
+     * @returns Formatted markdown table
+     */
+    static createStatusTable(statusData: Array<[string, string, string]>, options?: TableFormatterOptions): string;
+    /**
+     * Preview table formatting without generating full markdown
+     * Useful for debugging and development
+     * @param headers Array of header text
+     * @param options Formatting options
+     * @returns Human-readable formatting preview
+     */
+    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, 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, hasUncommittedChanges, isEmptyRepository, isPRBranch, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote };