@shepai/cli 1.36.0 → 1.37.0

package/dist/packages/core/src/application/ports/output/services/ide-launcher-service.interface.d.ts

@@ -0,0 +1,64 @@
+/**
+ * IDE Launcher Service Interface
+ *
+ * Output port for launching IDE editors in a target directory.
+ * Implementations resolve editor commands from metadata and spawn detached processes.
+ */
+/**
+ * Input for the LaunchIdeUseCase.
+ */
+export interface LaunchIdeInput {
+    /** Which editor to launch (e.g., "vscode", "cursor"). */
+    editorId: string;
+    /** Absolute path to the repository root. */
+    repositoryPath: string;
+    /** Git branch name. When omitted, repositoryPath is used directly. */
+    branch?: string;
+    /** Whether to verify binary availability before launching. Default: false. */
+    checkAvailability?: boolean;
+}
+/**
+ * Successful IDE launch result.
+ */
+export interface LaunchIdeSuccess {
+    ok: true;
+    /** Display name of the editor that was launched. */
+    editorName: string;
+    /** Absolute path that was opened in the editor. */
+    worktreePath: string;
+}
+/**
+ * Failed IDE launch result.
+ */
+export interface LaunchIdeFailed {
+    ok: false;
+    /** Error classification for consumer error handling. */
+    code: 'unknown_editor' | 'editor_unavailable' | 'launch_failed';
+    /** Human-readable error description. */
+    message: string;
+}
+/**
+ * Discriminated union result for IDE launch operations.
+ */
+export type LaunchIdeResult = LaunchIdeSuccess | LaunchIdeFailed;
+/**
+ * Service interface for launching IDE editors.
+ */
+export interface IIdeLauncherService {
+    /**
+     * Launch an IDE editor in the specified directory.
+     *
+     * @param editorId - Editor identifier (e.g., "vscode", "cursor")
+     * @param directoryPath - Absolute path to open in the editor
+     * @returns Launch result indicating success or failure with error details
+     */
+    launch(editorId: string, directoryPath: string): Promise<LaunchIdeResult>;
+    /**
+     * Check whether an editor's binary is available on the system PATH.
+     *
+     * @param editorId - Editor identifier (e.g., "vscode", "cursor")
+     * @returns True if the editor binary is found and executable
+     */
+    checkAvailability(editorId: string): Promise<boolean>;
+}
+//# sourceMappingURL=ide-launcher-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/ide-launcher-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-launcher-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/ide-launcher-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,wDAAwD;IACxD,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,eAAe,CAAC;IAChE,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD"}

package/dist/packages/core/src/application/ports/output/services/ide-launcher-service.interface.js

@@ -0,0 +1,7 @@
+/**
+ * IDE Launcher Service Interface
+ *
+ * Output port for launching IDE editors in a target directory.
+ * Implementations resolve editor commands from metadata and spawn detached processes.
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/index.d.ts

@@ -14,4 +14,5 @@ export type { IToolInstallerService } from './tool-installer.service.js';
 export type { INotificationService } from './notification-service.interface.js';
 export type { IGitPrService, CiStatus, CiStatusResult, DiffSummary, MergeStrategy, PrCreateResult, } from './git-pr-service.interface.js';
 export { GitPrError, GitPrErrorCode } from './git-pr-service.interface.js';
+export type { IIdeLauncherService, LaunchIdeInput, LaunchIdeResult, LaunchIdeSuccess, LaunchIdeFailed, } from './ide-launcher-service.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC"}

package/dist/packages/core/src/application/use-cases/ide/launch-ide.use-case.d.ts

@@ -0,0 +1,20 @@
+/**
+ * LaunchIdeUseCase
+ *
+ * Orchestrates IDE launching: computes the target directory path (worktree when
+ * a branch is specified), optionally checks editor availability, and delegates
+ * to IIdeLauncherService for the actual spawn.
+ */
+import type { IIdeLauncherService, LaunchIdeInput, LaunchIdeResult } from '../../ports/output/services/ide-launcher-service.interface.js';
+export declare class LaunchIdeUseCase {
+    private readonly ideLauncherService;
+    constructor(ideLauncherService: IIdeLauncherService);
+    /**
+     * Launch an IDE editor for the given repository/branch.
+     *
+     * @param input - Editor ID, repository path, optional branch and availability check flag
+     * @returns Launch result indicating success or failure with error details
+     */
+    execute(input: LaunchIdeInput): Promise<LaunchIdeResult>;
+}
+//# sourceMappingURL=launch-ide.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/ide/launch-ide.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-ide.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/ide/launch-ide.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EAChB,MAAM,+DAA+D,CAAC;AAGvE,qBACa,gBAAgB;IAGzB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAG1D;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;CAkB/D"}

