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

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

@@ -99,39 +99,6 @@ trigger: always_on
 
 **检验标准：** 用户从未因"AI 直接改了代码没打招呼"而感到意外。
 
-## 8. 业务空间开发模式（双模式，用户选择制）
-
-**仅当工作目录是业务空间根（存在 `CBB-WORKSPACE.json` 且 `.git` 为目录）时生效。空间支持两种开发模式，能力对称（都能修改 workspace 内容与应用代码、都强制分支隔离、交付都走 MR），由用户显式选择，agent 只给推荐不代决。**
-
-**模式一 · 本地模式（单线程快改，当前会话就地干）：**
-
-- 就地切分支：根 + 各涉及应用 `.codespace/<app>/` 同名 `checkout -b`（基线 = `origin/<main>`，经 `cbb-local-mode` 技能执行）
-- 当前会话原地开发，相对路径原样生效；**一次只承载一个需求**（独占本地检出；期间并行新需求走 worktree 模式，互不干扰）
-- 收尾（收尾合并门禁，ADR 0007）：`merge-branches.js --check` 判定已合并；未合并须三选一（提 MR / 直合并 `--allow-checkout` / 确认废弃）后方可收尾；各参与仓库 `checkout main && pull && 删分支`
-
-**模式二 · worktree 模式（并行 / 隔离）：**
-
-- `cbb-worktree-init` 建隔离 worktree（AI 配置内容子目录已 junction 就位），**开发会话开进 `.worktrees/worktree-<需求名>/`**，可多需求并行；app 检出收拢在 `<wt>/.codespace/<app>/`——**镜像空间根布局**（`.codespace/<app>/...` 相对路径两模式通用，ADR 0003）
-- 根会话保留作控制面（worktree 生灭、`cbb update` 等空间级操作）；**会话形态按工具定，能自动则 agent 亲自做**：OpenCode 桌面端 = agent 自动把会话切进/切出 worktree（`session_move`，上下文保留、不列入用户待办，空间根路径在案供回切）；无会话搬移能力的桌面端 = 用户手动切根；CLI/TUI = 新开会话进 worktree
-
-**基准与防线（两模式共同，ADR 0002）：**
-
-- **基准 = `origin/main`（唯一真相源）；`.codespace/<app>/` 的检出 = 视图**——本地模式可暂态被需求分支占用，收尾恢复
-- **严禁直接在任何 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 必须遵守）：**
-
-1. **开工前——状态自检**（`cbb-local-mode` 的 `check-local-state.js`）：干净态零交互直接开工；**遗留态（别的需求未收尾，任一仓库检出在非主干分支）必须让用户四选一**（继续 / 先收尾 / 升级 worktree / 丢弃），不得自行决定
-2. **开工时——布局确认**：向用户展示参与仓库与分支名，确认后执行
-3. **进行中——插单归属**：用户插入非本需求的改动，先确认归属（并入 / 收尾后处理 / 转 worktree），不得静默混入
-
-**读基准代码约定：** 本地模式进行中，工作区是开发态而非基准——要读"main 现状"先确认检出分支，或直接 `git show main:<path>` / `git diff main`；不要默认工作区即基准。
-
-**检验标准：** 任何 main 检出上无载荷提交（hook 兜底，git log 可机械审计；merge 提交除外）；本地模式收尾后全部仓库回主干且 clean；worktree 模式的变更产物只出现在需求工作树内；需求分支只经 push 技能产生；**未合并且非废弃的分支无法通过收尾（门禁兜底）**。
-
 ---
 
 **这些准则生效的标志：** diff 中不必要的改动减少、不会因过度设计而重写、澄清问题在实现前而非出错后提出。

package/cbb/dev-standards/rules/cbb-workspace-discipline.md

