geeto 0.6.6 → 0.9.0

package/lib/index.js

@@ -1,732 +1,529 @@
 #!/usr/bin/env node
 /**
  * Geeto - Git flow automation CLI tool with AI-powered branch naming
- * Main entry point - delegates to modular workflows
+ * Main entry point - delegates to modular workflows via command registry
  */
-import path from 'node:path';
 import { VERSION } from './version.js';
-const version = VERSION;
-const { main } = await import('./workflows/main.js');
-// Parse simple CLI flags for quick step shortcuts
-const argv = process.argv.slice(2);
-let startAt;
-let fresh = false;
-let resume = false;
-let stageAll = false;
-let showVersion = false;
-let showHelp = false;
-let showCleanup = false;
-let showSwitch = false;
-let showCompare = false;
-let showCherryPick = false;
-let showPR = false;
-let showIssue = false;
-let showHistory = false;
-let showStash = false;
-let showAmend = false;
-let showStats = false;
-let showUndo = false;
-let showRelease = false;
-let showRepoSettings = false;
-let showTrello = false;
-let showTrelloLists = false;
-let showTrelloGenerate = false;
-let showAbort = false;
-let showPull = false;
-let showPrune = false;
-let showFetch = false;
-let showStatus = false;
-let showRevert = false;
-let showAlias = false;
-let showReword = false;
-let dryRunMode = false;
-let settingsAction;
-for (const arg of argv) {
-    if (arg === '-c' || arg === '--commit') {
-        startAt = 'commit';
-    }
-    if (arg === '-m' || arg === '--merge') {
-        startAt = 'merge';
-    }
-    if (arg === '-b' || arg === '--branch') {
-        startAt = 'branch';
-    }
-    if (arg === '-s' || arg === '--stage') {
-        startAt = 'stage';
-    }
-    if (arg === '-sa' || arg === '-as') {
-        startAt = 'stage';
-        stageAll = true;
-    }
-    if (arg === '-p' || arg === '--push') {
-        startAt = 'push';
-    }
-    if (arg === '-f' || arg === '--fresh') {
-        fresh = true;
-    }
-    if (arg === '-r' || arg === '--resume') {
-        resume = true;
-    }
-    if (arg === '-v' || arg === '--version') {
-        showVersion = true;
-    }
-    if (arg === '-h' || arg === '--help') {
-        showHelp = true;
-    }
-    if (arg === '--separator') {
-        settingsAction = 'separator';
-    }
-    if (arg === '--sync-models') {
-        settingsAction = 'models';
-    }
-    if (arg === '--change-model') {
-        settingsAction = 'change-model';
-    }
-    if (arg === '--setup-gemini') {
-        settingsAction = 'gemini';
-    }
-    if (arg === '--setup-openrouter') {
-        settingsAction = 'openrouter';
-    }
-    if (arg === '--setup-trello') {
-        settingsAction = 'trello';
-    }
-    if (arg === '--setup-github') {
-        settingsAction = 'github';
-    }
-    if (arg === '--cleanup' || arg === '-cl') {
-        showCleanup = true;
-    }
-    if (arg === '--switch' || arg === '-sw') {
-        showSwitch = true;
-    }
-    if (arg === '--compare' || arg === '-cmp') {
-        showCompare = true;
-    }
-    if (arg === '--cherry-pick' || arg === '-cp') {
-        showCherryPick = true;
-    }
-    if (arg === '--pr' || arg === '-pr') {
-        showPR = true;
-    }
-    if (arg === '--issue' || arg === '-i') {
-        showIssue = true;
-    }
-    if (arg === '--log' || arg === '-lg') {
-        showHistory = true;
-    }
-    if (arg === '--stash' || arg === '-sh') {
-        showStash = true;
-    }
-    if (arg === '--amend' || arg === '-am') {
-        showAmend = true;
-    }
-    if (arg === '--stats' || arg === '-sts') {
-        showStats = true;
-    }
-    if (arg === '--undo' || arg === '-u') {
-        showUndo = true;
-    }
-    if (arg === '--tag' || arg === '-t') {
-        showRelease = true;
-    }
-    if (arg === '--repo' || arg === '-rp') {
-        showRepoSettings = true;
-    }
-    if (arg === '--trello' || arg === '-tr') {
-        showTrello = true;
-    }
-    if (arg === '--trello-list' || arg === '-tl') {
-        showTrelloLists = true;
-    }
-    if (arg === '--trello-generate' || arg === '-tg') {
-        showTrelloGenerate = true;
-    }
-    if (arg === '--abort') {
-        showAbort = true;
-    }
-    if (arg === '--pull' || arg === '-pl') {
-        showPull = true;
-    }
-    if (arg === '--prune') {
-        showPrune = true;
-    }
-    if (arg === '--fetch' || arg === '-ft') {
-        showFetch = true;
-    }
-    if (arg === '--status' || arg === '-st') {
-        showStatus = true;
-    }
-    if (arg === '--revert' || arg === '-rv') {
-        showRevert = true;
-    }
-    if (arg === '--alias' || arg === '-al') {
-        showAlias = true;
-    }
-    if (arg === '--reword' || arg === '-rw') {
-        showReword = true;
-    }
-    if (arg === '--dry-run' || arg === '-dr') {
-        dryRunMode = true;
-    }
-}
-// Validate unknown flags
-const validFlags = new Set([
-    '-c',
-    '--commit',
-    '-m',
-    '--merge',
-    '-b',
-    '--branch',
-    '-s',
-    '--stage',
-    '-sa',
-    '-as',
-    '-p',
-    '--push',
-    '--cleanup',
-    '-cl',
-    '--switch',
-    '-sw',
-    '--compare',
-    '-cmp',
-    '--cherry-pick',
-    '-cp',
-    '--pr',
-    '-pr',
-    '--issue',
-    '-i',
-    '--log',
-    '-lg',
-    '--stash',
-    '-sh',
-    '--amend',
-    '-am',
-    '--stats',
-    '-sts',
-    '--undo',
-    '-u',
-    '--tag',
-    '-t',
-    '--repo',
-    '-rp',
-    '-f',
-    '--fresh',
-    '-r',
-    '--resume',
-    '-v',
-    '--version',
-    '-h',
-    '--help',
-    '--separator',
-    '--sync-models',
-    '--change-model',
-    '--setup-gemini',
-    '--setup-openrouter',
-    '--setup-trello',
-    '--setup-github',
-    '--trello',
-    '-tr',
-    '--trello-list',
-    '-tl',
-    '--trello-generate',
-    '-tg',
-    '--abort',
-    '--pull',
-    '-pl',
-    '--prune',
-    '--fetch',
-    '-ft',
-    '--status',
-    '-st',
-    '--revert',
-    '-rv',
-    '--alias',
-    '-al',
-    '--reword',
-    '-rw',
-    '--dry-run',
-    '-dr',
-]);
-// Detect file path argument (non-flag arg → open in inline editor)
-let editFilePath;
-for (const arg of argv) {
-    if (!arg.startsWith('-')) {
-        editFilePath = arg;
-        break;
-    }
-}
-for (const arg of argv) {
-    if (arg.startsWith('-') && !validFlags.has(arg)) {
-        console.error(`Unknown flag: ${arg}`);
-        console.error('Use --help to see available options');
-        process.exit(1);
-    }
+/**
+ * Registry of all standalone commands.
+ * Order determines priority when multiple flags are passed.
+ */
+const COMMAND_REGISTRY = [
+    // Git tools
+    {
+        flag: '--abort',
+        alias: undefined,
+        module: './workflows/abort.js',
+        handler: 'handleAbort',
+        errorLabel: 'Abort',
+    },
+    {
+        flag: '--pull',
+        alias: '-pl',
+        module: './workflows/pull.js',
+        handler: 'handlePull',
+        errorLabel: 'Pull',
+    },
+    {
+        flag: '--prune',
+        alias: undefined,
+        module: './workflows/prune.js',
+        handler: 'handlePrune',
+        errorLabel: 'Prune',
+    },
+    {
+        flag: '--fetch',
+        alias: '-ft',
+        module: './workflows/fetch.js',
+        handler: 'handleFetch',
+        errorLabel: 'Fetch',
+    },
+    {
+        flag: '--status',
+        alias: '-st',
+        module: './workflows/status.js',
+        handler: 'handleStatus',
+        errorLabel: 'Status',
+    },
+    {
+        flag: '--revert',
+        alias: '-rv',
+        module: './workflows/revert.js',
+        handler: 'handleRevert',
+        errorLabel: 'Revert',
+    },
+    {
+        flag: '--alias',
+        alias: '-al',
+        module: './workflows/alias.js',
+        handler: 'handleAlias',
+        errorLabel: 'Alias',
+    },
+    {
+        flag: '--reword',
+        alias: '-rw',
+        module: './workflows/reword.js',
+        handler: 'handleReword',
+        errorLabel: 'Reword',
+    },
+    {
+        flag: '--cleanup',
+        alias: '-cl',
+        module: './workflows/cleanup.js',
+        handler: 'handleInteractiveCleanup',
+        errorLabel: 'Cleanup',
+    },
+    {
+        flag: '--switch',
+        alias: '-sw',
+        module: './workflows/switch.js',
+        handler: 'handleBranchSwitch',
+        errorLabel: 'Switch',
+    },
+    {
+        flag: '--compare',
+        alias: '-cmp',
+        module: './workflows/compare.js',
+        handler: 'handleBranchCompare',
+        errorLabel: 'Compare',
+    },
+    {
+        flag: '--cherry-pick',
+        alias: '-cp',
+        module: './workflows/cherry-pick.js',
+        handler: 'handleCherryPick',
+        errorLabel: 'Cherry-pick',
+    },
+    {
+        flag: '--pr',
+        alias: '-pr',
+        module: './workflows/pr.js',
+        handler: 'handleCreatePR',
+        errorLabel: 'PR',
+    },
+    {
+        flag: '--issue',
+        alias: '-i',
+        module: './workflows/issue.js',
+        handler: 'handleCreateIssue',
+        errorLabel: 'Issue',
+    },
+    {
+        flag: '--log',
+        alias: '-lg',
+        module: './workflows/history.js',
+        handler: 'handleHistory',
+        errorLabel: 'History',
+    },
+    {
+        flag: '--stash',
+        alias: '-sh',
+        module: './workflows/stash.js',
+        handler: 'handleStash',
+        errorLabel: 'Stash',
+    },
+    {
+        flag: '--amend',
+        alias: '-am',
+        module: './workflows/amend.js',
+        handler: 'handleAmend',
+        errorLabel: 'Amend',
+    },
+    {
+        flag: '--stats',
+        alias: '-sts',
+        module: './workflows/stats.js',
+        handler: 'handleStats',
+        errorLabel: 'Stats',
+    },
+    {
+        flag: '--undo',
+        alias: '-u',
+        module: './workflows/undo.js',
+        handler: 'handleUndo',
+        errorLabel: 'Undo',
+    },
+    {
+        flag: '--tag',
+        alias: '-t',
+        module: './workflows/release.js',
+        handler: 'handleRelease',
+        errorLabel: 'Release',
+    },
+    {
+        flag: '--repo',
+        alias: '-rp',
+        module: './workflows/repo-settings.js',
+        handler: 'handleRepoSettings',
+        errorLabel: 'Repo settings',
+    },
+    // Trello
+    {
+        flag: '--trello',
+        alias: '-tr',
+        module: './workflows/trello-menu.js',
+        handler: 'showTrelloMenu',
+        errorLabel: 'Trello menu',
+    },
+    {
+        flag: '--trello-generate',
+        alias: '-tg',
+        module: './workflows/trello-menu.js',
+        handler: 'handleGenerateTaskInstructions',
+        errorLabel: 'Trello generate',
+    },
+    // Settings
+    {
+        flag: '--separator',
+        alias: undefined,
+        module: './workflows/settings.js',
+        handler: 'handleSeparatorSetting',
+        errorLabel: 'Settings',
+    },
+    {
+        flag: '--sync-models',
+        alias: undefined,
+        module: './workflows/settings.js',
+        handler: 'handleModelResetSetting',
+        errorLabel: 'Settings',
+    },
+    {
+        flag: '--change-model',
+        alias: undefined,
+        module: './workflows/settings.js',
+        handler: 'handleChangeModelSetting',
+        errorLabel: 'Settings',
+    },
+    {
+        flag: '--setup-gemini',
+        alias: undefined,
+        module: './workflows/settings.js',
+        handler: 'handleGeminiSetting',
+        errorLabel: 'Settings',
+    },
+    {
+        flag: '--setup-openrouter',
+        alias: undefined,
+        module: './workflows/settings.js',
+        handler: 'handleOpenRouterSetting',
+        errorLabel: 'Settings',
+    },
+    {
+        flag: '--setup-trello',
+        alias: undefined,
+        module: './workflows/settings.js',
+        handler: 'handleTrelloSetting',
+        errorLabel: 'Settings',
+    },
+    {
+        flag: '--setup-github',
+        alias: undefined,
+        module: './core/github-setup.js',
+        handler: 'setupGithubConfigInteractive',
+        errorLabel: 'Settings',
+    },
+    {
+        flag: '--setup-gitlab',
+        alias: undefined,
+        module: './core/gitlab-setup.js',
+        handler: 'setupGitlabConfigInteractive',
+        errorLabel: 'Settings',
+    },
+    // Doctor / Info
+    {
+        flag: '--uninstall',
+        alias: undefined,
+        module: './workflows/doctor.js',
+        handler: 'handleUninstall',
+        errorLabel: 'Uninstall',
+    },
+    {
+        flag: '--where',
+        alias: undefined,
+        module: './workflows/doctor.js',
+        handler: 'handleWhereInstalled',
+        errorLabel: 'Where',
+    },
+];
+/** Flags that set the `startAt` step for the main workflow */
+const START_AT_FLAGS = [
+    { flag: '--commit', alias: '-c', startAt: 'commit' },
+    { flag: '--merge', alias: '-m', startAt: 'merge' },
+    { flag: '--branch', alias: '-b', startAt: 'branch' },
+    { flag: '--stage', alias: '-s', startAt: 'stage' },
+    { flag: '--push', alias: '-p', startAt: 'push' },
+];
+/** Modifier flags that don't trigger a command on their own */
+const MODIFIER_FLAGS = [
+    { flag: '--fresh', alias: '-f' },
+    { flag: '--resume', alias: '-r' },
+    { flag: '--version', alias: '-v' },
+    { flag: '--help', alias: '-h' },
+    { flag: '--dry-run', alias: '-dr' },
+];
+// ─── Valid Flags (auto-generated from registries) ────────────────────
+function buildValidFlags() {
+    const flags = new Set();
+    for (const cmd of COMMAND_REGISTRY) {
+        flags.add(cmd.flag);
+        if (cmd.alias)
+            flags.add(cmd.alias);
+    }
+    for (const sf of START_AT_FLAGS) {
+        flags.add(sf.flag);
+        flags.add(sf.alias);
+    }
+    // Special compound aliases
+    flags.add('-sa');
+    flags.add('-as');
+    for (const mf of MODIFIER_FLAGS) {
+        flags.add(mf.flag);
+        flags.add(mf.alias);
+    }
+    return flags;
 }
-;
-(async () => {
-    if (showVersion) {
-        console.log(`Geeto v${version}`);
-        process.exit(0);
-    }
-    if (showHelp) {
-        const C = '\u001B[36m'; // cyan
-        const B = '\u001B[1m'; // bright/bold
-        const G = '\u001B[90m'; // gray
-        const R = '\u001B[0m'; // reset
-        console.log('');
-        console.log(`  ${B}Geeto CLI${R} ${G}v${version}${R}`);
-        console.log(`  ${G}Git flow automation with AI-powered workflows${R}`);
-        console.log('');
-        console.log(`  ${B}USAGE${R}`);
-        console.log(`    ${C}geeto${R} ${G}[command] [options]${R}`);
-        console.log('');
-        console.log(`  ${B}WORKFLOW${R}`);
-        console.log(`    ${C}-s,  --stage${R}              Stage files interactively`);
-        console.log(`    ${C}-sa, -as${R}                  Stage all changes automatically`);
-        console.log(`    ${C}-c,  --commit${R}             Create a commit with AI message`);
-        console.log(`    ${C}-b,  --branch${R}             Create a branch with AI name`);
-        console.log(`    ${C}-p,  --push${R}               Push current branch to remote`);
-        console.log(`    ${C}-m,  --merge${R}              Merge branches interactively`);
-        console.log('');
-        console.log(`  ${B}GIT TOOLS${R}`);
-        console.log(`    ${C}-cl, --cleanup${R}            Clean up local & remote branches`);
-        console.log(`    ${C}-sw, --switch${R}             Switch branches with fuzzy search`);
-        console.log(`    ${C}-cmp, --compare${R}           Compare current branch with another`);
-        console.log(`    ${C}-cp, --cherry-pick${R}        Cherry-pick from another branch`);
-        console.log(`    ${C}-lg, --log${R}                View commit history with timeline`);
-        console.log(`    ${C}-sh, --stash${R}              Manage stashes interactively`);
-        console.log(`    ${C}-am, --amend${R}              Amend the last commit`);
-        console.log(`    ${C}-u,  --undo${R}               Undo the last git action safely`);
-        console.log(`    ${C}-rv, --revert${R}             Revert the last commit (soft reset)`);
-        console.log(`    ${C}-al, --alias${R}              Install shell aliases for geeto`);
-        console.log(`    ${C}-rw, --reword${R}             Edit past commit messages`);
-        console.log(`    ${C}-sts, --stats${R}             Repository statistics dashboard`);
-        console.log(`    ${C}     --abort${R}              Abort in-progress operation`);
-        console.log(`    ${C}-pl, --pull${R}               Pull from remote interactively`);
-        console.log(`    ${C}-ft, --fetch${R}              Fetch latest from remote`);
-        console.log(`    ${C}     --prune${R}              Remove stale remote branches`);
-        console.log(`    ${C}-st, --status${R}             Pretty git status overview`);
-        console.log('');
-        console.log(`  ${B}GITHUB${R}`);
-        console.log(`    ${C}-pr, --pr${R}                 Create a Pull Request`);
-        console.log(`    ${C}-i,  --issue${R}              Create an Issue`);
-        console.log(`    ${C}-t,  --tag${R}                Release & tag manager with semver`);
-        console.log(`    ${C}-rp, --repo${R}               Update GitHub repo settings`);
-        console.log('');
-        console.log(`  ${B}TRELLO${R}`);
-        console.log(`    ${C}-tr, --trello${R}             Open Trello menu`);
-        console.log(`    ${C}-tl, --trello-list${R}        List boards and lists`);
-        console.log(`    ${C}-tg, --trello-generate${R}    Generate tasks from Trello`);
-        console.log('');
-        console.log(`  ${B}SETTINGS${R}`);
-        console.log(`    ${C}     --setup-gemini${R}       Configure Gemini AI`);
-        console.log(`    ${C}     --setup-openrouter${R}   Configure OpenRouter AI`);
-        console.log(`    ${C}     --setup-github${R}       Configure GitHub token`);
-        console.log(`    ${C}     --setup-trello${R}       Configure Trello integration`);
-        console.log(`    ${C}     --change-model${R}       Switch AI provider / model`);
-        console.log(`    ${C}     --sync-models${R}        Fetch latest model list`);
-        console.log(`    ${C}     --separator${R}          Set branch name separator`);
-        console.log('');
-        console.log(`  ${B}OPTIONS${R}`);
-        console.log(`    ${C}-f,  --fresh${R}              Start fresh (ignore checkpoint)`);
-        console.log(`    ${C}-r,  --resume${R}             Resume from last checkpoint`);
-        console.log(`    ${C}-dr, --dry-run${R}            Simulate commands without executing`);
-        console.log(`    ${C}-v,  --version${R}            Show version`);
-        console.log(`    ${C}-h,  --help${R}               Show this help message`);
-        console.log('');
-        console.log(`  ${B}EDITOR${R}`);
-        console.log(`    ${C}geeto <file>${R}              Open file in inline editor`);
-        console.log('');
-        process.exit(0);
-    }
-    // Dry-run mode handling
-    if (dryRunMode) {
-        const { setDryRun, printDryRunBanner, printDryRunSummary } = await import('./utils/dry-run.js');
-        const hasOtherCommand = startAt !== undefined ||
-            showCleanup ||
-            showSwitch ||
-            showCompare ||
-            showCherryPick ||
-            showPR ||
-            showIssue ||
-            showHistory ||
-            showStash ||
-            showAmend ||
-            showStats ||
-            showUndo ||
-            showRelease ||
-            showRepoSettings ||
-            showTrello ||
-            showTrelloLists ||
-            showTrelloGenerate ||
-            showAbort ||
-            showPull ||
-            showPrune ||
-            showFetch ||
-            showStatus ||
-            showRevert ||
-            showAlias ||
-            showReword ||
-            settingsAction !== undefined;
-        if (!hasOtherCommand) {
-            // Standalone --dry-run: show interactive menu
-            try {
-                const { handleDryRunMenu } = await import('./workflows/dry-run.js');
-                await handleDryRunMenu();
-                process.exit(0);
-            }
-            catch (error) {
-                console.error('Dry-run error:', error);
-                process.exit(1);
+const validFlags = buildValidFlags();
+function parseArgs(argv) {
+    let startAt;
+    let fresh = false;
+    let resume = false;
+    let stageAll = false;
+    let dryRunMode = false;
+    let showVersion = false;
+    let showHelp = false;
+    const activeFlags = new Set();
+    for (const arg of argv) {
+        // Start-at flags (workflow step shortcuts)
+        for (const sf of START_AT_FLAGS) {
+            if (arg === sf.flag || arg === sf.alias) {
+                startAt = sf.startAt;
             }
         }
-        // Combo mode: activate dry-run, let normal routing handle it
-        setDryRun(true);
-        printDryRunBanner();
-        // Wrap process.exit to print summary before exiting
-        const originalExit = process.exit;
-        process.exit = ((code) => {
-            printDryRunSummary();
-            originalExit(code);
-        });
-    }
-    // Inline file editor: geeto <filepath>
-    if (editFilePath) {
-        try {
-            const fs = await import('node:fs');
-            const resolved = path.resolve(editFilePath);
-            let content = '';
-            if (fs.existsSync(resolved)) {
-                content = fs.readFileSync(resolved, 'utf8');
-            }
-            console.log(`  \u001B[90mEditing: ${resolved}\u001B[0m`);
-            const { editInline } = await import('./cli/input.js');
-            const result = await editInline(content, path.basename(editFilePath), path.extname(editFilePath));
-            if (result === null) {
-                console.log(`  \u001B[90m✗ Cancelled\u001B[0m`);
-            }
-            else {
-                fs.writeFileSync(resolved, result + '\n', 'utf8');
-                console.log(`  \u001B[32m✓\u001B[0m Saved to ${editFilePath}`);
+        // Special compound: -sa / -as → stage + stageAll
+        if (arg === '-sa' || arg === '-as') {
+            startAt = 'stage';
+            stageAll = true;
+        }
+        // Modifier flags
+        if (arg === '-f' || arg === '--fresh')
+            fresh = true;
+        if (arg === '-r' || arg === '--resume')
+            resume = true;
+        if (arg === '-v' || arg === '--version')
+            showVersion = true;
+        if (arg === '-h' || arg === '--help')
+            showHelp = true;
+        if (arg === '--dry-run' || arg === '-dr')
+            dryRunMode = true;
+        // Command registry lookup
+        for (const cmd of COMMAND_REGISTRY) {
+            if (arg === cmd.flag || arg === cmd.alias) {
+                activeFlags.add(cmd.flag);
             }
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Editor error:', error);
-            process.exit(1);
-        }
-    }
-    if (showAbort) {
-        try {
-            const { handleAbort } = await import('./workflows/abort.js');
-            await handleAbort();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Abort error:', error);
-            process.exit(1);
-        }
-    }
-    if (showPull) {
-        try {
-            const { handlePull } = await import('./workflows/pull.js');
-            await handlePull();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Pull error:', error);
-            process.exit(1);
-        }
-    }
-    if (showPrune) {
-        try {
-            const { handlePrune } = await import('./workflows/prune.js');
-            await handlePrune();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Prune error:', error);
-            process.exit(1);
-        }
-    }
-    if (showFetch) {
-        try {
-            const { handleFetch } = await import('./workflows/fetch.js');
-            await handleFetch();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Fetch error:', error);
-            process.exit(1);
-        }
-    }
-    if (showStatus) {
-        try {
-            const { handleStatus } = await import('./workflows/status.js');
-            handleStatus();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Status error:', error);
-            process.exit(1);
-        }
-    }
-    if (showRevert) {
-        try {
-            const { handleRevert } = await import('./workflows/revert.js');
-            await handleRevert();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Revert error:', error);
-            process.exit(1);
-        }
-    }
-    if (showAlias) {
-        try {
-            const { handleAlias } = await import('./workflows/alias.js');
-            await handleAlias();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Alias error:', error);
-            process.exit(1);
-        }
-    }
-    if (showReword) {
-        try {
-            const { handleReword } = await import('./workflows/reword.js');
-            await handleReword();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Reword error:', error);
-            process.exit(1);
-        }
-    }
-    if (showCleanup) {
-        try {
-            const { handleInteractiveCleanup } = await import('./workflows/cleanup.js');
-            await handleInteractiveCleanup();
-            process.exit(0);
         }
-        catch (error) {
-            console.error('Cleanup error:', error);
-            process.exit(1);
-        }
-    }
-    if (showSwitch) {
-        try {
-            const { handleBranchSwitch } = await import('./workflows/switch.js');
-            await handleBranchSwitch();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Switch error:', error);
-            process.exit(1);
-        }
-    }
-    if (showCompare) {
-        try {
-            const { handleBranchCompare } = await import('./workflows/compare.js');
-            await handleBranchCompare();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Compare error:', error);
-            process.exit(1);
-        }
-    }
-    if (showCherryPick) {
-        try {
-            const { handleCherryPick } = await import('./workflows/cherry-pick.js');
-            await handleCherryPick();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Cherry-pick error:', error);
-            process.exit(1);
-        }
-    }
-    if (showPR) {
-        try {
-            const { handleCreatePR } = await import('./workflows/pr.js');
-            await handleCreatePR();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('PR error:', error);
-            process.exit(1);
-        }
-    }
-    if (showIssue) {
-        try {
-            const { handleCreateIssue } = await import('./workflows/issue.js');
-            await handleCreateIssue();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Issue error:', error);
-            process.exit(1);
-        }
-    }
-    if (showHistory) {
-        try {
-            const { handleHistory } = await import('./workflows/history.js');
-            await handleHistory();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('History error:', error);
-            process.exit(1);
-        }
-    }
-    if (showStash) {
-        try {
-            const { handleStash } = await import('./workflows/stash.js');
-            await handleStash();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Stash error:', error);
-            process.exit(1);
-        }
-    }
-    if (showAmend) {
-        try {
-            const { handleAmend } = await import('./workflows/amend.js');
-            await handleAmend();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Amend error:', error);
-            process.exit(1);
-        }
-    }
-    if (showStats) {
-        try {
-            const { handleStats } = await import('./workflows/stats.js');
-            handleStats();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Stats error:', error);
-            process.exit(1);
-        }
-    }
-    if (showUndo) {
-        try {
-            const { handleUndo } = await import('./workflows/undo.js');
-            await handleUndo();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Undo error:', error);
-            process.exit(1);
-        }
-    }
-    if (showRelease) {
-        try {
-            const { handleRelease } = await import('./workflows/release.js');
-            await handleRelease();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Release error:', error);
-            process.exit(1);
-        }
-    }
-    if (showRepoSettings) {
+        // Non-flag argument → ignored
+    }
+    return {
+        startAt,
+        fresh,
+        resume,
+        stageAll,
+        dryRunMode,
+        showVersion,
+        showHelp,
+        activeFlags,
+    };
+}
+// ─── Help Display ────────────────────────────────────────────────────
+function showHelpMessage() {
+    const C = '\u001B[36m'; // cyan
+    const B = '\u001B[1m'; // bright/bold
+    const G = '\u001B[90m'; // gray
+    const R = '\u001B[0m'; // reset
+    console.log('');
+    console.log(`  ${B}Geeto CLI${R} ${G}v${VERSION}${R}`);
+    console.log(`  ${G}Git flow automation with AI-powered workflows${R}`);
+    console.log('');
+    console.log(`  ${B}USAGE${R}`);
+    console.log(`    ${C}geeto${R} ${G}[command] [options]${R}`);
+    console.log('');
+    console.log(`  ${B}WORKFLOW${R}`);
+    console.log(`    ${C}-s,  --stage${R}              Stage files interactively`);
+    console.log(`    ${C}-sa, -as${R}                  Stage all changes automatically`);
+    console.log(`    ${C}-c,  --commit${R}             Create a commit with AI message`);
+    console.log(`    ${C}-b,  --branch${R}             Create a branch with AI name`);
+    console.log(`    ${C}-p,  --push${R}               Push current branch to remote`);
+    console.log(`    ${C}-m,  --merge${R}              Merge branches interactively`);
+    console.log('');
+    console.log(`  ${B}GIT TOOLS${R}`);
+    console.log(`    ${C}-cl, --cleanup${R}            Clean up local & remote branches`);
+    console.log(`    ${C}-sw, --switch${R}             Switch branches with fuzzy search`);
+    console.log(`    ${C}-cmp, --compare${R}           Compare current branch with another`);
+    console.log(`    ${C}-cp, --cherry-pick${R}        Cherry-pick from another branch`);
+    console.log(`    ${C}-lg, --log${R}                View commit history with timeline`);
+    console.log(`    ${C}-sh, --stash${R}              Manage stashes interactively`);
+    console.log(`    ${C}-am, --amend${R}              Amend the last commit`);
+    console.log(`    ${C}-u,  --undo${R}               Undo the last git action safely`);
+    console.log(`    ${C}-rv, --revert${R}             Revert the last commit (soft reset)`);
+    console.log(`    ${C}-al, --alias${R}              Install shell aliases for geeto`);
+    console.log(`    ${C}-rw, --reword${R}             Edit past commit messages`);
+    console.log(`    ${C}-sts, --stats${R}             Repository statistics dashboard`);
+    console.log(`    ${C}     --abort${R}              Abort in-progress operation`);
+    console.log(`    ${C}-pl, --pull${R}               Pull from remote interactively`);
+    console.log(`    ${C}-ft, --fetch${R}              Fetch latest from remote`);
+    console.log(`    ${C}     --prune${R}              Remove stale remote branches`);
+    console.log(`    ${C}-st, --status${R}             Pretty git status overview`);
+    console.log('');
+    console.log(`  ${B}GITHUB / GITLAB${R}`);
+    console.log(`    ${C}-pr, --pr${R}                 Create a Pull Request / Merge Request`);
+    console.log(`    ${C}-i,  --issue${R}              Create an Issue`);
+    console.log(`    ${C}-t,  --tag${R}                Release & tag manager with semver`);
+    console.log(`    ${C}-rp, --repo${R}               Update repo settings`);
+    console.log('');
+    console.log(`  ${B}TRELLO${R}`);
+    console.log(`    ${C}-tr, --trello${R}             Open Trello menu`);
+    console.log(`    ${C}-tl, --trello-list${R}        List boards and lists`);
+    console.log(`    ${C}-tg, --trello-generate${R}    Generate tasks from Trello`);
+    console.log('');
+    console.log(`  ${B}SETTINGS${R}`);
+    console.log(`    ${C}     --setup-gemini${R}       Configure Gemini AI`);
+    console.log(`    ${C}     --setup-openrouter${R}   Configure OpenRouter AI`);
+    console.log(`    ${C}     --setup-github${R}       Configure GitHub token`);
+    console.log(`    ${C}     --setup-gitlab${R}       Configure GitLab token`);
+    console.log(`    ${C}     --setup-trello${R}       Configure Trello integration`);
+    console.log(`    ${C}     --change-model${R}       Switch AI provider / model`);
+    console.log(`    ${C}     --sync-models${R}        Fetch latest model list`);
+    console.log(`    ${C}     --separator${R}          Set branch name separator`);
+    console.log('');
+    console.log(`  ${B}OPTIONS${R}`);
+    console.log(`    ${C}-f,  --fresh${R}              Start fresh (ignore checkpoint)`);
+    console.log(`    ${C}-r,  --resume${R}             Resume from last checkpoint`);
+    console.log(`    ${C}-dr, --dry-run${R}            Simulate commands without executing`);
+    console.log(`    ${C}-v,  --version${R}            Show version`);
+    console.log(`    ${C}-h,  --help${R}               Show this help message`);
+    console.log('');
+    console.log(`  ${B}INFO${R}`);
+    console.log(`    ${C}     --where${R}              Show installation path & method`);
+    console.log(`    ${C}     --uninstall${R}          Uninstall geeto CLI`);
+    console.log('');
+}
+// ─── Command Execution ───────────────────────────────────────────────
+/**
+ * Static module map for compiled binary compatibility.
+ * Bun's compiler can only resolve string-literal dynamic imports — variable
+ * paths like `import(cmd.module)` won't be bundled. This map provides
+ * explicit string-literal imports that the compiler CAN resolve.
+ */
+const MODULE_LOADERS = {
+    './workflows/abort.js': () => import('./workflows/abort.js'),
+    './workflows/pull.js': () => import('./workflows/pull.js'),
+    './workflows/prune.js': () => import('./workflows/prune.js'),
+    './workflows/fetch.js': () => import('./workflows/fetch.js'),
+    './workflows/status.js': () => import('./workflows/status.js'),
+    './workflows/revert.js': () => import('./workflows/revert.js'),
+    './workflows/alias.js': () => import('./workflows/alias.js'),
+    './workflows/reword.js': () => import('./workflows/reword.js'),
+    './workflows/cleanup.js': () => import('./workflows/cleanup.js'),
+    './workflows/switch.js': () => import('./workflows/switch.js'),
+    './workflows/compare.js': () => import('./workflows/compare.js'),
+    './workflows/cherry-pick.js': () => import('./workflows/cherry-pick.js'),
+    './workflows/pr.js': () => import('./workflows/pr.js'),
+    './workflows/issue.js': () => import('./workflows/issue.js'),
+    './workflows/history.js': () => import('./workflows/history.js'),
+    './workflows/stash.js': () => import('./workflows/stash.js'),
+    './workflows/amend.js': () => import('./workflows/amend.js'),
+    './workflows/stats.js': () => import('./workflows/stats.js'),
+    './workflows/undo.js': () => import('./workflows/undo.js'),
+    './workflows/release.js': () => import('./workflows/release.js'),
+    './workflows/repo-settings.js': () => import('./workflows/repo-settings.js'),
+    './workflows/trello-menu.js': () => import('./workflows/trello-menu.js'),
+    './workflows/settings.js': () => import('./workflows/settings.js'),
+    './core/github-setup.js': () => import('./core/github-setup.js'),
+    './core/gitlab-setup.js': () => import('./core/gitlab-setup.js'),
+    './workflows/doctor.js': () => import('./workflows/doctor.js'),
+};
+async function handleDryRunSetup(args) {
+    const { setDryRun, printDryRunBanner, printDryRunSummary } = await import('./utils/dry-run.js');
+    const hasOtherCommand = args.startAt !== undefined || args.activeFlags.size > 0;
+    if (!hasOtherCommand) {
+        // Standalone --dry-run: show interactive menu
         try {
-            const { handleRepoSettings } = await import('./workflows/repo-settings.js');
-            await handleRepoSettings();
+            const { handleDryRunMenu } = await import('./workflows/dry-run.js');
+            await handleDryRunMenu();
             process.exit(0);
         }
         catch (error) {
-            console.error('Repo settings error:', error);
+            console.error('Dry-run error:', error);
             process.exit(1);
         }
     }
-    if (showTrello) {
-        try {
-            const { showTrelloMenu } = await import('./workflows/trello-menu.js');
-            await showTrelloMenu();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Trello menu error:', error);
-            process.exit(1);
-        }
+    // Combo mode: activate dry-run, let normal routing handle it
+    setDryRun(true);
+    printDryRunBanner();
+    // Wrap process.exit to print summary before exiting
+    const originalExit = process.exit;
+    process.exit = ((code) => {
+        printDryRunSummary();
+        originalExit(code);
+    });
+}
+async function executeCommand(args) {
+    // 1. Version (instant, no imports)
+    if (args.showVersion) {
+        console.log(`Geeto v${VERSION}`);
+        process.exit(0);
     }
-    if (showTrelloLists) {
-        try {
-            const { handleGetTrelloLists } = await import('./workflows/trello-menu.js');
-            await handleGetTrelloLists();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Trello list error:', error);
-            process.exit(1);
-        }
+    // 2. Help (instant, no imports)
+    if (args.showHelp) {
+        showHelpMessage();
+        process.exit(0);
     }
-    if (showTrelloGenerate) {
-        try {
-            const { handleGenerateTaskInstructions } = await import('./workflows/trello-menu.js');
-            await handleGenerateTaskInstructions();
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Trello generate error:', error);
-            process.exit(1);
-        }
+    // 3. Dry-run mode setup (must run before other commands)
+    if (args.dryRunMode) {
+        await handleDryRunSetup(args);
     }
-    if (settingsAction) {
-        try {
-            const { handleSeparatorSetting, handleModelResetSetting, handleChangeModelSetting, handleGeminiSetting, handleOpenRouterSetting, handleTrelloSetting, } = await import('./workflows/settings.js');
-            switch (settingsAction) {
-                case 'separator': {
-                    await handleSeparatorSetting();
-                    break;
-                }
-                case 'models': {
-                    await handleModelResetSetting();
-                    break;
-                }
-                case 'change-model': {
-                    await handleChangeModelSetting();
-                    break;
-                }
-                case 'gemini': {
-                    await handleGeminiSetting();
-                    break;
-                }
-                case 'openrouter': {
-                    await handleOpenRouterSetting();
-                    break;
-                }
-                case 'trello': {
-                    await handleTrelloSetting();
-                    break;
-                }
-                case 'github': {
-                    const { setupGithubConfigInteractive } = await import('./core/github-setup.js');
-                    setupGithubConfigInteractive();
-                    break;
+    // 4. Registry commands — first match wins
+    for (const cmd of COMMAND_REGISTRY) {
+        if (args.activeFlags.has(cmd.flag)) {
+            try {
+                const loader = MODULE_LOADERS[cmd.module];
+                if (!loader)
+                    throw new Error(`No module loader for ${cmd.module}`);
+                const mod = (await loader());
+                const handlerFn = mod[cmd.handler];
+                if (handlerFn) {
+                    await handlerFn();
                 }
+                process.exit(0);
+            }
+            catch (error) {
+                console.error(`${cmd.errorLabel} error:`, error);
+                process.exit(1);
             }
-            process.exit(0);
-        }
-        catch (error) {
-            console.error('Settings error:', error);
-            process.exit(1);
         }
     }
-    // Pass stageAll flag into main so workflows can auto-stage all changes
-    // Start the application with optional start step
-    main({ startAt, fresh, resume, stageAll }).catch((error) => {
+    // 6. Default: run main workflow
+    const { main } = await import('./workflows/main.js');
+    main({
+        startAt: args.startAt,
+        fresh: args.fresh,
+        resume: args.resume,
+        stageAll: args.stageAll,
+    }).catch((error) => {
         console.error('Fatal error:', error);
         process.exit(1);
     });
-})();
+}
+// ─── Entry Point ─────────────────────────────────────────────────────
+const argv = process.argv.slice(2);
+// Validate unknown flags
+for (const arg of argv) {
+    if (arg.startsWith('-') && !validFlags.has(arg)) {
+        console.error(`Unknown flag: ${arg}`);
+        console.error('Use --help to see available options');
+        process.exit(1);
+    }
+}
+const args = parseArgs(argv);
+void executeCommand(args);
 //# sourceMappingURL=index.js.map