@shepai/cli 1.68.1 → 1.70.0

package/dist/packages/core/src/application/use-cases/tools/list-tools.use-case.d.ts

@@ -13,7 +13,7 @@ export interface ToolItem {
     name: string;
     summary: string;
     description: string;
-    tags: ('ide' | 'cli-agent' | 'vcs')[];
+    tags: ('ide' | 'cli-agent' | 'vcs' | 'terminal')[];
     iconUrl: string | undefined;
     autoInstall: boolean;
     required: boolean;

package/dist/packages/core/src/application/use-cases/tools/list-tools.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-tools.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/tools/list-tools.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAGlF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC;IACtC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,EAAE,CAAC;AAWzC,qBACa,gBAAgB;IAGzB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,qBAAqB;IAGxD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;CAgC1C"}
+{"version":3,"file":"list-tools.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/tools/list-tools.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAGlF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;IACnD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,EAAE,CAAC;AAWzC,qBACa,gBAAgB;IAGzB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,qBAAqB;IAGxD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;CAgC1C"}

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

@@ -15,7 +15,8 @@ import type { IToolInstallerService } from '../../../application/ports/output/se
 import type { ToolInstallationStatus, ToolInstallCommand } from '../../../domain/generated/output.js';
 export declare class ToolInstallerServiceImpl implements IToolInstallerService {
     /**
-     * Check if a tool binary is available on the system (PATH check)
+     * Check if a tool binary is available on the system (PATH check,
+     * with verifyCommand fallback for GUI apps).
      */
     checkAvailability(toolName: string): Promise<ToolInstallationStatus>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"tool-installer.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/tool-installer/tool-installer.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sEAAsE,CAAC;AAClH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAEnB,MAAM,qCAAqC,CAAC;AA6C7C,qBACa,wBAAyB,YAAW,qBAAqB;IACpE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA4B1E;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAqB9D;;;OAGG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAuElC;;OAEG;IACH,OAAO,CAAC,6BAA6B;CA4BtC"}
+{"version":3,"file":"tool-installer.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/tool-installer/tool-installer.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sEAAsE,CAAC;AAClH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAEnB,MAAM,qCAAqC,CAAC;AAsD7C,qBACa,wBAAyB,YAAW,qBAAqB;IACpE;;;OAGG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoC1E;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAqB9D;;;OAGG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAuElC;;OAEG;IACH,OAAO,CAAC,6BAA6B;CA4BtC"}

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

@@ -18,7 +18,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { injectable } from 'tsyringe';
-import { execFile, spawn } from 'node:child_process';
+import { exec, execFile, spawn } from 'node:child_process';
 import { platform } from 'node:os';
 import { createAvailableStatus, createMissingStatus, createErrorStatus, } from '../../../domain/value-objects/tool-installation-status.js';
 import { TOOL_METADATA } from './tool-metadata.js';
@@ -55,9 +55,17 @@ const checkBinaryExists = (binary) => {
         });
     });
 };
