sillyspec 3.27.2 → 3.27.6

package/src/worktree-deps.js

@@ -8,8 +8,9 @@
  * 见 change 2026-06-28-worktree-deps-provision / D-005@v1, D-007@v1。
  */
 
-import { existsSync, readFileSync, realpathSync, lstatSync } from 'fs';
+import { existsSync, readFileSync, realpathSync, lstatSync, readdirSync } from 'fs';
 import { join, isAbsolute, relative, resolve as resolvePath, sep as pathSep } from 'path';
+import { fileURLToPath } from 'url';
 import { execFileSync } from 'child_process';
 import { createHash } from 'crypto';
 
@@ -129,9 +130,33 @@ function tryLink(mainNodeModules, linkPath) {
       const resolvedTarget = realpathSync(mainNodeModules);
       if (resolved === resolvedTarget) return { ok: true, method: process.platform === 'win32' ? 'junction' : 'symlink' };
     } catch {}
+    // 真实目录 ≠ 已有依赖（坑 provision-preexisting-dir-fake-linked，2026-08-23 实证：doctor --fix
+    // 报 re-provisioned 但链接没建——worktree node_modules 是 install 半途中断残留的真实目录时，
+    // realpath 不等 main → 被 preexisting 短路标 ok，根快路径据此写 depsStatus=linked，一个链接
+    // 都没建且后验证 existsSync 对空/残目录照样过）。真实目录 → ok:false + preexistingDir 标记，
+    // 交调用方决策：根快路径降级 tryInstall 真重建（宁可重装不说谎）；linkOneDir 视为本地安装
+    // 保留（installed 语义，合法状态）。指向别处的 link 仍是「他者安装」，尊重不 clobber。
+    try {
+      if (!lstatSync(linkPath).isSymbolicLink()) {
+        return { ok: false, preexistingDir: true, error: `node_modules 已存在且为真实目录（非链接，疑似 install 残留）: ${linkPath}` };
+      }
+    } catch {}
     // 指向别处 → 不 clobber，视为已有依赖（installed 语义）
     return { ok: true, method: 'install', preexisting: true };
   }
+  // broken junction 清理（existsSync 对目标丢失的 junction/symlink 返回 false，但目录项占位会使
+  // mklink/ln 撞名失败 → 根：落 install 慢路径；子模块：linkOneDir failed。此坑在 _doctorReprovision
+  // 的解链段同样存在——它也用 existsSync 前置判断，broken junction 永远解不掉）：lstat 是 link 而
+  // existsSync false → 删目录项后重建（rmdir 删 junction 不跟随 reparse，与 worktree.js 解链同款）。
+  try {
+    if (lstatSync(linkPath).isSymbolicLink()) {
+      if (process.platform === 'win32') {
+        execFileSync('cmd.exe', ['/c', 'rmdir', linkPath], { stdio: ['pipe', 'pipe', 'pipe'] });
+      } else {
+        unlinkSync(linkPath);
+      }
+    }
+  } catch { /* lstat 抛 = 目录项真不存在，直接建 */ }
   try {
     if (process.platform === 'win32') {
       // execFileSync 数组形式不经 shell：POSIX 双引号内 `/$() 会执行、cmd.exe 双引号内 %VAR% 仍展开，
@@ -292,6 +317,9 @@ function linkOneDir(wtDir, mainDir) {
   }
   const r = tryLink(mainNodeModules, join(wtDir, 'node_modules'));
   if (r.ok) return { status: 'linked', method: r.method };
+  // 真实目录 = 子模块本地安装过（合法状态，如 mismatch 后用户手动 pnpm install）：保留为
+  // installed 真话，不假 linked 也不误报 failed（tryLink 的 preexistingDir 细分见其注释）
+  if (r.preexistingDir) return { status: 'installed', reason: '子模块 node_modules 为真实目录（本地安装），保留' };
   return { status: 'failed', error: r.error };
 }
 
@@ -443,6 +471,17 @@ export function provisionDeps(worktreePath, mainCwd, opts = {}) {
       const fmsg = failedModules.map(m => `${m.path}: ${m.error}`).join('; ');
       result.depsError = result.depsError ? `${result.depsError}; ${fmsg}` : fmsg;
     }
+    // mismatch 可见性（坑 modules-mismatch-invisible，2026-08-23 实证：mismatch/skipped 只写
+    // depsModules 而 src 内零消费——doctor 报 re-provisioned 成功、子模块实际无链接且无任何
+    // 提示）。mismatch（worktree 与主仓 lockfile 不一致，link 不适用）摘要进 depsError：可见、
+    // 落 meta、doctor msg 带出（_doctorReprovision 不再抹）；但不降级 depsStatus——mismatch 是
+    // 配置分叉态不是供给失败，降级会经 deps gate 卡死 execute（正确动作是用户在 worktree 跑
+    // pnpm install 或对齐 lockfile， doctor --fix 的 force 重装路径也会覆盖此场景）。
+    const mismatchModules = moduleResults.filter(m => m.status === 'mismatch');
+    if (mismatchModules.length > 0) {
+      const mmsg = `子模块 lockfile 与主仓不一致（未链接，本地 install 或对齐 lockfile）: ${mismatchModules.map(m => m.path).join('、')}`;
+      result.depsError = result.depsError ? `${result.depsError}; ${mmsg}` : mmsg;
+    }
   }
 
   return result;
