@linkdesk/plugin-sdk 0.1.31 → 0.1.33

package/dist/eslint/checks/command-ownership.test.js

@@ -0,0 +1,207 @@
+/**
+ * check-command-ownership 腿·**命令 id / 协议 id 归属判据**（E6#111b · 1.32）单测。
+ *
+ * 为什么值得一条测试：这条腿的**两条失效方向都是静默的**——
+ *   · 太松（放过一条不带归属的 id）⇒ 壳侧按名字第一段找属主 ⇒ 两个插件撞前缀时**静默互相覆盖**
+ *     （不报错、只是有一个命令永远不生效），正是本件要杀的形态；
+ *   · 太紧（误伤合法 id / 把宿主保留面判错户）⇒ 插件仓白红，作者学会「看到黄就 disable」。
+ * 故判据①②（本仓前缀 ／ 宿主保留面）＋ 三面（声明 ／ 运行时 ／ 协议）＋ fail-closed ＋ 豁免
+ * **正反两向都钉住**，另加两条元判据：
+ *   · **同一份源码 ＋ 不同 pluginId ⇒ 不同裁决**（证明真的在读 manifest，不是恒红/恒绿）；
+ *   · **账读不到 ⇒ 判据② 明示空转**（不是静默绿）——账是判据② 的**唯一**输入（不许内联一份）。
+ *
+ * 命令 id 用**真实形态样本**（`file-tree` 的 `selectForCompare`——H3 那条「借了 `editor.` 前缀」的命令）
+ * 与虚构 id 并用：真实形态才抓得到「前缀与属主不是一回事」这类错，虚构 id 用来钉边界。
+ */
+import { describe, expect, it } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { judgeCommandId, runCommandOwnershipCheck, manifestIdLine } from "./command-ownership.js";
+/** 宿主保留面夹具（不依赖真账内容——真账会被后续轮次加家族；这里只钉判据的形状） */
+const RESERVED = {
+    commandPrefixes: ["workbench.", "view."],
+    protocolIds: ["bracket"],
+    configKeys: [],
+    pseudoPluginIds: [],
+    appearanceRecipeIds: [],
+    appearanceColorwayIds: [],
+    appearanceIconThemeIds: [],
+    appearanceSentinels: [],
+    appearanceIdGrants: {},
+    contextKeysHostOnly: [],
+    contextKeysPublic: [],
+};
+/** 造一个临时插件工程（manifest 写成 JSONC——作者面允许注释，读 manifest 的代码必须容忍） */
+function withPlugin(opts, fn) {
+    const base = mkdtempSync(join(tmpdir(), "cmd-owner-"));
+    const root = opts.dirName ? join(base, opts.dirName) : base;
+    mkdirSync(join(root, "src"), { recursive: true });
+    if (opts.manifest !== null) {
+        const raw = opts.manifest ?? {
+            pluginId: "file-tree",
+            name: "文件树",
+            version: "1.0.0",
+            contributes: { commands: [{ id: "file-tree.revealInExplorer", title: "在资源管理器中显示" }] },
+        };
+        writeFileSync(join(root, "plugin.json"), `{\n  // 作者允许的注释\n  ${JSON.stringify(raw).slice(1, -1)},\n}\n`, "utf8");
+    }
+    for (const [rel, body] of Object.entries(opts.files ?? {})) {
+        const abs = join(root, rel);
+        mkdirSync(join(abs, ".."), { recursive: true });
+        writeFileSync(abs, body, "utf8");
+    }
+    try {
+        fn(root);
+    }
+    finally {
+        rmSync(base, { recursive: true, force: true });
+    }
+}
+/** 账的假路径（不存在 ⇒ 报告里 hostLedger.found = false）——用于「账读不到」这一控 */
+const NO_LEDGER = join(tmpdir(), "no-such-host-reserved.json");
+describe("判据①② 三面（声明 / 运行时 / 协议）", () => {
+    it("正控：三面都带本仓前缀 ⇒ 零违规，且三面读数各就各位", () => {
+        withPlugin({
+            files: {
+                "src/register.ts": 'lk.commands.registerCommand("file-tree.selectForCompare", () => 0);\n' +
+                    'registerProtocol({ id: "file-tree.codec", name: "编解码", pluginId: "file-tree", mode: "text" });\n',
+            },
+        }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(0);
+            expect(r.declaredIds).toEqual(["file-tree.revealInExplorer"]);
+            expect(r.runtimeIds).toEqual(["file-tree.selectForCompare"]);
+            expect(r.protocolIds).toEqual(["file-tree.codec"]);
+            expect(r.pluginId).toBe("file-tree");
+            expect(r.pluginIdSource).toBe("plugin.json");
+        });
+    });
+    it("N1 负控：声明面 id 前缀被删掉 ⇒ 红，报点带 文件:行 ＋「应以 file-tree. 开头」＋ 建议名", () => {
+        withPlugin({ manifest: { pluginId: "file-tree", name: "文件树", version: "1.0.0", contributes: { commands: [{ id: "selectForCompare", title: "对比" }] } } }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1);
+            const v = r.violations[0];
+            expect(v.file).toBe("plugin.json");
+            expect(v.line).toBeGreaterThan(1); // 真实行号（不是恒 1）
+            expect(v.message).toContain('id "selectForCompare"');
+            expect(v.message).toContain('应以 "file-tree." 开头');
+            expect(r.sites[0].code).toBe("no-plugin-prefix");
+            expect(r.sites[0].suggested).toBe("file-tree.selectForCompare"); // 改名映射可直接用
+        });
+        // 还原（加回前缀）⇒ 逐字节同一份源码回到零违规
+        withPlugin({ manifest: { pluginId: "file-tree", name: "文件树", version: "1.0.0", contributes: { commands: [{ id: "file-tree.selectForCompare", title: "对比" }] } } }, (root) => {
+            expect(runCommandOwnershipCheck(root, RESERVED, NO_LEDGER).violations).toHaveLength(0);
+        });
+    });
+    it("N2 负控：命令 id 落在宿主保留前缀里 ⇒ 红，且点名撞上哪一条", () => {
+        withPlugin({
+            manifest: {
+                pluginId: "file-tree",
+                name: "文件树",
+                version: "1.0.0",
+                contributes: { commands: [{ id: "workbench.action.showCommands", title: "命令面板" }] },
+            },
+        }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1);
+            expect(r.sites[0].code).toBe("host-reserved");
+            expect(r.sites[0].reserved).toBe("workbench.");
+            expect(r.violations[0].message).toContain("宿主保留面");
+            // 🔴 建议值 = **只换第一段**（`workbench.` 换成自己的前缀，词干一个字不改）——
+            //   与报点里的措辞必须是同一件事：措辞说「前缀只插入」而建议值把 `workbench.` 删了，
+            //   第三方作者按文字做会与按建议值做得到两个不同结果（E6#111b 发布 0.1.30 修的就是这处）。
+            expect(r.sites[0].suggested).toBe("file-tree.action.showCommands");
+            expect(r.violations[0].message).toContain("只换第一段");
+            expect(r.violations[0].message).not.toContain("前缀只插入");
+        });
+    });
+    it("N3 负控：运行时面 ＋ 真实形态样本（借了 editor. 前缀的命令）⇒ 红", () => {
+        withPlugin({
+            files: { "src/views/Editor.ts": 'lk.commands.registerCommand("editor.selectForCompare", () => 0);\n' },
+        }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1);
+            expect(r.violations[0].file).toBe("src/views/Editor.ts");
+            expect(r.violations[0].line).toBe(1);
+            expect(r.sites[0].face).toBe("runtime");
+            expect(r.sites[0].suggested).toBe("file-tree.selectForCompare");
+        });
+    });
+    it("协议面负控：协议 id 撞宿主内置协议 ⇒ 红（协议面比**全等**，不是前缀）", () => {
+        withPlugin({
+            files: {
+                "src/protocol.ts": 'registerProtocol({ id: "bracket", name: "方括号", pluginId: "file-tree", mode: "text" });\n' +
+                    'registerProtocol({ id: "bracket-ext", name: "扩展方括号", pluginId: "file-tree", mode: "text" });\n',
+            },
+        }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            // `bracket` 撞宿主内置 ⇒ 红；`bracket-ext` 只是**不带本仓前缀**（不以 "bracket" 为保留前缀判定）
+            expect(r.sites.map((s) => [s.id, s.code])).toEqual([
+                ["bracket", "host-reserved"],
+                ["bracket-ext", "no-plugin-prefix"],
+            ]);
+            expect(r.violations[0].message).toContain("宿主保留面");
+        });
+    });
+    it("元判据：同一份源码 ＋ 不同 pluginId ⇒ 不同裁决（读的是 manifest，不是恒红/恒绿）", () => {
+        const files = { "src/a.ts": 'lk.commands.registerCommand("alpha.do", () => 0);\n' };
+        withPlugin({ manifest: { pluginId: "alpha", name: "A", version: "1.0.0" }, files }, (root) => {
+            expect(runCommandOwnershipCheck(root, RESERVED, NO_LEDGER).violations).toHaveLength(0);
+        });
+        withPlugin({ manifest: { pluginId: "beta", name: "B", version: "1.0.0" }, files }, (root) => {
+            expect(runCommandOwnershipCheck(root, RESERVED, NO_LEDGER).violations).toHaveLength(1);
+        });
+    });
+    it("测试/mock 文件里的字面量不报（与另几条腿同口径，免得插件仓白噪声）", () => {
+        withPlugin({ files: { "src/a.test.ts": 'registerCommand("editor.nope", () => 0);\n' } }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(0);
+            expect(r.runtimeIds).toEqual([]);
+        });
+    });
+});
+describe("fail-closed / 豁免 / 账的加载实况", () => {
+    it("fail-closed：没有 plugin.json ⇒ 红一条（拿不到身份就无从判归属）", () => {
+        withPlugin({ manifest: null, files: { "src/a.ts": 'registerCommand("who.knows", () => 0);\n' } }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1);
+            expect(r.violations[0].file).toBe("plugin.json");
+            expect(r.violations[0].message).toContain("拿不到本仓 pluginId");
+            expect(r.runtimeIds).toEqual([]); // 身份不明 ⇒ 不继续扫（免得把「无主」报成「不合规」）
+        });
+    });
+    it("豁免：标准 disable 注释盖住一条运行时面报点 ⇒ 静默（知情绕行语义）", () => {
+        withPlugin({
+            files: {
+                "src/a.ts": "// eslint-disable-next-line linkdesk/no-unowned-command-id -- 兼容旧名，1.42 改名轮统一处理\n" +
+                    'lk.commands.registerCommand("editor.selectForCompare", () => 0);\n',
+            },
+        }, (root) => {
+            const r = runCommandOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(0);
+            expect(r.runtimeIds).toEqual(["editor.selectForCompare"]); // 读数照记（豁免只影响报点）
+        });
+    });
+    it("账读不到 ⇒ 报告里明确标记（判据② 空转，不是静默绿）", () => {
+        withPlugin({ files: { "src/a.ts": 'registerCommand("workbench.x", () => 0);\n' } }, (root) => {
+            const r = runCommandOwnershipCheck(root, { commandPrefixes: [], protocolIds: [], configKeys: [], pseudoPluginIds: [], appearanceRecipeIds: [], appearanceColorwayIds: [], appearanceIconThemeIds: [], appearanceSentinels: [], appearanceIdGrants: {}, contextKeysHostOnly: [], contextKeysPublic: [] }, NO_LEDGER);
+            expect(r.hostLedger.found).toBe(false);
+            // 账空 ⇒ 判据② 无输入；`workbench.x` 仍因**不带本仓前缀**被 ① 报出来
+            expect(r.sites[0].code).toBe("no-plugin-prefix");
+        });
+    });
+});
+describe("辅助（探针与腿共用的纯函数）", () => {
+    it("judgeCommandId：顺序 = 先判宿主保留面、后判本仓前缀（撞保留面时报告更严重的那条）", () => {
+        expect(judgeCommandId("workbench.a", "workbench", RESERVED, "declared")?.code).toBe("host-reserved");
+        expect(judgeCommandId("file-tree.a", "file-tree", RESERVED, "declared")).toBeNull();
+        expect(judgeCommandId("bracket", "file-tree", RESERVED, "protocol")?.reserved).toBe("bracket");
+    });
+    it("manifestIdLine：找得到 ⇒ 真实行号；找不到 ⇒ 1（不抛错、不当成「不存在」）", () => {
+        const raw = '{\n  "contributes": {\n    "commands": [\n      { "id": "file-tree.x" }\n    ]\n  }\n}\n';
+        expect(manifestIdLine(raw, "file-tree.x")).toBe(4);
+        expect(manifestIdLine(raw, "nope.y")).toBe(1);
+    });
+});
+//# sourceMappingURL=command-ownership.test.js.map

