@jspg-ai/coding-bb 0.0.3-beta.9 → 0.0.5-beta.1

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

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * 收尾合并门禁 —— 废弃分支出口（ADR 0007）
+ *
+ * 用户在门禁处确认"分支废弃、不再交付"后，把各参与仓库远端的需求分支重命名为
+ * <branch>-deprecated（保留历史、去掉占用中的旧名），**不删除任何提交**。
+ * 本地分支保持原名不动；未推送的仓库（远端无该分支）跳过。
+ *
+ * 用法：
+ *   node deprecate-branches.js <ws_root> <branch> [--apps a,b]
+ *
+ * 退出码：0 全部成功（含 skipped）/ 1 参数错误 / 2 存在失败
+ * 末行：DEPRECATE_RESULT [...]
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function run(cmd, cwd) {
+  try {
+    return {
+      ok: true,
+      out: execSync(cmd, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        timeout: 120000,
+        env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+      }).trim(),
+    };
+  } catch (e) {
+    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
+  }
+}
+
+function loadApps(wsRoot) {
+  try {
+    const config = JSON.parse(fs.readFileSync(path.join(wsRoot, 'CBB-WORKSPACE.json'), 'utf-8'));
+    return Array.isArray(config.apps) ? config.apps : [];
+  } catch (e) {
+    return [];
+  }
+}
+
+/** 对单个仓库执行废弃重命名 */
+function deprecateRepo(name, repo, branch) {
+  const newName = branch + '-deprecated';
+  const rec = { name, status: 'skipped', 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];
+  // 仅重命名远端确实存在的分支
+  const exists = run('git ls-remote --heads "' + r + '" "refs/heads/' + branch + '"', repo);
+  if (!exists.ok || !exists.out) {
+    rec.detail = 'remote-has-no-branch';
+    return rec;
+  }
+  const pushNew = run('git push "' + r + '" "refs/heads/' + branch + ':refs/heads/' + newName + '"', repo);
+  if (!pushNew.ok) {
+    rec.status = 'failed';
+    rec.detail = 'push-new-failed: ' + (pushNew.err || '').split(/\r?\n/)[0];
+    return rec;
+  }
+  const delOld = run('git push "' + r + '" --delete "' + branch + '"', repo);
+  if (!delOld.ok) {
+    rec.status = 'failed';
+    rec.detail = 'delete-old-failed: ' + (delOld.err || '').split(/\r?\n/)[0];
+    return rec;
+  }
+  rec.status = 'deprecated';
+  rec.detail = 'remote ' + branch + ' → ' + newName;
+  return rec;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const wsRoot = args[0];
+  const branch = args[1];
+
+  if (!wsRoot || !branch || branch.indexOf('--') === 0) {
+    console.error('Usage: node deprecate-branches.js <ws_root> <branch> [--apps a,b]');
+    process.exit(1);
+  }
+
+  const appsIdx = args.indexOf('--apps');
+  const appFilter = appsIdx >= 0
+    ? new Set((args[appsIdx + 1] || '').split(',').map(s => s.trim()).filter(Boolean))
+    : null;
+
+  const repos = [{ name: 'workspace', repo: wsRoot }];
+  for (const app of loadApps(wsRoot)) {
+    if (appFilter && !appFilter.has(app.name)) continue;
+    repos.push({ name: app.name, repo: path.join(wsRoot, '.codespace', app.name) });
+  }
+
+  const results = repos.map(rp => deprecateRepo(rp.name, rp.repo, branch));
+
+  results.forEach(r => {
+    console.log(r.status.toUpperCase() + ' ' + r.name + (r.detail ? ' — ' + r.detail : ''));
+  });
+
+  const ok = results.every(r => r.status !== 'failed');
+  console.log('---');
+  console.log('DEPRECATE_RESULT', JSON.stringify({ branch, new_name: branch + '-deprecated', results }));
+  process.exit(ok ? 0 : 2);
+}
+
+if (require.main === module) main();
+
+module.exports = { run, loadApps, deprecateRepo };