+/**
+ * Run a shell command and resolve true when it exits 0, false otherwise.
+ * Used as a fallback for GUI apps whose binary isn't in PATH (e.g. Warp, iTerm2).
+ */
+const runVerifyCommand = (command) => new Promise((resolve) => {
+    exec(command, (err) => resolve(!err));
+});
 let ToolInstallerServiceImpl = class ToolInstallerServiceImpl {
     /**
-     * Check if a tool binary is available on the system (PATH check)
+     * Check if a tool binary is available on the system (PATH check,
+     * with verifyCommand fallback for GUI apps).
      */
     async checkAvailability(toolName) {
         const metadata = TOOL_METADATA[toolName];
@@ -69,6 +77,13 @@ let ToolInstallerServiceImpl = class ToolInstallerServiceImpl {
             if (result.found) {
                 return createAvailableStatus(toolName);
             }
+            // Binary not in PATH — try verifyCommand as fallback (handles GUI .app bundles)
+            if (result.notInPath && metadata.verifyCommand) {
+                const verified = await runVerifyCommand(metadata.verifyCommand);
+                if (verified) {
+                    return createAvailableStatus(toolName);
+                }
+            }
             if (result.notInPath) {
                 const suggestions = this.createInstallationSuggestions(metadata);
                 return createMissingStatus(toolName, suggestions);

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

@@ -15,7 +15,7 @@ export interface ToolMetadata {
     /** Detailed description */
     description: string;
     /** Tool tags for grouping in listings. A tool can belong to multiple categories. */
-    tags: ('ide' | 'cli-agent' | 'vcs')[];
+    tags: ('ide' | 'cli-agent' | 'vcs' | 'terminal')[];
     /** URL to the tool's icon/logo image */
     iconUrl?: string;
     /** Binary name to check with 'which' command (string or per-platform 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,oFAAoF;IACpF,IAAI,EAAE,CAAC,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC;IAEtC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,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,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;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;IAEF;;;;wEAIoE;IACpE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnD;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"}
+{"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,GAAG,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;IAEnD,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,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,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;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;IAEF;;;;wEAIoE;IACpE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnD;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/tools/CLAUDE.md

@@ -5,24 +5,24 @@ Files are loaded dynamically by `tool-metadata.ts` — the filename (minus `.jso
 
 ## Schema
 
-| Field              | Type                              | Required | Description                                                              |
-| ------------------ | --------------------------------- | -------- | ------------------------------------------------------------------------ |
-| `name`             | `string`                          | Yes      | Human-readable display name                                              |
-| `summary`          | `string`                          | Yes      | One-line description                                                     |
-| `description`      | `string`                          | Yes      | Detailed description                                                     |
-| `tags`             | `("ide"\|"cli-agent"\|"vcs")[]`   | Yes      | Categories for filtering in UI and CLI                                   |
-| `iconUrl`          | `string`                          | No       | URL to SVG/PNG icon (use cdn.simpleicons.org when possible)              |
-| `binary`           | `string \| Record<string,string>` | Yes      | Binary name for `which` check. Per-platform map if differs               |
-| `packageManager`   | `string`                          | Yes      | Install method label (apt, brew, curl, manual, download)                 |
-| `commands`         | `Record<string,string>`           | Yes      | Platform-keyed install commands (`linux`, `darwin`)                      |
-| `timeout`          | `number`                          | Yes      | Install timeout in ms (typically 300000)                                 |
-| `documentationUrl` | `string`                          | Yes      | Official docs URL                                                        |
-| `verifyCommand`    | `string`                          | Yes      | Command to verify installation (e.g. `git --version`)                    |
-| `autoInstall`      | `boolean`                         | No       | `true` (default) = run commands automatically. `false` = manual download |
-| `required`         | `boolean`                         | No       | `true` = tool is required for platform to function                       |
-| `openDirectory`    | `string \| Record<string,string>` | No       | Command to open a directory. Use `{dir}` placeholder                     |
-| `spawnOptions`     | `object`                          | No       | Override spawn behavior (see below)                                      |
-| `terminalCommand`  | `string \| Record<string,string>` | No       | Command to open tool in a **new terminal window** from web UI            |
+| Field              | Type                                        | Required | Description                                                              |
+| ------------------ | ------------------------------------------- | -------- | ------------------------------------------------------------------------ |
+| `name`             | `string`                                    | Yes      | Human-readable display name                                              |
+| `summary`          | `string`                                    | Yes      | One-line description                                                     |
+| `description`      | `string`                                    | Yes      | Detailed description                                                     |
+| `tags`             | `("ide"\|"cli-agent"\|"vcs"\|"terminal")[]` | Yes      | Categories for filtering in UI and CLI                                   |
+| `iconUrl`          | `string`                                    | No       | URL to SVG/PNG icon (use cdn.simpleicons.org when possible)              |
+| `binary`           | `string \| Record<string,string>`           | Yes      | Binary name for `which` check. Per-platform map if differs               |
+| `packageManager`   | `string`                                    | Yes      | Install method label (apt, brew, curl, manual, download)                 |
+| `commands`         | `Record<string,string>`                     | Yes      | Platform-keyed install commands (`linux`, `darwin`)                      |
+| `timeout`          | `number`                                    | Yes      | Install timeout in ms (typically 300000)                                 |
+| `documentationUrl` | `string`                                    | Yes      | Official docs URL                                                        |
+| `verifyCommand`    | `string`                                    | Yes      | Command to verify installation (e.g. `git --version`)                    |
+| `autoInstall`      | `boolean`                                   | No       | `true` (default) = run commands automatically. `false` = manual download |
+| `required`         | `boolean`                                   | No       | `true` = tool is required for platform to function                       |
+| `openDirectory`    | `string \| Record<string,string>`           | No       | Command to open a directory. Use `{dir}` placeholder                     |
+| `spawnOptions`     | `object`                                    | No       | Override spawn behavior (see below)                                      |
+| `terminalCommand`  | `string \| Record<string,string>`           | No       | Command to open tool in a **new terminal window** from web UI            |
 
 ## Spawn Options
 
@@ -59,5 +59,32 @@ The launcher auto-detects TTY: CLI launch uses `openDirectory`, web launch uses
 | `ide`       | GUI code editor                | VS Code, Cursor, Zed    |
 | `cli-agent` | Terminal-based AI coding agent | Claude Code, Cursor CLI |
 | `vcs`       | Version control tool           | Git, GitHub CLI         |
+| `terminal`  | Terminal emulator/multiplexer  | tmux, Kitty, Alacritty  |
 
 Tools can have multiple tags. A tool appears in all matching filter tabs in the UI.
+
+### Terminal Tools
+
+Terminal tools use the `terminal` tag. GUI terminals (Kitty, Alacritty) use `brew install --cask` on macOS.
+CLI tools like tmux use `brew install` (formula). Terminals with `--working-directory` flags can include
+`openDirectory` for launch support. tmux requires `spawnOptions` with `shell: true` and `stdio: "inherit"`
+since it runs inside the current terminal session.
+
+Example (tmux):
+
+```json
+{
+  "name": "tmux",
+  "summary": "Terminal multiplexer for session management",
+  "tags": ["terminal"],
+  "binary": "tmux",
+  "packageManager": "brew",
+  "commands": { "darwin": "brew install tmux", "linux": "apt install -y tmux" },
+  "timeout": 300000,
+  "documentationUrl": "https://github.com/tmux/tmux/wiki",
+  "verifyCommand": "tmux -V",
+  "autoInstall": true,
+  "openDirectory": "tmux new-session -c {dir}",
+  "spawnOptions": { "shell": true, "stdio": "inherit", "detached": false }
+}
+```

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

@@ -0,0 +1,18 @@
+{
+  "name": "Alacritty",
+  "summary": "GPU-accelerated terminal emulator",
+  "description": "Alacritty is a modern, GPU-accelerated terminal emulator focused on simplicity and performance. Cross-platform (macOS and Linux). On older Linux distributions, you may need to add a PPA before installing via apt.",
+  "tags": ["terminal"],
+  "iconUrl": "https://cdn.simpleicons.org/alacritty",
+  "binary": "alacritty",
+  "packageManager": "brew",
+  "commands": {
+    "darwin": "brew install --cask alacritty",
+    "linux": "apt install -y alacritty"
+  },
+  "timeout": 300000,
+  "documentationUrl": "https://alacritty.org/",
+  "verifyCommand": "alacritty --version",
+  "autoInstall": false,
+  "openDirectory": "alacritty --working-directory {dir}"
+}

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

@@ -0,0 +1,17 @@
+{
+  "name": "iTerm2",
+  "summary": "macOS terminal replacement",
+  "description": "iTerm2 is a feature-rich replacement for the default macOS Terminal.app with split panes, search, autocomplete, and extensive customization. macOS only. Verified by checking for the iTerm.app bundle in /Applications.",
+  "tags": ["terminal"],
+  "iconUrl": "https://cdn.simpleicons.org/iterm2",
+  "binary": "iterm2",
+  "packageManager": "brew",
+  "commands": {
+    "darwin": "brew install --cask iterm2"
+  },
+  "timeout": 300000,
+  "documentationUrl": "https://iterm2.com/documentation.html",
+  "verifyCommand": "test -d /Applications/iTerm.app",
+  "autoInstall": false,
+  "openDirectory": "open -a iTerm {dir}"
+}

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

@@ -0,0 +1,18 @@
+{
+  "name": "Kitty",
+  "summary": "Fast, GPU-based terminal emulator",
+  "description": "Kitty is a fast, feature-rich, GPU-based terminal emulator with advanced graphics support, extensibility via kittens, and modern rendering. Cross-platform (macOS and Linux).",
+  "tags": ["terminal"],
+  "iconUrl": "https://raw.githubusercontent.com/kovidgoyal/kitty/master/logo/kitty.svg",
+  "binary": "kitty",
+  "packageManager": "brew",
+  "commands": {
+    "darwin": "brew install --cask kitty",
+    "linux": "apt install -y kitty"
+  },
+  "timeout": 300000,
+  "documentationUrl": "https://sw.kovidgoyal.net/kitty/",
+  "verifyCommand": "kitty --version",
+  "autoInstall": false,
+  "openDirectory": "kitty --working-directory {dir}"
+}

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

@@ -0,0 +1,27 @@
+{
+  "name": "tmux",
+  "summary": "Terminal multiplexer for session management",
+  "description": "tmux is a terminal multiplexer that lets you create, manage, and switch between multiple terminal sessions. Ideal for remote development, persistent sessions, and multi-pane workflows. Cross-platform (macOS and Linux).",
+  "tags": ["terminal"],
+  "iconUrl": "https://cdn.simpleicons.org/tmux",
+  "binary": "tmux",
+  "packageManager": "brew",
+  "commands": {
+    "darwin": "brew install tmux",
+    "linux": "apt install -y tmux"
+  },
+  "timeout": 300000,
+  "documentationUrl": "https://github.com/tmux/tmux/wiki",
+  "verifyCommand": "tmux -V",
+  "autoInstall": true,
+  "openDirectory": "tmux new-session -c {dir}",
+  "terminalCommand": {
+    "darwin": "osascript -e 'tell application \"Terminal\" to do script \"tmux new-session -c {dir}\"' -e 'tell application \"Terminal\" to activate'",
+    "linux": "x-terminal-emulator -e tmux new-session -c {dir}"
+  },
+  "spawnOptions": {
+    "shell": true,
+    "stdio": "inherit",
+    "detached": false
+  }
+}

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

@@ -0,0 +1,17 @@
+{
+  "name": "Warp",
+  "summary": "Modern terminal with AI features",
+  "description": "Warp is a modern terminal with AI-powered features, intelligent command suggestions, and a collaborative workflow. macOS only — Linux users can install manually via AppImage from https://www.warp.dev/.",
+  "tags": ["terminal"],
+  "iconUrl": "https://cdn.simpleicons.org/warp",
+  "binary": "warp",
+  "packageManager": "brew",
+  "commands": {
+    "darwin": "brew install --cask warp"
+  },
+  "timeout": 300000,
+  "documentationUrl": "https://docs.warp.dev/",
+  "verifyCommand": "test -d /Applications/Warp.app",
+  "autoInstall": false,
+  "openDirectory": "open -a Warp {dir}"
+}

package/dist/src/presentation/web/components/common/feature-node/feature-node-state-config.d.ts

@@ -22,6 +22,8 @@ export interface FeatureNodeData {
     branch: string;
     /** Absolute path to the specs folder on disk */
     specPath?: string;
+    /** Epoch ms when the current agent run started (for elapsed-time in sidebar) */
+    startedAt?: number;
     /** Human-readable runtime for done state (e.g. "2h 15m") */
     runtime?: string;
     /** Feature name this node is blocked by */

package/dist/src/presentation/web/components/common/feature-node/feature-node-state-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-node-state-config.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/feature-node/feature-node-state-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,MAAM,GACN,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,UAAU,CAAC;AAEf,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAOxE,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAOvE,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,+DAA+D;IAC/D,EAAE,CAAC,EAAE;QACH,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,QAAQ,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CA6DnF,CAAC"}
+{"version":3,"file":"feature-node-state-config.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/feature-node/feature-node-state-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,MAAM,GACN,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,UAAU,CAAC;AAEf,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAOxE,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAOvE,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,+DAA+D;IAC/D,EAAE,CAAC,EAAE;QACH,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,QAAQ,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CA6DnF,CAAC"}

package/dist/src/presentation/web/components/features/control-center/control-center-inner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-center-inner.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/control-center-inner.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAU5E,UAAU,uBAAuB;IAC/B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,EAAE,IAAI,EAAE,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,uBAAuB,2CAyJzF"}
+{"version":3,"file":"control-center-inner.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/control-center-inner.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAc5E,UAAU,uBAAuB;IAC/B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,EAAE,IAAI,EAAE,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,uBAAuB,2CAiMzF"}

package/dist/src/presentation/web/components/features/control-center/control-center-inner.js

@@ -5,10 +5,42 @@ import { FeaturesCanvas } from '../../features/features-canvas/index.js';
 import { ControlCenterDrawer, computeDrawerView } from '../../common/control-center-drawer/index.js';
 import { NotificationPermissionBanner } from '../../common/notification-permission-banner/index.js';
 import { getWorkflowDefaults } from '../../../app/actions/get-workflow-defaults.js';
+import { useSidebarFeaturesContext, mapNodeStateToSidebarStatus, } from '../../../hooks/sidebar-features-context.js';
 import { ControlCenterEmptyState } from './control-center-empty-state.js';
 import { useControlCenterState } from './use-control-center-state.js';
 export function ControlCenterInner({ initialNodes, initialEdges }) {
     const { nodes, edges, selectedNode, isCreateDrawerOpen, isDeleting, pendingRepositoryPath, onNodesChange, handleConnect, handleAddFeature, handleAddFeatureToRepo, handleAddFeatureToFeature, handleAddRepository, handleNodeClick, clearSelection, handleCreateFeatureSubmit, handleDeleteFeature, handleDeleteRepository, closeCreateDrawer, selectFeatureById, pendingParentFeatureId, } = useControlCenterState(initialNodes, initialEdges);
+    // Publish sidebar features to context whenever feature node data changes
+    const { setFeatures: setSidebarFeatures } = useSidebarFeaturesContext();
+    const sidebarKey = useMemo(() => {
+        return nodes
+            .filter((n) => n.type === 'featureNode')
+            .map((n) => {
+            const d = n.data;
+            return `${d.featureId}:${d.state}:${d.runtime ?? ''}:${d.startedAt ?? ''}`;
+        })
+            .sort()
+            .join(',');
+    }, [nodes]);
+    useEffect(() => {
+        const sidebarItems = nodes
+            .filter((n) => n.type === 'featureNode')
+            .map((n) => {
+            const d = n.data;
+            const status = mapNodeStateToSidebarStatus(d.state);
+            if (!status)
+                return null;
+            return {
+                featureId: d.featureId,
+                name: d.name,
+                status,
+                ...(d.startedAt != null && { startedAt: d.startedAt }),
+                ...(d.runtime != null && { duration: d.runtime }),
+            };
+        })
+            .filter(Boolean);
+        setSidebarFeatures(sidebarItems);
+    }, [sidebarKey, nodes, setSidebarFeatures]);
     // Feature list for the parent selector in the create drawer
     const featureOptions = useMemo(() => nodes
         .filter((n) => n.type === 'featureNode')

package/dist/src/presentation/web/components/features/tools/tool-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-card.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/tool-card.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,aAAa,2CA2JrE"}
+{"version":3,"file":"tool-card.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/tool-card.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,aAAa,2CA2JrE"}

package/dist/src/presentation/web/components/features/tools/tool-card.js

@@ -9,6 +9,7 @@ const TAG_CONFIG = {
     ide: { label: 'IDE', icon: Monitor },
     'cli-agent': { label: 'CLI Agent', icon: Terminal },
     vcs: { label: 'VCS', icon: GitBranch },
+    terminal: { label: 'Terminal', icon: Terminal },
 };
 export function ToolCard({ tool, onRefresh, className }) {
     const [installDrawerOpen, setInstallDrawerOpen] = useState(false);

package/dist/src/presentation/web/components/features/tools/tools-page-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/tools-page-client.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CA4EvF"}
+{"version":3,"file":"tools-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/tools-page-client.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CA+EvF"}

package/dist/src/presentation/web/components/features/tools/tools-page-client.js

@@ -10,6 +10,7 @@ const TAB_FILTER = {
     ide: (tool) => tool.tags.includes('ide'),
     'cli-agent': (tool) => tool.tags.includes('cli-agent'),
     vcs: (tool) => tool.tags.includes('vcs'),
+    terminal: (tool) => tool.tags.includes('terminal'),
 };
 export function ToolsPageClient({ tools: initialTools, className }) {
     const [tools, setTools] = useState(initialTools);
@@ -27,5 +28,5 @@ export function ToolsPageClient({ tools: initialTools, className }) {
         }
     }
     const filtered = tools.filter(TAB_FILTER[activeTab]);
-    return (_jsxs("div", { "data-testid": "tools-page-client", className: cn('space-y-4', className), children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Wrench, { className: "text-muted-foreground h-4 w-4" }), _jsx("h1", { className: "text-sm font-bold tracking-tight", children: "Tools" }), _jsxs("span", { className: "text-muted-foreground text-[10px]", children: [tools.filter((t) => t.status.status === 'available').length, "/", tools.length, " installed"] })] }), _jsxs(Tabs, { value: activeTab, onValueChange: (value) => setActiveTab(value), "data-testid": "tools-page-tabs", children: [_jsxs(TabsList, { className: "h-7", children: [_jsx(TabsTrigger, { value: "all", "data-testid": "tools-tab-all", className: "px-2.5 text-xs", children: "All" }), _jsx(TabsTrigger, { value: "ide", "data-testid": "tools-tab-ide", className: "px-2.5 text-xs", children: "IDEs" }), _jsx(TabsTrigger, { value: "cli-agent", "data-testid": "tools-tab-cli-agent", className: "px-2.5 text-xs", children: "CLI Agents" }), _jsx(TabsTrigger, { value: "vcs", "data-testid": "tools-tab-vcs", className: "px-2.5 text-xs", children: "Version Control" })] }), _jsx(TabsContent, { value: activeTab, className: "mt-3", children: filtered.length === 0 ? (_jsxs("div", { "data-testid": "tools-page-empty", className: "text-muted-foreground flex flex-col items-center justify-center py-12 text-center", children: [_jsx(Wrench, { className: "mb-2 h-6 w-6 opacity-20" }), _jsx("p", { className: "text-xs", children: "No tools in this category." })] })) : (_jsx("div", { "data-testid": "tools-page-grid", className: "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4", children: filtered.map((tool) => (_jsx(ToolCard, { tool: tool, onRefresh: refreshTools }, tool.id))) })) })] })] }));
+    return (_jsxs("div", { "data-testid": "tools-page-client", className: cn('space-y-4', className), children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Wrench, { className: "text-muted-foreground h-4 w-4" }), _jsx("h1", { className: "text-sm font-bold tracking-tight", children: "Tools" }), _jsxs("span", { className: "text-muted-foreground text-[10px]", children: [tools.filter((t) => t.status.status === 'available').length, "/", tools.length, " installed"] })] }), _jsxs(Tabs, { value: activeTab, onValueChange: (value) => setActiveTab(value), "data-testid": "tools-page-tabs", children: [_jsxs(TabsList, { className: "h-7", children: [_jsx(TabsTrigger, { value: "all", "data-testid": "tools-tab-all", className: "px-2.5 text-xs", children: "All" }), _jsx(TabsTrigger, { value: "ide", "data-testid": "tools-tab-ide", className: "px-2.5 text-xs", children: "IDEs" }), _jsx(TabsTrigger, { value: "cli-agent", "data-testid": "tools-tab-cli-agent", className: "px-2.5 text-xs", children: "CLI Agents" }), _jsx(TabsTrigger, { value: "vcs", "data-testid": "tools-tab-vcs", className: "px-2.5 text-xs", children: "Version Control" }), _jsx(TabsTrigger, { value: "terminal", "data-testid": "tools-tab-terminal", className: "px-2.5 text-xs", children: "Terminals" })] }), _jsx(TabsContent, { value: activeTab, className: "mt-3", children: filtered.length === 0 ? (_jsxs("div", { "data-testid": "tools-page-empty", className: "text-muted-foreground flex flex-col items-center justify-center py-12 text-center", children: [_jsx(Wrench, { className: "mb-2 h-6 w-6 opacity-20" }), _jsx("p", { className: "text-xs", children: "No tools in this category." })] })) : (_jsx("div", { "data-testid": "tools-page-grid", className: "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4", children: filtered.map((tool) => (_jsx(ToolCard, { tool: tool, onRefresh: refreshTools }, tool.id))) })) })] })] }));
 }

