@ats-cx/cx-cli 0.1.0 → 0.1.1

package/dist/init.js

@@ -1,6 +1,6 @@
 import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
-import { isApmConfigured, loadConfig, SENTENCE } from "@ats-cx/cx-core";
+import { isApmConfigured, loadApmProviderState, SENTENCE } from "@ats-cx/cx-core";
 import { UserFacingError } from "./errors.js";
 import { formatOut, jsonOut } from "./output.js";
 import { REQUIRED_ENV_KEYS } from "./project-pull.js";
@@ -56,7 +56,7 @@ export function runInit(options) {
             (existsSync(path) ? skipped : created).push(`${dir}/`);
             mkdirSync(path, { recursive: true });
         }
-        // 唯一的非幂等例外：老工作区里内容为 `*` 的 .gitignore 会把语义表挡在 git 外，
+        // 唯一无条件重写的已有文件：老工作区里内容为 `*` 的 .gitignore 会把语义表挡在 git 外，
         // 必须换成选择性模板，否则组件 D 的「宿主 git 承载语义历史」不成立。
         writeFileSync(join(workspaceDir, ".gitignore"), WORKSPACE_GITIGNORE);
         rewritten.push(".gitignore");
@@ -73,11 +73,15 @@ export function runInit(options) {
         else {
             let existingConfig = null;
             let invalidConfigJson = false;
+            let notObjectJson = false;
             try {
                 const parsed = JSON.parse(readFileSync(configPath, "utf8"));
                 if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
                     existingConfig = parsed;
                 }
+                else {
+                    notObjectJson = true;
+                }
             }
             catch {
                 invalidConfigJson = true;
@@ -90,6 +94,11 @@ export function runInit(options) {
                 skipped.push("config.json");
                 warnings.push("config.json 不是合法 JSON，未修改；请手工修复或删除后重跑 cx-cli init。");
             }
+            else if (notObjectJson) {
+                // 与坏 JSON 同待遇：不是对象就没有可定点修的键，删了等于重建，由人决定。
+                skipped.push("config.json");
+                warnings.push("config.json 顶层不是 JSON 对象，未修改；请手工修复或删除后重跑 cx-cli init。");
+            }
             else if (existingConfig && hasPointer && (typeof pointer !== "string" || pointer.length === 0)) {
                 delete existingConfig.toolkitConfigDir;
                 writeFileSync(configPath, `${JSON.stringify(existingConfig, null, 2)}\n`);
@@ -133,7 +142,7 @@ export function runInit(options) {
             warnings.push(`工具箱缺少 ${seedSemantics}，未生成工作区 event-semantics.json；诊断命令会因缺语义表报错。`);
         }
         const toolkitConfigDir = join(resolve(options.toolkitRoot), "config");
-        const apmState = loadConfig(toolkitConfigDir, { source: "toolkit" }).apmProviderState;
+        const apmState = loadApmProviderState(toolkitConfigDir, { source: "toolkit" }).apmProviderState;
         if (apmState?.kind === "invalid") {
             warnings.push(`apm 配置无效：${apmState.error}`);
         }

package/dist/skills.js

@@ -1,7 +1,7 @@
 import { existsSync, lstatSync, mkdirSync, readdirSync, readlinkSync, realpathSync, symlinkSync, unlinkSync, writeFileSync, } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { isApmConfigured, loadConfig, machineConfigDir, SENTENCE } from "@ats-cx/cx-core";
+import { isApmConfigured, loadApmProviderState, machineConfigDir, SENTENCE } from "@ats-cx/cx-core";
 import { jsonOut } from "./output.js";
 export const SKILLS_INSTALL_HELP = `Usage: cx-cli skills install
 
@@ -123,8 +123,9 @@ function findOrphans(packageRoot, skillNames, home) {
     }
     return [...mountOrphans, ...centralOrphans.values()];
 }
+/** 只读 apm-provider 叠层：toolkit.local.json / 语义表 / 规则表出错不该让 skills 组报 io。 */
 function machineApmStatus(packageRoot) {
-    const state = loadConfig(join(packageRoot, "config"), { source: "toolkit" }).apmProviderState;
+    const state = loadApmProviderState(join(packageRoot, "config"), { source: "toolkit" }).apmProviderState;
     return {
         apmConfigured: isApmConfigured(state),
         ...(state?.kind === "invalid" ? { apmError: state.error } : {}),
@@ -301,7 +302,8 @@ export function runSkillsStatus(options) {
             claude: existsSync(join(home, ".claude")),
             codex: existsSync(join(home, ".codex")),
         };
-        const issues = [...inventory.warnings];
+        // issues 只放让 ok 为 false 的原因；缺 SKILL.md 的目录是包内容问题，install 修不了，进 hint 提醒。
+        const issues = [];
         const orphans = findOrphans(packageRoot, inventory.names, home);
         const skills = inventory.names.map(name => {
             const central = inspectLink(join(centralDir, name), join(packageRoot, "skills", name), "realpath");
@@ -327,7 +329,7 @@ export function runSkillsStatus(options) {
         const configDir = resolve(machineConfigDir());
         const configPath = join(configDir, "apm-provider.local.json");
         const apm = machineApmStatus(packageRoot);
-        const hintParts = [ok ? "skills 链接正常。" : "运行 cx-cli skills install 修复。"];
+        const hintParts = [ok ? "skills 链接正常。" : "运行 cx-cli skills install 修复。", ...inventory.warnings];
         if (apm.apmError) {
             hintParts.push(ensurePeriod(`apm 配置无效：${apm.apmError}`));
         }
@@ -369,14 +371,26 @@ export function runSkillsUninstall(options) {
         const orphans = findOrphans(packageRoot, inventory.names, home);
         const removed = [];
         const skipped = [];
+        // 中央段归属先算好：挂载链只在中央链是本包的（或已悬空）时才跟着删。
+        // 否则 nvm 双装场景下卸载旧版本会拆掉新版本的 Claude 入口（中央链早已重指到新版本）。
+        const centralOwned = new Map();
+        for (const name of inventory.names) {
+            const path = join(centralDir, name);
+            const target = symlinkTarget(path);
+            centralOwned.set(name, target !== null && (!existsSync(path) || isWithin(realpathSync(path), packageRoot)));
+        }
         for (const mountDir of mountDirs) {
             for (const name of inventory.names) {
                 const path = join(mountDir, name);
                 const target = symlinkTarget(path);
-                if (target === join(centralDir, name)) {
+                const centralPath = join(centralDir, name);
+                if (target === centralPath && centralOwned.get(name)) {
                     unlinkSync(path);
                     removed.push(path);
                 }
+                else if (target === centralPath) {
+                    skipped.push({ path, reason: `中央链指向别处：${symlinkTarget(centralPath) ?? centralPath}` });
+                }
                 else if (target !== null) {
                     skipped.push({ path, reason: `指向别处：${target}` });
                 }
@@ -398,7 +412,7 @@ export function runSkillsUninstall(options) {
                 }
                 continue;
             }
-            if (!existsSync(path) || isWithin(realpathSync(path), packageRoot)) {
+            if (centralOwned.get(name)) {
                 unlinkSync(path);
                 removed.push(path);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ats-cx/cx-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "编辑器诊断工具箱命令行：串联埋点日志、project 快照与 APM，输出结构化诊断 run 供 Agent 消费；附带 Claude Code / Codex skills",
   "author": "heyg",
   "license": "UNLICENSED",
@@ -27,7 +27,7 @@
   "dependencies": {
     "commander": "^15.0.0",
     "zod": "^3.24.0",
-    "@ats-cx/cx-core": "0.1.0"
+    "@ats-cx/cx-core": "0.1.1"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/skills/cx-cli-setup/SKILL.md

@@ -8,7 +8,7 @@ description: >-
 
 # cx-cli Setup
 
-两级安装的统一入口：**机器级**（全局命令 `cx-cli` 可用 + 包内 skills 链进本机 Agent + 机器级覆盖目录 `~/.config/cx-cli/`，一台机器一次）+ **项目级**（当前仓库建 `.cx-cli/` 诊断工作区，每个仓库一次）。全部幂等：重复触发只补缺的、修坏的，已有配置与语义表不动；`.cx-cli/.gitignore` 是唯一会按当前模板重写的文件。
+两级安装的统一入口：**机器级**（全局命令 `cx-cli` 可用 + 包内 skills 链进本机 Agent + 机器级覆盖目录 `~/.config/cx-cli/`，一台机器一次）+ **项目级**（当前仓库建 `.cx-cli/` 诊断工作区，每个仓库一次）。全部幂等：重复触发只补缺的、修坏的，已有配置与语义表不动（仅为空、非字符串、指向不存在或非目录路径的 `config.json.toolkitConfigDir` 会被定点移除）；`.cx-cli/.gitignore` 是唯一每次都按当前模板重写的已有文件。
 
 本 skill 只调用现成命令并解读 `--json` 输出：机器级喊 `cx-cli skills status` / `cx-cli skills install`，项目级喊 `cx-cli init`。不要绕过它们手工建软链、手工建目录。本 skill 随 `@ats-cx/cx-cli` 包分发，**不需要知道包装在哪**——需要路径时全部从命令输出里取。
 
@@ -78,9 +78,9 @@ cx-cli init --json
 | 字段 | 含义与动作 |
 |------|-----------|
 | `workspaceDir` | 工作区位置（宿主仓库根 `.cx-cli/`） |
-| `created` / `skipped` | 本次建了什么 / 已存在没动什么。首次 init 从工具箱种子复制 `event-semantics.json`；已有语义表、`.env` 与 `config.json` 均不覆盖 |
-| `rewritten` | 本次被 init 改写的已有文件：`.gitignore` 每次按当前模板重写；`config.json` 仅在其 `toolkitConfigDir` 指向不存在的目录时被修（删掉这一键，`warnings` 会说明） |
-| `warnings` | 四类：「宿主不像编辑器仓库」→ 转述给用户确认是否跑错目录，不阻塞；「skills 未安装到本机 Agent（…）」→ 回 §2（§1–2 走完后不该出现）；「apm 未配置：…」→ §4 处理；「config.json 的 toolkitConfigDir 指向不存在的 …，已移除」→ 转述即可，无需动作 |
+| `created` / `skipped` | 本次建了什么 / 已存在没动什么。首次 init 从工具箱种子复制 `event-semantics.json`；已有语义表与 `.env` 不覆盖；`config.json` 除下行所述的失效指针修复外不覆盖 |
+| `rewritten` | 本次被 init 改写的已有文件：`.gitignore` 每次按当前模板重写；`config.json` 仅在其 `toolkitConfigDir` 为空、非字符串、指向不存在或非目录路径时被修（只删这一键，`warnings` 会说明） |
+| `warnings` | 四类：「宿主不像编辑器仓库」→ 转述给用户确认是否跑错目录，不阻塞；「skills 未安装到本机 Agent（…）」→ 回 §2（§1–2 走完后不该出现）；「apm 未配置：…」→ §4 处理；「config.json 的 toolkitConfigDir … 已移除」→ 转述即可，无需动作 |
 | `missingEnvKeys` | `.cx-cli/.env` 里还空着的 DB 凭据键 |
 | `hint` | 汇总提示，可直接转述；apm 未配置时它会说「填好 apm 后可运行 run new / apm query」 |