@shepai/cli 1.25.0 → 1.27.0

package/dist/packages/core/src/infrastructure/services/notifications/notification.service.js

@@ -0,0 +1,43 @@
+/**
+ * Notification Service
+ *
+ * Implements INotificationService port interface. Fans out notification
+ * events to enabled channels:
+ * - Notification bus (for SSE → in-app toasts and browser notifications)
+ * - Desktop notifier (node-notifier for OS-level notifications)
+ *
+ * Channel enable/disable and event type filters are read from Settings.
+ */
+import { NotificationEventType } from '../../../domain/generated/output.js';
+import { getSettings } from '../settings.service.js';
+const EVENT_TYPE_TO_CONFIG_KEY = {
+    [NotificationEventType.AgentStarted]: 'agentStarted',
+    [NotificationEventType.PhaseCompleted]: 'phaseCompleted',
+    [NotificationEventType.WaitingApproval]: 'waitingApproval',
+    [NotificationEventType.AgentCompleted]: 'agentCompleted',
+    [NotificationEventType.AgentFailed]: 'agentFailed',
+};
+export class NotificationService {
+    bus;
+    desktopNotifier;
+    constructor(bus, desktopNotifier) {
+        this.bus = bus;
+        this.desktopNotifier = desktopNotifier;
+    }
+    notify(event) {
+        const { notifications } = getSettings();
+        // Check event type filter
+        const configKey = EVENT_TYPE_TO_CONFIG_KEY[event.eventType];
+        if (configKey && !notifications.events[configKey]) {
+            return;
+        }
+        // Emit to bus if in-app or browser channel is enabled
+        if (notifications.inApp.enabled || notifications.browser.enabled) {
+            this.bus.emit('notification', event);
+        }
+        // Dispatch to desktop notifier if desktop channel is enabled
+        if (notifications.desktop.enabled) {
+            this.desktopNotifier.send(event.featureName, event.message);
+        }
+    }
+}

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/cli/commands/ui.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/ui.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAiB1D;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CA0DzC"}
+{"version":3,"file":"ui.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/ui.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAwB1D;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAkEzC"}

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

@@ -19,6 +19,7 @@ import { findAvailablePort, DEFAULT_PORT } from '../../../../packages/core/src/i
 import { container } from '../../../../packages/core/src/infrastructure/di/container.js';
 import { setVersionEnvVars } from '../../../../packages/core/src/infrastructure/services/version.service.js';
 import { resolveWebDir } from '../../../../packages/core/src/infrastructure/services/web-server.service.js';
