@jspg-ai/coding-bb 0.0.3-beta.31 → 0.0.3-beta.33

package/cbb/dev-standards/rules/cbb-ai-behavior.md

@@ -107,7 +107,7 @@ trigger: always_on
 
 - 就地切分支：根 + 各涉及应用 `.codespace/<app>/` 同名 `checkout -b`（基线 = `origin/<main>`，经 `cbb-local-mode` 技能执行）
 - 当前会话原地开发，相对路径原样生效；**一次只承载一个需求**（独占本地检出；期间并行新需求走 worktree 模式，互不干扰）
-- 收尾：MR 合并后各参与仓库 `checkout main && pull && 删分支`
+- 收尾（收尾合并门禁，ADR 0007）：`merge-branches.js --check` 判定已合并；未合并须三选一（提 MR / 直合并 `--allow-checkout` / 确认废弃）后方可收尾；各参与仓库 `checkout main && pull && 删分支`
 
 **模式二 · worktree 模式（并行 / 隔离）：**
 
@@ -117,8 +117,9 @@ trigger: always_on
 **基准与防线（两模式共同，ADR 0002）：**
 
 - **基准 = `origin/main`（唯一真相源）；`.codespace/<app>/` 的检出 = 视图**——本地模式可暂态被需求分支占用，收尾恢复
-- **严禁直接在任何 main 检出上提交载荷**：分支感知 pre-commit hook 机械拦截（workspace 仓库仅放行控制面白名单：`CBB-WORKSPACE.json` / `.gitignore` / `AGENTS.md` / `openspec/config.yaml` / `openspec/schemas/**`；应用仓库 main 全拦）——**被拦是防线生效，不是故障**；`--no-verify` 绕过仅限用户显式要求
-- 远端推送唯一出口 = `cbb-worktree-push`（init 创建流程零远端操作，lazy push；空分支尸体不存在）
+- **严禁直接在任何 main 检出上提交载荷**：分支感知 pre-commit hook 机械拦截（workspace 仓库仅放行控制面白名单：`CBB-WORKSPACE.json` / `.gitignore` / `AGENTS.md` / `openspec/config.yaml` / `openspec/schemas/**`；应用仓库 main 全拦；**merge 提交（`MERGE_HEAD` 存在）放行**，见 ADR 0007）——**被拦是防线生效，不是故障**；`--no-verify` 绕过仅限用户显式要求
+- 需求分支推送唯一出口 = `cbb-worktree-push`（init 创建流程零远端操作，lazy push）；推送后可选提 MR 或**直接合并**（`merge-branches.js`，主干 / 测试分支，ADR 0008）；收尾合并门禁同源（ADR 0007）
+- **收尾合并门禁（ADR 0007）**：两模式收尾均须每仓库"已合并"（`safety-check` / `merge-branches.js --check` 判定）；未合并三选一——提 MR / 直合并 / 确认废弃（远程重命名 `<分支>-deprecated`）；交付完成自动删本地+远程分支
 - **模式误判零代价**：本地模式中途要并行/隔离 → 重跑 `cbb-worktree-init`（分支已存在自动复用，提交随身带走）
 
 **三时刻对齐（agent 必须遵守）：**
@@ -129,7 +130,7 @@ trigger: always_on
 
 **读基准代码约定：** 本地模式进行中，工作区是开发态而非基准——要读"main 现状"先确认检出分支，或直接 `git show main:<path>` / `git diff main`；不要默认工作区即基准。
 
-**检验标准：** 任何 main 检出上无载荷提交（hook 兜底，git log 可机械审计）；本地模式收尾后全部仓库回主干且 clean；worktree 模式的变更产物只出现在需求工作树内；远端分支只经 push 技能产生。
+**检验标准：** 任何 main 检出上无载荷提交（hook 兜底，git log 可机械审计；merge 提交除外）；本地模式收尾后全部仓库回主干且 clean；worktree 模式的变更产物只出现在需求工作树内；需求分支只经 push 技能产生；**未合并且非废弃的分支无法通过收尾（门禁兜底）**。
 
 ---
 