@@ -0,0 +1,36 @@
+---
+trigger: always_on
+---
+
+# 业务空间开发纪律（双模式，用户选择制）
+
+**仅当工作目录是业务空间根（存在 `CBB-WORKSPACE.json` 且 `.git` 为目录）时生效。空间支持两种开发模式，能力对称（都能修改 workspace 内容与应用代码、都强制分支隔离、交付均有 MR 与直合并两条通道，ADR 0007/0008），由用户显式选择，agent 只给推荐不代决。**
+
+**模式一 · 本地模式（单线程快改，当前会话就地干）：**
+
+- 就地切分支：根 + 各涉及应用 `.codespace/<app>/` 同名 `checkout -b`（基线 = `origin/<main>`，经 `cbb-local-mode` 技能执行）
+- 当前会话原地开发，相对路径原样生效；**一次只承载一个需求**（独占本地检出；期间并行新需求走 worktree 模式，互不干扰）
+- 收尾（收尾合并门禁，ADR 0007）：`merge-branches.js --check` 判定已合并；未合并须三选一（提 MR / 直合并 `--allow-checkout` / 确认废弃）后方可收尾；各参与仓库 `checkout main && pull && 删分支`
+
+**模式二 · worktree 模式（并行 / 隔离）：**
+
+- `cbb-worktree-init` 建隔离 worktree（AI 配置内容子目录已 junction 就位），**开发会话开进 `.worktrees/worktree-<需求名>/`**，可多需求并行；app 检出收拢在 `<wt>/.codespace/<app>/`——**镜像空间根布局**（`.codespace/<app>/...` 相对路径两模式通用，ADR 0003）
+- 根会话保留作控制面（worktree 生灭、`cbb update` 等空间级操作）；**会话形态按工具定，能自动则 agent 亲自做**：OpenCode 桌面端 = agent 自动把会话切进/切出 worktree（`session_move`，上下文保留、不列入用户待办，空间根路径在案供回切）；无会话搬移能力的桌面端 = 用户手动切根；CLI/TUI = 新开会话进 worktree
+
+**基准与防线（两模式共同，ADR 0002）：**
+
+- **基准 = `origin/main`（唯一真相源）；`.codespace/<app>/` 的检出 = 视图**——本地模式可暂态被需求分支占用，收尾恢复
+- **严禁直接在任何 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 必须遵守）：**
+
+1. **开工前——状态自检**（`cbb-local-mode` 的 `check-local-state.js`）：干净态零交互直接开工；**遗留态（别的需求未收尾，任一仓库检出在非主干分支）必须让用户四选一**（继续 / 先收尾 / 升级 worktree / 丢弃），不得自行决定
+2. **开工时——布局确认**：向用户展示参与仓库与分支名，确认后执行
+3. **进行中——插单归属**：用户插入非本需求的改动，先确认归属（并入 / 收尾后处理 / 转 worktree），不得静默混入
+
+**读基准代码约定：** 本地模式进行中，工作区是开发态而非基准——要读"main 现状"先确认检出分支，或直接 `git show main:<path>` / `git diff main`；不要默认工作区即基准。
+
+**检验标准：** 任何 main 检出上无载荷提交（hook 兜底，git log 可机械审计；merge 提交除外）；本地模式收尾后全部仓库回主干且 clean；worktree 模式的变更产物只出现在需求工作树内；需求分支只经 push 技能产生；**未合并且非废弃的分支无法通过收尾（门禁兜底）**。

package/cbb/lib/install/init.js

@@ -396,7 +396,7 @@ function deployCoreRules(adapter, isUpgrade, managedPaths) {
   const rulesDest = path.join(TARGET_DIR, adapter.rulesDir);
   const action = isUpgrade ? '更新' : '安装';
 
-  const coreRules = ['cbb-coding-rule.md', 'cbb-priority.md', 'cbb-ai-behavior.md'];
+  const coreRules = ['cbb-coding-rule.md', 'cbb-priority.md', 'cbb-ai-behavior.md', 'cbb-workspace-discipline.md'];
 
   // 确保目标目录存在
   fs.mkdirSync(rulesDest, { recursive: true });
@@ -1086,13 +1086,14 @@ async function init(targetDir, options = {}) {
     newPaths.add(`${adapter.rulesDir}/cbb-coding-rule.md`);
     newPaths.add(`${adapter.rulesDir}/cbb-priority.md`);
     newPaths.add(`${adapter.rulesDir}/cbb-ai-behavior.md`);
+    newPaths.add(`${adapter.rulesDir}/cbb-workspace-discipline.md`);
     // opencode：rules glob 登记进 .opencode/opencode.json instructions，并迁移根文件旧登记
     if (adapter.instructionsFile) {
       injectInstructions(adapter, newPaths, managedPaths);
       migrateLegacyInstructions(adapter);
     }
   });
