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

package/cbb/worktrees/skills/cbb-worktree-init/scripts/create-worktrees.js

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * cbb-worktree-init 创建 Worktree（含自愈清理）
+ * cbb-worktree-init 创建 Worktree（自愈清理仅限元数据 prune）
  *
  * 用法：node create-worktrees.js <ws_root> <branch>
- *   （apps 由脚本内部从 <ws_root>/workspace-config.json 读取）
+ *   （apps 由脚本内部从 <ws_root>/CBB-WORKSPACE.json 读取）
  *
  * 行为：
- *   1. 自愈清理：prune + 物理目录清理
+ *   1. 自愈清理：仅 git worktree prune（元数据），**绝不删除任何物理目录**
+ *      （0.0.3-beta.11 事故修复：旧版按"不在 worktree list"负向推断递归删残留目录，
+ *        Windows 下 git 输出正斜杠路径与 realpathSync 反斜杠永不匹配，误删活跃 worktree）
  *   2. workspace worktree 创建（.worktrees/worktree-<branch>）
  *   3. 各 app worktree 创建（物理嵌套在 workspace worktree 内）
  *   4. 失败时输出回滚提示
@@ -15,7 +17,7 @@ require('./silence-popup');
  * 退出码：
  *   0 - 全部成功
  *   1 - 参数错误
- *   2 - workspace worktree 创建失败
+ *   2 - workspace worktree 创建失败（含目标目录存在但非有效 worktree 的残留场景）
  *   3 - 部分 app worktree 创建失败
  */
 
@@ -27,12 +29,19 @@ const wsRoot = process.argv[2];
 const branch = process.argv[3];
 
 if (!wsRoot || !branch) {
-  console.error('❌ 用法：node create-worktrees.js <ws_root> <branch>');
+  console.error('❌ 用法：node create-worktrees.js <ws_root> <branch> [--apps "app1,app2"]');
   process.exit(1);
 }
 
+// 可选 --apps 应用子集（逗号分隔；缺省 = 全量，ADR 0002 需求语境子集）
+let appFilter = null;
+const appsFlagIdx = process.argv.indexOf('--apps');
+if (appsFlagIdx >= 0) {
+  appFilter = new Set((process.argv[appsFlagIdx + 1] || '').split(',').map(s => s.trim()).filter(Boolean));
+}
+
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) return null;
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
@@ -40,12 +49,25 @@ function loadAppsFromConfig() {
   } catch (e) { return null; }
 }
 