package/cbb/worktrees/skills/cbb-local-mode/scripts/install-git-hook.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * 向指定 git 仓库安装分支感知 pre-commit hook（ADR 0002）。
+ *
+ * 真源：cbb/lib/utils/githook.js 的 PRE_COMMIT_SOURCE（本文件为部署到业务空间的自包含副本，
+ * 改动必须两处同步——本仓库内改真源后同步本文件，勿只改其一）。
+ *
+ * 用法（二选一）：
+ *   CLI：node install-git-hook.js <repoPath...>   —— 对每个仓库安装，输出 HOOK_RESULT
+ *   require：installTo(repoPath) → 'installed' | 'updated' | 'skipped-not-git'
+ *
+ * 供 cbb-worktree-init 的 sync-repos.js 兜底 clone 后调用（cbb setup 已装过，此处幂等补齐）。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const HOOK_MARKER = 'managed-by-cbb';
+const HOOK_FILE = 'pre-commit';
+const BACKUP_SUFFIX = '.cbb-backup';
+
+// 与 cbb/lib/utils/githook.js 的 buildPreCommitSource() 输出完全一致（构建时注入）
+const PRE_COMMIT_SOURCE = "#!/usr/bin/env node\n// managed-by-cbb v1 —— 分支感知提交防线（ADR 0002）\n// main 上：workspace 只放行控制面白名单，应用全拦（merge 提交除外）；非 main 一律放行。\n// 绕过逃生口仅限用户显式 git commit --no-verify。\nconst { execSync } = require('child_process');\nconst fs = require('fs');\nfunction run(cmd) {\n  try { return execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim(); }\n  catch (e) { return null; }\n}\nconst branch = run('git branch --show-current') || '';\n// 主干名：优先远端 HEAD 指向；探测失败按本地 main/master 存在性回退\nlet main = null;\nconst remotes = run('git remote');\nif (remotes) {\n  const r = remotes.split(/\\r?\\n/)[0];\n  const sym = run('git symbolic-ref \"refs/remotes/' + r + '/HEAD\"');\n  if (sym) main = sym.replace('refs/remotes/' + r + '/', '');\n}\nif (!main) {\n  if (run('git rev-parse --verify --quiet refs/heads/main')) main = 'main';\n  else if (run('git rev-parse --verify --quiet refs/heads/master')) main = 'master';\n}\n// 非主干（含 detached / 探测失败）→ 放行\nif (!main || branch !== main) process.exit(0);\n\n// merge 进行中（MERGE_HEAD 存在）→ 显式人工合并提交，放行（ADR 0007 合并门禁）\nif (run('git rev-parse --verify --quiet MERGE_HEAD')) process.exit(0);\n\n// 主干上的提交：收集 staged 变更（空提交放行）\nconst staged = run('git diff --cached --name-only') || '';\nconst files = staged.split(/\\r?\\n/).filter(Boolean);\nif (files.length === 0) process.exit(0);\n\n// 仓库类型：workspace 仓库 = 检出含 CBB-WORKSPACE.json（或旧名，改名过渡期识别）\nconst isWorkspace = fs.existsSync('CBB-WORKSPACE.json') || fs.existsSync('workspace-config.json');\n\nfunction deny(bad) {\n  console.error('[cbb-guard] 主干上拦截载荷提交（ADR 0002）：');\n  bad.forEach(f => console.error('  ' + f));\n  console.error('需求载荷须在需求分支上提交：本地模式先 git checkout -b <需求名>；worktree 模式在 .worktrees/ 工作树内提交。');\n  console.error('控制面白名单：CBB-WORKSPACE.json / .gitignore / AGENTS.md / openspec/config.yaml / openspec/schemas/** / .cbb/**');\n  console.error('如确需在主干提交，须由用户显式 git commit --no-verify。');\n  process.exit(1);\n}\n\nif (isWorkspace) {\n  // 旧名仅放行删除条目：更名迁移提交（git mv）会产生旧名删除 + 新名新增两条\n  const EXACT = new Set(['CBB-WORKSPACE.json', 'workspace-config.json', '.gitignore', 'AGENTS.md', 'openspec/config.yaml']);\n  const PREFIXES = ['openspec/schemas/', '.cbb/'];\n  const bad = files.filter(f => !EXACT.has(f) && !PREFIXES.some(p => f.indexOf(p) === 0));\n  if (bad.length) deny(bad);\n} else {\n  deny(files);\n}\nprocess.exit(0);\n";
+
+function isCbbHookContent(content) {
+  return typeof content === 'string' && content.includes(HOOK_MARKER);
+}
+
+function resolveHooksDir(repoPath) {
+  const gitDir = path.join(repoPath, '.git');
+  if (!fs.existsSync(gitDir)) return null;
+  const st = fs.statSync(gitDir);
+  if (!st.isDirectory()) return null; // worktree 检出（.git 为文件）：hook 由主仓库承担
+  return path.join(gitDir, 'hooks');
+}
+
+function installTo(repoPath) {
+  const dir = resolveHooksDir(repoPath);
+  if (!dir) return 'skipped-not-git';
+
+  const hookPath = path.join(dir, HOOK_FILE);
+  fs.mkdirSync(dir, { recursive: true });
+
+  if (fs.existsSync(hookPath)) {
+    const prev = fs.readFileSync(hookPath, 'utf-8');
+    if (isCbbHookContent(prev)) {
+      if (prev !== PRE_COMMIT_SOURCE) fs.writeFileSync(hookPath, PRE_COMMIT_SOURCE);
+      return 'updated';
+    }
+    fs.writeFileSync(hookPath + BACKUP_SUFFIX, prev); // 用户自有 hook：备份后接管
+  }
+  fs.writeFileSync(hookPath, PRE_COMMIT_SOURCE);
+  try { fs.chmodSync(hookPath, 0o755); } catch (_) { /* Windows 无压力 */ }
+  return 'installed';
+}
+
+module.exports = { installTo, isCbbHookContent, PRE_COMMIT_SOURCE };
+
+// CLI 形式：node install-git-hook.js <repoPath...>
+if (require.main === module) {
+  const targets = process.argv.slice(2);
+  if (targets.length === 0) {
+    console.error('Usage: node install-git-hook.js <repoPath...>');
+    process.exit(1);
+  }
+  const results = targets.map(p => ({ path: p, status: installTo(p) }));
+  results.forEach(r => console.log((r.status === 'skipped-not-git' ? '⚠️ ' : '✅ ') + r.path + ' → ' + r.status));
+  console.log('HOOK_RESULT', JSON.stringify(results));
+  process.exit(0);
+}