-  log(`核心规则 → ${selectedAdapters.map(a => a.rulesDir).join(', ')} (2 个文件)`, 'success');
+  log(`核心规则 → ${selectedAdapters.map(a => a.rulesDir).join(', ')} (4 个文件)`, 'success');
 
   // 安装 Skills（支持 skills 的适配器）
   const skillsAdapters = selectedAdapters.filter(a => a.skillsDir);

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

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * 删除需求分支（共享脚本，真源：cbb/worktrees/_shared/scripts/）
+ *
+ * 供 cbb-worktree-close（Step 4.4 交付完成后自动删本地 + 远程分支）与
+ * cbb-local-mode（Step 5.4 收尾删远程分支）调用。
+ *
+ * 用法：node delete-branches.js <ws_root> <branch> <mode>   # mode: keep / local / local_remote
+ *
+ * 逐仓库执行：本地分支按合并判定选 -d / -D（squash 合并 -d 失败回退 -D）；
+ * local_remote 模式追加 git push <remote> --delete。
+ * 清理阶段失败报告并继续其余仓库，不回滚（ADR 0007）。
+ */
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const branch = process.argv[3];
+const mode = process.argv[4];
+
+if (!wsRoot || !branch || !mode) {
+  console.error('Usage: node delete-branches.js <ws_root> <branch> <mode>');
+  process.exit(1);
+}
+
+if (mode === 'keep') {
+  console.log('Keep branch, skip delete');
+  console.log('---');
+  console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode: 'keep', ok: true, deleted: [] }));
+  process.exit(0);
+}
+
+if (mode !== 'local' && mode !== 'local_remote') {
+  console.error('mode must be keep / local / local_remote');
+  process.exit(1);
+}
+
+function run(cmd, cwd, env) {
+  try {
+    return { ok: true, out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env, ...(env || {}) } }).trim() };
+  } catch (e) {
+    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
+  }
+}
+
+function detectMain(repoPath) {
+  const remote = run('git remote', repoPath);
+  if (!remote.ok || !remote.out) return 'main';
+  const r = remote.out.split(/\r?\n/)[0];
+  const symbolic = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', repoPath);
+  if (symbolic.ok && symbolic.out) {
+    return symbolic.out.replace('refs/remotes/' + r + '/', '');
+  }
+  return 'main';
+}
+
+function mergedTo(repoPath, from, to) {
+  // 0=merged, 1=unmerged, 2=to-ref-missing
+  if (!run('git rev-parse --verify --quiet "' + from + '"', repoPath).ok) return 1;
+  if (!run('git rev-parse --verify --quiet "' + to + '"', repoPath).ok) return 2;
+  if (run('git merge-base --is-ancestor "' + from + '" "' + to + '" && echo Y', repoPath).out === 'Y') return 0;
+  // 跨平台：不用 grep（Windows 无 grep），解析 git cherry 输出（+ 前缀 = 未合并提交）
+  const cherry = run('git cherry "' + to + '" "' + from + '"', repoPath);
+  if (!cherry.ok) return 1;
+  if (cherry.out.split(/\r?\n/).filter(Boolean).some(l => l.indexOf('+') === 0)) return 1;
+  return 0;
+}
+
+function mergedToMain(repoPath, branchName, main) {
+  if (mergedTo(repoPath, branchName, main) === 0) return true;
+  if (mergedTo(repoPath, branchName, 'origin/' + main) === 0) return true;
+  // release-* transit
+  const releaseList = run('git for-each-ref --format="%(refname:short)" "refs/heads/release-*" "refs/remotes/origin/release-*"', repoPath);
+  if (releaseList.ok && releaseList.out) {
+    const releases = releaseList.out.split(/\r?\n/).filter(Boolean).sort();
+    for (const rel of releases) {
+      if (mergedTo(repoPath, branchName, rel) === 0) {
+        if (mergedTo(repoPath, rel, main) === 0) return true;
+        if (mergedTo(repoPath, rel, 'origin/' + main) === 0) return true;
+      }
+    }
+  }
+  return false;
+}
+
+function deleteBranch(repoPath, name) {
+  const checkLocal = run('git branch --list "' + branch + '"', repoPath);
+  if (checkLocal.ok && checkLocal.out) {
+    const main = detectMain(repoPath);
+    const merged = main ? mergedToMain(repoPath, branch, main) : false;
+    let flag = merged ? '-d' : '-D';
+    const del = run('git branch ' + flag + ' "' + branch + '"', repoPath);
+    if (del.ok) {
+      console.log('OK ' + name + ' local branch deleted (' + flag + ', ' + (merged ? 'merged' : 'unmerged') + ')');
+    } else {
+      if (flag === '-d') {
+        const fallback = run('git branch -D "' + branch + '"', repoPath);
+        if (fallback.ok) {
+          console.log('OK ' + name + ' local branch deleted (squash merge, fallback -D)');
+        } else {
+          console.error('FAIL ' + name + ' local branch delete failed');
+          return false;
+        }
+      } else {
+        console.error('FAIL ' + name + ' local branch delete failed');
+        return false;
+      }
+    }
+  } else {
+    console.log('Skip ' + name + ': no local branch ' + branch);
+  }
+
+  if (mode === 'local_remote') {
+    const remote = run('git remote', repoPath);
+    if (remote.ok && remote.out) {
+      const r = remote.out.split(/\r?\n/)[0];
+      const pushDel = run('git push "' + r + '" --delete "' + branch + '"', repoPath, { GIT_TERMINAL_PROMPT: '0' });
+      if (pushDel.ok) {
+        console.log('OK ' + name + ' remote branch deleted');
+      } else {
+        console.log('Skip ' + name + ': remote has no ' + branch);
+      }
+    }
+  }
+  return true;
+}
+
+const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
+let config = {};
+try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
+
+const apps = config.apps || [];
+
+console.log('=== Delete Workspace Branch ===');
+deleteBranch(wsRoot, 'workspace');
+
+console.log('=== Delete App Branches ===');
+for (const app of apps) {
+  const appPath = path.join(wsRoot, '.codespace', app.name);
+  deleteBranch(appPath, app.name);
+}
+
+console.log('---');
+console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode, ok: true }));
+process.exit(0);

