@mk-co/neox-cli 2.2.16 → 2.4.7-test

package/bin/neox

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../cli-wrapper.cjs');
+require('../cli-wrapper.cjs').run();

package/cli-wrapper.cjs

@@ -1,83 +1,120 @@
 #!/usr/bin/env node
 /**
- * @mk-co/neox-cli · cli-wrapper
+ * @mk-co/neox-cli · cli-wrapper (launcher)
  *
- *   主包安装后, bin/neox 是个 symlink → @mk-co/neox-cli-${platform}/neox.
- *   理论上 npm bin shim 直接走 symlink 就行, 不一定需要 wrapper.
+ *   ★ Windows EBUSY 根治 ★
+ *   以前: bin/neox = symlink/copy → node_modules 里的平台二进制, 直接跑它 → 运行中的 .exe 被
+ *   Windows 锁死 → `npm i -g` 要覆盖 node_modules\...\neox.exe → EBUSY (Claude Code 是纯 JS
+ *   跑在 node 上, .js 不被锁, 所以没这问题)。
  *
- *   但保留这个 wrapper 是给两种 fallback 路径:
- *
- *     1. 用户 main 包当 require('@mk-co/neox-cli') module 用 (尽管罕见) —
- *        package.json `"main": "./cli-wrapper.cjs"` 让 require 拿到这个 stub,
- *        不会拿到 binary 然后 SyntaxError.
- *
- *     2. 用户 install 时 postinstall 失败 (e.g. --no-optional), bin/neox 是
- *        placeholder, 直接跑 `neox` 时 placeholder script 调本 wrapper 退出
- *        + 友好提示.
- *
- *   binary 跑起来后, 这个 wrapper 完全不在 critical path, 所以零业务逻辑.
+ *   现在: bin/neox 永远是这个 JS launcher (node 跑, 不被锁)。它把平台二进制【copy 到缓存】
+ *   `~/.neox/bin/neox-<版本>(.exe)` (在 node_modules 之外), 跑【缓存】那一份。daemon / workers
+ *   都用 process.execPath = 缓存二进制起, 也跑在缓存。
+ *   → `npm i -g` 只覆盖 node_modules (JS launcher + 源二进制, 都没在运行) → 永不 EBUSY。
+ *   缓存按版本命名, 升级时换新名字 (旧的在跑也不冲突), 用完清理旧的。
  */
 
 'use strict';
 
 const fs = require('node:fs');
 const path = require('node:path');
+const os = require('node:os');
+const { spawn } = require('node:child_process');
 
 const SUPPORTED = {
-  'darwin-arm64':   '@mk-co/neox-cli-darwin-arm64',
-  'darwin-x64':     '@mk-co/neox-cli-darwin-x64',
-  'linux-x64':      '@mk-co/neox-cli-linux-x64',
-  'linux-arm64':    '@mk-co/neox-cli-linux-arm64',
-  'win32-x64':      '@mk-co/neox-cli-win32-x64',
+  'darwin-arm64': '@mk-co/neox-cli-darwin-arm64',
+  'darwin-x64': '@mk-co/neox-cli-darwin-x64',
+  'linux-x64': '@mk-co/neox-cli-linux-x64',
+  'linux-arm64': '@mk-co/neox-cli-linux-arm64',
+  'win32-x64': '@mk-co/neox-cli-win32-x64',
 };
 
-function findBinary() {
-  const platformKey = `${process.platform}-${process.arch}`;
-  const pkgName = SUPPORTED[platformKey];
-  if (!pkgName) {
-    process.stderr.write(`neox: 不支持当前平台 ${platformKey}.\n`);
-    process.stderr.write(`支持的平台: ${Object.keys(SUPPORTED).join(', ')}\n`);
-    process.exit(1);
-  }
+const EXE = process.platform === 'win32' ? 'neox.exe' : 'neox';
+
+/** 解析 node_modules 里的平台二进制 (源) + 其版本号。失败返回 { error }。 */
+function resolveSource() {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = SUPPORTED[key];
+  if (!pkg) return { error: `不支持当前平台 ${key} (支持: ${Object.keys(SUPPORTED).join(', ')})` };
   try {
-    const pkgRoot = path.dirname(require.resolve(`${pkgName}/package.json`));
-    const exeName = process.platform === 'win32' ? 'neox.exe' : 'neox';
-    const binary = path.join(pkgRoot, exeName);
-    if (fs.existsSync(binary)) return binary;
+    const root = path.dirname(require.resolve(`${pkg}/package.json`));
+    const bin = path.join(root, EXE);
+    if (fs.existsSync(bin)) {
+      let version = '0';
+      try { version = require(`${pkg}/package.json`).version || '0'; } catch { /* keep 0 */ }
+      return { bin, version };
+    }
   } catch { /* fall through */ }
+  return { error: `平台子包 ${pkg} 未安装 (可能用了 --no-optional)。修复: npm install -g ${pkg}` };
+}
 
-  process.stderr.write(`neox: 平台子包 ${pkgName} 没装 (可能用了 --no-optional).\n`);
-  process.stderr.write(`修复: npm install -g ${pkgName}\n`);
-  process.exit(1);
+/**
+ * 把源二进制 copy 到缓存 ~/.neox/bin/neox-<版本>(.exe), 返回缓存路径。
+ *   · 已存在且大小一致 → 跳过 copy
+ *   · 原子: 临时文件 + rename (rename 失败说明被同版本 daemon 锁着, 即已存在, 直接用)
+ *   · 清理旧版本缓存 (best-effort; 锁着就跳过)
+ *   · 任何失败 → 回落直接返回源路径 (退化成旧行为, 至少能跑)
+ */
+function ensureCached(src, version) {
+  const cacheDir = path.join(os.homedir(), '.neox', 'bin');
+  const name = process.platform === 'win32' ? `neox-${version}.exe` : `neox-${version}`;
+  const dest = path.join(cacheDir, name);
+  try {
+    fs.mkdirSync(cacheDir, { recursive: true });
+    let need = true;
+    try {
+      if (fs.statSync(dest).size === fs.statSync(src).size) need = false; // 已缓存好
+    } catch { /* dest 不存在 → need=true */ }
+    if (need) {
+      const tmp = path.join(cacheDir, `.tmp-${process.pid}-${Date.now()}-${name}`);
+      fs.copyFileSync(src, tmp);
+      if (process.platform !== 'win32') { try { fs.chmodSync(tmp, 0o755); } catch { /* ignore */ } }
+      try {
+        fs.renameSync(tmp, dest);
+      } catch {
+        // dest 被同版本运行中的 daemon 锁住 → 它已存在且就是对的, 删临时文件用现有的
+        try { fs.rmSync(tmp, { force: true }); } catch { /* ignore */ }
+      }
+    }
+    // 清理旧版本缓存 (锁着的旧 daemon 二进制跳过, 下次再清)
+    try {
+      for (const f of fs.readdirSync(cacheDir)) {
+        if (f === name || f.startsWith('.tmp-') || !f.startsWith('neox-')) continue;
+        try { fs.rmSync(path.join(cacheDir, f), { force: true }); } catch { /* 锁着, 跳过 */ }
+      }
+    } catch { /* ignore */ }
+    if (fs.existsSync(dest)) return dest;
+  } catch { /* 缓存整体失败 → 回落源路径 */ }
+  return src;
 }
 
-/* 直接 exec, 跨进程 forward stdio + signals. */
-const { spawn } = require('node:child_process');
-const binary = findBinary();
-const child = spawn(binary, process.argv.slice(2), {
-  stdio: 'inherit',
-  windowsHide: false,
-});
+/** 安装期预热: 把当前平台二进制 copy 进缓存, 让首次 `neox` 不用现 copy。失败静默。 */
+function prewarm() {
+  try {
+    const s = resolveSource();
+    if (s.bin) ensureCached(s.bin, s.version);
+  } catch { /* best-effort */ }
+}
 
-const passSignal = (sig) => () => {
-  try { child.kill(sig); } catch { /* ignore */ }
-};
-process.on('SIGINT', passSignal('SIGINT'));
-process.on('SIGTERM', passSignal('SIGTERM'));
-process.on('SIGHUP', passSignal('SIGHUP'));
+/** 真正启动: 解析源 → 确保缓存 → 跑缓存二进制 (透传 argv / stdio / signals)。 */
+function run() {
+  const s = resolveSource();
+  if (s.error) { process.stderr.write(`neox: ${s.error}\n`); process.exit(1); return; }
+  const target = ensureCached(s.bin, s.version);
 
-child.on('exit', (code, sig) => {
-  if (sig) {
-    /* 让 parent 也以同样 signal 死, shell 才能正确 detect Ctrl-C 退出 */
-    process.kill(process.pid, sig);
-  } else {
-    process.exit(code ?? 0);
-  }
-});
+  const child = spawn(target, process.argv.slice(2), { stdio: 'inherit', windowsHide: false });
+  const pass = (sig) => () => { try { child.kill(sig); } catch { /* ignore */ } };
+  process.on('SIGINT', pass('SIGINT'));
+  process.on('SIGTERM', pass('SIGTERM'));
+  process.on('SIGHUP', pass('SIGHUP'));
+  child.on('exit', (code, sig) => {
+    if (sig) process.kill(process.pid, sig); // 让 parent 也以同 signal 死, shell 能正确 detect Ctrl-C
+    else process.exit(code ?? 0);
+  });
+  child.on('error', (e) => { process.stderr.write(`neox: 无法启动 binary: ${e.message}\n`); process.exit(2); });
+}
 
-child.on('error', (e) => {
-  process.stderr.write(`neox: 无法启动 binary: ${e.message}\n`);
-  process.exit(2);
-});
+module.exports = { run, prewarm, resolveSource, ensureCached };
 
-module.exports = { findBinary };
+/* 作为 binary 直接跑 (bin/neox → require(this).run())。被 require 当 module 用时不自动跑。 */
+if (require.main === module) run();

package/install.cjs

@@ -3,40 +3,30 @@
  * @mk-co/neox-cli · postinstall
  *
  *   npm 装完主包 + 当前 platform 的 optional dep 之后跑这里:
- *     · 检测当前 platform = "${process.platform}-${process.arch}"
- *     · 找到 @mk-co/neox-cli-${platform} 的 native binary 路径
- *     · symlink (Unix) / copy (Windows) 到 ./bin/neox 给 npm bin shim 用
+ *     · 校验当前 platform 受支持 + 平台子包的二进制在位
+ *     · 预热: 把二进制 copy 进缓存 ~/.neox/bin/neox-<版本>(.exe), 让首次 `neox` 不用现 copy
  *
- *   设计跟 @anthropic-ai/claude-code 同套路 — 主包零业务代码, 真 binary 在
- *   平台子包里, 用户 `npm install -g` 时 optional deps 自动只装当前 platform.
+ *   ★ 不再把 bin/neox 替换成指向 node_modules 二进制的 symlink/copy ★
+ *   bin/neox 永远是 JS launcher (cli-wrapper)。真正运行的二进制在缓存里 (node_modules 之外),
+ *   所以 `npm i -g` 重装/升级时 npm 不会去覆盖一个【正在运行 / 被锁】的文件 → 根治 Windows EBUSY。
  *
- *   失败容错:
- *     · platform 不支持 → 退 1 + 友好提示 (列出我们支持的 platforms)
- *     · platform 包没装 → 友好提示用户 manual install (常见: 用了 --no-optional)
- *
- *   不抛 throw, 因为 npm postinstall 抛了会让整个 install 显红, 但其实没 fatal.
+ *   不抛 throw — postinstall 抛了会让整个 install 显红, 但其实没 fatal (跑 neox 时 launcher 会兜底)。
  */
 
 'use strict';
 
 const fs = require('node:fs');
 const path = require('node:path');
-const os = require('node:os');
 
 const SUPPORTED = {
-  'darwin-arm64':   '@mk-co/neox-cli-darwin-arm64',
-  'linux-x64':      '@mk-co/neox-cli-linux-x64',
-  'win32-x64':      '@mk-co/neox-cli-win32-x64',
-  // darwin-x64 (Intel Mac) + linux-arm64 本版未发布 (runner 排队 / 设备少). 这些平台会落到
-  // "platform 不支持" 友好提示, 待加回时同步 build-cli-binaries PLATFORMS + package.json.tpl.
+  'darwin-arm64': '@mk-co/neox-cli-darwin-arm64',
+  'linux-x64': '@mk-co/neox-cli-linux-x64',
+  'win32-x64': '@mk-co/neox-cli-win32-x64',
+  // darwin-x64 / linux-arm64 本版未发布; 落到"平台不支持"友好提示。
 };
 
-function log(msg) {
-  process.stdout.write(`[neox-cli postinstall] ${msg}\n`);
-}
-function warn(msg) {
-  process.stderr.write(`[neox-cli postinstall] ⚠ ${msg}\n`);
-}
+function log(msg) { process.stdout.write(`[neox-cli postinstall] ${msg}\n`); }
+function warn(msg) { process.stderr.write(`[neox-cli postinstall] ⚠ ${msg}\n`); }
 
 function main() {
   const platformKey = `${process.platform}-${process.arch}`;
@@ -45,18 +35,15 @@ function main() {
   if (!pkgName) {
     warn(`不支持当前平台 ${platformKey}.`);
     warn(`支持的平台: ${Object.keys(SUPPORTED).join(', ')}`);
-    warn(`你的 neox 命令会找不到, 请联系 MK-CO 支持其他平台.`);
-    return; /* 不退 1, 让 npm install 整体成功, 用户跑 neox 时再报错 */
+    warn(`你的 neox 命令会找不到二进制, 请联系 MK-CO 支持其他平台.`);
+    return; /* 不退 1 */
   }
 
-  /* 找 platform sub-package 的 binary. node_modules 解析路径取决于安装方式
-   * (-g vs 项目级), 用 require.resolve 让 npm 自己决定. */
-  let binarySrc;
+  /* 校验平台子包二进制在位 */
   try {
-    /* 期待: node_modules/@mk-co/neox-cli-${platform}/neox (Unix) or neox.exe (Win) */
     const pkgRoot = path.dirname(require.resolve(`${pkgName}/package.json`));
     const exeName = process.platform === 'win32' ? 'neox.exe' : 'neox';
-    binarySrc = path.join(pkgRoot, exeName);
+    const binarySrc = path.join(pkgRoot, exeName);
     if (!fs.existsSync(binarySrc)) {
       warn(`平台子包已装但 binary 不在 ${binarySrc} — 可能 publish 出错.`);
       return;
@@ -68,30 +55,13 @@ function main() {
     return;
   }
 
-  /* 创建 bin/neox 指向 platform binary. Unix 用 symlink, Windows 用 copy. */
-  const binDir = path.join(__dirname, 'bin');
-  fs.mkdirSync(binDir, { recursive: true });
-  const exeName = process.platform === 'win32' ? 'neox.exe' : 'neox';
-  const binDest = path.join(binDir, exeName);
-
+  /* 预热缓存 (copy 二进制到 ~/.neox/bin/neox-<版本>)。失败不致命 — launcher 首次跑时会兜底 copy。 */
   try {
-    if (fs.existsSync(binDest) || fs.lstatSync(binDest).isSymbolicLink?.()) {
-      fs.rmSync(binDest, { force: true });
-    }
-  } catch { /* ignore */ }
-
-  try {
-    if (process.platform === 'win32') {
-      /* Windows: 不能 symlink (要管理员), 直接 copy */
-      fs.copyFileSync(binarySrc, binDest);
-    } else {
-      fs.symlinkSync(binarySrc, binDest);
-      fs.chmodSync(binDest, 0o755);
-    }
-    log(`installed ${platformKey}: ${path.relative(process.cwd(), binDest)} → ${path.relative(process.cwd(), binarySrc)}`);
+    const { prewarm } = require('./cli-wrapper.cjs');
+    prewarm();
+    log(`ready (${platformKey}) — 二进制已缓存到 ~/.neox/bin, 跑 neox 即可。`);
   } catch (e) {
-    warn(`无法 ${process.platform === 'win32' ? 'copy' : 'symlink'} binary: ${e.message}`);
-    warn(`手动 fix: ${process.platform === 'win32' ? 'copy' : 'ln -s'} "${binarySrc}" "${binDest}"`);
+    warn(`缓存预热失败 (非致命, 首次跑 neox 时会自动补): ${e?.message || e}`);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mk-co/neox-cli",
-  "version": "2.2.16",
+  "version": "2.4.7-test",
   "description": "Neox CLI · Professional AI code assistant",
   "license": "UNLICENSED",
   "engines": {
@@ -21,9 +21,9 @@
     "postinstall": "node install.cjs"
   },
   "optionalDependencies": {
-    "@mk-co/neox-cli-darwin-arm64": "2.2.16",
-    "@mk-co/neox-cli-linux-x64":    "2.2.16",
-    "@mk-co/neox-cli-win32-x64":    "2.2.16"
+    "@mk-co/neox-cli-darwin-arm64": "2.4.7-test",
+    "@mk-co/neox-cli-linux-x64":    "2.4.7-test",
+    "@mk-co/neox-cli-win32-x64":    "2.4.7-test"
   },
   "publishConfig": {
     "access": "public"