package/dist/src/presentation/web/components/layouts/app-shell/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-shell/app-shell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASpD,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAgCD,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAMnD"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-shell/app-shell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAapD,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AA0CD,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAQnD"}

package/dist/src/presentation/web/components/layouts/app-shell/app-shell.js

@@ -7,19 +7,24 @@ import { AddRepositoryButton } from '../../common/add-repository-node/index.js';
 import { ThemeToggle } from '../../common/theme-toggle/index.js';
 import { SoundToggle } from '../../common/sound-toggle/index.js';
 import { AgentEventsProvider } from '../../../hooks/agent-events-provider.js';
+import { SidebarFeaturesProvider, useSidebarFeaturesContext, } from '../../../hooks/sidebar-features-context.js';
 import { useNotifications } from '../../../hooks/use-notifications.js';
 /** Inner shell that consumes the agent-events context for notifications. */
 function AppShellInner({ children }) {
     // Subscribe to agent lifecycle events and dispatch toast/browser notifications
     useNotifications();
+    const { features } = useSidebarFeaturesContext();
     const handleNewFeature = useCallback(() => {
         window.dispatchEvent(new CustomEvent('shep:open-create-drawer'));
     }, []);
+    const handleFeatureClick = useCallback((featureId) => {
+        window.dispatchEvent(new CustomEvent('shep:select-feature', { detail: { featureId } }));
+    }, []);
     const handleRepositorySelect = useCallback((path) => {
         window.dispatchEvent(new CustomEvent('shep:add-repository', { detail: { path } }));
     }, []);
-    return (_jsxs(SidebarProvider, { children: [_jsx(AppSidebar, { features: [], onNewFeature: handleNewFeature }), _jsx(SidebarInset, { children: _jsxs("div", { className: "relative h-full", children: [_jsxs("div", { className: "absolute top-3 right-3 z-50 flex gap-1", children: [_jsx(AddRepositoryButton, { onSelect: handleRepositorySelect }), _jsx(SoundToggle, {}), _jsx(ThemeToggle, {})] }), _jsx("main", { className: "h-full", children: children })] }) })] }));
+    return (_jsxs(SidebarProvider, { children: [_jsx(AppSidebar, { features: features, onNewFeature: handleNewFeature, onFeatureClick: handleFeatureClick }), _jsx(SidebarInset, { children: _jsxs("div", { className: "relative h-full", children: [_jsxs("div", { className: "absolute top-3 right-3 z-50 flex gap-1", children: [_jsx(AddRepositoryButton, { onSelect: handleRepositorySelect }), _jsx(SoundToggle, {}), _jsx(ThemeToggle, {})] }), _jsx("main", { className: "h-full", children: children })] }) })] }));
 }
 export function AppShell({ children }) {
-    return (_jsx(AgentEventsProvider, { children: _jsx(AppShellInner, { children: children }) }));
+    return (_jsx(AgentEventsProvider, { children: _jsx(SidebarFeaturesProvider, { children: _jsx(AppShellInner, { children: children }) }) }));
 }