@@ -492,6 +531,25 @@ export function checkDepsFreshness(meta, wtPath, mainCwd) {
     };
   }
 
+  // 2b. 子模块 missing（坑 modules-submodule-missing-no-selfheal）：meta.depsModules 中 linked
+  // 状态的子模块逐一核验 wt/<mp>/node_modules 实存。provisionDeps 内的同款核验（坑
+  // modules-submodule-link-verify）只管供给时刻，此后 junction 被删（杀毒/手工误删/半途清理）
+  // 时本函数只查根（上方）→ 永远 fresh → doctor 不再报 → 漏链永不自愈。此处补 doctor 侧
+  // 闭环：缺失 → missing → doctor --fix 走 relinkFirst 重链（provisionDeps 非 force 路径
+  // 的 linkOneDir 对缺失目录直接重建 junction）。
+  if (Array.isArray(meta && meta.depsModules)) {
+    const missingMods = meta.depsModules.filter(m =>
+      m && m.status === 'linked' && typeof m.path === 'string'
+      && !existsSync(join(wtPath, m.path, 'node_modules')));
+    if (missingMods.length > 0) {
+      return {
+        status: 'missing',
+        detail: `${missingMods.length} 个 linked 子模块 node_modules 缺失: ${missingMods.map(m => m.path).join('、')}`,
+        wtHash, mainHash, metaLockHash,
+      };
+    }
+  }
+
   // 3. stale：worktree 自身 lockfile 与 meta 快照不一致（对齐 doctor 916-917 / ensure 404）
   if (metaLockHash && wtHash && wtHash !== metaLockHash) {
     return {
@@ -517,3 +575,94 @@ export function checkDepsFreshness(meta, wtPath, mainCwd) {
     wtHash, mainHash, metaLockHash,
   };
 }
+
+/**
+ * editable install 越界探测（坑 worktree-editable-install-escape，2026-08-25 用户实证
+ * gen:types 坑）：worktree 内 Python venv 的 editable install 指向 worktree 外（典型：
+ * 主仓 checkout 路径）时，gen:types / 后端命令 / pytest 静默加载 worktree 外的旧代码——
+ * 改动不生效且无任何报错，此前靠模块文档注意事项人工记忆，本函数把它 CLI 检查化
+ * （worktree doctor 调用）。
+ *
+ * 覆盖三种 editable 痕迹：
+ *   1. 路径型 .pth（setuptools 旧式）：.pth 内容行即绝对路径
+ *   2. PEP 660 __editable__.<pkg>-*.pth + __editable___<pkg>_*_finder.py（MAPPING 表绝对路径）
+ *   3. *.dist-info/direct_url.json { dir_info.editable: true, url: file:///... }
+ * 判定统一为「目标路径 resolve 后不在 worktree 内」；venv/文件读取失败按无越界处理
+ * （doctor 体检语义，不阻断）。
+ *
+ * @param {string} wtPath worktree 根目录
+ * @returns {Array<{ pkg: string, target: string, via: string }>} 越界清单（空 = 干净或无 venv）
+ */
+export function detectEditableInstallEscape(wtPath) {
+  const offenders = [];
+  if (!wtPath || !existsSync(wtPath)) return offenders;
+  const wtRoot = resolvePath(wtPath);
+  const isEscape = (target) => {
+    if (!target || !isAbsolute(target)) return false;
+    const rel = relative(wtRoot, resolvePath(target));
+    return rel.startsWith('..') || isAbsolute(rel);
+  };
+  const seen = new Set();
+  const push = (pkg, target, via) => {
+    const key = `${pkg}|${target}`;
+    if (seen.has(key)) return;
+    seen.add(key);
+    offenders.push({ pkg, target, via });
+  };
+
+  for (const venvName of ['.venv', 'venv']) {
+    const venvDir = join(wtPath, venvName);
+    if (!existsSync(venvDir)) continue;
+    // site-packages 候选：Windows Lib/site-packages + POSIX lib/python*/site-packages
+    const spCandidates = [join(venvDir, 'Lib', 'site-packages')];
+    try {
+      for (const e of readdirSync(join(venvDir, 'lib'), { withFileTypes: true })) {
+        if (e.isDirectory() && e.name.toLowerCase().startsWith('python')) {
+          spCandidates.push(join(venvDir, 'lib', e.name, 'site-packages'));
+        }
+      }
+    } catch { /* 无 lib 目录（Windows 布局）跳过 */ }
+    for (const sp of spCandidates) {
+      if (!existsSync(sp)) continue;
+      let entries = [];
+      try { entries = readdirSync(sp, { withFileTypes: true }); } catch { continue; }
+      for (const e of entries) {
+        if (!e.isFile()) continue;
+        const fp = join(sp, e.name);
+        if (e.name.endsWith('.pth')) {
+          let lines = [];
+          try { lines = readFileSync(fp, 'utf8').split('\n'); } catch { continue; }
+          for (const raw of lines) {
+            const line = raw.trim();
+            if (!line || line.startsWith('#') || line.startsWith('import ')) continue;
+            if (isEscape(line)) push(e.name.replace(/\.pth$/, ''), line, '.pth');
+          }
+        } else if (/^__editable___.+_finder\.py$/.test(e.name)) {
+          let src = '';
+          try { src = readFileSync(fp, 'utf8'); } catch { continue; }
+          const mm = /MAPPING\s*=\s*\{([\s\S]*?)\}/.exec(src);
+          if (!mm) continue;
+          const pkg = e.name.replace(/^__editable___/, '').replace(/_finder\.py$/, '');
+          for (const pm of mm[1].matchAll(/'((?:[^'\\]|\\.)*)'/g)) {
+            const target = pm[1].replace(/\\\\/g, '\\');
+            if (isEscape(target)) push(pkg, target, 'pep660-finder');
+          }
+        }
+      }
+      // direct_url.json（pip/uv 现代 editable 标记）
+      for (const e of entries) {
+        if (!e.isDirectory() || !e.name.endsWith('.dist-info')) continue;
+        const du = join(sp, e.name, 'direct_url.json');
+        if (!existsSync(du)) continue;
+        try {
+          const meta = JSON.parse(readFileSync(du, 'utf8'));
+          if (meta?.dir_info?.editable && typeof meta.url === 'string' && meta.url.startsWith('file://')) {
+            const target = fileURLToPath(meta.url);
+            if (isEscape(target)) push(e.name.replace(/\.dist-info$/, ''), target, 'direct_url');
+          }
+        } catch { /* 解析失败跳过 */ }
+      }
+    }
+  }
+  return offenders;
+}