+import { initializeNotificationWatcher, getNotificationWatcher, } from '../../../../packages/core/src/infrastructure/services/notifications/notification-watcher.service.js';
 import { colors, fmt, messages } from '../ui/index.js';
 function parsePort(value) {
     const port = parseInt(value, 10);
@@ -52,6 +53,12 @@ Examples:
             messages.newline();
             const service = container.resolve('IWebServerService');
             await service.start(port, dir, dev);
+            // Start notification watcher to detect agent status transitions
+            const runRepo = container.resolve('IAgentRunRepository');
+            const phaseTimingRepo = container.resolve('IPhaseTimingRepository');
+            const notificationService = container.resolve('INotificationService');
+            initializeNotificationWatcher(runRepo, phaseTimingRepo, notificationService);
+            getNotificationWatcher().start();
             messages.success(`Server ready at ${fmt.code(`http://localhost:${port}`)}`);
             messages.info('Press Ctrl+C to stop');
             messages.newline();
@@ -67,6 +74,7 @@ Examples:
                 // Force exit after 5s if graceful shutdown stalls
                 const forceExit = setTimeout(() => process.exit(0), 5000);
                 forceExit.unref();
+                getNotificationWatcher().stop();
                 await service.stop();
                 process.exit(0);
             };

package/dist/src/presentation/web/app/api/agent-events/route.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SSE API Route: GET /api/agent-events
+ *
+ * Streams agent lifecycle notification events to connected web UI clients
+ * via Server-Sent Events (SSE). This is the first API route in the web UI.
+ *
+ * - Subscribes to the notification event bus (shared in-process singleton)
+ * - Formats events as SSE data frames (event: notification\ndata: JSON\n\n)
+ * - Sends heartbeat comments every 30 seconds to keep connection alive
+ * - Supports optional ?runId query parameter to filter events
+ * - Cleans up listeners and intervals on client disconnect
+ */
+export declare function GET(request: Request): Response;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/agent-events/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/app/api/agent-events/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA+D9C"}

package/dist/src/presentation/web/app/api/agent-events/route.js

@@ -0,0 +1,77 @@
+/**
+ * SSE API Route: GET /api/agent-events
+ *
+ * Streams agent lifecycle notification events to connected web UI clients
+ * via Server-Sent Events (SSE). This is the first API route in the web UI.
+ *
+ * - Subscribes to the notification event bus (shared in-process singleton)
+ * - Formats events as SSE data frames (event: notification\ndata: JSON\n\n)
+ * - Sends heartbeat comments every 30 seconds to keep connection alive
+ * - Supports optional ?runId query parameter to filter events
+ * - Cleans up listeners and intervals on client disconnect
+ */
+import { getNotificationBus, hasNotificationBus, } from '../../../../../../packages/core/src/infrastructure/services/notifications/notification-bus.js';
+const HEARTBEAT_INTERVAL_MS = 30_000;
+function formatSSEEvent(event) {
+    return `event: notification\ndata: ${JSON.stringify(event)}\n\n`;
+}
+function formatHeartbeat() {
+    return ': heartbeat\n\n';
+}
+export function GET(request) {
+    const url = new URL(request.url);
+    const runIdFilter = url.searchParams.get('runId');
+    const stream = new ReadableStream({
+        start(controller) {
+            const encoder = new TextEncoder();
+            // Check if bus is available
+            if (!hasNotificationBus()) {
+                controller.close();
+                return;
+            }
+            const bus = getNotificationBus();
+            // Notification event listener
+            const onNotification = (event) => {
+                // Apply runId filter if set
+                if (runIdFilter && event.agentRunId !== runIdFilter) {
+                    return;
+                }
+                try {
+                    controller.enqueue(encoder.encode(formatSSEEvent(event)));
+                }
+                catch {
+                    // Stream may be closed — ignore enqueue errors
+                }
+            };
+            bus.on('notification', onNotification);
+            // Heartbeat to keep connection alive
+            const heartbeatInterval = setInterval(() => {
+                try {
+                    controller.enqueue(encoder.encode(formatHeartbeat()));
+                }
+                catch {
+                    // Stream may be closed — ignore enqueue errors
+                }
+            }, HEARTBEAT_INTERVAL_MS);
+            // Cleanup on client disconnect
+            const cleanup = () => {
+                bus.removeListener('notification', onNotification);
+                clearInterval(heartbeatInterval);
+                try {
+                    controller.close();
+                }
+                catch {
+                    // Stream may already be closed
+                }
+            };
+            request.signal.addEventListener('abort', cleanup, { once: true });
+        },
+    });
+    return new Response(stream, {
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+        },
+    });
+}

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

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