package/cbb/lib/install/claude-code.js

@@ -4,8 +4,8 @@
  * 将编码规范分发到 .claude/rules/ 目录
  *
  * 退市（selectable: false）：团队当前不使用 Claude Code，不在安装面板提供。
- * 适配器代码与全部能力保留（含用户级 settings hook）；先前已安装的空间按
- * .last-tools 记录**粘性维护**（见 tool-selection.js），内容不被清理。
+ * 适配器代码与全部能力保留（含用户级 settings hook）；旧记录中的遗留内容
+ * 不在勾选范围时随清单差集与用户级差集清理移除（ADR 0006）。
  * 恢复入口：删掉 selectable 即可重新出现在面板（决策：不留参数开关）。
  */
 
@@ -22,6 +22,6 @@ module.exports = {
   settingsFile: path.join(os.homedir(), '.claude', 'settings.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],
-  // 退市：不在安装面板提供（代码保留，存量空间粘性维护）
+  // 退市：不在安装面板提供（代码保留；旧记录遗留随清单/用户级差集清理，ADR 0006）
   selectable: false,
 };

package/cbb/lib/install/init.js

@@ -105,7 +105,7 @@ const agentsNav = require('./agents-nav');
 // 命令 → skill 形态转换（commandsAsSkills 适配器，当前仅 MiniMax Code）
 const commandSkill = require('./command-skill');
 
-// 工具选择策略（退市工具不在面板提供 + 存量粘性保留）
+// 工具选择策略（退市工具不在面板提供；勾选范围即权威，ADR 0006）
 const toolSelection = require('./tool-selection');
 
 /** 适配器的 hook 方言参数（Trae 需顶层 version 字段等差异） */
@@ -384,10 +384,7 @@ async function selectTools(isUpgrade) {
       .map(i => selectable[i]);
   }
 
-  // 退市但该空间旧记录里有的工具：粘性保留（继续维护，不因退市清删其内容）
-  result = toolSelection.carryOverRetired(adapters, result, lastTools);
-
-  // 保存本次选择（含粘性保留项，避免记录丢失导致下次被清理），供下次运行时预选
+  // 保存本次选择（勾选范围即权威，供下次运行时预选）
   saveLastTools(result);
   return result;
 }
