@jspg-ai/coding-bb 0.0.3-beta.6 → 0.0.3-beta.8

package/cbb/dev-standards/rules/cbb-ai-behavior.md

@@ -103,7 +103,7 @@ trigger: always_on
 
 **仅当工作目录是业务空间根（存在 `workspace-config.json`）时生效：写操作命令必须落在需求工作树内。**
 
-业务空间根（主分支）只负责组织与调度，不做需求开发。接到需求先建工作树（`/cbb:worktree-init` 或 `/cbb-worktree-init`），之后：
+业务空间根（主分支）只负责组织与调度，不做需求开发。接到需求先建工作树（`cbb-worktree-init` skill，或斜杠命令 `/cbb-worktree-init`），之后：
 
 - 一切产生写操作的命令（git commit / openspec / 构建 / 测试 / 文件修改）必须以 `.worktrees/worktree-<需求名>/`（或其应用子目录）为工作目录：显式 `cd` 或绝对路径
 - 禁止在空间根执行写操作：不在主分支提交代码、不在空间根创建 openspec 变更产物、不改 `.codespace/` 基准代码

package/cbb/lib/install/claude-code.js

@@ -13,9 +13,7 @@ module.exports = {
   rulesDir: '.claude/rules',
   skillsDir: '.claude/skills',
   commandsDir: '.claude/commands/opsx',
-  // worktree 管理命令（非 openspec 上游）：独立命名空间 /cbb:worktree-*
-  worktreeCommandsDir: '.claude/commands/cbb',
-  // 用户级 settings，写入全局生效，不污染项目目录
+  // 用户级 settings，写入全局生效，不污染项目目录
   settingsFile: path.join(os.homedir(), '.claude', 'settings.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],

package/cbb/lib/install/codebuddy.js

@@ -21,8 +21,6 @@ module.exports = {
   rulesDir: '.codebuddy/rules',
   skillsDir: '.codebuddy/skills',
   commandsDir: '.codebuddy/commands/opsx',
-  // worktree 管理命令（非 openspec 上游）：独立命名空间 /cbb:worktree-*
-  worktreeCommandsDir: '.codebuddy/commands/cbb',
   // 规则 frontmatter 改写：Qoder 风格 → CodeBuddy 风格
   ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
   // 用户级 settings，写入全局生效，不污染项目目录

package/cbb/lib/install/init.js

@@ -61,8 +61,8 @@ const adapters = [
   require('./claude-code'),
 ];
 
-// superpowers 部署白名单：仅装 openspec 工作流硬依赖 + 方法论基底（源仓库仍保留全量 14 个，
-// 供 cbb update --upstream-superpowers 维护；砍掉的与 openspec 工作流重叠或属低频场景）
+// superpowers 部署白名单：仅装 openspec 工作流硬依赖 + 方法论基底（源仓库仍保留全量 15 个，
+// 供 cbbm update --upstream-superpowers 维护；砍掉的与 openspec 工作流重叠或属低频场景）
 const SUPERPOWERS_WHITELIST = [
   'writing-plans',                  // openspec apply：生成 plan.md（schema.yaml 引用）
   'subagent-driven-development',    // openspec apply：执行 plan.md（schema.yaml 引用）
@@ -72,8 +72,9 @@ const SUPERPOWERS_WHITELIST = [
   'test-driven-development',        // TDD 计划结构 + TDD Evidence 方法论基底
 ];
 
-// worktree 运行时部署清单：init / close / push 三件套（SKILL.md + scripts），
-// 部署到 .cbb/skills/<name>/（每空间一份，不分工具；命令文件统一指向此处）
+// worktree 管理 skill 清单：init / close / push 三件套（SKILL.md + scripts）。
+// 按 skill 形态部署到各工具的 skillsDir，使这三个能力可被 AI 在对话中自动触发
+// （description 驱动），同时工具也会把它们暴露为斜杠命令供用户手动指定。
 const WORKTREE_SKILLS = ['cbb-worktree-init', 'cbb-worktree-close', 'cbb-worktree-push'];
 
 // 装到空间的 tools skills：当前不分发。
@@ -221,6 +222,39 @@ function removePath(targetPath) {
   }
 }
 
+/**
+ * 清理因删除文件/目录而变空的祖先目录（从深到浅，止于 TARGET_DIR）。
+ *
+ * 删除清单路径只删到该路径本身，其父目录会留空（如改名后残留的空 `.cbb/skills/`）。
+ * 此处统一收尾，升级与卸载共用。仅删除「存在且为空」的目录，非空目录（含用户文件）
+ * 一律保留。
+ *
+ * @param {Iterable<string>} relativePaths 已删除的相对路径（正斜杠）
+ * @returns {string[]} 实际删除的空目录相对路径
+ */
+function cleanupEmptyParentDirs(relativePaths) {
+  const dirsToCheck = new Set();
+  for (const relativePath of relativePaths) {
+    let dir = path.dirname(relativePath);
+    while (dir && dir !== '.') {
+      dirsToCheck.add(dir);
+      dir = path.dirname(dir);
+    }
+  }
+
+  const removed = [];
+  [...dirsToCheck]
+    .sort((a, b) => b.split('/').length - a.split('/').length)
+    .forEach(dir => {
+      const fullPath = path.join(TARGET_DIR, dir);
+      if (fs.existsSync(fullPath) && fs.readdirSync(fullPath).length === 0) {
+        removePath(fullPath);
+        removed.push(dir);
+      }
+    });
+  return removed;
+}
+
 /**
  * 安全删除目标路径（文件或目录）
  * 在清单中 → 直接删除（本包旧版本）
@@ -580,29 +614,6 @@ function deployCommandFiles(adapter, srcDir, destDir, prefix, filter) {
   return { count: commandFiles.length, names: commandFiles.map(f => prefix + f) };
 }
 
-/**
- * worktree 运行时部署：SKILL.md + scripts 复制到 .cbb/skills/<name>/（每空间一份，不分工具）。
- * 单形态 command 收敛后，worktree 不进各工具的 skills 目录——新版工具会把 skills 暴露成
- * 斜杠命令，与命令文件在面板里重复；脚本与流程文档统一放 .cbb/skills/，命令文件指向此处。
- */
-function deployWorktreeRuntime(newPaths) {
-  const srcDir = path.join(SHARED_STANDARDS_DIR, 'cbb', 'worktrees', 'skills');
-  if (!fs.existsSync(srcDir)) return 0;
-  const runtimeDir = path.join(TARGET_DIR, '.cbb', 'skills');
-  fs.mkdirSync(runtimeDir, { recursive: true });
-  let count = 0;
-  WORKTREE_SKILLS.forEach(name => {
-    const src = path.join(srcDir, name);
-    if (!fs.existsSync(src)) return;
-    const destDir = path.join(runtimeDir, name);
-    removePath(destDir);
-    fs.cpSync(src, destDir, { recursive: true });
-    newPaths.add(`.cbb/skills/${name}`);
-    count++;
-  });
-  return count;
-}
-
 /**
  * 命令 frontmatter 消毒：opencode 新版校验命令配置（description 必须为 string | undefined），
  * 上游个别命令（openspec/commands/update.md）的 description 为空值（YAML 解析为 null），
@@ -656,13 +667,6 @@ function deployCommands(adapter, isUpgrade, managedPaths, srcDir, filter) {
     adapter, srcDir, path.join(TARGET_DIR, adapter.commandsDir), adapter.commandPrefix || '', filter);
 }
 
-/** worktree 管理命令（cbb/worktrees/commands/ → adapter.worktreeCommandsDir） */
-function deployWorktreeCommands(adapter, srcDir, filter) {
-  if (!adapter.worktreeCommandsDir) return { count: 0, names: [] };
-  return deployCommandFiles(
-    adapter, srcDir, path.join(TARGET_DIR, adapter.worktreeCommandsDir), adapter.worktreeCommandPrefix || '', filter);
-}
-
 // ── 设置 OpenSpec 工作流 ──────────────────────────────────
 
 /**
@@ -1050,6 +1054,20 @@ async function init(targetDir, options = {}) {
     if (stdCount > 0) log(`规范 Skills → ${skillsDests.join(', ')} (${stdCount} 个)`, 'success');
     if (extCount > 0) log(`扩展 Skills → ${skillsDests.join(', ')} (${extCount} 个)`, 'success');
 
+    // 部署 worktree 管理 Skills（init / close / push；skill 形态，可被对话自动触发）
+    const worktreeSkillsSrc = path.join(SHARED_STANDARDS_DIR, 'cbb', 'worktrees', 'skills');
+    let wtCount = 0;
+    if (fs.existsSync(worktreeSkillsSrc)) {
+      skillsAdapters.forEach(adapter => {
+        const wtResult = deploySkills(adapter, isUpgrade, managedPaths, worktreeSkillsSrc, WORKTREE_SKILLS);
+        if (wtResult.count > 0) {
+          wtCount = wtResult.count;
+          wtResult.names.forEach(name => newPaths.add(`${adapter.skillsDir}/${name}`));
+        }
+      });
+      if (wtCount > 0) log(`Worktree Skills → ${skillsDests.join(', ')} (${wtCount} 个)`, 'success');
+    }
+
     // 部署 Superpowers Skills（白名单：openspec 工作流依赖 + 方法论基底）
     const superpowersSkillsSrc = superpowers.SUPERPOWERS_SKILLS_DIR;
     let spCount = 0;
@@ -1071,22 +1089,16 @@ async function init(targetDir, options = {}) {
     await detectUserLevelSuperpowers(selectedAdapters, yes);
   }
 
-  // worktree 运行时（SKILL.md + scripts）→ .cbb/skills/（每空间一份，不分工具）
-  const runtimeCount = deployWorktreeRuntime(newPaths);
-  if (runtimeCount > 0) log(`worktree 运行时 → .cbb/skills (${runtimeCount} 个)`, 'success');
-
-  // 安装 Commands（官方 11 个 → /opsx:*，onboard 不分发；worktree 管理 → /cbb:worktree-*，init/close/push 三件套）
+  // 安装 Commands（官方 11 个 → /opsx:*，onboard 不分发）
   const commandsAdapters = selectedAdapters.filter(a => a.commandsDir);
   if (commandsAdapters.length > 0) {
     console.log(`\n  ⚡ ${action} Commands...`);
     const commandsBaseSrc = path.join(SHARED_STANDARDS_DIR, 'openspec', 'commands');
-    const commandsExtendsSrc = path.join(SHARED_STANDARDS_DIR, 'cbb', 'worktrees', 'commands');
-    const cmdFilter = ['worktree-init.md', 'worktree-close.md', 'worktree-push.md'];
     const openspecCmdInclude = fs.readdirSync(commandsBaseSrc)
       .filter(f => f.endsWith('.md') && !OPENSPEC_COMMANDS_EXCLUDE.includes(f));
 
     const cmdDests = [...new Set(commandsAdapters
-      .flatMap(a => [a.commandsDir, a.worktreeCommandsDir])
+      .map(a => a.commandsDir)
       .filter(Boolean))];
     let cmdCount = 0;
     commandsAdapters.forEach(adapter => {
@@ -1097,12 +1109,6 @@ async function init(targetDir, options = {}) {
         adapterCmdCount += baseResult.count;
         baseResult.names.forEach(name => newPaths.add(`${adapter.commandsDir}/${name}`));
       }
-      // worktree 管理 Commands（cbb/worktrees/commands/）
-      const extResult = deployWorktreeCommands(adapter, commandsExtendsSrc, cmdFilter);
-      if (extResult.count > 0) {
-        adapterCmdCount += extResult.count;
-        extResult.names.forEach(name => newPaths.add(`${adapter.worktreeCommandsDir}/${name}`));
-      }
       cmdCount = Math.max(cmdCount, adapterCmdCount);
     });
     if (cmdCount > 0) log(`Commands → ${cmdDests.join(', ')} (${cmdCount} 个)`, 'success');
@@ -1168,6 +1174,8 @@ async function init(targetDir, options = {}) {
       if (oldPaths.length > MAX_DISPLAY) {
         log(`  ... 还有 ${oldPaths.length - MAX_DISPLAY} 个`, 'dim');
       }
+      // 收尾：清掉因此变空的祖先目录（如改名后残留的空 .cbb/skills/）
+      cleanupEmptyParentDirs(oldPaths).forEach(dir => log(`  清理空目录 ${dir}/`, 'dim'));
     }
 
     const kept = protectedKeptPaths(managedPaths, newPaths);
@@ -1948,22 +1956,7 @@ async function uninstall() {
   });
 
   // 清理可能变空的父目录（从深到浅）
-  const dirsToCheck = new Set();
-  managedPaths.forEach(relativePath => {
-    let dir = path.dirname(relativePath);
-    while (dir && dir !== '.') {
-      dirsToCheck.add(dir);
-      dir = path.dirname(dir);
-    }
-  });
-  // 按深度排序，深层先处理
-  [...dirsToCheck].sort((a, b) => b.split('/').length - a.split('/').length).forEach(dir => {
-    const fullPath = path.join(TARGET_DIR, dir);
-    if (fs.existsSync(fullPath) && fs.readdirSync(fullPath).length === 0) {
-      removePath(fullPath);
-      log(`清理空目录 ${dir}/`, 'success');
-    }
-  });
+  cleanupEmptyParentDirs(managedPaths).forEach(dir => log(`清理空目录 ${dir}/`, 'success'));
 
   // 删除清单文件和 .va 目录
   removePath(manifestDir);
@@ -1981,11 +1974,50 @@ async function uninstall() {
   console.log(`\n✅ 卸载完成！共移除 ${removed} 个文件/目录\n`);
 }
 
+// ── 上游版本检查 ──────────────────────────────────────────────
+
+/**
+ * 检查 openspec / superpowers 是否有上游新版本（只读，不改动任何文件）。
+ * 供 cbbm check-upstream 调用。
+ */
+async function checkUpstream() {
+  const results = await Promise.allSettled([
+    openspec.checkUpstream().then(r => ({ name: 'openspec', ...r })),
+    superpowers.checkUpstream().then(r => ({ name: 'superpowers', ...r })),
+  ]);
+
+  let outdated = false;
+  for (const r of results) {
+    if (r.status === 'rejected') {
+      log(`检查失败: ${r.reason.message}`, 'error');
+      continue;
+    }
+    const { name, current, latest, outdated: isOutdated } = r.value;
+    if (!latest) {
+      log(`${name}: 无法获取上游版本`, 'warn');
+      continue;
+    }
+    if (!current) {
+      log(`${name}: 本地无 pin（上游最新 ${latest}）`, 'warn');
+      outdated = true;
+    } else if (isOutdated) {
+      log(`${name}: ${current} → ${latest}（有新版本）`, 'warn');
+      outdated = true;
+    } else {
+      log(`${name}: ${current} 已是最新`, 'success');
+    }
+  }
+
+  if (outdated) {
+    log('升级方式：修改对应 .version 的 pin 后，执行 cbbm update --upstream-openspec / --upstream-superpowers', 'info');
+  }
+}
+
 // ── CLI 入口 ──────────────────────────────────────────────
 
 // 入口身份：cbb（用户命令） / cbbm（内部命令，由流程、hook、Agent 技能调用）
 const ENTRY = process.env.CBB_ENTRY === 'cbbm' ? 'cbbm' : 'cbb';
-const INTERNAL_COMMANDS = ['check-update', 'wiki', 'wp'];
+const INTERNAL_COMMANDS = ['check-update', 'check-upstream', 'wiki', 'wp'];
 const UPSTREAM_FLAGS = ['--upstream-superpowers', '--upstream-openspec'];
 
 const args = process.argv.slice(2);
@@ -2024,11 +2056,11 @@ switch (command) {
     const upstreamSuperpowers = restArgs.includes('--upstream-superpowers');
     const upstreamOpenspec = restArgs.includes('--upstream-openspec');
     if (upstreamSuperpowers || upstreamOpenspec) {
-      // 维护者选项：从 GitHub 拉取上游原生内容到本包源仓库（发布流程用）
+      // 维护者选项：按 .version 的 pin 重新拉取上游原生内容到本包源仓库（发布流程用）
       if (upstreamSuperpowers) {
         superpowers.fetchLatestSkills().then(result => {
           if (result.skipped) {
-            log(`superpowers skills 已是最新 (${result.sha.slice(0, 8)})`, 'success');
+            log(`superpowers skills 已是最新 (${result.tag})`, 'success');
           }
           const validation = superpowers.validateSkills();
           if (!validation.valid) {
@@ -2044,22 +2076,13 @@ switch (command) {
       }
       if (upstreamOpenspec) {
         openspec.fetchLatestOpenSpec().then(result => {
-          if (!result.skipped) {
-            const validation = openspec.validateDeployed();
-            if (!validation.valid) {
-              log(`部署不完整,缺失: ${validation.missing.join(', ')}`, 'error');
-              process.exit(1);
-            }
-            log(`openspec 工作流完整性校验通过`, 'success');
-          } else {
-            const validation = openspec.validateDeployed();
-            if (!validation.valid) {
-              log(`本地 openspec 工作流不完整,请重新运行 cbb update --upstream-openspec:`, 'error');
-              for (const m of validation.missing) log(`  - 缺失 ${m}`, 'error');
-              process.exit(1);
-            }
-            log(`openspec 工作流完整性校验通过`, 'success');
+          const validation = openspec.validateDeployed();
+          if (!validation.valid) {
+            log(`部署不完整,缺失: ${validation.missing.join(', ')}`, 'error');
+            for (const m of validation.missing) log(`  - 缺失 ${m}`, 'error');
+            process.exit(1);
           }
+          log(`openspec 工作流完整性校验通过`, 'success');
         }).catch(err => {
           log(`更新失败: ${err.message}`, 'error');
           process.exit(1);
@@ -2082,6 +2105,12 @@ switch (command) {
   case 'check-update':
     require('../utils/check-update.js');
     break;
+  case 'check-upstream':
+    checkUpstream().catch(err => {
+      log(err.message, 'error');
+      process.exit(1);
+    });
+    break;
   case 'wp':
     require('../wiki/index.js').publish(restArgs);
     break;
@@ -2113,11 +2142,12 @@ function showHelp() {
 @jspg-ai/coding-bb v${pkg.version} — cbbm：内部命令（由流程 / hook / Agent 技能调用）
 
   cbbm check-update          版本检查（用户级 hook 每日自动触发）
+  cbbm check-upstream        检查 openspec / superpowers 是否有上游新版本
   cbbm wiki / cbbm wp        Wiki 查询与发布（AI 通过技能调用）
 
-维护者选项（拉取上游原生内容到本包源仓库）：
-  cbbm update --upstream-superpowers    从 GitHub 拉取最新 superpowers skills
-  cbbm update --upstream-openspec       从 GitHub 拉取最新 OpenSpec 工作流
+维护者选项（按 .version 的 pin 重新拉取上游原生内容到本包源仓库）：
+  cbbm update --upstream-superpowers    按 pin tag 拉取 superpowers skills（走镜像）
+  cbbm update --upstream-openspec       按 pin 版本从 npmmirror 渲染 OpenSpec 工作流
 `);
     return;
   }

package/cbb/lib/install/opencode.js

@@ -9,8 +9,7 @@
  *   官方支持的配置位置：全局目录 / 项目根 / .opencode 目录内均会被发现）
  * - skills：.opencode/skills/<name>/SKILL.md，结构与 Claude 同构
  * - commands：命令名 = 文件名（嵌套目录无命名空间，且 init.md 等会撞内置 /init），
- *   因此扁平化为 opsx-<name>.md（/opsx-propose）；worktree 管理命令同理扁平化为
- *   cbb-<name>.md（/cbb-worktree-init），部署副本中的 /opsx: 与 /cbb: 引用同步改写
+ *   因此扁平化为 opsx-<name>.md（/opsx-propose）；部署副本中的 /opsx: 与 /cbb: 引用同步改写
  * - hooks：opencode 无 UserPromptSubmit 等价事件，版本检查 hook 不安装（settingsFile 留空即跳过）
  */
 
@@ -22,9 +21,6 @@ module.exports = {
   commandsDir: '.opencode/commands',
   // 部署时给命令文件名加此前缀（规避内置命令名冲突）
   commandPrefix: 'opsx-',
-  // worktree 管理命令（非 openspec 上游）落在同一扁平目录，用 cbb- 前缀区分
-  worktreeCommandsDir: '.opencode/commands',
-  worktreeCommandPrefix: 'cbb-',
   // 部署副本中将该引用串改写为 opencode 的命令风格（配合 commandPrefix）
   contentRewrites: [['/opsx:', '/opsx-'], ['/cbb:', '/cbb-']],
   // 命令显示名取自 frontmatter name，部署副本重写为 kebab-case（/opsx-propose，与文档一致）

package/cbb/lib/install/qoder.js

@@ -13,9 +13,7 @@ module.exports = {
   rulesDir: '.qoder/rules',
   skillsDir: '.qoder/skills',
   commandsDir: '.qoder/commands/opsx',
-  // worktree 管理命令（非 openspec 上游）：独立命名空间 /cbb:worktree-*
-  worktreeCommandsDir: '.qoder/commands/cbb',
-  // 用户级 settings，写入全局生效，不污染项目目录
+  // 用户级 settings，写入全局生效，不污染项目目录
   settingsFile: path.join(os.homedir(), '.qoder', 'settings.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],

package/cbb/lib/install/trae.js

@@ -22,8 +22,6 @@ module.exports = {
   rulesDir: '.trae/rules',
   skillsDir: '.trae/skills',
   commandsDir: '.trae/commands/opsx',
-  // worktree 管理命令（非 openspec 上游）：独立命名空间 /cbb:worktree-*
-  worktreeCommandsDir: '.trae/commands/cbb',
   // 规则 frontmatter 改写：Qoder 风格 → Trae 风格
   ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
   // 用户级 hooks 配置（Trae 用 hooks.json，国内版目录为 ~/.trae-cn/）