@jspg-ai/coding-bb 0.0.3-beta.3 → 0.0.3-beta.31

package/cbb/lib/install/minimax.js

@@ -0,0 +1,60 @@
+/**
+ * MiniMax Code（mcode CLI）适配器
+ *
+ * 官方源码考证结论（agent.minimaxi.com 文档站 + 源码浅克隆）：
+ * - rules：MiniMax 无原生 rules 自动读取逻辑（源码无 .minimax/rules 读取），
+ *   规则照常分发到 .minimax/rules/，靠 AGENTS.md 托管导航块（agentsNav）引导
+ *   AI 主动读取——AGENTS.md 是 MiniMax 唯一的项目级规则注入通道
+ *   （local-runtime/src/project/instructions.ts，32KB 预算）。
+ * - skills：.minimax/skills 为原生 workspace skill 根（skills/roots.ts），
+ *   标准 Agent Skills 格式（目录名 = frontmatter name）零改写。
+ * - commands：MiniMax 无项目级 commands 目录，openspec 命令转 skill 形态分发
+ *   （skill 即其命令形态，/opsx-propose 斜杠照常可用），commandsAsSkills: true。
+ * - hooks：无 Claude 式 settings.json hooks（hooks 仅插件作用域），版本检查改用
+ *   用户级本地插件（<data-dir>/plugins/cbb-check-update，声明 UserPromptSubmit）。
+ *
+ * 数据目录：MINIMAX_DATA_DIR（优先）> MAVIS_DATA_DIR > ~/.minimax，与 mcode
+ * 运行时一致；用户若改过数据目录，需重跑 cbb update 以重装插件到新位置。
+ *
+ * 退市（selectable: false）：实测 MiniMax Code 不支持目录级 skill 与 command
+ * （无项目级 commands 目录，skill 亦需插件形态承载），当前分发形态不可用。
+ * 适配器代码与全部能力保留（备将来改走插件形态），但不在安装面板提供；
+ * 已安装过（beta.29）的空间按 .last-tools 记录**粘性维护**，内容不被清理。
+ */
+
+const path = require('path');
+const os = require('os');
+
+/** 解析 mcode 数据目录（调用时求值，便于环境变量覆盖与测试） */
+function resolveDataDir() {
+  return process.env.MINIMAX_DATA_DIR
+    || process.env.MAVIS_DATA_DIR
+    || path.join(os.homedir(), '.minimax');
+}
+
+module.exports = {
+  name: 'minimax',
+  displayName: 'MiniMax Code',
+  rulesDir: '.minimax/rules',
+  skillsDir: '.minimax/skills',
+  // 无项目级 commands 目录：openspec 命令转 <skillsDir>/<prefix><name>/SKILL.md
+  commandsAsSkills: true,
+  commandPrefix: 'opsx-',
+  // 部署副本中把 /opsx: 与 /cbb: 引用改写为 skill 斜杠风格（/opsx-propose）
+  contentRewrites: [['/opsx:', '/opsx-'], ['/cbb:', '/cbb-']],
+  // AGENTS.md 托管导航块（幂等注入 / 卸载精确摘除，不触碰块外用户内容）
+  agentsNav: {
+    file: 'AGENTS.md',
+    text: '⚠️ 规则优先：在当前目录下执行的任何任务（不限于编码任务）开始前，必须先读取并遵循 `.minimax/rules/` 中的相关规则文件。',
+  },
+  // 版本检查 hook：用户级本地插件（<dataDir>/plugins/<dirName>，自动发现热加载、默认启用）
+  pluginHook: {
+    dirName: 'cbb-check-update',
+    events: ['UserPromptSubmit'],
+    // 解析上限：MiniMax timeout 单位为秒，1–10（超出视为非法回落 5s）
+    timeout: 10,
+  },
+  resolveDataDir,
+  // 退市：不在安装面板提供（代码保留，存量空间粘性维护）
+  selectable: false,
+};

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,11 +21,10 @@ 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，与文档一致）
+  commandNameKebab: true,
   // rules 加载登记：写入 .opencode/opencode.json 的 instructions。
   // instructions 相对路径的解析基准（配置文件目录 vs 项目根）文档未写死，
   // 登记双 glob 对冲：任一基准下恰有一个命中，另一个空匹配。

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/tool-selection.js

