@jspg-ai/coding-bb 0.0.3-beta.32 → 0.0.3-beta.34

package/cbb/worktrees/skills/cbb-worktree-close/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cbb-worktree-close
-description: "关闭/清理/删除需求工作空间的 worktree 和分支。触发：用户明确说关闭/清理/删除 worktree、结束隔离开发、合并完要清理。禁止在 cbb-worktree-init 执行后自动调用——只有用户主动要求关闭时才触发。"
+description: "关闭/清理/删除需求工作空间的 worktree 和分支。内置收尾合并门禁（ADR 0007）：未合并分支必须先经 MR 或直合并交付，或由用户确认废弃并重命名为 <分支>-deprecated，否则不允许关闭。触发：用户明确说关闭/清理/删除 worktree、结束隔离开发、合并完要清理。禁止在 cbb-worktree-init 执行后自动调用——只有用户主动要求关闭时才触发。"
 ---
 
 # Close Worktree（跨平台脚本化版本 v2.0）
@@ -17,7 +17,9 @@ description: "关闭/清理/删除需求工作空间的 worktree 和分支。触
 - 只操作 `.worktrees/worktree-<需求名>` 这一类精确路径，**绝不碰其它 worktree**（如 IDE/工具自动创建的 `~/.qoder/worktree/...` 会话 worktree）
 - 通过检查 `.worktrees/worktree-<需求名>/.codespace/<应用名>/` **是否实际存在**来确定关联应用——创建时用户可能只关联了 `CBB-WORKSPACE.json` 中的部分应用，不能假设全部应用都关联
 - **顺序硬约束：先移除所有 worktree，再删除分支。** 目标分支当前正检出于 worktree 中，先删分支会报 `error: Cannot delete branch '<分支>' checked out at '<worktree 路径>'`
-- **破坏性操作必须先报告、经用户确认才执行**：未提交修改、未合并/未推送的提交，绝不静默 `--force` 或 `-D` 丢弃
+- **收尾合并门禁（ADR 0007）**：关闭前每个参与仓库必须为"已合并"（复用 `safety-check` 的 `merged` 判定，含 release 中转 / squash 兜底）。未合并时由用户在门禁处三选一——**提 MR**（人工浏览器合入）/ **直合并**（agent 执行 `merge-branches.js`，前置：已归档 + 已提交）/ **确认废弃**（`deprecate-branches.js` 把远程分支重命名为 `<分支>-deprecated`）。**硬门禁：未合并且非废弃一律不允许关闭**
+- **合并成功后自动删分支（ADR 0007）**：交付完成（MR 已合并或直合并成功）后自动删各参与仓库的本地 + 远程 feature 分支（删除前输出将删清单）；"废弃"出口则保留分支（仅远程重命名）
+- **破坏性操作必须先报告、经用户确认才执行**：未提交修改、未确认废弃的分支，绝不静默 `--force` 或 `-D` 丢弃
 - 软性检查失败时报告详情，询问用户是否继续
 - 输入约定：凡是需要用户自由输入文本（如分支名、确认）的场景，**必须直接在对话中提问并等待用户回复**，禁止使用 `AskUserQuestion` 工具；`AskUserQuestion` 仅用于固定选项场景（选择归档哪些 change、是否丢弃未提交修改）
 