package/dist/packages/core/src/application/use-cases/ide/launch-ide.use-case.js

@@ -0,0 +1,54 @@
+/**
+ * LaunchIdeUseCase
+ *
+ * Orchestrates IDE launching: computes the target directory path (worktree when
+ * a branch is specified), optionally checks editor availability, and delegates
+ * to IIdeLauncherService for the actual spawn.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { computeWorktreePath } from '../../../infrastructure/services/ide-launchers/compute-worktree-path.js';
+let LaunchIdeUseCase = class LaunchIdeUseCase {
+    ideLauncherService;
+    constructor(ideLauncherService) {
+        this.ideLauncherService = ideLauncherService;
+    }
+    /**
+     * Launch an IDE editor for the given repository/branch.
+     *
+     * @param input - Editor ID, repository path, optional branch and availability check flag
+     * @returns Launch result indicating success or failure with error details
+     */
+    async execute(input) {
+        const { editorId, repositoryPath, branch, checkAvailability } = input;
+        const directoryPath = branch ? computeWorktreePath(repositoryPath, branch) : repositoryPath;
+        if (checkAvailability) {
+            const available = await this.ideLauncherService.checkAvailability(editorId);
+            if (!available) {
+                return {
+                    ok: false,
+                    code: 'editor_unavailable',
+                    message: `Editor '${editorId}' is not available on the system PATH`,
+                };
+            }
+        }
+        return this.ideLauncherService.launch(editorId, directoryPath);
+    }
+};
+LaunchIdeUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IIdeLauncherService')),
+    __metadata("design:paramtypes", [Object])
+], LaunchIdeUseCase);
+export { LaunchIdeUseCase };

package/dist/packages/core/src/infrastructure/di/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAuFrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CA+KrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA0FrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CAuLrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/packages/core/src/infrastructure/di/container.js

@@ -22,6 +22,7 @@ import { WebServerService } from '../services/web-server.service.js';
 import { WorktreeService } from '../services/git/worktree.service.js';
 import { ToolInstallerServiceImpl } from '../services/tool-installer/tool-installer.service.js';
 import { GitPrService } from '../services/git/git-pr.service.js';
+import { JsonDrivenIdeLauncherService } from '../services/ide-launchers/json-driven-ide-launcher.service.js';
 import { AgentExecutorFactory } from '../services/agents/common/agent-executor-factory.service.js';
 import { AgentExecutorProvider } from '../services/agents/common/agent-executor-provider.service.js';
 import { StructuredAgentCallerService } from '../services/agents/common/structured-agent-caller.service.js';
@@ -59,6 +60,7 @@ import { DeleteFeatureUseCase } from '../../application/use-cases/features/delet
 import { ResumeFeatureUseCase } from '../../application/use-cases/features/resume-feature.use-case.js';
 import { ValidateToolAvailabilityUseCase } from '../../application/use-cases/tools/validate-tool-availability.use-case.js';
 import { InstallToolUseCase } from '../../application/use-cases/tools/install-tool.use-case.js';
+import { LaunchIdeUseCase } from '../../application/use-cases/ide/launch-ide.use-case.js';
 // Database connection
 import { getSQLiteConnection } from '../persistence/sqlite/connection.js';
 import { runSQLiteMigrations } from '../persistence/sqlite/migrations.js';
