@jspg-ai/coding-bb 0.0.3-beta.2 → 0.0.3-beta.21

package/cbb/lib/install/opencode.js

@@ -1,31 +1,35 @@
-/**
- * opencode 适配器
- *
- * 将编码规范分发到 .opencode/ 目录（opencode 项目级配置域）。
- *
- * 与 Claude Code / Qoder 的映射差异：
- * - rules：opencode 无原生 rules 目录，部署到 .opencode/rules/ 并由安装流程
- *   将 glob 注册进项目根 opencode.json 的 instructions 字段（官方支持的加载方式）
- * - 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: 引用同步改写
- * - hooks：opencode 无 UserPromptSubmit 等价事件，版本检查 hook 不安装（settingsFile 留空即跳过）
- */
-
-module.exports = {
-  name: 'opencode',
-  displayName: 'opencode',
-  rulesDir: '.opencode/rules',
-  skillsDir: '.opencode/skills',
-  commandsDir: '.opencode/commands',
-  // 部署时给命令文件名加此前缀（规避内置命令名冲突）
-  commandPrefix: 'opsx-',
-  // worktree 管理命令（非 openspec 上游）落在同一扁平目录，用 cbb- 前缀区分
-  worktreeCommandsDir: '.opencode/commands',
-  worktreeCommandPrefix: 'cbb-',
-  // 部署副本中将该引用串改写为 opencode 的命令风格（配合 commandPrefix）
-  contentRewrites: [['/opsx:', '/opsx-'], ['/cbb:', '/cbb-']],
-  // rules 加载登记：注入项目根 opencode.json 的 instructions（glob，相对项目根）
-  instructionsPattern: '.opencode/rules/*.md',
-};
+/**
+ * opencode 适配器
+ *
+ * 将编码规范分发到 .opencode/ 目录（opencode 项目级配置域）。
+ *
+ * 与 Claude Code / Qoder 的映射差异：
+ * - rules：opencode 无原生 rules 目录，部署到 .opencode/rules/ 并由安装流程
+ *   将 glob 登记进 .opencode/opencode.json 的 instructions 字段（opencode V2
+ *   官方支持的配置位置：全局目录 / 项目根 / .opencode 目录内均会被发现）
+ * - skills：.opencode/skills/<name>/SKILL.md，结构与 Claude 同构
+ * - commands：命令名 = 文件名（嵌套目录无命名空间，且 init.md 等会撞内置 /init），
+ *   因此扁平化为 opsx-<name>.md（/opsx-propose）；部署副本中的 /opsx: 与 /cbb: 引用同步改写
+ * - hooks：opencode 无 UserPromptSubmit 等价事件，版本检查 hook 不安装（settingsFile 留空即跳过）
+ */
+
+module.exports = {
+  name: 'opencode',
+  displayName: 'opencode',
+  rulesDir: '.opencode/rules',
+  skillsDir: '.opencode/skills',
+  commandsDir: '.opencode/commands',
+  // 部署时给命令文件名加此前缀（规避内置命令名冲突）
+  commandPrefix: 'opsx-',
+  // 部署副本中将该引用串改写为 opencode 的命令风格（配合 commandPrefix）
+  contentRewrites: [['/opsx:', '/opsx-'], ['/cbb:', '/cbb-']],
+  // 命令显示名取自 frontmatter name，部署副本重写为 kebab-case（/opsx-propose，与文档一致）
+  commandNameKebab: true,
+  // rules 加载登记：写入 .opencode/opencode.json 的 instructions。
+  // instructions 相对路径的解析基准（配置文件目录 vs 项目根）文档未写死，
+  // 登记双 glob 对冲：任一基准下恰有一个命中，另一个空匹配。
+  instructionsFile: '.opencode/opencode.json',
+  instructionsPatterns: ['rules/*.md', '.opencode/rules/*.md'],
+  // 旧版（≤0.0.3-beta.2）曾登记在项目根 opencode.json 的 pattern，迁移/卸载时识别清理用
+  legacyInstructionsPattern: '.opencode/rules/*.md',
+};

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/rule-rewrite.js

