@jspg-ai/coding-bb 0.0.3-beta.32 → 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/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);