@jspg-ai/coding-bb 0.0.3-beta.21 → 0.0.3-beta.22

package/cbb/worktrees/skills/cbb-worktree-init/scripts/junction-ai-config.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * worktree 模式 AI 配置 junction（ADR 0002，防线 B）。
+ *
+ * 用法：node junction-ai-config.js <ws_root> <wt_path>
+ *
+ * 目的：让开发会话能开进 worktree（工作树内加载 AI 配置），同时保持
+ * 「单层安装」实质——配置唯一物理副本在空间根，cbb update 一处生效。
+ *
+ * 策略（规避 ADR 0001 否决时的状态污染）：
+ *   - 只 junction **只读内容子目录**（rules / skills / commands）：
+ *     工具向配置根写状态（如 settings.local.json）落在 worktree 自建的
+ *     物理（空壳）配置目录里，按项目隔离，不互相覆盖；
+ *   - 配置根目录本身在 worktree 侧是物理目录（不是链接）；
+ *   - .opencode/opencode.json 为文件（junction 不支持文件）：直接复制
+ *     （cbb update 后需重跑本脚本同步；worktree 为瞬态，影响可控）。
+ *
+ * 幂等：linkPath 已指向同一 target → skip；指向不同 → 重建；
+ *       存在同名**物理目录**（非链接）→ warn 跳过（不覆盖用户内容）。
+ *
+ * 退出码：0 成功（含全部 skip）；1 参数错误；2 执行失败。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const wtPath = process.argv[3];
+
+if (!wsRoot || !wtPath) {
+  console.error('Usage: node junction-ai-config.js <ws_root> <wt_path>');
+  process.exit(1);
+}
+
+// 各工具的项目级配置根（存在才处理）与本包部署的内容子目录
+const CONFIG_ROOTS = ['.claude', '.qoder', '.opencode', '.workbuddy', '.trae'];
+const CONTENT_SUBDIRS = ['rules', 'skills', 'commands'];
+// 文件级内容（复制而非 junction）：opencode 的 instructions 登记
+const CONTENT_FILES = { '.opencode': ['opencode.json'] };
+
+const linked = [];
+const copied = [];
+const skipped = [];
+const warned = [];
+let hasFailure = false;
+
+/** 归一化 junction 目标路径（Windows readlink 返回 \\?\ 前缀） */
+function normLinkTarget(p) {
+  return path.resolve(String(p).replace(/^\\\\\?\\/, ''));
+}
+
+function linkDir(target, linkPath, label) {
+  if (fs.existsSync(linkPath)) {
+    const st = fs.lstatSync(linkPath);
+    if (st.isSymbolicLink()) {
+      const existing = normLinkTarget(fs.readlinkSync(linkPath));
+      if (existing === path.resolve(target)) {
+        skipped.push(label);
+        return;
+      }
+      fs.unlinkSync(linkPath); // 指向不同 → 重建
+    } else if (st.isDirectory()) {
+      warned.push(label + '（存在同名物理目录，未覆盖）');
+      return;
+    } else {
+      fs.unlinkSync(linkPath); // 同名文件，罕见，重建
+    }
+  }
+  fs.mkdirSync(path.dirname(linkPath), { recursive: true });
+  try {
+    if (process.platform === 'win32') {
+      fs.symlinkSync(path.resolve(target), linkPath, 'junction');
+    } else {
+      fs.symlinkSync(path.resolve(target), linkPath, 'dir');
+    }
+    linked.push(label);
+  } catch (e) {
+    console.error('❌ junction 失败 ' + label + ' — ' + e.message);
+    hasFailure = true;
+  }
+}
+
+function copyFile(target, dest, label) {
+  if (fs.existsSync(dest) && fs.existsSync(target) &&
+      fs.readFileSync(dest, 'utf-8') === fs.readFileSync(target, 'utf-8')) {
+    skipped.push(label);
+    return;
+  }
+  try {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(target, dest);
+    copied.push(label);
+  } catch (e) {
+    console.error('❌ 复制失败 ' + label + ' — ' + e.message);
+    hasFailure = true;
+  }
+}
+
+for (const root of CONFIG_ROOTS) {
+  const srcRoot = path.join(wsRoot, root);
+  if (!fs.existsSync(srcRoot) || !fs.statSync(srcRoot).isDirectory()) continue;
+
+  for (const sub of CONTENT_SUBDIRS) {
+    const src = path.join(srcRoot, sub);
+    if (!fs.existsSync(src) || !fs.statSync(src).isDirectory()) continue;
+    linkDir(src, path.join(wtPath, root, sub), root + '/' + sub);
+  }
+
+  for (const file of (CONTENT_FILES[root] || [])) {
+    const src = path.join(srcRoot, file);
+    if (!fs.existsSync(src) || !fs.statSync(src).isFile()) continue;
+    copyFile(src, path.join(wtPath, root, file), root + '/' + file);
+  }
+}
+
+if (linked.length === 0 && copied.length === 0 && skipped.length === 0 && warned.length === 0) {
+  console.log('ℹ️  空间根无 AI 配置目录，跳过（cbb setup 选择工具后再装）');
+} else {
+  if (linked.length) console.log('✅ junction：' + linked.join(', '));
+  if (copied.length) console.log('✅ 复制：' + copied.join(', '));
+  if (skipped.length) console.log('⏭️  已就绪：' + skipped.join(', '));
+  if (warned.length) console.log('⚠️  ' + warned.join('；'));
+}
+
+console.log('---');
+console.log('JUNCTION_RESULT', JSON.stringify({ linked, copied, skipped, warned, wt: wtPath }));
+process.exit(hasFailure ? 2 : 0);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/sync-repos.js

