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

package/cbb/lib/install/claude-code.js

@@ -4,8 +4,8 @@
  * 将编码规范分发到 .claude/rules/ 目录
  *
  * 退市（selectable: false）：团队当前不使用 Claude Code，不在安装面板提供。
- * 适配器代码与全部能力保留（含用户级 settings hook）；先前已安装的空间按
- * .last-tools 记录**粘性维护**（见 tool-selection.js），内容不被清理。
+ * 适配器代码与全部能力保留（含用户级 settings hook）；旧记录中的遗留内容
+ * 不在勾选范围时随清单差集与用户级差集清理移除（ADR 0006）。
  * 恢复入口：删掉 selectable 即可重新出现在面板（决策：不留参数开关）。
  */
 
@@ -22,6 +22,6 @@ module.exports = {
   settingsFile: path.join(os.homedir(), '.claude', 'settings.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],
-  // 退市：不在安装面板提供（代码保留，存量空间粘性维护）
+  // 退市：不在安装面板提供（代码保留；旧记录遗留随清单/用户级差集清理，ADR 0006）
   selectable: false,
 };

package/cbb/lib/install/init.js

@@ -105,7 +105,7 @@ const agentsNav = require('./agents-nav');
 // 命令 → skill 形态转换（commandsAsSkills 适配器，当前仅 MiniMax Code）
 const commandSkill = require('./command-skill');
 
-// 工具选择策略（退市工具不在面板提供 + 存量粘性保留）
+// 工具选择策略（退市工具不在面板提供；勾选范围即权威，ADR 0006）
 const toolSelection = require('./tool-selection');
 
 /** 适配器的 hook 方言参数（Trae 需顶层 version 字段等差异） */
@@ -384,10 +384,7 @@ async function selectTools(isUpgrade) {
       .map(i => selectable[i]);
   }
 
-  // 退市但该空间旧记录里有的工具：粘性保留（继续维护，不因退市清删其内容）
-  result = toolSelection.carryOverRetired(adapters, result, lastTools);
-
-  // 保存本次选择（含粘性保留项，避免记录丢失导致下次被清理），供下次运行时预选
+  // 保存本次选择（勾选范围即权威，供下次运行时预选）
   saveLastTools(result);
   return result;
 }
