@idea1/cli 1.0.0

package/README.md

@@ -0,0 +1,160 @@
+# Idea1 CLI
+
+CLI tool for Idea1.ai workflow automation - AI-assisted development workflows.
+
+## Installation
+
+```bash
+npm install -g idea1
+```
+
+## Usage
+
+### Headless Mode
+
+Run commands directly from the command line:
+
+```bash
+# Start implementing a project item
+idea1 start-project-item https://app.idea1.ai/project/items/590
+idea1 -s https://app.idea1.ai/project/items/590
+
+# Start with custom options
+idea1 -s https://app.idea1.ai/project/items/590 --base-branch main
+idea1 -s https://app.idea1.ai/project/items/590 -b prompt
+
+# Close worktree and create PR
+idea1 close-worktree
+idea1 -c
+idea1 -c --prompt-pr
+
+# Show help
+idea1 --help
+idea1 -h
+```
+
+### Interactive Mode
+
+Run `idea1` without arguments to enter interactive mode with a searchable command interface:
+
+```
+$ idea1
+
+╭──────────────────────────────────────────────────╮
+│                                                  │
+│   Idea1 CLI v1.0.0                               │
+│   ~/src/my-repo-name                             │
+│                                                  │
+╰──────────────────────────────────────────────────╯
+
+Available commands:
+  /start-project-item (s) - Start implementing a project item in an isolated environment
+  /close-worktree (c) - Close current worktree, commit changes, and create PR
+  /help (h, ?) - Show help information
+  /exit (q, quit) - Exit the CLI
+
+> [Search and select commands using arrow keys and Enter]
+```
+
+## Commands
+
+### start-project-item
+
+Start implementing an Idea1.ai project item in an isolated git worktree.
+
+```bash
+idea1 start-project-item <url> [branch-name] [options]
+idea1 -s <url> [branch-name] [options]
+```
+
+**Arguments:**
+- `<url>` - The Idea1.ai project item URL (required)
+- `[branch-name]` - Custom branch name (optional, auto-generated from item description if not provided)
+
+**Options:**
+- `-m, --isolation-mode <mode>` - Isolation mode: `worktree` (default) or `container`
+- `-p, --source-path <path>` - Path to source directory
+- `-b, --base-branch <branch>` - Base branch (default: `working/release`). Use `prompt` to interactively select.
+- `--build-image` - Force rebuild of Docker image (container mode only)
+- `--disable-firewall` - Disable network firewall (container mode only)
+
+**What it does:**
+1. Sets the item's workflow status to "Agent implementation"
+2. Generates a branch name from the item description (if not provided)
+3. Creates a new branch from the base branch
+4. Creates a git worktree for isolated development
+5. Runs any setup hooks defined in `.idea1/settings.json`
+6. Launches Claude Code with the implementation prompt
+
+### close-worktree
+
+Close the current worktree, commit changes, and create a PR.
+
+```bash
+idea1 close-worktree [options]
+idea1 -c [options]
+```
+
+**Options:**
+- `-p, --source-path <path>` - Path to worktree directory
+- `-b, --base-branch <branch>` - Base branch for PR (uses stored preference by default)
+- `--prompt-pr` - Prompt before creating PR
+
+**What it does:**
+1. Detects uncommitted changes and prompts for project item URL if needed
+2. Commits and pushes changes
+3. Creates a PR (or confirms existing PR)
+4. Updates the item's workflow status to "Dev implementation"
+5. Removes the git worktree
+6. Cleans up orphaned branch configs
+
+## Configuration
+
+### Repository Settings
+
+Create `.idea1/settings.json` in your repository root to configure hooks:
+
+```json
+{
+  "hooks": {
+    "setup-worktree": "dev/workflow/setup-worktree.sh"
+  }
+}
+```
+
+**Hooks:**
+- `setup-worktree` - Script to run after creating a new worktree (e.g., install dependencies)
+
+### User Settings
+
+User settings are stored in the XDG-compliant config directory:
+- macOS: `~/Library/Preferences/idea1-cli/`
+- Linux: `~/.config/idea1-cli/`
+- Windows: `%APPDATA%/idea1-cli/`
+
+Settings include:
+- `defaultBaseBranch` - Default base branch (default: `working/release`)
+- `defaultIsolationMode` - Default isolation mode (default: `worktree`)
+
+## Requirements
+
+- Node.js 20+
+- Git
+- GitHub CLI (`gh`) - for PR operations
+- Claude Code CLI (`claude`) - for AI-assisted development
+
+## Development
+
+```bash
+# Build the CLI
+npm run build
+
+# Run in development mode (watch for changes)
+npm run dev
+
+# Link globally for testing
+npm link
+
+# Run the CLI
+idea1 --help
+```

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+/**
+ * Create and configure the CLI program
+ */
+export declare function createProgram(): Command;
+/**
+ * Run the CLI
+ */
+export declare function runCli(argv: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAgGvC;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1D"}

package/dist/cli.js

@@ -0,0 +1,105 @@
+import { Command } from 'commander';
+import { startProjectItemCommand, closeWorktreeCommand, helpCommand } from './commands/index.js';
+import { runInteractiveMode } from './interactive.js';
+import { logger } from './lib/logger.js';
+const VERSION = '1.0.0';
+/**
+ * Create and configure the CLI program
+ */
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('idea1')
+        .description('CLI tool for Idea1.ai workflow automation - AI-assisted development workflows')
+        .version(VERSION, '-v, --version', 'Output the current version');
+    // Start project item command
+    program
+        .command('start-project-item <url> [branch-name]')
+        .alias('s')
+        .description('Start implementing a project item in an isolated environment')
+        .option('-m, --isolation-mode <mode>', 'Isolation mode: worktree (default) or container', 'worktree')
+        .option('-p, --source-path <path>', 'Path to source directory')
+        .option('-b, --base-branch <branch>', 'Base branch (default: working/release)', 'working/release')
+        .option('--build-image', 'Force rebuild of Docker image (container mode)')
+        .option('--disable-firewall', 'Disable network firewall (container mode)')
+        .action(async (url, branchName, options) => {
+        try {
+            const args = [url];
+            if (branchName) {
+                args.push(branchName);
+            }
+            if (options.isolationMode && options.isolationMode !== 'worktree') {
+                args.unshift('-m', options.isolationMode);
+            }
+            if (options.sourcePath) {
+                args.unshift('-p', options.sourcePath);
+            }
+            if (options.baseBranch && options.baseBranch !== 'working/release') {
+                args.unshift('-b', options.baseBranch);
+            }
+            if (options.buildImage) {
+                args.unshift('--build-image');
+            }
+            if (options.disableFirewall) {
+                args.unshift('--disable-firewall');
+            }
+            await startProjectItemCommand.execute(args);
+        }
+        catch (error) {
+            const err = error;
+            logger.error(err.message);
+            process.exit(1);
+        }
+    });
+    // Close worktree command
+    program
+        .command('close-worktree')
+        .alias('c')
+        .description('Close current worktree, commit changes, and create PR')
+        .option('-p, --source-path <path>', 'Path to worktree directory')
+        .option('-b, --base-branch <branch>', 'Base branch for PR')
+        .option('--prompt-pr', 'Prompt before creating PR')
+        .action(async (options) => {
+        try {
+            const args = [];
+            if (options.sourcePath) {
+                args.push('-p', options.sourcePath);
+            }
+            if (options.baseBranch) {
+                args.push('-b', options.baseBranch);
+            }
+            if (options.promptPr) {
+                args.push('--prompt-pr');
+            }
+            await closeWorktreeCommand.execute(args);
+        }
+        catch (error) {
+            const err = error;
+            logger.error(err.message);
+            process.exit(1);
+        }
+    });
+    // Help command (also available as --help by default)
+    program
+        .command('help')
+        .alias('h')
+        .description('Show help information')
+        .action(async () => {
+        await helpCommand.execute([]);
+    });
+    return program;
+}
+/**
+ * Run the CLI
+ */
+export async function runCli(argv) {
+    const program = createProgram();
+    // If no arguments provided, run interactive mode
+    if (argv.length <= 2) {
+        await runInteractiveMode();
+        return;
+    }
+    // Parse and execute command
+    await program.parseAsync(argv);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/close-worktree.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from '../types/index.js';
+export declare const closeWorktreeCommand: Command;
+//# sourceMappingURL=close-worktree.d.ts.map

package/dist/commands/close-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-worktree.d.ts","sourceRoot":"","sources":["../../src/commands/close-worktree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAwB,MAAM,mBAAmB,CAAC;AAwHvE,eAAO,MAAM,oBAAoB,EAAE,OA8GlC,CAAC"}

package/dist/commands/close-worktree.js

@@ -0,0 +1,184 @@
+import { logger } from '../lib/logger.js';
+import * as git from '../services/git.js';
+import * as github from '../services/github.js';
+import * as claude from '../services/claude.js';
+import { configService } from '../services/config.js';
+import inquirer from 'inquirer';
+/**
+ * Parse command line arguments for close-worktree
+ */
+function parseArgs(args) {
+    const options = {
+        promptPr: false
+    };
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        switch (arg) {
+            case '--source-path':
+            case '-p':
+                i++;
+                options.sourcePath = args[i];
+                break;
+            case '--base-branch':
+            case '-b':
+                i++;
+                options.baseBranch = args[i];
+                break;
+            case '--prompt-pr':
+                options.promptPr = true;
+                break;
+            default:
+                if (arg.startsWith('-')) {
+                    throw new Error(`Unknown option: ${arg}`);
+                }
+                throw new Error(`Unexpected argument: ${arg}`);
+        }
+        i++;
+    }
+    return options;
+}
+/**
+ * Prompt for project item URL
+ */
+async function promptProjectItemUrl() {
+    const { url } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'url',
+            message: 'Please paste the project item URL:',
+            validate: (input) => input.trim() ? true : 'Project item URL is required'
+        }
+    ]);
+    return url.trim();
+}
+/**
+ * Ask whether to create a PR
+ */
+async function askCreatePr() {
+    const { createPr } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'createPr',
+            message: 'No PR exists for this branch. Would you like to create one?',
+            default: true
+        }
+    ]);
+    return createPr;
+}
+/**
+ * Resolve base branch using hierarchical resolution:
+ * 1. Command-line parameter (if provided)
+ * 2. Existing PR (authoritative)
+ * 3. Stored preference in git config
+ * 4. Default to working/release
+ */
+async function resolveBaseBranch(cliBaseBranch, branchName) {
+    // 1. Command-line parameter
+    if (cliBaseBranch) {
+        logger.dim(`Using command-line base branch: ${cliBaseBranch}`);
+        return cliBaseBranch;
+    }
+    // 2. Existing PR (authoritative)
+    const prBaseBranch = await github.getPrBaseBranch(branchName);
+    if (prBaseBranch) {
+        logger.dim(`Using base branch from existing PR: ${prBaseBranch}`);
+        return prBaseBranch;
+    }
+    // 3. Stored preference in git config
+    const storedBaseBranch = await git.getBaseBranch(branchName);
+    if (storedBaseBranch) {
+        logger.dim(`Using stored base branch: ${storedBaseBranch}`);
+        return storedBaseBranch;
+    }
+    // 4. Default
+    const defaultBranch = configService.getDefaultBaseBranch();
+    logger.dim(`Using default base branch: ${defaultBranch}`);
+    return defaultBranch;
+}
+export const closeWorktreeCommand = {
+    name: 'close-worktree',
+    aliases: ['c', 'close'],
+    description: 'Close current worktree, commit changes, and create PR',
+    async execute(args) {
+        const options = parseArgs(args);
+        // Navigate to source path if provided
+        if (options.sourcePath) {
+            process.chdir(options.sourcePath);
+        }
+        // Get the main repository root dynamically
+        const mainRepoRoot = await git.getMainRepoRoot();
+        // Get repository name
+        const repoName = await git.getRepoName();
+        // Get current branch
+        const fullBranchName = await git.getCurrentBranch();
+        // Extract short branch name (remove "working/agent/" prefix)
+        const shortBranchName = fullBranchName.replace(/^working\/agent\//, '');
+        logger.info(`Current branch: ${fullBranchName} -> short name: ${shortBranchName}`);
+        if (!shortBranchName) {
+            throw new Error('Could not extract branch name');
+        }
+        // Get worktree root path
+        const worktreeRootPath = process.cwd();
+        // Retrieve stored project item URL from git config
+        let projectItemUrl = await git.getProjectItemUrl(fullBranchName);
+        if (projectItemUrl) {
+            logger.dim(`Found stored project item URL: ${projectItemUrl}`);
+        }
+        // Resolve base branch
+        const baseBranchName = await resolveBaseBranch(options.baseBranch, fullBranchName);
+        // Check for uncommitted changes
+        const hasChanges = await git.hasUncommittedChanges();
+        if (hasChanges) {
+            logger.newline();
+            logger.info('Uncommitted changes detected in worktree.');
+            logger.newline();
+            // Prompt for URL if not stored
+            if (!projectItemUrl) {
+                projectItemUrl = await promptProjectItemUrl();
+            }
+            // Commit and push changes
+            const commitMessage = projectItemUrl
+                ? `Agent implementation of ${projectItemUrl} on ${fullBranchName}`
+                : `Changes on ${fullBranchName}`;
+            await git.commitAllChanges(commitMessage);
+            await git.pushToRemote(fullBranchName);
+            logger.success('Changes pushed successfully');
+        }
+        else {
+            logger.dim('No uncommitted changes detected.');
+        }
+        // Check if PR exists
+        const existingPr = await github.checkPrExists(fullBranchName, baseBranchName);
+        if (!existingPr) {
+            logger.newline();
+            let shouldCreatePr = true;
+            if (options.promptPr) {
+                shouldCreatePr = await askCreatePr();
+            }
+            if (shouldCreatePr) {
+                // Prompt for URL if not available
+                if (!projectItemUrl) {
+                    projectItemUrl = await promptProjectItemUrl();
+                }
+                // Create PR
+                await github.createPrIfNeeded(fullBranchName, baseBranchName, projectItemUrl);
+            }
+        }
+        else {
+            logger.info(`PR #${existingPr.number} already exists for this branch.`);
+        }
+        // Update idea1.ai workflow status to "Dev implementation"
+        if (projectItemUrl) {
+            await claude.setWorkflowStatus(projectItemUrl, 'Dev implementation');
+        }
+        // Navigate to main repo root
+        process.chdir(mainRepoRoot);
+        // Remove git worktree
+        await git.removeWorktree(worktreeRootPath);
+        // Garbage collect orphaned branch configs
+        await git.gcOrphanedBranchConfigs();
+        logger.success('Done.');
+    }
+};
+//# sourceMappingURL=close-worktree.js.map

package/dist/commands/close-worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-worktree.js","sourceRoot":"","sources":["../../src/commands/close-worktree.ts"],"names":[],"mappings":"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"}

package/dist/commands/help.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from '../types/index.js';
+export declare const helpCommand: Command;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,eAAO,MAAM,WAAW,EAAE,OAgDzB,CAAC"}

package/dist/commands/help.js

@@ -0,0 +1,45 @@
+import { logger } from '../lib/logger.js';
+import chalk from 'chalk';
+export const helpCommand = {
+    name: 'help',
+    aliases: ['h', '?'],
+    description: 'Show help information',
+    async execute(_args) {
+        logger.newline();
+        console.log(chalk.bold('Idea1 CLI - AI-assisted development workflow automation'));
+        logger.newline();
+        console.log(chalk.bold('USAGE:'));
+        console.log('  idea1 [command] [options]');
+        console.log('  idea1                           Launch interactive mode');
+        logger.newline();
+        console.log(chalk.bold('COMMANDS:'));
+        console.log('  start-project-item, -s <url>    Start implementing a project item');
+        console.log('  close-worktree, -c              Close current worktree and create PR');
+        console.log('  help, -h                        Show this help message');
+        logger.newline();
+        console.log(chalk.bold('START-PROJECT-ITEM OPTIONS:'));
+        console.log('  --isolation-mode, -m <mode>     Isolation mode: worktree (default) or container');
+        console.log('  --source-path, -p <path>        Path to source directory');
+        console.log('  --base-branch, -b <branch>      Base branch (default: working/release)');
+        console.log('                                  Use "prompt" to interactively select');
+        console.log('  --build-image                   Force rebuild of Docker image (container mode)');
+        console.log('  --disable-firewall              Disable network firewall (container mode)');
+        logger.newline();
+        console.log(chalk.bold('CLOSE-WORKTREE OPTIONS:'));
+        console.log('  --source-path, -p <path>        Path to worktree directory');
+        console.log('  --base-branch, -b <branch>      Base branch for PR');
+        console.log('  --prompt-pr                     Prompt before creating PR');
+        logger.newline();
+        console.log(chalk.bold('EXAMPLES:'));
+        console.log('  idea1 -s https://app.idea1.ai/project/items/590');
+        console.log('  idea1 --start-project-item https://app.idea1.ai/project/items/590 -b main');
+        console.log('  idea1 -c');
+        console.log('  idea1 --close-worktree --prompt-pr');
+        logger.newline();
+        console.log(chalk.bold('INTERACTIVE MODE:'));
+        console.log('  Run "idea1" without arguments to enter interactive mode.');
+        console.log('  Use slash commands: /start-project-item, /close-worktree, /help, /exit');
+        logger.newline();
+    }
+};
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACnB,WAAW,EAAE,uBAAuB;IAEpC,KAAK,CAAC,OAAO,CAAC,KAAe;QAC3B,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QACxE,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;QAChG,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC;QACxF,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;CACF,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from '../types/index.js';
+import { startProjectItemCommand } from './start-project-item.js';
+import { closeWorktreeCommand } from './close-worktree.js';
+import { helpCommand } from './help.js';
+/**
+ * Get a command by name or alias
+ */
+export declare function getCommand(nameOrAlias: string): Command | undefined;
+/**
+ * Get all unique commands (excludes aliases)
+ */
+export declare function getAllCommands(): Command[];
+/**
+ * Get all command names and aliases for autocomplete
+ */
+export declare function getAllCommandNamesAndAliases(): string[];
+export { startProjectItemCommand, closeWorktreeCommand, helpCommand };
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAyBxC;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,EAAE,CAM1C;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD;AAED,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,46 @@
+import { startProjectItemCommand } from './start-project-item.js';
+import { closeWorktreeCommand } from './close-worktree.js';
+import { helpCommand } from './help.js';
+/**
+ * Command registry - Map-based for O(1) lookup
+ */
+const commandRegistry = new Map();
+/**
+ * Register a command in the registry
+ */
+function registerCommand(command) {
+    // Register by name
+    commandRegistry.set(command.name, command);
+    // Register by aliases
+    for (const alias of command.aliases) {
+        commandRegistry.set(alias, command);
+    }
+}
+// Register all commands
+registerCommand(startProjectItemCommand);
+registerCommand(closeWorktreeCommand);
+registerCommand(helpCommand);
+/**
+ * Get a command by name or alias
+ */
+export function getCommand(nameOrAlias) {
+    return commandRegistry.get(nameOrAlias);
+}
+/**
+ * Get all unique commands (excludes aliases)
+ */
+export function getAllCommands() {
+    const uniqueCommands = new Set();
+    for (const command of commandRegistry.values()) {
+        uniqueCommands.add(command);
+    }
+    return Array.from(uniqueCommands);
+}
+/**
+ * Get all command names and aliases for autocomplete
+ */
+export function getAllCommandNamesAndAliases() {
+    return Array.from(commandRegistry.keys());
+}
+export { startProjectItemCommand, closeWorktreeCommand, helpCommand };
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;GAEG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEnD;;GAEG;AACH,SAAS,eAAe,CAAC,OAAgB;IACvC,mBAAmB;IACnB,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3C,sBAAsB;IACtB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,eAAe,CAAC,uBAAuB,CAAC,CAAC;AACzC,eAAe,CAAC,oBAAoB,CAAC,CAAC;AACtC,eAAe,CAAC,WAAW,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,OAAO,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,cAAc,GAAG,IAAI,GAAG,EAAW,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;QAC/C,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAC"}

package/dist/commands/start-project-item.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from '../types/index.js';
+export declare const startProjectItemCommand: Command;
+//# sourceMappingURL=start-project-item.d.ts.map

package/dist/commands/start-project-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-project-item.d.ts","sourceRoot":"","sources":["../../src/commands/start-project-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA2B,MAAM,mBAAmB,CAAC;AA+L1E,eAAO,MAAM,uBAAuB,EAAE,OAqErC,CAAC"}