@iloom/cli 0.1.17 → 0.1.19

package/dist/index.d.ts

@@ -123,683 +123,6 @@ interface WorktreeCleanupOptions {
     dryRun?: boolean;
 }
 
-/**
- * Manages Git worktrees for the iloom CLI
- * Ports functionality from bash scripts into TypeScript
- */
-declare class GitWorktreeManager {
-    private readonly _workingDirectory;
-    constructor(workingDirectory?: string);
-    /**
-     * Get the working directory for git operations (main worktree path)
-     */
-    get workingDirectory(): string;
-    /**
-     * List all worktrees in the repository
-     * Defaults to porcelain format for reliable machine parsing
-     * Equivalent to: git worktree list --porcelain
-     */
-    listWorktrees(options?: WorktreeListOptions): Promise<GitWorktree[]>;
-    /**
-     * Find worktree for a specific branch
-     * Ports: find_worktree_for_branch() from find-worktree-for-branch.sh
-     */
-    findWorktreeForBranch(branchName: string): Promise<GitWorktree | null>;
-    /**
-     * Check if a worktree is the main repository worktree
-     * The main worktree is the first one listed by git worktree list (Git guarantee)
-     * This cannot be determined by path comparison because --show-toplevel returns
-     * the same value for all worktrees.
-     */
-    isMainWorktree(worktree: GitWorktree): Promise<boolean>;
-    /**
-     * Check if a worktree is a PR worktree based on naming patterns
-     * Ports: is_pr_worktree() from worktree-utils.sh
-     */
-    isPRWorktree(worktree: GitWorktree): boolean;
-    /**
-     * Get PR number from worktree branch name
-     * Ports: get_pr_number_from_worktree() from worktree-utils.sh
-     */
-    getPRNumberFromWorktree(worktree: GitWorktree): number | null;
-    /**
-     * Create a new worktree
-     * Ports worktree creation logic from new-branch-workflow.sh
-     * @returns The absolute path to the created worktree
-     */
-    createWorktree(options: WorktreeCreateOptions): Promise<string>;
-    /**
-     * Remove a worktree and optionally clean up associated files
-     * Ports worktree removal logic from cleanup-worktree.sh
-     * @returns A message describing what was done (for dry-run mode)
-     */
-    removeWorktree(worktreePath: string, options?: WorktreeCleanupOptions): Promise<string | void>;
-    /**
-     * Validate worktree state and integrity
-     */
-    validateWorktree(worktreePath: string): Promise<WorktreeValidation>;
-    /**
-     * Get detailed status information for a worktree
-     */
-    getWorktreeStatus(worktreePath: string): Promise<WorktreeStatus>;
-    /**
-     * Generate a suggested worktree path for a branch
-     */
-    generateWorktreePath(branchName: string, customRoot?: string, options?: {
-        isPR?: boolean;
-        prNumber?: number;
-        prefix?: string;
-    }): string;
-    /**
-     * Sanitize a branch name for use as a directory name
-     * Replaces slashes with dashes and removes invalid filesystem characters
-     * Ports logic from bash script line 593: ${BRANCH_NAME//\\//-}
-     */
-    sanitizeBranchName(branchName: string): string;
-    /**
-     * Check if repository is in a valid state for worktree operations
-     */
-    isRepoReady(): Promise<boolean>;
-    /**
-     * Get repository information
-     */
-    getRepoInfo(): Promise<{
-        root: string | null;
-        defaultBranch: string;
-        currentBranch: string | null;
-    }>;
-    /**
-     * Prune stale worktree entries (worktrees that no longer exist on disk)
-     */
-    pruneWorktrees(): Promise<void>;
-    /**
-     * Lock a worktree to prevent it from being pruned or moved
-     */
-    lockWorktree(worktreePath: string, reason?: string): Promise<void>;
-    /**
-     * Unlock a previously locked worktree
-     */
-    unlockWorktree(worktreePath: string): Promise<void>;
-    /**
-     * Find worktrees matching an identifier (branch name, path, or PR number)
-     */
-    findWorktreesByIdentifier(identifier: string): Promise<GitWorktree[]>;
-    /**
-     * Find worktree for a specific issue number using exact pattern matching
-     * Matches: issue-{N} at start OR after /, -, _ (but NOT issue-{N}X where X is a digit)
-     * Supports patterns like: issue-44, feat/issue-44-feature, feat-issue-44, bugfix_issue-44, etc.
-     * Avoids false matches like: tissue-44, myissue-44
-     * Ports: find_existing_worktree() from bash script lines 131-165
-     */
-    findWorktreeForIssue(issueNumber: number): Promise<GitWorktree | null>;
-    /**
-     * Find worktree for a specific PR by branch name
-     * Ports: find_existing_worktree() for PR type from bash script lines 149-160
-     */
-    findWorktreeForPR(prNumber: number, branchName: string): Promise<GitWorktree | null>;
-    /**
-     * Remove multiple worktrees
-     * Returns a summary of successes and failures
-     * Automatically filters out the main worktree
-     */
-    removeWorktrees(worktrees: GitWorktree[], options?: WorktreeCleanupOptions): Promise<{
-        successes: Array<{
-            worktree: GitWorktree;
-        }>;
-        failures: Array<{
-            worktree: GitWorktree;
-            error: string;
-        }>;
-        skipped: Array<{
-            worktree: GitWorktree;
-            reason: string;
-        }>;
-    }>;
-    /**
-     * Format worktree information for display
-     */
-    formatWorktree(worktree: GitWorktree): {
-        title: string;
-        path: string;
-        commit: string;
-    };
-}
-
-interface EnvVariable {
-    key: string;
-    value: string;
-}
-interface EnvFileOptions {
-    path: string;
-    backup?: boolean;
-    encoding?: BufferEncoding;
-}
-/**
- * @deprecated Use exception-based error handling instead
- */
-interface EnvOperationResult {
-    success: boolean;
-    backupPath?: string;
-    error?: string;
-}
-interface PortAssignmentOptions {
-    basePort?: number;
-    issueNumber?: number;
-    prNumber?: number;
-    branchName?: string;
-}
-
-type ProjectCapability = 'cli' | 'web';
-type Capability = ProjectCapability;
-interface Loom {
-    id: string;
-    path: string;
-    branch: string;
-    type: 'issue' | 'pr' | 'branch';
-    identifier: string | number;
-    port: number;
-    databaseBranch?: string;
-    createdAt: Date;
-    lastAccessed: Date;
-    githubData?: {
-        title?: string;
-        body?: string;
-        url?: string;
-        state?: string;
-    };
-    capabilities?: ProjectCapability[];
-    binEntries?: Record<string, string>;
-    cliSymlinks?: string[];
-}
-interface CreateLoomInput {
-    type: 'issue' | 'pr' | 'branch';
-    identifier: string | number;
-    originalInput: string;
-    baseBranch?: string;
-    options?: {
-        skipDatabase?: boolean;
-        skipColorSync?: boolean;
-        enableClaude?: boolean;
-        enableCode?: boolean;
-        enableDevServer?: boolean;
-        enableTerminal?: boolean;
-        oneShot?: OneShotMode;
-        setArguments?: string[];
-        executablePath?: string;
-    };
-}
-type LaunchMode = 'editor' | 'terminal' | 'both';
-interface LoomSummary {
-    id: string;
-    type: 'issue' | 'pr' | 'branch';
-    identifier: string | number;
-    title?: string;
-    branch: string;
-    port: number;
-    status: 'active' | 'stale' | 'error';
-    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: 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
- */
-interface ProcessInfo {
-    /** Process ID */
-    pid: number;
-    /** Process name (e.g., "node", "pnpm") */
-    name: string;
-    /** Full command line */
-    command: string;
-    /** Port the process is listening on */
-    port: number;
-    /** Whether this appears to be a dev server */
-    isDevServer: boolean;
-}
-
-interface Workspace {
-    id: string;
-    path: string;
-    branch: string;
-    issueNumber?: number;
-    prNumber?: number;
-    port: number;
-    databaseBranch?: string;
-    createdAt: Date;
-    lastAccessed: Date;
-}
-interface WorkspaceInput {
-    identifier: string;
-    type: 'issue' | 'pr' | 'branch';
-    skipClaude?: boolean;
-}
-interface WorkspaceSummary {
-    id: string;
-    issueNumber?: number;
-    prNumber?: number;
-    title: string;
-    branch: string;
-    port: number;
-    status: 'active' | 'stale' | 'error';
-    lastAccessed: string;
-}
-interface Worktree {
-    path: string;
-    branch: string;
-    commit: string;
-    isPR: boolean;
-    prNumber?: number;
-    issueNumber?: number;
-    port?: number;
-}
-interface GitStatus {
-    hasUncommittedChanges: boolean;
-    unstagedFiles: string[];
-    stagedFiles: string[];
-    currentBranch: string;
-    isAheadOfRemote: boolean;
-    isBehindRemote: boolean;
-}
-interface Issue {
-    number: number;
-    title: string;
-    body: string;
-    state: 'open' | 'closed';
-    labels: string[];
-    assignees: string[];
-    url: string;
-}
-interface PullRequest {
-    number: number;
-    title: string;
-    body: string;
-    state: 'open' | 'closed' | 'merged';
-    branch: string;
-    baseBranch: string;
-    url: string;
-    isDraft: boolean;
-}
-/**
- * Result of database branch deletion operation
- * Distinguishes between successful deletion, branch not found, and errors
- */
-interface DatabaseDeletionResult {
-    /** Overall operation succeeded (true even if branch didn't exist) */
-    success: boolean;
-    /** True only if a branch was actually deleted */
-    deleted: boolean;
-    /** True if branch didn't exist (not an error, just nothing to do) */
-    notFound: boolean;
-    /** Error message if operation failed */
-    error?: string;
-    /** User declined deletion (for preview databases) */
-    userDeclined?: boolean;
-    /** Name of the branch that was processed */
-    branchName?: string;
-}
-interface DatabaseProvider {
-    createBranch(name: string, fromBranch?: string, cwd?: string): Promise<string>;
-    deleteBranch(name: string, isPreview?: boolean, cwd?: string): Promise<DatabaseDeletionResult>;
-    getConnectionString(branch: string, cwd?: string): Promise<string>;
-    listBranches(cwd?: string): Promise<string[]>;
-    branchExists(name: string, cwd?: string): Promise<boolean>;
-    findPreviewBranch(branchName: string, cwd?: string): Promise<string | null>;
-    getBranchNameFromEndpoint(endpointId: string, cwd?: string): Promise<string | null>;
-    sanitizeBranchName(branchName: string): string;
-    isAuthenticated(cwd?: string): Promise<boolean>;
-    isCliAvailable(): Promise<boolean>;
-    isConfigured(): boolean;
-}
-interface Config {
-    defaultPort: number;
-    databaseProvider?: 'neon' | 'supabase' | 'planetscale';
-    claudeModel?: 'opus' | 'sonnet' | 'haiku';
-    skipClaude?: boolean;
-    customWorkspaceRoot?: string;
-}
-type OneShotMode = 'default' | 'noReview' | 'bypassPermissions';
-interface StartOptions {
-    claude?: boolean;
-    code?: boolean;
-    devServer?: boolean;
-    terminal?: boolean;
-    oneShot?: OneShotMode;
-}
-interface AddIssueOptions {
-}
-interface FeedbackOptions {
-}
-interface EnhanceOptions {
-    noBrowser?: boolean;
-}
-interface FinishOptions {
-    force?: boolean;
-    dryRun?: boolean;
-    pr?: number;
-    skipBuild?: boolean;
-}
-/**
- * Options for the cleanup command
- * All flags are optional and can be combined (subject to validation)
- */
-interface CleanupOptions {
-    /** List all worktrees without removing anything */
-    list?: boolean;
-    /** Remove all worktrees (interactive confirmation required unless --force) */
-    all?: boolean;
-    /** Cleanup by specific issue number */
-    issue?: number;
-    /** Skip confirmations and force removal */
-    force?: boolean;
-    /** Show what would be done without actually doing it */
-    dryRun?: boolean;
-}
-interface ListOptions {
-    json?: boolean;
-}
-interface MockOptions {
-    scenario: 'empty' | 'existing' | 'conflicts' | 'error';
-    data?: unknown;
-}
-
-interface RgbColor {
-    r: number;
-    g: number;
-    b: number;
-}
-interface ColorData {
-    rgb: RgbColor;
-    hex: string;
-    index: number;
-}
-type Platform = 'darwin' | 'linux' | 'win32' | 'unsupported';
-interface ValidationOptions {
-    dryRun?: boolean;
-    skipTypecheck?: boolean;
-    skipLint?: boolean;
-    skipTests?: boolean;
-}
-interface ValidationStepResult {
-    step: 'typecheck' | 'lint' | 'test';
-    passed: boolean;
-    skipped: boolean;
-    output?: string;
-    error?: string;
-    duration?: number;
-}
-interface ValidationResult {
-    success: boolean;
-    steps: ValidationStepResult[];
-    totalDuration: number;
-}
-interface CommitOptions {
-    dryRun?: boolean;
-    issueNumber?: number;
-    message?: string;
-    noReview?: boolean;
-    skipVerify?: boolean;
-}
-interface MergeOptions {
-    dryRun?: boolean;
-    force?: boolean;
-    repoRoot?: string;
-}
-interface MergeResult {
-    success: boolean;
-    branchName: string;
-    commitsMerged: number;
-    rebaseCompleted: boolean;
-    mergeCompleted: boolean;
-}
-interface UpdateCheckCache {
-    lastCheck: number;
-    latestVersion: string;
-}
-interface UpdateCheckResult {
-    currentVersion: string;
-    latestVersion: string;
-    updateAvailable: boolean;
-}
-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;
-}
-
-declare class GitHubService {
-    private defaultBranchNameStrategy;
-    private prompter;
-    constructor(options?: {
-        branchNameStrategy?: BranchNameStrategy;
-        useClaude?: boolean;
-        claudeModel?: string;
-        prompter?: (message: string) => Promise<boolean>;
-    });
-    detectInputType(input: string): Promise<GitHubInputDetection>;
-    fetchIssue(issueNumber: number): Promise<Issue>;
-    isValidIssue(issueNumber: number): Promise<Issue | false>;
-    private fetchIssueInternal;
-    validateIssueState(issue: Issue): Promise<void>;
-    fetchPR(prNumber: number): Promise<PullRequest>;
-    isValidPR(prNumber: number): 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;
-        url: string;
-    }>;
-    getIssueUrl(issueNumber: number, repo?: string): Promise<string>;
-    moveIssueToInProgress(issueNumber: number): Promise<void>;
-    private updateIssueStatusInProject;
-    extractContext(entity: Issue | PullRequest): string;
-    private mapGitHubIssueToIssue;
-    private mapGitHubPRToPullRequest;
-    private promptUserConfirmation;
-    setDefaultBranchNameStrategy(strategy: BranchNameStrategy): void;
-    getBranchNameStrategy(): BranchNameStrategy;
-}
-
-declare class EnvironmentManager {
-    private readonly backupSuffix;
-    /**
-     * Set or update an environment variable in a .env file
-     * Ports functionality from bash/utils/env-utils.sh:setEnvVar()
-     * @returns The backup path if a backup was created
-     */
-    setEnvVar(filePath: string, key: string, value: string, backup?: boolean): Promise<string | void>;
-    /**
-     * Read and parse a .env file
-     */
-    readEnvFile(filePath: string): Promise<Map<string, string>>;
-    /**
-     * Generic file copy helper that only copies if source exists
-     * Does not throw if source file doesn't exist - just logs and returns
-     * @private
-     */
-    copyIfExists(source: string, destination: string): Promise<void>;
-    /**
-     * Calculate unique port for workspace
-     * Implements:
-     * - Issue/PR: 3000 + issue/PR number
-     * - Branch: 3000 + deterministic hash offset (1-999)
-     */
-    calculatePort(options: PortAssignmentOptions): number;
-    /**
-     * Set port environment variable for workspace
-     */
-    setPortForWorkspace(envFilePath: string, issueNumber?: number, prNumber?: number, branchName?: string): Promise<number>;
-    /**
-     * Validate environment configuration
-     */
-    validateEnvFile(filePath: string): Promise<{
-        valid: boolean;
-        errors: string[];
-    }>;
-    /**
-     * Create backup of existing file
-     */
-    private createBackup;
-}
-
-/**
- * Database Manager - orchestrates database operations with conditional execution
- * Ports functionality from bash scripts with guard conditions:
- *   1. Database provider must be properly configured (provider.isConfigured())
- *   2. The worktree's .env file must contain the configured database URL variable (default: DATABASE_URL)
- *
- * This ensures database branching only occurs for projects that actually use databases
- */
-declare class DatabaseManager {
-    private provider;
-    private environment;
-    private databaseUrlEnvVarName;
-    constructor(provider: DatabaseProvider, environment: EnvironmentManager, databaseUrlEnvVarName?: string);
-    /**
-     * Get the configured database URL environment variable name
-     */
-    getConfiguredVariableName(): string;
-    /**
-     * Check if database branching should be used
-     * Requires BOTH conditions:
-     *   1. Database provider is properly configured (checked via provider.isConfigured())
-     *   2. .env file contains the configured database URL variable
-     */
-    shouldUseDatabaseBranching(envFilePath: string): Promise<boolean>;
-    /**
-     * Create database branch only if configured
-     * Returns connection string if branch was created, null if skipped
-     *
-     * @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
-     */
-    createBranchIfConfigured(branchName: string, envFilePath: string, cwd?: string): Promise<string | null>;
-    /**
-     * Delete database branch only if configured
-     * Returns result object indicating what happened
-     *
-     * @param branchName - Name of the branch to delete
-     * @param shouldCleanup - Boolean indicating if database cleanup should be performed (pre-fetched config)
-     * @param isPreview - Whether this is a preview database branch
-     * @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>;
-    /**
-     * Check if .env has the configured database URL variable
-     * CRITICAL: If user explicitly configured a custom variable name (not default),
-     * throw an error if it's missing from .env
-     */
-    private hasDatabaseUrlInEnv;
-}
-
 /**
  * Zod schema for iloom settings
  */