@@ -1054,7 +1051,8 @@ async function init(targetDir, options = {}) {
     fromRecord = true;
   } else if (isNonInteractive) {
     const lastTools = readLastTools();
-    const reused = lastTools ? adapters.filter(a => lastTools.has(a.name)) : [];
+    // 旧记录只用于预选可选项——历史遗留的退市工具不并回（ADR 0006：勾选范围即权威）
+    const reused = lastTools ? toolSelection.selectableAdapters(adapters).filter(a => lastTools.has(a.name)) : [];
     selectedAdapters = reused.length > 0 ? reused : toolSelection.selectableAdapters(adapters);
     fromRecord = reused.length > 0;
     if (yes && process.stdin.isTTY) {
@@ -1066,19 +1064,10 @@ async function init(targetDir, options = {}) {
     selectedAdapters = await selectTools(isUpgrade);
   }
 
-  // 退市工具粘性保留（面板不出现，但本空间旧记录里有 → 继续维护，内容不被清理）。
-  // 覆盖面板外入口：setup 预设（presetAdapters）与非交互记录沿用；交互面板已在 selectTools 内并过。
-  const lastToolsForDir = readLastTools();
-  const withRetired = toolSelection.carryOverRetired(adapters, selectedAdapters, lastToolsForDir);
-  const retiredKept = toolSelection.retiredNames(withRetired);
-  if (retiredKept.length > 0) {
-    log(`保留上次选择的退市工具：${retiredKept.join('、')}（当前不在安装面板提供，内容继续维护）`, 'dim');
-  }
-  selectedAdapters = withRetired;
+  // 退市工具不粘性保留（ADR 0006）：选择集即权威，旧记录里的退市工具随清单差集清理
 
-  // 业务空间根记录本次选择，供 cbb update 等非交互场景沿用；
-  // 沿用旧记录时同样落盘，使历史工具名（codebuddy → workbuddy）归一化自愈
-  if (isWorkspaceRoot && fromRecord) {
+  // 本次选择落盘（沿用旧记录时同样落盘：归一化历史工具名 + 剔除退市遗留记录）
+  if (fromRecord) {
     saveLastTools(selectedAdapters);
   }
 
@@ -1871,8 +1860,10 @@ function printSetupSummary(selected, selectedAdapters, parentDir) {
 /**
  * 安装用户级组件（与项目无关的内容，一次安装全局可用，幂等）。
  *
- * - 清单：~/.cbb/.user-components 记录本包管理的用户级路径
+ * - 清单：~/.cbb/.user-components 只记录**本次实装**的用户级路径
  * - 内容：check-update hook（settings 由 settingsManager 幂等管理）
+ * - 差集清理（ADR 0006）：不在本次目标集合内的适配器，其清单遗留路径、
+ *   本包版本检查 hook、本地插件一并移除（仅删本包标记项，不动用户自装内容）
  */
 const USER_MANIFEST_FILE = path.join(os.homedir(), '.cbb', '.user-components');
 // 装到用户级的工具 skills（与具体项目无关，任何会话都可能用到）。
@@ -1884,15 +1875,18 @@ async function setupUserLevelComponents(targetAdapters = toolSelection.selectabl
   const srcDir = path.join(SHARED_STANDARDS_DIR, 'cbb', 'tools');
   if (!fs.existsSync(srcDir)) return;
 
-  const managed = new Set();
+  // 旧清单仅作差集清理基准，不再并入 managed（ADR 0006：勾选范围即权威，
+  // 本次未实装的路径由下方差集移除，而非累积保留）
+  let oldPaths = [];
   const manifestDir = path.dirname(USER_MANIFEST_FILE);
   fs.mkdirSync(manifestDir, { recursive: true });
   if (fs.existsSync(USER_MANIFEST_FILE)) {
     try {
       const data = JSON.parse(fs.readFileSync(USER_MANIFEST_FILE, 'utf-8'));
-      (data.paths || []).forEach(p => managed.add(p));
+      oldPaths = data.paths || [];
     } catch (_) { /* ignore parse errors */ }
   }
+  const managed = new Set();
 
   const summaryParts = [];
 
@@ -1939,6 +1933,43 @@ async function setupUserLevelComponents(targetAdapters = toolSelection.selectabl
     summaryParts.push(`版本检查插件 → ${pluginHookAdapters.map(a => a.displayName).join('、')}`);
   }
 
+  // ── 用户级差集清理（ADR 0006：不在本次勾选范围内的工具，用户级组件一并移除）──
+  const targetNames = new Set(targetAdapters.map(a => a.name));
+
+  // 1) 清单路径差集：旧有新无 → 删除（仅本包管理路径，不碰用户自装内容）
+  const removedPaths = [];
+  oldPaths.forEach(relPath => {
+    if (!managed.has(relPath)) {
+      const target = path.join(home, relPath);
+      if (fs.existsSync(target)) {
+        removePath(target);
+        removedPaths.push(relPath);
+      }
+    }
+  });
+  if (removedPaths.length > 0) {
+    summaryParts.push(`移除清单遗留 ×${removedPaths.length}`);
+  }
+
+  // 2) 非目标适配器：摘除本包版本检查 hook（仅删 _managedBy: cbb 标记项，保留用户配置）
+  //    + 本地插件目录
+  const removedNames = [];
+  adapters.filter(a => !targetNames.has(a.name)).forEach(adapter => {
+    let touched = false;
+    if (adapter.settingsFile && adapter.hookEvents) {
+      if (settingsManager.removeHooks(adapter.settingsFile, adapter.hookEvents, hookOpts(adapter))) touched = true;
+      if (cleanLegacySettings(adapter)) touched = true;
+    }
+    if (adapter.pluginHook &&
+        pluginHookManager.remove({ dataDir: adapter.resolveDataDir(), ...adapter.pluginHook })) {
+      touched = true;
+    }
+    if (touched) removedNames.push(adapter.displayName);
+  });
+  if (removedNames.length > 0) {
+    summaryParts.push(`清理 ${removedNames.join('、')} 的用户级组件`);
+  }
+
   if (summaryParts.length > 0) step('✓', '用户级组件', summaryParts.join(' · '));
 
   const pkg = require(path.join(SHARED_STANDARDS_DIR, 'package.json'));
@@ -1955,9 +1986,10 @@ async function setupUserLevelComponents(targetAdapters = toolSelection.selectabl
  * worktree 管理入口与空间导航；旧子集清单升级时由清单差集机制自动补齐全量内容。
  */
 async function updateInstalled() {
-  // 用户级组件沿用本目录的工具选择（.last-tools），无记录或为空才回退全量
+  // 用户级组件沿用本目录的工具选择（.last-tools），无记录或为空才回退全量。
+  // 旧记录只预选可选项——历史遗留的退市工具不并回（ADR 0006）
   const lastTools = readLastTools();
-  const reused = lastTools ? adapters.filter(a => lastTools.has(a.name)) : [];
+  const reused = lastTools ? toolSelection.selectableAdapters(adapters).filter(a => lastTools.has(a.name)) : [];
   await setupUserLevelComponents(reused.length > 0 ? reused : toolSelection.selectableAdapters(adapters));
 
   const manifest = readManifest();

package/cbb/lib/install/minimax.js

@@ -19,7 +19,7 @@
  * 退市（selectable: false）：实测 MiniMax Code 不支持目录级 skill 与 command
  * （无项目级 commands 目录，skill 亦需插件形态承载），当前分发形态不可用。
  * 适配器代码与全部能力保留（备将来改走插件形态），但不在安装面板提供；
- * 已安装过（beta.29）的空间按 .last-tools 记录**粘性维护**，内容不被清理。
+ * 旧记录中的遗留内容不在勾选范围时随清单差集与用户级差集清理移除（ADR 0006）。
  */
 
 const path = require('path');
@@ -55,6 +55,6 @@ module.exports = {
     timeout: 10,
   },
   resolveDataDir,
-  // 退市：不在安装面板提供（代码保留，存量空间粘性维护）
+  // 退市：不在安装面板提供（代码保留；旧记录遗留随清单/用户级差集清理，ADR 0006）
   selectable: false,
 };

package/cbb/lib/install/tool-selection.js

@@ -1,20 +1,18 @@
 'use strict';
 
 /**
- * 工具选择策略：安装面板的可见集合 + 退市工具的粘性保留。
+ * 工具选择策略：安装面板的可见集合（未退市适配器）。
  *
  * 背景（2026-09-28 决策）：MiniMax Code 实测不支持目录级 skill 与 command、
  * Claude Code 团队当前未用，两者**退市**——适配器与全部能力保留（见各适配器
  * 文件头），仅不在 `cbb setup` / `cbb update` 的安装面板提供。
  *
- * 两条规则：
- *  1. **可选项**（selectableAdapters）：面板项、非交互全选兜底、setup 默认预选、
- *     用户级组件新装，一律只用未退市适配器（`selectable !== false`）；
- *  2. **粘性保留**（carryOverRetired）：某空间的 `.last-tools` 记录过退市工具
- *     （即确曾安装），则继续纳入本次安装/升级集合——面板不出现，内容不因退市
- *     被清单差集清删；`.last-tools` 一并保持该记录，避免记录丢失导致下次清理。
- *
- * 恢复入口：删掉适配器的 `selectable: false` 即回到面板（决策：不留参数开关）。
+ * 退市工具的取舍（ADR 0006，反转 beta.30 的粘性保留决策）：
+ *  - 退市工具**不进**选择集：面板、非交互沿用、setup 预设、用户级组件，
+ *     一律只用未退市适配器（`selectable !== false`）；
+ *  - 勾选范围即权威：`.last-tools` 只如实记录本次实际选择，不在范围内的
+ *     工具内容（含用户级 hook / 插件）由清单差集与用户级差集清理移除；
+ *  - 恢复入口：删掉适配器的 `selectable: false` 即回到面板。
  */
 
 /** 面板/默认可选适配器（未标 selectable: false 的全部） */
@@ -22,24 +20,4 @@ function selectableAdapters(adapters) {
   return adapters.filter(a => a.selectable !== false);
 }
 
-/**
- * 把「本空间旧记录中的退市工具」并入选择结果（按注册表顺序追加，去重）。
- * @param {Array} adapters 注册表全量
- * @param {Array} selected 本次选择（面板 / 预设 / 记录沿用）
- * @param {Set<string>|null} lastTools 该空间的旧工具记录（.last-tools）
- * @returns {Array} 并入后的有序数组（无退市工具需保留时原样返回）
- */
-function carryOverRetired(adapters, selected, lastTools) {
-  if (!lastTools || lastTools.size === 0) return selected;
-  const selectedNames = new Set(selected.map(a => a.name));
-  const carried = adapters.filter(a =>
-    a.selectable === false && lastTools.has(a.name) && !selectedNames.has(a.name));
-  return carried.length > 0 ? selected.concat(carried) : selected;
-}
-
-/** 结果集中退市工具的显示名（供安装输出提示，如「保留上次选择的 Claude Code」） */
-function retiredNames(selected) {
-  return selected.filter(a => a.selectable === false).map(a => a.displayName);
-}
-
-module.exports = { selectableAdapters, carryOverRetired, retiredNames };
+module.exports = { selectableAdapters };

package/cbb/lib/utils/githook.js

@@ -9,7 +9,8 @@
  *     CBB-WORKSPACE.json / .gitignore / AGENTS.md / openspec/config.yaml /
  *     openspec/schemas/** / .cbb/**（配置变更与 cbb update 部署物，直改即推）；
  *     另放行旧名 workspace-config.json 的删除条目（仅用于一次性更名迁移）
- *   - 应用仓库在主干上 → 全拦（交付只走 MR）
+ *   - 主干上处于 merge 进行中（MERGE_HEAD 存在）→ 放行（ADR 0007 合并门禁的直合并通道）
+ *   - 应用仓库在主干上 → 全拦（交付只走 MR；merge 进行中的合并提交除外）
  *   - 逃生口：用户显式 git commit --no-verify（AI 侧纪律禁止自动绕过）
  *
  * 本模块是 hook 源码的唯一真源；cbb/worktrees/_shared/scripts/install-git-hook.js
@@ -32,7 +33,7 @@ const BACKUP_SUFFIX = '.cbb-backup';
 const PRE_COMMIT_SOURCE = [
   '#!/usr/bin/env node',
   '// managed-by-cbb v1 —— 分支感知提交防线（ADR 0002）',
-  '// main 上：workspace 仓库只放行控制面白名单，应用仓库全拦；非 main 一律放行。',
+  '// main 上：workspace 只放行控制面白名单，应用全拦（merge 提交除外）；非 main 一律放行。',
   '// 绕过逃生口仅限用户显式 git commit --no-verify。',
   "const { execSync } = require('child_process');",
   "const fs = require('fs');",
@@ -56,6 +57,9 @@ const PRE_COMMIT_SOURCE = [
   '// 非主干（含 detached / 探测失败）→ 放行',
   'if (!main || branch !== main) process.exit(0);',
   '',
+  '// merge 进行中（MERGE_HEAD 存在）→ 显式人工合并提交，放行（ADR 0007 合并门禁）',
+  "if (run('git rev-parse --verify --quiet MERGE_HEAD')) process.exit(0);",
+  '',
   "// 主干上的提交：收集 staged 变更（空提交放行）",
   "const staged = run('git diff --cached --name-only') || '';",
   "const files = staged.split(/\\r?\\n/).filter(Boolean);",

package/cbb/worktrees/_shared/scripts/check-unarchived.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * 未归档 change 检查（共享脚本，真源：cbb/worktrees/_shared/scripts/）
+ *
+ * 供 cbb-worktree-close（收尾安全评估）与 cbb-worktree-push（Step 7 直合并前置，ADR 0008）调用。
+ *
+ * 用法：node check-unarchived.js <ws_root> [branch]
+ *
+ * 双扫（ADR 0002）：
+ *   - <ws_root>/openspec/changes/                       → 空间根当前检出（本地模式产物 / 空间根遗留）
+ *   - <ws_root>/.worktrees/worktree-<branch>/openspec/changes/ → worktree 模式产物
+ *     （branch 未传时跳过 worktree 扫描，保持旧调用兼容）
+ *
+ * 输出：changes 为两处合集（去重）；detail 标注每个 change 的来源
+ *       （'root' / 'worktree'，同名两处共存时为 'both'）。
+ * 本检查为信息收集性质，不阻断流程。
+ *
+ * 退出码：
+ *   0 - 检查完成（无论是否有未归档 change）
+ *   1 - 参数错误
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const branch = process.argv[3];
+
+if (!wsRoot) {
+  console.error('Usage: node check-unarchived.js <ws_root> [branch]');
+  process.exit(1);
+}
+
+/**
+ * 扫描单个 changes 目录，返回未归档 change 名数组（目录不存在返回 []）。
+ */
+function scanDir(changesDir) {
+  if (!fs.existsSync(changesDir)) return [];
+  let entries;
+  try {
+    entries = fs.readdirSync(changesDir, { withFileTypes: true });
+  } catch (e) {
+    console.error('Failed to read ' + changesDir + ':', e.message);
+    return [];
+  }
+  return entries
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+    .map(e => e.name);
+}
+
+const rootChanges = scanDir(path.join(wsRoot, 'openspec', 'changes'));
+
+const worktreeDir = branch
+  ? path.join(wsRoot, '.worktrees', 'worktree-' + branch, 'openspec', 'changes')
+  : null;
+const wtChanges = worktreeDir ? scanDir(worktreeDir) : [];
+
+const detail = {};
+for (const name of rootChanges) detail[name] = 'root';
+for (const name of wtChanges) {
+  detail[name] = detail[name] === 'root' ? 'both' : 'worktree';
+}
+
+const changes = Object.keys(detail).sort();
+
+if (rootChanges.length === 0 && wtChanges.length === 0) {
+  console.log('ℹ️  未发现未归档 change（根与 worktree' + (worktreeDir ? '' : '（未指定 branch，跳过）') + '均无）');
+} else {
+  console.log('ℹ️  未归档 change：' + (changes.join(', ') || '无'));
+  for (const name of changes) {
+    console.log('    - ' + name + '（来源：' + detail[name] + '）');
+  }
+}
+
+console.log('UNARCHIVED_RESULT', JSON.stringify({ changes, detail }));
+process.exit(0);

package/cbb/worktrees/_shared/scripts/deprecate-branches.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * 收尾合并门禁 —— 废弃分支出口（ADR 0007）
+ *
+ * 用户在门禁处确认"分支废弃、不再交付"后，把各参与仓库远端的需求分支重命名为
+ * <branch>-deprecated（保留历史、去掉占用中的旧名），**不删除任何提交**。
+ * 本地分支保持原名不动；未推送的仓库（远端无该分支）跳过。
+ *
+ * 用法：
+ *   node deprecate-branches.js <ws_root> <branch> [--apps a,b]
+ *
+ * 退出码：0 全部成功（含 skipped）/ 1 参数错误 / 2 存在失败
+ * 末行：DEPRECATE_RESULT [...]
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function run(cmd, cwd) {
+  try {
+    return {
+      ok: true,
+      out: execSync(cmd, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        timeout: 120000,
+        env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+      }).trim(),
+    };
+  } catch (e) {
+    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
+  }
+}
+
+function loadApps(wsRoot) {
+  try {
+    const config = JSON.parse(fs.readFileSync(path.join(wsRoot, 'CBB-WORKSPACE.json'), 'utf-8'));
+    return Array.isArray(config.apps) ? config.apps : [];
+  } catch (e) {
+    return [];
+  }
+}
+
+/** 对单个仓库执行废弃重命名 */
+function deprecateRepo(name, repo, branch) {
+  const newName = branch + '-deprecated';
+  const rec = { name, status: 'skipped', detail: null };
+  if (!fs.existsSync(path.join(repo, '.git'))) {
+    rec.detail = 'no-repo';
+    return rec;
+  }
+  const remote = run('git remote', repo);
+  if (!remote.ok || !remote.out) {
+    rec.detail = 'no-remote';
+    return rec;
+  }
+  const r = remote.out.split(/\r?\n/)[0];
+  // 仅重命名远端确实存在的分支
+  const exists = run('git ls-remote --heads "' + r + '" "refs/heads/' + branch + '"', repo);
+  if (!exists.ok || !exists.out) {
+    rec.detail = 'remote-has-no-branch';
+    return rec;
+  }
+  const pushNew = run('git push "' + r + '" "refs/heads/' + branch + ':refs/heads/' + newName + '"', repo);
+  if (!pushNew.ok) {
+    rec.status = 'failed';
+    rec.detail = 'push-new-failed: ' + (pushNew.err || '').split(/\r?\n/)[0];
+    return rec;
+  }
+  const delOld = run('git push "' + r + '" --delete "' + branch + '"', repo);
+  if (!delOld.ok) {
+    rec.status = 'failed';
+    rec.detail = 'delete-old-failed: ' + (delOld.err || '').split(/\r?\n/)[0];
+    return rec;
+  }
+  rec.status = 'deprecated';
+  rec.detail = 'remote ' + branch + ' → ' + newName;
+  return rec;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const wsRoot = args[0];
+  const branch = args[1];
+
+  if (!wsRoot || !branch || branch.indexOf('--') === 0) {
+    console.error('Usage: node deprecate-branches.js <ws_root> <branch> [--apps a,b]');
+    process.exit(1);
+  }
+
+  const appsIdx = args.indexOf('--apps');
+  const appFilter = appsIdx >= 0
+    ? new Set((args[appsIdx + 1] || '').split(',').map(s => s.trim()).filter(Boolean))
+    : null;
+
+  const repos = [{ name: 'workspace', repo: wsRoot }];
+  for (const app of loadApps(wsRoot)) {
+    if (appFilter && !appFilter.has(app.name)) continue;
+    repos.push({ name: app.name, repo: path.join(wsRoot, '.codespace', app.name) });
+  }
+
+  const results = repos.map(rp => deprecateRepo(rp.name, rp.repo, branch));
+
+  results.forEach(r => {
+    console.log(r.status.toUpperCase() + ' ' + r.name + (r.detail ? ' — ' + r.detail : ''));
+  });
+
+  const ok = results.every(r => r.status !== 'failed');
+  console.log('---');
+  console.log('DEPRECATE_RESULT', JSON.stringify({ branch, new_name: branch + '-deprecated', results }));
+  process.exit(ok ? 0 : 2);
+}
+
+if (require.main === module) main();
+
+module.exports = { run, loadApps, deprecateRepo };

package/cbb/worktrees/_shared/scripts/install-git-hook.js

@@ -20,7 +20,7 @@ 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 仓库只放行控制面白名单，应用仓库全拦；非 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// 主干上的提交：收集 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";
+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);