@jspg-ai/coding-bb 0.0.5-beta.3 → 0.0.5-beta.4

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

@@ -9,9 +9,17 @@ require('./silence-popup');
  *
  * 用法：
  *   node deprecate-branches.js <ws_root> <branch> [--apps a,b]
+ *   node deprecate-branches.js <ws_root> <branch> [--apps a,b] --check   # 仅检查，不重命名
+ *
+ * 模式：
+ *   --check      只读检查：逐仓库报远端分支存在性与本地未推送提交数
+ *                （ls-remote 取远端权威 hash 与本地 <branch> 比对）。
+ *                用途：废弃重命名只覆盖远端已推送的部分——本地 ahead 提交
+ *                不会被带进 <branch>-deprecated，执行前须提示用户决策。
+ *   默认         执行远端重命名 <branch> → <branch>-deprecated
  *
  * 退出码：0 全部成功（含 skipped）/ 1 参数错误 / 2 存在失败
- * 末行：DEPRECATE_RESULT [...]
+ * 末行：DEPRECATE_RESULT [...] 或 DEPRECATE_CHECK_RESULT [...]
  */
 
 const { execSync } = require('child_process');
@@ -44,6 +52,51 @@ function loadApps(wsRoot) {
   }
 }
 
+/**
+ * 检查单个仓库（--check，只读）：
+ *   unpushed: 0 = 已全部推送；>0 = 本地领先远端 N 个提交；'all' = 远端无该分支（提交全部未推送）
+ */
+function checkRepo(name, repo, branch) {
+  const rec = { name, status: 'skipped', remote_exists: false, unpushed: 0, 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];
+  if (!run('git rev-parse --verify --quiet "refs/heads/' + branch + '"', repo).ok) {
+    rec.detail = 'no-local-branch';
+    return rec;
+  }
+  const ls = run('git ls-remote --heads "' + r + '" "refs/heads/' + branch + '"', repo);
+  if (!ls.ok) {
+    rec.status = 'failed';
+    rec.detail = 'ls-remote-failed';
+    return rec;
+  }
+  if (!ls.out) {
+    rec.status = 'ok';
+    rec.unpushed = 'all';
+    rec.detail = 'remote-has-no-branch';
+    return rec;
+  }
+  const remoteHash = ls.out.split(/\r?\n/)[0].split(/\s+/)[0];
+  const cnt = run('git rev-list --count "' + remoteHash + '..refs/heads/' + branch + '"', repo);
+  if (!cnt.ok) {
+    rec.status = 'failed';
+    rec.detail = 'rev-list-failed';
+    return rec;
+  }
+  rec.status = 'ok';
+  rec.remote_exists = true;
+  rec.unpushed = parseInt(cnt.out, 10) || 0;
+  return rec;
+}
+
 /** 对单个仓库执行废弃重命名 */
 function deprecateRepo(name, repo, branch) {
   const newName = branch + '-deprecated';
@@ -95,6 +148,7 @@ function main() {
   const appFilter = appsIdx >= 0
     ? new Set((args[appsIdx + 1] || '').split(',').map(s => s.trim()).filter(Boolean))
     : null;
+  const checkOnly = args.includes('--check');
 
   const repos = [{ name: 'workspace', repo: wsRoot }];
   for (const app of loadApps(wsRoot)) {
@@ -102,6 +156,17 @@ function main() {
     repos.push({ name: app.name, repo: path.join(wsRoot, '.codespace', app.name) });
   }
 
+  if (checkOnly) {
+    const results = repos.map(rp => checkRepo(rp.name, rp.repo, branch));
+    results.forEach(r => {
+      const up = r.status === 'ok' && r.unpushed !== 0 ? ' [unpushed: ' + r.unpushed + ']' : '';
+      console.log(r.status.toUpperCase() + ' ' + r.name + (r.detail ? ' — ' + r.detail : '') + up);
+    });
+    console.log('---');
+    console.log('DEPRECATE_CHECK_RESULT', JSON.stringify({ branch, results }));
+    process.exit(results.some(r => r.status === 'failed') ? 2 : 0);
+  }
+
   const results = repos.map(rp => deprecateRepo(rp.name, rp.repo, branch));
 
   results.forEach(r => {
@@ -116,4 +181,4 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { run, loadApps, deprecateRepo };
+module.exports = { run, loadApps, checkRepo, deprecateRepo };

package/cbb/worktrees/_shared/scripts/return-to-trunk.js

@@ -21,7 +21,8 @@ require('./silence-popup');
  *      - 检出 dirty（含未跟踪）→ FAIL dirty-worktree（列未提交项数；不自动 stash，交用户决策）
  *      - 本地有主干分支 → git checkout <主干>；仅远端有 → git checkout -b <主干> --track origin/<主干>
  *   5. 追平远端：origin/<主干> 存在 → git pull --ff-only origin <主干>
- *      （本地主干与 origin 分叉 → FAIL pull-failed，交用户决策；远端无主干 → 注记跳过）
+ *      （成功详情注记 `pulled origin/<主干>` / `up-to-date`；本地主干与 origin 分叉 → FAIL
+ *      pull-failed，交用户决策；远端无主干 → 注记跳过）
  *   6. 已在主干 → 跳过切回，仍追平（幂等）
  *
  * 退出码：0 全部成功（含 no-repo / 已在主干）/ 1 参数错误 / 2 任一仓库失败
@@ -160,12 +161,18 @@ function main() {
     }
 
     if (hasRef(rp.repo, 'refs/remotes/origin/' + main)) {
+      const before = run('git rev-parse --quiet HEAD', rp.repo);
       const pull = run('git pull --ff-only --quiet origin "' + main + '"', rp.repo);
       if (!pull.ok) {
         rec.status = 'failed';
         rec.reason = 'pull-failed';
         rec.detail = (pull.err || '').split(/\r?\n/)[0];
         failed = true;
+      } else {
+        const after = run('git rev-parse --quiet HEAD', rp.repo);
+        rec.detail = before.ok && after.ok && before.out !== after.out
+          ? 'pulled origin/' + main
+          : 'up-to-date';
       }
     } else if (!rec.reason) {
       rec.reason = 'no-remote-trunk';

package/cbb/worktrees/skills/cbb-local-mode/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cbb-local-mode
-description: "业务空间本地模式开发：空间根与各涉及应用在 .codespace/<app>/ 就地建同名分支，当前会话直接开发（不建 worktree、不换目录）。触发：用户说'本地模式'/'就地开发'/'不走 worktree'/'在这个窗口开发'，或双模式选择时用户选本地模式。覆盖开工（状态自检→布局确认→切分支）、开发、提交推送（转 cbb-worktree-push）、收尾（收尾合并门禁 ADR 0007：MR / 直合并 / 确认废弃后回主干 + 删分支）、升级 worktree（重跑 cbb-worktree-init）。一次只承载一个需求。"
+description: "业务空间本地模式开发：空间根与各涉及应用在 .codespace/<app>/ 就地建同名分支，当前会话直接开发（不建 worktree、不换目录）。触发：用户说'本地模式'/'就地开发'/'不走 worktree'/'在这个窗口开发'，或双模式选择时用户选本地模式。覆盖开工（状态自检→布局确认→切分支）、开发、提交推送（转 cbb-worktree-push）、收尾（收尾合并门禁 ADR 0007：MR / 直合并 / 确认废弃；交付完成回主干 + 删分支，废弃保留本地分支）、升级 worktree（重跑 cbb-worktree-init）。一次只承载一个需求。"
 ---
 
 # Local Mode（本地模式）
@@ -103,9 +103,36 @@ node "<skill_dir>/scripts/merge-branches.js" "<ws_root>" "<需求名>" --apps "<
   ```
 
   `need-mr`（远端主干受保护）→ 改用提 MR；`failed` → 输出明细、修复后重跑
-- **确认废弃** → `deprecate-branches.js`（远程重命名 `<需求名>-deprecated`；本地分支保留原名）
+- **确认废弃** → 三步：检查未推送提交 → 二次确认 → 执行。**废弃后仍进 5.4 步骤 1 回主干，但跳过步骤 2（本地分支保留原名，不调用 `delete-branches.js`）**。
 
-**5.4 交付完成 → 各仓库回主干并删分支**（脚本化；主干名逐仓库经远端 HEAD 探测，兼容 main / master）：
+  1. 检查未推送提交（废弃重命名只覆盖远端已推送的部分，本地 ahead 提交不会进 `<需求名>-deprecated`）：
+
+  ```bash
+  node "<skill_dir>/scripts/deprecate-branches.js" "<ws_root>" "<需求名>" --apps "<app1,app2>" --check
+  ```
+
+  **解读末行 `DEPRECATE_CHECK_RESULT`**：每仓库 `unpushed`（本地领先远端的提交数；`all` = 远端无该分支、提交全部未推送；`0` = 已全部推送）。存在 `unpushed > 0` / `all` 时用 `AskUserQuestion`：
+
+  ```
+  ⚠️ 以下仓库存在未推送提交（将只保留在本地分支，不进 <需求名>-deprecated）：
+    - workspace: 3 个 commit
+
+  请选择处理方式：
+    [先推送]（推荐）调 cbb-worktree-push 推送全部提交后回到本步
+    [继续]            不推送直接废弃（这些提交只存在于被保留的本地分支）
+    [中止]            终止流程，我先手动处理
+  ```
+
+  2. 二次确认（远程重命名不可逆，`AskUserQuestion` 固定选项）：确认废弃 / 中止
+  3. 执行：
+
+  ```bash
+  node "<skill_dir>/scripts/deprecate-branches.js" "<ws_root>" "<需求名>" --apps "<app1,app2>"
+  ```
+
+  `failed` → 报告并终止；完成后进 5.4（**仅步骤 1**）
+
+**5.4 交付完成 → 各仓库回主干并删分支**（脚本化；主干名逐仓库经远端 HEAD 探测，兼容 main / master。**废弃出口仅执行步骤 1**——分支保留、不删）：
 
 1. 各仓库切回主干并追平远端（替代原裸 git 三连；不自动 stash，失败即报告）：
 
@@ -114,20 +141,20 @@ node "<skill_dir>/scripts/return-to-trunk.js" "<ws_root>" --apps "<app1,app2>"
 ```
 
 **解读末行 `TRUNK_RESULT`**：
-- 退出码 0 → 全部已回主干并追平
+- 退出码 0 → 全部已回主干并追平（detail 注记 `pulled origin/<主干>` = 本次有追平；`up-to-date` = 本就最新）
 - 某仓库 `dirty-worktree` → 检出上有未提交改动（回归 5.1 前置，先处理再重跑）；**不自动 stash**
 - 某仓库 `pull-failed`（本地主干与 origin 分叉）→ 输出详情，交用户决策
 - 某仓库 `cannot-detect-main` → 检查该仓库远端与主干分支（`fetch-failed` 同理）
 - 幂等：已在主干的仓库仅追平远端，重复执行无害
 
-2. 本地 + 远程需求分支删除（本地删除含 squash 合并的 `-d` → `-D` 兜底；删除前输出将删清单）：
+2. 本地 + 远程需求分支删除（**仅交付完成出口执行**——MR 已合入 / 直合并成功；**废弃出口跳过本步**，本地分支保留原名。本地删除含 squash 合并的 `-d` → `-D` 兜底；删除前输出将删清单）：
 
 ```bash
 node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<需求名>" local_remote
 ```
 
 - openspec change 归档在合并前执行（产物在分支上随交付合入）
-- 全部仓库回主干且分支删除后，向用户报告"本地模式已收尾，空间回到干净态"
+- 全部仓库回主干（交付完成出口含分支删除）后，向用户报告"本地模式已收尾，空间回到干净态"
 
 ## 升级 worktree（中途要并行 / 要隔离）
 
@@ -146,7 +173,7 @@ node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<需求名>" local_re
 | commit 被 hook 拦（main 载荷） | 大声报错是预期行为：回分支重做；禁止自动 --no-verify |
 | 误在 main 检出上写了文件 | `git checkout -b <需求名>` 后改动随分支走；已 staged 则 unstage 后再切 |
 | 提交推送 | 说"提交并推送" → cbb-worktree-push（本地布局自动发现） |
-| 收尾 | 收尾合并门禁（ADR 0007）：`merge-branches.js --check` 判已合并 → 全合并则 `return-to-trunk.js` 回主干 + `delete-branches.js` 删分支（主干名探测）；否则三选一（MR / 直合并（临时 worktree） / 确认废弃） |
+| 收尾 | 收尾合并门禁（ADR 0007）：`merge-branches.js --check` 判已合并 → 全合并则 `return-to-trunk.js` 回主干 + `delete-branches.js` 删分支（主干名探测）；否则三选一（MR / 直合并（临时 worktree） / 确认废弃（仅回主干不删分支）） |
 | 要并行新需求 | 转 worktree 模式（init 分支从 origin/main 建，不占本地检出）；本地需求继续占用根 |
 | 升级隔离 | 重跑 cbb-worktree-init（提交随身带走）；先回主干腾检出（return-to-trunk.js） |
 
@@ -174,6 +201,11 @@ node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<需求名>" local_re
 - **问题：** 回主干后未追平远端，本地主干陈旧，下次 `start-local` 从旧基线建分支
 - **修复：** 收尾固定两步脚本：`return-to-trunk.js`（切回主干 + `pull --ff-only` 追平）→ `delete-branches.js` 删分支
 
+### 废弃出口误跑删分支
+
+- **问题：** 选"确认废弃"后照 5.4 全跑，`delete-branches.js` 对未合并的废弃分支 `-D` 强删——远端 `<需求名>-deprecated` 只含已推送部分，本地领先提交只剩 reflog 可捞
+- **修复：** 废弃出口仅执行 5.4 步骤 1（回主干 + 追平）；本地分支保留原名，**不调用** `delete-branches.js`
+
 ### 中途插单静默混入
 
 - **问题：** 用户插的"顺手改一下"与本需求改动混在同一 commit，评审困难
@@ -200,5 +232,6 @@ node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<需求名>" local_re
 - 切分支统一走 `start-local.js`（基线 = `<remote>/<main>`，不取 HEAD）
 - 收尾先过门禁判定（`merge-branches.js --check`）；未合并必须三选一后收尾
 - 直合并走 `merge-branches.js`（临时 worktree，零接触；本地检出由 5.4 `return-to-trunk.js` 切回主干）
-- 收尾脚本化（`return-to-trunk.js` 回主干 + `delete-branches.js` 删分支）完成后报告干净态
+- 废弃出口：先 `deprecate-branches.js --check` 查未推送提交（有 ahead 须用户决策）→ 二次确认后执行；废弃后**仅回主干**（5.4 步骤 1），不删本地分支
+- 收尾脚本化（`return-to-trunk.js` 回主干 + 交付完成出口 `delete-branches.js` 删分支）完成后报告干净态
 - 所有写操作前的分支确认（当前检出 = 需求分支）

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

@@ -9,9 +9,17 @@ require('./silence-popup');
  *
  * 用法：
  *   node deprecate-branches.js <ws_root> <branch> [--apps a,b]
+ *   node deprecate-branches.js <ws_root> <branch> [--apps a,b] --check   # 仅检查，不重命名
+ *
+ * 模式：
+ *   --check      只读检查：逐仓库报远端分支存在性与本地未推送提交数
+ *                （ls-remote 取远端权威 hash 与本地 <branch> 比对）。
+ *                用途：废弃重命名只覆盖远端已推送的部分——本地 ahead 提交
+ *                不会被带进 <branch>-deprecated，执行前须提示用户决策。
+ *   默认         执行远端重命名 <branch> → <branch>-deprecated
  *
  * 退出码：0 全部成功（含 skipped）/ 1 参数错误 / 2 存在失败
- * 末行：DEPRECATE_RESULT [...]
+ * 末行：DEPRECATE_RESULT [...] 或 DEPRECATE_CHECK_RESULT [...]
  */
 
 const { execSync } = require('child_process');
@@ -44,6 +52,51 @@ function loadApps(wsRoot) {
   }
 }
 
+/**
+ * 检查单个仓库（--check，只读）：
+ *   unpushed: 0 = 已全部推送；>0 = 本地领先远端 N 个提交；'all' = 远端无该分支（提交全部未推送）
+ */
+function checkRepo(name, repo, branch) {
+  const rec = { name, status: 'skipped', remote_exists: false, unpushed: 0, 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];
+  if (!run('git rev-parse --verify --quiet "refs/heads/' + branch + '"', repo).ok) {
+    rec.detail = 'no-local-branch';
+    return rec;
+  }
+  const ls = run('git ls-remote --heads "' + r + '" "refs/heads/' + branch + '"', repo);
+  if (!ls.ok) {
+    rec.status = 'failed';
+    rec.detail = 'ls-remote-failed';
+    return rec;
+  }
+  if (!ls.out) {
+    rec.status = 'ok';
+    rec.unpushed = 'all';
+    rec.detail = 'remote-has-no-branch';
+    return rec;
+  }
+  const remoteHash = ls.out.split(/\r?\n/)[0].split(/\s+/)[0];
+  const cnt = run('git rev-list --count "' + remoteHash + '..refs/heads/' + branch + '"', repo);
+  if (!cnt.ok) {
+    rec.status = 'failed';
+    rec.detail = 'rev-list-failed';
+    return rec;
+  }
+  rec.status = 'ok';
+  rec.remote_exists = true;
+  rec.unpushed = parseInt(cnt.out, 10) || 0;
+  return rec;
+}
+
 /** 对单个仓库执行废弃重命名 */
 function deprecateRepo(name, repo, branch) {
   const newName = branch + '-deprecated';
@@ -95,6 +148,7 @@ function main() {
   const appFilter = appsIdx >= 0
     ? new Set((args[appsIdx + 1] || '').split(',').map(s => s.trim()).filter(Boolean))
     : null;
+  const checkOnly = args.includes('--check');
 
   const repos = [{ name: 'workspace', repo: wsRoot }];
   for (const app of loadApps(wsRoot)) {
@@ -102,6 +156,17 @@ function main() {
     repos.push({ name: app.name, repo: path.join(wsRoot, '.codespace', app.name) });
   }
 
+  if (checkOnly) {
+    const results = repos.map(rp => checkRepo(rp.name, rp.repo, branch));
+    results.forEach(r => {
+      const up = r.status === 'ok' && r.unpushed !== 0 ? ' [unpushed: ' + r.unpushed + ']' : '';
+      console.log(r.status.toUpperCase() + ' ' + r.name + (r.detail ? ' — ' + r.detail : '') + up);
+    });
+    console.log('---');
+    console.log('DEPRECATE_CHECK_RESULT', JSON.stringify({ branch, results }));
+    process.exit(results.some(r => r.status === 'failed') ? 2 : 0);
+  }
+
   const results = repos.map(rp => deprecateRepo(rp.name, rp.repo, branch));
 
   results.forEach(r => {
@@ -116,4 +181,4 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { run, loadApps, deprecateRepo };
+module.exports = { run, loadApps, checkRepo, deprecateRepo };

package/cbb/worktrees/skills/cbb-local-mode/scripts/return-to-trunk.js

@@ -21,7 +21,8 @@ require('./silence-popup');
  *      - 检出 dirty（含未跟踪）→ FAIL dirty-worktree（列未提交项数；不自动 stash，交用户决策）
  *      - 本地有主干分支 → git checkout <主干>；仅远端有 → git checkout -b <主干> --track origin/<主干>
  *   5. 追平远端：origin/<主干> 存在 → git pull --ff-only origin <主干>
- *      （本地主干与 origin 分叉 → FAIL pull-failed，交用户决策；远端无主干 → 注记跳过）
+ *      （成功详情注记 `pulled origin/<主干>` / `up-to-date`；本地主干与 origin 分叉 → FAIL
+ *      pull-failed，交用户决策；远端无主干 → 注记跳过）
  *   6. 已在主干 → 跳过切回，仍追平（幂等）
  *
  * 退出码：0 全部成功（含 no-repo / 已在主干）/ 1 参数错误 / 2 任一仓库失败
@@ -160,12 +161,18 @@ function main() {
     }
 
     if (hasRef(rp.repo, 'refs/remotes/origin/' + main)) {
+      const before = run('git rev-parse --quiet HEAD', rp.repo);
       const pull = run('git pull --ff-only --quiet origin "' + main + '"', rp.repo);
       if (!pull.ok) {
         rec.status = 'failed';
         rec.reason = 'pull-failed';
         rec.detail = (pull.err || '').split(/\r?\n/)[0];
         failed = true;
+      } else {
+        const after = run('git rev-parse --quiet HEAD', rp.repo);
+        rec.detail = before.ok && after.ok && before.out !== after.out
+          ? 'pulled origin/' + main
+          : 'up-to-date';
       }
     } else if (!rec.reason) {
       rec.reason = 'no-remote-trunk';

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

@@ -9,9 +9,17 @@ require('./silence-popup');
  *
  * 用法：
  *   node deprecate-branches.js <ws_root> <branch> [--apps a,b]
+ *   node deprecate-branches.js <ws_root> <branch> [--apps a,b] --check   # 仅检查，不重命名
+ *
+ * 模式：
+ *   --check      只读检查：逐仓库报远端分支存在性与本地未推送提交数
+ *                （ls-remote 取远端权威 hash 与本地 <branch> 比对）。
+ *                用途：废弃重命名只覆盖远端已推送的部分——本地 ahead 提交
+ *                不会被带进 <branch>-deprecated，执行前须提示用户决策。
+ *   默认         执行远端重命名 <branch> → <branch>-deprecated
  *
  * 退出码：0 全部成功（含 skipped）/ 1 参数错误 / 2 存在失败
- * 末行：DEPRECATE_RESULT [...]
+ * 末行：DEPRECATE_RESULT [...] 或 DEPRECATE_CHECK_RESULT [...]
  */
 
 const { execSync } = require('child_process');
@@ -44,6 +52,51 @@ function loadApps(wsRoot) {
   }
 }
 
+/**
+ * 检查单个仓库（--check，只读）：
+ *   unpushed: 0 = 已全部推送；>0 = 本地领先远端 N 个提交；'all' = 远端无该分支（提交全部未推送）
+ */
+function checkRepo(name, repo, branch) {
+  const rec = { name, status: 'skipped', remote_exists: false, unpushed: 0, 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];
+  if (!run('git rev-parse --verify --quiet "refs/heads/' + branch + '"', repo).ok) {
+    rec.detail = 'no-local-branch';
+    return rec;
+  }
+  const ls = run('git ls-remote --heads "' + r + '" "refs/heads/' + branch + '"', repo);
+  if (!ls.ok) {
+    rec.status = 'failed';
+    rec.detail = 'ls-remote-failed';
+    return rec;
+  }
+  if (!ls.out) {
+    rec.status = 'ok';
+    rec.unpushed = 'all';
+    rec.detail = 'remote-has-no-branch';
+    return rec;
+  }
+  const remoteHash = ls.out.split(/\r?\n/)[0].split(/\s+/)[0];
+  const cnt = run('git rev-list --count "' + remoteHash + '..refs/heads/' + branch + '"', repo);
+  if (!cnt.ok) {
+    rec.status = 'failed';
+    rec.detail = 'rev-list-failed';
+    return rec;
+  }
+  rec.status = 'ok';
+  rec.remote_exists = true;
+  rec.unpushed = parseInt(cnt.out, 10) || 0;
+  return rec;
+}
+
 /** 对单个仓库执行废弃重命名 */
 function deprecateRepo(name, repo, branch) {
   const newName = branch + '-deprecated';
@@ -95,6 +148,7 @@ function main() {
   const appFilter = appsIdx >= 0
     ? new Set((args[appsIdx + 1] || '').split(',').map(s => s.trim()).filter(Boolean))
     : null;
+  const checkOnly = args.includes('--check');
 
   const repos = [{ name: 'workspace', repo: wsRoot }];
   for (const app of loadApps(wsRoot)) {
@@ -102,6 +156,17 @@ function main() {
     repos.push({ name: app.name, repo: path.join(wsRoot, '.codespace', app.name) });
   }
 
+  if (checkOnly) {
+    const results = repos.map(rp => checkRepo(rp.name, rp.repo, branch));
+    results.forEach(r => {
+      const up = r.status === 'ok' && r.unpushed !== 0 ? ' [unpushed: ' + r.unpushed + ']' : '';
+      console.log(r.status.toUpperCase() + ' ' + r.name + (r.detail ? ' — ' + r.detail : '') + up);
+    });
+    console.log('---');
+    console.log('DEPRECATE_CHECK_RESULT', JSON.stringify({ branch, results }));
+    process.exit(results.some(r => r.status === 'failed') ? 2 : 0);
+  }
+
   const results = repos.map(rp => deprecateRepo(rp.name, rp.repo, branch));
 
   results.forEach(r => {
@@ -116,4 +181,4 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { run, loadApps, deprecateRepo };
+module.exports = { run, loadApps, checkRepo, deprecateRepo };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.5-beta.3",
+  "version": "0.0.5-beta.4",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {