grix-connector 4.2.9 → 4.3.1

package/scripts/upgrade-guardian.mjs

@@ -9,6 +9,7 @@ import {
   existsSync,
   mkdirSync,
   readFileSync,
+  realpathSync,
   renameSync,
   rmSync,
   writeFileSync,
@@ -45,6 +46,43 @@ const TRANSACTION_PHASES = new Set([
 ]);
 const RENAME_RETRY_DELAYS_MS = [250, 750, 1_500, 3_000, 5_000];
 
+/** 逐侧解析真实路径；解析不了的一侧原样保留，另一侧仍然受益。 */
+function toRealPath(value) {
+  try {
+    return realpathSync(value);
+  } catch {
+    return value;
+  }
+}
+
+/**
+ * Windows 路径大小写不敏感（`C:\\Users\\X` 与 `c:\\users\\x` 是同一个文件），
+ * 且盘符大小写会随调用方变化；POSIX 必须保持大小写敏感，否则会把两个不同文件
+ * 判成同一个。
+ */
+function normalizePathForCompare(value, platform = process.platform) {
+  const resolved = resolve(value);
+  return platform === 'win32' ? resolved.toLowerCase() : resolved;
+}
+
+/**
+ * 判断两个路径是否指向同一个文件。**必须按真实路径比对**：Node 的 ESM 加载器默认
+ * 解析软链接，`import.meta.url` 给的是真实路径，而 `process.argv[1]` 是调用方原样
+ * 传入的路径。`resolve()` 只做规范化、不解软链，于是 `$GRIX_CONNECTOR_HOME` 只要
+ * 含一段软链接（例如 `~/.grix -> /Volumes/disk1/gcf/.grix`），两者就永不相等。
+ * 曾导致 guardian 被拉起后 `isMain` 恒为 false、主逻辑一次都没执行：升级包装好、
+ * 校验通过、上报 installed，然后 guardian 空转到 10 分钟激活超时，事务被按版本裁决
+ * 收口成 rolled_back，错误码还报成误导性的 STARTUP_CRASH。
+ *
+ * 两侧各自解析、各自归一化，所以"一侧存在一侧不存在"时另一侧的真实路径依然生效；
+ * 大小写按平台处理，见 {@link normalizePathForCompare}。
+ */
+export function isSamePath(left, right, platform = process.platform) {
+  if (!left || !right) return false;
+  return normalizePathForCompare(toRealPath(left), platform)
+    === normalizePathForCompare(toRealPath(right), platform);
+}
+
 function pathsFor(rootDir) {
   return {
     pending: join(rootDir, 'data', 'upgrade-pending.json'),
@@ -739,7 +777,7 @@ function wrapperChildPid(record, runtimeDir, pending, deps = {}) {
     && typeof record?.boot_time === 'number'
     && Math.abs(record.boot_time - currentBootTime) <= 60_000
     && typeof record?.cli_path === 'string'
-    && resolve(record.cli_path) === resolve(expectedCli)
+    && isSamePath(record.cli_path, expectedCli)
     ? record.pid
     : null;
 }
@@ -1306,6 +1344,9 @@ async function runCli() {
     ? resolve(args[rootIndex + 1])
     : resolve(process.env.GRIX_CONNECTOR_HOME || join(homedir(), '.grix'));
   const paths = pathsFor(rootDir);
+  // 落一条启动行再做任何判断：guardian 是 detached 起的，早期失败没有任何出口，
+  // 缺这行时"被拉起却什么都没发生"在日志上和"根本没被拉起"完全无法区分。
+  appendLog(paths.log, `${mode}: guardian started pid=${process.pid} node=${process.version} entry=${process.argv[1] ?? ''}`);
   const readArg = (name) => {
     const index = args.indexOf(name);
     return index >= 0 && args[index + 1] ? args[index + 1] : '';
@@ -1341,5 +1382,5 @@ async function runCli() {
   }
 }
 
-const isMain = process.argv[1] && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url));
+const isMain = isSamePath(process.argv[1], fileURLToPath(import.meta.url));
 if (isMain) process.exitCode = await runCli();