@shepai/cli 1.35.3 → 1.37.0

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/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,CA4L3C"}
+{"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;AAmFpC,wBAAgB,iBAAiB,IAAI,OAAO,CAiO3C"}

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

@@ -61,6 +61,17 @@ function formatLifecycle(lifecycle) {
         return colors.warning(lifecycle);
     return colors.info(lifecycle);
 }
+function formatDuration(ms) {
+    const secs = ms / 1000;
+    const totalSecs = Math.round(secs);
+    const mins = Math.floor(totalSecs / 60);
+    const remSecs = totalSecs % 60;
+    const secsStr = secs.toFixed(1);
+    if (mins > 0) {
+        return `${secsStr}s (${mins}m ${remSecs}s)`;
+    }
+    return `${secsStr}s`;
+}
 function isProcessAlive(pid) {
     try {
         process.kill(pid, 0);
@@ -109,7 +120,8 @@ export function createShowCommand() {
                 const isWaiting = run?.status === 'waiting_approval';
                 const maxDurationMs = Math.max(...timings.map((t) => (t.durationMs != null ? Number(t.durationMs) : 0)));
                 const MAX_BAR = 20;
-                const lines = timings.map((t, idx) => {
+                const lines = [];
+                for (const [idx, t] of timings.entries()) {
                     const isLast = idx === timings.length - 1;
                     const isSubPhase = t.phase.includes(':');
                     const label = isSubPhase
@@ -121,21 +133,43 @@ export function createShowCommand() {
                         const secs = (ms / 1000).toFixed(1);
                         const barLen = maxDurationMs > 0 ? Math.max(1, Math.round((ms / maxDurationMs) * MAX_BAR)) : 1;
                         const bar = `${colors.success('\u2588'.repeat(barLen))}${colors.muted('\u2591'.repeat(MAX_BAR - barLen))}`;
-                        return `${label} ${bar} ${secs}s`;
+                        lines.push(`${label} ${bar} ${secs}s`);
                     }
                     // Waiting for approval - only the LAST timing
-                    if (isLast && isWaiting) {
-                        return `${label} ${colors.warning('awaiting review')}`;
+                    else if (isLast && isWaiting) {
+                        lines.push(`${label} ${colors.warning('awaiting review')}`);
                     }
                     // Running phase - blue bar with elapsed time
-                    const elapsedMs = Math.max(0, Date.now() - new Date(t.startedAt).getTime());
-                    const secs = (elapsedMs / 1000).toFixed(1);
-                    const barLen = maxDurationMs > 0
-                        ? Math.min(MAX_BAR, Math.max(1, Math.round((elapsedMs / maxDurationMs) * MAX_BAR)))
-                        : 1;
-                    const bar = `${colors.info('\u2588'.repeat(barLen))}${colors.muted('\u2591'.repeat(MAX_BAR - barLen))}`;
-                    return `${label} ${bar} ${secs}s (running)`;
-                });
+                    else {
+                        const elapsedMs = Math.max(0, Date.now() - new Date(t.startedAt).getTime());
+                        const secs = (elapsedMs / 1000).toFixed(1);
+                        const barLen = maxDurationMs > 0
+                            ? Math.min(MAX_BAR, Math.max(1, Math.round((elapsedMs / maxDurationMs) * MAX_BAR)))
+                            : 1;
+                        const bar = `${colors.info('\u2588'.repeat(barLen))}${colors.muted('\u2591'.repeat(MAX_BAR - barLen))}`;
+                        lines.push(`${label} ${bar} ${secs}s (running)`);
+                    }
+                    // Show approval wait time under gated phases
+                    if (t.approvalWaitMs != null && Number(t.approvalWaitMs) > 0) {
+                        const waitMs = Number(t.approvalWaitMs);
+                        const waitSecs = (waitMs / 1000).toFixed(1);
+                        const waitLabel = '  \u21b3 approval'.padEnd(16);
+                        const waitBarLen = maxDurationMs > 0 ? Math.max(1, Math.round((waitMs / maxDurationMs) * MAX_BAR)) : 1;
+                        const waitBar = `${colors.warning('\u2588'.repeat(waitBarLen))}${colors.muted('\u2591'.repeat(MAX_BAR - waitBarLen))}`;
+                        lines.push(`${waitLabel} ${waitBar} ${waitSecs}s`);
+                    }
+                }
+                // Summary totals
+                const totalExecMs = timings.reduce((sum, t) => sum + (t.durationMs != null ? Number(t.durationMs) : 0), 0);
+                const totalWaitMs = timings.reduce((sum, t) => sum + (t.approvalWaitMs != null ? Number(t.approvalWaitMs) : 0), 0);
+                if (totalExecMs > 0) {
+                    lines.push('');
+                    lines.push(`${'Total execution'.padEnd(16)} ${formatDuration(totalExecMs)}`);
+                    if (totalWaitMs > 0) {
+                        lines.push(`${'Total wait'.padEnd(16)} ${formatDuration(totalWaitMs)}`);
+                        lines.push(`${'Total wall-clock'.padEnd(16)} ${formatDuration(totalExecMs + totalWaitMs)}`);
+                    }
+                }
                 textBlocks.push({ title: 'Phase Timing', content: lines.join('\n') });
             }
             if (run?.status === 'waiting_approval') {

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"}

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

@@ -2,51 +2,49 @@
  * 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';
-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 { LaunchIdeUseCase } from '../../../../packages/core/src/application/use-cases/ide/launch-ide.use-case.js';
 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 { getIdeEntries } from '../../../../packages/core/src/infrastructure/services/tool-installer/tool-metadata.js';
 import { messages } from '../ui/index.js';
-/** 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,
-};
+/** Commander converts --kebab-case flags to camelCase option keys. */
+function toCamelCase(s) {
+    return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
 /**
  * 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;
-        }
+function resolveEditorId(options, ideIds) {
+    for (const id of ideIds) {
+        if (options[toCamelCase(id)])
+            return id;
     }
     return getSettings().environment.defaultEditor;
 }
 export function createIdeOpenCommand() {
-    return new Command('ide')
+    const cmd = 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) => {
+        .argument('<feat-id>', 'Feature ID or prefix');
+    const ideEntries = getIdeEntries();
+    const ideIds = ideEntries.map(([id]) => id);
+    for (const [id, meta] of ideEntries) {
+        cmd.option(`--${id}`, `Open in ${meta.name}`);
+    }
+    cmd.action(async (featId, options) => {
         try {
-            const editorId = resolveEditorId(options);
-            const useCase = container.resolve(ShowFeatureUseCase);
-            const feature = await useCase.execute(featId);
-            const result = await launchIde({
+            const editorId = resolveEditorId(options, ideIds);
+            const showFeature = container.resolve(ShowFeatureUseCase);
+            const feature = await showFeature.execute(featId);
+            const launchIde = container.resolve(LaunchIdeUseCase);
+            const result = await launchIde.execute({
                 editorId,
                 repositoryPath: feature.repositoryPath,
                 branch: feature.branch,
@@ -64,4 +62,5 @@ export function createIdeOpenCommand() {
             process.exitCode = 1;
         }
     });
+    return cmd;
 }

package/dist/src/presentation/cli/commands/install.command.js

@@ -17,8 +17,8 @@ import { TOOL_METADATA } from '../../../../packages/core/src/infrastructure/serv
 import { messages, fmt, colors } from '../ui/index.js';
 function printToolsList() {
     const tools = Object.entries(TOOL_METADATA);
-    const ides = tools.filter(([, meta]) => meta.category === 'ide');
-    const cliAgents = tools.filter(([, meta]) => meta.category === 'cli-agent');
+    const ides = tools.filter(([, meta]) => meta.tags.includes('ide'));
+    const cliAgents = tools.filter(([, meta]) => meta.tags.includes('cli-agent'));
     console.log(fmt.heading('IDEs:'));
     for (const [key, meta] of ides) {
         console.log(`  ${colors.accent(key.padEnd(16))}${meta.name} - ${colors.muted(meta.summary)}`);
@@ -101,7 +101,7 @@ function printInstallInstructions(metadata) {
     console.log(`${fmt.label('Name:')} ${metadata.name}`);
     console.log(`${fmt.label('Summary:')} ${metadata.summary}`);
     console.log(`${fmt.label('Description:')} ${metadata.description}`);
-    console.log(`${fmt.label('Category:')} ${metadata.category}`);
+    console.log(`${fmt.label('Tags:')} ${metadata.tags.join(', ')}`);
     console.log();
     const binaryDisplay = typeof metadata.binary === 'string'
         ? metadata.binary

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

@@ -2,6 +2,7 @@
  * IDE Configuration Command
  *
  * Configures the preferred IDE/editor used by Shep.
+ * Valid editors are derived dynamically from JSON tool metadata.
  *
  * Usage:
  *   shep settings ide                    # Interactive selection

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

@@ -1 +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"}
+{"version":3,"file":"ide.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/ide.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CA+D1C"}

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

@@ -2,6 +2,7 @@
  * IDE Configuration Command
  *
  * Configures the preferred IDE/editor used by Shep.
+ * Valid editors are derived dynamically from JSON tool metadata.
  *
  * Usage:
  *   shep settings ide                    # Interactive selection
@@ -9,22 +10,21 @@
  */
 import { Command } from 'commander';
 import { select } from '@inquirer/prompts';
-import { EditorType } from '../../../../../packages/core/src/domain/generated/output.js';
 import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
 import { UpdateSettingsUseCase } from '../../../../../packages/core/src/application/use-cases/settings/update-settings.use-case.js';
 import { createIdeSelectConfig } from '../../../tui/prompts/ide-select.prompt.js';
 import { getSettings, resetSettings, initializeSettings, } from '../../../../../packages/core/src/infrastructure/services/settings.service.js';
-import { createLauncherRegistry } from '../../../../../packages/core/src/infrastructure/services/ide-launchers/ide-launcher.registry.js';
+import { getIdeEntries } from '../../../../../packages/core/src/infrastructure/services/tool-installer/tool-metadata.js';
 import { messages } from '../../ui/index.js';
-/** Valid EditorType values for input validation. */
-const VALID_EDITORS = new Set(Object.values(EditorType));
+/** Valid IDE tool IDs derived from JSON metadata. */
+const VALID_EDITORS = new Set(getIdeEntries().map(([id]) => id));
 /**
  * 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)')
+        .option('--editor <name>', `IDE/editor name (${[...VALID_EDITORS].join(', ')})`)
         .addHelpText('after', `
 Examples:
   $ shep settings ide                           Interactive selection
@@ -44,14 +44,11 @@ Examples:
             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.`);
-                }
+            // PATH check via IDE launcher service (non-blocking warning)
+            const ideLauncher = container.resolve('IIdeLauncherService');
+            const available = await ideLauncher.checkAvailability(editorValue);
+            if (!available) {
+                messages.warning(`Editor '${editorValue}' not found in PATH. The editor will still be saved.`);
             }
             // Persist settings
             const settings = getSettings();