@@ -1054,7 +1051,8 @@ async function init(targetDir, options = {}) {
     fromRecord = true;
   } else if (isNonInteractive) {
     const lastTools = readLastTools();
-    const reused = lastTools ? adapters.filter(a => lastTools.has(a.name)) : [];
+    // 旧记录只用于预选可选项——历史遗留的退市工具不并回（ADR 0006：勾选范围即权威）
+    const reused = lastTools ? toolSelection.selectableAdapters(adapters).filter(a => lastTools.has(a.name)) : [];
     selectedAdapters = reused.length > 0 ? reused : toolSelection.selectableAdapters(adapters);
     fromRecord = reused.length > 0;
     if (yes && process.stdin.isTTY) {
@@ -1066,19 +1064,10 @@ async function init(targetDir, options = {}) {
     selectedAdapters = await selectTools(isUpgrade);
   }
 
-  // 退市工具粘性保留（面板不出现，但本空间旧记录里有 → 继续维护，内容不被清理）。
-  // 覆盖面板外入口：setup 预设（presetAdapters）与非交互记录沿用；交互面板已在 selectTools 内并过。
-  const lastToolsForDir = readLastTools();
-  const withRetired = toolSelection.carryOverRetired(adapters, selectedAdapters, lastToolsForDir);
-  const retiredKept = toolSelection.retiredNames(withRetired);
-  if (retiredKept.length > 0) {
-    log(`保留上次选择的退市工具：${retiredKept.join('、')}（当前不在安装面板提供，内容继续维护）`, 'dim');
-  }
-  selectedAdapters = withRetired;
+  // 退市工具不粘性保留（ADR 0006）：选择集即权威，旧记录里的退市工具随清单差集清理
 
-  // 业务空间根记录本次选择，供 cbb update 等非交互场景沿用；
-  // 沿用旧记录时同样落盘，使历史工具名（codebuddy → workbuddy）归一化自愈
-  if (isWorkspaceRoot && fromRecord) {
+  // 本次选择落盘（沿用旧记录时同样落盘：归一化历史工具名 + 剔除退市遗留记录）
+  if (fromRecord) {
     saveLastTools(selectedAdapters);
   }
 
@@ -1871,8 +1860,10 @@ function printSetupSummary(selected, selectedAdapters, parentDir) {
 /**
  * 安装用户级组件（与项目无关的内容，一次安装全局可用，幂等）。
  *
- * - 清单：~/.cbb/.user-components 记录本包管理的用户级路径
+ * - 清单：~/.cbb/.user-components 只记录**本次实装**的用户级路径
  * - 内容：check-update hook（settings 由 settingsManager 幂等管理）
+ * - 差集清理（ADR 0006）：不在本次目标集合内的适配器，其清单遗留路径、
+ *   本包版本检查 hook、本地插件一并移除（仅删本包标记项，不动用户自装内容）
  */
 const USER_MANIFEST_FILE = path.join(os.homedir(), '.cbb', '.user-components');
 // 装到用户级的工具 skills（与具体项目无关，任何会话都可能用到）。
@@ -1884,15 +1875,18 @@ async function setupUserLevelComponents(targetAdapters = toolSelection.selectabl
   const srcDir = path.join(SHARED_STANDARDS_DIR, 'cbb', 'tools');
   if (!fs.existsSync(srcDir)) return;
 
-  const managed = new Set();
+  // 旧清单仅作差集清理基准，不再并入 managed（ADR 0006：勾选范围即权威，
+  // 本次未实装的路径由下方差集移除，而非累积保留）
+  let oldPaths = [];
   const manifestDir = path.dirname(USER_MANIFEST_FILE);
   fs.mkdirSync(manifestDir, { recursive: true });
   if (fs.existsSync(USER_MANIFEST_FILE)) {
     try {
       const data = JSON.parse(fs.readFileSync(USER_MANIFEST_FILE, 'utf-8'));
-      (data.paths || []).forEach(p => managed.add(p));
+      oldPaths = data.paths || [];
     } catch (_) { /* ignore parse errors */ }
   }
+  const managed = new Set();
 
   const summaryParts = [];
 
@@ -1939,6 +1933,43 @@ async function setupUserLevelComponents(targetAdapters = toolSelection.selectabl
     summaryParts.push(`版本检查插件 → ${pluginHookAdapters.map(a => a.displayName).join('、')}`);
   }
 
+  // ── 用户级差集清理（ADR 0006：不在本次勾选范围内的工具，用户级组件一并移除）──
+  const targetNames = new Set(targetAdapters.map(a => a.name));
+
+  // 1) 清单路径差集：旧有新无 → 删除（仅本包管理路径，不碰用户自装内容）
+  const removedPaths = [];
+  oldPaths.forEach(relPath => {
+    if (!managed.has(relPath)) {
+      const target = path.join(home, relPath);
+      if (fs.existsSync(target)) {
+        removePath(target);
+        removedPaths.push(relPath);
+      }
+    }
+  });
+  if (removedPaths.length > 0) {
+    summaryParts.push(`移除清单遗留 ×${removedPaths.length}`);
+  }
+
+  // 2) 非目标适配器：摘除本包版本检查 hook（仅删 _managedBy: cbb 标记项，保留用户配置）
+  //    + 本地插件目录
+  const removedNames = [];
+  adapters.filter(a => !targetNames.has(a.name)).forEach(adapter => {
+    let touched = false;
+    if (adapter.settingsFile && adapter.hookEvents) {
+      if (settingsManager.removeHooks(adapter.settingsFile, adapter.hookEvents, hookOpts(adapter))) touched = true;
+      if (cleanLegacySettings(adapter)) touched = true;
+    }
+    if (adapter.pluginHook &&
+        pluginHookManager.remove({ dataDir: adapter.resolveDataDir(), ...adapter.pluginHook })) {
+      touched = true;
+    }
+    if (touched) removedNames.push(adapter.displayName);
+  });
+  if (removedNames.length > 0) {
+    summaryParts.push(`清理 ${removedNames.join('、')} 的用户级组件`);
+  }
+
   if (summaryParts.length > 0) step('✓', '用户级组件', summaryParts.join(' · '));
 
   const pkg = require(path.join(SHARED_STANDARDS_DIR, 'package.json'));
@@ -1955,9 +1986,10 @@ async function setupUserLevelComponents(targetAdapters = toolSelection.selectabl
  * worktree 管理入口与空间导航；旧子集清单升级时由清单差集机制自动补齐全量内容。
  */
 async function updateInstalled() {
-  // 用户级组件沿用本目录的工具选择（.last-tools），无记录或为空才回退全量
+  // 用户级组件沿用本目录的工具选择（.last-tools），无记录或为空才回退全量。
+  // 旧记录只预选可选项——历史遗留的退市工具不并回（ADR 0006）
   const lastTools = readLastTools();
-  const reused = lastTools ? adapters.filter(a => lastTools.has(a.name)) : [];
+  const reused = lastTools ? toolSelection.selectableAdapters(adapters).filter(a => lastTools.has(a.name)) : [];
   await setupUserLevelComponents(reused.length > 0 ? reused : toolSelection.selectableAdapters(adapters));
 
   const manifest = readManifest();

package/cbb/lib/install/minimax.js

@@ -19,7 +19,7 @@
  * 退市（selectable: false）：实测 MiniMax Code 不支持目录级 skill 与 command
  * （无项目级 commands 目录，skill 亦需插件形态承载），当前分发形态不可用。
  * 适配器代码与全部能力保留（备将来改走插件形态），但不在安装面板提供；
- * 已安装过（beta.29）的空间按 .last-tools 记录**粘性维护**，内容不被清理。
+ * 旧记录中的遗留内容不在勾选范围时随清单差集与用户级差集清理移除（ADR 0006）。
  */
 
 const path = require('path');
@@ -55,6 +55,6 @@ module.exports = {
     timeout: 10,
   },
   resolveDataDir,
-  // 退市：不在安装面板提供（代码保留，存量空间粘性维护）
+  // 退市：不在安装面板提供（代码保留；旧记录遗留随清单/用户级差集清理，ADR 0006）
   selectable: false,
 };

package/cbb/lib/install/tool-selection.js

@@ -1,20 +1,18 @@
 '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` 即回到面板（决策：不留参数开关）。
+ * 退市工具的取舍（ADR 0006，反转 beta.30 的粘性保留决策）：
+ *  - 退市工具**不进**选择集：面板、非交互沿用、setup 预设、用户级组件，
+ *     一律只用未退市适配器（`selectable !== false`）；
+ *  - 勾选范围即权威：`.last-tools` 只如实记录本次实际选择，不在范围内的
+ *     工具内容（含用户级 hook / 插件）由清单差集与用户级差集清理移除；
+ *  - 恢复入口：删掉适配器的 `selectable: false` 即回到面板。
  */
 
 /** 面板/默认可选适配器（未标 selectable: false 的全部） */
@@ -22,24 +20,4 @@ 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 };
+module.exports = { selectableAdapters };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.31",
+  "version": "0.0.3-beta.32",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {