@idea1/cli 1.2.3 → 1.3.1

package/README.md

@@ -25,66 +25,23 @@ idea1 ready-for-approval john   # or: idea1 rfa john
 idea1 approve-pr                # or: idea1 approve
 idea1 next-workflow-step        # or: idea1 next
 
-# Create a new worktree (without a project item)
-idea1 create-worktree my-feature
-idea1 -w my-feature -d main
-
-# Commit, push, and create PR
-idea1 push
-idea1 -p --no-tests
-
-# Close worktree and create PR
-idea1 close-worktree
-idea1 -c --prompt-pr
-
-# Update documentation
-idea1 update-docs
-
 # Show help
 idea1 --help
 ```
 
 ### Interactive Mode
 
-Run `idea1` without arguments to enter interactive mode with a searchable command interface:
+Run `idea1` without arguments to enter interactive mode with a searchable command interface.
 
-```
-$ idea1
-
-╭──────────────────────────────────────────────────╮
-│                                                  │
-│   Idea1 CLI v1.1.1                               │
-│   ~/src/my-repo-name                             │
-│                                                  │
-│   Branch: working/agent/my-feature               │
-│   Base: working/release                          │
-│   Workflow: Agent implementation                 │
-│   Item: https://app.idea1.ai/project/items/123   │
-│                                                  │
-╰──────────────────────────────────────────────────╯
-
-Available commands:
-  /start-project-item (s, start) - Start implementing a project item
-  /start-dev-implementation (dev) - Transition to dev implementation
-  /ready-for-approval (rfa) - Mark PR ready for approval
-  /approve-pr (approve) - Approve and merge PR
-  /next-workflow-step (next, n) - Auto-perform next transition
-  /close-worktree (c, close) - Close current worktree and create PR
-  /push (p, push-changes) - Commit, push changes, and create PR
-  /update-docs (docs) - Update README.md for changed folders
-  /help (h) - Show help information
-  /exit (q, quit) - Exit the CLI
-
-> [Type "/" to see commands, use arrow keys and tab to navigate, Enter to select]
-```
+## Commands
+
+## Workflow Commands
 
-When a branch is under workflow management, the header displays:
-- **Branch**: Current branch name
-- **Base**: Base branch for PRs
-- **Workflow**: Current workflow state (color-coded)
-- **Item**: Associated Idea1.ai project item URL
+The CLI provides a complete workflow automation system with state tracking. The workflow progresses through these states:
 
-## Commands
+```
+Agent Implementation → Dev Implementation → PR needs Approval → Complete
+```
 
 ### start-project-item
 
@@ -100,12 +57,10 @@ idea1 -s <url> [branch-name] [options]
 - `[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` (not yet implemented)
 - `-p, --source-path <path>` - Path to source directory
 - `-b, --base-branch <branch>` - Base branch (default: `working/release`). Use `prompt` to interactively select.
 - `-pm, --permission-mode <mode>` - Claude permission mode (default: `plan`). Valid values: `acceptEdits`, `bypassPermissions`, `default`, `delegate`, `dontAsk`, `plan`
-- `--build-image` - Force rebuild of Docker image (container mode only, not yet implemented)
-- `--disable-firewall` - Disable network firewall (container mode only, not yet implemented)
+- `--claude-entry-point <mode>` - How Claude is invoked after setup (default: `launch`). Valid values: `launch` (start a new Claude session), `inline` (output structured prompt for an already-running Claude session), `none` (do not invoke Claude)
 
 **What it does:**
 1. Sets the item's workflow status to "Agent implementation"
@@ -115,98 +70,9 @@ idea1 -s <url> [branch-name] [options]
 5. Runs any setup hooks defined in `.idea1/settings.json`
 6. Launches Claude Code with the implementation prompt
 
-### create-worktree
-
-Create a new branch and git worktree for development (without a project item).
-
-```bash
-idea1 create-worktree <branch-name> [options]
-idea1 -w <branch-name> [options]
-```
-
-**Arguments:**
-- `<branch-name>` - Name for the new branch (required)
-
-**Options:**
-- `-d, --dest-branch <branch>` - Base branch to branch from (default: from settings or `working/release`)
-- `-p, --branch-prefix <prefix>` - Prefix for new branch (default: from settings or `working/agent`)
-- `-s, --source-path <path>` - Path to source directory
-
-**What it does:**
-1. Creates a new branch from the base branch
-2. Creates a git worktree for isolated development
-3. Runs any setup hooks defined in `.idea1/settings.json`
-
-### push
-
-Commit and push changes, optionally creating a PR.
-
-```bash
-idea1 push [options]
-idea1 -p [options]
-```
-
-**Options:**
-- `-i, --project-item-url <url>` - Project item URL for commit message
-- `--no-project-item` - Skip project item URL
-- `--no-tests` - Skip running tests before PR creation
-- `--create-pr <true|false>` - Whether to create PR (default: true)
-- `-d, --dest-branch <branch>` - PR target branch
-
-**What it does:**
-1. Commits all changes with a descriptive message
-2. Pushes to remote
-3. Runs tests if configured (skippable with `--no-tests`)
-4. Creates a PR if requested
-
-### 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
-
-### update-docs
-
-Update README.md files for folders with code changes.
-
-```bash
-idea1 update-docs
-idea1 docs
-```
-
-**What it does:**
-1. Finds all folders with staged, unstaged, or PR file changes
-2. Classifies changes as "small" or "large" to determine update strategy
-3. Uses Claude to update or create README.md files
-4. Respects `.contextignore` patterns to skip folders
-
-## Workflow Commands
-
-The CLI provides a complete workflow automation system with state tracking. The workflow progresses through these states:
-
-```
-Agent Implementation → Dev Implementation → PR needs Approval → Complete
-```
-
 ### start-dev-implementation
 
-Transition from agent implementation to dev implementation - creates PR and closes worktree.
+Transition from agent implementation to dev implementation - commits, pushes, and creates PR.
 
 ```bash
 idea1 start-dev-implementation [options]
@@ -220,7 +86,7 @@ idea1 dev [options]
 1. Validates current state is "Agent implementation"
 2. Commits and pushes all changes in the branch
 3. Creates a PR of the branch into its base branch
-4. If in a worktree, closes the worktree and deletes the worktree folder
+4. If in a worktree and `removeWorktreeOnDevTransition` is enabled in `.idea1/settings.json`, removes the worktree
 5. Updates workflow state to "Dev implementation"
 6. Updates Idea1.ai workflow status
 
@@ -245,6 +111,7 @@ idea1 rfa [reviewer] [options]
 3. Assigns reviewer to the PR (if provided)
 4. Updates workflow state to "PR needs Approval"
 5. Updates Idea1.ai workflow status
+6. If in a worktree, removes the worktree
 
 ### approve-pr
 
@@ -317,6 +184,7 @@ Create `.idea1/settings.json` in your repository root to configure repo-specific
 - `branchPrefix` - Prefix for new branches (default: `working/agent`)
 - `baseBranch` - Default base branch for branching (default: `working/release`)
 - `testCommand` - Command to run tests before PR creation (e.g., `npm run test`)
+- `removeWorktreeOnDevTransition` - Whether to remove the worktree when transitioning to dev implementation (default: `false`). The `ready-for-approval` transition always removes the worktree if running inside one.
 
 ### User Settings
 
@@ -343,16 +211,15 @@ Settings include:
 # Build the CLI
 npm run build
 
-# Run in development mode (watch for changes)
-npm run dev
+# Run directly from the local source code
+npm run start
 
 # Link globally for testing
 npm link
 
-# Run the CLI
+# Install the CLI from the latest published idea1 command package
+npm install -g @idea1/cli
+
+# Run the CLI from the current installed idea1 command package
 idea1 --help
 ```
-
-## License
-
-MIT

package/dist/cli/parser.d.ts

@@ -0,0 +1,20 @@
+import type { Command, CommandOption } from '../types/index.js';
+/**
+ * Resolve the default value of an option (handles static and dynamic defaults)
+ */
+export declare function resolveDefault(option: CommandOption): string | undefined;
+/**
+ * Parse command line arguments for a given command.
+ * All arguments must be named: --longName value or -shortName value.
+ * Flags set their value to "true".
+ */
+export declare function parseCommandLine(args: string[], command: Command): Record<string, string>;
+/**
+ * Print global usage listing all commands
+ */
+export declare function printUsage(): void;
+/**
+ * Print per-command usage with all options
+ */
+export declare function printCommandUsage(command: Command): void;
+//# sourceMappingURL=parser.d.ts.map

package/dist/cli/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/cli/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkCzF;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAsBjC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyCxD"}

package/dist/cli/parser.js

@@ -0,0 +1,105 @@
+import chalk from 'chalk';
+import { getAllCommands } from '../commands/index.js';
+/**
+ * Resolve the default value of an option (handles static and dynamic defaults)
+ */
+export function resolveDefault(option) {
+    if (option.defaultValue === undefined)
+        return undefined;
+    return typeof option.defaultValue === 'function' ? option.defaultValue() : option.defaultValue;
+}
+/**
+ * Parse command line arguments for a given command.
+ * All arguments must be named: --longName value or -shortName value.
+ * Flags set their value to "true".
+ */
+export function parseCommandLine(args, command) {
+    const options = command.options ?? [];
+    const parsed = {};
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (!arg.startsWith('-')) {
+            throw new Error(`Unexpected argument: ${arg}. All arguments must be named (--option value or -o value).`);
+        }
+        const matchedOption = options.find(o => arg === `--${o.longName}` || (o.shortName && arg === `-${o.shortName}`));
+        if (!matchedOption) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        if (matchedOption.isFlag) {
+            parsed[matchedOption.longName] = 'true';
+        }
+        else {
+            i++;
+            if (i >= args.length) {
+                throw new Error(`Option ${arg} requires a value`);
+            }
+            parsed[matchedOption.longName] = args[i];
+        }
+        i++;
+    }
+    return parsed;
+}
+/**
+ * Print global usage listing all commands
+ */
+export function printUsage() {
+    const commands = getAllCommands();
+    console.log(chalk.bold('Idea1 CLI - AI-assisted development workflow automation'));
+    console.log();
+    console.log(chalk.bold('USAGE:'));
+    console.log('  idea1 <command> [options]');
+    console.log('  idea1                           Launch interactive mode');
+    console.log();
+    console.log(chalk.bold('COMMANDS:'));
+    const maxWidth = Math.max(...commands.map(c => c.name.length));
+    for (const cmd of commands) {
+        const aliases = cmd.aliases.length > 0 ? chalk.dim(` (${cmd.aliases.join(', ')})`) : '';
+        const padding = ' '.repeat(maxWidth - cmd.name.length + 2);
+        console.log(`  ${cmd.name}${padding}${cmd.description}${aliases}`);
+    }
+    console.log();
+    console.log("Run 'idea1 <command> --help' for command-specific options.");
+    console.log();
+}
+/**
+ * Print per-command usage with all options
+ */
+export function printCommandUsage(command) {
+    const options = command.options ?? [];
+    console.log();
+    console.log(`Usage: idea1 ${command.name} [options]`);
+    console.log();
+    console.log(`  ${command.description}`);
+    if (options.length > 0) {
+        console.log();
+        console.log('Options:');
+        for (const option of options) {
+            const forms = option.shortName
+                ? `-${option.shortName}, --${option.longName}`
+                : `    --${option.longName}`;
+            let defaultText = '';
+            if (option.isFlag) {
+                defaultText = '';
+            }
+            else {
+                const resolved = resolveDefault(option);
+                if (resolved !== undefined) {
+                    defaultText = resolved ? ` (default: ${resolved})` : '';
+                }
+                else if (option.validate) {
+                    // Only mark as required when a validator exists to enforce it
+                    defaultText = ' (required)';
+                }
+            }
+            const padding = Math.max(0, 30 - forms.length);
+            console.log(`  ${forms}${' '.repeat(padding)} ${option.description}${defaultText}`);
+        }
+    }
+    if (command.aliases.length > 0) {
+        console.log();
+        console.log(`Aliases: ${command.aliases.join(', ')}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=parser.js.map

package/dist/cli/parser.js.map

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

package/dist/cli/resolver.d.ts

@@ -0,0 +1,16 @@
+import type { Command } from '../types/index.js';
+/**
+ * Resolve all options for a command.
+ * Fills in missing values by prompting interactively or using defaults.
+ *
+ * For each option in command.options (in order):
+ * 1. Skip if isFlag — flags are never prompted
+ * 2. Skip if already in parsed — value was provided on CLI
+ * 3. If has default and promptWhenDefaultExists is not true: silently use default
+ * 4. If no default: prompt (required — re-prompt until valid value given)
+ * 5. If has default and promptWhenDefaultExists is true: prompt showing default as hint
+ * 6. Use promptSelection if option has choices, else promptTextInput
+ * 7. If validate exists, check the value; re-prompt on error
+ */
+export declare function resolveOptions(command: Command, parsed: Record<string, string>): Promise<Record<string, string>>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/cli/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/cli/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoEjC"}

package/dist/cli/resolver.js

@@ -0,0 +1,72 @@
+import { promptTextInput, promptSelection } from '../interactive.js';
+import { resolveDefault } from './parser.js';
+/**
+ * Resolve all options for a command.
+ * Fills in missing values by prompting interactively or using defaults.
+ *
+ * For each option in command.options (in order):
+ * 1. Skip if isFlag — flags are never prompted
+ * 2. Skip if already in parsed — value was provided on CLI
+ * 3. If has default and promptWhenDefaultExists is not true: silently use default
+ * 4. If no default: prompt (required — re-prompt until valid value given)
+ * 5. If has default and promptWhenDefaultExists is true: prompt showing default as hint
+ * 6. Use promptSelection if option has choices, else promptTextInput
+ * 7. If validate exists, check the value; re-prompt on error
+ */
+export async function resolveOptions(command, parsed) {
+    const resolved = { ...parsed };
+    const options = command.options ?? [];
+    for (const option of options) {
+        // Skip flags — they're never prompted
+        if (option.isFlag) {
+            if (!(option.longName in resolved)) {
+                resolved[option.longName] = 'false';
+            }
+            continue;
+        }
+        // Skip if already provided on CLI
+        if (option.longName in resolved) {
+            // Validate if validator exists
+            if (option.validate) {
+                const error = option.validate(resolved[option.longName]);
+                if (error) {
+                    throw new Error(`Invalid value for --${option.longName}: ${error}`);
+                }
+            }
+            continue;
+        }
+        const defaultVal = resolveDefault(option);
+        const hasDefault = defaultVal !== undefined;
+        const promptWhenDefault = option.promptWhenDefaultExists !== false; // default true
+        // Has default and should NOT prompt: silently use default
+        if (hasDefault && !promptWhenDefault) {
+            resolved[option.longName] = defaultVal;
+            continue;
+        }
+        // Need to prompt — either required (no default) or has default with promptWhenDefaultExists
+        let value;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            if (option.choices && option.choices.length > 0) {
+                value = await promptSelection(option.description, option.choices, defaultVal);
+            }
+            else {
+                value = await promptTextInput(option.description, defaultVal);
+            }
+            // Validate — this is the sole mechanism for enforcing required/non-empty.
+            // Options that need non-empty values should declare a validate function.
+            if (option.validate) {
+                const error = option.validate(value);
+                if (error) {
+                    const { logger } = await import('../lib/logger.js');
+                    logger.error(error);
+                    continue; // Re-prompt
+                }
+            }
+            break;
+        }
+        resolved[option.longName] = value ?? '';
+    }
+    return resolved;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/cli/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/cli/resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgB,EAChB,MAA8B;IAE9B,MAAM,QAAQ,GAA2B,EAAE,GAAG,MAAM,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IAEtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,sCAAsC;QACtC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC;gBACnC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;YACtC,CAAC;YACD,SAAS;QACX,CAAC;QAED,kCAAkC;QAClC,IAAI,MAAM,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,+BAA+B;YAC/B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,UAAU,KAAK,SAAS,CAAC;QAC5C,MAAM,iBAAiB,GAAG,MAAM,CAAC,uBAAuB,KAAK,KAAK,CAAC,CAAC,eAAe;QAEnF,0DAA0D;QAC1D,IAAI,UAAU,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACrC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;YACvC,SAAS;QACX,CAAC;QAED,4FAA4F;QAC5F,IAAI,KAAyB,CAAC;QAE9B,iDAAiD;QACjD,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,KAAK,GAAG,MAAM,eAAe,CAC3B,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,OAAO,EACd,UAAU,CACX,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAChE,CAAC;YAED,0EAA0E;YAC1E,yEAAyE;YACzE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;oBACpD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACpB,SAAS,CAAC,YAAY;gBACxB,CAAC;YACH,CAAC;YAED,MAAM;QACR,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli.d.ts

@@ -1,8 +1,3 @@
-import { Command } from 'commander';
-/**
- * Create and configure the CLI program
- */
-export declare function createProgram(): Command;
 /**
  * Run the CLI
  */

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA0TvC;AAiBD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkF1D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmE1D"}