@@ -962,6 +285,45 @@ declare const IloomSettingsSchema: z.ZodObject<{
             databaseUrlEnvVarName?: string | undefined;
         } | undefined;
     }>>;
+    databaseProviders: z.ZodOptional<z.ZodObject<{
+        neon: z.ZodOptional<z.ZodObject<{
+            projectId: z.ZodString;
+            parentBranch: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            projectId: string;
+            parentBranch: string;
+        }, {
+            projectId: string;
+            parentBranch: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    }, {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    }>>;
+    issueManagement: z.ZodOptional<z.ZodObject<{
+        github: z.ZodOptional<z.ZodObject<{
+            remote: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            remote: string;
+        }, {
+            remote: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        github?: {
+            remote: string;
+        } | undefined;
+    }, {
+        github?: {
+            remote: string;
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     mainBranch?: string | undefined;
     worktreePrefix?: string | undefined;
@@ -1003,6 +365,17 @@ declare const IloomSettingsSchema: z.ZodObject<{
             databaseUrlEnvVarName: string;
         } | undefined;
     } | undefined;
+    databaseProviders?: {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    } | undefined;
+    issueManagement?: {
+        github?: {
+            remote: string;
+        } | undefined;
+    } | undefined;
 }, {
     mainBranch?: string | undefined;
     worktreePrefix?: string | undefined;
@@ -1044,62 +417,756 @@ declare const IloomSettingsSchema: z.ZodObject<{
             databaseUrlEnvVarName?: string | undefined;
         } | undefined;
     } | undefined;
+    databaseProviders?: {
+        neon?: {
+            projectId: string;
+            parentBranch: string;
+        } | undefined;
+    } | undefined;
+    issueManagement?: {
+        github?: {
+            remote: string;
+        } | undefined;
+    } | undefined;
 }>;
 /**
- * TypeScript type for iloom settings derived from Zod schema
+ * TypeScript type for iloom settings derived from Zod schema
+ */
+type IloomSettings = z.infer<typeof IloomSettingsSchema>;
+/**
+ * Manages project-level settings from .iloom/settings.json
+ */
+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)
+     */
+    loadSettings(projectRoot?: string, cliOverrides?: Partial<IloomSettings>): Promise<IloomSettings>;
+    /**
+     * Log the final merged configuration for debugging
+     */
+    private logFinalConfiguration;
+    /**
+     * Load and parse a single settings file
+     * Returns empty object if file doesn't exist (not an error)
+     */
+    private loadSettingsFile;
+    /**
+     * Deep merge two settings objects with priority to override
+     * Uses deepmerge library with array replacement strategy
+     */
+    private mergeSettings;
+    /**
+     * Format all Zod validation errors into a single error message
+     */
+    private formatAllZodErrors;
+    /**
+     * Validate settings structure and model names using Zod schema
+     * This method is kept for testing purposes but uses Zod internally
+     * @internal - Only used in tests via bracket notation
+     */
+    private validateSettings;
+    /**
+     * Get project root (defaults to process.cwd())
+     */
+    private getProjectRoot;
+    /**
+     * Get effective protected branches list with mainBranch always included
+     *
+     * This method provides a single source of truth for protected branches logic:
+     * 1. Use configured protectedBranches if provided
+     * 2. Otherwise use defaults: [mainBranch, 'main', 'master', 'develop']
+     * 3. ALWAYS ensure mainBranch is included even if user configured custom list
+     *
+     * @param projectRoot - Optional project root directory (defaults to process.cwd())
+     * @returns Array of protected branch names with mainBranch guaranteed to be included
+     */
+    getProtectedBranches(projectRoot?: string): Promise<string[]>;
+}
+
+/**
+ * Manages Git worktrees for the iloom CLI
+ * Ports functionality from bash scripts into TypeScript
+ */
+declare class GitWorktreeManager {
+    private readonly _workingDirectory;
+    constructor(workingDirectory?: string);
+    /**
+     * Get the working directory for git operations (main worktree path)
+     */
+    get workingDirectory(): string;
+    /**
+     * List all worktrees in the repository
+     * Defaults to porcelain format for reliable machine parsing
+     * Equivalent to: git worktree list --porcelain
+     */
+    listWorktrees(options?: WorktreeListOptions): Promise<GitWorktree[]>;
+    /**
+     * Find worktree for a specific branch
+     * Ports: find_worktree_for_branch() from find-worktree-for-branch.sh
+     */
+    findWorktreeForBranch(branchName: string): Promise<GitWorktree | null>;
+    /**
+     * Check if a worktree is the main repository worktree
+     * Uses findMainWorktreePathWithSettings to determine the main worktree based on settings.
+     *
+     * @param worktree - The worktree to check
+     * @param settingsManager - SettingsManager instance for loading settings
+     * @returns true if the worktree is the main worktree
+     */
+    isMainWorktree(worktree: GitWorktree, settingsManager: SettingsManager): Promise<boolean>;
+    /**
+     * Check if a worktree is a PR worktree based on naming patterns
+     * Ports: is_pr_worktree() from worktree-utils.sh
+     */
+    isPRWorktree(worktree: GitWorktree): boolean;
+    /**
+     * Get PR number from worktree branch name
+     * Ports: get_pr_number_from_worktree() from worktree-utils.sh
+     */
+    getPRNumberFromWorktree(worktree: GitWorktree): number | null;
+    /**
+     * Create a new worktree
+     * Ports worktree creation logic from new-branch-workflow.sh
+     * @returns The absolute path to the created worktree
+     */
+    createWorktree(options: WorktreeCreateOptions): Promise<string>;
+    /**
+     * Remove a worktree and optionally clean up associated files
+     * Ports worktree removal logic from cleanup-worktree.sh
+     * @returns A message describing what was done (for dry-run mode)
+     */
+    removeWorktree(worktreePath: string, options?: WorktreeCleanupOptions): Promise<string | void>;
+    /**
+     * Validate worktree state and integrity
+     */
+    validateWorktree(worktreePath: string): Promise<WorktreeValidation>;
+    /**
+     * Get detailed status information for a worktree
+     */
+    getWorktreeStatus(worktreePath: string): Promise<WorktreeStatus>;
+    /**
+     * Generate a suggested worktree path for a branch
+     */
+    generateWorktreePath(branchName: string, customRoot?: string, options?: {
+        isPR?: boolean;
+        prNumber?: number;
+        prefix?: string;
+    }): string;
+    /**
+     * Sanitize a branch name for use as a directory name
+     * Replaces slashes with dashes and removes invalid filesystem characters
+     * Ports logic from bash script line 593: ${BRANCH_NAME//\\//-}
+     */
+    sanitizeBranchName(branchName: string): string;
+    /**
+     * Check if repository is in a valid state for worktree operations
+     */
+    isRepoReady(): Promise<boolean>;
+    /**
+     * Get repository information
+     */
+    getRepoInfo(): Promise<{
+        root: string | null;
+        defaultBranch: string;
+        currentBranch: string | null;
+    }>;
+    /**
+     * Prune stale worktree entries (worktrees that no longer exist on disk)
+     */
+    pruneWorktrees(): Promise<void>;
+    /**
+     * Lock a worktree to prevent it from being pruned or moved
+     */
+    lockWorktree(worktreePath: string, reason?: string): Promise<void>;
+    /**
+     * Unlock a previously locked worktree
+     */
+    unlockWorktree(worktreePath: string): Promise<void>;
+    /**
+     * Find worktrees matching an identifier (branch name, path, or PR number)
+     */
+    findWorktreesByIdentifier(identifier: string): Promise<GitWorktree[]>;
+    /**
+     * Find worktree for a specific issue number using exact pattern matching
+     * Matches: issue-{N} at start OR after /, -, _ (but NOT issue-{N}X where X is a digit)
+     * Supports patterns like: issue-44, feat/issue-44-feature, feat-issue-44, bugfix_issue-44, etc.
+     * Avoids false matches like: tissue-44, myissue-44
+     * Ports: find_existing_worktree() from bash script lines 131-165
+     */
+    findWorktreeForIssue(issueNumber: number): Promise<GitWorktree | null>;
+    /**
+     * Find worktree for a specific PR by branch name
+     * Ports: find_existing_worktree() for PR type from bash script lines 149-160
+     */
+    findWorktreeForPR(prNumber: number, branchName: string): Promise<GitWorktree | null>;
+    /**
+     * Remove multiple worktrees
+     * Returns a summary of successes and failures
+     * Automatically filters out the main worktree
+     *
+     * @param worktrees - Array of worktrees to remove
+     * @param settingsManager - SettingsManager instance for determining main worktree
+     * @param options - Cleanup options
+     */
+    removeWorktrees(worktrees: GitWorktree[], settingsManager: SettingsManager, options?: WorktreeCleanupOptions): Promise<{
+        successes: Array<{
+            worktree: GitWorktree;
+        }>;
+        failures: Array<{
+            worktree: GitWorktree;
+            error: string;
+        }>;
+        skipped: Array<{
+            worktree: GitWorktree;
+            reason: string;
+        }>;
+    }>;
+    /**
+     * Format worktree information for display
+     */
+    formatWorktree(worktree: GitWorktree): {
+        title: string;
+        path: string;
+        commit: string;
+    };
+}
+
+interface EnvVariable {
+    key: string;
+    value: string;
+}
+interface EnvFileOptions {
+    path: string;
+    backup?: boolean;
+    encoding?: BufferEncoding;
+}
+/**
+ * @deprecated Use exception-based error handling instead
+ */
+interface EnvOperationResult {
+    success: boolean;
+    backupPath?: string;
+    error?: string;
+}
+interface PortAssignmentOptions {
+    basePort?: number;
+    issueNumber?: number;
+    prNumber?: number;
+    branchName?: string;
+}
+
+type ProjectCapability = 'cli' | 'web';
+type Capability = ProjectCapability;
+interface Loom {
+    id: string;
+    path: string;
+    branch: string;
+    type: 'issue' | 'pr' | 'branch';
+    identifier: string | number;
+    port: number;
+    databaseBranch?: string;
+    createdAt: Date;
+    lastAccessed: Date;
+    githubData?: {
+        title?: string;
+        body?: string;
+        url?: string;
+        state?: string;
+    };
+    capabilities?: ProjectCapability[];
+    binEntries?: Record<string, string>;
+    cliSymlinks?: string[];
+}
+interface CreateLoomInput {
+    type: 'issue' | 'pr' | 'branch';
+    identifier: string | number;
+    originalInput: string;
+    baseBranch?: string;
+    options?: {
+        skipDatabase?: boolean;
+        skipColorSync?: boolean;
+        enableClaude?: boolean;
+        enableCode?: boolean;
+        enableDevServer?: boolean;
+        enableTerminal?: boolean;
+        oneShot?: OneShotMode;
+        setArguments?: string[];
+        executablePath?: string;
+    };
+}
+type LaunchMode = 'editor' | 'terminal' | 'both';
+interface LoomSummary {
+    id: string;
+    type: 'issue' | 'pr' | 'branch';
+    identifier: string | number;
+    title?: string;
+    branch: string;
+    port: number;
+    status: 'active' | 'stale' | 'error';
+    lastAccessed: string;
+}
+
+/**
+ * Options for ResourceCleanup operations
  */