package/cbb/worktrees/_shared/scripts/find-target-worktree.js

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 目标需求名识别
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/find-target-worktree.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（extend / close / push）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（close / push）。
  *
  * 用法：node find-target-worktree.js <ws_root>
  *

package/cbb/worktrees/_shared/scripts/find-workspace-root.js

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 工作空间根目录定位
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/find-workspace-root.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（close / push）。
  *
  * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 CBB-WORKSPACE.json 副本干扰）
  * 兜底：当前目录含 CBB-WORKSPACE.json

package/cbb/worktrees/_shared/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/_shared/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-local-mode/SKILL.md

@@ -5,7 +5,7 @@ description: "业务空间本地模式开发：空间根与各涉及应用在 .c
 
 # Local Mode（本地模式）
 
-业务空间的**就地开发**模式（ADR 0002）：需求涉及的所有仓库（空间根 + 各应用的标准本地检出 `.codespace/<app>/`）统一切到同名分支，当前会话在原地直接开发。与 worktree 模式**能力对称**（都能改 workspace 内容与应用代码、都强制分支隔离、交付都走 MR），差异仅是**无隔离目录、不可并行**——适合单线程快速推进的需求。
+业务空间的**就地开发**模式（ADR 0002）：需求涉及的所有仓库（空间根 + 各应用的标准本地检出 `.codespace/<app>/`）统一切到同名分支，当前会话在原地直接开发。与 worktree 模式**能力对称**（都能改 workspace 内容与应用代码、都强制分支隔离、交付均有 MR 与直合并两条通道，ADR 0007/0008），差异仅是**无隔离目录、不可并行**——适合单线程快速推进的需求。
 
 **启动时声明：** "我正在使用 cbb-local-mode 技能进行本地模式开发。"
 
@@ -42,7 +42,7 @@ node "<skill_dir>/scripts/check-local-state.js" "<ws_root>"
 
 ## Step 1：需求名与布局确认
 
