@shepai/cli 1.64.2 → 1.65.0

package/dist/src/presentation/cli/commands/daemon/stop-daemon.d.ts

@@ -0,0 +1,27 @@
+/**
+ * stopDaemon() — Shared daemon-stop helper
+ *
+ * Contains the stop logic for gracefully terminating a running Shep daemon.
+ * Used by:
+ *   - stop.command.ts (shep stop)
+ *   - restart.command.ts (shep restart)
+ *   - upgrade.command.ts (shep upgrade — stops before install)
+ *
+ * Stop sequence:
+ *   1. Read daemon.json via IDaemonService
+ *   2. If no daemon / PID not alive: silently clean up daemon.json and return
+ *   3. Validate PID is a positive finite integer
+ *   4. Send SIGTERM
+ *   5. Poll process liveness every 200ms for up to 5000ms
+ *   6. If still alive after 5s, send SIGKILL (errors suppressed — process may have exited)
+ *   7. Always delete daemon.json (in finally block)
+ *
+ * @param daemonService - IDaemonService instance (injected by caller for testability, NFR-4)
+ */
+import type { IDaemonService } from '../../../../../packages/core/src/application/ports/output/services/daemon-service.interface.js';
+/**
+ * Stop the Shep daemon gracefully.
+ * Safe to call when no daemon is running — silently cleans up stale daemon.json (NFR-2).
+ */
+export declare function stopDaemon(daemonService: IDaemonService): Promise<void>;
+//# sourceMappingURL=stop-daemon.d.ts.map

package/dist/src/presentation/cli/commands/daemon/stop-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-daemon.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/daemon/stop-daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AA0BtG;;;GAGG;AACH,wBAAsB,UAAU,CAAC,aAAa,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC7E"}

package/dist/src/presentation/cli/commands/daemon/stop-daemon.js

