@shepai/cli 1.24.0 → 1.26.0

package/dist/packages/core/src/application/use-cases/features/create/metadata-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-generator.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/metadata-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mEAAmE,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAG3D;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAyCnE;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf"}
+{"version":3,"file":"metadata-generator.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/metadata-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mEAAmE,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAG3D;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA4CnE;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf"}

package/dist/packages/core/src/application/use-cases/features/create/metadata-generator.js

@@ -53,6 +53,9 @@ JSON only, no markdown fences.`;
             silent: true,
         });
         const cleaned = this.stripCodeFence(result.result);
+        if (!cleaned) {
+            throw new Error('AI returned empty response for metadata generation');
+        }
         const parsed = JSON.parse(cleaned);
         if (!parsed.slug || !parsed.name || !parsed.description) {
             throw new Error('Missing required fields in AI response');

package/dist/packages/core/src/infrastructure/di/populate-use-cases-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"populate-use-cases-bridge.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/populate-use-cases-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAKpD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAOnE"}
+{"version":3,"file":"populate-use-cases-bridge.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/populate-use-cases-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAMpD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAQnE"}

package/dist/packages/core/src/infrastructure/di/populate-use-cases-bridge.js

@@ -12,6 +12,7 @@
  * @see use-cases-bridge.ts for the reader side (web-safe).
  */
 import { ListFeaturesUseCase } from '../../application/use-cases/features/list-features.use-case.js';
+import { CreateFeatureUseCase } from '../../application/use-cases/features/create/create-feature.use-case.js';
 import { SHEP_USE_CASES_KEY } from './use-cases-bridge.js';
 /**
  * Populate the globalThis bridge with resolved use cases from the DI container.
@@ -21,6 +22,7 @@ export function populateUseCasesBridge(c) {
     const bridge = {
         listFeatures: c.resolve(ListFeaturesUseCase),
         agentRunRepo: c.resolve('IAgentRunRepository'),
+        createFeature: c.resolve(CreateFeatureUseCase),
     };
     globalThis[SHEP_USE_CASES_KEY] = bridge;
     process[SHEP_USE_CASES_KEY] = bridge;

package/dist/packages/core/src/infrastructure/di/use-cases-bridge.d.ts

@@ -17,7 +17,8 @@
  */
 import type { Feature, AgentRun } from '../../domain/generated/output.js';
 import type { FeatureListFilters } from '../../application/ports/output/repositories/feature-repository.interface.js';
-export type { FeatureListFilters };
+import type { CreateFeatureInput, CreateFeatureResult } from '../../application/use-cases/features/create/types.js';
+export type { FeatureListFilters, CreateFeatureInput, CreateFeatureResult };
 /** The globalThis key shared between writer and reader. */
 export declare const SHEP_USE_CASES_KEY = "__shepUseCases";
 /**
@@ -31,4 +32,11 @@ export declare function getFeatures(filters?: FeatureListFilters): Promise<Featu
  * Returns null if the DI bridge is not initialized or the run is not found.
  */
 export declare function getAgentRun(id: string): Promise<AgentRun | null>;
+/**
+ * Create a new feature via the DI-managed use case.
+ * Unlike getFeatures/getAgentRun, this function propagates errors so callers
+ * (API routes) can return proper HTTP error responses and surface messages to the user.
+ * Throws if the bridge is not initialized or the use case fails.
+ */
+export declare function createFeature(input: CreateFeatureInput): Promise<CreateFeatureResult>;
 //# sourceMappingURL=use-cases-bridge.d.ts.map

package/dist/packages/core/src/infrastructure/di/use-cases-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-cases-bridge.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/use-cases-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6EAA6E,CAAC;AAEtH,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAiCnD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAWlF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAStE"}
+{"version":3,"file":"use-cases-bridge.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/use-cases-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6EAA6E,CAAC;AACtH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,sDAAsD,CAAC;AAE9D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;AAE5E,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAqCnD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAWlF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAStE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAO3F"}

package/dist/packages/core/src/infrastructure/di/use-cases-bridge.js

@@ -23,10 +23,13 @@ function isShepUseCases(value) {
     const maybe = value;
     const listFeatures = maybe.listFeatures;
     const agentRunRepo = maybe.agentRunRepo;
+    const createFeature = maybe.createFeature;
     return (!!listFeatures &&
         typeof listFeatures.execute === 'function' &&
         !!agentRunRepo &&
-        typeof agentRunRepo.findById === 'function');
+        typeof agentRunRepo.findById === 'function' &&
+        !!createFeature &&
+        typeof createFeature.execute === 'function');
 }
 function getUseCases() {
     const globalBridge = globalThis[SHEP_USE_CASES_KEY];
@@ -70,3 +73,16 @@ export async function getAgentRun(id) {
         return null;
     }
 }
+/**
+ * Create a new feature via the DI-managed use case.
+ * Unlike getFeatures/getAgentRun, this function propagates errors so callers
+ * (API routes) can return proper HTTP error responses and surface messages to the user.
+ * Throws if the bridge is not initialized or the use case fails.
+ */
+export async function createFeature(input) {
+    const useCases = getUseCases();
+    if (!useCases?.createFeature) {
+        throw new Error('Use-cases bridge is not initialized. Ensure the CLI process is running.');
+    }
+    return useCases.createFeature.execute(input);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"antigravity.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/antigravity.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,mBAAoB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,QAAQ,0BAA0B;IAC3C,QAAQ,CAAC,MAAM,iBAAiB;IAE1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}
+{"version":3,"file":"antigravity.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/antigravity.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,mBAAoB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,QAAQ,0BAA0B;IAC3C,QAAQ,CAAC,MAAM,iBAAiB;IAE1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

package/dist/packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Compute Worktree Path
+ *
+ * Pure utility that computes the filesystem path for a feature's git worktree
+ * given a repository path and branch name.
+ *
+ * Path format: ~/.shep/repos/<sha256-hash-prefix>/wt/<branch-slug>
+ */
+/**
+ * Compute the worktree path for a given repository and branch.
+ *
+ * @param repoPath - Absolute path to the repository
+ * @param branch - Git branch name (slashes are replaced with hyphens)
+ * @returns Absolute path to the worktree directory under ~/.shep/repos/
+ */
+export declare function computeWorktreePath(repoPath: string, branch: string): string;
+//# sourceMappingURL=compute-worktree-path.d.ts.map

package/dist/packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-worktree-path.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI5E"}

package/dist/packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.js

@@ -0,0 +1,24 @@
+/**
+ * Compute Worktree Path
+ *
+ * Pure utility that computes the filesystem path for a feature's git worktree
+ * given a repository path and branch name.
+ *
+ * Path format: ~/.shep/repos/<sha256-hash-prefix>/wt/<branch-slug>
+ */
+import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const SHEP_HOME_DIR = join(homedir(), '.shep');
+/**
+ * Compute the worktree path for a given repository and branch.
+ *
+ * @param repoPath - Absolute path to the repository
+ * @param branch - Git branch name (slashes are replaced with hyphens)
+ * @returns Absolute path to the worktree directory under ~/.shep/repos/
+ */
+export 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);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"cursor.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/cursor.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,QAAQ,CAAC,MAAM,YAAY;IAErB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}
+{"version":3,"file":"cursor.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/cursor.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,QAAQ,CAAC,MAAM,YAAY;IAErB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ide-launcher.interface.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/ide-launcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAE9B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC"}
+{"version":3,"file":"ide-launcher.interface.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/ide-launcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAE9B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ide-launcher.registry.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/ide-launcher.registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAO/D;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAcrE"}
+{"version":3,"file":"ide-launcher.registry.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/ide-launcher.registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAcrE"}

package/dist/packages/core/src/infrastructure/services/ide-launchers/launch-ide.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared IDE launch logic used by both CLI and Web presentation layers.
+ *
+ * Returns a discriminated union so callers can map errors to their own format
+ * (CLI messages vs HTTP status codes).
+ */
+import type { EditorType } from '../../../domain/generated/output.js';
+export interface LaunchIdeInput {
+    /** Which editor to launch. */
+    editorId: EditorType;
+    /** Absolute path to the repository root. */
+    repositoryPath: string;
+    /** Git branch name. */
+    branch: string;
+    /** Whether to verify binary availability before launching. Default: false. */
+    checkAvailability?: boolean;
+}
+export interface LaunchIdeSuccess {
+    ok: true;
+    editorName: string;
+    worktreePath: string;
+}
+export interface LaunchIdeFailed {
+    ok: false;
+    code: 'unknown_editor' | 'editor_unavailable' | 'launch_failed';
+    message: string;
+}
+export type LaunchIdeResult = LaunchIdeSuccess | LaunchIdeFailed;
+export declare function launchIde(input: LaunchIdeInput): Promise<LaunchIdeResult>;
+//# sourceMappingURL=launch-ide.d.ts.map

package/dist/packages/core/src/infrastructure/services/ide-launchers/launch-ide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-ide.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/launch-ide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAInE,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,eAAe,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEjE,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAkC/E"}

package/dist/packages/core/src/infrastructure/services/ide-launchers/launch-ide.js

@@ -0,0 +1,41 @@
+/**
+ * Shared IDE launch logic used by both CLI and Web presentation layers.
+ *
+ * Returns a discriminated union so callers can map errors to their own format
+ * (CLI messages vs HTTP status codes).
+ */
+import { createLauncherRegistry } from './ide-launcher.registry.js';
+import { computeWorktreePath } from './compute-worktree-path.js';
+export async function launchIde(input) {
+    const registry = createLauncherRegistry();
+    const launcher = registry.get(input.editorId);
+    if (!launcher) {
+        return {
+            ok: false,
+            code: 'unknown_editor',
+            message: `No launcher found for editor: ${input.editorId}. Supported: ${[...registry.keys()].join(', ')}`,
+        };
+    }
+    if (input.checkAvailability) {
+        const available = await launcher.checkAvailable();
+        if (!available) {
+            return {
+                ok: false,
+                code: 'editor_unavailable',
+                message: `${launcher.name} is not available — ensure "${launcher.binary}" is installed and on your PATH`,
+            };
+        }
+    }
+    try {
+        const worktreePath = computeWorktreePath(input.repositoryPath, input.branch);
+        await launcher.launch(worktreePath);
+        return { ok: true, editorName: launcher.name, worktreePath };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            code: 'launch_failed',
+            message: error instanceof Error ? error.message : 'Failed to launch IDE',
+        };
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"vscode.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/vscode.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,QAAQ,CAAC,MAAM,UAAU;IAEnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}
+{"version":3,"file":"vscode.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/vscode.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,QAAQ,CAAC,MAAM,UAAU;IAEnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

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

@@ -1 +1 @@
-{"version":3,"file":"windsurf.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/windsurf.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,uBAAuB;IACxC,QAAQ,CAAC,MAAM,cAAc;IAEvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}
+{"version":3,"file":"windsurf.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/windsurf.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,uBAAuB;IACxC,QAAQ,CAAC,MAAM,cAAc;IAEvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

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

@@ -1 +1 @@
-{"version":3,"file":"zed.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/zed.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,QAAQ,kBAAkB;IACnC,QAAQ,CAAC,MAAM,SAAS;IAElB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}
+{"version":3,"file":"zed.launcher.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/ide-launchers/zed.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,QAAQ,kBAAkB;IACnC,QAAQ,CAAC,MAAM,SAAS;IAElB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

package/dist/packages/core/src/infrastructure/services/settings.service.d.ts

@@ -2,7 +2,9 @@
  * Settings Service
  *
  * Provides global access to application settings within the CLI.
- * Implements singleton pattern for consistent settings access.
+ * Uses globalThis/process storage so the singleton survives Turbopack
+ * module re-evaluations in Next.js API routes (same pattern as the
+ * use-cases bridge in di/use-cases-bridge.ts).
  *
  * Usage:
  * ```typescript