-1. 对话中询问需求名（kebab-case，同时作分支名；禁 `..` / 路径分隔符 / 空格）
+1. 对话中询问需求名（kebab-case，同时作分支名；禁 `..` / 路径分隔符 / 空格）：直接给名，或输入需求描述由 agent 推荐 3–5 个英文候选（`AskUserQuestion` 选定；不满意可直接回复自己的名字）
 2. 从需求语境提取**涉及的应用子集**（改哪些 `.codespace/<app>`）；纯 workspace 内容则仅根参与。展示布局向用户确认：
 
 ```
@@ -74,7 +74,7 @@ node "<skill_dir>/scripts/start-local.js" "<ws_root>" "<branch>" --apps "<app1>,
 
 ## Step 4：提交推送（转 cbb-worktree-push）
 
-对话中说"提交并推送"即触发 `cbb-worktree-push`——其仓库发现已支持**本地布局**（根 + 持有同名分支的 `.codespace/<app>/`），dry-run 预览（含 agent 生成的 commit 信息）→ 批量 commit → push → MR 预填链接，全流程与 worktree 模式一致。
+对话中说"提交并推送"即触发 `cbb-worktree-push`——其仓库发现已支持**本地布局**（根 + 持有同名分支的 `.codespace/<app>/`），dry-run 预览（含 agent 生成的 commit 信息）→ 批量 commit → push → Step 7 交付选择（提 MR 预填链接 / 直接合并 / 暂不处理，ADR 0008），全流程与 worktree 模式一致。
 
 ## Step 5：收尾（收尾合并门禁 · ADR 0007）
 
@@ -110,7 +110,11 @@ node "<skill_dir>/scripts/merge-branches.js" "<ws_root>" "<需求名>" --apps "<
 git -C "<仓库>" checkout main && git -C "<仓库>" pull && git -C "<仓库>" branch -d "<需求名>"
 ```
 
-- 各仓库本地分支删除后，远程分支删除由 `delete-branches.js local_remote` 完成（删除前输出将删清单）
+- 各仓库本地分支删除后，远程分支删除由共享脚本完成（删除前输出将删清单）：
+
+```bash
+node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<需求名>" local_remote
+```
 - `checkout` 被 hook 拦（说明 main 落后或本地 main 有分叉）→ 先 `pull --ff-only`，再删分支
 - openspec change 归档在合并前执行（产物在分支上随交付合入）
 - 全部仓库回 main 后向用户报告"本地模式已收尾，空间回到干净态"
@@ -126,7 +130,7 @@ git -C "<仓库>" checkout main && git -C "<仓库>" pull && git -C "<仓库>" b
 | 场景 | 处理方式 |
 |------|----------|
 | 任何触发 | 先跑 Step 0 状态自检（clean 零交互 / active 用户四选一） |
-| 需求名 | 对话自由文本输入（禁 AskUserQuestion 收集自由文本） |
+| 需求名 | 对话输入：直接给名，或给需求描述（agent 推荐 3–5 个英文候选供选）；自由文本本身禁走 AskUserQuestion |
 | 涉及应用 | 需求语境提取子集，`--apps` 传入；中途补齐重跑（幂等） |
 | 切分支失败（dirty 冲突） | 报告详情，用户处理；禁止自动 stash |
 | commit 被 hook 拦（main 载荷） | 大声报错是预期行为：回分支重做；禁止自动 --no-verify |

