@shepai/cli 1.170.0 → 1.171.0

package/dist/packages/core/src/application/use-cases/upgrade/upgrade-cli.use-case.d.ts

@@ -24,6 +24,7 @@ export declare class UpgradeCliUseCase {
     constructor(versionService: IVersionService, daemonService: IDaemonService);
     execute(onOutput?: (data: string) => void): Promise<UpgradeResult>;
     private getLatestVersion;
+    private preDownloadPackage;
     /**
      * Schedule a daemon self-restart after upgrade.
      * Reads the current daemon port, spawns a new daemon process with the

package/dist/packages/core/src/application/use-cases/upgrade/upgrade-cli.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade-cli.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/upgrade/upgrade-cli.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AAE9F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,cAAc,EAAE,eAAe,EAE/B,aAAa,EAAE,cAAc;IAG1C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAkCxE,OAAO,CAAC,gBAAgB;IA6CxB;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5C,OAAO,CAAC,aAAa;CAuBtB"}
+{"version":3,"file":"upgrade-cli.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/upgrade/upgrade-cli.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AAE9F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,cAAc,EAAE,eAAe,EAE/B,aAAa,EAAE,cAAc;IAG1C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAyCxE,OAAO,CAAC,gBAAgB;IA6CxB,OAAO,CAAC,kBAAkB;IAwD1B;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5C,OAAO,CAAC,aAAa;CAuBtB"}

package/dist/packages/core/src/application/use-cases/upgrade/upgrade-cli.use-case.js

@@ -24,7 +24,11 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from 'tsyringe';
 import { spawn } from 'node:child_process';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
 const VERSION_CHECK_TIMEOUT_MS = 10_000;
+const NPM_CACHE_ADD_TIMEOUT_MS = 120_000;
 /** Delay (ms) before the current process exits to allow the SSE response to flush. */
 const SELF_RESTART_DELAY_MS = 1_000;
 let UpgradeCliUseCase = class UpgradeCliUseCase {
@@ -43,8 +47,14 @@ let UpgradeCliUseCase = class UpgradeCliUseCase {
             onOutput?.(`Already up to date (v${currentVersion})\n`);
             return { status: 'up-to-date', currentVersion, latestVersion };
         }
-        // 3. Run upgrade
+        // 3. Pre-download the package into npm cache before install
         const target = latestVersion ? `v${latestVersion}` : 'latest';
+        onOutput?.(`Downloading @shepai/cli@latest...\n`);
+        const cached = await this.preDownloadPackage();
+        if (!cached) {
+            onOutput?.('Pre-download did not complete — proceeding with install...\n');
+        }
+        // 4. Run install (fast if cached)
         onOutput?.(`Upgrading from v${currentVersion} to ${target}...\n`);
         try {
             const exitCode = await this.runNpmInstall(onOutput);
@@ -104,6 +114,53 @@ let UpgradeCliUseCase = class UpgradeCliUseCase {
             });
         });
     }
+    preDownloadPackage() {
+        let tmpDir;
+        try {
+            tmpDir = mkdtempSync(join(tmpdir(), 'shep-upgrade-'));
+        }
+        catch {
+            return Promise.resolve(false);
+        }
+        const cleanup = () => {
+            try {
+                rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch {
+                /* best-effort */
+            }
+        };
+        return new Promise((resolve) => {
+            let settled = false;
+            const child = spawn('npm', ['install', '--prefix', tmpDir, '--ignore-scripts', '@shepai/cli@latest'], {
+                stdio: ['ignore', 'ignore', 'pipe'],
+            });
+            const timeout = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    child.kill();
+                    cleanup();
+                    resolve(false);
+                }
+            }, NPM_CACHE_ADD_TIMEOUT_MS);
+            child.on('close', (code) => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    cleanup();
+                    resolve(code === 0);
+                }
+            });
+            child.on('error', () => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    cleanup();
+                    resolve(false);
+                }
+            });
+        });
+    }
     /**
      * Schedule a daemon self-restart after upgrade.
      * Reads the current daemon port, spawns a new daemon process with the
@@ -130,7 +187,7 @@ let UpgradeCliUseCase = class UpgradeCliUseCase {
     }
     runNpmInstall(onOutput) {
         return new Promise((resolve, reject) => {
-            const child = spawn('npm', ['i', '-g', '@shepai/cli@latest'], {
+            const child = spawn('npm', ['i', '-g', '@shepai/cli@latest', '--prefer-offline'], {
                 stdio: ['ignore', 'pipe', 'pipe'],
             });
             child.stdout?.on('data', (data) => {

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;AAS9E,KAAK,OAAO,GAAG,OAAO,YAAY,CAAC;AA8EnC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAsB,GAAG,OAAO,CAqE7E"}
+{"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;AAY9E,KAAK,OAAO,GAAG,OAAO,YAAY,CAAC;AA8InC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAsB,GAAG,OAAO,CA6E7E"}

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

@@ -8,12 +8,16 @@
  */
 import { Command } from 'commander';
 import { spawn as defaultSpawn } from 'node:child_process';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
 import { container } from '../../../../packages/core/src/infrastructure/di/container.js';
 import { messages } from '../ui/index.js';
 import { getCliI18n } from '../i18n.js';
 import { stopDaemon } from './daemon/stop-daemon.js';
 import { startDaemon } from './daemon/start-daemon.js';
 const VERSION_CHECK_TIMEOUT_MS = 10_000;