@@ -0,0 +1,45 @@
+'use strict';
+
+/**
+ * 工具选择策略：安装面板的可见集合 + 退市工具的粘性保留。
+ *
+ * 背景（2026-09-28 决策）：MiniMax Code 实测不支持目录级 skill 与 command、
+ * Claude Code 团队当前未用，两者**退市**——适配器与全部能力保留（见各适配器
+ * 文件头），仅不在 `cbb setup` / `cbb update` 的安装面板提供。
+ *
+ * 两条规则：
+ *  1. **可选项**（selectableAdapters）：面板项、非交互全选兜底、setup 默认预选、
+ *     用户级组件新装，一律只用未退市适配器（`selectable !== false`）；
+ *  2. **粘性保留**（carryOverRetired）：某空间的 `.last-tools` 记录过退市工具
+ *     （即确曾安装），则继续纳入本次安装/升级集合——面板不出现，内容不因退市
+ *     被清单差集清删；`.last-tools` 一并保持该记录，避免记录丢失导致下次清理。
+ *
+ * 恢复入口：删掉适配器的 `selectable: false` 即回到面板（决策：不留参数开关）。
+ */
+
+/** 面板/默认可选适配器（未标 selectable: false 的全部） */
+function selectableAdapters(adapters) {
+  return adapters.filter(a => a.selectable !== false);
+}
+
+/**
+ * 把「本空间旧记录中的退市工具」并入选择结果（按注册表顺序追加，去重）。
+ * @param {Array} adapters 注册表全量
+ * @param {Array} selected 本次选择（面板 / 预设 / 记录沿用）
+ * @param {Set<string>|null} lastTools 该空间的旧工具记录（.last-tools）
+ * @returns {Array} 并入后的有序数组（无退市工具需保留时原样返回）
+ */
+function carryOverRetired(adapters, selected, lastTools) {
+  if (!lastTools || lastTools.size === 0) return selected;
+  const selectedNames = new Set(selected.map(a => a.name));
+  const carried = adapters.filter(a =>
+    a.selectable === false && lastTools.has(a.name) && !selectedNames.has(a.name));
+  return carried.length > 0 ? selected.concat(carried) : selected;
+}
+
+/** 结果集中退市工具的显示名（供安装输出提示，如「保留上次选择的 Claude Code」） */
+function retiredNames(selected) {
+  return selected.filter(a => a.selectable === false).map(a => a.displayName);
+}
+
+module.exports = { selectableAdapters, carryOverRetired, retiredNames };

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

package/cbb/lib/install/workspaces.js

@@ -16,7 +16,7 @@ const path = require('path');
 const { execSync } = require('child_process');
 
 const DEFAULT_CONFIG = 'config/workspaces.json';
-const SAMPLE_CONFIG  = 'config/workspace-config.sample.json';
+const SAMPLE_CONFIG  = 'config/CBB-WORKSPACE.sample.json';
 const SAMPLE_AGENTS_MD = 'config/workspace-agents.sample.md';
 
 /**
@@ -104,7 +104,7 @@ function loadWorkspaces(configPath = DEFAULT_CONFIG) {
 }
 
 /**
- * 校验业务工作空间 workspace-config.json 的格式是否合法。
+ * 校验业务工作空间 CBB-WORKSPACE.json 的格式是否合法。
  *
  * 校验项：
  *  - 文件存在且为合法 JSON
@@ -113,31 +113,31 @@ function loadWorkspaces(configPath = DEFAULT_CONFIG) {
  *  - name、repo 为非空字符串；side 必须为 'front'、'back' 或 'mixed'
  *  - desc 为可选字段；一旦出现必须是非空字符串（应用职责描述）
  *
- * @param {string} configPath workspace-config.json 的绝对路径
+ * @param {string} configPath CBB-WORKSPACE.json 的绝对路径
  * @returns {{ valid: boolean, message?: string, config?: object }}
  */
 function validateWorkspaceConfig(configPath) {
   if (!fs.existsSync(configPath)) {
-    return { valid: false, message: `workspace-config.json 不存在：${configPath}` };
+    return { valid: false, message: `CBB-WORKSPACE.json 不存在：${configPath}` };
   }
 
   let raw;
   try {
     raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
   } catch (e) {
-    return { valid: false, message: `workspace-config.json 不是合法 JSON：${e.message}` };
+    return { valid: false, message: `CBB-WORKSPACE.json 不是合法 JSON：${e.message}` };
   }
 
   if (!raw || typeof raw !== 'object') {
-    return { valid: false, message: 'workspace-config.json 内容应为 JSON 对象' };
+    return { valid: false, message: 'CBB-WORKSPACE.json 内容应为 JSON 对象' };
   }
 
   if (!Array.isArray(raw.apps)) {
-    return { valid: false, message: 'workspace-config.json 缺少 apps 数组' };
+    return { valid: false, message: 'CBB-WORKSPACE.json 缺少 apps 数组' };
   }
 
   if (raw.apps.length === 0) {
-    return { valid: false, message: 'workspace-config.json 中 apps 数组为空，请至少配置一个关联应用' };
+    return { valid: false, message: 'CBB-WORKSPACE.json 中 apps 数组为空，请至少配置一个关联应用' };
   }
 
   const VALID_SIDES = ['front', 'back', 'mixed'];
@@ -146,22 +146,22 @@ function validateWorkspaceConfig(configPath) {
     const label = `第 ${i + 1} 项`;
 
     if (!app || typeof app !== 'object') {
-      return { valid: false, message: `workspace-config.json ${label}不是对象` };
+      return { valid: false, message: `CBB-WORKSPACE.json ${label}不是对象` };
     }
     if (typeof app.name !== 'string' || !app.name.trim()) {
-      return { valid: false, message: `workspace-config.json ${label}缺少 name（应用名）` };
+      return { valid: false, message: `CBB-WORKSPACE.json ${label}缺少 name（应用名）` };
     }
     if (typeof app.repo !== 'string' || !app.repo.trim()) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 缺少 repo（Git 仓库地址）` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 缺少 repo（Git 仓库地址）` };
     }
     if (typeof app.side !== 'string' || !app.side.trim()) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 缺少 side（仓库类型，可选值：front / back / mixed）` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 缺少 side（仓库类型，可选值：front / back / mixed）` };
     }
     if (!VALID_SIDES.includes(app.side.trim())) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 的 side 字段值无效："${app.side}"（可选值：front / back / mixed）` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 的 side 字段值无效："${app.side}"（可选值：front / back / mixed）` };
     }
     if (app.desc !== undefined && (typeof app.desc !== 'string' || !app.desc.trim())) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 的 desc 字段应为非空字符串（该应用的职责描述），不需要可整条删除` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 的 desc 字段应为非空字符串（该应用的职责描述），不需要可整条删除` };
     }
   }
 
@@ -186,11 +186,15 @@ function ensureWorkspaceAgentsMd(targetDir) {
   return 'created';
 }
 
-// 旧版空间导航模板（0.0.3 单层安装改造前）的特征语句。
-// 该文件归用户所有、永不覆盖，故只能提示用户删除后重跑 cbb update 重新生成。
+// 旧版空间导航模板的特征语句（命中即提示用户删除后重跑 cbb update 重新生成；
+// 该文件归用户所有、永不覆盖）。分两代：
+//   - 0.0.3 单层安装改造前：前两条
+//   - 双模式重构前（≤0.0.3-beta.21，worktree 默认 + 轻量模式）：后两条
 const LEGACY_AGENTS_MD_MARKERS = [
   '故意不含编码规范',
   '自动安装沙箱内的编码规范',
+  '轻量模式',
+  'AI 会话始终停在空间根',
 ];
 
 /**
@@ -268,7 +272,7 @@ function extractRepoBasename(url) {
 
 /**
  * 判断 repo 是否为样例占位地址（RFC 2606 保留域名）。
- * 样例 workspace-config.json 的 repo 用 example.com 等占位，clone 必然失败；
+ * 样例 CBB-WORKSPACE.json 的 repo 用 example.com 等占位，clone 必然失败；
  * setup 据此逐条跳过空跑并给出明确编辑提示。
  * 支持 SSH（git@host:path）与 URL（ssh://、https://、git://）两种形式的 host 提取。
  *