package/cbb/worktrees/skills/cbb-local-mode/scripts/delete-branches.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * 删除需求分支（共享脚本，真源：cbb/worktrees/_shared/scripts/）
+ *
+ * 供 cbb-worktree-close（Step 4.4 交付完成后自动删本地 + 远程分支）与
+ * cbb-local-mode（Step 5.4 收尾删远程分支）调用。
+ *
+ * 用法：node delete-branches.js <ws_root> <branch> <mode>   # mode: keep / local / local_remote
+ *
+ * 逐仓库执行：本地分支按合并判定选 -d / -D（squash 合并 -d 失败回退 -D）；
+ * local_remote 模式追加 git push <remote> --delete。
+ * 清理阶段失败报告并继续其余仓库，不回滚（ADR 0007）。
+ */
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const branch = process.argv[3];
+const mode = process.argv[4];
+
+if (!wsRoot || !branch || !mode) {
+  console.error('Usage: node delete-branches.js <ws_root> <branch> <mode>');
+  process.exit(1);
+}
+
+if (mode === 'keep') {
+  console.log('Keep branch, skip delete');
+  console.log('---');
+  console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode: 'keep', ok: true, deleted: [] }));
+  process.exit(0);
+}
+
+if (mode !== 'local' && mode !== 'local_remote') {
+  console.error('mode must be keep / local / local_remote');
+  process.exit(1);
+}
+
+function run(cmd, cwd, env) {
+  try {
+    return { ok: true, out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env, ...(env || {}) } }).trim() };
+  } catch (e) {
+    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
+  }
+}
+
+function detectMain(repoPath) {
+  const remote = run('git remote', repoPath);
+  if (!remote.ok || !remote.out) return 'main';
+  const r = remote.out.split(/\r?\n/)[0];
+  const symbolic = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', repoPath);
+  if (symbolic.ok && symbolic.out) {
+    return symbolic.out.replace('refs/remotes/' + r + '/', '');
+  }
+  return 'main';
+}
+
+function mergedTo(repoPath, from, to) {
+  // 0=merged, 1=unmerged, 2=to-ref-missing
+  if (!run('git rev-parse --verify --quiet "' + from + '"', repoPath).ok) return 1;
+  if (!run('git rev-parse --verify --quiet "' + to + '"', repoPath).ok) return 2;
+  if (run('git merge-base --is-ancestor "' + from + '" "' + to + '" && echo Y', repoPath).out === 'Y') return 0;
+  // 跨平台：不用 grep（Windows 无 grep），解析 git cherry 输出（+ 前缀 = 未合并提交）
+  const cherry = run('git cherry "' + to + '" "' + from + '"', repoPath);
+  if (!cherry.ok) return 1;
+  if (cherry.out.split(/\r?\n/).filter(Boolean).some(l => l.indexOf('+') === 0)) return 1;
+  return 0;
+}
+
+function mergedToMain(repoPath, branchName, main) {
+  if (mergedTo(repoPath, branchName, main) === 0) return true;
+  if (mergedTo(repoPath, branchName, 'origin/' + main) === 0) return true;
+  // release-* transit
+  const releaseList = run('git for-each-ref --format="%(refname:short)" "refs/heads/release-*" "refs/remotes/origin/release-*"', repoPath);
+  if (releaseList.ok && releaseList.out) {
+    const releases = releaseList.out.split(/\r?\n/).filter(Boolean).sort();
+    for (const rel of releases) {
+      if (mergedTo(repoPath, branchName, rel) === 0) {
+        if (mergedTo(repoPath, rel, main) === 0) return true;
+        if (mergedTo(repoPath, rel, 'origin/' + main) === 0) return true;
+      }
+    }
+  }
+  return false;
+}
+
+function deleteBranch(repoPath, name) {
+  const checkLocal = run('git branch --list "' + branch + '"', repoPath);
+  if (checkLocal.ok && checkLocal.out) {
+    const main = detectMain(repoPath);
+    const merged = main ? mergedToMain(repoPath, branch, main) : false;
+    let flag = merged ? '-d' : '-D';
+    const del = run('git branch ' + flag + ' "' + branch + '"', repoPath);
+    if (del.ok) {
+      console.log('OK ' + name + ' local branch deleted (' + flag + ', ' + (merged ? 'merged' : 'unmerged') + ')');
+    } else {
+      if (flag === '-d') {
+        const fallback = run('git branch -D "' + branch + '"', repoPath);
+        if (fallback.ok) {
+          console.log('OK ' + name + ' local branch deleted (squash merge, fallback -D)');
+        } else {
+          console.error('FAIL ' + name + ' local branch delete failed');
+          return false;
+        }
+      } else {
+        console.error('FAIL ' + name + ' local branch delete failed');
+        return false;
+      }
+    }
+  } else {
+    console.log('Skip ' + name + ': no local branch ' + branch);
+  }
+
+  if (mode === 'local_remote') {
+    const remote = run('git remote', repoPath);
+    if (remote.ok && remote.out) {
+      const r = remote.out.split(/\r?\n/)[0];
+      const pushDel = run('git push "' + r + '" --delete "' + branch + '"', repoPath, { GIT_TERMINAL_PROMPT: '0' });
+      if (pushDel.ok) {
+        console.log('OK ' + name + ' remote branch deleted');
+      } else {
+        console.log('Skip ' + name + ': remote has no ' + branch);
+      }
+    }
+  }
+  return true;
+}
+
+const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
+let config = {};
+try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
+
+const apps = config.apps || [];
+
+console.log('=== Delete Workspace Branch ===');
+deleteBranch(wsRoot, 'workspace');
+
+console.log('=== Delete App Branches ===');
+for (const app of apps) {
+  const appPath = path.join(wsRoot, '.codespace', app.name);
+  deleteBranch(appPath, app.name);
+}
+
+console.log('---');
+console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode, ok: true }));
+process.exit(0);