package/dist/packages/core/src/infrastructure/services/settings.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.service.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/services/settings.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAQjE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAMtC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}
+{"version":3,"file":"settings.service.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/services/settings.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAsBjE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAOtC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/packages/core/src/infrastructure/services/settings.service.js

@@ -2,7 +2,9 @@
  * Settings Service
  *
  * Provides global access to application settings within the CLI.
- * Implements singleton pattern for consistent settings access.
+ * Uses globalThis/process storage so the singleton survives Turbopack
+ * module re-evaluations in Next.js API routes (same pattern as the
+ * use-cases bridge in di/use-cases-bridge.ts).
  *
  * Usage:
  * ```typescript
@@ -12,11 +14,23 @@
  * console.log(settings.models.analyze); // 'claude-opus-4'
  * ```
  */
-/**
- * Singleton settings instance.
- * Set during CLI initialization, accessed throughout application lifecycle.
- */
-let settingsInstance = null;
+/** The globalThis / process key for the settings singleton. */
+const SHEP_SETTINGS_KEY = '__shepSettings';
+/** Read the settings instance from globalThis, falling back to process. */
+function readSettings() {
+    const fromGlobal = globalThis[SHEP_SETTINGS_KEY];
+    if (fromGlobal != null)
+        return fromGlobal;
+    const fromProcess = process[SHEP_SETTINGS_KEY];
+    if (fromProcess != null)
+        return fromProcess;
+    return null;
+}
+/** Write the settings instance to both globalThis and process. */
+function writeSettings(value) {
+    globalThis[SHEP_SETTINGS_KEY] = value;
+    process[SHEP_SETTINGS_KEY] = value;
+}
 /**
  * Initialize the settings service with loaded settings.
  * Must be called once during CLI bootstrap.
@@ -25,10 +39,10 @@ let settingsInstance = null;
  * @throws Error if settings are already initialized
  */
 export function initializeSettings(settings) {
-    if (settingsInstance !== null) {
+    if (readSettings() !== null) {
         throw new Error('Settings already initialized. Cannot re-initialize.');
     }
-    settingsInstance = settings;
+    writeSettings(settings);
 }
 /**
  * Get the current application settings.
@@ -43,10 +57,11 @@ export function initializeSettings(settings) {
  * ```
  */
 export function getSettings() {
-    if (settingsInstance === null) {
+    const instance = readSettings();
+    if (instance === null) {
         throw new Error('Settings not initialized. Call initializeSettings() during CLI bootstrap.');
     }
-    return settingsInstance;
+    return instance;
 }
 /**
  * Check if settings have been initialized.
@@ -54,7 +69,7 @@ export function getSettings() {
  * @returns True if settings are initialized, false otherwise
  */
 export function hasSettings() {
-    return settingsInstance !== null;
+    return readSettings() !== null;
 }
 /**
  * Reset settings instance (for testing purposes only).
@@ -63,5 +78,5 @@ export function hasSettings() {
  * @internal
  */
 export function resetSettings() {
-    settingsInstance = null;
+    writeSettings(null);
 }

package/dist/src/presentation/cli/commands/agent/show.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/agent/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAoG3C"}
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/agent/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAoG3C"}

package/dist/src/presentation/cli/commands/agent/show.command.js

@@ -8,17 +8,10 @@
  *   shep agent show <id>
  */
 import { Command } from 'commander';
-import { createHash } from 'node:crypto';
-import { join } from 'node:path';
 import { colors, messages, symbols, renderDetailView } from '../../ui/index.js';
 import { resolveAgentRun } from './resolve-run.js';
 import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
-import { SHEP_HOME_DIR } from '../../../../../packages/core/src/infrastructure/services/filesystem/shep-directory.service.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);
-}
+import { computeWorktreePath } from '../../../../../packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.js';
 function isProcessAlive(pid) {
     try {
         process.kill(pid, 0);

package/dist/src/presentation/cli/commands/feat/show.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuEpC,wBAAgB,iBAAiB,IAAI,OAAO,CA4I3C"}
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DpC,wBAAgB,iBAAiB,IAAI,OAAO,CA4I3C"}

package/dist/src/presentation/cli/commands/feat/show.command.js

@@ -7,17 +7,10 @@
  * Usage: shep feat show <id>
  */
 import { Command } from 'commander';
-import { createHash } from 'node:crypto';
-import { join } from 'node:path';
 import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
 import { ShowFeatureUseCase } from '../../../../../packages/core/src/application/use-cases/features/show-feature.use-case.js';
 import { colors, symbols, messages, renderDetailView } from '../../ui/index.js';
-import { SHEP_HOME_DIR } from '../../../../../packages/core/src/infrastructure/services/filesystem/shep-directory.service.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);
-}
+import { computeWorktreePath } from '../../../../../packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.js';
 /** Map graph node names to human-readable phase labels (active). */
 const NODE_TO_PHASE = {
     analyze: 'Analyzing',

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;AA+CpC,wBAAgB,oBAAoB,IAAI,OAAO,CAwC9C"}
+{"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"}

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

@@ -6,20 +6,12 @@
  * 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 '../../../../packages/core/src/domain/generated/output.js';
 import { container } from '../../../../packages/core/src/infrastructure/di/container.js';
 import { ShowFeatureUseCase } from '../../../../packages/core/src/application/use-cases/features/show-feature.use-case.js';
 import { getSettings } from '../../../../packages/core/src/infrastructure/services/settings.service.js';
-import { createLauncherRegistry } from '../../../../packages/core/src/infrastructure/services/ide-launchers/ide-launcher.registry.js';
-import { SHEP_HOME_DIR } from '../../../../packages/core/src/infrastructure/services/filesystem/shep-directory.service.js';
+import { launchIde } from '../../../../packages/core/src/infrastructure/services/ide-launchers/launch-ide.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,
@@ -51,22 +43,20 @@ export function createIdeOpenCommand() {
         .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}`));
+            const useCase = container.resolve(ShowFeatureUseCase);
+            const feature = await useCase.execute(featId);
+            const result = await launchIde({
+                editorId,
+                repositoryPath: feature.repositoryPath,
+                branch: feature.branch,
+            });
+            if (!result.ok) {
+                messages.error(result.message, new Error(result.message));
                 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}`);
+            messages.success(`Opened ${result.editorName} at ${result.worktreePath}`);
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));

package/dist/src/presentation/web/app/api/features/create/route.d.ts

@@ -0,0 +1,5 @@
+import { NextResponse } from 'next/server';
+export declare function POST(request: Request): Promise<NextResponse<{
+    error: string;
+}> | NextResponse<import("../../../../../../../packages/core/src/infrastructure/di/use-cases-bridge.js").CreateFeatureResult>>;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/features/create/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../../src/presentation/web/app/api/features/create/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2B3C,wBAAsB,IAAI,CAAC,OAAO,EAAE,OAAO;;kGA0B1C"}

package/dist/src/presentation/web/app/api/features/create/route.js

@@ -0,0 +1,32 @@
+import { NextResponse } from 'next/server';
+import { createFeature } from '../../../../../../../packages/core/src/infrastructure/di/use-cases-bridge.js';
+function composeUserInput(name, description, attachments) {
+    let userInput = `Feature: ${name}`;
+    if (description) {
+        userInput += `\n\n${description}`;
+    }
+    if (attachments && attachments.length > 0) {
+        const paths = attachments.map((a) => `- ${a.path}`).join('\n');
+        userInput += `\n\nAttached files:\n${paths}`;
+    }
+    return userInput;
+}
+export async function POST(request) {
+    const body = await request.json();
+    const { name, description, repositoryPath, attachments } = body;
+    if (!name?.trim()) {
+        return NextResponse.json({ error: 'name is required' }, { status: 400 });
+    }
+    if (!repositoryPath?.trim()) {
+        return NextResponse.json({ error: 'repositoryPath is required' }, { status: 400 });
+    }
+    const userInput = composeUserInput(name, description, attachments);
+    try {
+        const result = await createFeature({ userInput, repositoryPath });
+        return NextResponse.json(result);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to create feature';
+        return NextResponse.json({ error: message }, { status: 500 });
+    }
+}

package/dist/src/presentation/web/app/api/ide/open/route.d.ts

@@ -0,0 +1,9 @@
+import { NextResponse } from 'next/server';
+export declare function POST(request: Request): Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    editor: string;
+    path: string;
+}>>;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/ide/open/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../../src/presentation/web/app/api/ide/open/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,wBAAsB,IAAI,CAAC,OAAO,EAAE,OAAO;;;;;;IA8B1C"}