@@ -105,6 +107,7 @@ export async function initializeContainer() {
     container.registerSingleton('IWorktreeService', WorktreeService);
     container.registerSingleton('IToolInstallerService', ToolInstallerServiceImpl);
     container.registerSingleton('IGitPrService', GitPrService);
+    container.registerSingleton('IIdeLauncherService', JsonDrivenIdeLauncherService);
     // Register agent infrastructure
     container.register('IAgentRunRepository', {
         useFactory: (c) => {
@@ -206,6 +209,7 @@ export async function initializeContainer() {
     container.registerSingleton(ResumeFeatureUseCase);
     container.registerSingleton(ValidateToolAvailabilityUseCase);
     container.registerSingleton(InstallToolUseCase);
+    container.registerSingleton(LaunchIdeUseCase);
     // String-token aliases for web routes (Turbopack can't resolve .js→.ts
     // imports inside @shepai/core, so routes use string tokens instead of class refs)
     container.register('CreateFeatureUseCase', {
@@ -217,6 +221,9 @@ export async function initializeContainer() {
     container.register('DeleteFeatureUseCase', {
         useFactory: (c) => c.resolve(DeleteFeatureUseCase),
     });
+    container.register('LaunchIdeUseCase', {
+        useFactory: (c) => c.resolve(LaunchIdeUseCase),
+    });
     _initialized = true;
     return container;
 }

package/dist/packages/core/src/infrastructure/services/ide-launchers/json-driven-ide-launcher.service.d.ts

@@ -0,0 +1,23 @@
+/**
+ * JSON-Driven IDE Launcher Service
+ *
+ * Replaces the 5 hard-coded IDE launcher classes with a single service that
+ * derives editor commands from the JSON tool metadata files. Reads from the
+ * already-loaded TOOL_METADATA record, filters by category "ide" and presence
+ * of openDirectory, and performs {dir} placeholder substitution at launch time.
+ */
+import type { IIdeLauncherService, LaunchIdeResult } from '../../../application/ports/output/services/ide-launcher-service.interface.js';
+/**
+ * Resolve a platform-specific value from a string or per-platform record.
+ * When the value is a plain string, returns it directly.
+ * When the value is a record, returns the entry for the current os.platform(),
+ * falling back to the first value if the current platform is not present.
+ */
+export declare function resolvePlatformValue(value: string | Record<string, string>): string;
+export declare class JsonDrivenIdeLauncherService implements IIdeLauncherService {
+    private readonly editors;
+    constructor();
+    launch(editorId: string, directoryPath: string): Promise<LaunchIdeResult>;
+    checkAvailability(editorId: string): Promise<boolean>;
+}
+//# sourceMappingURL=json-driven-ide-launcher.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/ide-launchers/json-driven-ide-launcher.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-driven-ide-launcher.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/json-driven-ide-launcher.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAChB,MAAM,8EAA8E,CAAC;AActF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAGnF;AAED,qBACa,4BAA6B,YAAW,mBAAmB;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;;IAgB1C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAoD/E,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAWtD"}

package/dist/packages/core/src/infrastructure/services/ide-launchers/json-driven-ide-launcher.service.js

@@ -0,0 +1,114 @@
+/**
+ * JSON-Driven IDE Launcher Service
+ *
+ * Replaces the 5 hard-coded IDE launcher classes with a single service that
+ * derives editor commands from the JSON tool metadata files. Reads from the
+ * already-loaded TOOL_METADATA record, filters by category "ide" and presence
+ * of openDirectory, and performs {dir} placeholder substitution at launch time.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { injectable } from 'tsyringe';
+import { spawn, execFile } from 'node:child_process';
+import { platform } from 'node:os';
+import { TOOL_METADATA } from '../tool-installer/tool-metadata.js';
+/**
+ * Resolve a platform-specific value from a string or per-platform record.
+ * When the value is a plain string, returns it directly.
+ * When the value is a record, returns the entry for the current os.platform(),
+ * falling back to the first value if the current platform is not present.
+ */
+export function resolvePlatformValue(value) {
+    if (typeof value === 'string')
+        return value;
+    return value[platform()] ?? Object.values(value)[0];
+}
+let JsonDrivenIdeLauncherService = class JsonDrivenIdeLauncherService {
+    editors;
+    constructor() {
+        this.editors = new Map();
+        for (const [id, meta] of Object.entries(TOOL_METADATA)) {
+            if (meta.openDirectory != null) {
+                this.editors.set(id, {
+                    name: meta.name,
+                    binary: meta.binary,
+                    openDirectory: meta.openDirectory,
+                    spawnOptions: meta.spawnOptions,
+                });
+            }
+        }
+    }
+    async launch(editorId, directoryPath) {
+        const entry = this.editors.get(editorId);
+        if (!entry) {
+            const available = [...this.editors.keys()].join(', ');
+            return {
+                ok: false,
+                code: 'unknown_editor',
+                message: `No launcher found for editor: ${editorId}. Available: ${available}`,
+            };
+        }
+        const openCmd = resolvePlatformValue(entry.openDirectory);
+        if (!openCmd.includes('{dir}')) {
+            return {
+                ok: false,
+                code: 'launch_failed',
+                message: `openDirectory for "${editorId}" is missing {dir} placeholder: "${openCmd}"`,
+            };
+        }
+        const resolved = openCmd.replace('{dir}', directoryPath);
+        const useShell = entry.spawnOptions?.shell === true;
+        const opts = {
+            detached: entry.spawnOptions?.detached ?? !useShell,
+            stdio: (entry.spawnOptions?.stdio ?? 'ignore'),
+            shell: useShell,
+        };
+        try {
+            let child;
+            if (useShell) {
+                child = spawn(resolved, [], opts);
+            }
+            else {
+                const [command, ...args] = resolved.split(/\s+/);
+                child = spawn(command, args, opts);
+            }
+            if (opts.detached)
+                child.unref();
+            return {
+                ok: true,
+                editorName: entry.name,
+                worktreePath: directoryPath,
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                code: 'launch_failed',
+                message: error instanceof Error ? error.message : 'Failed to launch IDE',
+            };
+        }
+    }
+    checkAvailability(editorId) {
+        const entry = this.editors.get(editorId);
+        if (!entry)
+            return Promise.resolve(false);
+        const binary = resolvePlatformValue(entry.binary);
+        return new Promise((resolve) => {
+            execFile('which', [binary], (err) => {
+                resolve(!err);
+            });
+        });
+    }
+};
+JsonDrivenIdeLauncherService = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [])
+], JsonDrivenIdeLauncherService);
+export { JsonDrivenIdeLauncherService };

package/dist/packages/core/src/infrastructure/services/tool-installer/tool-metadata.d.ts

@@ -14,8 +14,8 @@ export interface ToolMetadata {
     summary: string;
     /** Detailed description */
     description: string;
-    /** Tool category for grouping in listings */
-    category: 'ide' | 'cli-agent';
+    /** Tool tags for grouping in listings. A tool can belong to multiple categories. */
+    tags: ('ide' | 'cli-agent')[];
     /** Binary name to check with 'which' command (string or per-platform map) */
     binary: string | Record<string, string>;
     /** Package manager or installation method */
@@ -30,8 +30,24 @@ export interface ToolMetadata {
     verifyCommand: string;
     /** Whether the tool supports automated installation (default: true) */
     autoInstall?: boolean;
-    /** Command to open a directory in this tool (e.g., "code .") */
-    openDirectory?: string;
+    /** Command to open a directory in this tool.
+     * String format: "code {dir}" — single command for all platforms.
+     * Object format: { "linux": "antigravity {dir}", "darwin": "agy {dir}" } — per-platform commands. */
+    openDirectory?: string | Record<string, string>;
+    /** Override default spawn options for the launch process.
+     * Defaults: { detached: true, stdio: "ignore" } (GUI IDEs).
+     * CLI agents should use { shell: true, stdio: "inherit" } to run in the current terminal. */
+    spawnOptions?: {
+        shell?: boolean;
+        stdio?: 'ignore' | 'inherit' | 'pipe';
+        detached?: boolean;
+    };
 }
 export declare const TOOL_METADATA: Record<string, ToolMetadata>;
+/**
+ * Returns entries from TOOL_METADATA that can open a directory as an IDE.
+ * A tool qualifies if it has an `openDirectory` field, regardless of category.
+ * Each entry is [toolId, metadata].
+ */
+export declare function getIdeEntries(): [string, ToolMetadata][];
 //# sourceMappingURL=tool-metadata.d.ts.map

package/dist/packages/core/src/infrastructure/services/tool-installer/tool-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-metadata.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/tool-installer/tool-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,QAAQ,EAAE,KAAK,GAAG,WAAW,CAAC;IAE9B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IAEvB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IAEtB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA8CD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAsB,CAAC"}
+{"version":3,"file":"tool-metadata.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/tool-installer/tool-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IAEpB,oFAAoF;IACpF,IAAI,EAAE,CAAC,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC;IAE9B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IAEvB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IAEtB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;yGAEqG;IACrG,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD;;iGAE6F;IAC7F,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;QACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AA8CD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAsB,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAExD"}

package/dist/packages/core/src/infrastructure/services/tool-installer/tool-metadata.js

@@ -14,7 +14,7 @@ const REQUIRED_FIELDS = [
     'name',
     'summary',
     'description',
-    'category',
+    'tags',
     'binary',
     'packageManager',
     'commands',
@@ -50,3 +50,11 @@ function loadToolMetadata() {
     return metadata;
 }
 export const TOOL_METADATA = loadToolMetadata();
+/**
+ * Returns entries from TOOL_METADATA that can open a directory as an IDE.
+ * A tool qualifies if it has an `openDirectory` field, regardless of category.
+ * Each entry is [toolId, metadata].
+ */
+export function getIdeEntries() {
+    return Object.entries(TOOL_METADATA).filter(([, meta]) => meta.openDirectory != null);
+}

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/antigravity.json

@@ -2,7 +2,7 @@
   "name": "Google Antigravity",
   "summary": "AI-powered agentic development platform",
   "description": "Google Antigravity is an AI-powered platform that enables agentic development workflows, helping developers build intelligent applications with autonomous agents.",
-  "category": "ide",
+  "tags": ["ide"],
   "binary": {
     "linux": "antigravity",
     "darwin": "agy"
@@ -16,5 +16,8 @@
   "documentationUrl": "https://codelabs.developers.google.com/getting-started-google-antigravity",
   "verifyCommand": "agy --version",
   "autoInstall": false,
-  "openDirectory": "agy ."
+  "openDirectory": {
+    "linux": "antigravity {dir}",
+    "darwin": "agy {dir}"
+  }
 }

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/claude-code.json

@@ -2,7 +2,7 @@
   "name": "Claude Code",
   "summary": "AI-powered code assistant from Anthropic",
   "description": "Claude Code is an AI-powered code assistant from Anthropic that helps you write, understand, and debug code with advanced AI capabilities.",
-  "category": "cli-agent",
+  "tags": ["ide", "cli-agent"],
   "binary": "claude",
   "packageManager": "curl",
   "commands": {
@@ -12,5 +12,11 @@
   "timeout": 300000,
   "documentationUrl": "https://code.claude.com/docs/en/overview",
   "verifyCommand": "claude --version",
-  "autoInstall": true
+  "autoInstall": true,
+  "openDirectory": "cd {dir} && exec claude",
+  "spawnOptions": {
+    "shell": true,
+    "stdio": "inherit",
+    "detached": false
+  }
 }

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/cursor-cli.json

@@ -2,7 +2,7 @@
   "name": "Cursor CLI",
   "summary": "AI-powered terminal coding agent",
   "description": "Cursor CLI is a terminal-based AI coding agent that brings conversational AI assistance directly to your command line for any IDE or terminal.",
-  "category": "cli-agent",
+  "tags": ["ide", "cli-agent"],
   "binary": "cursor-agent",
   "packageManager": "curl",
   "commands": {
@@ -12,5 +12,11 @@
   "timeout": 300000,
   "documentationUrl": "https://www.codecademy.com/article/getting-started-with-cursor-cli",
   "verifyCommand": "cursor-agent --version",
-  "autoInstall": true
+  "autoInstall": true,
+  "openDirectory": "cd {dir} && exec cursor-agent",
+  "spawnOptions": {
+    "shell": true,
+    "stdio": "inherit",
+    "detached": false
+  }
 }

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/cursor.json

@@ -2,7 +2,7 @@
   "name": "Cursor",
   "summary": "AI-powered code editor for efficient development",
   "description": "Cursor is an AI-powered code editor built on VS Code, designed to streamline development workflows with advanced AI-assisted coding capabilities.",
-  "category": "ide",
+  "tags": ["ide"],
   "binary": "cursor",
   "packageManager": "manual",
   "commands": {
@@ -13,5 +13,5 @@
   "documentationUrl": "https://cursor.com/download",
   "verifyCommand": "cursor --version",
   "autoInstall": false,
-  "openDirectory": "cursor ."
+  "openDirectory": "cursor {dir}"
 }

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/vscode.json

@@ -2,7 +2,7 @@
   "name": "Visual Studio Code",
   "summary": "Lightweight but powerful source code editor",
   "description": "Microsoft Visual Studio Code is a free, open-source code editor with built-in support for debugging, version control, and extensions for enhanced development workflows.",
-  "category": "ide",
+  "tags": ["ide"],
   "binary": "code",
   "packageManager": "apt",
   "commands": {
@@ -13,5 +13,5 @@
   "documentationUrl": "https://code.visualstudio.com/docs/setup/linux",
   "verifyCommand": "code --version --no-sandbox --user-data-dir=/tmp/vscode-test",
   "autoInstall": true,
-  "openDirectory": "code ."
+  "openDirectory": "code {dir}"
 }

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/windsurf.json

@@ -2,7 +2,7 @@
   "name": "Windsurf",
   "summary": "AI-powered code editor by Codeium",
   "description": "Windsurf is an AI-powered code editor by Codeium that provides intelligent code assistance and automation features for modern development.",
-  "category": "ide",
+  "tags": ["ide"],
   "binary": "windsurf",
   "packageManager": "apt",
   "commands": {
@@ -13,5 +13,5 @@
   "documentationUrl": "https://docs.windsurf.com/windsurf/getting-started",
   "verifyCommand": "windsurf --version --no-sandbox --user-data-dir=/tmp/windsurf-test",
   "autoInstall": true,
-  "openDirectory": "windsurf ."
+  "openDirectory": "windsurf {dir}"
 }

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/zed.json

@@ -2,7 +2,7 @@
   "name": "Zed",
   "summary": "High-performance code editor written in Rust",
   "description": "Zed is a high-performance code editor written in Rust, designed for speed and collaboration with modern developer workflows.",
-  "category": "ide",
+  "tags": ["ide"],
   "binary": "zed",
   "packageManager": "curl",
   "commands": {
@@ -13,5 +13,5 @@
   "documentationUrl": "https://zed.dev/docs/installation",
   "verifyCommand": "zed --version",
   "autoInstall": true,
-  "openDirectory": "zed ."
+  "openDirectory": "zed {dir}"
 }

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

@@ -2,8 +2,10 @@
  * IDE Open Command
  *
  * Opens a feature worktree in the configured IDE.
+ * IDE flags (e.g. --vscode, --cursor) are derived dynamically from
+ * the JSON tool metadata files in packages/core.
  *
- * Usage: shep ide <feat-id> [--vscode|--cursor|--windsurf|--zed|--antigravity]
+ * Usage: shep ide <feat-id> [--<ide-name>]
  */
 import { Command } from 'commander';
 export declare function createIdeOpenCommand(): Command;

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

@@ -1 +1 @@
-{"version":3,"file":"ide-open.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/ide-open.command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCpC,wBAAgB,oBAAoB,IAAI,OAAO,CAkC9C"}
+{"version":3,"file":"ide-open.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/ide-open.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,oBAAoB,IAAI,OAAO,CAwC9C"}