@@ -224,60 +226,82 @@ AskUserQuestion({
 - 若 delta specs 需要同步 → 对该 change 单独提示同步选项（同步 / 跳过同步直接归档）
 - 每个 change 的归档结果独立记录（✅ 已归档 / ⏭️ 跳过 / ❌ 失败）
 
-### 3.3 分支处理方式（默认保留，不询问）
+### 3.3 未推送 commit 处理（仅当 2.4 任一 worktree `unpushed_count > 0` 时出现）
 
-历史版本此步骤会询问"保留 / 删本地 / 删本地+远程"，但绝大多数场景仅需移除 worktree、自动保留分支；频繁弹窗会打断 close-worktree 的批量清理节奏。改为 **默认 `MODE = keep`，不再触发 `AskUserQuestion`**。
+**场景**：用户在 worktree 中做了 commit，但没有调 `cbb-worktree-push` 推送，本地有 ahead 提交。
 
-**默认行为**：
+**报告**：
+```
+⚠️ 检测到未推送的提交（ahead of origin/<branch>）：
+  - workspace: 3 个 commit
+  - ep-user-info-server: 1 个 commit
+
+请选择处理方式：
+  [先推送]（推荐）调 cbb-worktree-push 推送所有 ahead 提交
+  [继续]   不单独推送，直接进入合并门禁（走「直合并」时会随合并一并推送到主干）
+  [中止]   终止流程，我先手动处理
+```
 
-- `MODE = keep` → 仅移除 worktree，**本地分支与远程分支都不动**
-- Step 2 安全评估结果（合并状态 / 远程存在性）仅用于内部决策展示，**不再弹出分支处理问卷**
+- 用户选择「先推送」→ AI 引导执行 `cbb-worktree-push` skill（或 `/cbb-worktree-push`），完成后**重新跑** Step 2 safety-check 确认 `unpushed_count = 0` 再回到本步骤
+- 用户选择「继续」→ 进入 Step 3.4；注意：走「提 MR」出口时会因 feature 未推送而失败，需回到本步骤先推送
+- 用户选择「中止」→ 终止流程
 
-**逃生通道**（确需主动删分支时手动调用）：
+> ⓘ 走「直合并」出口时，ahead 提交会被合并进主干并随 `git push origin <主干>` 一并推送，无需单独推送 feature 分支。
 
-如用户在 Step 1.1 选定要关闭的 worktree 时同步要求"删除分支"，或运行后需要清理本地/远程分支，可手动调用脚本：
+### 3.4 合并门禁决策（核心 · ADR 0007）
 
-```bash
-# 仅删本地分支（已合并自动 -d，未合并自动 -D；含 squash 合并 -D 兜底）
-node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local
+依据 Step 2 的 `merged` 判定（每个参与仓库 `merged !== null` 即已合并，含 `main` / `origin/main` / `main-via-release-*`）：
 
-# 删本地 + 远程分支
-node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
-```
+**情况 A：全部参与仓库已合并** → 无交互，直接进入 Step 4（合并成功后自动删分支）。
 
-**调用前的强警告**（调用方需自评）：
+**情况 B：存在未合并仓库** → 硬门禁触发，`AskUserQuestion` 三选一（**不允许"未合并且非废弃"地关闭**）：
 
-- **未合并分支**（Step 2.2 `merged: null`）：删除会永久丢失未合并的提交，必须二次确认
-- **远程分支**：删除后无法直接恢复，需确认其他仓库/同事是否还在引用
-- **推荐做法**：默认 `keep` 关闭 worktree 即可，确有必要再单独执行脚本；这样误删风险被显式手动动作兜住
+```
+以下仓库的需求分支尚未交付（未合并到主干）：
+  - workspace（merged: null）
+  - ep-foo-app（merged: null）
+
+请选择交付方式：
+  [提 MR]（推荐）   生成预填合并请求链接，由人工在浏览器合入
+  [直合并]          由 agent 直接合并到主干并推送远端（需你确认）
+  [确认废弃]        该分支不再交付，远程重命名为 <分支>-deprecated
+```
 
-> 合并代码到主分支属于另一项工作（参见 `finishing-a-development-branch`），本技能不代为合并；若用户其实想合并，引导其先完成合并再回来关闭。
+**出口一 · 提 MR（推荐）**
 
-### 3.4 未推送 commit 处理（仅当 2.4 任一 worktree `unpushed_count > 0` 时出现）
+1. 先确保 feature 已推送（Step 3.3 未推送时先推送）
+2. **引导用户运行 `cbb-worktree-push`**（说"提交并推送"）：其 Step 7 会列出目标分支候选（`git branch -r` 现场候选，**禁止 AI 代决**）并生成 MR 预填链接（可选自动开浏览器）；本技能不自带 MR 链接脚本
+3. **中止 close**：提示"合并完成后重跑本技能"。**不执行任何移除 / 删除**
 
-**场景**：
-- 用户在 worktree 中做了 commit，但**没有调** `cbb-worktree-push` 推送
-- 本地有 ahead 提交未推送到 origin
-- 一旦 close worktree + 后续走 `local` / `local_remote` 删分支，ahead 提交可能永久丢失（取决于上游 `delete-branches.js` 行为）
+**出口二 · 直合并（`merge-branches.js`）**
 
-**报告**：
+- **前置（Q18）**：3.1 无未提交修改、3.2 已归档并提交——**合并前必须已归档 + 已提交**（两者先后不限）
+- 执行（`--apps` 传 Step 1.2 发现的参与应用）：
+
+```bash
+node "<skill_dir>/scripts/merge-branches.js" "<ws_root>" "<branch>" --apps "<app1,app2>"
 ```
-⚠️ 检测到未推送的提交（ahead of origin/<branch>）：
-  - workspace: 3 个 commit
-  - ep-user-info-server: 1 个 commit
-  - ep-baz-app: 2 个 commit
 
-请选择处理方式：
-  [先推送]（推荐）调 cbb-worktree-push 推送所有 ahead 提交
-  [接受丢失] 继续关闭，ahead 提交在删分支后永久丢失
-  [中止] 终止流程，我先手动处理
+- 两阶段：预检（主干可探测 / 主干检出干净且不领先 origin / 分支存在；全过才执行）→ 执行（checkout 主干 → pull --ff-only → merge --no-ff → push origin 主干）
+- 解读末行 `MERGE_RESULT`：
+  - 退出码 0 → 交付完成，继续 Step 4
+  - `need-mr`（`branch-protected`：远端主干受保护）→ 远端保护是常态，**改用出口一**（不是故障）
+  - `failed`（含 `merge-failed` / `push-failed`）→ 输出失败明细，阻塞并询问用户（修复后重跑；重跑幂等）
+  - `failed` 且 `not-on-main`（空间根检出不是主干：被其他需求占用或异常）→ 先让该占用回到主干（收尾本地需求）或改用出口一；**不要用 `--allow-checkout`**（会切走占用者的工作区）
+
+**出口三 · 确认废弃（`deprecate-branches.js`）**
+
+- **二次确认**（远程重命名不可逆）：`AskUserQuestion` 固定选项"确认废弃 / 中止"
+- 执行：
+
+```bash
+node "<skill_dir>/scripts/deprecate-branches.js" "<ws_root>" "<branch>" --apps "<app1,app2>"
 ```
 
-- 用户选择「先推送」→ AI 引导用户执行 `cbb-worktree-push` skill（或 `/cbb-worktree-push`），完成后**重新跑** Step 2 safety-check 确认 `unpushed_count = 0` 再回到本步骤
-- 用户选择「接受丢失」→ 必须二次确认（ahead 提交真的会丢），确认后继续 Step 4
-- 用户选择「中止」→ 终止流程
+- 效果：远程存在该分支的仓库，重命名 `<分支>` → `<分支>-deprecated`（**保留历史、不删提交**）；**本地分支保持原名不动**
+- 解读末行 `DEPRECATE_RESULT`：`failed` → 报告并终止
 
-> ⓘ **为什么必须二次确认**：close-worktree 的默认 MODE=keep 不会删分支，ahead 提交仍在本地；只有用户主动走 `local` / `local_remote` 删分支模式才会真正丢。AI 必须先在报告中讲清楚后果，再询问用户决策。
+> ⓘ 门禁判定复用 `safety-check` 的 `merged`：他人经 MR 或 `release-*` 中转合入后，重跑本技能即自动放行，无需重复交付。
 
 ---
 
@@ -341,32 +365,34 @@ node "<skill_dir>/scripts/remove-worktrees.js "<ws_root>" "<branch>" "<force>"
 - **不会产生孤立窗口**——`--reuse-window` 是复用当前窗口切换目录，**不会打开新窗口**。即使 IDE 已开着指向 WS_ROOT 的其他窗口，本步骤也不会重复创建，仅是把当前指向已删除目录的窗口切走
 - **失败不致命**——`session_move` / `--reuse-window` 失败时仅警告，后续分支删除不受影响
 
-### 4.4 分支处理（默认跳过，按需手动调用）
+### 4.4 分支处理（合并成功后自动删除 · ADR 0007）
 
-默认 `MODE = keep`（见 Step 3.3），本步骤**不主动调用** `delete-branches.js`，本地分支与远程分支均保留。
+**按 Step 3.4 的门禁出口决定**：
 
-如用户在 Step 1.1 选定 worktree 时已要求"删除分支"，或运行后需要单独清理，可在此步骤**手动调用**：
+- **交付完成**（情况 A 已合并，或出口二直合并成功）→ **自动删除**各参与仓库的本地 + 远程 feature 分支：
 
 ```bash
-node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local
-# 或
 node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
 ```
 
+- **出口三废弃** → **保留分支**（远程已重命名为 `<分支>-deprecated`），**不调用** `delete-branches.js`
+
+**删除前必做**：输出"即将删除的本地 / 远程分支清单"（逐仓库），透明可见。
+
 脚本内部对每个仓库：
 - **本地分支**：检测是否已合并（复用 safety-check 的合并判定算法）
   - 已合并 → `git branch -d`（安全删除）
   - 未合并 → `git branch -D`（强制删除）
   - squash 合并可能让 `-d` 失败 → 自动回退到 `-D`（squash 合并同样安全）
-- **远程分支**（仅 `local_remote` 模式）：`git push <remote> --delete <branch>`
+- **远程分支**（`local_remote` 模式）：`git push <remote> --delete <branch>`
   - 分支不存在时 push --delete 会报错，按"已删除/本就无"处理即可
   - 远程引用已在 Step 2.0 主动 fetch 刷新并持久化在 .git，此处直接读取无需重复 fetch
 
-**解读末行 `BRANCH_DELETE_RESULT`**：
-- `mode`：keep / local / local_remote
-- `ok`：是否全部成功
+**解读末行 `BRANCH_DELETE_RESULT`**：`mode`（keep / local / local_remote）、`ok`。
+
+**失败处理（ADR 0007）**：清理阶段（删除分支）失败**报告并继续其余仓库，不回滚**——交付已达成，清理不净不该阻塞（与合并阶段的"失败即停"不同）。
 
-> 默认跳过分支删除是安全红线的取舍：未合并分支误删会永久丢失提交、远程分支误删会冲击其他仓库/同事。保留为显式手动动作可让调用方在执行前再做一次审视。
+**顺序硬约束**：必须在 Step 4.2（移除 worktree）**之后**执行——分支正检出于 worktree，先删会报 `Cannot delete branch ... checked out at ...`。
 
 > 关于 `.gitignore`：创建时把 `.worktrees/` 加入 `.gitignore` 并**提交到了 feature 分支**（非主分支）。
 > - 分支未合并、被 `-D` 删除 → 这些 commit 随分支一起消失，主分支的 `.gitignore` 不受影响
@@ -395,6 +421,7 @@ git -C "<ws_root>" worktree list
 ```
 ✅ 工作空间 worktree 已关闭
   当前目录：<工作空间根目录绝对路径>
+  交付方式：已合并（MR 合入）/ 直合并（agent 合并并推送主干）/ 确认废弃
   已移除 worktree：
     - .worktrees/worktree-feature-xxx（workspace）
     - .worktrees/worktree-feature-xxx/.codespace/ep-user-info-server（嵌套，ep-user-info-server 仓库）
@@ -404,7 +431,9 @@ git -C "<ws_root>" worktree list
     ✅ ai-call-send-im-msg → 已归档到 archive/2026-07-08-ai-call-send-im-msg
     ⏭️  fix-payment-timeout → 用户选择跳过
     （无未归档 change 时不显示本节）
-  分支处理：feature-xxx 已保留（默认行为；如需删除分支，手动调用 scripts/delete-branches.js）
+  分支处理：
+    - 交付完成 → 已删除本地 + 远程分支：feature-xxx（逐仓库列出）
+    - 已废弃 → 远程已重命名为 feature-xxx-deprecated（本地分支保留原名）
   剩余工作空间 worktree：<列出仍存在的，或 "无" >
   👉 仅当所用工具不支持自动切根、且你的窗口仍停在已删除的 worktree 时，请手动切回工作空间根：<ws_root 绝对路径>
   Workspace cleaned up.
@@ -425,7 +454,10 @@ git -C "<ws_root>" worktree list
 ### 绝不允许
 
 - 先删分支再删 worktree（分支正检出于 worktree，会报 `Cannot delete branch ... checked out at ...`）
-- 未经用户确认用 `--force` 丢弃未提交修改，或主动调用 `delete-branches.js` 对未合并分支执行 `-D` 强删
+- **未合并且未确认为废弃时关闭 worktree**（违反 ADR 0007 硬门禁）
+- 未经用户确认用 `--force` 丢弃未提交修改；或对未确认废弃的未合并分支执行 `-D` 强删
+- 未经二次确认执行 `deprecate-branches.js`（远程重命名不可逆）
+- 直合并前跳过"已归档 + 已提交"前置校验
 - 操作 `.worktrees/worktree-<需求名>` 以外的任何 worktree（如 `~/.qoder/worktree/...` 会话 worktree）
 - 移除/删除前跳过 Step 2 安全评估
 - 删除工作空间根目录的 AI 配置目录（`.claude/`、`.qoder/`、`.opencode/` 等）
@@ -437,6 +469,8 @@ git -C "<ws_root>" worktree list
 
 - 读 `CBB-WORKSPACE.json` 取应用名列表；以 `.worktrees/worktree-<需求名>/.codespace/<应用名>/` 实际存在性确定关联清单
 - 移除/删除前执行安全评估（未提交修改 / 是否合并 / 是否推远程）并报告
+- **按 Step 3.4 门禁三选一交付**；未合并且未确认为废弃时**禁止关闭**
+- 交付完成（自动删分支）前**先输出将删清单**；清理阶段失败报告并继续，不回滚
 - 严格按 Step 4.2（移除 worktree）→ Step 4.4（删分支）顺序
 - 移除 workspace worktree 前先把会话移出（`cd "<WS_ROOT>" &&` 或 `git -C` 绝对路径）
 - 收尾切回 WS 根目录、`pwd` 确认
@@ -460,7 +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） | ws_root, branch, mode | 0/1/2 |
+| `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 / --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 - 探活通过

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

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * cbb-worktree-close 未归档 change 检查
+ * 未归档 change 检查（共享脚本，真源：cbb/worktrees/_shared/scripts/）
+ *
+ * 供 cbb-worktree-close（收尾安全评估）与 cbb-worktree-push（Step 7 直合并前置，ADR 0008）调用。
  *
  * 用法：node check-unarchived.js <ws_root> [branch]
  *

package/cbb/worktrees/skills/cbb-worktree-close/scripts/delete-branches.js

@@ -1,136 +1,147 @@
-#!/usr/bin/env node
-require('./silence-popup');
-/**
- * cbb-worktree-close 删除分支 (按用户选择)
- */
-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', 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;
-  const cherry = run('git cherry "' + to + '" "' + from + '" | grep -q "^+" && echo N || echo Y', repoPath);
-  if (cherry.out === 'N') 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);
+#!/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);