package/cbb/worktrees/skills/cbb-local-mode/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-close/SKILL.md

@@ -287,6 +287,7 @@ node "<skill_dir>/scripts/merge-branches.js" "<ws_root>" "<branch>" --apps "<app
   - 退出码 0 → 交付完成，继续 Step 4
   - `need-mr`（`branch-protected`：远端主干受保护）→ 远端保护是常态，**改用出口一**（不是故障）
   - `failed`（含 `merge-failed` / `push-failed`）→ 输出失败明细，阻塞并询问用户（修复后重跑；重跑幂等）
+  - `failed` 且 `not-on-main`（空间根检出不是主干：被其他需求占用或异常）→ 先让该占用回到主干（收尾本地需求）或改用出口一；**不要用 `--allow-checkout`**（会切走占用者的工作区）
 
 **出口三 · 确认废弃（`deprecate-branches.js`）**
 
@@ -493,9 +494,9 @@ git -C "<ws_root>" worktree list
 | `find-workspace-root.js` | 定位工作空间根目录（共享脚本，源仓库真源在 `_shared/scripts/`） | 无 | 0/1 |
 | `find-target-worktree.js` | 目标 worktree 识别（共享脚本，源仓库真源在 `_shared/scripts/`） | ws_root | 0/1/2 |
 | `discover-apps.js` | 发现关联应用 worktree | ws_root, branch | 0/1/2 |
-| `check-unarchived.js` | 检查未归档 change | ws_root | 0/1 |
+| `check-unarchived.js` | 检查未归档 change（双扫空间根 + worktree） | ws_root, branch | 0/1 |
 | `safety-check.js` | 安全评估（合并判定 + 未提交 + 远程） | ws_root, branch | 0/1 |
 | `remove-worktrees.js` | 移除 worktree（三层降级） | ws_root, branch, force | 0/1 |
 | `delete-branches.js` | 删除分支（按 mode；交付完成后由 Step 4.4 自动以 local_remote 调用） | ws_root, branch, mode | 0/1/2 |
-| `merge-branches.js` | 收尾合并门禁·直合并（预检 → merge --no-ff → push 主干，共享脚本，真源在 `_shared/scripts/`） | ws_root, branch, --apps / --allow-checkout / --dry-run | 0/1/2 |
+| `merge-branches.js` | 收尾合并门禁·直合并（预检 → merge --no-ff → push 主干，共享脚本，真源在 `_shared/scripts/`） | ws_root, branch, --apps / --target / --allow-checkout / --dry-run / --check | 0/1/2 |
 | `deprecate-branches.js` | 收尾合并门禁·废弃（远程分支重命名为 `<分支>-deprecated`，共享脚本） | ws_root, branch, --apps | 0/1/2 |

package/cbb/worktrees/skills/cbb-worktree-close/scripts/check-env.js

@@ -4,7 +4,7 @@ require('./silence-popup');
  * cbb-worktree-close 环境健康探活
  *
  * close-worktree 必须在工作空间根目录或 worktree 内执行，且需找到 CBB-WORKSPACE.json。
- * 与 init/extend 探活同构，但额外校验 CBB-WORKSPACE.json 存在性。
+ * 与 init 探活同构，但额外校验 CBB-WORKSPACE.json 存在性。
  *
  * 退出码：
  *   0 - 探活通过