-const apps = loadAppsFromConfig();
-if (!apps) {
-  console.error('❌ workspace-config.json 缺失或 apps 为空');
+const allApps = loadAppsFromConfig();
+if (!allApps) {
+  console.error('❌ CBB-WORKSPACE.json 缺失或 apps 为空');
   process.exit(1);
 }
 
+const apps = appFilter
+  ? allApps.filter(a => appFilter.has(a.name))
+  : allApps;
+
+if (appFilter) {
+  const unknown = [...appFilter].filter(n => !allApps.some(a => a.name === n));
+  if (unknown.length > 0) {
+    console.error('❌ --apps 中的应用不在 CBB-WORKSPACE.json：' + unknown.join(', '));
+    process.exit(1);
+  }
+  console.log('ℹ️  应用子集（' + apps.length + '/' + allApps.length + '）：' + apps.map(a => a.name).join(', '));
+}
+
 function run(cmd, cwd) {
   try {
     return { ok: true, out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).trim() };
@@ -54,52 +76,28 @@ function run(cmd, cwd) {
   }
 }
 
-// 1. 自愈清理
-console.log('=== 自愈清理 ===');
+// 1. 自愈清理（仅元数据：prune 只清理"目录已缺失/失效"的 worktree 注册项，不碰物理目录）
+console.log('=== 自愈清理（仅 prune 元数据，不删物理目录）===');
 
-// 1.1 prune 所有仓库
 const allRepos = [wsRoot, ...apps.map(a => path.join(wsRoot, '.codespace', a.name))];
 for (const repo of allRepos) {
   if (fs.existsSync(repo)) {
     run('git worktree prune', repo);
   }
 }
-console.log('✅ 已 prune 所有仓库的 worktree 元数据');
-
-// 1.2 清理 .worktrees/ 下无元数据的物理目录
-const worktreesDir = path.join(wsRoot, '.worktrees');
-if (fs.existsSync(worktreesDir)) {
-  const validWts = run('git worktree list --porcelain', wsRoot);
-  const validPaths = new Set();
-  if (validWts.ok) {
-    validWts.out.split('\n').forEach(line => {
-      if (line.startsWith('worktree ')) {
-        validPaths.add(line.substring(9).trim());
-      }
-    });
-  }
-
-  const entries = fs.readdirSync(worktreesDir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const dir = path.join(worktreesDir, entry.name);
-    let absDir;
-    try { absDir = fs.realpathSync(dir); } catch { continue; }
-    if (!validPaths.has(absDir)) {
-      try {
-        fs.rmSync(dir, { recursive: true, force: true });
-        console.log('🧹 已清理残留目录：' + entry.name);
-      } catch (e) {
-        console.log('⏳ 残留目录仍被占用，跳过：' + entry.name);
-      }
-    }
-  }
-}
+console.log('✅ 已 prune 所有仓库的 worktree 元数据（物理目录一律保留）');
 
 // 2. workspace worktree 创建
 console.log('=== 创建 Workspace Worktree ===');
 const wtDir = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
 if (fs.existsSync(wtDir)) {
+  if (!fs.existsSync(path.join(wtDir, '.git'))) {
+    console.error('❌ 目标目录已存在但不是有效 worktree（缺 .git 指针）：' + wtDir);
+    console.error('   可能是上次 close / init 中断的残留。本脚本不会自动删除任何目录，请二选一后重跑：');
+    console.error('   1) 执行 cbb-worktree-close 技能清理该需求');
+    console.error('   2) 手动删除上述目录后执行：git -C "' + wsRoot + '" worktree prune');
+    process.exit(2);
+  }
   console.log('⏭️  workspace worktree 已存在，复用：' + wtDir);
 } else {
   const created = run('git worktree add ".worktrees/worktree-' + branch + '" "' + branch + '"', wsRoot);
@@ -111,12 +109,13 @@ if (fs.existsSync(wtDir)) {
   console.log('✅ workspace worktree 已创建：' + wtDir);
 }
 
-// 3. apps worktree 创建（物理嵌套）
+// 3. apps worktree 创建（物理嵌套于 workspace worktree 的 .codespace/ 容器内，镜像主布局，ADR 0003）
 console.log('=== 创建 App Worktrees ===');
 const results = [];
 for (const app of apps) {
   const appPath = path.join(wsRoot, '.codespace', app.name);
-  const nestedWt = path.join(wtDir, app.name);
+  const nestedWt = path.join(wtDir, '.codespace', app.name);
+  const legacyWt = path.join(wtDir, app.name);
 
   if (fs.existsSync(nestedWt) && fs.existsSync(path.join(nestedWt, '.git'))) {
     console.log('⏭️  ' + app.name + ': 嵌套 worktree 已存在，复用');
@@ -124,8 +123,23 @@ for (const app of apps) {
     continue;
   }
 
-  // 防御性兜底：父目录不存在则创建
+  // 防御性兜底：容器目录不存在则创建
   fs.mkdirSync(path.dirname(nestedWt), { recursive: true });
+
+  // 存量迁移：≤beta.23 旧平铺布局 → .codespace/ 容器（worktree 平移，分支与提交随身带走）
+  if (fs.existsSync(legacyWt) && fs.existsSync(path.join(legacyWt, '.git'))) {
+    const moved = run('git worktree move "' + legacyWt + '" "' + nestedWt + '"', appPath);
+    if (moved.ok) {
+      console.log('🔁 ' + app.name + ': 旧平铺 worktree 已迁移到 .codespace/ 容器');
+      results.push({ name: app.name, status: 'migrated' });
+      continue;
+    }
+    console.error('❌ ' + app.name + ': 旧平铺 worktree 迁移失败（常见原因：目录被 IDE 等进程占用）：' + moved.err);
+    console.error('   请关闭占用 ' + legacyWt + ' 的程序后重跑本技能；或先执行 cbb-worktree-close 再重建');
+    results.push({ name: app.name, status: 'failed', error: moved.err });
+    continue;
+  }
+
   const created = run('git worktree add "' + nestedWt + '" "' + branch + '"', appPath);
   if (created.ok) {
     console.log('✅ ' + app.name + ': 嵌套 worktree 创建成功');

package/cbb/worktrees/skills/cbb-worktree-init/scripts/install-git-hook.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * 向指定 git 仓库安装分支感知 pre-commit hook（ADR 0002）。
+ *
+ * 真源：cbb/lib/utils/githook.js 的 PRE_COMMIT_SOURCE（本文件为部署到业务空间的自包含副本，
+ * 改动必须两处同步——本仓库内改真源后同步本文件，勿只改其一）。
+ *
+ * 用法（二选一）：
+ *   CLI：node install-git-hook.js <repoPath...>   —— 对每个仓库安装，输出 HOOK_RESULT
+ *   require：installTo(repoPath) → 'installed' | 'updated' | 'skipped-not-git'
+ *
+ * 供 cbb-worktree-init 的 sync-repos.js 兜底 clone 后调用（cbb setup 已装过，此处幂等补齐）。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const HOOK_MARKER = 'managed-by-cbb';
+const HOOK_FILE = 'pre-commit';
+const BACKUP_SUFFIX = '.cbb-backup';
+
+// 与 cbb/lib/utils/githook.js 的 buildPreCommitSource() 输出完全一致（构建时注入）
+const PRE_COMMIT_SOURCE = "#!/usr/bin/env node\n// managed-by-cbb v1 —— 分支感知提交防线（ADR 0002）\n// main 上：workspace 只放行控制面白名单，应用全拦（merge 提交除外）；非 main 一律放行。\n// 绕过逃生口仅限用户显式 git commit --no-verify。\nconst { execSync } = require('child_process');\nconst fs = require('fs');\nfunction run(cmd) {\n  try { return execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim(); }\n  catch (e) { return null; }\n}\nconst branch = run('git branch --show-current') || '';\n// 主干名：优先远端 HEAD 指向；探测失败按本地 main/master 存在性回退\nlet main = null;\nconst remotes = run('git remote');\nif (remotes) {\n  const r = remotes.split(/\\r?\\n/)[0];\n  const sym = run('git symbolic-ref \"refs/remotes/' + r + '/HEAD\"');\n  if (sym) main = sym.replace('refs/remotes/' + r + '/', '');\n}\nif (!main) {\n  if (run('git rev-parse --verify --quiet refs/heads/main')) main = 'main';\n  else if (run('git rev-parse --verify --quiet refs/heads/master')) main = 'master';\n}\n// 非主干（含 detached / 探测失败）→ 放行\nif (!main || branch !== main) process.exit(0);\n\n// merge 进行中（MERGE_HEAD 存在）→ 显式人工合并提交，放行（ADR 0007 合并门禁）\nif (run('git rev-parse --verify --quiet MERGE_HEAD')) process.exit(0);\n\n// 主干上的提交：收集 staged 变更（空提交放行）\nconst staged = run('git diff --cached --name-only') || '';\nconst files = staged.split(/\\r?\\n/).filter(Boolean);\nif (files.length === 0) process.exit(0);\n\n// 仓库类型：workspace 仓库 = 检出含 CBB-WORKSPACE.json（或旧名，改名过渡期识别）\nconst isWorkspace = fs.existsSync('CBB-WORKSPACE.json') || fs.existsSync('workspace-config.json');\n\nfunction deny(bad) {\n  console.error('[cbb-guard] 主干上拦截载荷提交（ADR 0002）：');\n  bad.forEach(f => console.error('  ' + f));\n  console.error('需求载荷须在需求分支上提交：本地模式先 git checkout -b <需求名>；worktree 模式在 .worktrees/ 工作树内提交。');\n  console.error('控制面白名单：CBB-WORKSPACE.json / .gitignore / AGENTS.md / openspec/config.yaml / openspec/schemas/** / .cbb/**');\n  console.error('如确需在主干提交，须由用户显式 git commit --no-verify。');\n  process.exit(1);\n}\n\nif (isWorkspace) {\n  // 旧名仅放行删除条目：更名迁移提交（git mv）会产生旧名删除 + 新名新增两条\n  const EXACT = new Set(['CBB-WORKSPACE.json', 'workspace-config.json', '.gitignore', 'AGENTS.md', 'openspec/config.yaml']);\n  const PREFIXES = ['openspec/schemas/', '.cbb/'];\n  const bad = files.filter(f => !EXACT.has(f) && !PREFIXES.some(p => f.indexOf(p) === 0));\n  if (bad.length) deny(bad);\n} else {\n  deny(files);\n}\nprocess.exit(0);\n";
+
+function isCbbHookContent(content) {
+  return typeof content === 'string' && content.includes(HOOK_MARKER);
+}
+
+function resolveHooksDir(repoPath) {
+  const gitDir = path.join(repoPath, '.git');
+  if (!fs.existsSync(gitDir)) return null;
+  const st = fs.statSync(gitDir);
+  if (!st.isDirectory()) return null; // worktree 检出（.git 为文件）：hook 由主仓库承担
+  return path.join(gitDir, 'hooks');
+}
+
+function installTo(repoPath) {
+  const dir = resolveHooksDir(repoPath);
+  if (!dir) return 'skipped-not-git';
+
+  const hookPath = path.join(dir, HOOK_FILE);
+  fs.mkdirSync(dir, { recursive: true });
+
+  if (fs.existsSync(hookPath)) {
+    const prev = fs.readFileSync(hookPath, 'utf-8');
+    if (isCbbHookContent(prev)) {
+      if (prev !== PRE_COMMIT_SOURCE) fs.writeFileSync(hookPath, PRE_COMMIT_SOURCE);
+      return 'updated';
+    }
+    fs.writeFileSync(hookPath + BACKUP_SUFFIX, prev); // 用户自有 hook：备份后接管
+  }
+  fs.writeFileSync(hookPath, PRE_COMMIT_SOURCE);
+  try { fs.chmodSync(hookPath, 0o755); } catch (_) { /* Windows 无压力 */ }
+  return 'installed';
+}
+
+module.exports = { installTo, isCbbHookContent, PRE_COMMIT_SOURCE };
+
+// CLI 形式：node install-git-hook.js <repoPath...>
+if (require.main === module) {
+  const targets = process.argv.slice(2);
+  if (targets.length === 0) {
+    console.error('Usage: node install-git-hook.js <repoPath...>');
+    process.exit(1);
+  }
+  const results = targets.map(p => ({ path: p, status: installTo(p) }));
+  results.forEach(r => console.log((r.status === 'skipped-not-git' ? '⚠️ ' : '✅ ') + r.path + ' → ' + r.status));
+  console.log('HOOK_RESULT', JSON.stringify(results));
+  process.exit(0);
+}

package/cbb/worktrees/skills/cbb-worktree-init/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);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/parse-config.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * cbb-worktree-init 读取并校验 workspace-config.json
+ * cbb-worktree-init 读取并校验 CBB-WORKSPACE.json
  *
  * 退出码：
  *   0 - 成功，输出应用列表 JSON
@@ -15,10 +15,10 @@ require('./silence-popup');
 const fs = require('fs');
 const path = require('path');
 
-const configPath = path.join(process.cwd(), 'workspace-config.json');
+const configPath = path.join(process.cwd(), 'CBB-WORKSPACE.json');
 
 if (!fs.existsSync(configPath)) {
-  console.error('❌ workspace-config.json 不存在');
+  console.error('❌ CBB-WORKSPACE.json 不存在');
   console.error('   请先在 cbb setup 阶段创建，或手动配置');
   console.error('---');
   console.error('CONFIG_MISSING');
@@ -29,7 +29,7 @@ let config;
 try {
   config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
 } catch (e) {
-  console.error('❌ workspace-config.json 解析失败：', e.message);
+  console.error('❌ CBB-WORKSPACE.json 解析失败：', e.message);
   console.error('   请检查 JSON 格式');
   console.error('---');
   console.error('CONFIG_INVALID');
@@ -38,8 +38,8 @@ try {
 
 const apps = config.apps || [];
 if (apps.length === 0) {
-  console.error('❌ workspace-config.json 中 apps 为空');
-  console.error('   请编辑 workspace-config.json 配置关联应用');
+  console.error('❌ CBB-WORKSPACE.json 中 apps 为空');
+  console.error('   请编辑 CBB-WORKSPACE.json 配置关联应用');
   console.error('---');
   console.error('CONFIG_EMPTY');
   process.exit(2);
@@ -61,7 +61,7 @@ for (const app of apps) {
   }
 }
 
-console.log('✅ workspace-config.json 有效（' + apps.length + ' 个应用）');
+console.log('✅ CBB-WORKSPACE.json 有效（' + apps.length + ' 个应用）');
 console.log('---');
 console.log('CONFIG_OK', JSON.stringify(apps));
 process.exit(0);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/push-branches.js

@@ -20,7 +20,7 @@ const fs = require('fs');
 const path = require('path');
 
 function loadAppsFromConfig(wsRoot) {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) return null;
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
@@ -40,7 +40,7 @@ function executePush(opts) {
   const branch = opts.branch;
   const apps = opts.apps != null ? opts.apps : loadAppsFromConfig(wsRoot);
   if (apps == null) {
-    throw new Error('workspace-config.json missing or apps empty');
+    throw new Error('CBB-WORKSPACE.json missing or apps empty');
   }
 
   const results = [];
@@ -68,7 +68,7 @@ function main() {
 
   const apps = loadAppsFromConfig(wsRoot);
   if (apps == null) {
-    console.error('❌ workspace-config.json 缺失或 apps 为空');
+    console.error('❌ CBB-WORKSPACE.json 缺失或 apps 为空');
     process.exit(1);
   }
 

package/cbb/worktrees/skills/cbb-worktree-init/scripts/push-core.js

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 推送核心模块
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/push-core.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init-worktree / extend-worktree / push-worktrees）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / push）。
  *
  * 公开 API：
  *   - tryExec(cmd, cwd, execImpl)             包装 execSync，统一返回 {ok, out|err}

package/cbb/worktrees/skills/cbb-worktree-init/scripts/silence-popup.js

@@ -4,7 +4,7 @@
 // koffi is resolved from cbb global install (no local node_modules needed).
 //
 // 唯一真源：cbb/worktrees/_shared/scripts/silence-popup.js
-// 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
+// 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / close / push / local-mode）。
 // skill 内同目录引用：脚本第一行 `require('./silence-popup')`。
 if (process.platform === 'win32') {
   try {

package/cbb/worktrees/skills/cbb-worktree-init/scripts/sync-repos.js

@@ -4,7 +4,7 @@ require('./silence-popup');
  * cbb-worktree-init 同步 .codespace/ 仓库
  *
  * 用法：node sync-repos.js <ws_root>
- *   - ws_root: 工作空间根绝对路径（apps 从 <ws_root>/workspace-config.json 读取）
+ *   - ws_root: 工作空间根绝对路径（apps 从 <ws_root>/CBB-WORKSPACE.json 读取）
  *
  * 对每个 app：
  *   - .codespace/<name>/.git 存在 → fetch --all
@@ -19,6 +19,7 @@ require('./silence-popup');
 const { execSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const { installTo: installGitHook } = require('./install-git-hook');
 
 const wsRoot = process.argv[2];
 
@@ -28,23 +29,23 @@ if (!wsRoot) {
 }
 
 /**
- * 从 workspace-config.json 读取 apps（避免 shell 字符串传递中的转义问题）
+ * 从 CBB-WORKSPACE.json 读取 apps（避免 shell 字符串传递中的转义问题）
  */
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) {
-    console.error('❌ workspace-config.json 不存在：' + configPath);
+    console.error('❌ CBB-WORKSPACE.json 不存在：' + configPath);
     return null;
   }
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
     if (!config.apps || !Array.isArray(config.apps) || config.apps.length === 0) {
-      console.error('❌ workspace-config.json 中 apps 为空');
+      console.error('❌ CBB-WORKSPACE.json 中 apps 为空');
       return null;
     }
     return config.apps;
   } catch (e) {
-    console.error('❌ workspace-config.json 解析失败：' + e.message);
+    console.error('❌ CBB-WORKSPACE.json 解析失败：' + e.message);
     return null;
   }
 }
@@ -77,7 +78,10 @@ for (const app of apps) {
     // 不存在：clone
     try {
       execSync('git clone -q "' + app.repo + '" "' + target + '"', { stdio: 'pipe' });
-      console.log('✅ ' + app.name + ': 代码已拉取（clone）');
+      // 兜底 clone 出的应用同步装分支感知 pre-commit hook（ADR 0002；
+      // cbb setup 首次 clone 已装，此处幂等补齐）
+      installGitHook(target);
+      console.log('✅ ' + app.name + ': 代码已拉取（clone + 提交防线 hook）');
       results.push({ name: app.name, status: 'cloned' });
     } catch (e) {
       console.error('❌ ' + app.name + ': clone 失败 — ' + app.repo);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/update-gitignore.js

@@ -7,8 +7,8 @@ require('./silence-popup');
  *
  * 行为：
  *   1. stash 当前未提交修改（仅 untracked 时不产生 stash）
- *   2. 目标分支不存在则从 HEAD 创建（首跑时分支尚未由 create-branches.js 建立，
- *      顺序无关自愈；create-branches.js 后续会报 reused）
+ *   2. 目标分支不存在则从 <remote>/<main> 创建（首跑时分支尚未由 create-branches.js 建立，
+ *      顺序无关自愈；create-branches.js 后续会报 reused；基线不取 HEAD，见 ADR 0002）
  *   3. 切换到目标分支
  *   4. 检查 .worktrees/ 和 .codespace/ 是否在 .gitignore，缺失则添加并提交
  *   5. 切回原分支
@@ -81,16 +81,28 @@ if (status.ok && status.out) {
   console.log('ℹ️  无未提交修改，跳过 stash');
 }
 
-// 2.1 目标分支不存在则从 HEAD 创建（Step 3.2 先于 Step 3.3 执行时分支尚未建立）
+// 2.1 目标分支不存在则创建（Step 3.2 先于 Step 3.3 执行时分支尚未建立）
+// 基线取 <remote>/<main>（ADR 0002，与 create-branches.js 一致）：本地模式进行中根可能检出在
+// feature 分支，从 HEAD 建会把未合并的开发态带进新分支；无 remote 时回退 HEAD
 const branchList = run('git branch --list "' + branch + '"', wsRoot);
 if (branchList.ok && !branchList.out) {
-  const create = run('git branch "' + branch + '"', wsRoot);
+  const remoteOut = run('git remote', wsRoot);
+  let base = 'HEAD';
+  if (remoteOut.ok && remoteOut.out) {
+    const r = remoteOut.out.split(/\r?\n/)[0];
+    const symbolic = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', wsRoot);
+    const main = (symbolic.ok && symbolic.out)
+      ? symbolic.out.replace('refs/remotes/' + r + '/', '')
+      : 'main';
+    base = r + '/' + main;
+  }
+  const create = run('git branch "' + branch + '" "' + base + '"', wsRoot);
   if (!create.ok) {
     console.error('❌ 创建分支 ' + branch + ' 失败：' + create.err);
     if (stashed) run('git stash pop', wsRoot);
     process.exit(2);
   }
-  console.log('✅ 分支 ' + branch + ' 不存在，已从 HEAD 创建');
+  console.log('✅ 分支 ' + branch + ' 不存在，已从 ' + base + ' 创建');
 }
 
 // 3. 切换到目标分支