@jspg-ai/coding-bb 0.0.3-beta.15 → 0.0.3-beta.17

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 (.workbuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
  *
  * 使用方式：
  *   npm install -g @jspg-ai/coding-bb  # 首次使用
@@ -56,7 +56,7 @@ const LAST_TOOLS_FILE = path.join(MANIFEST_DIR, '.last-tools');
 // 适配器（数组顺序 = 工具选择面板的显示顺序）
 const adapters = [
   require('./opencode'),
-  require('./codebuddy'),
+  require('./workbuddy'),
   require('./trae'),
   require('./qoder'),
   require('./claude-code'),
@@ -94,10 +94,31 @@ function hookOpts(adapter) {
   return adapter.hookDialect ? { dialect: adapter.hookDialect } : {};
 }
 
+// 工具历史名迁移：beta.16 及以前为 'codebuddy'（CodeBuddy 目录模型），
+// beta.17 起统一为 'workbuddy'。存量 .last-tools / 清单里的旧名读取时归一，
+// 下次安装由 saveLastTools 以新名落盘。
+const LEGACY_TOOL_NAMES = { codebuddy: 'workbuddy' };
+
+/** 工具名集合归一（旧名 → 新名）；null 透传 */
+function normalizeToolSet(set) {
+  if (!set) return set;
+  return new Set([...set].map(t => LEGACY_TOOL_NAMES[t] || t));
+}
+
+/**
+ * 迁移清理：移除本包写在旧用户级 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');
 
-// 规则 frontmatter 改写（Trae/CodeBuddy 需 alwaysApply: true）
+// 规则 frontmatter 改写（Trae/WorkBuddy 需 alwaysApply: true）
 const { applyRuleRewrites } = require('./rule-rewrite');
 
 // .gitignore 条目决策（纯函数：检测/写入/卸载移除）
@@ -198,7 +219,7 @@ function readLastTools() {
   if (!fs.existsSync(filePath)) return null;
   try {
     const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    return new Set(data.tools || []);
+    return normalizeToolSet(new Set(data.tools || []));
   } catch (_) {
     return null;
   }
@@ -1153,6 +1174,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');
@@ -1267,7 +1292,7 @@ function decideUpgradeIfInstalled(targetDir, selectedAdapters) {
   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),
+    lastTools: normalizeToolSet(setupDecision.readLastToolsFrom(targetDir)),
     selectedNames: (selectedAdapters || []).map(a => a.name),
   });
 
@@ -1776,6 +1801,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('、')}`);
   }
@@ -1894,6 +1920,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);
@@ -1922,7 +1951,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/rule-rewrite.js

@@ -7,7 +7,7 @@
  * `trigger: always_on`。各工具对"始终生效"的字段名不同：
  *  - Qoder：trigger: always_on（源格式）
  *  - Claude Code / opencode：无该字段，靠各自机制加载
- *  - WorkBuddy/CodeBuddy、Trae：alwaysApply: true
+ *  - WorkBuddy、Trae：alwaysApply: true
  *
  * 适配器通过 ruleRewrites（[[from, to], ...]）声明改写规则，部署时套用；
  * 无 ruleRewrites 的适配器原样返回。

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

@@ -6,7 +6,7 @@
  * 背景 bug（0.0.3-beta.15 修复）：旧版 decideUpgradeIfInstalled 只比较
  * 「已装版本 vs 当前包版本」，版本一致即 skip——导致「空间已是当前版本 +
  * 本次新选了工具（如 WorkBuddy）」被整体跳过，新工具的空间级目录
- * （.codebuddy/ 等）永不生成，.last-tools 也不更新。
+ * （.workbuddy/ 等）永不生成，.last-tools 也不更新。
  */
 
 const fs = require('fs');

package/cbb/lib/install/workbuddy.js

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

package/cbb/lib/utils/check-update.js

@@ -23,7 +23,8 @@ const CACHE_FILE = path.join(os.homedir(), '.cbb', '.update-check-cache.json');
 const CACHE_TTL = 24 * 60 * 60 * 1000;
 
 function getProjectDir() {
-  return process.env.CODEBUDDY_PROJECT_DIR
+  return process.env.WORKBUDDY_PROJECT_DIR
+    || process.env.CODEBUDDY_PROJECT_DIR
     || process.env.TRAE_PROJECT_DIR
     || process.env.QODER_PROJECT_DIR
     || process.env.CLAUDE_PROJECT_DIR
@@ -32,8 +33,9 @@ function getProjectDir() {
 
 /** 通过环境变量检测当前调用方对应的适配器名称 */
 function detectAdapterName() {
-  // 兼容变量（CLAUDE_PROJECT_DIR）由 Trae / CodeBuddy 一并注入，故优先判定各自专属变量
-  if (process.env.CODEBUDDY_PROJECT_DIR) return 'codebuddy';
+  // 兼容变量（CLAUDE_PROJECT_DIR）由 Trae / WorkBuddy 一并注入，故优先判定各自专属变量；
+  // CODEBUDDY_PROJECT_DIR 为 WorkBuddy 沿用的历史变量名，一并识别为 workbuddy
+  if (process.env.WORKBUDDY_PROJECT_DIR || process.env.CODEBUDDY_PROJECT_DIR) return 'workbuddy';
   if (process.env.TRAE_PROJECT_DIR) return 'trae';
   if (process.env.QODER_PROJECT_DIR) return 'qoder';
   if (process.env.CLAUDE_PROJECT_DIR) return 'claude-code';

package/cbb/lib/utils/gitignore.js

@@ -19,7 +19,9 @@ const GITIGNORE_RULES = [
   { add: '.cbb/', accept: ['.cbb/'] },
   { add: '.codespace/', accept: ['.codespace/', '.codespace'] },
   { add: '.opencode', accept: ['.opencode', '.opencode/'] },
-  { add: '.codebuddy', accept: ['.codebuddy', '.codebuddy/'] },
+  // .codebuddy：beta.15 及以前写入的旧目录，不再新增（add: null），但卸载/清理时仍移除其行
+  { add: null, accept: ['.codebuddy', '.codebuddy/'] },
+  { add: '.workbuddy', accept: ['.workbuddy', '.workbuddy/'] },
   { add: '.trae', accept: ['.trae', '.trae/'] },
 ];
 
@@ -31,12 +33,12 @@ function toLines(content) {
 /**
  * 给定 .gitignore 内容，返回需要新增的条目。
  * 已含任一可接受形式（带/不带尾斜杠）的目录会被跳过；全部已存在时返回空数组。
- * 返回的是写入形式（.claude / .qoder 无尾斜杠，.cbb/ 带尾斜杠）。
+ * 返回的是写入形式（.claude / .qoder 无尾斜杠，.cbb/ 带尾斜杠；add 为 null 的纯遗留规则不新增）。
  */
 function entriesToAdd(content) {
   const lines = toLines(content).map(l => l.trim());
   return GITIGNORE_RULES
-    .filter(r => !r.accept.some(a => lines.includes(a)))
+    .filter(r => r.add && !r.accept.some(a => lines.includes(a)))
     .map(r => r.add);
 }
 

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.15",
+  "version": "0.0.3-beta.17",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {

package/cbb/lib/install/codebuddy.js

@@ -1,30 +0,0 @@
-/**
- * WorkBuddy / CodeBuddy 适配器
- *
- * 腾讯 WorkBuddy 桌面工作台与 CodeBuddy IDE / CLI 共用项目级配置目录 `.codebuddy/`，
- * 故一个适配器同时覆盖两者。
- *
- * 与 Claude Code / Qoder 的映射差异：
- * - rules：`.codebuddy/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
- */
-
-const path = require('path');
-const os = require('os');
-
-module.exports = {
-  name: 'codebuddy',
-  displayName: 'WorkBuddy（CodeBuddy）',
-  rulesDir: '.codebuddy/rules',
-  skillsDir: '.codebuddy/skills',
-  commandsDir: '.codebuddy/commands/opsx',
-  // 规则 frontmatter 改写：Qoder 风格 → CodeBuddy 风格
-  ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
-  // 用户级 settings，写入全局生效，不污染项目目录
-  settingsFile: path.join(os.homedir(), '.codebuddy', 'settings.json'),
-  settingsFileIsUserLevel: true,
-  hookEvents: ['UserPromptSubmit'],
-};