@@ -0,0 +1,77 @@
+/**
+ * stopDaemon() — Shared daemon-stop helper
+ *
+ * Contains the stop logic for gracefully terminating a running Shep daemon.
+ * Used by:
+ *   - stop.command.ts (shep stop)
+ *   - restart.command.ts (shep restart)
+ *   - upgrade.command.ts (shep upgrade — stops before install)
+ *
+ * Stop sequence:
+ *   1. Read daemon.json via IDaemonService
+ *   2. If no daemon / PID not alive: silently clean up daemon.json and return
+ *   3. Validate PID is a positive finite integer
+ *   4. Send SIGTERM
+ *   5. Poll process liveness every 200ms for up to 5000ms
+ *   6. If still alive after 5s, send SIGKILL (errors suppressed — process may have exited)
+ *   7. Always delete daemon.json (in finally block)
+ *
+ * @param daemonService - IDaemonService instance (injected by caller for testability, NFR-4)
+ */
+import { messages } from '../../ui/index.js';
+const POLL_INTERVAL_MS = 200;
+const MAX_WAIT_MS = 5000;
+/**
+ * Poll until the given PID is dead or the timeout expires.
+ * Returns true if the process is dead, false if it survived the timeout.
+ */
+async function pollUntilDead(daemonService, pid, maxMs, intervalMs) {
+    const deadline = Date.now() + maxMs;
+    while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        if (!daemonService.isAlive(pid)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Stop the Shep daemon gracefully.
+ * Safe to call when no daemon is running — silently cleans up stale daemon.json (NFR-2).
+ */
+export async function stopDaemon(daemonService) {
+    const state = await daemonService.read();
+    // No daemon running or PID not alive — silently clean up and return
+    if (!state || !daemonService.isAlive(state.pid)) {
+        await daemonService.delete();
+        return;
+    }
+    const { pid } = state;
+    // Validate PID is a positive finite integer before kill
+    if (!Number.isFinite(pid) || !Number.isInteger(pid) || pid <= 0) {
+        await daemonService.delete();
+        return;
+    }
+    try {
+        messages.info(`Stopping Shep daemon (PID ${pid})...`);
+        // Send SIGTERM — request graceful shutdown
+        process.kill(pid, 'SIGTERM');
+        // Poll for up to 5s waiting for the process to exit
+        const died = await pollUntilDead(daemonService, pid, MAX_WAIT_MS, POLL_INTERVAL_MS);
+        if (!died) {
+            // Graceful shutdown timed out — force kill
+            messages.info('Daemon did not stop gracefully, sending SIGKILL...');
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch {
+                // Process may have exited between the check and the kill — ignore
+            }
+        }
+        messages.success('Shep daemon stopped.');
+    }
+    finally {
+        // Always clean up daemon.json regardless of termination path
+        await daemonService.delete();
+    }
+}

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

@@ -0,0 +1,14 @@
+/**
+ * restart Command
+ *
+ * Gracefully restarts the Shep web UI daemon. If the daemon is not running,
+ * starts it instead. Accepts an optional --port flag (parity with shep start).
+ *
+ * Usage: shep restart [--port <number>]
+ */
+import { Command } from 'commander';
+/**
+ * Create the restart command.
+ */
+export declare function createRestartCommand(): Command;
+//# sourceMappingURL=restart.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restart.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/restart.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAe1D;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CA2B9C"}

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

@@ -0,0 +1,47 @@
+/**
+ * restart Command
+ *
+ * Gracefully restarts the Shep web UI daemon. If the daemon is not running,
+ * starts it instead. Accepts an optional --port flag (parity with shep start).
+ *
+ * Usage: shep restart [--port <number>]
+ */
+import { Command, InvalidArgumentError } from 'commander';
+import { container } from '../../../../packages/core/src/infrastructure/di/container.js';
+import { messages } from '../ui/index.js';
+import { stopDaemon } from './daemon/stop-daemon.js';
+import { startDaemon } from './daemon/start-daemon.js';
+function parsePort(value) {
+    const port = parseInt(value, 10);
+    if (isNaN(port) || port < 1024 || port > 65535) {
+        throw new InvalidArgumentError('Port must be an integer between 1024 and 65535');
+    }
+    return port;
+}
+/**
+ * Create the restart command.
+ */
+export function createRestartCommand() {
+    return new Command('restart')
+        .description('Gracefully restart the Shep web UI daemon (starts it if not running)')
+        .option('-p, --port <number>', 'Port number (1024-65535)', parsePort)
+        .addHelpText('after', `
+Examples:
+  $ shep restart               Restart (or start) on default port
+  $ shep restart --port 8080   Restart on custom port`)
+        .action(async (options) => {
+        const daemonService = container.resolve('IDaemonService');
+        const state = await daemonService.read();
+        const isRunning = state !== null && daemonService.isAlive(state.pid);
+        if (isRunning) {
+            // Daemon is running — stop it then start it, preserving the port unless overridden
+            await stopDaemon(daemonService);
+            await startDaemon({ port: options.port ?? state.port });
+        }
+        else {
+            // Daemon is not running — start it directly
+            messages.info('Daemon was not running — starting...');
+            await startDaemon({ port: options.port });
+        }
+    });
+}

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

@@ -2,15 +2,7 @@
  * stop Command
  *
  * Stops the running Shep web UI daemon.
- *
- * Stop sequence:
- *   1. Read daemon.json via IDaemonService
- *   2. If no daemon / PID not alive: print clear message and exit 0
- *   3. Validate PID is a positive finite integer
- *   4. Send SIGTERM
- *   5. Poll process liveness every 200ms for up to 5000ms
- *   6. If still alive after 5s, send SIGKILL
- *   7. Always delete daemon.json (in finally block)
+ * Stop logic is implemented in the shared stopDaemon() helper.
  *
  * Usage: shep stop
  */

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

@@ -1 +1 @@
-{"version":3,"file":"stop.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/stop.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA+C3C"}
+{"version":3,"file":"stop.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/stop.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAc3C"}

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

@@ -2,37 +2,14 @@
  * stop Command
  *
  * Stops the running Shep web UI daemon.
- *
- * Stop sequence:
- *   1. Read daemon.json via IDaemonService
- *   2. If no daemon / PID not alive: print clear message and exit 0
- *   3. Validate PID is a positive finite integer
- *   4. Send SIGTERM
- *   5. Poll process liveness every 200ms for up to 5000ms
- *   6. If still alive after 5s, send SIGKILL
- *   7. Always delete daemon.json (in finally block)
+ * Stop logic is implemented in the shared stopDaemon() helper.
  *
  * Usage: shep stop
  */
 import { Command } from 'commander';
 import { container } from '../../../../packages/core/src/infrastructure/di/container.js';
 import { messages } from '../ui/index.js';
-const POLL_INTERVAL_MS = 200;
-const MAX_WAIT_MS = 5000;
-/**
- * Poll until the given PID is dead or the timeout expires.
- * Returns true if the process is dead, false if it survived the timeout.
- */
-async function pollUntilDead(daemonService, pid, maxMs, intervalMs) {
-    const deadline = Date.now() + maxMs;
-    while (Date.now() < deadline) {
-        await new Promise((resolve) => setTimeout(resolve, intervalMs));
-        if (!daemonService.isAlive(pid)) {
-            return true;
-        }
-    }
-    return false;
-}
+import { stopDaemon } from './daemon/stop-daemon.js';
 /**
  * Create the stop command.
  */
@@ -40,40 +17,11 @@ export function createStopCommand() {
     return new Command('stop').description('Stop the running Shep web UI daemon').action(async () => {
         const daemonService = container.resolve('IDaemonService');
         const state = await daemonService.read();
-        // No daemon running or PID not alive
-        if (!state || !daemonService.isAlive(state.pid)) {
+        // Print a user-facing message when no daemon state is recorded at all.
+        // The alive-but-stale case (state exists, PID dead) is handled silently by stopDaemon.
+        if (!state) {
             messages.info('No Shep daemon is running.');
-            await daemonService.delete();
-            return;
-        }
-        const { pid } = state;
-        // Validate PID is a positive finite integer before kill
-        if (!Number.isFinite(pid) || !Number.isInteger(pid) || pid <= 0) {
-            messages.info('No Shep daemon is running (invalid PID in state file).');
-            await daemonService.delete();
-            return;
-        }
-        try {
-            messages.info(`Stopping Shep daemon (PID ${pid})...`);
-            // Send SIGTERM — request graceful shutdown
-            process.kill(pid, 'SIGTERM');
-            // Poll for up to 5s waiting for the process to exit
-            const died = await pollUntilDead(daemonService, pid, MAX_WAIT_MS, POLL_INTERVAL_MS);
-            if (!died) {
-                // Graceful shutdown timed out — force kill
-                messages.info('Daemon did not stop gracefully, sending SIGKILL...');
-                try {
-                    process.kill(pid, 'SIGKILL');
-                }
-                catch {
-                    // Process may have exited between the check and the kill — ignore
-                }
-            }
-            messages.success('Shep daemon stopped.');
-        }
-        finally {
-            // Always clean up daemon.json regardless of termination path
-            await daemonService.delete();
         }
+        await stopDaemon(daemonService);
     });
 }

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

@@ -1 +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"}
+{"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;AAQ9E,KAAK,OAAO,GAAG,OAAO,YAAY,CAAC;AAyEnC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAsB,GAAG,OAAO,CA+D7E"}

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

@@ -10,6 +10,8 @@ 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';
+import { stopDaemon } from './daemon/stop-daemon.js';
+import { startDaemon } from './daemon/start-daemon.js';
 const VERSION_CHECK_TIMEOUT_MS = 10_000;
 /**
  * Get the latest published version of @shepai/cli from npm registry.
@@ -96,13 +98,37 @@ export function createUpgradeCommand(spawnFn = defaultSpawn) {
             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) {
+            // 4. Check daemon state before install (FR-1)
+            const daemonService = container.resolve('IDaemonService');
+            const daemonState = await daemonService.read();
+            const daemonWasRunning = daemonState !== null && daemonService.isAlive(daemonState.pid);
+            const previousPort = daemonWasRunning ? daemonState.port : undefined;
+            if (daemonWasRunning) {
+                messages.info('Stopping daemon before upgrade...');
+                await stopDaemon(daemonService);
+            }
+            // 5. Run npm i -g @shepai/cli@latest; always restore daemon in finally (FR-2, FR-3)
+            let installExitCode = 1;
+            try {
+                installExitCode = await runNpmInstall(spawnFn);
+            }
+            finally {
+                if (daemonWasRunning) {
+                    messages.info('Restarting daemon...');
+                    await startDaemon({ port: previousPort });
+                    messages.success('Daemon restarted successfully.');
+                }
+            }
+            if (installExitCode === 0) {
                 messages.success('Shep CLI upgraded successfully');
             }
             else {
-                messages.error('Upgrade failed');
+                if (daemonWasRunning) {
+                    messages.error('Upgrade failed — daemon restored on previous version.');
+                }
+                else {
+                    messages.error('Upgrade failed');
+                }
                 process.exitCode = 1;
             }
         }

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

@@ -11,6 +11,7 @@
  *   shep              Start the web UI daemon (or run onboarding on first run)
  *   shep start        Start the web UI as a background daemon
  *   shep stop         Stop the running web UI daemon
+ *   shep restart      Restart (or start) the web UI daemon
  *   shep status       Show status and metrics of the running daemon
  *   shep version      Display version information
  *   shep ui           Start the web UI (foreground, interactive)

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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,kBAAkB,CAAC"}

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

@@ -11,6 +11,7 @@
  *   shep              Start the web UI daemon (or run onboarding on first run)
  *   shep start        Start the web UI as a background daemon
  *   shep stop         Stop the running web UI daemon
+ *   shep restart      Restart (or start) the web UI daemon
  *   shep status       Show status and metrics of the running daemon
  *   shep version      Display version information
  *   shep ui           Start the web UI (foreground, interactive)
@@ -46,6 +47,7 @@ import { messages } from './ui/index.js';
 import { createStartCommand } from './commands/start.command.js';
 import { createStopCommand } from './commands/stop.command.js';
 import { createStatusCommand } from './commands/status.command.js';
+import { createRestartCommand } from './commands/restart.command.js';
 import { createServeCommand } from './commands/_serve.command.js';
 import { startDaemon } from './commands/daemon/start-daemon.js';
 // DI container and settings
@@ -122,6 +124,7 @@ async function bootstrap() {
         // Daemon lifecycle commands (task-9)
         program.addCommand(createStartCommand());
         program.addCommand(createStopCommand());
+        program.addCommand(createRestartCommand());
         program.addCommand(createStatusCommand());
         program.addCommand(createServeCommand()); // hidden from --help
         // Parse arguments (parseAsync needed for async command actions like init)