+const NPM_CACHE_ADD_TIMEOUT_MS = 120_000;
 /** On Windows, npm is a .cmd batch file — spawn() needs shell: true to resolve it. */
 const IS_WINDOWS = process.platform === 'win32';
 /**
@@ -61,13 +65,67 @@ function getLatestVersion(spawnFn) {
         });
     });
 }
+/**
+ * Pre-download the package AND all transitive dependencies into npm's cache.
+ * Uses `npm install --prefix <tmpdir>` which resolves the full dependency tree
+ * and populates the cache. The temp directory is cleaned up afterwards.
+ * Returns true if the pre-download succeeded, false otherwise (fail-open).
+ */
+function preDownloadPackage(spawnFn) {
+    let tmpDir;
+    try {
+        tmpDir = mkdtempSync(join(tmpdir(), 'shep-upgrade-'));
+    }
+    catch {
+        return Promise.resolve(false);
+    }
+    const cleanup = () => {
+        try {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+    };
+    return new Promise((resolve) => {
+        let settled = false;
+        const child = spawnFn('npm', ['install', '--prefix', tmpDir, '--ignore-scripts', '@shepai/cli@latest'], {
+            stdio: ['ignore', 'ignore', 'pipe'],
+            ...(IS_WINDOWS && { shell: true }),
+        });
+        const timeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                child.kill();
+                cleanup();
+                resolve(false);
+            }
+        }, NPM_CACHE_ADD_TIMEOUT_MS);
+        child.on('close', (code) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                cleanup();
+                resolve(code === 0);
+            }
+        });
+        child.on('error', () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                cleanup();
+                resolve(false);
+            }
+        });
+    });
+}
 /**
  * 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'], {
+        const child = spawnFn('npm', ['i', '-g', '@shepai/cli@latest', '--prefer-offline'], {
             stdio: 'inherit',
             ...(IS_WINDOWS && { shell: true }),
         });
@@ -107,7 +165,14 @@ export function createUpgradeCommand(spawnFn = defaultSpawn) {
             else {
                 messages.info(t('cli:commands.upgrade.upgradingToLatest', { current: currentVersion }));
             }
-            // 4. Check daemon state before install (FR-1)
+            // 4. Pre-download the package into npm cache BEFORE stopping the daemon.
+            //    This minimizes downtime — the actual install will read from cache.
+            messages.info(t('cli:commands.upgrade.downloadingPackage'));
+            const cached = await preDownloadPackage(spawnFn);
+            if (!cached) {
+                messages.warning(t('cli:commands.upgrade.downloadFailed'));
+            }
+            // 5. Check daemon state and stop if running
             const daemonService = container.resolve('IDaemonService');
             const daemonState = await daemonService.read();
             const daemonWasRunning = daemonState !== null && daemonService.isAlive(daemonState.pid);
@@ -116,7 +181,7 @@ export function createUpgradeCommand(spawnFn = defaultSpawn) {
                 messages.info(t('cli:commands.upgrade.stoppingDaemon'));
                 await stopDaemon(daemonService);
             }
-            // 5. Run npm i -g @shepai/cli@latest; always restore daemon in finally (FR-2, FR-3)
+            // 6. Run npm i -g @shepai/cli@latest; always restore daemon in finally
             let installExitCode = 1;
             try {
                 installExitCode = await runNpmInstall(spawnFn);

package/dist/translations/ar/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "محدّث بالفعل (v{{version}})",
       "upgradingFromTo": "الترقية من v{{current}} إلى v{{latest}}",
       "upgradingToLatest": "الترقية من v{{current}} إلى الأحدث",
+      "downloadingPackage": "جارٍ تنزيل الإصدار الجديد...",
+      "downloadFailed": "لم يكتمل التنزيل المسبق — المتابعة بالتثبيت",
       "stoppingDaemon": "جارٍ إيقاف الخدمة الخلفية قبل الترقية...",
       "restartingDaemon": "جارٍ إعادة تشغيل الخدمة الخلفية...",
       "daemonRestarted": "تمت إعادة تشغيل الخدمة الخلفية بنجاح.",

package/dist/translations/de/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "Bereits aktuell (v{{version}})",
       "upgradingFromTo": "Aktualisierung von v{{current}} auf v{{latest}}",
       "upgradingToLatest": "Aktualisierung von v{{current}} auf die neueste Version",
+      "downloadingPackage": "Neue Version wird heruntergeladen...",
+      "downloadFailed": "Vorab-Download nicht abgeschlossen — Installation wird fortgesetzt",
       "stoppingDaemon": "Dienst wird vor Aktualisierung gestoppt...",
       "restartingDaemon": "Dienst wird neu gestartet...",
       "daemonRestarted": "Dienst erfolgreich neu gestartet.",

package/dist/translations/en/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "Already up to date (v{{version}})",
       "upgradingFromTo": "Upgrading from v{{current}} to v{{latest}}",
       "upgradingToLatest": "Upgrading from v{{current}} to latest",
+      "downloadingPackage": "Downloading new version...",
+      "downloadFailed": "Pre-download did not complete — proceeding with install",
       "stoppingDaemon": "Stopping daemon before upgrade...",
       "restartingDaemon": "Restarting daemon...",
       "daemonRestarted": "Daemon restarted successfully.",

package/dist/translations/es/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "Ya está actualizado (v{{version}})",
       "upgradingFromTo": "Actualizando de v{{current}} a v{{latest}}",
       "upgradingToLatest": "Actualizando de v{{current}} a la última versión",
+      "downloadingPackage": "Descargando nueva versión...",
+      "downloadFailed": "La descarga previa no se completó — continuando con la instalación",
       "stoppingDaemon": "Deteniendo el demonio antes de actualizar...",
       "restartingDaemon": "Reiniciando el demonio...",
       "daemonRestarted": "Demonio reiniciado exitosamente.",

package/dist/translations/fr/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "Déjà à jour (v{{version}})",
       "upgradingFromTo": "Mise à jour de v{{current}} vers v{{latest}}",
       "upgradingToLatest": "Mise à jour de v{{current}} vers la dernière version",
+      "downloadingPackage": "Téléchargement de la nouvelle version...",
+      "downloadFailed": "Le pré-téléchargement n'a pas abouti — poursuite de l'installation",
       "stoppingDaemon": "Arrêt du démon avant la mise à jour...",
       "restartingDaemon": "Redémarrage du démon...",
       "daemonRestarted": "Démon redémarré avec succès.",

package/dist/translations/he/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "כבר מעודכן (v{{version}})",
       "upgradingFromTo": "משדרג מ-v{{current}} ל-v{{latest}}",
       "upgradingToLatest": "משדרג מ-v{{current}} לגרסה האחרונה",
+      "downloadingPackage": "מוריד גרסה חדשה...",
+      "downloadFailed": "ההורדה המוקדמת לא הושלמה — ממשיך בהתקנה",
       "stoppingDaemon": "עוצר תהליך לפני שדרוג...",
       "restartingDaemon": "מפעיל מחדש תהליך...",
       "daemonRestarted": "התהליך הופעל מחדש בהצלחה.",

package/dist/translations/pt/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "Já está atualizado (v{{version}})",
       "upgradingFromTo": "Atualizando de v{{current}} para v{{latest}}",
       "upgradingToLatest": "Atualizando de v{{current}} para a mais recente",
+      "downloadingPackage": "Baixando nova versão...",
+      "downloadFailed": "Download prévio não concluído — prosseguindo com a instalação",
       "stoppingDaemon": "Parando daemon antes da atualização...",
       "restartingDaemon": "Reiniciando daemon...",
       "daemonRestarted": "Daemon reiniciado com sucesso.",

package/dist/translations/ru/cli.json

@@ -567,6 +567,8 @@
       "alreadyUpToDate": "Уже актуальная версия (v{{version}})",
       "upgradingFromTo": "Обновление с v{{current}} до v{{latest}}",
       "upgradingToLatest": "Обновление с v{{current}} до последней версии",
+      "downloadingPackage": "Загрузка новой версии...",
+      "downloadFailed": "Предварительная загрузка не завершена — продолжение установки",
       "stoppingDaemon": "Остановка демона перед обновлением...",
       "restartingDaemon": "Перезапуск демона...",
       "daemonRestarted": "Демон успешно перезапущен.",