@jspg-ai/coding-bb 0.0.3-beta.14 → 0.0.3-beta.16

package/cbb/lib/install/codebuddy.js

@@ -1,15 +1,17 @@
 /**
  * WorkBuddy / CodeBuddy 适配器
  *
- * 腾讯 WorkBuddy 桌面工作台与 CodeBuddy IDE / CLI 共用项目级配置目录 `.codebuddy/`，
- * 故一个适配器同时覆盖两者。
+ * 腾讯 WorkBuddy 桌面工作台的项目级配置目录为 `.workbuddy/`（实测：skill 只有
+ * 放在 `.workbuddy/skills/` 才生效；旧版假设「与 CodeBuddy 共用 .codebuddy/」不成立）。
+ * 0.0.3-beta.16 起目录与用户级 settings 全部切到 `.workbuddy`，`.codebuddy` 作为
+ * legacy 由安装流程迁移清理（legacyDirs / legacySettingsFile）。
  *
  * 与 Claude Code / Qoder 的映射差异：
- * - rules：`.codebuddy/rules/*.md`（扁平文件、递归加载），frontmatter 用
+ * - rules：`.workbuddy/rules/*.md`（扁平文件、递归加载），frontmatter 用
  *   `alwaysApply: true`（Qoder 的 `trigger: always_on` 需改写，见 ruleRewrites）
- * - skills：`.codebuddy/skills/<name>/SKILL.md`，结构与 Claude 同构
- * - commands：`.codebuddy/commands/`，支持目录嵌套（`/group:command`），与 Claude 同风格
- * - hooks：完全兼容 Claude Code Hooks 规范，settings 结构一致，直接复用 settingsManager
+ * - skills：`.workbuddy/skills/<name>/SKILL.md`，结构与 Claude 同构
+ * - commands：`.workbuddy/commands/`，支持目录嵌套（`/group:command`），与 Claude 同风格
+ * - hooks：兼容 Claude Code Hooks 规范，settings 结构一致，直接复用 settingsManager
  */
 
 const path = require('path');
