@shepai/cli 1.18.0 → 1.20.0

package/dist/src/presentation/cli/commands/ide-open.command.js

@@ -0,0 +1,77 @@
+/**
+ * IDE Open Command
+ *
+ * Opens a feature worktree in the configured IDE.
+ *
+ * Usage: shep ide <feat-id> [--vscode|--cursor|--windsurf|--zed|--antigravity]
+ */
+import { Command } from 'commander';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { EditorType } from '../../../domain/generated/output.js';
+import { container } from '../../../infrastructure/di/container.js';
+import { ShowFeatureUseCase } from '../../../application/use-cases/features/show-feature.use-case.js';
+import { getSettings } from '../../../infrastructure/services/settings.service.js';
+import { createLauncherRegistry } from '../../../infrastructure/services/ide-launchers/ide-launcher.registry.js';
+import { SHEP_HOME_DIR } from '../../../infrastructure/services/filesystem/shep-directory.service.js';
+import { messages } from '../ui/index.js';
+function computeWorktreePath(repoPath, branch) {
+    const repoHash = createHash('sha256').update(repoPath).digest('hex').slice(0, 16);
+    const slug = branch.replace(/\//g, '-');
+    return join(SHEP_HOME_DIR, 'repos', repoHash, 'wt', slug);
+}
+/** IDE flag names mapped to their EditorType values. */
+const IDE_FLAG_MAP = {
+    vscode: EditorType.VsCode,
+    cursor: EditorType.Cursor,
+    windsurf: EditorType.Windsurf,
+    zed: EditorType.Zed,
+    antigravity: EditorType.Antigravity,
+};
+/**
+ * Determine which editor to use based on CLI flags and settings.
+ * Flag takes precedence over settings.
+ */
+function resolveEditorId(options) {
+    for (const [flag, editorType] of Object.entries(IDE_FLAG_MAP)) {
+        if (options[flag]) {
+            return editorType;
+        }
+    }
+    return getSettings().environment.defaultEditor;
+}
+export function createIdeOpenCommand() {
+    return new Command('ide')
+        .description('Open a feature worktree in your IDE')
+        .argument('<feat-id>', 'Feature ID or prefix')
+        .option('--vscode', 'Open in VS Code')
+        .option('--cursor', 'Open in Cursor')
+        .option('--windsurf', 'Open in Windsurf')
+        .option('--zed', 'Open in Zed')
+        .option('--antigravity', 'Open in Antigravity')
+        .action(async (featId, options) => {
+        try {
+            // Resolve the editor
+            const editorId = resolveEditorId(options);
+            const registry = createLauncherRegistry();
+            const launcher = registry.get(editorId);
+            if (!launcher) {
+                messages.error(`Unknown editor "${editorId}". Supported: ${[...registry.keys()].join(', ')}`, new Error(`Unknown editor: ${editorId}`));
+                process.exitCode = 1;
+                return;
+            }
+            // Resolve the feature
+            const useCase = container.resolve(ShowFeatureUseCase);
+            const feature = await useCase.execute(featId);
+            // Compute worktree path and launch
+            const worktreePath = computeWorktreePath(feature.repositoryPath, feature.branch);
+            await launcher.launch(worktreePath);
+            messages.success(`Opened ${launcher.name} at ${worktreePath}`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to open IDE', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/settings/ide.command.d.ts

@@ -0,0 +1,15 @@
+/**
+ * IDE Configuration Command
+ *
+ * Configures the preferred IDE/editor used by Shep.
+ *
+ * Usage:
+ *   shep settings ide                    # Interactive selection
+ *   shep settings ide --editor cursor    # Non-interactive
+ */
+import { Command } from 'commander';
+/**
+ * Create the IDE configuration command.
+ */
+export declare function createIdeCommand(): Command;
+//# sourceMappingURL=ide.command.d.ts.map

package/dist/src/presentation/cli/commands/settings/ide.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/ide.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAkE1C"}

package/dist/src/presentation/cli/commands/settings/ide.command.js

@@ -0,0 +1,76 @@
+/**
+ * IDE Configuration Command
+ *
+ * Configures the preferred IDE/editor used by Shep.
+ *
+ * Usage:
+ *   shep settings ide                    # Interactive selection
+ *   shep settings ide --editor cursor    # Non-interactive
+ */
+import { Command } from 'commander';
+import { select } from '@inquirer/prompts';
+import { EditorType } from '../../../../domain/generated/output.js';
+import { container } from '../../../../infrastructure/di/container.js';
+import { UpdateSettingsUseCase } from '../../../../application/use-cases/settings/update-settings.use-case.js';
+import { createIdeSelectConfig } from '../../../tui/prompts/ide-select.prompt.js';
+import { getSettings, resetSettings, initializeSettings, } from '../../../../infrastructure/services/settings.service.js';
+import { createLauncherRegistry } from '../../../../infrastructure/services/ide-launchers/ide-launcher.registry.js';
+import { messages } from '../../ui/index.js';
+/** Valid EditorType values for input validation. */
+const VALID_EDITORS = new Set(Object.values(EditorType));
+/**
+ * Create the IDE configuration command.
+ */
+export function createIdeCommand() {
+    return new Command('ide')
+        .description('Configure preferred IDE/editor')
+        .option('--editor <name>', 'IDE/editor name (e.g., vscode, cursor, windsurf, zed, antigravity)')
+        .addHelpText('after', `
+Examples:
+  $ shep settings ide                           Interactive selection
+  $ shep settings ide --editor cursor           Non-interactive
+  $ shep settings ide --editor antigravity      Set Google Antigravity`)
+        .action(async (options) => {
+        try {
+            let editorValue;
+            if (options.editor !== undefined) {
+                if (!VALID_EDITORS.has(options.editor)) {
+                    messages.error(`Unknown editor "${options.editor}". Valid: ${[...VALID_EDITORS].join(', ')}`, new Error(`Unknown editor: ${options.editor}`));
+                    process.exitCode = 1;
+                    return;
+                }
+                editorValue = options.editor;
+            }
+            else {
+                editorValue = await select(createIdeSelectConfig());
+            }
+            // PATH check via launcher registry (non-blocking warning)
+            const registry = createLauncherRegistry();
+            const launcher = registry.get(editorValue);
+            if (launcher) {
+                const available = await launcher.checkAvailable();
+                if (!available) {
+                    messages.warning(`'${launcher.binary}' not found in PATH. The editor will still be saved.`);
+                }
+            }
+            // Persist settings
+            const settings = getSettings();
+            settings.environment.defaultEditor = editorValue;
+            const useCase = container.resolve(UpdateSettingsUseCase);
+            const updatedSettings = await useCase.execute(settings);
+            // Refresh in-memory singleton
+            resetSettings();
+            initializeSettings(updatedSettings);
+            messages.success(`Default editor set to: ${editorValue}`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            if (err.message.includes('force closed') || err.message.includes('User force closed')) {
+                messages.info('Configuration cancelled.');
+                return;
+            }
+            messages.error('Failed to configure IDE', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/settings/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAM/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C"}

package/dist/src/presentation/cli/commands/settings/index.js

@@ -12,6 +12,7 @@ import { Command } from 'commander';
 import { createShowCommand } from './show.command.js';
 import { createInitCommand } from './init.command.js';
 import { createAgentCommand } from './agent.command.js';
+import { createIdeCommand } from './ide.command.js';
 /**
  * Create the settings command group
  */
@@ -20,5 +21,6 @@ export function createSettingsCommand() {
         .description('Manage Shep global settings')
         .addCommand(createShowCommand())
         .addCommand(createInitCommand())
-        .addCommand(createAgentCommand());
+        .addCommand(createAgentCommand())
+        .addCommand(createIdeCommand());
 }

package/dist/src/presentation/cli/index.js

@@ -30,6 +30,7 @@ import { createUiCommand } from './commands/ui.command.js';
 import { createRunCommand } from './commands/run.command.js';
 import { createAgentCommand } from './commands/agent/index.js';
 import { createFeatCommand } from './commands/feat/index.js';
+import { createIdeOpenCommand } from './commands/ide-open.command.js';
 import { messages } from './ui/index.js';
 // DI container and settings
 import { initializeContainer, container } from '../../infrastructure/di/container.js';
@@ -78,6 +79,7 @@ async function bootstrap() {
         program.addCommand(createRunCommand());
         program.addCommand(createAgentCommand());
         program.addCommand(createFeatCommand());
+        program.addCommand(createIdeOpenCommand());
         // Parse arguments (parseAsync needed for async command actions like init)
         await program.parseAsync();
     }

package/dist/src/presentation/tui/prompts/ide-select.prompt.d.ts

@@ -0,0 +1,45 @@
+/**
+ * IDE Select Prompt Configuration
+ *
+ * Configuration for the @inquirer/select prompt that lets users
+ * choose their preferred IDE/editor.
+ */
+import { EditorType } from '../../../domain/generated/output.js';
+/**
+ * Creates the @inquirer/select configuration for selecting a preferred IDE.
+ */
+export declare function createIdeSelectConfig(): {
+    readonly message: "Select your preferred IDE";
+    readonly choices: readonly [{
+        readonly name: "VS Code";
+        readonly value: EditorType.VsCode;
+        readonly description: "Visual Studio Code";
+    }, {
+        readonly name: "Cursor";
+        readonly value: EditorType.Cursor;
+        readonly description: "Cursor AI editor";
+    }, {
+        readonly name: "Windsurf";
+        readonly value: EditorType.Windsurf;
+        readonly description: "Windsurf editor";
+    }, {
+        readonly name: "Zed";
+        readonly value: EditorType.Zed;
+        readonly description: "Zed editor";
+    }, {
+        readonly name: "Antigravity";
+        readonly value: EditorType.Antigravity;
+        readonly description: "Google Antigravity IDE";
+    }];
+    readonly theme: {
+        readonly prefix: {
+            readonly idle: string;
+            readonly done: string;
+        };
+        readonly style: {
+            readonly highlight: import("picocolors/types.js").Formatter;
+            readonly answer: import("picocolors/types.js").Formatter;
+        };
+    };
+};
+//# sourceMappingURL=ide-select.prompt.d.ts.map

package/dist/src/presentation/tui/prompts/ide-select.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-select.prompt.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/tui/prompts/ide-select.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAGjE;;GAEG;AACH,wBAAgB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCpC"}

package/dist/src/presentation/tui/prompts/ide-select.prompt.js

@@ -0,0 +1,44 @@
+/**
+ * IDE Select Prompt Configuration
+ *
+ * Configuration for the @inquirer/select prompt that lets users
+ * choose their preferred IDE/editor.
+ */
+import { EditorType } from '../../../domain/generated/output.js';
+import { shepTheme } from '../themes/shep.theme.js';
+/**
+ * Creates the @inquirer/select configuration for selecting a preferred IDE.
+ */
+export function createIdeSelectConfig() {
+    return {
+        message: 'Select your preferred IDE',
+        choices: [
+            {
+                name: 'VS Code',
+                value: EditorType.VsCode,
+                description: 'Visual Studio Code',
+            },
+            {
+                name: 'Cursor',
+                value: EditorType.Cursor,
+                description: 'Cursor AI editor',
+            },
+            {
+                name: 'Windsurf',
+                value: EditorType.Windsurf,
+                description: 'Windsurf editor',
+            },
+            {
+                name: 'Zed',
+                value: EditorType.Zed,
+                description: 'Zed editor',
+            },
+            {
+                name: 'Antigravity',
+                value: EditorType.Antigravity,
+                description: 'Google Antigravity IDE',
+            },
+        ],
+        theme: shepTheme,
+    };
+}