@jspg-ai/coding-bb 0.0.1

package/cbb/worktrees/skills/openspec-push-worktrees/scripts/find-workspace-root.js

@@ -0,0 +1,67 @@
+require('./silence-popup');
+/**
+ * openspec-shared 工作空间根目录定位
+ *
+ * 唯一真源：cbb/worktrees/_shared/scripts/find-workspace-root.js
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
+ *
+ * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 CONFIG.json 副本干扰）
+ * 兜底：当前目录含 CONFIG.json
+ *
+ * 退出码：
+ *   0 - 定位成功，输出 WS_ROOT 绝对路径
+ *   1 - 未找到工作空间根目录
+ *
+ * 输出格式：
+ *   第一行：人类可读报告
+ *   最后一行：纯路径（便于 AI agent 解析后用于 cd）
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function tryExec(cmd) {
+  try {
+    return { ok: true, out: execSync(cmd, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).trim() };
+  } catch (e) {
+    return { ok: false };
+  }
+}
+
+let wsRoot = '';
+
+// 优先：git worktree list 第一行
+const worktreeList = tryExec('git worktree list');
+if (worktreeList.ok) {
+  const firstLine = worktreeList.out.split('\n')[0];
+  if (firstLine) {
+    // 格式：<path> <sha> [<branch>]
+    const candidate = firstLine.split(/\s+/)[0];
+    if (candidate && fs.existsSync(candidate)) {
+      wsRoot = candidate;
+    }
+  }
+}
+
+// 兜底：当前目录含 CONFIG.json
+if (!wsRoot) {
+  const cwd = process.cwd();
+  if (fs.existsSync(path.join(cwd, 'CONFIG.json'))) {
+    wsRoot = cwd;
+  }
+}
+
+// 校验
+if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'CONFIG.json'))) {
+  console.error('❌ 未找到工作空间根目录');
+  console.error('   原因：git worktree list 失败且当前目录无 CONFIG.json');
+  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 CONFIG.json）下执行本技能');
+  process.exit(1);
+}
+
+console.log('✅ 工作空间根目录：' + wsRoot);
+console.log('---');
+// 最后一行输出纯路径，AI agent 可直接 cd 使用
+console.log(wsRoot);
+process.exit(0);

package/cbb/worktrees/skills/openspec-push-worktrees/scripts/push-core.js

@@ -0,0 +1,136 @@
+require('./silence-popup');
+/**
+ * openspec-shared 推送核心模块
+ *
+ * 唯一真源：cbb/worktrees/_shared/scripts/push-core.js
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init-worktree / extend-worktree / push-worktrees）。
+ *
+ * 公开 API：
+ *   - tryExec(cmd, cwd, execImpl)             包装 execSync，统一返回 {ok, out|err}
+ *   - escapeBranch(name)                      分支名 shell 转义（防命令注入）
+ *   - classifyError(stderr)                   将 stderr 归类为 8 种错误码之一
+ *   - pushSingle(repoPath, repoName, branch)  推送单个仓库并建立 upstream
+ *   - collectRemoteMetadata(repoPath, branch, remote)  采集远程 commit 元信息
+ *
+ * 错误码契约（classifyError 输出）：
+ *   - ssh-auth-failed        Permission denied (publickey)
+ *   - https-auth-failed      Authentication failed
+ *   - network-unreachable    Could not resolve host / hung up / connection refused
+ *   - branch-protected       protected branch / deny updating
+ *   - remote-exists          already exists
+ *   - no-remote              (pushSingle 内部判定)
+ *   - non-fast-forward       non-fast-forward
+ *   - unknown                兜底
+ */
+
+const { execSync: realExecSync } = require('child_process');
+
+const PUSH_TIMEOUT_MS = 60000;
+
+function tryExec(cmd, cwd, execImpl) {
+  const execSync = (execImpl || realExecSync);
+  try {
+    return {
+      ok: true,
+      out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], timeout: PUSH_TIMEOUT_MS }).toString().trim(),
+    };
+  } catch (e) {
+    const stderr = (e.stderr ? e.stderr.toString() : e.message || String(e)).trim();
+    return { ok: false, err: stderr };
+  }
+}
+
+function escapeBranch(name) {
+  return '"' + String(name).replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+}
+
+function classifyError(stderr) {
+  const s = (stderr || '').toLowerCase();
+  if (s.includes('permission denied (publickey)')) return 'ssh-auth-failed';
+  if (s.includes('authentication failed')) return 'https-auth-failed';
+  if (s.includes('could not resolve host') || s.includes('hung up') || s.includes('connection refused')) {
+    return 'network-unreachable';
+  }
+  if (s.includes('protected branch') || s.includes('deny updating')) return 'branch-protected';
+  if (s.includes('already exists')) return 'remote-exists';
+  if (s.includes('non-fast-forward')) return 'non-fast-forward';
+  return 'unknown';
+}
+
+/**
+ * 采集远程分支的元信息（hash/author/date/message + 本地 hash）
+ * 任意子命令失败时返回 null（不抛错）
+ * @param {string} repoPath
+ * @param {string} branch
+ * @param {string} remote
+ * @param {{ execSyncImpl?: Function }} [opts]
+ * @returns {{ remote: {hash, author, date, message}, local: {hash} } | null}
+ */
+function collectRemoteMetadata(repoPath, branch, remote, opts) {
+  const execImpl = opts && opts.execSyncImpl;
+  try {
+    const remoteHash = tryExec('git rev-parse ' + escapeBranch(remote + '/' + branch), repoPath, execImpl);
+    if (!remoteHash.ok || !remoteHash.out) return null;
+
+    const remoteLog = tryExec('git log -1 --format="%an <%ae> | %ad | %s" ' + escapeBranch(remote + '/' + branch), repoPath, execImpl);
+    const localHash = tryExec('git rev-parse ' + escapeBranch(branch), repoPath, execImpl);
+    if (!remoteLog.ok || !localHash.ok || !localHash.out) return null;
+
+    // 解析 "author <email> | date | message"
+    const parts = remoteLog.out.split(' | ');
+    const author = parts[0] || '';
+    const date = parts[1] || '';
+    const message = parts.slice(2).join(' | ') || '';
+
+    return {
+      remote: {
+        hash: remoteHash.out,
+        author,
+        date,
+        message,
+      },
+      local: {
+        hash: localHash.out,
+      },
+    };
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * 推送单个仓库的分支并建立 upstream
+ * @param {string} repoPath
+ * @param {string} repoName
+ * @param {string} branch
+ * @param {{ execSyncImpl?: Function }} [opts]
+ * @returns {{ name: string, status: string, upstream?: string, error?: string, message?: string, metadata?: object }}
+ */
+function pushSingle(repoPath, repoName, branch, opts) {
+  const execImpl = opts && opts.execSyncImpl;
+  const remote = tryExec('git remote', repoPath, execImpl);
+  if (!remote.ok || !remote.out) {
+    return { name: repoName, status: 'failed', error: 'no-remote', message: '无远程配置' };
+  }
+  const r = remote.out.split(/\r?\n/)[0];
+  const branchEsc = escapeBranch(branch);
+  const remoteEsc = '"' + String(r).replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+  const pushResult = tryExec('git push -u ' + remoteEsc + ' ' + branchEsc, repoPath, execImpl);
+  if (pushResult.ok) {
+    return { name: repoName, status: 'pushed', upstream: r + '/' + branch };
+  }
+  const errCode = classifyError(pushResult.err);
+  if (errCode === 'remote-exists') {
+    const metadata = collectRemoteMetadata(repoPath, branch, r, opts);
+    return {
+      name: repoName,
+      status: 'remote-exists',
+      error: errCode,
+      message: '远程分支已存在，需用户决策',
+      metadata,
+    };
+  }
+  return { name: repoName, status: 'failed', error: errCode, message: pushResult.err.split(/\r?\n/)[0] };
+}
+
+module.exports = { tryExec, escapeBranch, classifyError, pushSingle, collectRemoteMetadata };

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

@@ -0,0 +1,159 @@
+require('./silence-popup');
+/**
+ * openspec-push-worktrees 推送所有 worktree 仓库
+ *
+ * 用法：
+ *   node push-worktrees.js <ws_root> <branch>
+ *   node push-worktrees.js <wt_path>          # wt_path 必须是 <ws_root>/.worktrees/worktree-<branch> 形态
+ *
+ * 行为：
+ *   1. 扫描 <ws_root>/.worktrees/worktree-<branch>/ 下所有 git 仓库（workspace + 各 app 子 worktree）
+ *   2. 对每个仓库调 push-core.pushSingle（已建立 upstream 时直接 push -u；否则建立 upstream）
+ *   3. 逐个报告状态，输出末行 PUSH_RESULT
+ *
+ * 退出码：
+ *   0 - 全部推送成功
+ *   1 - 参数错误（ws_root/branch 无法识别）
+ *   2 - 部分或全部推送失败（AI agent 必须阻塞流程）
+ *
+ * 与 init-worktree/scripts/push-branches.js 的区别：
+ *   - push-branches.js 推送 workspace 主目录 + .code/<app>/（创建 worktree 时使用）
+ *   - push-worktrees.js 推送 .worktrees/worktree-<branch>/ 下所有 worktree（开发完成时使用）
+ *
+ * 错误码契约复用 push-core.classifyError：
+ *   - pushed / remote-exists / failed(ssh-auth-failed / https-auth-failed / network-unreachable
+ *     / branch-protected / no-remote / non-fast-forward / unknown)
+ */
+
+const { pushSingle } = require('./push-core');
+const fs = require('fs');
+const path = require('path');
+
+function resolveInputs(argv) {
+  // argv[2] 单独：wt_path 形式
+  // argv[2] + argv[3]：ws_root + branch 形式
+  if (argv.length === 3) {
+    const wtPath = path.resolve(argv[2]);
+    // 形如 <ws_root>/.worktrees/worktree-<branch>
+    const m = wtPath.match(/^(.+)[\\\/]\.worktrees[\\\/]worktree-(.+)$/);
+    if (!m) {
+      return { error: 'argv[2] 必须是 <ws_root>/.worktrees/worktree-<branch> 形态，或同时传 ws_root + branch' };
+    }
+    return { wsRoot: m[1], branch: m[2] };
+  }
+  if (argv.length >= 4) {
+    return { wsRoot: path.resolve(argv[2]), branch: argv[3] };
+  }
+  return { error: '用法：node push-worktrees.js <ws_root> <branch> | node push-worktrees.js <wt_path>' };
+}
+
+function isGitRepo(p) {
+  try {
+    // worktree 顶层是 .git 文件（gitdir 指向真实 .git），主目录是 .git 目录
+    return fs.existsSync(path.join(p, '.git'));
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 扫描 worktree 下的所有 git 仓库
+ * - workspace worktree：<ws_root>/.worktrees/worktree-<branch>/ 本身
+ * - app worktree：<ws_root>/.worktrees/worktree-<branch>/<app_name>/（嵌套子目录）
+ */
+function scanWorktreeRepos(wsRoot, branch) {
+  const wtRoot = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
+  const repos = [];
+
+  if (!fs.existsSync(wtRoot)) {
+    return { wtRoot, repos, error: 'worktree 目录不存在：' + wtRoot };
+  }
+
+  // workspace worktree（自身是 git worktree）
+  if (isGitRepo(wtRoot)) {
+    repos.push({ name: 'workspace', wt: wtRoot, repo: wsRoot });
+  }
+
+  // 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, '.code', e.name) });
+  }
+  return { wtRoot, repos, error: null };
+}
+
+/**
+ * 编排：扫描 + 逐个 push
+ * @param {{ wsRoot: string, branch: string, execSyncImpl?: Function }} opts
+ * @returns {{ wtRoot: string, results: Array }}
+ */
+function executePush(opts) {
+  const { wtRoot, repos, error } = scanWorktreeRepos(opts.wsRoot, opts.branch);
+  if (error) {
+    return { wtRoot, results: [], error };
+  }
+  const results = [];
+  for (const r of repos) {
+    // push 在 worktree 目录下执行（worktree 自带 .git 引用，git push 走 worktree 检出状态）
+    const pushOpts = { execSyncImpl: opts.execSyncImpl };
+    const res = pushSingle(r.wt, r.name, opts.branch, pushOpts);
+    results.push(res);
+  }
+  return { wtRoot, results, error: null };
+}
+
+// 导出供单测
+module.exports = { resolveInputs, scanWorktreeRepos, executePush };
+
+function main() {
+  const inputs = resolveInputs(process.argv);
+  if (inputs.error) {
+    console.error('❌ ' + inputs.error);
+    process.exit(1);
+  }
+
+  console.log('=== 推送所有 worktree 仓库 ===');
+  console.log('工作空间根：' + inputs.wsRoot);
+  console.log('需求名（分支）：' + inputs.branch);
+
+  const { wtRoot, results, error } = executePush({ wsRoot: inputs.wsRoot, branch: inputs.branch });
+
+  if (error) {
+    console.error('❌ ' + error);
+    process.exit(1);
+  }
+
+  if (results.length === 0) {
+    console.log('⚠️  未在 worktree 下发现任何 git 仓库');
+    console.log('---');
+    console.log('PUSH_RESULT', JSON.stringify([]));
+    process.exit(0);
+  }
+
+  // 人类可读报告
+  for (const r of results) {
+    if (r.status === 'pushed') {
+      console.log('✅ ' + r.name + ': 已推送 ' + r.upstream);
+    } else if (r.status === 'remote-exists') {
+      console.log('⚠️  ' + r.name + ': 远程分支已存在（需用户决策）');
+    } else {
+      console.error('❌ ' + r.name + ': 推送失败 - ' + (r.message || r.error));
+    }
+  }
+
+  const hasFailure = results.some(r => r.status === 'failed' || r.status === 'remote-exists');
+
+  console.log('---');
+  console.log('PUSH_RESULT', JSON.stringify(results));
+  process.exit(hasFailure ? 2 : 0);
+}
+
+// CLI 入口
+if (require.main === module) {
+  main();
+}

package/cbb/worktrees/skills/openspec-push-worktrees/scripts/silence-popup.js

@@ -0,0 +1,23 @@
+// silence-popup.js (shared)
+// Silences Windows 0xc0000142 (STATUS_DLL_INIT_FAILED) popups from child git processes.
+// Cross-platform: only effective on Windows; no-op on macOS/Linux.
+// 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）。
+// skill 内同目录引用：脚本第一行 `require('./silence-popup')`。
+if (process.platform === 'win32') {
+  try {
+    const path = require('path');
+    const { execSync } = require('child_process');
+    const globalRoot = execSync('npm root -g', { stdio: 'pipe', timeout: 5000 }).toString().trim();
+    const koffiPath = path.join(globalRoot, '@jspg-ai', 'coding-bb', 'node_modules', 'koffi');
+    const koffi = require(koffiPath);
+    const kernel32 = koffi.load('kernel32.dll');
+    const SetErrorMode = kernel32.func('uint __stdcall SetErrorMode(uint uMode)');
+    // SEM_FAILCRITICALERRORS=0x0001 | SEM_NOGPFAULTERRORBOX=0x0002 | SEM_NOOPENFILEERRORBOX=0x8000
+    SetErrorMode(0x0001 | 0x0002 | 0x8000);
+  } catch (e) {
+    // koffi unavailable or SetErrorMode failed: silently continue (worst case: popups may reappear)
+  }
+}

package/config/cbb.yaml

@@ -0,0 +1,6 @@
+# 项目级总配置（定位类似 Spring Boot 的 application.yaml）
+# 所有项目级配置集中于此：团队共享、进 git。个人凭据（如 Wiki 认证）仍放 ~/.cbb/wiki-config.json。
+
+wiki:
+  # Confluence Wiki 地址：一个公司通常只有一个，按需修改
+  baseUrl: wiki.amh-group.com

package/config/config.sample.json

@@ -0,0 +1,16 @@
+{
+    "_comment": "AI 开发工作空间配置样例（请勿修改本文件，复制为工作空间根目录的 CONFIG.json 后编辑使用）。apps 数组中每个对象需包含：name（应用名，同时作为 .code/ 子目录名）、repo（Git 仓库地址，支持 SSH 或 HTTPS）、side（仓库类型，'front' 表示前端工程，'back' 表示后端工程）。",
+    "apps":
+    [
+        {
+            "name": "ep-user-auth-app",
+            "repo": "git@code.example.com:team/ep-user-auth-app.git",
+            "side": "back"
+        },
+        {
+            "name": "ep-user-web",
+            "repo": "git@code.example.com:team/ep-user-web.git",
+            "side": "front"
+        }
+    ]
+}

package/config/openspec/config.yaml

@@ -0,0 +1,28 @@
+schema: spec-driven
+
+context: |
+  # 工作目录约束
+  不要 cd 进子仓库目录。读取代码用绝对路径，所有命令在当前目录执行。
+
+  语言：中文（简体）
+  所有文档必须使用中文简体编写，但技术术语保持英文，如 API、REST、RPC、MQ 等。
+
+  # Java 技术栈
+
+  ## 核心框架
+  - Java 1.8 或 Java 21
+  - Spring Boot 2.0.4.RELEASE
+  - Ironman 1.3.19
+
+  ## 中间件
+  - 数据库：Zebra 分库分表 (Ironman-SQL)
+  - RPC：Pigeon (Ironman-RPC)
+  - 消息队列：RocketMQ (Ironman-MQ)
+  - 缓存：Redis (Ironman-Redis)
+  - 配置中心：Lion (Ironman-Config)
+
+  ## 文档写作原则
+  - 每个章节先给结论或概览，再展开细节
+  - 用业务语言描述目标和规则，用技术语言描述实现方式
+  - 图优于表，表优于列表，列表优于段落
+  - 只写不显而易见的内容，标准实践不写