-type IloomSettings = z.infer<typeof IloomSettingsSchema>;
+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: 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
+ */
+interface ProcessInfo {
+    /** Process ID */
+    pid: number;
+    /** Process name (e.g., "node", "pnpm") */
+    name: string;
+    /** Full command line */
+    command: string;
+    /** Port the process is listening on */
+    port: number;
+    /** Whether this appears to be a dev server */
+    isDevServer: boolean;
+}
+
+interface Workspace {
+    id: string;
+    path: string;
+    branch: string;
+    issueNumber?: number;
+    prNumber?: number;
+    port: number;
+    databaseBranch?: string;
+    createdAt: Date;
+    lastAccessed: Date;
+}
+interface WorkspaceInput {
+    identifier: string;
+    type: 'issue' | 'pr' | 'branch';
+    skipClaude?: boolean;
+}
+interface WorkspaceSummary {
+    id: string;
+    issueNumber?: number;
+    prNumber?: number;
+    title: string;
+    branch: string;
+    port: number;
+    status: 'active' | 'stale' | 'error';
+    lastAccessed: string;
+}
+interface Worktree {
+    path: string;
+    branch: string;
+    commit: string;
+    isPR: boolean;
+    prNumber?: number;
+    issueNumber?: number;
+    port?: number;
+}
+interface GitStatus {
+    hasUncommittedChanges: boolean;
+    unstagedFiles: string[];
+    stagedFiles: string[];
+    currentBranch: string;
+    isAheadOfRemote: boolean;
+    isBehindRemote: boolean;
+}
+interface Issue {
+    number: number;
+    title: string;
+    body: string;
+    state: 'open' | 'closed';
+    labels: string[];
+    assignees: string[];
+    url: string;
+}
+interface PullRequest {
+    number: number;
+    title: string;
+    body: string;
+    state: 'open' | 'closed' | 'merged';
+    branch: string;
+    baseBranch: string;
+    url: string;
+    isDraft: boolean;
+}
+/**
+ * Result of database branch deletion operation
+ * Distinguishes between successful deletion, branch not found, and errors
+ */
+interface DatabaseDeletionResult {
+    /** Overall operation succeeded (true even if branch didn't exist) */
+    success: boolean;
+    /** True only if a branch was actually deleted */
+    deleted: boolean;
+    /** True if branch didn't exist (not an error, just nothing to do) */
+    notFound: boolean;
+    /** Error message if operation failed */
+    error?: string;
+    /** User declined deletion (for preview databases) */
+    userDeclined?: boolean;
+    /** Name of the branch that was processed */
+    branchName?: string;
+}
+interface DatabaseProvider {
+    createBranch(name: string, fromBranch?: string, cwd?: string): Promise<string>;
+    deleteBranch(name: string, isPreview?: boolean, cwd?: string): Promise<DatabaseDeletionResult>;
+    getConnectionString(branch: string, cwd?: string): Promise<string>;
+    listBranches(cwd?: string): Promise<string[]>;
+    branchExists(name: string, cwd?: string): Promise<boolean>;
+    findPreviewBranch(branchName: string, cwd?: string): Promise<string | null>;
+    getBranchNameFromEndpoint(endpointId: string, cwd?: string): Promise<string | null>;
+    sanitizeBranchName(branchName: string): string;
+    isAuthenticated(cwd?: string): Promise<boolean>;
+    isCliAvailable(): Promise<boolean>;
+    isConfigured(): boolean;
+}
+interface Config {
+    defaultPort: number;
+    databaseProvider?: 'neon' | 'supabase' | 'planetscale';
+    claudeModel?: 'opus' | 'sonnet' | 'haiku';
+    skipClaude?: boolean;
+    customWorkspaceRoot?: string;
+}
+type OneShotMode = 'default' | 'noReview' | 'bypassPermissions';
+interface StartOptions {
+    claude?: boolean;
+    code?: boolean;
+    devServer?: boolean;
+    terminal?: boolean;
+    oneShot?: OneShotMode;
+}
+interface AddIssueOptions {
+}
+interface FeedbackOptions {
+}
+interface EnhanceOptions {
+    noBrowser?: boolean;
+}
+interface FinishOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    pr?: number;
+    skipBuild?: boolean;
+}
 /**
- * Manages project-level settings from .iloom/settings.json
+ * Options for the cleanup command
+ * All flags are optional and can be combined (subject to validation)
  */