package/dist/eslint/checks/command-ownership.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-ownership.test.js","sourceRoot":"","sources":["../../../src/eslint/checks/command-ownership.test.ts"],"names":[],"mappings":"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"}

package/dist/eslint/checks/config-ownership.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-ownership.test.d.ts.map

package/dist/eslint/checks/config-ownership.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-ownership.test.d.ts","sourceRoot":"","sources":["../../../src/eslint/checks/config-ownership.test.ts"],"names":[],"mappings":""}

package/dist/eslint/checks/config-ownership.test.js

@@ -0,0 +1,252 @@
+/**
+ * check-config-ownership 腿·**配置键归属判据**（E6#111d · 1.34）单测。
+ *
+ * 为什么值得一条测试：这条腿**两侧都容易错，且错法不同**——
+ *   · 太松（放过一个宿主保留键）⇒ 装上壳后那个键被**运行时拒绝注册**，作者却在 lint 里看到全绿
+ *     （"本地绿、装上炸"是作者最恨的一类）；太松（放过一个不带前缀的键）⇒ 键归别人名下，
+ *     两个插件撞键时一个静默失效。
+ *   · 太紧（把弱默认值面的键当"新键"要求前缀）⇒ **把 `configurationDefaults` 这个能力判死**
+ *     （它的语义就是给**别人的**键建议弱默认值），作者只能 disable 整条腿。
+ * 故：判据①（宿主保留面 ⇒ 红）／判据②（本仓前缀 ⇒ 黄）／**面差异**（`defaults` 面不判②）／
+ * fail-closed ／ 豁免 —— 正反两向都钉住，另加三条元判据：
+ *   · **同一份源码 ＋ 不同 pluginId ⇒ 不同裁决**（证明真在读 manifest，不是恒红/恒绿）；
+ *   · **红与黄在同一例里同时断言**（`violations` 长度与 `advisories` 长度各就各位）——
+ *     只测"报出来了"是不够的，**分级写错**（黄判成红）同样是这条腿的失效方向；
+ *   · **账读不到 ⇒ 明示空转**（不是静默绿）——账是判据① 的**唯一**输入（不许内联一份清单）。
+ */
+import { describe, expect, it } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { judgeConfigKey, judgeRegisterIdentity, runConfigOwnershipCheck, } from "./config-ownership.js";
+/** 宿主保留面夹具（不依赖真账内容——真账会被后续轮次加家族；这里只钉判据的形状） */
+const RESERVED = {
+    commandPrefixes: ["workbench.", "view."],
+    protocolIds: ["bracket"],
+    configKeys: ["app.theme", "app.surfaceRadius", "app.schemaVersion"],
+    pseudoPluginIds: ["app", "appearance", "update"],
+    appearanceRecipeIds: [],
+    appearanceColorwayIds: [],
+    appearanceIconThemeIds: [],
+    appearanceSentinels: [],
+    appearanceIdGrants: {},
+    contextKeysHostOnly: [],
+    contextKeysPublic: [],
+};
+const NO_LEDGER = join(tmpdir(), "no-such-host-reserved.json");
+/** 造一个临时插件工程（manifest 写成 JSONC——作者面允许注释，读 manifest 的代码必须容忍） */
+function withPlugin(opts, fn) {
+    const base = mkdtempSync(join(tmpdir(), "cfg-owner-"));
+    const root = opts.dirName ? join(base, opts.dirName) : base;
+    mkdirSync(join(root, "src"), { recursive: true });
+    if (opts.manifest !== null) {
+        const raw = opts.manifest ?? {
+            pluginId: "file-tree",
+            name: "文件树",
+            version: "1.0.0",
+            contributes: { configuration: { title: "文件树", properties: { "file-tree.confirmDelete": { type: "boolean" } } } },
+        };
+        writeFileSync(join(root, "plugin.json"), `{\n  // 作者允许的注释\n  ${JSON.stringify(raw).slice(1, -1)},\n}\n`, "utf8");
+    }
+    for (const [rel, body] of Object.entries(opts.files ?? {})) {
+        const abs = join(root, rel);
+        mkdirSync(join(abs, ".."), { recursive: true });
+        writeFileSync(abs, body, "utf8");
+    }
+    try {
+        fn(root);
+    }
+    finally {
+        rmSync(base, { recursive: true, force: true });
+    }
+}
+const manifest = (contributes, pluginId = "file-tree") => ({
+    pluginId,
+    name: "文件树",
+    version: "1.0.0",
+    contributes,
+});
+describe("judgeConfigKey —— 纯判据（只换第一段的建议名形状）", () => {
+    const judge = (key, face) => judgeConfigKey(key, "file-tree", RESERVED, face);
+    it("宿主保留键 ⇒ host-reserved（红）＋ 建议名只换第一段（词干零变化）", () => {
+        expect(judge("app.theme", "declared")).toEqual({
+            code: "host-reserved",
+            suggested: "file-tree.theme",
+            reserved: "app.theme",
+        });
+    });
+    it("退役键 app.schemaVersion 也拦（宿主从不注册它 ⇒ 这里拦它才是判据① 的硬核）", () => {
+        expect(judge("app.schemaVersion", "declared")?.code).toBe("host-reserved");
+    });
+    it("不带本仓前缀（声明面）⇒ no-plugin-prefix（黄）＋ 建议名", () => {
+        expect(judge("confirmDelete", "declared")).toEqual({ code: "no-plugin-prefix", suggested: "file-tree.confirmDelete" });
+        expect(judge("explorer.confirmDelete", "declared")).toEqual({
+            code: "no-plugin-prefix",
+            suggested: "file-tree.confirmDelete",
+        });
+    });
+    it("🔴 面差异：弱默认值面**不判**判据②（它的键天然是别人的键）——但判据① 照判", () => {
+        expect(judge("editor.fontSize", "defaults")).toBeNull(); // 建议别人的键 = 本能力的正常用法
+        expect(judge("app.theme", "defaults")?.code).toBe("host-reserved"); // 顶替宿主设置面 = 照拦
+    });
+    it("合规：本仓前缀 ⇒ 零命中（任何面）", () => {
+        expect(judge("file-tree.confirmDelete", "declared")).toBeNull();
+        expect(judge("file-tree.confirmDelete", "defaults")).toBeNull();
+    });
+    it("judgeRegisterIdentity：宿主伪身份 ⇒ 红；别人的 id ⇒ 黄；自己的 id ⇒ 零命中", () => {
+        expect(judgeRegisterIdentity("app", "file-tree", RESERVED)?.code).toBe("host-reserved");
+        expect(judgeRegisterIdentity("other-plugin", "file-tree", RESERVED)?.code).toBe("no-plugin-prefix");
+        expect(judgeRegisterIdentity("file-tree", "file-tree", RESERVED)).toBeNull();
+    });
+});
+describe("三面（声明 / 弱默认值 / 运行时）＋ 分级", () => {
+    it("正控：三面都合规 ⇒ 零红零黄，三面读数各就各位", () => {
+        withPlugin({
+            manifest: manifest({
+                configuration: { title: "文件树", properties: { "file-tree.confirmDelete": { type: "boolean" } } },
+                configurationDefaults: { "editor.fontSize": 13 }, // 建议别人的键 = 正常用法，不报
+            }),
+            files: { "src/config.ts": 'registerConfiguration("file-tree", { title: "x", properties: {} });\n' },
+        }, (root) => {
+            const r = runConfigOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(0);
+            expect(r.advisories).toHaveLength(0);
+            expect(r.declaredKeys).toEqual(["file-tree.confirmDelete"]);
+            expect(r.defaultsKeys).toEqual(["editor.fontSize"]);
+            expect(r.runtimeIdentities).toEqual(["file-tree"]);
+            expect(r.pluginId).toBe("file-tree");
+            expect(r.pluginIdSource).toBe("plugin.json");
+        });
+    });
+    it("🔴 判据① 红 ＋ 🟡 判据② 黄 **在同一例里同时断言**（分级写错也要被抓）", () => {
+        withPlugin({
+            manifest: manifest({
+                configuration: {
+                    title: "文件树",
+                    properties: {
+                        "app.theme": { type: "string" }, // 判据① ⇒ 红
+                        "explorer.confirmDelete": { type: "boolean" }, // 判据② ⇒ 黄
+                        "file-tree.expandDepth": { type: "number" }, // 合规 ⇒ 不报
+                    },
+                },
+            }),
+        }, (root) => {
+            const r = runConfigOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1); // 红：只在 violations 里
+            expect(r.advisories).toHaveLength(1); // 黄：只在 advisories 里（没进 violations）
+            expect(r.red.map((s) => s.key)).toEqual(["app.theme"]);
+            expect(r.yellow.map((s) => s.key)).toEqual(["explorer.confirmDelete"]);
+            expect(r.red[0].face).toBe("declared");
+            // 红的那条：报点带宿主保留键名 ＋ 建议名；行号是真行号（不是恒 1）
+            expect(r.violations[0].file).toBe("plugin.json");
+            expect(r.violations[0].line).toBeGreaterThan(1);
+            expect(r.violations[0].message).toContain("宿主");
+            expect(r.violations[0].message).toContain('改成 "file-tree.theme"');
+            expect(r.advisories[0].message).toContain('改成 "file-tree.confirmDelete"');
+        });
+    });
+    it("弱默认值面：宿主键 ⇒ 红；别人的键 ⇒ 不报（同一次声明里两种结果并存）", () => {
+        withPlugin({
+            manifest: manifest({
+                configurationDefaults: { "app.surfaceRadius": 8, "editor.wordWrap": true },
+            }),
+        }, (root) => {
+            const r = runConfigOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1);
+            expect(r.red[0].face).toBe("defaults");
+            expect(r.red[0].key).toBe("app.surfaceRadius");
+            expect(r.advisories).toHaveLength(0); // editor.wordWrap 不报（面差异）
+        });
+    });
+    it("运行时面：冒充宿主身份 ⇒ 红；用别人的 id ⇒ 黄；用自己的 id ⇒ 零命中", () => {
+        withPlugin({
+            files: {
+                "src/impersonate.ts": 'registerConfiguration("app", { title: "冒充", properties: {} });\n',
+                "src/borrow.ts": 'registerConfigurationDefaults("other-plugin", { "editor.fontSize": 12 });\n',
+                "src/own.ts": 'registerConfiguration("file-tree", { title: "自己", properties: {} });\n',
+            },
+        }, (root) => {
+            const r = runConfigOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1); // 冒充宿主 = 红
+            expect(r.advisories).toHaveLength(1); // 借别人的 id = 黄
+            expect(r.red[0].face).toBe("runtime");
+            expect(r.red[0].key).toBe("app");
+            expect(r.red[0].file).toBe("src/impersonate.ts");
+            expect(r.red[0].line).toBe(1);
+            expect(r.violations[0].message).toContain("宿主自己的身份");
+            expect(r.yellow[0].file).toBe("src/borrow.ts");
+            // 三面读数含全部身份名（合规的也在——口径：名数，非站点数）；目录遍历顺序不参与断言（比集合）
+            expect([...r.runtimeIdentities].sort()).toEqual(["app", "file-tree", "other-plugin"]);
+        });
+    });
+    it("测试/mock 文件跳过（与另几条腿同口径）——夹具里的 app.* 不报", () => {
+        withPlugin({ files: { "src/config.test.ts": 'registerConfiguration("app", { title: "夹具", properties: {} });\n' } }, (root) => {
+            const r = runConfigOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(0);
+            expect(r.runtimeIdentities).toEqual([]);
+        });
+    });
+    it("fail-closed：没有 plugin.json ⇒ 红一条（不受豁免注释管辖）", () => {
+        withPlugin({ manifest: null, dirName: "no-manifest" }, (root) => {
+            const r = runConfigOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(1);
+            expect(r.violations[0].file).toBe("plugin.json");
+            expect(r.violations[0].message).toContain("拿不到本仓 pluginId");
+            expect(r.red).toHaveLength(0); // 红的是 fail-closed 那条，不是判据命中
+        });
+    });
+    it("账读不到 ⇒ hostLedger.found = false ＋ 两栏计数为 0（判据① 明示空转，不许静默绿）", () => {
+        withPlugin({}, (root) => {
+            const r = runConfigOwnershipCheck(root, { ...RESERVED, configKeys: [], pseudoPluginIds: [] }, NO_LEDGER);
+            expect(r.hostLedger.found).toBe(false);
+            expect(r.hostLedger.configKeys).toBe(0);
+            expect(r.hostLedger.pseudoPluginIds).toBe(0);
+            expect(r.violations).toHaveLength(0); // 账空 ⇒ 判据① 无从命中（这正是"空转"的样子）
+        });
+    });
+    it("元判据：同一份源码 ＋ 不同 pluginId ⇒ 不同裁决（真在读 manifest，不是恒红）", () => {
+        const body = manifest({
+            configuration: { title: "x", properties: { "file-tree.confirmDelete": { type: "boolean" } } },
+        });
+        withPlugin({ manifest: body }, (root) => {
+            expect(runConfigOwnershipCheck(root, RESERVED, NO_LEDGER).violations).toHaveLength(0);
+        });
+        withPlugin({
+            manifest: manifest({
+                configuration: { title: "x", properties: { "file-tree.confirmDelete": { type: "boolean" } } },
+            }, "marketplace"),
+        }, (root) => {
+            const r = runConfigOwnershipCheck(root, RESERVED, NO_LEDGER);
+            expect(r.advisories).toHaveLength(1); // 换身份后同一个键成了"不带本仓前缀"
+            expect(r.advisories[0].message).toContain('应以 "marketplace." 开头');
+        });
+    });
+    it("知情绕行：行级 disable 注释 ⇒ 该行整体静默（红也不亮）", () => {
+        withPlugin({
+            manifest: manifest({
+                configuration: {
+                    title: "x",
+                    properties: {
+                        // disable 注释必须紧邻违规行的上一行
+                        "app.theme": { type: "string" },
+                    },
+                },
+            }),
+        }, (root) => {
+            // 先在**没有**豁免时确认它真的会红（否则本控什么都没证明）
+            expect(runConfigOwnershipCheck(root, RESERVED, NO_LEDGER).violations).toHaveLength(1);
+        });
+        const raw = JSON.stringify(manifest({ configuration: { title: "x", properties: { "app.theme": { type: "string" } } } }));
+        const base = mkdtempSync(join(tmpdir(), "cfg-owner-"));
+        try {
+            writeFileSync(join(base, "plugin.json"), `{\n  // eslint-disable-next-line ${"linkdesk/no-unowned-config-key"} -- 本仓键名迁移留待下个版本\n  ${raw.slice(1)}\n`, "utf8");
+            const r = runConfigOwnershipCheck(base, RESERVED, NO_LEDGER);
+            expect(r.violations).toHaveLength(0); // 豁免生效
+            expect(r.red).toHaveLength(0);
+        }
+        finally {
+            rmSync(base, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=config-ownership.test.js.map

package/dist/eslint/checks/config-ownership.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-ownership.test.js","sourceRoot":"","sources":["../../../src/eslint/checks/config-ownership.test.ts"],"names":[],"mappings":"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"}

package/dist/eslint/checks/context-ownership.d.ts

@@ -0,0 +1,74 @@
+import { type PluginIdSource } from "./plugin-prefix.js";
+import { type HostReservedNames } from "./command-ownership.js";
+import { type CheckViolation } from "./scan.js";
+/** 判据命中的两种形态（与 `CommandIdCode` / `ConfigKeyCode` 同词表：红 = 占别人的面；黄 = 不带本仓归属） */
+export type ContextKeyCode = "host-reserved" | "no-plugin-prefix";
+/** 一处不合规站点（探针与腿共用同一份数据） */
+export interface ContextKeySite {
+    /** 工程相对路径（正斜杠） */
+    file: string;
+    line: number;
+    /** 旗子名 */
+    key: string;
+    code: ContextKeyCode;
+    /** 应改成什么：**只换第一段**（`<pluginId>.` ＋ 原名第一段之后的全部）——词干零变化 */
+    suggested: string;
+    /** code = host-reserved 时：撞上的那条宿主专用旗子名 */
+    reserved?: string;
+}
+export interface ContextOwnershipReport {
+    root: string;
+    pluginId: string | null;
+    pluginIdSource: PluginIdSource | null;
+    pluginIdNote: string | null;
+    /** fail-closed：非 null ⇒ 本腿报红（拿不到身份就无从判归属） */
+    error: string | null;
+    /** 🔴 必须改的（进腿报点） */
+    red: ContextKeySite[];
+    /** 🟡 建议改的（只打印，不拦） */
+    yellow: ContextKeySite[];
+    /** 🟠 **宿主公开约定面**的写点——**不报点、不拦、不进任何退出码**（登记用：让"谁在设约定面"可见） */
+    publicFace: ContextKeySite[];
+    /** 扫到的**全部**旗子名（合规 ＋ 不合规，按出现顺序去重）——探针的读数面（口径：名数，非站点数） */
+    keys: string[];
+    /** 账的加载实况（账没读到 ⇒ 判据① 空转，报告里必须能看出来） */
+    hostLedger: {
+        file: string;
+        found: boolean;
+        contextKeysHostOnly: number;
+        contextKeysPublic: number;
+    };
+    /** 腿报点 = fail-closed ＋ 全部红 */
+    violations: CheckViolation[];
+    /** 黄灯建议（`lint.ts` 打印用；**不进** `LintLeg.violations` ⇒ 不拦 CI） */
+    advisories: CheckViolation[];
+}
+/**
+ * 一个 context key 的裁决（纯函数——单测与探针共用，别在别处再写一份判据）。
+ *
+ * 🔴 建议名的形状 = **只替换第一段**（`explorerFocus` → `file-tree.explorerFocus`，词干零变化），
+ *    与 `judgeCommandId` / `judgeConfigKey` 同形。
+ * ⚠️ **约定面（`contextKeysPublic`）在这里返回 null**——它既不是红的，也**不判黄**：
+ *    约定面是**名册里已登记的名字**，谁设都合法（1.37 §13.5）；它的写点由 `publicFace` 单独登记。
+ */
+export declare function judgeContextKey(key: string, pluginId: string, reserved: HostReservedNames): {
+    code: ContextKeyCode;
+    suggested: string;
+    reserved?: string;
+} | null;
+/**
+ * 扫描面：源码里 `contextKey.set("<字面量>", …)` 与 `ContextKeyService.setValue("<字面量>", …)`。
+ * 🔴 两支**都要扫**：前者是插件侧惯用写法（`contextKey` 是注入的 API 对象），后者是壳侧写法——
+ * 同一件事的两张脸，只扫一支 = 漏一半（1.37 §十七 的复现命令就是按这两支取读数的）。
+ * ⚠️ `` ` `` 定界符保留，但**分两种**：
+ *   · **无插值**的模板（`` set(`myFlag`, 1) ``）= 字面量 ⇒ **扫得到**（能扫到就是收益）。
+ *   · **带插值**的（`` set(`exp${x}`, 1) ``）⇒ 名字在运行时才拼出来，**扫不到**——§15.1 登记的残余边界。
+ *     实现上由 `(?![\s\S]*?\$\{)` 挡：模板体里出现 `${` 一律不匹配（**不是**匹配出一个
+ *     `exp${x}` 这种不存在的名字——那会变成假红，比漏报更坏）。
+ */
+export declare const RE_CONTEXT_KEY_SET: RegExp;
+/**
+ * 跑本仓 context key 归属判据。返回结构化报告（探针用）＋ 腿报点（`lint.ts` 用）——**同一份实现**。
+ */
+export declare function runContextOwnershipCheck(root: string, reserved?: HostReservedNames, reservedFile?: string): ContextOwnershipReport;
+//# sourceMappingURL=context-ownership.d.ts.map

package/dist/eslint/checks/context-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-ownership.d.ts","sourceRoot":"","sources":["../../../src/eslint/checks/context-ownership.ts"],"names":[],"mappings":"AA6CA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtG,OAAO,EAAsD,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpG,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAElE,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oBAAoB;IACpB,GAAG,EAAE,cAAc,EAAE,CAAC;IACtB,sBAAsB;IACtB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,6DAA6D;IAC7D,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sCAAsC;IACtC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;IACrG,8BAA8B;IAC9B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,iBAAiB,GAC1B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUvE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,QAC0G,CAAC;AAE1I;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,iBAAsC,EAChD,YAAY,GAAE,MAA2B,GACxC,sBAAsB,CAuFxB"}