@@ -18,13 +20,16 @@ const os = require('os');
 module.exports = {
   name: 'codebuddy',
   displayName: 'WorkBuddy（CodeBuddy）',
-  rulesDir: '.codebuddy/rules',
-  skillsDir: '.codebuddy/skills',
-  commandsDir: '.codebuddy/commands/opsx',
+  rulesDir: '.workbuddy/rules',
+  skillsDir: '.workbuddy/skills',
+  commandsDir: '.workbuddy/commands/opsx',
   // 规则 frontmatter 改写：Qoder 风格 → CodeBuddy 风格
   ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
   // 用户级 settings，写入全局生效，不污染项目目录
-  settingsFile: path.join(os.homedir(), '.codebuddy', 'settings.json'),
+  settingsFile: path.join(os.homedir(), '.workbuddy', 'settings.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],
+  // 旧版目录/文件（beta.15 及以前写入 .codebuddy）：安装时迁移清理
+  legacyDirs: ['.codebuddy'],
+  legacySettingsFile: path.join(os.homedir(), '.codebuddy', 'settings.json'),
 };

package/cbb/lib/install/init.js

@@ -5,7 +5,7 @@
  *
  * 将AI 编码规范与工作流套件安装到目标项目中。
  * 支持工具：Claude Code (.claude/rules/)、Qoder (.qoder/rules/)、opencode (.opencode/rules/)、
- *          WorkBuddy/CodeBuddy (.codebuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
+ *          WorkBuddy/CodeBuddy (.workbuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
  *
  * 使用方式：
  *   npm install -g @jspg-ai/coding-bb  # 首次使用
@@ -40,6 +40,7 @@ function execCmd(file, args, opts = {}) {
 }
 
 const SHARED_STANDARDS_DIR = path.join(__dirname, '..', '..', '..');
+const setupDecision = require('./setup-decision');
 
 // 目标项目根目录：默认取当前 cwd，init() 可在调用前覆盖。
 // 注意：使用 let 而非 const 是为了让 cbb setup 能在拉好仓库后把目标目录
@@ -93,6 +94,16 @@ function hookOpts(adapter) {
   return adapter.hookDialect ? { dialect: adapter.hookDialect } : {};
 }
 
+/**
+ * 迁移清理：移除本包写在旧用户级 settings 里的 hook（如 WorkBuddy 适配修正：
+ * ~/.codebuddy/settings.json → ~/.workbuddy/settings.json）。
+ * removeHooks 只删 _managedBy: cbb 标记的条目，文件清空则删除。返回 true 表示有改动。
+ */
+function cleanLegacySettings(adapter) {
+  if (!adapter.legacySettingsFile || !adapter.hookEvents) return false;
+  return settingsManager.removeHooks(adapter.legacySettingsFile, adapter.hookEvents, hookOpts(adapter));
+}
+
 // 清单驱动的文件清理决策（保护用户文档 CLAUDE.md / AGENTS.md 等）
 const { pathsToDelete, protectedKeptPaths } = require('./cleanup');
 
@@ -1152,6 +1163,10 @@ async function init(targetDir, options = {}) {
       if (settingsManager.removeLegacyHooks(settingsPath, hookOpts(adapter))) {
         log(`清理 ${adapter.displayName} 遗留的 SessionStart hook`, 'success');
       }
+      // 迁移：清理旧用户级 settings（如 ~/.codebuddy → ~/.workbuddy）
+      if (cleanLegacySettings(adapter)) {
+        log(`迁移清理旧用户级配置 ${adapter.legacySettingsFile}`, 'success');
+      }
       if (!adapter.settingsFileIsUserLevel) newPaths.add(adapter.settingsFile);
     });
     log(`版本检查 hook → ${hookAdapters.map(a => a.displayName).join(', ')} (${hookAdapters[0].hookEvents.join(', ')})`, 'success');
@@ -1246,28 +1261,41 @@ async function init(targetDir, options = {}) {
 // ── cbb setup 命令 ──────────────────────────────────────
 
 /**
- * 若 targetDir 已安装，比较已装版本与当前包版本决定是否继续安装。
- *  - 版本一致 → 返回 'skip'（不询问、不重复安装）
- *  - 版本不同 → 返回 'install'（setup 已整体确认过，直接升级到当前包版本，不再二次询问）
- *  - 未安装 → 返回 'install'（不提示，直接继续）
+ * 若 targetDir 已安装，比较「已装版本 vs 当前包版本」与「本次工具选择 vs .last-tools」
+ * 决定是否继续安装（判定纯逻辑见 setup-decision.js）。
+ *  - 版本不同 → 'install'（setup 已整体确认过，直接升级到当前包版本，不再二次询问）
+ *  - 版本一致但本次选择含 .last-tools 之外的新工具（或无记录）→ 'install'
+ *    （beta.14 及以前的 bug：版本一致即整体跳过，新工具的空间级目录永不安装）
+ *  - 版本一致且所选 ⊆ .last-tools → 'skip'（不询问、不重复安装）
  *
  * 注：只比较「已装版本 vs 当前包版本」——安装动作只能落盘当前包的产物，
  * registry 是否有更新由用户级版本检查 hook 提醒，不在此处联网查询。
+ * @param {string} targetDir
+ * @param {Array<{name:string}>} [selectedAdapters] 本次 setup 选中的工具
  * @returns {'install'|'skip'}
  */
-function decideUpgradeIfInstalled(targetDir) {
+function decideUpgradeIfInstalled(targetDir, selectedAdapters) {
   const installed = version.readInstalledVersion(targetDir);
   if (!installed) return 'install'; // 未安装：不提示，直接继续
 
   const pkg = require(path.join(SHARED_STANDARDS_DIR, 'package.json'));
+  const decision = setupDecision.decideSetupAction({
+    sameVersion: version.compareVersions(installed, pkg.version) === 0,
+    lastTools: setupDecision.readLastToolsFrom(targetDir),
+    selectedNames: (selectedAdapters || []).map(a => a.name),
+  });
 
-  // 版本未变化 → 不处理（不询问、不重复安装）
-  if (version.compareVersions(installed, pkg.version) === 0) {
+  if (decision.action === 'skip') {
     step('✓', '版本', `v${installed}（已是最新，跳过）`);
     return 'skip';
   }
-
-  step('✓', '版本', `v${installed} → v${pkg.version}`);
+  if (decision.reason === 'new-tools') {
+    step('✓', '版本', `v${installed}（版本一致，新增工具 ${decision.newTools.join('、')} → 继续安装）`);
+  } else if (decision.reason === 'no-tools-record') {
+    step('✓', '版本', `v${installed}（无工具选择记录 → 继续安装）`);
+  } else {
+    step('✓', '版本', `v${installed} → v${pkg.version}`);
+  }
   return 'install';
 }
 
@@ -1558,8 +1586,8 @@ async function initSingleWorkspace(w, opts = {}) {
     console.log(`      ${c('gray', `${names} → 编辑 workspace-config.json 填入真实仓库地址`)}`);
   }
 
-  // 5. 若已安装：版本未变化直接跳过；有新版本直接升级（setup 已整体确认过，不再二次询问）
-  const decision = decideUpgradeIfInstalled(targetDir);
+  // 5. 若已安装：版本一致且无新增工具才跳过；否则继续安装/升级（setup 已整体确认过，不再二次询问）
+  const decision = decideUpgradeIfInstalled(targetDir, opts.selectedAdapters);
   if (decision === 'skip') {
     return { ok: true, subdir: subdirName, upToDate: true };
   }
@@ -1762,6 +1790,7 @@ async function setupUserLevelComponents(targetAdapters = adapters) {
     hookAdapters.forEach(adapter => {
       settingsManager.addHooks(adapter.settingsFile, command, adapter.hookEvents, hookOpts(adapter));
       settingsManager.removeLegacyHooks(adapter.settingsFile, hookOpts(adapter));
+      cleanLegacySettings(adapter);
     });
     summaryParts.push(`版本检查 hook → ${hookAdapters.map(a => a.displayName).join('、')}`);
   }
@@ -1880,6 +1909,9 @@ async function uninstallUserLevelComponents() {
     if (settingsManager.removeHooks(adapter.settingsFile, adapter.hookEvents, hookOpts(adapter))) {
       log(`${adapter.settingsFile}: 移除版本检查 hook，保留用户配置`, 'success');
     }
+    if (cleanLegacySettings(adapter)) {
+      log(`${adapter.legacySettingsFile}: 移除版本检查 hook（旧路径），保留用户配置`, 'success');
+    }
   });
 
   removePath(USER_MANIFEST_FILE);
@@ -1908,7 +1940,7 @@ async function uninstall() {
   // 是否同时卸载用户级组件（工具 skills + 版本检查 hook，作用于 ~/.claude 等用户目录）
   let removeUserLevel = false;
   if (fs.existsSync(USER_MANIFEST_FILE)) {
-    const answerUser = await ask('是否同时卸载用户级组件（~/.claude、~/.qoder、~/.codebuddy、~/.trae-cn 的版本检查 hook）？(y/N): ');
+    const answerUser = await ask('是否同时卸载用户级组件（~/.claude、~/.qoder、~/.workbuddy、~/.trae-cn 的版本检查 hook）？(y/N): ');
     removeUserLevel = answerUser.toLowerCase() === 'y' || answerUser.toLowerCase() === 'yes';
   }
 

package/cbb/lib/install/setup-decision.js

@@ -0,0 +1,48 @@
+'use strict';
+
+/**
+ * cbb setup 空间级安装的跳过判定（纯逻辑，可单测）。
+ *
+ * 背景 bug（0.0.3-beta.15 修复）：旧版 decideUpgradeIfInstalled 只比较
+ * 「已装版本 vs 当前包版本」，版本一致即 skip——导致「空间已是当前版本 +
+ * 本次新选了工具（如 WorkBuddy）」被整体跳过，新工具的空间级目录
+ * （.workbuddy/ 等）永不生成，.last-tools 也不更新。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 读取 <targetDir>/.cbb/.last-tools 的已装工具集合。
+ * @param {string} targetDir 业务空间根
+ * @returns {Set<string>|null} 工具名集合；无文件或解析失败返回 null
+ */
+function readLastToolsFrom(targetDir) {
+  const filePath = path.join(targetDir, '.cbb', '.last-tools');
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    return new Set(data.tools || []);
+  } catch (_) {
+    return null;
+  }
+}
+
+/**
+ * 判定已安装空间本次 setup 应跳过还是继续安装。
+ * @param {object} p
+ * @param {boolean} p.sameVersion    已装版本 == 当前包版本
+ * @param {Set<string>|null} p.lastTools  .last-tools 记录（null = 无记录）
+ * @param {string[]} p.selectedNames 本次选中的工具名
+ * @returns {{action:'skip'|'install', newTools:string[], reason:string}}
+ *   reason: 'version-changed' | 'no-tools-record' | 'new-tools' | 'up-to-date'
+ */
+function decideSetupAction({ sameVersion, lastTools, selectedNames }) {
+  if (!sameVersion) return { action: 'install', newTools: [], reason: 'version-changed' };
+  if (lastTools === null) return { action: 'install', newTools: [], reason: 'no-tools-record' };
+  const newTools = (selectedNames || []).filter(n => !lastTools.has(n));
+  if (newTools.length > 0) return { action: 'install', newTools, reason: 'new-tools' };
+  return { action: 'skip', newTools: [], reason: 'up-to-date' };
+}
+
+module.exports = { decideSetupAction, readLastToolsFrom };

package/cbb/lib/utils/gitignore.js

@@ -20,6 +20,7 @@ const GITIGNORE_RULES = [
   { add: '.codespace/', accept: ['.codespace/', '.codespace'] },
   { add: '.opencode', accept: ['.opencode', '.opencode/'] },
   { add: '.codebuddy', accept: ['.codebuddy', '.codebuddy/'] },
+  { add: '.workbuddy', accept: ['.workbuddy', '.workbuddy/'] },
   { add: '.trae', accept: ['.trae', '.trae/'] },
 ];
 

package/config/workspace-agents.sample.md

@@ -20,7 +20,7 @@
 | `.codespace/` | 各关联应用的基准代码（每个应用一个子目录） | `cbb setup` 与 worktree 流程自动 clone / fetch；**勿手动编辑**；已 gitignore，不提交 |
 | `.worktrees/` | 需求隔离开发区（每个需求一个 `worktree-<需求名>/` 目录） | worktree 命令自动创建 / 清理；不提交（首次执行 worktree 流程时自动加入 .gitignore） |
 | `openspec/` | OpenSpec 工作流配置（`config.yaml` + `schemas/`） | 由 cbb 安装；变更产物（`openspec/changes/` 等）worktree 模式在**需求工作树内**生成随需求分支提交，轻量模式直接在空间根生成提交 main |
-| `.claude/` `.qoder/` `.opencode/` `.codebuddy/` `.trae/` | AI 工具适配目录：编码规范规则、OpenSpec 命令、worktree 管理技能（skill 形态） | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
+| `.claude/` `.qoder/` `.opencode/` `.workbuddy/` `.trae/` | AI 工具适配目录：编码规范规则、OpenSpec 命令、worktree 管理技能（skill 形态） | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
 | `.cbb/` | cbb 安装清单与状态（`.managed-by-cbb`、`.last-tools`） | 由 cbb 管理；**勿手动编辑** |
 
 ## 典型流程

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.14",
+  "version": "0.0.3-beta.16",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {
@@ -19,7 +19,7 @@
   "scripts": {
     "sync:shared": "node scripts/sync-shared.js",
     "pretest": "node scripts/sync-shared.js --check",
-    "test": "node test/lib/install/cleanup.test.js && node test/lib/utils/settings.test.js && node test/lib/utils/gitignore.test.js && node test/lib/utils/version.test.js && node test/lib/install/workspaces.test.js && node test/lib/utils/checkbox.test.js && node test/lib/utils/output.test.js && node test/lib/install/cli-help.test.js && node test/lib/install/adapters.test.js && node test/lib/wiki/wiki-publish.test.js && node test/lib/wiki/wiki-parse-args.test.js && node test/lib/wiki/wiki-split.test.js && node test/lib/superpowers/superpowers.test.js && node test/worktrees/push-branches.test.js && node test/worktrees/commit-worktrees.test.js && node test/worktrees/push-worktrees.test.js && node test/worktrees/check-env-deep.test.js && node test/worktrees/create-worktrees.test.js && node test/worktrees/make-mr-urls.test.js && node test/lib/openspec/protected-paths.test.js"
+    "test": "node test/lib/install/cleanup.test.js && node test/lib/utils/settings.test.js && node test/lib/utils/gitignore.test.js && node test/lib/utils/version.test.js && node test/lib/install/workspaces.test.js && node test/lib/utils/checkbox.test.js && node test/lib/utils/output.test.js && node test/lib/install/cli-help.test.js && node test/lib/install/adapters.test.js && node test/lib/wiki/wiki-publish.test.js && node test/lib/wiki/wiki-parse-args.test.js && node test/lib/wiki/wiki-split.test.js && node test/lib/superpowers/superpowers.test.js && node test/worktrees/push-branches.test.js && node test/worktrees/commit-worktrees.test.js && node test/worktrees/push-worktrees.test.js && node test/worktrees/check-env-deep.test.js && node test/worktrees/create-worktrees.test.js && node test/worktrees/make-mr-urls.test.js && node test/lib/install/setup-decision.test.js && node test/lib/openspec/protected-paths.test.js"
   },
   "keywords": [
     "cbb",