package/dist/src/presentation/web/app/api/ide/open/route.js

@@ -0,0 +1,29 @@
+import { NextResponse } from 'next/server';
+import { getSettings } from '../../../../../../../packages/core/src/infrastructure/services/settings.service.js';
+import { launchIde } from '../../../../../../../packages/core/src/infrastructure/services/ide-launchers/launch-ide.js';
+import { validateToolbarInput } from '../../validate-toolbar-input.js';
+export async function POST(request) {
+    const body = await request.json();
+    const validation = validateToolbarInput(body);
+    if ('error' in validation) {
+        return NextResponse.json({ error: validation.error }, { status: validation.status });
+    }
+    const { repositoryPath, branch } = validation;
+    const settings = getSettings();
+    const editor = settings.environment.defaultEditor;
+    const result = await launchIde({
+        editorId: editor,
+        repositoryPath,
+        branch,
+        checkAvailability: true,
+    });
+    if (!result.ok) {
+        const status = result.code === 'launch_failed' ? 500 : 404;
+        return NextResponse.json({ error: result.message }, { status });
+    }
+    return NextResponse.json({
+        success: true,
+        editor: result.editorName,
+        path: result.worktreePath,
+    });
+}

package/dist/src/presentation/web/app/api/shell/open/route.d.ts

@@ -0,0 +1,9 @@
+import { NextResponse } from 'next/server';
+export declare function POST(request: Request): Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    path: string;
+    shell: string;
+}>>;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/shell/open/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../../src/presentation/web/app/api/shell/open/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,wBAAsB,IAAI,CAAC,OAAO,EAAE,OAAO;;;;;;IAsD1C"}