@shepai/cli 1.169.0-pr523.2f53944 → 1.169.0-pr524.54c51f4

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;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;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;IAkC1B;;;;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

@@ -25,6 +25,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { injectable, inject } from 'tsyringe';
 import { spawn } from 'node:child_process';
 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 +44,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 +111,35 @@ let UpgradeCliUseCase = class UpgradeCliUseCase {
             });
         });
     }
+    preDownloadPackage() {
+        return new Promise((resolve) => {
+            let settled = false;
+            const child = spawn('npm', ['cache', 'add', '@shepai/cli@latest'], {
+                stdio: ['ignore', 'ignore', 'pipe'],
+            });
+            const timeout = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    child.kill();
+                    resolve(false);
+                }
+            }, NPM_CACHE_ADD_TIMEOUT_MS);
+            child.on('close', (code) => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    resolve(code === 0);
+                }
+            });
+            child.on('error', () => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    resolve(false);
+                }
+            });
+        });
+    }
     /**
      * Schedule a daemon self-restart after upgrade.
      * Reads the current daemon port, spawns a new daemon process with the

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/evidence.node.js

@@ -86,7 +86,7 @@ export function createEvidenceNode(executor) {
         const commitEvidence = state.commitEvidence;
         const settings = hasSettings() ? getSettings() : undefined;
         const maxRetries = settings?.workflow.evidenceRetries ?? DEFAULT_MAX_RETRIES;
-        const options = buildExecutorOptions(state, undefined, 'evidence');
+        const options = buildExecutorOptions(state);
         const tasks = parseTasks(state.specDir);
         // --- Validation retry loop ---
         let allEvidence = [];

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/fast-implement.node.js

@@ -48,7 +48,7 @@ export function createFastImplementNode(executor) {
             agentType: executor.agentType,
         });
         try {
-            const options = buildExecutorOptions(state, undefined, 'fast-implement');
+            const options = buildExecutorOptions(state);
             log.info(`Executing agent at cwd=${options.cwd}`);
             log.info(`Prompt length: ${prompt.length} chars`);
             const result = await retryExecute(executor, prompt, options, { logger: log });

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/implement.node.js

@@ -112,7 +112,7 @@ export function createImplementNode(executor) {
                 }
                 log.info(`Phase ${phase.id} "${phase.name}" — ${phaseTasks.length} task(s), parallel: ${phase.parallel}`);
                 updateFeatureProgress(state.specDir, completedTasks, totalTasks, `implementing-${phase.id}`, phaseTasks[0].id, log);
-                const options = buildExecutorOptions(state, undefined, 'implement');
+                const options = buildExecutorOptions(state);
                 const promptContext = { isLastPhase, phaseIndex: i, totalPhases };
                 const phaseStartTime = Date.now();
                 const phaseTimingId = await recordPhaseStart(`implement:${phase.id}`, {

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/merge/merge.node.js

@@ -83,7 +83,7 @@ export function createMergeNode(deps) {
             const feature = await deps.featureRepository.findById(state.featureId);
             const branch = feature?.branch ?? `feat/${state.featureId}`;
             const baseBranch = await deps.getDefaultBranch(cwd);
-            const options = buildExecutorOptions(state, undefined, 'merge');
+            const options = buildExecutorOptions(state);
             let commitHash = state.commitHash;
             let prUrl = state.prUrl;
             let prNumber = state.prNumber;

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;AAS9E,KAAK,OAAO,GAAG,OAAO,YAAY,CAAC;AAuHnC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAsB,GAAG,OAAO,CA6E7E"}

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

@@ -14,6 +14,7 @@ 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,6 +62,41 @@ function getLatestVersion(spawnFn) {
         });
     });
 }
+/**
+ * Pre-download the package into npm's cache so the subsequent install is fast.
+ * Uses `npm cache add` which downloads without installing.
+ * Returns true if the cache add succeeded, false otherwise (fail-open).
+ */
+function preDownloadPackage(spawnFn) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const child = spawnFn('npm', ['cache', 'add', '@shepai/cli@latest'], {
+            stdio: ['ignore', 'ignore', 'pipe'],
+            ...(IS_WINDOWS && { shell: true }),
+        });
+        const timeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                child.kill();
+                resolve(false);
+            }
+        }, NPM_CACHE_ADD_TIMEOUT_MS);
+        child.on('close', (code) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                resolve(code === 0);
+            }
+        });
+        child.on('error', () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                resolve(false);
+            }
+        });
+    });
+}
 /**
  * Run npm i -g @shepai/cli@latest with inherited stdio.
  * Returns the exit code, or rejects on spawn error.
@@ -107,7 +143,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 +159,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

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

package/dist/translations/de/cli.json

@@ -565,6 +565,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

@@ -565,6 +565,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

@@ -565,6 +565,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

@@ -565,6 +565,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

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

package/dist/translations/pt/cli.json

@@ -565,6 +565,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

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