evolcore 0.0.37 → 0.0.38

package/CHANGELOG.md

@@ -5,6 +5,13 @@
 
 ## Unreleased
 
+## 0.0.38 (2026-10-24)
+
+### npm 升级稳定性
+
+- 修复 npm 升级在 registry 元数据暂未同步时误报目标版本不存在的问题。
+- 改进升级失败诊断，保留 npm 错误码和具体错误信息，便于定位网络、权限和版本解析问题。
+
 ## 0.0.37 (2026-10-24)
 
 ### 升级与重启稳定性

package/dist/utils/npm-ops.js

@@ -394,20 +394,36 @@ export async function preparePackageCache(target, registry, options = {}) {
     const run = (args) => new Promise((resolve, reject) => {
         let failure = null;
         let output = '';
+        let errorOutput = '';
         const child = execFile(npm.command, [...npm.argsPrefix, ...args, '--registry', registry, ...npmConfigArgs(options.npmConfig), '--ignore-scripts'], {
             timeout: 180_000, windowsHide: isWindows, signal: options.signal, maxBuffer: 8 * 1024 * 1024,
-        }, (error, stdout) => { failure = error; output = String(stdout ?? ''); });
+        }, (error, stdout, stderr) => {
+            failure = error;
+            output = String(stdout ?? '');
+            errorOutput = String(stderr ?? '');
+        });
         child.once('error', error => { failure = error; });
         child.once('close', code => {
-            if (failure || code !== 0 || options.signal?.aborted)
-                reject(new Error(options.signal?.aborted
-                    ? 'Package cache preparation timed out or was cancelled' : 'npm cache preparation failed; check registry connectivity, credentials, disk space and permissions'));
-            else
+            if (!failure && code === 0 && !options.signal?.aborted) {
                 resolve(output);
+                return;
+            }
+            if (options.signal?.aborted) {
+                reject(new Error('Package cache preparation timed out or was cancelled'));
+                return;
+            }
+            const codeText = failure && 'code' in failure && failure.code ? ` (${String(failure.code)})` : '';
+            const detail = (errorOutput || failure?.stderr || failure?.message || '')
+                .replace(/\s+/g, ' ').trim().slice(0, 500);
+            reject(new Error(`npm cache preparation failed${codeText}${detail ? `: ${detail}` : ''}`));
         });
     });
     options.onPhase?.('downloading');
-    await run(['cache', 'add', spec, '--prefer-offline']);
+    // Revalidate registry metadata before resolving the exact version. A stale
+    // install-v1 packument can otherwise report ETARGET even when the registry
+    // already contains the selected release. The tarball itself remains cached
+    // and is reused when npm can do so.
+    await run(['cache', 'add', spec, '--prefer-online']);
     options.onPhase?.('tarball-check');
     const metadata = JSON.parse(await run(['view', spec, 'name', 'version', 'dist', '--json', '--offline']));
     const [packed] = JSON.parse(await run(['pack', spec, '--dry-run', '--json', '--offline']));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolcore",
-  "version": "0.0.37",
+  "version": "0.0.38",
   "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
   "type": "module",
   "main": "dist/index.js",