@shepai/cli 1.23.1 → 1.24.0

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

@@ -0,0 +1,20 @@
+/**
+ * Use Cases Bridge — Writer
+ *
+ * Resolves use cases from the DI container and places them on globalThis
+ * so the Next.js web layer can access them without importing DI infrastructure.
+ * Called by CLI bootstrap and dev-server after initializeContainer() completes.
+ *
+ * This file imports tsyringe and decorated use case classes — only import it
+ * from Node.js entry points, never from the Next.js web layer (Turbopack
+ * cannot bundle native addons or decorator metadata).
+ *
+ * @see use-cases-bridge.ts for the reader side (web-safe).
+ */
+import type { DependencyContainer } from 'tsyringe';
+/**
+ * Populate the globalThis bridge with resolved use cases from the DI container.
+ * Must be called after `initializeContainer()` completes.
+ */
+export declare function populateUseCasesBridge(c: DependencyContainer): void;
+//# sourceMappingURL=populate-use-cases-bridge.d.ts.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * Use Cases Bridge — Writer
+ *
+ * Resolves use cases from the DI container and places them on globalThis
+ * so the Next.js web layer can access them without importing DI infrastructure.
+ * Called by CLI bootstrap and dev-server after initializeContainer() completes.
+ *
+ * This file imports tsyringe and decorated use case classes — only import it
+ * from Node.js entry points, never from the Next.js web layer (Turbopack
+ * cannot bundle native addons or decorator metadata).
+ *
+ * @see use-cases-bridge.ts for the reader side (web-safe).
+ */
+import { ListFeaturesUseCase } from '../../application/use-cases/features/list-features.use-case.js';
+import { SHEP_USE_CASES_KEY } from './use-cases-bridge.js';
+/**
+ * Populate the globalThis bridge with resolved use cases from the DI container.
+ * Must be called after `initializeContainer()` completes.
+ */
+export function populateUseCasesBridge(c) {
+    const bridge = {
+        listFeatures: c.resolve(ListFeaturesUseCase),
+        agentRunRepo: c.resolve('IAgentRunRepository'),
+    };
+    globalThis[SHEP_USE_CASES_KEY] = bridge;
+    process[SHEP_USE_CASES_KEY] = bridge;
+}

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

@@ -0,0 +1,34 @@
+/**
+ * Use Cases Bridge — Reader
+ *
+ * Why does this exist?
+ * Use cases (e.g. ListFeaturesUseCase) are DI-managed classes that depend on
+ * injected repositories, which in turn need a live SQLite connection. The web
+ * layer (Next.js / Turbopack) cannot run the DI container because it would
+ * pull in tsyringe, reflect-metadata, and better-sqlite3 (native C++ addon) —
+ * none of which Turbopack can bundle.
+ *
+ * How it works:
+ * 1. CLI bootstrap runs initializeContainer() and resolves fully-wired use cases.
+ * 2. The writer (populate-use-cases-bridge.ts) places those instances on globalThis.
+ * 3. This reader retrieves them — no DI, no native modules, no decorators.
+ *
+ * This file is safe to import from the Next.js web layer.
+ */
+import type { Feature, AgentRun } from '../../domain/generated/output.js';
+import type { FeatureListFilters } from '../../application/ports/output/repositories/feature-repository.interface.js';
+export type { FeatureListFilters };
+/** The globalThis key shared between writer and reader. */
+export declare const SHEP_USE_CASES_KEY = "__shepUseCases";
+/**
+ * List all features for the control center.
+ * Returns an empty array if the DI bridge is not initialized
+ * (e.g. during static builds or when running outside the CLI process).
+ */
+export declare function getFeatures(filters?: FeatureListFilters): Promise<Feature[]>;
+/**
+ * Find an agent run by ID.
+ * Returns null if the DI bridge is not initialized or the run is not found.
+ */
+export declare function getAgentRun(id: string): Promise<AgentRun | null>;
+//# sourceMappingURL=use-cases-bridge.d.ts.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * Use Cases Bridge — Reader
+ *
+ * Why does this exist?
+ * Use cases (e.g. ListFeaturesUseCase) are DI-managed classes that depend on
+ * injected repositories, which in turn need a live SQLite connection. The web
+ * layer (Next.js / Turbopack) cannot run the DI container because it would
+ * pull in tsyringe, reflect-metadata, and better-sqlite3 (native C++ addon) —
+ * none of which Turbopack can bundle.
+ *
+ * How it works:
+ * 1. CLI bootstrap runs initializeContainer() and resolves fully-wired use cases.
+ * 2. The writer (populate-use-cases-bridge.ts) places those instances on globalThis.
+ * 3. This reader retrieves them — no DI, no native modules, no decorators.
+ *
+ * This file is safe to import from the Next.js web layer.
+ */
+/** The globalThis key shared between writer and reader. */
+export const SHEP_USE_CASES_KEY = '__shepUseCases';
+function isShepUseCases(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const maybe = value;
+    const listFeatures = maybe.listFeatures;
+    const agentRunRepo = maybe.agentRunRepo;
+    return (!!listFeatures &&
+        typeof listFeatures.execute === 'function' &&
+        !!agentRunRepo &&
+        typeof agentRunRepo.findById === 'function');
+}
+function getUseCases() {
+    const globalBridge = globalThis[SHEP_USE_CASES_KEY];
+    if (isShepUseCases(globalBridge))
+        return globalBridge;
+    const processBridge = process[SHEP_USE_CASES_KEY];
+    if (isShepUseCases(processBridge))
+        return processBridge;
+    return undefined;
+}
+/**
+ * List all features for the control center.
+ * Returns an empty array if the DI bridge is not initialized
+ * (e.g. during static builds or when running outside the CLI process).
+ */
+export async function getFeatures(filters) {
+    const useCases = getUseCases();
+    if (!useCases?.listFeatures)
+        return [];
+    try {
+        return await useCases.listFeatures.execute(filters);
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console
+        console.error('Failed to load features:', error);
+        return [];
+    }
+}
+/**
+ * Find an agent run by ID.
+ * Returns null if the DI bridge is not initialized or the run is not found.
+ */
+export async function getAgentRun(id) {
+    const useCases = getUseCases();
+    if (!useCases?.agentRunRepo)
+        return null;
+    try {
+        return await useCases.agentRunRepo.findById(id);
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -24,5 +24,7 @@ export declare class WorktreeService implements IWorktreeService {
     getWorktreePath(repoPath: string, branch: string): string;
     private parseWorktreeOutput;
     private parseGitError;
+    private arePathsEquivalent;
+    private normalizeWorktreePath;
 }
 //# sourceMappingURL=worktree.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"worktree.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/worktree.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,0EAA0E,CAAC;AAOlF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEjD,qBACa,eAAgB,YAAW,gBAAgB;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqBrF,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO/C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAMzD,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,aAAa;CA+BtB"}
+{"version":3,"file":"worktree.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/worktree.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,0EAA0E,CAAC;AAOlF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEjD,qBACa,eAAgB,YAAW,gBAAgB;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqBrF,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO/C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAMzD,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/packages/core/src/infrastructure/services/git/worktree.service.js

@@ -38,7 +38,7 @@ let WorktreeService = class WorktreeService {
         }
         // Get info about the created worktree
         const worktrees = await this.list(repoPath);
-        const created = worktrees.find((w) => w.path === worktreePath);
+        const created = worktrees.find((w) => this.arePathsEquivalent(w.path, worktreePath));
         if (!created) {
             throw new WorktreeError('Worktree created but not found in list', WorktreeErrorCode.GIT_ERROR);
         }
@@ -103,6 +103,17 @@ let WorktreeService = class WorktreeService {
         }
         return new WorktreeError(message, WorktreeErrorCode.GIT_ERROR, error instanceof Error ? error : undefined);
     }
+    arePathsEquivalent(a, b) {
+        return this.normalizeWorktreePath(a) === this.normalizeWorktreePath(b);
+    }
+    normalizeWorktreePath(input) {
+        const normalized = path.normalize(input).replace(/\/+$/, '');
+        // On macOS, git can report /private/var/... while callers use /var/...
+        if (process.platform === 'darwin' && normalized.startsWith('/private/var/')) {
+            return normalized.slice('/private'.length);
+        }
+        return normalized;
+    }
 };
 WorktreeService = __decorate([
     injectable(),

package/dist/packages/core/src/infrastructure/services/web-server.service.d.ts

@@ -44,6 +44,7 @@ export declare class WebServerService implements IWebServerService {
     start(port: number, dir: string, dev?: boolean): Promise<void>;
     /**
      * Gracefully stop the server.
+     * Destroys active connections to avoid hanging on keep-alive sockets.
      */
     stop(): Promise<void>;
 }

package/dist/packages/core/src/infrastructure/services/web-server.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-server.service.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/services/web-server.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yEAAyE,CAAC;AAIjH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,IAAI,CAAC,YAAY,CAAC;CAC5C;AAOD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAsB7D;AAED,qBACa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,IAAI,GAAE,OAAO,CAAC,aAAa,CAAM;IAI7C;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB5B"}
+{"version":3,"file":"web-server.service.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/services/web-server.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yEAAyE,CAAC;AAIjH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,IAAI,CAAC,YAAY,CAAC;CAC5C;AAOD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAsB7D;AAED,qBACa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,IAAI,GAAE,OAAO,CAAC,aAAa,CAAM;IAI7C;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjE;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB5B"}

package/dist/packages/core/src/infrastructure/services/web-server.service.js

@@ -92,6 +92,7 @@ let WebServerService = class WebServerService {
     }
     /**
      * Gracefully stop the server.
+     * Destroys active connections to avoid hanging on keep-alive sockets.
      */
     async stop() {
         if (this.isShuttingDown)
@@ -99,6 +100,9 @@ let WebServerService = class WebServerService {
         this.isShuttingDown = true;
         try {
             if (this.server) {
+                // Destroy all active connections so server.close() resolves immediately
+                // Without this, HTTP keep-alive connections keep the server hanging
+                this.server.closeAllConnections();
                 await new Promise((resolve) => {
                     this.server.close(() => resolve());
                 });

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,CAkH3C"}
+{"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"}

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

@@ -103,24 +103,38 @@ export function createShowCommand() {
                     content: last5,
                 });
             }
+            /**
+             * Helper function to render a single phase timing bar.
+             * Handles three states: completed (green bar), waiting (yellow text), running (blue bar).
+             */
+            const renderPhaseTimingBar = (timing, maxDurationMs, isWaiting, MAX_BAR) => {
+                const label = (NODE_TO_PHASE[timing.phase] ?? timing.phase).padEnd(16);
+                // Completed phase - green bar with duration
+                if (timing.completedAt && timing.durationMs != null) {
+                    const ms = Number(timing.durationMs);
+                    const secs = (ms / 1000).toFixed(1);
+                    const barLen = maxDurationMs > 0 ? Math.max(1, Math.round((ms / maxDurationMs) * MAX_BAR)) : 1;
+                    const bar = `${colors.success('█'.repeat(barLen))}${colors.muted('░'.repeat(MAX_BAR - barLen))}`;
+                    return `${label} ${bar} ${secs}s`;
+                }
+                // Waiting for approval - yellow warning text
+                if (isWaiting) {
+                    return `${label} ${colors.warning('awaiting review')}`;
+                }
+                // Running phase - blue bar with elapsed time
+                const elapsedMs = Math.max(0, Date.now() - timing.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('█'.repeat(barLen))}${colors.muted('░'.repeat(MAX_BAR - barLen))}`;
+                return `${label} ${bar} ${secs}s (running)`;
+            };
             if (timings.length > 0) {
                 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) => {
-                    const label = (NODE_TO_PHASE[t.phase] ?? t.phase).padEnd(16);
-                    if (t.completedAt && t.durationMs != null) {
-                        const ms = Number(t.durationMs);
-                        const secs = (ms / 1000).toFixed(1);
-                        const barLen = maxDurationMs > 0 ? Math.max(1, Math.round((ms / maxDurationMs) * MAX_BAR)) : 1;
-                        const bar = `${colors.success('█'.repeat(barLen))}${colors.muted('░'.repeat(MAX_BAR - barLen))}`;
-                        return `${label} ${bar} ${secs}s`;
-                    }
-                    if (isWaiting) {
-                        return `${label} ${colors.warning('awaiting review')}`;
-                    }
-                    return `${label} ${colors.info('running...')}`;
-                });
+                const lines = timings.map((t) => renderPhaseTimingBar(t, maxDurationMs, isWaiting, MAX_BAR));
                 textBlocks.push({ title: 'Phase Timing', content: lines.join('\n') });
             }
             if (run?.status === 'waiting_approval') {

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,CAqDzC"}
+{"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"}

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

@@ -64,6 +64,9 @@ Examples:
                 isShuttingDown = true;
                 messages.newline();
                 messages.info('Shutting down...');
+                // Force exit after 5s if graceful shutdown stalls
+                const forceExit = setTimeout(() => process.exit(0), 5000);
+                forceExit.unref();
                 await service.stop();
                 process.exit(0);
             };

package/dist/src/presentation/cli/commands/upgrade.command.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Upgrade Command
+ *
+ * Self-upgrades Shep CLI to the latest published version.
+ * Checks current vs latest version before running npm install.
+ *
+ * Usage: shep upgrade
+ */
+import { Command } from 'commander';
+import { spawn as defaultSpawn } from 'node:child_process';
+type SpawnFn = typeof defaultSpawn;
+/**
+ * Create the upgrade command
+ */
+export declare function createUpgradeCommand(spawnFn?: SpawnFn): Command;
+export {};
+//# sourceMappingURL=upgrade.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/upgrade.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAK9E,KAAK,OAAO,GAAG,OAAO,YAAY,CAAC;AAyEnC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAsB,GAAG,OAAO,CAuC7E"}

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

@@ -0,0 +1,115 @@
+/**
+ * Upgrade Command
+ *
+ * Self-upgrades Shep CLI to the latest published version.
+ * Checks current vs latest version before running npm install.
+ *
+ * Usage: shep upgrade
+ */
+import { Command } from 'commander';
+import { spawn as defaultSpawn } from 'node:child_process';
+import { container } from '../../../../packages/core/src/infrastructure/di/container.js';
+import { messages } from '../ui/index.js';
+const VERSION_CHECK_TIMEOUT_MS = 10_000;
+/**
+ * Get the latest published version of @shepai/cli from npm registry.
+ * Returns null if the check fails (fail-open).
+ */
+function getLatestVersion(spawnFn) {
+    return new Promise((resolve) => {
+        let output = '';
+        let settled = false;
+        const child = spawnFn('npm', ['view', '@shepai/cli', 'version'], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const timeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                child.kill();
+                messages.warning('Could not complete version check (timed out)');
+                resolve(null);
+            }
+        }, VERSION_CHECK_TIMEOUT_MS);
+        child.stdout?.on('data', (data) => {
+            output += data.toString();
+        });
+        child.on('close', (code) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                if (code === 0 && output.trim()) {
+                    resolve(output.trim());
+                }
+                else {
+                    resolve(null);
+                }
+            }
+        });
+        child.on('error', () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                messages.warning('Could not complete version check');
+                resolve(null);
+            }
+        });
+    });
+}
+/**
+ * Run npm i -g @shepai/cli@latest with inherited stdio.
+ * Returns the exit code, or rejects on spawn error.
+ */
+function runNpmInstall(spawnFn) {
+    return new Promise((resolve, reject) => {
+        const child = spawnFn('npm', ['i', '-g', '@shepai/cli@latest'], {
+            stdio: 'inherit',
+        });
+        child.on('close', (code) => {
+            resolve(code ?? 1);
+        });
+        child.on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+/**
+ * Create the upgrade command
+ */
+export function createUpgradeCommand(spawnFn = defaultSpawn) {
+    return new Command('upgrade')
+        .description('Upgrade Shep CLI to the latest version')
+        .action(async () => {
+        try {
+            const versionService = container.resolve('IVersionService');
+            const { version: currentVersion } = versionService.getVersion();
+            // 1. Check latest version (fail-open with timeout)
+            const latestVersion = await getLatestVersion(spawnFn);
+            // 2. Compare — exit early if up to date
+            if (latestVersion && latestVersion === currentVersion) {
+                messages.success(`Already up to date (v${currentVersion})`);
+                return;
+            }
+            // 3. Show what we're doing
+            if (latestVersion) {
+                messages.info(`Upgrading from v${currentVersion} to v${latestVersion}`);
+            }
+            else {
+                messages.info(`Upgrading from v${currentVersion} to latest`);
+            }
+            // 4. Run npm i -g @shepai/cli@latest with inherited stdio
+            const exitCode = await runNpmInstall(spawnFn);
+            if (exitCode === 0) {
+                messages.success('Shep CLI upgraded successfully');
+            }
+            else {
+                messages.error('Upgrade failed');
+                process.exitCode = 1;
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Upgrade failed', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/index.d.ts

@@ -15,6 +15,7 @@
  *   shep agent        Manage and view agent runs
  *   shep feat         Manage features through the SDLC lifecycle
  *   shep settings     Configure Shep settings
+ *   shep upgrade      Upgrade Shep CLI to the latest version
  *   shep --version    Display version number only
  *
  * Global Options:

package/dist/src/presentation/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,kBAAkB,CAAC"}

package/dist/src/presentation/cli/index.js

@@ -15,6 +15,7 @@
  *   shep agent        Manage and view agent runs
  *   shep feat         Manage features through the SDLC lifecycle
  *   shep settings     Configure Shep settings
+ *   shep upgrade      Upgrade Shep CLI to the latest version
  *   shep --version    Display version number only
  *
  * Global Options:
@@ -32,12 +33,13 @@ import { createAgentCommand } from './commands/agent/index.js';
 import { createFeatCommand } from './commands/feat/index.js';
 import { createIdeOpenCommand } from './commands/ide-open.command.js';
 import { createInstallCommand } from './commands/install.command.js';
+import { createUpgradeCommand } from './commands/upgrade.command.js';
 import { messages } from './ui/index.js';
 // DI container and settings
 import { initializeContainer, container } from '../../../packages/core/src/infrastructure/di/container.js';
 import { InitializeSettingsUseCase } from '../../../packages/core/src/application/use-cases/settings/initialize-settings.use-case.js';
-import { ListFeaturesUseCase } from '../../../packages/core/src/application/use-cases/features/list-features.use-case.js';
 import { initializeSettings } from '../../../packages/core/src/infrastructure/services/settings.service.js';
+import { populateUseCasesBridge } from '../../../packages/core/src/infrastructure/di/populate-use-cases-bridge.js';
 /**
  * Bootstrap function - initializes all dependencies before CLI starts.
  * Performs async initialization (database, settings) before parsing commands.
@@ -64,13 +66,11 @@ async function bootstrap() {
             messages.error('Failed to initialize settings', err);
             throw error;
         }
-        // Step 2b: Expose resolved use cases for the web layer via globalThis bridge
-        // The Next.js web server runs in the same process, so globalThis is shared.
-        // Web layer reads from this instead of importing CLI source (Turbopack incompatibility).
-        globalThis.__shepUseCases = {
-            listFeatures: container.resolve(ListFeaturesUseCase),
-            agentRunRepo: container.resolve('IAgentRunRepository'),
-        };
+        // Expose resolved use cases on globalThis for the web layer.
+        // The Next.js web UI (Turbopack) cannot import @shepai/core at runtime
+        // (ESM .js extensions, native C++ addons, tsyringe decorators), so the
+        // CLI places live instances on globalThis and the web reads them back.
+        populateUseCasesBridge(container);
         // Step 3: Set up Commander CLI
         const versionService = container.resolve('IVersionService');
         const { version, description } = versionService.getVersion();
@@ -90,6 +90,7 @@ async function bootstrap() {
         program.addCommand(createFeatCommand());
         program.addCommand(createIdeOpenCommand());
         program.addCommand(createInstallCommand());
+        program.addCommand(createUpgradeCommand());
         // Parse arguments (parseAsync needed for async command actions like init)
         await program.parseAsync();
     }

package/dist/src/presentation/web/app/layout.d.ts

@@ -1,4 +1,5 @@
 import type { Metadata } from 'next';
+import '@xyflow/react/dist/base.css';
 import './globals.css';
 export declare const metadata: Metadata;
 export default function RootLayout({ children, }: Readonly<{

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

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/app/layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,eAAe,CAAC;AAGvB,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EACjC,QAAQ,GACT,EAAE,QAAQ,CAAC;IACV,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC,2CAyBD"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/app/layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,6BAA6B,CAAC;AACrC,OAAO,eAAe,CAAC;AAGvB,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EACjC,QAAQ,GACT,EAAE,QAAQ,CAAC;IACV,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC,2CAyBD"}

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

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import '@xyflow/react/dist/base.css';
 import './globals.css';
 import { AppShell } from '../components/layouts/app-shell/index.js';
 export const metadata = {

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

@@ -1,2 +1,4 @@
+/** Force request-time rendering so the globalThis DI bridge is available. */
+export declare const dynamic = "force-dynamic";
 export default function HomePage(): Promise<import("react/jsx-runtime").JSX.Element>;
 //# sourceMappingURL=page.d.ts.map

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":"AA2BA,wBAA8B,QAAQ,qDA2ErC"}
+{"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"}

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

@@ -1,8 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ControlCenter } from '../components/features/control-center/index.js';
-import { getFeatures } from '../lib/features.js';
+import { getAgentRun, getFeatures } from '../../../../packages/core/src/infrastructure/di/use-cases-bridge.js';
 import { deriveState } from './derive-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';
 /** Map domain SdlcLifecycle enum values to UI FeatureLifecyclePhase (1:1). */
 const lifecycleMap = {
     Requirements: 'requirements',
@@ -22,14 +24,23 @@ const nodeToLifecyclePhase = {
 };
 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,
+        };
+    }));
     // Group features by repository path
     const featuresByRepo = {};
-    features.forEach((f) => {
-        const repoKey = f.repositoryPath;
+    featuresWithRuns.forEach((entry) => {
+        const repoKey = entry.feature.repositoryPath;
         if (!featuresByRepo[repoKey]) {
             featuresByRepo[repoKey] = [];
         }
-        featuresByRepo[repoKey].push(f);
+        featuresByRepo[repoKey].push(entry);
     });
     const nodes = [];
     const edges = [];
@@ -42,11 +53,9 @@ export default async function HomePage() {
             position: { x: 0, y: 0 },
             data: { name: repoName },
         });
-        repoFeatures.forEach((feature) => {
-            const agentNode = feature.agentResult?.startsWith('node:')
-                ? feature.agentResult.slice(5)
-                : undefined;
-            const lifecycle = feature.agentStatus === 'completed'
+        repoFeatures.forEach(({ feature, agentStatus, agentError, agentResult }) => {
+            const agentNode = agentResult?.startsWith('node:') ? agentResult.slice(5) : undefined;
+            const lifecycle = agentStatus === 'completed'
                 ? 'maintain'
                 : ((agentNode ? nodeToLifecyclePhase[agentNode] : undefined) ??
                     lifecycleMap[feature.lifecycle] ??
@@ -56,8 +65,8 @@ export default async function HomePage() {
                 description: feature.description ?? feature.slug,
                 featureId: feature.id,
                 lifecycle,
-                ...deriveState(lifecycle, feature.agentStatus),
-                ...(feature.agentError && { errorMessage: feature.agentError }),
+                ...deriveState(lifecycle, agentStatus),
+                ...(agentError && { errorMessage: agentError }),
             };
             const featureNodeId = `feat-${feature.id}`;
             nodes.push({

package/dist/src/presentation/web/dev-server.js

@@ -14,8 +14,8 @@ import next from 'next';
 import http from 'node:http';
 import { initializeContainer, container } from '../../../packages/core/src/infrastructure/di/container.js';
 import { InitializeSettingsUseCase } from '../../../packages/core/src/application/use-cases/settings/initialize-settings.use-case.js';
-import { ListFeaturesUseCase } from '../../../packages/core/src/application/use-cases/features/list-features.use-case.js';
 import { initializeSettings } from '../../../packages/core/src/infrastructure/services/settings.service.js';
+import { populateUseCasesBridge } from '../../../packages/core/src/infrastructure/di/populate-use-cases-bridge.js';
 const DEFAULT_PORT = 3000;
 async function main() {
     const port = parseInt(process.env.PORT ?? '', 10) || DEFAULT_PORT;
@@ -26,11 +26,7 @@ async function main() {
         const initSettingsUseCase = container.resolve(InitializeSettingsUseCase);
         const settings = await initSettingsUseCase.execute();
         initializeSettings(settings);
-        // Set globalThis bridge for the web layer (same as CLI bootstrap index.ts:74-76)
-        globalThis.__shepUseCases = {
-            listFeatures: container.resolve(ListFeaturesUseCase),
-            agentRunRepo: container.resolve('IAgentRunRepository'),
-        };
+        populateUseCasesBridge(container);
         console.log('[dev-server] DI bridge initialized');
     }
     catch (error) {