-declare class SettingsManager {
+interface CleanupOptions {
+    /** List all worktrees without removing anything */
+    list?: boolean;
+    /** Remove all worktrees (interactive confirmation required unless --force) */
+    all?: boolean;
+    /** Cleanup by specific issue number */
+    issue?: number;
+    /** Skip confirmations and force removal */
+    force?: boolean;
+    /** Show what would be done without actually doing it */
+    dryRun?: boolean;
+}
+interface ListOptions {
+    json?: boolean;
+}
+interface MockOptions {
+    scenario: 'empty' | 'existing' | 'conflicts' | 'error';
+    data?: unknown;
+}
+
+interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+interface ColorData {
+    rgb: RgbColor;
+    hex: string;
+    index: number;
+}
+type Platform = 'darwin' | 'linux' | 'win32' | 'unsupported';
+interface ValidationOptions {
+    dryRun?: boolean;
+    skipTypecheck?: boolean;
+    skipLint?: boolean;
+    skipTests?: boolean;
+}
+interface ValidationStepResult {
+    step: 'typecheck' | 'lint' | 'test';
+    passed: boolean;
+    skipped: boolean;
+    output?: string;
+    error?: string;
+    duration?: number;
+}
+interface ValidationResult {
+    success: boolean;
+    steps: ValidationStepResult[];
+    totalDuration: number;
+}
+interface CommitOptions {
+    dryRun?: boolean;
+    issueNumber?: number;
+    message?: string;
+    noReview?: boolean;
+    skipVerify?: boolean;
+}
+interface MergeOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    repoRoot?: string;
+}
+interface MergeResult {
+    success: boolean;
+    branchName: string;
+    commitsMerged: number;
+    rebaseCompleted: boolean;
+    mergeCompleted: boolean;
+}
+interface UpdateCheckCache {
+    lastCheck: number;
+    latestVersion: string;
+}
+interface UpdateCheckResult {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+}
+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;
+}
+
+declare class GitHubService {
+    private defaultBranchNameStrategy;
+    private prompter;
+    constructor(options?: {
+        branchNameStrategy?: BranchNameStrategy;
+        useClaude?: boolean;
+        claudeModel?: string;
+        prompter?: (message: string) => Promise<boolean>;
+    });
+    detectInputType(input: string, repo?: string): Promise<GitHubInputDetection>;
+    fetchIssue(issueNumber: number, repo?: string): Promise<Issue>;
+    isValidIssue(issueNumber: number, repo?: string): Promise<Issue | false>;
+    private fetchIssueInternal;
+    validateIssueState(issue: Issue): Promise<void>;
+    fetchPR(prNumber: number, repo?: string): Promise<PullRequest>;
+    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;
+        url: string;
+    }>;
+    getIssueUrl(issueNumber: number, repo?: string): Promise<string>;
+    moveIssueToInProgress(issueNumber: number): Promise<void>;
+    private updateIssueStatusInProject;
+    extractContext(entity: Issue | PullRequest): string;
+    private mapGitHubIssueToIssue;
+    private mapGitHubPRToPullRequest;
+    private promptUserConfirmation;
+    setDefaultBranchNameStrategy(strategy: BranchNameStrategy): void;
+    getBranchNameStrategy(): BranchNameStrategy;
+}
+
+declare class EnvironmentManager {
+    private readonly backupSuffix;
     /**
-     * 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)
+     * Set or update an environment variable in a .env file
+     * Ports functionality from bash/utils/env-utils.sh:setEnvVar()
+     * @returns The backup path if a backup was created
      */
-    loadSettings(projectRoot?: string, cliOverrides?: Partial<IloomSettings>): Promise<IloomSettings>;
+    setEnvVar(filePath: string, key: string, value: string, backup?: boolean): Promise<string | void>;
     /**
-     * Log the final merged configuration for debugging
+     * Read and parse a .env file
      */
-    private logFinalConfiguration;
+    readEnvFile(filePath: string): Promise<Map<string, string>>;
     /**
-     * Load and parse a single settings file
-     * Returns empty object if file doesn't exist (not an error)
+     * Generic file copy helper that only copies if source exists
+     * Does not throw if source file doesn't exist - just logs and returns
+     * @private
      */
-    private loadSettingsFile;
+    copyIfExists(source: string, destination: string): Promise<void>;
     /**
-     * Deep merge two settings objects with priority to override
-     * Uses deepmerge library with array replacement strategy
+     * Calculate unique port for workspace
+     * Implements:
+     * - Issue/PR: 3000 + issue/PR number
+     * - Branch: 3000 + deterministic hash offset (1-999)
      */
-    private mergeSettings;
+    calculatePort(options: PortAssignmentOptions): number;
     /**
-     * Format all Zod validation errors into a single error message
+     * Set port environment variable for workspace
      */
-    private formatAllZodErrors;
+    setPortForWorkspace(envFilePath: string, issueNumber?: number, prNumber?: number, branchName?: string): Promise<number>;
     /**
-     * Validate settings structure and model names using Zod schema
-     * This method is kept for testing purposes but uses Zod internally
-     * @internal - Only used in tests via bracket notation
+     * Validate environment configuration
      */
-    private validateSettings;
+    validateEnvFile(filePath: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
     /**
-     * Get project root (defaults to process.cwd())
+     * Create backup of existing file
      */
-    private getProjectRoot;
+    private createBackup;
+}
+
+/**
+ * Database Manager - orchestrates database operations with conditional execution
+ * Ports functionality from bash scripts with guard conditions:
+ *   1. Database provider must be properly configured (provider.isConfigured())
+ *   2. The worktree's .env file must contain the configured database URL variable (default: DATABASE_URL)
+ *
+ * This ensures database branching only occurs for projects that actually use databases
+ */
+declare class DatabaseManager {
+    private provider;
+    private environment;
+    private databaseUrlEnvVarName;
+    constructor(provider: DatabaseProvider, environment: EnvironmentManager, databaseUrlEnvVarName?: string);
     /**
-     * Get effective protected branches list with mainBranch always included
+     * Get the configured database URL environment variable name
+     */
+    getConfiguredVariableName(): string;
+    /**
+     * Check if database branching should be used
+     * Requires BOTH conditions:
+     *   1. Database provider is properly configured (checked via provider.isConfigured())
+     *   2. .env file contains the configured database URL variable
+     */
+    shouldUseDatabaseBranching(envFilePath: string): Promise<boolean>;
+    /**
+     * Create database branch only if configured
+     * Returns connection string if branch was created, null if skipped
      *
-     * This method provides a single source of truth for protected branches logic:
-     * 1. Use configured protectedBranches if provided
-     * 2. Otherwise use defaults: [mainBranch, 'main', 'master', 'develop']
-     * 3. ALWAYS ensure mainBranch is included even if user configured custom list
+     * @param 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
+     */
+    createBranchIfConfigured(branchName: string, envFilePath: string, cwd?: string): Promise<string | null>;
+    /**
+     * Delete database branch only if configured
+     * Returns result object indicating what happened
      *
-     * @param projectRoot - Optional project root directory (defaults to process.cwd())
-     * @returns Array of protected branch names with mainBranch guaranteed to be included
+     * @param branchName - Name of the branch to delete
+     * @param shouldCleanup - Boolean indicating if database cleanup should be performed (pre-fetched config)
+     * @param isPreview - Whether this is a preview database branch
+     * @param cwd - Optional working directory to run commands from (prevents issues with deleted directories)
      */
-    getProtectedBranches(projectRoot?: string): Promise<string[]>;
+    deleteBranchIfConfigured(branchName: string, shouldCleanup: boolean, isPreview?: boolean, cwd?: string): Promise<DatabaseDeletionResult>;
+    /**
+     * Check if .env has the configured database URL variable
+     * CRITICAL: If user explicitly configured a custom variable name (not default),
+     * throw an error if it's missing from .env
+     */
+    private hasDatabaseUrlInEnv;
 }
 
 interface TemplateVariables {
@@ -1110,6 +1177,21 @@ interface TemplateVariables {
     WORKSPACE_PATH?: string;
     PORT?: number;
     ONE_SHOT_MODE?: boolean;
+    SETTINGS_SCHEMA?: string;
+    SETTINGS_JSON?: string;
+    SETTINGS_LOCAL_JSON?: string;
+    SHELL_TYPE?: string;
+    SHELL_CONFIG_PATH?: string;
+    SHELL_CONFIG_CONTENT?: string;
+    REMOTES_INFO?: string;
+    MULTIPLE_REMOTES?: string;
+    SINGLE_REMOTE?: string;
+    SINGLE_REMOTE_NAME?: string;
+    SINGLE_REMOTE_URL?: string;
+    NO_REMOTES?: string;
+    README_CONTENT?: string;
+    SETTINGS_SCHEMA_CONTENT?: string;
+    FIRST_TIME_USER?: boolean;
 }
 declare class PromptTemplateManager {
     private templateDir;
@@ -1117,7 +1199,7 @@ declare class PromptTemplateManager {
     /**
      * Load a template file by name
      */
-    loadTemplate(templateName: 'issue' | 'pr' | 'regular'): Promise<string>;
+    loadTemplate(templateName: 'issue' | 'pr' | 'regular' | 'init'): Promise<string>;
     /**
      * Substitute variables in a template string
      */
@@ -1132,7 +1214,7 @@ declare class PromptTemplateManager {
     /**
      * Get a fully processed prompt for a workflow type
      */
-    getPrompt(type: 'issue' | 'pr' | 'regular', variables: TemplateVariables): Promise<string>;
+    getPrompt(type: 'issue' | 'pr' | 'regular' | 'init', variables: TemplateVariables): Promise<string>;
 }
 
 interface ClaudeWorkflowOptions {