@jspg-ai/coding-bb 0.0.2-beta.29 → 0.0.3-beta.12

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

@@ -0,0 +1,33 @@
+/**
+ * TraeWork / TraeCode 适配器
+ *
+ * 字节 TraeWork 桌面工作台与 TraeCode IDE 共用项目级配置目录 `.trae/`，
+ * 故一个适配器同时覆盖两者。
+ *
+ * 与 Claude Code / Qoder 的映射差异：
+ * - rules：`.trae/rules/*.md`（扁平文件、支持子目录，最多 3 层），frontmatter 用
+ *   `alwaysApply: true`（Qoder 的 `trigger: always_on` 需改写，见 ruleRewrites）
+ * - skills：`.trae/skills/<name>/SKILL.md`，结构与 Claude 同构
+ * - commands：`.trae/commands/`，支持目录嵌套（最多 3 层），与 Claude 同风格
+ * - hooks：`~/.trae-cn/hooks.json`，格式与 Claude 相近但需顶层 `version: 1`
+ *   （由 settingsManager 的 hookDialect 处理），事件名/输出字段一致
+ */
+
+const path = require('path');
+const os = require('os');
+
+module.exports = {
+  name: 'trae',
+  displayName: 'TraeWork（TraeCode）',
+  rulesDir: '.trae/rules',
+  skillsDir: '.trae/skills',
+  commandsDir: '.trae/commands/opsx',
+  // 规则 frontmatter 改写：Qoder 风格 → Trae 风格
+  ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
+  // 用户级 hooks 配置（Trae 用 hooks.json，国内版目录为 ~/.trae-cn/）
+  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/workspaces.js

@@ -186,6 +186,29 @@ function ensureWorkspaceAgentsMd(targetDir) {
   return 'created';
 }
 
+// 旧版空间导航模板（0.0.3 单层安装改造前）的特征语句。
+// 该文件归用户所有、永不覆盖，故只能提示用户删除后重跑 cbb update 重新生成。
+const LEGACY_AGENTS_MD_MARKERS = [
+  '故意不含编码规范',
+  '自动安装沙箱内的编码规范',
+];
+
+/**
+ * 检测空间根 AGENTS.md 是否仍为旧版导航文案（命中任一特征语句即为旧版）。
+ * 仅用于安装时打印提示，不修改文件。
+ * @returns {boolean}
+ */
+function detectLegacyAgentsMd(targetDir) {
+  const agentsPath = path.join(targetDir, 'AGENTS.md');
+  if (!fs.existsSync(agentsPath)) return false;
+  try {
+    const content = fs.readFileSync(agentsPath, 'utf-8');
+    return LEGACY_AGENTS_MD_MARKERS.some(m => content.includes(m));
+  } catch (_) {
+    return false;
+  }
+}
+
 /**
  * 在指定目录执行 `git remote -v`，解析出 [{ name, url }] 列表。
  * 任何异常静默返回空数组，便于上层用 state 机判定。
@@ -285,6 +308,7 @@ module.exports = {
   loadWorkspaces,
   validateWorkspaceConfig,
   ensureWorkspaceAgentsMd,
+  detectLegacyAgentsMd,
   readGitRemotes,
   detectRepo,
   extractRepoBasename,