@@ -0,0 +1,51 @@
+import { NextResponse } from 'next/server';
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { getSettings } from '../../../../../../../packages/core/src/infrastructure/services/settings.service.js';
+import { computeWorktreePath } from '../../../../../../../packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.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;
+    try {
+        const settings = getSettings();
+        const shell = settings.environment.shellPreference;
+        const worktreePath = computeWorktreePath(repositoryPath, branch);
+        if (!existsSync(worktreePath)) {
+            return NextResponse.json({ error: `Worktree path does not exist: ${worktreePath}` }, { status: 404 });
+        }
+        const platform = process.platform;
+        if (platform === 'darwin') {
+            const child = spawn('open', ['-a', 'Terminal', worktreePath], {
+                detached: true,
+                stdio: 'ignore',
+            });
+            child.unref();
+        }
+        else if (platform === 'linux') {
+            const child = spawn('x-terminal-emulator', [`--working-directory=${worktreePath}`], {
+                detached: true,
+                stdio: 'ignore',
+            });
+            child.unref();
+        }
+        else {
+            return NextResponse.json({
+                error: `Unsupported platform: ${platform}. Shell launch is supported on macOS and Linux only.`,
+            }, { status: 501 });
+        }
+        return NextResponse.json({
+            success: true,
+            path: worktreePath,
+            shell,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to open shell';
+        return NextResponse.json({ error: message }, { status: 500 });
+    }
+}

package/dist/src/presentation/web/app/api/validate-toolbar-input.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared input validation for feature toolbar API routes.
+ *
+ * Validates that repositoryPath is a non-empty absolute path and branch is a
+ * non-empty string without path traversal sequences or null bytes.
+ */
+interface ValidInput {
+    repositoryPath: string;
+    branch: string;
+}
+interface ValidationError {
+    error: string;
+    status: number;
+}
+export declare function validateToolbarInput(body: Record<string, unknown>): ValidInput | ValidationError;
+export {};
+//# sourceMappingURL=validate-toolbar-input.d.ts.map

package/dist/src/presentation/web/app/api/validate-toolbar-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-toolbar-input.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/api/validate-toolbar-input.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU,UAAU;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,GAAG,eAAe,CAwBhG"}

package/dist/src/presentation/web/app/api/validate-toolbar-input.js

@@ -0,0 +1,25 @@
+/**
+ * Shared input validation for feature toolbar API routes.
+ *
+ * Validates that repositoryPath is a non-empty absolute path and branch is a
+ * non-empty string without path traversal sequences or null bytes.
+ */
+export function validateToolbarInput(body) {
+    const { repositoryPath, branch } = body;
+    if (typeof repositoryPath !== 'string' || repositoryPath.length === 0) {
+        return { error: 'repositoryPath is required and must be a non-empty string', status: 400 };
+    }
+    if (!repositoryPath.startsWith('/')) {
+        return { error: 'repositoryPath must be an absolute path (starting with /)', status: 400 };
+    }
+    if (typeof branch !== 'string' || branch.length === 0) {
+        return { error: 'branch is required and must be a non-empty string', status: 400 };
+    }
+    if (branch.includes('..')) {
+        return { error: 'branch must not contain path traversal sequences (..)', status: 400 };
+    }
+    if (branch.includes('\0')) {
+        return { error: 'branch must not contain null bytes', status: 400 };
+    }
+    return { repositoryPath, branch };
+}

package/dist/src/presentation/web/app/page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/app/page.tsx"],"names":[],"mappings":"AAQA,6EAA6E;AAC7E,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAqBvC,wBAA8B,QAAQ,qDAoFrC"}
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/app/page.tsx"],"names":[],"mappings":"AAWA,6EAA6E;AAC7E,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAqBvC,wBAA8B,QAAQ,qDAmFrC"}

package/dist/src/presentation/web/app/page.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ControlCenter } from '../components/features/control-center/index.js';
 import { getAgentRun, getFeatures } from '../../../../packages/core/src/infrastructure/di/use-cases-bridge.js';
-import { deriveState } from './derive-state.js';
+import { deriveNodeState, deriveProgress, } from '../components/common/feature-node/derive-feature-state.js';
 import { layoutWithDagre } from '../lib/layout-with-dagre.js';
 /** Force request-time rendering so the globalThis DI bridge is available. */
 export const dynamic = 'force-dynamic';
@@ -26,12 +26,7 @@ export default async function HomePage() {
     const features = await getFeatures();
     const featuresWithRuns = await Promise.all(features.map(async (feature) => {
         const run = feature.agentRunId ? await getAgentRun(feature.agentRunId) : null;
-        return {
-            feature,
-            agentStatus: run?.status,
-            agentError: run?.error,
-            agentResult: run?.result,
-        };
+        return { feature, run };
     }));
     // Group features by repository path
     const featuresByRepo = {};
@@ -53,9 +48,9 @@ export default async function HomePage() {
             position: { x: 0, y: 0 },
             data: { name: repoName },
         });
-        repoFeatures.forEach(({ feature, agentStatus, agentError, agentResult }) => {
-            const agentNode = agentResult?.startsWith('node:') ? agentResult.slice(5) : undefined;
-            const lifecycle = agentStatus === 'completed'
+        repoFeatures.forEach(({ feature, run }) => {
+            const agentNode = run?.result?.startsWith('node:') ? run.result.slice(5) : undefined;
+            const lifecycle = run?.status === 'completed'
                 ? 'maintain'
                 : ((agentNode ? nodeToLifecyclePhase[agentNode] : undefined) ??
                     lifecycleMap[feature.lifecycle] ??
@@ -65,8 +60,12 @@ export default async function HomePage() {
                 description: feature.description ?? feature.slug,
                 featureId: feature.id,
                 lifecycle,
-                ...deriveState(lifecycle, agentStatus),
-                ...(agentError && { errorMessage: agentError }),
+                repositoryPath: feature.repositoryPath,
+                branch: feature.branch,
+                state: deriveNodeState(feature, run),
+                progress: deriveProgress(feature),
+                ...(run?.agentType && { agentType: run.agentType }),
+                ...(run?.error && { errorMessage: run.error }),
             };
             const featureNodeId = `feat-${feature.id}`;
             nodes.push({

package/dist/src/presentation/web/components/common/feature-drawer/feature-drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-drawer.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/feature-drawer/feature-drawer.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,kBAAkB,2CAmE1E"}
+{"version":3,"file":"feature-drawer.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/feature-drawer/feature-drawer.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,kBAAkB,2CA2E1E"}