@@ -0,0 +1,27 @@
+'use strict';
+
+/**
+ * 规则 frontmatter 改写（纯函数，无副作用，便于单测）。
+ *
+ * 源规则（cbb/dev-standards/rules/*.md）用 Qoder 的 frontmatter 约定
+ * `trigger: always_on`。各工具对"始终生效"的字段名不同：
+ *  - Qoder：trigger: always_on（源格式）
+ *  - Claude Code / opencode：无该字段，靠各自机制加载
+ *  - WorkBuddy、Trae：alwaysApply: true
+ *
+ * 适配器通过 ruleRewrites（[[from, to], ...]）声明改写规则，部署时套用；
+ * 无 ruleRewrites 的适配器原样返回。
+ */
+
+/**
+ * 按适配器的 ruleRewrites 改写规则文本。
+ * @param {object} adapter 适配器配置
+ * @param {string} text 规则文件原文
+ * @returns {string} 改写后的文本（无 ruleRewrites 时原样返回）
+ */
+function applyRuleRewrites(adapter, text) {
+  if (!adapter || !adapter.ruleRewrites) return text;
+  return adapter.ruleRewrites.reduce((t, [from, to]) => t.split(from).join(to), text);
+}
+
+module.exports = { applyRuleRewrites };

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/install/trae.js

@@ -0,0 +1,43 @@
+/**
+ * TraeWork / TraeCode 适配器（中国版）
+ *
+ * 中国版 TraeCode IDE 与 TraeWork 的项目级配置目录为 `.trae/`
+ * （官方文档 docs.trae.cn：项目规则 `.trae/rules/`、项目命令 `.trae/commands`），
+ * `.trae-cn/` 仅是中国版**用户级**目录（~/.trae-cn/hooks.json、user_rules、commands），
+ * 与国际版共用项目级 `.trae/` 命名。cbb 仅支持中国版（我司均用中国版）。
+ *
+ * 与 Claude Code / Qoder 的映射差异：
+ * - rules：`.trae/rules/*.md`（扁平文件、支持子目录，最多 3 层），frontmatter 用
+ *   `alwaysApply: true`（Qoder 的 `trigger: always_on` 需改写，见 ruleRewrites）
+ * - skills：`.trae/skills/<name>/SKILL.md`，结构与 Claude 同构
+ * - commands：命令名 = 文件名，无 Claude 式"目录:命令"命名空间（实测嵌套目录 +
+ *   `name: "OPSX: Apply"` 不出现在斜杠列表），故与 opencode 同款扁平化为
+ *   `.trae/commands/opsx-<name>.md`（/opsx-propose），frontmatter name 同步 kebab 化
+ * - hooks：`~/.trae-cn/hooks.json`（用户级），格式与 Claude 相近但需顶层 `version: 1`
+ *   （由 settingsManager 的 hookDialect 处理），事件名/输出字段一致
+ *
+ * 注意：不设 legacyDirs —— `.trae/` 本就是正确的项目级目录，无需清理。
+ */
+
+const path = require('path');
+const os = require('os');
+
+module.exports = {
+  name: 'trae',
+  displayName: 'TraeWork（TraeCode·中国版）',
+  rulesDir: '.trae/rules',
+  skillsDir: '.trae/skills',
+  commandsDir: '.trae/commands',
+  // 命令扁平化（同 opencode）：中国版命令名 = 文件名，不支持 "目录:命令" 命名空间
+  commandPrefix: 'opsx-',
+  contentRewrites: [['/opsx:', '/opsx-'], ['/cbb:', '/cbb-']],
+  commandNameKebab: true,
+  // 规则 frontmatter 改写：Qoder 风格 → Trae 风格
+  ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
+  // 用户级 hooks 配置（中国版目录为 ~/.trae-cn/，项目级才是 .trae/）
+  settingsFile: path.join(os.homedir(), '.trae-cn', 'hooks.json'),
+  settingsFileIsUserLevel: true,
+  hookEvents: ['UserPromptSubmit'],
+  // Trae 的 hooks.json 需顶层 version: 1（Claude 风格 settings.json 无此字段）
+  hookDialect: 'trae',
+};

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'),
+};