@jspg-ai/coding-bb 0.0.3-beta.9 → 0.0.5-beta.1

package/cbb/worktrees/_shared/scripts/junction-ai-config.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+/**
+ * worktree 模式 AI 配置 junction（ADR 0002，防线 B）。
+ *
+ * 用法：node junction-ai-config.js <ws_root> <wt_path> [--remove]
+ *
+ * 目的：让开发会话能开进 worktree（工作树内加载 AI 配置），同时保持
+ * 「单层安装」实质——配置唯一物理副本在空间根，cbb update 一处生效。
+ *
+ * 策略（规避 ADR 0001 否决时的状态污染）：
+ *   - 只 junction **只读内容子目录**（rules / skills / commands）：
+ *     工具向配置根写状态（如 settings.local.json）落在 worktree 自建的
+ *     物理（空壳）配置目录里，按项目隔离，不互相覆盖；
+ *   - 配置根目录本身在 worktree 侧是物理目录（不是链接）；
+ *   - .opencode/opencode.json 为文件（junction 不支持文件）：直接复制
+ *     （cbb update 后需重跑本脚本同步；worktree 为瞬态，影响可控）。
+ *
+ * 幂等：linkPath 已指向同一 target → skip；指向不同 → 重建；
+ *       存在同名**物理目录**（非链接）→ warn 跳过（不覆盖用户内容）。
+ *
+ * --remove（cbb-worktree-close 调用）：
+ *   - 拆除 worktree 内已建 junction 与复制件，**源文件零接触**：
+ *     只解除链接本身（fs.rmSync 对 reparse point 仅删链接、不穿透目标，
+ *     已由 Windows 实测验证），复制件为普通文件直接删除；
+ *   - 拆除前校验链接目标位于空间根内——目标在空间根外 / readlink 失败
+ *     → 跳过并警告（防误删外部目录）；同名物理目录/文件 → 跳过不碰。
+ *
+ * 退出码：0 成功（含全部 skip）；1 参数错误；2 执行失败。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const wtPath = process.argv[3];
+const removeMode = process.argv[4] === '--remove';
+
+if (!wsRoot || !wtPath) {
+  console.error('Usage: node junction-ai-config.js <ws_root> <wt_path> [--remove]');
+  process.exit(1);
+}
+
+// 各工具的项目级配置根（存在才处理）与本包部署的内容子目录
+const CONFIG_ROOTS = ['.claude', '.qoder', '.opencode', '.workbuddy', '.trae', '.minimax'];
+const CONTENT_SUBDIRS = ['rules', 'skills', 'commands'];
+// 文件级内容（复制而非 junction）：opencode 的 instructions 登记
+const CONTENT_FILES = { '.opencode': ['opencode.json'] };
+
+const linked = [];
+const copied = [];
+const skipped = [];
+const warned = [];
+let hasFailure = false;
+
+/** 归一化 junction 目标路径（Windows readlink 返回 \\?\ 前缀） */
+function normLinkTarget(p) {
+  return path.resolve(String(p).replace(/^\\\\\?\\/, ''));
+}
+
+/** 目标是否位于空间根内（防误删空间根外目录的守卫） */
+function isWithin(p, root) {
+  const r = path.resolve(root) + path.sep;
+  return path.resolve(p).startsWith(r);
+}
+
+// ── remove 模式：显式拆除 junction 与复制件（源文件零接触）──
+if (removeMode) {
+  const removed = [];
+  const guarded = [];
+
+  for (const root of CONFIG_ROOTS) {
+    for (const sub of CONTENT_SUBDIRS) {
+      const linkPath = path.join(wtPath, root, sub);
+      const label = root + '/' + sub;
+      let st;
+      try { st = fs.lstatSync(linkPath); } catch (e) { continue; } // 不存在 → 跳过（dangling 链接 lstat 仍成功，可拆）
+      if (!st.isSymbolicLink()) continue; // 物理目录/文件（工具状态空壳或用户内容）→ 不碰
+
+      const target = normLinkTarget(fs.readlinkSync(linkPath));
+      if (!isWithin(target, wsRoot)) {
+        guarded.push(label + ' → ' + target + '（目标不在空间根内，跳过）');
+        continue;
+      }
+
+      try {
+        // 只解除链接：Node 对 reparse point 仅删除链接本身，不递归、不触达目标内容
+        fs.rmSync(linkPath, { recursive: true, force: true });
+        removed.push(label);
+      } catch (e) {
+        console.error('❌ 拆除失败 ' + label + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+
+    for (const file of (CONTENT_FILES[root] || [])) {
+      const linkPath = path.join(wtPath, root, file);
+      if (!fs.existsSync(linkPath)) continue;
+      try {
+        fs.unlinkSync(linkPath); // 复制件为普通文件，删除不影响源
+        removed.push(root + '/' + file);
+      } catch (e) {
+        console.error('❌ 删除失败 ' + root + '/' + file + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+  }
+
+  if (removed.length) console.log('✅ 已拆除 junction/复制件：' + removed.join(', '));
+  if (guarded.length) console.log('⚠️  ' + guarded.join('；'));
+  if (removed.length === 0 && guarded.length === 0) console.log('ℹ️  无待拆除项（幂等）');
+
+  console.log('---');
+  console.log('JUNCTION_REMOVE_RESULT', JSON.stringify({ removed, guarded, wt: wtPath }));
+  process.exit(hasFailure ? 2 : 0);
+}
+
+function linkDir(target, linkPath, label) {
+  if (fs.existsSync(linkPath)) {
+    const st = fs.lstatSync(linkPath);
+    if (st.isSymbolicLink()) {
+      const existing = normLinkTarget(fs.readlinkSync(linkPath));
+      if (existing === path.resolve(target)) {
+        skipped.push(label);
+        return;
+      }
+      fs.unlinkSync(linkPath); // 指向不同 → 重建
+    } else if (st.isDirectory()) {
+      warned.push(label + '（存在同名物理目录，未覆盖）');
+      return;
+    } else {
+      fs.unlinkSync(linkPath); // 同名文件，罕见，重建
+    }
+  }
+  fs.mkdirSync(path.dirname(linkPath), { recursive: true });
+  try {
+    if (process.platform === 'win32') {
+      fs.symlinkSync(path.resolve(target), linkPath, 'junction');
+    } else {
+      fs.symlinkSync(path.resolve(target), linkPath, 'dir');
+    }
+    linked.push(label);
+  } catch (e) {
+    console.error('❌ junction 失败 ' + label + ' — ' + e.message);
+    hasFailure = true;
+  }
+}
+
+function copyFile(target, dest, label) {
+  if (fs.existsSync(dest) && fs.existsSync(target) &&
+      fs.readFileSync(dest, 'utf-8') === fs.readFileSync(target, 'utf-8')) {
+    skipped.push(label);
+    return;
+  }
+  try {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(target, dest);
+    copied.push(label);
+  } catch (e) {
+    console.error('❌ 复制失败 ' + label + ' — ' + e.message);
+    hasFailure = true;
+  }
+}
+
+for (const root of CONFIG_ROOTS) {
+  const srcRoot = path.join(wsRoot, root);
+  if (!fs.existsSync(srcRoot) || !fs.statSync(srcRoot).isDirectory()) continue;
+
+  for (const sub of CONTENT_SUBDIRS) {
+    const src = path.join(srcRoot, sub);
+    if (!fs.existsSync(src) || !fs.statSync(src).isDirectory()) continue;
+    linkDir(src, path.join(wtPath, root, sub), root + '/' + sub);
+  }
+
+  for (const file of (CONTENT_FILES[root] || [])) {
+    const src = path.join(srcRoot, file);
+    if (!fs.existsSync(src) || !fs.statSync(src).isFile()) continue;
+    copyFile(src, path.join(wtPath, root, file), root + '/' + file);
+  }
+}
+
+if (linked.length === 0 && copied.length === 0 && skipped.length === 0 && warned.length === 0) {
+  console.log('ℹ️  空间根无 AI 配置目录，跳过（cbb setup 选择工具后再装）');
+} else {
+  if (linked.length) console.log('✅ junction：' + linked.join(', '));
+  if (copied.length) console.log('✅ 复制：' + copied.join(', '));
+  if (skipped.length) console.log('⏭️  已就绪：' + skipped.join(', '));
+  if (warned.length) console.log('⚠️  ' + warned.join('；'));
+}
+
+console.log('---');
+console.log('JUNCTION_RESULT', JSON.stringify({ linked, copied, skipped, warned, wt: wtPath }));
+process.exit(hasFailure ? 2 : 0);