@@ -19,6 +19,7 @@ require('./silence-popup');
 const { execSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const { installTo: installGitHook } = require('./install-git-hook');
 
 const wsRoot = process.argv[2];
 
@@ -77,7 +78,10 @@ for (const app of apps) {
     // 不存在：clone
     try {
       execSync('git clone -q "' + app.repo + '" "' + target + '"', { stdio: 'pipe' });
-      console.log('✅ ' + app.name + ': 代码已拉取（clone）');
+      // 兜底 clone 出的应用同步装分支感知 pre-commit hook（ADR 0002；
+      // cbb setup 首次 clone 已装，此处幂等补齐）
+      installGitHook(target);
+      console.log('✅ ' + app.name + ': 代码已拉取（clone + 提交防线 hook）');
       results.push({ name: app.name, status: 'cloned' });
     } catch (e) {
       console.error('❌ ' + app.name + ': clone 失败 — ' + app.repo);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/update-gitignore.js

@@ -7,8 +7,8 @@ require('./silence-popup');
  *
  * 行为：
  *   1. stash 当前未提交修改（仅 untracked 时不产生 stash）
- *   2. 目标分支不存在则从 HEAD 创建（首跑时分支尚未由 create-branches.js 建立，
- *      顺序无关自愈；create-branches.js 后续会报 reused）
+ *   2. 目标分支不存在则从 <remote>/<main> 创建（首跑时分支尚未由 create-branches.js 建立，
+ *      顺序无关自愈；create-branches.js 后续会报 reused；基线不取 HEAD，见 ADR 0002）
  *   3. 切换到目标分支
  *   4. 检查 .worktrees/ 和 .codespace/ 是否在 .gitignore，缺失则添加并提交
  *   5. 切回原分支
@@ -81,16 +81,28 @@ if (status.ok && status.out) {
   console.log('ℹ️  无未提交修改，跳过 stash');
 }
 
-// 2.1 目标分支不存在则从 HEAD 创建（Step 3.2 先于 Step 3.3 执行时分支尚未建立）
+// 2.1 目标分支不存在则创建（Step 3.2 先于 Step 3.3 执行时分支尚未建立）
+// 基线取 <remote>/<main>（ADR 0002，与 create-branches.js 一致）：本地模式进行中根可能检出在
+// feature 分支，从 HEAD 建会把未合并的开发态带进新分支；无 remote 时回退 HEAD
 const branchList = run('git branch --list "' + branch + '"', wsRoot);
 if (branchList.ok && !branchList.out) {
-  const create = run('git branch "' + branch + '"', wsRoot);
+  const remoteOut = run('git remote', wsRoot);
+  let base = 'HEAD';
+  if (remoteOut.ok && remoteOut.out) {
+    const r = remoteOut.out.split(/\r?\n/)[0];
+    const symbolic = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', wsRoot);
+    const main = (symbolic.ok && symbolic.out)
+      ? symbolic.out.replace('refs/remotes/' + r + '/', '')
+      : 'main';
+    base = r + '/' + main;
+  }
+  const create = run('git branch "' + branch + '" "' + base + '"', wsRoot);
   if (!create.ok) {
     console.error('❌ 创建分支 ' + branch + ' 失败：' + create.err);
     if (stashed) run('git stash pop', wsRoot);
     process.exit(2);
   }
-  console.log('✅ 分支 ' + branch + ' 不存在，已从 HEAD 创建');
+  console.log('✅ 分支 ' + branch + ' 不存在，已从 ' + base + ' 创建');
 }
 
 // 3. 切换到目标分支

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

@@ -3,9 +3,9 @@ name: cbb-worktree-push
 description: "提交并推送当前需求的所有关联仓库（跨 worktree 批量），推送后提案生成 MR（合并请求）预填链接。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'/'提MR'/'提合并请求'/'merge request'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-worktree 前需要先推送未提交改动。注意：本技能会先识别场景——不在 cbb 工作空间时降级为普通单仓库提交推送。"
 ---
 
-# Push Worktrees（跨平台脚本化版本 v1.1）
+# Push Worktrees（跨平台脚本化版本 v2.0）
 
-提交并推送当前需求的所有关联仓库（跨 worktree 批量）。专门解决"开发完成后批量推送"和"用户口语化提交并push"两类场景，弥补 [cbb-worktree-init Step 3.4](file:///d:/workspace/va-ai/coding-bb/cbb/worktrees/skills/cbb-worktree-init/SKILL.md) 仅推送初始空 commit 的缺口。
+提交并推送当前需求的所有关联仓库（跨仓库批量，ADR 0002 双布局：worktree 布局或本地模式布局自动发现）。专门解决"开发完成后批量推送"和"用户口语化提交并push"两类场景——本技能是**唯一的远端推送出口**（cbb-worktree-init 自 0.0.3-beta.22 起 lazy push，创建流程零远端副作用；首次 push 自动建立 upstream）。
 
 > **本技能描述含宽泛触发词（"提交"/"push"），允许被误触发**。因此第一步永远是 **Step 0 场景识别**：在 cbb 工作空间内才走跨 worktree 批量流程；在普通 git 仓库降级为单仓库提交推送；非 git 目录则退出。
 
@@ -91,9 +91,9 @@ node "<skill_dir>/scripts/find-target-worktree.js" "<ws_root>"
 ```
 
 **解读末行**：
-- 退出码 0 + 末行（需求名） → 唯一识别，自动用之
-- 退出码 1 + 末行 `MULTIPLE_WORKTREEES` → 多个 worktree，AI agent 在对话中让用户输入序号或分支名
-- 退出码 2 + 末行 `NO_WORKTREE` → 无 worktree，提示用户先用 `cbb-worktree-init`
+- 退出码 0 + 末行（需求名） → 唯一识别，自动用之（脚本自动合并 worktree 布局与本地模式布局候选，`（local）` 标本地模式进行中）
+- 退出码 1 + 末行 `MULTIPLE_WORKTREEES` → 多个进行中需求，AI agent 在对话中让用户输入序号或分支名
+- 退出码 2 + 末行 `NO_WORKTREE` → 无进行中需求，提示用户先执行 `cbb-worktree-init`（worktree 模式）或 `cbb-local-mode`（本地模式）
 
 ---
 

package/cbb/worktrees/skills/cbb-worktree-push/scripts/commit-worktrees.js

@@ -7,7 +7,9 @@ require('./silence-popup');
  *   node commit-worktrees.js <wt_path> --message "msg" [options]
  *
  * 行为：
- *   1. 扫描 <ws_root>/.worktrees/worktree-<branch>/ 下所有 git 仓库
+ *   1. 按需求名发现参与仓库（ADR 0002 双布局）：
+ *      - worktree 布局：.worktrees/worktree-<branch>/ 下所有 git 仓库
+ *      - 本地布局：根 / .codespace/<app>/ 检出恰在 <branch> 分支上
  *   2. 对每个仓库：
  *      a. git status --porcelain 检测 dirty
  *      b. 若 clean 或已有 ahead commit → 跳过
@@ -95,23 +97,57 @@ function isGitRepo(p) {
   return fs.existsSync(path.join(p, '.git'));
 }
 
+function currentBranch(p) {
+  try {
+    return execSync('git branch --show-current', { cwd: p, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).toString().trim();
+  } catch (e) { return ''; }
+}
+
+/**
+ * 按需求名发现参与仓库（ADR 0002 双布局）：
+ *   布局一 worktree：.worktrees/worktree-<branch>/ 下 workspace + 嵌套 app worktree
+ *   布局二 本地模式：根 / .codespace/<app>/ 的检出恰在 <branch> 分支上（同名仓库以 worktree 布局优先）
+ * 两者皆空 → error。
+ */
 function scanWorktreeRepos(wsRoot, branch) {
   const wtRoot = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
   const repos = [];
-  if (!fs.existsSync(wtRoot)) {
-    return { wtRoot, repos, error: 'worktree 目录不存在：' + wtRoot };
+
+  // 布局一：worktree
+  if (fs.existsSync(wtRoot)) {
+    if (isGitRepo(wtRoot)) {
+      repos.push({ name: 'workspace', wt: wtRoot, repo: wsRoot, layout: 'worktree' });
+    }
+    const entries = fs.readdirSync(wtRoot, { withFileTypes: true });
+    for (const e of entries) {
+      if (!e.isDirectory() || e.name.startsWith('.')) continue;
+      const appWt = path.join(wtRoot, e.name);
+      if (!isGitRepo(appWt)) continue;
+      repos.push({ name: e.name, wt: appWt, repo: path.join(wsRoot, '.codespace', e.name), layout: 'worktree' });
+    }
   }
-  if (isGitRepo(wtRoot)) {
-    repos.push({ name: 'workspace', wt: wtRoot, repo: wsRoot });
+
+  // 布局二：本地模式（检出在需求分支上）
+  const names = new Set(repos.map(r => r.name));
+  if (!names.has('workspace') && isGitRepo(wsRoot) && currentBranch(wsRoot) === branch) {
+    repos.push({ name: 'workspace', wt: wsRoot, repo: wsRoot, layout: 'local' });
   }
-  const entries = fs.readdirSync(wtRoot, { withFileTypes: true });
-  for (const e of entries) {
-    if (!e.isDirectory() || e.name.startsWith('.')) continue;
-    const appWt = path.join(wtRoot, e.name);
-    if (!isGitRepo(appWt)) continue;
-    repos.push({ name: e.name, wt: appWt, repo: path.join(wsRoot, '.codespace', e.name) });
+  const codeDir = path.join(wsRoot, '.codespace');
+  if (fs.existsSync(codeDir)) {
+    for (const name of fs.readdirSync(codeDir).sort()) {
+      if (names.has(name)) continue;
+      const appDir = path.join(codeDir, name);
+      if (!isGitRepo(appDir)) continue;
+      if (currentBranch(appDir) === branch) {
+        repos.push({ name, wt: appDir, repo: appDir, layout: 'local' });
+      }
+    }
   }
-  return { wtRoot, repos, error: null };
+
+  const error = repos.length === 0
+    ? ('未发现需求 ' + branch + ' 的参与仓库（worktree 不存在，且无仓库检出在 ' + branch + ' 分支上）')
+    : null;
+  return { wtRoot, repos, error };
 }
 
 function run(cmd, cwd) {

package/cbb/worktrees/skills/cbb-worktree-push/scripts/find-target-worktree.js

@@ -1,96 +1,148 @@
-require('./silence-popup');
-/**
- * openspec-shared 目标需求名识别
- *
- * 唯一真源：cbb/worktrees/_shared/scripts/find-target-worktree.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（extend / close / push）。
- *
- * 用法：node find-target-worktree.js <ws_root>
- *
- * 优先级：
- *   1. cwd 在 .worktrees/worktree-xxx/ 内 → 自动从路径反推
- *   2. .worktrees/ 下只有一个 worktree → 自动选用
- *   3. 多个 worktree → 按 mtime 倒序，第一个为推荐
- *
- * 输出：
- *   末行输出需求名（用于 AI agent 解析）
- *   多个时按 [1] xxx ⭐ / [2] yyy 列出
- *
- * 退出码：
- *   0 - 唯一识别（自动或唯一）
- *   1 - 多个 worktree，需用户输入
- *   2 - 无 worktree
- */
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const wsRoot = process.argv[2];
-
-if (!wsRoot) {
-  console.error('❌ 用法：node find-target-worktree.js <ws_root>');
-  process.exit(1);
-}
-
-// 优先级 1：cwd 反推
-const cwd = process.cwd();
-const cwdMatch = cwd.match(/\.worktrees[\\\/]worktree-([^\\\/]+)/);
-if (cwdMatch) {
-  const branch = cwdMatch[1];
-  console.log('✅ 从 cwd 反推需求名：' + branch);
-  console.log('---');
-  console.log(branch);
-  process.exit(0);
-}
-
-const worktreesDir = path.join(wsRoot, '.worktrees');
-if (!fs.existsSync(worktreesDir)) {
-  console.error('❌ .worktrees 目录不存在：' + worktreesDir);
-  console.error('   请先执行 cbb-worktree-init 创建 worktree');
-  console.log('---');
-  console.log('NO_WORKTREE');
-  process.exit(2);
-}
-
-// 列出所有 worktree-xxx 目录
-const entries = fs.readdirSync(worktreesDir, { withFileTypes: true })
-  .filter(e => e.isDirectory() && e.name.startsWith('worktree-'))
-  .map(e => ({
-    name: e.name.substring('worktree-'.length),
-    fullName: e.name,
-    path: path.join(worktreesDir, e.name),
-    mtime: fs.statSync(path.join(worktreesDir, e.name)).mtime.getTime(),
-  }));
-
-if (entries.length === 0) {
-  console.error('❌ 未找到任何 worktree');
-  console.error('   请先执行 cbb-worktree-init 创建 worktree');
-  console.log('---');
-  console.log('NO_WORKTREE');
-  process.exit(2);
-}
-
-// 优先级 2：唯一
-if (entries.length === 1) {
-  console.log('✅ 自动选用唯一 worktree：' + entries[0].name);
-  console.log('---');
-  console.log(entries[0].name);
-  process.exit(0);
-}
-
-// 优先级 3：多个 → 按 mtime 倒序
-entries.sort((a, b) => b.mtime - a.mtime);
-
-console.log('⚠️  检测到 ' + entries.length + ' 个 worktree（按最近修改排序）：');
-entries.forEach((e, i) => {
-  if (i === 0) {
-    console.log('  [' + (i + 1) + '] ' + e.name + '  ⭐ (推荐：最近修改)');
-  } else {
-    console.log('  [' + (i + 1) + '] ' + e.name);
-  }
-});
-console.log('请在对话中输入序号(1/2/3)或完整分支名：');
-console.log('---');
-console.log('MULTIPLE_WORKTREEES');
-process.exit(1);
+require('./silence-popup');
+/**
+ * openspec-shared 目标需求名识别
+ *
+ * 唯一真源：cbb/worktrees/_shared/scripts/find-target-worktree.js
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（extend / close / push）。
+ *
+ * 用法：node find-target-worktree.js <ws_root>
+ *
+ * 优先级（ADR 0002 双布局）：
+ *   1. cwd 在 .worktrees/worktree-xxx/ 内 → 自动从路径反推
+ *   2. 收集候选：worktree 目录（.worktrees/worktree-xxx）
+ *      + 本地布局（根 / .codespace/<app>/ 检出在非主干分支，本地模式进行中）
+ *      同一需求名两种布局共存时合并为一项（标 both）
+ *   3. 唯一候选 → 自动选用；多个 → 按 mtime 倒序列出（本地布局用分支检出时间）
+ *
+ * 输出：
+ *   末行输出需求名（用于 AI agent 解析）
+ *   多个时按 [1] xxx ⭐ / [2] yyy 列出
+ *
+ * 退出码：
+ *   0 - 唯一识别（自动或唯一）
+ *   1 - 多个候选，需用户输入
+ *   2 - 无候选（无 worktree 且无本地布局检出）
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+
+if (!wsRoot) {
+  console.error('❌ 用法：node find-target-worktree.js <ws_root>');
+  process.exit(1);
+}
+
+function run(cmd, cwd) {
+  try {
+    return execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+  } catch (e) { return null; }
+}
+
+function currentBranch(cwd) {
+  return run('git branch --show-current', cwd) || '';
+}
+
+/** 主干名（探测失败返回 null → 该仓库任何非空检出都视为候选） */
+function detectMain(cwd) {
+  const remotes = run('git remote', cwd);
+  if (remotes) {
+    const r = remotes.split(/\r?\n/)[0];
+    const sym = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', cwd);
+    if (sym) return sym.replace('refs/remotes/' + r + '/', '');
+  }
+  if (run('git rev-parse --verify --quiet refs/heads/main', cwd)) return 'main';
+  if (run('git rev-parse --verify --quiet refs/heads/master', cwd)) return 'master';
+  return null;
+}
+
+// 优先级 1：cwd 反推
+const cwd = process.cwd();
+const cwdMatch = cwd.match(/\.worktrees[\\\/]worktree-([^\\\/]+)/);
+if (cwdMatch) {
+  const branch = cwdMatch[1];
+  console.log('✅ 从 cwd 反推需求名：' + branch);
+  console.log('---');
+  console.log(branch);
+  process.exit(0);
+}
+
+// 优先级 2a：worktree 目录候选
+const candidates = new Map(); // name → { layouts: Set, mtime }
+
+const worktreesDir = path.join(wsRoot, '.worktrees');
+if (fs.existsSync(worktreesDir)) {
+  const entries = fs.readdirSync(worktreesDir, { withFileTypes: true })
+    .filter(e => e.isDirectory() && e.name.startsWith('worktree-'));
+  for (const e of entries) {
+    const name = e.name.substring('worktree-'.length);
+    const full = path.join(worktreesDir, e.name);
+    const item = candidates.get(name) || { layouts: new Set(), mtime: 0 };
+    item.layouts.add('worktree');
+    item.mtime = Math.max(item.mtime, fs.statSync(full).mtime.getTime());
+    candidates.set(name, item);
+  }
+}
+
+// 优先级 2b：本地布局候选（根 + .codespace/<app>/ 检出在非主干分支）
+function addLocalCandidate(name, cwdPath) {
+  if (!name) return;
+  const item = candidates.get(name) || { layouts: new Set(), mtime: 0 };
+  item.layouts.add('local');
+  try {
+    item.mtime = Math.max(item.mtime, fs.statSync(path.join(cwdPath, '.git')).mtime.getTime());
+  } catch (_) { /* .git 状态时间不可读则保持 */ }
+  candidates.set(name, item);
+}
+
+const rootMain = detectMain(wsRoot);
+const rootBranch = currentBranch(wsRoot);
+if (rootBranch && (!rootMain || rootBranch !== rootMain)) {
+  addLocalCandidate(rootBranch, wsRoot);
+}
+
+const codeDir = path.join(wsRoot, '.codespace');
+if (fs.existsSync(codeDir)) {
+  for (const app of fs.readdirSync(codeDir).sort()) {
+    const appDir = path.join(codeDir, app);
+    if (!fs.existsSync(path.join(appDir, '.git'))) continue;
+    const appMain = detectMain(appDir);
+    const appBranch = currentBranch(appDir);
+    if (appBranch && (!appMain || appBranch !== appMain)) {
+      addLocalCandidate(appBranch, appDir);
+    }
+  }
+}
+
+if (candidates.size === 0) {
+  console.error('❌ 未找到任何进行中的需求（无 worktree，且无仓库检出在非主干分支）');
+  console.error('   worktree 模式请先执行 cbb-worktree-init；本地模式请先执行 cbb-local-mode');
+  console.log('---');
+  console.log('NO_WORKTREE');
+  process.exit(2);
+}
+
+// 唯一候选 → 自动选用
+if (candidates.size === 1) {
+  const [name] = [...candidates.keys()];
+  const layouts = [...candidates.get(name).layouts].join('+');
+  console.log('✅ 自动选用唯一进行中需求：' + name + '（' + layouts + '）');
+  console.log('---');
+  console.log(name);
+  process.exit(0);
+}
+
+// 多候选 → 按 mtime 倒序列出
+const sorted = [...candidates.entries()].sort((a, b) => b[1].mtime - a[1].mtime);
+console.log('⚠️  检测到 ' + sorted.length + ' 个进行中的需求（按最近活动排序）：');
+sorted.forEach(([name, item], i) => {
+  const layouts = [...item.layouts].join('+');
+  const tag = i === 0 ? '  ⭐ (推荐：最近活动)' : '';
+  console.log('  [' + (i + 1) + '] ' + name + '（' + layouts + '）' + tag);
+});
+console.log('请在对话中输入序号(1/2/3)或完整分支名：');
+console.log('---');
+console.log('MULTIPLE_WORKTREEES');
+process.exit(1);

package/cbb/worktrees/skills/cbb-worktree-push/scripts/push-worktrees.js

@@ -7,7 +7,9 @@ require('./silence-popup');
  *   node push-worktrees.js <wt_path>          # wt_path 必须是 <ws_root>/.worktrees/worktree-<branch> 形态
  *
  * 行为：
- *   1. 扫描 <ws_root>/.worktrees/worktree-<branch>/ 下所有 git 仓库（workspace + 各 app 子 worktree）
+ *   1. 按需求名发现参与仓库（ADR 0002 双布局）：
+ *      - worktree 布局：.worktrees/worktree-<branch>/ 下所有 git 仓库（workspace + 各 app 子 worktree）
+ *      - 本地布局：根 / .codespace/<app>/ 检出恰在 <branch> 分支上
  *   2. 对每个仓库调 push-core.pushSingle（已建立 upstream 时直接 push -u；否则建立 upstream）
  *   3. 逐个报告状态，输出末行 PUSH_RESULT
  *
@@ -28,6 +30,7 @@ require('./silence-popup');
 const { pushSingle } = require('./push-core');
 const fs = require('fs');
 const path = require('path');
+const { execSync } = require('child_process');
 
 function resolveInputs(argv) {
   // argv[2] 单独：wt_path 形式
@@ -56,35 +59,57 @@ function isGitRepo(p) {
   }
 }
 
+function currentBranch(p) {
+  try {
+    return execSync('git branch --show-current', { cwd: p, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).toString().trim();
+  } catch (e) { return ''; }
+}
+
 /**
- * 扫描 worktree 下的所有 git 仓库
- * - workspace worktree：<ws_root>/.worktrees/worktree-<branch>/ 本身
- * - app worktree：<ws_root>/.worktrees/worktree-<branch>/<app_name>/（嵌套子目录）
+ * 按需求名发现参与仓库（ADR 0002 双布局）：
+ *   布局一 worktree：.worktrees/worktree-<branch>/ 下 workspace + 嵌套 app worktree
+ *   布局二 本地模式：根 / .codespace/<app>/ 的检出恰在 <branch> 分支上（同名仓库以 worktree 布局优先）
+ * 两者皆空 → error。
  */
 function scanWorktreeRepos(wsRoot, branch) {
   const wtRoot = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
   const repos = [];
 
-  if (!fs.existsSync(wtRoot)) {
-    return { wtRoot, repos, error: 'worktree 目录不存在：' + wtRoot };
+  // 布局一：worktree
+  if (fs.existsSync(wtRoot)) {
+    if (isGitRepo(wtRoot)) {
+      repos.push({ name: 'workspace', wt: wtRoot, repo: wsRoot, layout: 'worktree' });
+    }
+    const entries = fs.readdirSync(wtRoot, { withFileTypes: true });
+    for (const e of entries) {
+      if (!e.isDirectory() || e.name.startsWith('.')) continue;
+      const appWt = path.join(wtRoot, e.name);
+      if (!isGitRepo(appWt)) continue;
+      repos.push({ name: e.name, wt: appWt, repo: path.join(wsRoot, '.codespace', e.name), layout: 'worktree' });
+    }
   }
 
-  // workspace worktree（自身是 git worktree）
-  if (isGitRepo(wtRoot)) {
-    repos.push({ name: 'workspace', wt: wtRoot, repo: wsRoot });
+  // 布局二：本地模式（检出在需求分支上）
+  const names = new Set(repos.map(r => r.name));
+  if (!names.has('workspace') && isGitRepo(wsRoot) && currentBranch(wsRoot) === branch) {
+    repos.push({ name: 'workspace', wt: wsRoot, repo: wsRoot, layout: 'local' });
   }
-
-  // app worktree（嵌套子目录）
-  const entries = fs.readdirSync(wtRoot, { withFileTypes: true });
-  for (const e of entries) {
-    if (!e.isDirectory()) continue;
-    // 跳过 . 开头的隐藏目录（如 .va、.claude、.qoder）
-    if (e.name.startsWith('.')) continue;
-    const appWt = path.join(wtRoot, e.name);
-    if (!isGitRepo(appWt)) continue;
-    repos.push({ name: e.name, wt: appWt, repo: path.join(wsRoot, '.codespace', e.name) });
+  const codeDir = path.join(wsRoot, '.codespace');
+  if (fs.existsSync(codeDir)) {
+    for (const name of fs.readdirSync(codeDir).sort()) {
+      if (names.has(name)) continue;
+      const appDir = path.join(codeDir, name);
+      if (!isGitRepo(appDir)) continue;
+      if (currentBranch(appDir) === branch) {
+        repos.push({ name, wt: appDir, repo: appDir, layout: 'local' });
+      }
+    }
   }
-  return { wtRoot, repos, error: null };
+
+  const error = repos.length === 0
+    ? ('未发现需求 ' + branch + ' 的参与仓库（worktree 不存在，且无仓库检出在 ' + branch + ' 分支上）')
+    : null;
+  return { wtRoot, repos, error };
 }
 
 /**