package/dist/src/presentation/web/components/layouts/app-sidebar/app-sidebar.d.ts

@@ -1,5 +1,6 @@
 import type { FeatureStatus } from '../../common/feature-status-config.js';
-interface FeatureItem {
+export interface FeatureItem {
+    featureId: string;
     name: string;
     status: FeatureStatus;
     startedAt?: number;
@@ -8,10 +9,9 @@ interface FeatureItem {
 export interface AppSidebarProps {
     features: FeatureItem[];
     onNewFeature?: () => void;
-    onFeatureClick?: (name: string) => void;
+    onFeatureClick?: (featureId: string) => void;
     onFeaturesFolderClick?: () => void;
     onFeaturesMenuClick?: () => void;
 }
 export declare function AppSidebar({ features, onNewFeature, onFeatureClick, onFeaturesFolderClick, onFeaturesMenuClick, }: AppSidebarProps): import("react/jsx-runtime").JSX.Element;
-export {};
 //# sourceMappingURL=app-sidebar.d.ts.map

package/dist/src/presentation/web/components/layouts/app-sidebar/app-sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-sidebar.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-sidebar/app-sidebar.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAI/E,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;CAClC;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,mBAAmB,GACpB,EAAE,eAAe,2CAuGjB"}
+{"version":3,"file":"app-sidebar.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-sidebar/app-sidebar.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAI/E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;CAClC;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,mBAAmB,GACpB,EAAE,eAAe,2CAyGjB"}

package/dist/src/presentation/web/components/layouts/app-sidebar/app-sidebar.js

@@ -31,5 +31,5 @@ export function AppSidebar({ features, onNewFeature, onFeatureClick, onFeaturesF
                         'min-w-0 overflow-hidden transition-opacity duration-200 ease-out',
                         '[&_[data-sidebar=group-label]]:!mt-0 [&_[data-sidebar=group-label]]:!opacity-100 [&_[data-sidebar=group-label]]:!transition-none',
                         expandedVisible ? 'opacity-100' : 'opacity-0',
-                    ].join(' '), children: [_jsx(SidebarSectionHeader, { label: "Features", onFolderClick: onFeaturesFolderClick, onMenuClick: onFeaturesMenuClick }), _jsx(ScrollArea, { children: grouped.map(({ key, label, items }) => items.length > 0 ? (_jsx(FeatureStatusGroup, { label: label, count: items.length, children: items.map((feature) => (_jsx(FeatureListItem, { name: feature.name, status: feature.status, startedAt: feature.startedAt, duration: feature.duration, onClick: onFeatureClick ? () => onFeatureClick(feature.name) : undefined }, feature.name))) }, key)) : null) })] })) : null }), _jsx(SidebarFooter, { children: _jsx(SidebarMenu, { children: _jsx(SidebarMenuItem, { children: _jsxs(SidebarMenuButton, { onClick: onNewFeature, tooltip: "New feature", children: [_jsx(Plus, {}), _jsx("span", { children: "New feature" })] }) }) }) }), _jsx(SidebarRail, {})] }));
+                    ].join(' '), children: [_jsx(SidebarSectionHeader, { label: "Features", onFolderClick: onFeaturesFolderClick, onMenuClick: onFeaturesMenuClick }), _jsx(ScrollArea, { children: grouped.map(({ key, label, items }) => items.length > 0 ? (_jsx(FeatureStatusGroup, { label: label, count: items.length, children: items.map((feature) => (_jsx(FeatureListItem, { name: feature.name, status: feature.status, startedAt: feature.startedAt, duration: feature.duration, onClick: onFeatureClick ? () => onFeatureClick(feature.featureId) : undefined }, feature.featureId))) }, key)) : null) })] })) : null }), _jsx(SidebarFooter, { children: _jsx(SidebarMenu, { children: _jsx(SidebarMenuItem, { children: _jsxs(SidebarMenuButton, { onClick: onNewFeature, tooltip: "New feature", children: [_jsx(Plus, {}), _jsx("span", { children: "New feature" })] }) }) }) }), _jsx(SidebarRail, {})] }));
 }

package/dist/src/presentation/web/components/layouts/app-sidebar/app-sidebar.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-sidebar.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-sidebar/app-sidebar.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAsBjC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAWnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAOvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAInB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAO3B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC"}
+{"version":3,"file":"app-sidebar.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-sidebar/app-sidebar.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAsBjC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AA0BnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAOvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAInB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAiB3B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC"}

package/dist/src/presentation/web/components/layouts/app-sidebar/app-sidebar.stories.js

@@ -17,12 +17,27 @@ const meta = {
 };
 export default meta;
 const mockFeatures = [
-    { name: 'Auth Module', status: 'action-needed' },
-    { name: 'Payment Flow', status: 'action-needed' },
-    { name: 'Dashboard', status: 'in-progress', startedAt: Date.now() - 330_000 },
-    { name: 'API Gateway', status: 'in-progress', startedAt: Date.now() - 60_000 },
-    { name: 'Settings Page', status: 'done', duration: '2h' },
-    { name: 'User Profile', status: 'done', duration: '1h' },
+    { featureId: 'feat-auth-001', name: 'Auth Module', status: 'action-needed' },
+    { featureId: 'feat-payment-002', name: 'Payment Flow', status: 'action-needed' },
+    {
+        featureId: 'feat-dashboard-003',
+        name: 'Dashboard',
+        status: 'in-progress',
+        startedAt: Date.now() - 330_000,
+    },
+    {
+        featureId: 'feat-api-004',
+        name: 'API Gateway',
+        status: 'in-progress',
+        startedAt: Date.now() - 60_000,
+    },
+    {
+        featureId: 'feat-settings-005',
+        name: 'Settings Page',
+        status: 'done',
+        duration: '2h',
+    },
+    { featureId: 'feat-profile-006', name: 'User Profile', status: 'done', duration: '1h' },
 ];
 export const Default = {
     args: {
@@ -45,17 +60,27 @@ export const Empty = {
 export const AllInProgress = {
     args: {
         features: [
-            { name: 'Feature A', status: 'in-progress', startedAt: Date.now() - 120_000 },
-            { name: 'Feature B', status: 'in-progress', startedAt: Date.now() - 600_000 },
+            {
+                featureId: 'feat-a-001',
+                name: 'Feature A',
+                status: 'in-progress',
+                startedAt: Date.now() - 120_000,
+            },
+            {
+                featureId: 'feat-b-002',
+                name: 'Feature B',
+                status: 'in-progress',
+                startedAt: Date.now() - 600_000,
+            },
         ],
     },
 };
 export const AllDone = {
     args: {
         features: [
-            { name: 'Feature A', status: 'done', duration: '30m' },
-            { name: 'Feature B', status: 'done', duration: '1h' },
-            { name: 'Feature C', status: 'done', duration: '3h' },
+            { featureId: 'feat-a-001', name: 'Feature A', status: 'done', duration: '30m' },
+            { featureId: 'feat-b-002', name: 'Feature B', status: 'done', duration: '1h' },
+            { featureId: 'feat-c-003', name: 'Feature C', status: 'done', duration: '3h' },
         ],
     },
 };

package/dist/src/presentation/web/hooks/sidebar-features-context.d.ts

@@ -0,0 +1,26 @@
+import { type ReactNode } from 'react';
+import type { FeatureNodeState } from '../components/common/feature-node/feature-node-state-config.js';
+import type { FeatureStatus } from '../components/common/feature-status-config.js';
+export interface SidebarFeatureItem {
+    name: string;
+    status: FeatureStatus;
+    featureId: string;
+    startedAt?: number;
+    duration?: string;
+}
+/**
+ * Maps a canvas FeatureNodeState to the sidebar's 3-state FeatureStatus.
+ * Returns `null` for `creating` (optimistic UI) — these should be excluded from the sidebar.
+ */
+export declare function mapNodeStateToSidebarStatus(state: FeatureNodeState): FeatureStatus | null;
+interface SidebarFeaturesContextValue {
+    features: SidebarFeatureItem[];
+    setFeatures: (features: SidebarFeatureItem[]) => void;
+}
+interface SidebarFeaturesProviderProps {
+    children: ReactNode;
+}
+export declare function SidebarFeaturesProvider({ children }: SidebarFeaturesProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useSidebarFeaturesContext(): SidebarFeaturesContextValue;
+export {};
+//# sourceMappingURL=sidebar-features-context.d.ts.map

package/dist/src/presentation/web/hooks/sidebar-features-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-features-context.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/sidebar-features-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAI/E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAEzF;AAMD,UAAU,2BAA2B;IACnC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,WAAW,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;CACvD;AAID,UAAU,4BAA4B;IACpC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,EAAE,4BAA4B,2CAQjF;AAED,wBAAgB,yBAAyB,IAAI,2BAA2B,CAMvE"}