@zhushanwen/pi-subagent-workflow 8.6.0 → 8.7.0

package/src/shared/__tests__/agent-ref.test.ts

@@ -1,34 +0,0 @@
-/**
- * displayAgentName 测试：agent ref 绝对路径 → UI 显示短名（basename 去 .md）。
- *
- * 数据层不变式（displayAgentName 只服务显示出口）：非路径值原样返回。
- */
-import { describe, expect, it } from "vitest";
-
-import { displayAgentName } from "../agent-ref.ts";
-
-describe("displayAgentName", () => {
-  it("mac/linux 绝对路径取 basename 并去 .md", () => {
-    expect(displayAgentName("/Users/x/.agents/agents/worker.md")).toBe("worker");
-    expect(displayAgentName("/home/u/project/.agents/agents/reviewer.md")).toBe("reviewer");
-  });
-
-  it("windows 路径（反斜杠分隔）同样取短名", () => {
-    expect(displayAgentName("C:\\Users\\x\\agents\\worker.md")).toBe("worker");
-    expect(displayAgentName("C:/Users/x/agents/worker.md")).toBe("worker");
-  });
-
-  it("非路径 agent 名原样返回（DEFAULT_AGENT_NAME 等）", () => {
-    expect(displayAgentName("general-purpose")).toBe("general-purpose");
-    expect(displayAgentName("worker")).toBe("worker");
-  });
-
-  it("无 .md 扩展名的 basename 原样返回（不去别的后缀）", () => {
-    expect(displayAgentName("/a/b/worker")).toBe("worker");
-    expect(displayAgentName("/a/b/agent.spec.ts")).toBe("agent.spec.ts");
-  });
-
-  it("裸文件名（无目录）也去 .md", () => {
-    expect(displayAgentName("worker.md")).toBe("worker");
-  });
-});

package/src/shared/__tests__/meta-parser.test.ts

@@ -1,304 +0,0 @@
-/**
- * meta-parser 测试（v5 §11.1 / TC1-TC10 + 边界 + exec-review 回归）
- *
- * [P-yaml] 探针由 TC5/TC10 承载：验证 eemeli/yaml 真实抛错对象有 linePos 字段且结构为
- * {line,col}（取自 linePos[0]）。不 mock parseYaml——必须用真实库验证此运行时断言。
- *
- * exec-review 回归：major-1（星斜杠截断）+ minor-2（kind 串类）+ minor-3（description 必填）
- * + minor-4（detail 非字符串）+ minor-5（parameters 非对象）+ minor-6（空块 vs 缺块）+ minor-7（CRLF）。
- *
- * 框架：vitest（项目规范：禁 node:test，import from "vitest"）。
- */
-import { describe, expect, it } from "vitest";
-
-import {
-  parseResourceMeta,
-  parseResourceMetaDetailed,
-} from "../meta-parser.ts";
-import type { AgentMeta, WorkflowMeta } from "../resource-meta.ts";
-
-// ── 固定 content fixtures ────────────────────────────────────
-
-const VALID_WORKFLOW = `// 顶部可有任意代码注释
-/* @pi-meta
-name: chain
-description: 通用编排三步链
-when: 用户要顺序编排
-phases: [analyze, transform, synthesize]
-parameters:
-  type: object
-  properties:
-    task: { type: string }
-  required: [task]
-usage: |
-  ## 使用说明
-  - task 必填
-*/
-const agent = require("./agent");
-`;
-
-const VALID_AGENT = `---
-name: code-review
-description: 审查代码变更
-when: 用户要求 review
-notFor: 非 xyz-agent 项目
-examples:
-  - match: "帮我 review 一下"
-    action: 调用 code-review
-    positive: true
-  - match: 今天天气
-    action: 不调用
-    positive: false
-tools: [read, bash, grep]
-model: claude-3.5
----
-# code-review agent 正文
-`;
-
-const MALFORMED_INDENT = `/* @pi-meta
-name: x
-description: bad
-  description: bad indent
-phases: [a]
-*/`;
-
-const REGEX_SINGLE_BACKSLASH = `/* @pi-meta
-name: rfl
-description: 测试正则转义
-phases: [Review, Fix]
-parameters:
-  type: object
-  patternProperties:
-    "^batch\\d+$": { type: string }
-*/`;
-
-const LEGACY_CONST_META = `const meta = {
-  name: chain,
-  description: 旧格式,
-  phases: ["a"]
-};
-const agent = require("./agent");
-`;
-
-const NO_META_BLOCK = `const agent = require("./agent");
-// 纯代码，无 @pi-meta
-`;
-
-const EMPTY_PI_META = `/* @pi-meta
-
-*/
-const x = 1;
-`;
-
-const EMPTY_PHASES = `/* @pi-meta
-name: x
-description: 空 phases
-phases: []
-*/`;
-
-// ── parseResourceMeta（IF1，discovery）──────────────────────
-
-describe("parseResourceMeta (discovery, fail-safe null)", () => {
-  it("TC1: 合法 workflow @pi-meta 返 WorkflowMeta", () => {
-    const meta = parseResourceMeta(VALID_WORKFLOW, "workflow");
-    expect(meta).not.toBeNull();
-    const wf = meta as WorkflowMeta;
-    expect(wf.kind).toBe("workflow");
-    expect(wf.name).toBe("chain");
-    expect(wf.phases).toEqual(["analyze", "transform", "synthesize"]);
-    expect(wf.when).toBe("用户要顺序编排");
-    expect(wf.parameters).toBeDefined();
-    expect(wf.usage).toContain("task 必填");
-  });
-
-  it("TC2: 合法 agent frontmatter 返 AgentMeta", () => {
-    const meta = parseResourceMeta(VALID_AGENT, "agent");
-    expect(meta).not.toBeNull();
-    const a = meta as AgentMeta;
-    expect(a.kind).toBe("agent");
-    expect(a.name).toBe("code-review");
-    expect(a.notFor).toBe("非 xyz-agent 项目");
-    expect(a.examples).toHaveLength(2);
-    expect(a.examples![0]).toEqual({ match: "帮我 review 一下", action: "调用 code-review", positive: true });
-    expect(a.examples![1]!.positive).toBe(false);
-    expect(a.tools).toEqual(["read", "bash", "grep"]);
-    expect(a.model).toBe("claude-3.5");
-  });
-
-  it("TC3: malformed YAML（缩进错）返 null，不抛 [P-yaml]", () => {
-    expect(() => parseResourceMeta(MALFORMED_INDENT, "workflow")).not.toThrow();
-    expect(parseResourceMeta(MALFORMED_INDENT, "workflow")).toBeNull();
-  });
-
-  it("TC4: 缺 meta 块返 null", () => {
-    expect(parseResourceMeta(NO_META_BLOCK, "workflow")).toBeNull();
-  });
-
-  it("TC8（修正）: workflow 字段（phases）当 agent kind 解析，typecheckMeta 串类 reject [minor-2]", () => {
-    // 用 frontmatter 包裹 workflow 字段，确保 FRONTMATTER_RE 匹配、typecheckMeta 真正被触达
-    const content = `---
-name: chainlike
-description: has phases but parsed as agent
-phases: [analyze, transform]
-parameters:
-  type: object
----
-# agent body`;
-    expect(parseResourceMeta(content, "agent")).toBeNull();
-  });
-
-  it("TC8b: agent 字段（examples）当 workflow kind 解析，串类 reject [minor-2]", () => {
-    const content = `/* @pi-meta
-name: x
-description: has examples but workflow
-phases: [A]
-examples:
-  - match: m
-    action: a
-    positive: true
-*/`;
-    expect(parseResourceMeta(content, "workflow")).toBeNull();
-  });
-
-  it("TC9: legacy const meta（无 @pi-meta 块）返 null（无 adapter）[D1]", () => {
-    expect(parseResourceMeta(LEGACY_CONST_META, "workflow")).toBeNull();
-  });
-
-  it("TC10: patternProperties 单反斜杠正则致 YAML 解析失败返 null [P-yaml]", () => {
-    expect(parseResourceMeta(REGEX_SINGLE_BACKSLASH, "workflow")).toBeNull();
-  });
-
-  it("边界：空 @pi-meta 块（内容为空）返 null", () => {
-    expect(parseResourceMeta(EMPTY_PI_META, "workflow")).toBeNull();
-  });
-
-  it("边界：phases: [] 空数组合法（workflow 可无 phase）", () => {
-    const meta = parseResourceMeta(EMPTY_PHASES, "workflow");
-    expect(meta).not.toBeNull();
-    expect((meta as WorkflowMeta).phases).toEqual([]);
-  });
-
-  // ── exec-review 回归 ──────────────────────────────────────
-
-  it("major-1: usage 块标量含 */ 不再截断，parameters 不丢失", () => {
-    const content = `/* @pi-meta
-name: x
-description: d
-phases: [A]
-when: present
-usage: |
-  see */ for details
-parameters:
-  type: object
-  properties:
-    task: { type: string }
-*/`;
-    const meta = parseResourceMeta(content, "workflow");
-    expect(meta).not.toBeNull();
-    const wf = meta as WorkflowMeta;
-    expect(wf.parameters).toBeDefined(); // major-1：此前被 */ 截断静默丢失
-    expect(wf.when).toBe("present");     // 此前同样丢失
-    expect(wf.usage).toContain("see */ for details");
-  });
-
-  it("major-1b: patternProperties 正则含 * 后接 / 不再误截断", () => {
-    const content = `/* @pi-meta
-name: re
-description: regex
-phases: [A]
-parameters:
-  type: object
-  patternProperties:
-    "^\\\\d*/\\\\w+$": { type: string }
-*/`;
-    const meta = parseResourceMeta(content, "workflow");
-    expect(meta).not.toBeNull();
-    expect((meta as WorkflowMeta).parameters).toBeDefined();
-  });
-
-  it("minor-3: 缺 description 返 null（必填，不再静默空串）", () => {
-    const content = `/* @pi-meta
-name: nodesc
-phases: [A]
-*/`;
-    expect(parseResourceMeta(content, "workflow")).toBeNull();
-  });
-
-  it("minor-4: phase detail 非字符串返 null（不再静默丢弃）", () => {
-    const content = `/* @pi-meta
-name: x
-description: d
-phases:
-  - title: A
-    detail: 123
-*/`;
-    expect(parseResourceMeta(content, "workflow")).toBeNull();
-  });
-
-  it("minor-5: parameters 是数组返 null（不再静默当 undefined）", () => {
-    const content = `/* @pi-meta
-name: x
-description: d
-phases: [A]
-parameters: [a, b]
-*/`;
-    expect(parseResourceMeta(content, "workflow")).toBeNull();
-  });
-
-  it("minor-7: CRLF 行尾 frontmatter 正确提取", () => {
-    const content = "---\r\nname: a\r\ndescription: d\r\n---\r\n# body";
-    const meta = parseResourceMeta(content, "agent");
-    expect(meta).not.toBeNull();
-    expect((meta as AgentMeta).name).toBe("a");
-  });
-});
-
-// ── parseResourceMetaDetailed（IF2，generate 闭环）──────────
-
-describe("parseResourceMetaDetailed (generate, linePos)", () => {
-  it("TC6: 合法返 {ok:true, meta}", () => {
-    const r = parseResourceMetaDetailed(VALID_WORKFLOW, "workflow");
-    expect(r.ok).toBe(true);
-    if (r.ok) expect(r.meta.name).toBe("chain");
-  });
-
-  it("TC5: malformed YAML 返 {ok:false, error, linePos:{line,col}} [P-yaml]", () => {
-    const r = parseResourceMetaDetailed(MALFORMED_INDENT, "workflow");
-    expect(r.ok).toBe(false);
-    if (!r.ok) {
-      expect(r.error).toBeTruthy();
-      expect(r.linePos).toBeDefined();
-      expect(typeof r.linePos!.line).toBe("number");
-      expect(typeof r.linePos!.col).toBe("number");
-      expect(r.linePos!.line).toBeGreaterThan(0);
-    }
-  });
-
-  it("TC7: 缺块返 {ok:false, error} 无 linePos", () => {
-    const r = parseResourceMetaDetailed(NO_META_BLOCK, "workflow");
-    expect(r.ok).toBe(false);
-    if (!r.ok) expect(r.linePos).toBeUndefined();
-  });
-
-  it("TC10: 单反斜杠正则返 {ok:false, error 含 escape, linePos} [P-yaml]", () => {
-    const r = parseResourceMetaDetailed(REGEX_SINGLE_BACKSLASH, "workflow");
-    expect(r.ok).toBe(false);
-    if (!r.ok) {
-      expect(r.error).toContain("escape");
-      expect(r.linePos).toBeDefined();
-      expect(r.linePos!.line).toBeGreaterThan(0);
-    }
-  });
-
-  it("minor-6: 空块与缺块错误消息区分（空块不报「未找到」）", () => {
-    const empty = parseResourceMetaDetailed(EMPTY_PI_META, "workflow");
-    const missing = parseResourceMetaDetailed(NO_META_BLOCK, "workflow");
-    expect(empty.ok).toBe(false);
-    expect(missing.ok).toBe(false);
-    if (!empty.ok && !missing.ok) {
-      // 缺块报「未找到 meta 块」；空块报类型校验失败（块在但内容空/非法）
-      expect(missing.error).toContain("未找到");
-      expect(empty.error).not.toContain("未找到");
-    }
-  });
-});

package/src/shared/__tests__/model-ref.test.ts

@@ -1,306 +0,0 @@
-// src/shared/__tests__/model-ref.test.ts
-//
-// [U1 ModelRef 全等裁决] assertCanonicalModelRef / modelRefFromVerified 单测族。
-// 设计权威：docs/design/subagent-dispatch-reliability.md §3.3 D1（规则①~⑤含孪生守卫）、D2（继承路径豁免口径）。
-//
-// P-A2（实施期门）：孪生守卫行为验证——含孪生的 registry 快照实测拒单路径 +
-// 无孪生快照实测放行路径。「有孪生仍放行」= 守卫失效，阻断合入。
-
-import { describe, expect, it } from "vitest";
-
-import {
-  type ModelRefSource,
-  assertCanonicalModelRef,
-  assertThinkingLevel,
-  modelRefFromVerified,
-  stripThinkingSuffix,
-  THINKING_ORDER,
-} from "../model-ref.ts";
-
-// ============================================================
-// helpers
-// ============================================================
-
-/** registry 快照构造（getAvailable 顺序即判定顺序）。 */
-function makeSource(entries: ReadonlyArray<{ provider: string; id: string }>): ModelRefSource {
-  return { getAvailable: () => entries };
-}
-
-/** 基线快照：模拟真实 registry 形态（大小写混合 id + 无关条目）。 */
-const BASELINE: ReadonlyArray<{ provider: string; id: string }> = [
-  { provider: "zai-coding-cn", id: "GLM-5.3-Flash" },
-  { provider: "zai-coding-cn", id: "GLM-5.3" },
-  { provider: "xiaomi-token-plan-cn", id: "mimo-v2.5-pro" },
-  { provider: "deepseek", id: "deepseek-v4-pro" },
-];
-
-// ============================================================
-// 全等放行（规则③）+ 无孪生快照（P-A2 放行路径）
-// ============================================================
-
-describe("assertCanonicalModelRef — exact match passes (rule ③)", () => {
-  it("全等命中 → 返回 {provider, id}，与 registry 条目逐字段全等", () => {
-    const ref = assertCanonicalModelRef("zai-coding-cn/GLM-5.3-Flash", makeSource(BASELINE));
-    expect(ref).toEqual({ provider: "zai-coding-cn", id: "GLM-5.3-Flash" });
-  });
-
-  it("P-A2 放行路径：无孪生快照下全等写法放行（含大小写差异的 id 原样保留）", () => {
-    // 快照中该 id 仅一种大小写形态（GLM-5.3-Flash ≠ glm-5.3，后者是不同 id 而非孪生）
-    const ref = assertCanonicalModelRef("zai-coding-cn/GLM-5.3-Flash", makeSource(BASELINE));
-    expect(ref.id).toBe("GLM-5.3-Flash");
-    expect(ref.provider).toBe("zai-coding-cn");
-  });
-
-  it("无关大小写的不同 id（GLM-5.3 vs GLM-5.3-Flash）不构成孪生，全等命中各自放行", () => {
-    const source = makeSource(BASELINE);
-    expect(assertCanonicalModelRef("zai-coding-cn/GLM-5.3", source)).toEqual({
-      provider: "zai-coding-cn",
-      id: "GLM-5.3",
-    });
-  });
-});
-
-// ============================================================
-// 非全等同步拒单（规则②⑤）+ case variant 首位建议
-// ============================================================
-
-describe("assertCanonicalModelRef — non-exact rejected synchronously (rule ⑤)", () => {
-  it("小写变体输入 → 同步抛错（不采纳、不改写），错误含原始输入", () => {
-    expect(() =>
-      assertCanonicalModelRef("zai-coding-cn/glm-5.3-flash", makeSource(BASELINE)),
-    ).toThrow(/is not a registry entry/);
-  });
-
-  it("case variant 是首个建议且标注 ← case variant（S2 负面路径）", () => {
-    let msg = "";
-    try {
-      assertCanonicalModelRef("zai-coding-cn/glm-5.3-flash", makeSource(BASELINE), { source: "paramOverride" });
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).toMatch(/is not a registry entry/);
-    expect(msg).toContain('Model "zai-coding-cn/glm-5.3-flash" (paramOverride)');
-    expect(msg).toMatch(/Registry match is case-sensitive/);
-    expect(msg).toMatch(/Did you mean one of these\?/);
-    // case variant 排首位并标注
-    const didYouMeanIdx = msg.indexOf("Did you mean one of these?");
-    const variantLine = msg.indexOf("zai-coding-cn/GLM-5.3-Flash   ← case variant of \"glm-5.3-flash\"");
-    expect(variantLine).toBeGreaterThan(didYouMeanIdx);
-    // 其他模糊候选在 case variant 之后
-    const otherIdx = msg.indexOf("Other models you may have meant");
-    expect(otherIdx).toBeGreaterThan(variantLine);
-    expect(msg).toContain("zai-coding-cn/GLM-5.3");
-  });
-
-  it("错误末尾附「省略 model 继承主 agent」指引", () => {
-    let msg = "";
-    try {
-      assertCanonicalModelRef("zai-coding-cn/glm-5.3-flash", makeSource(BASELINE));
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).toMatch(/Or omit the `model` param to inherit the main agent model\./);
-  });
-
-  it("provider 大小写不同（Zai-Coding-CN）→ 不命中（provider 精确匹配，规则②）", () => {
-    let msg = "";
-    try {
-      assertCanonicalModelRef("Zai-Coding-CN/GLM-5.3-Flash", makeSource(BASELINE));
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).toMatch(/is not a registry entry/);
-    // provider 拼写相近 → general 候选命中
-    expect(msg).toMatch(/Other models you may have meant/);
-  });
-
-  it("同 provider 但 id 不存在 → provider 相似度候选（同 provider 下其他条目）", () => {
-    let msg = "";
-    try {
-      assertCanonicalModelRef("zai-coding-cn/nonexistent-probe", makeSource(BASELINE), { source: "agentConfig" });
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).toMatch(/is not a registry entry/);
-    expect(msg).not.toMatch(/Did you mean/);
-    expect(msg).toMatch(/Other models you may have meant/);
-    expect(msg).toContain("zai-coding-cn/GLM-5.3-Flash");
-    expect(msg).toContain("(agentConfig)");
-  });
-
-  it("provider 与 id 均无相似物 → 列合法串全集 + 继承指引（S2 前者路径）", () => {
-    let msg = "";
-    try {
-      assertCanonicalModelRef("ghost-provider/zzz-unknown", makeSource(BASELINE));
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).toMatch(/is not a registry entry/);
-    expect(msg).not.toMatch(/Did you mean/);
-    expect(msg).toMatch(/No similar models found\./);
-    expect(msg).toMatch(/Available models:/);
-    // 合法串全集（canonical 形态，可复制）
-    expect(msg).toContain("zai-coding-cn/GLM-5.3-Flash");
-    expect(msg).toContain("xiaomi-token-plan-cn/mimo-v2.5-pro");
-    expect(msg).toMatch(/Or omit the `model` param to inherit the main agent model\./);
-  });
-
-  it("无 slash / 空 id → 同步拒单（结构非法）", () => {
-    const source = makeSource(BASELINE);
-    expect(() => assertCanonicalModelRef("no-slash", source)).toThrow(/is not a registry entry/);
-    expect(() => assertCanonicalModelRef("only-provider/", source)).toThrow(/is not a registry entry/);
-  });
-
-  it("空 registry → 明确提示 + 继承指引", () => {
-    let msg = "";
-    try {
-      assertCanonicalModelRef("p/m", makeSource([]));
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).toMatch(/Registry has no available models\./);
-    expect(msg).toMatch(/Or omit the `model` param/);
-  });
-});
-
-// ============================================================
-// strip thinking 后缀（规则①）
-// ============================================================
-
-describe("assertCanonicalModelRef — strips legal thinking suffix (rule ①)", () => {
-  it('":xhigh" 后缀剥离后全等命中', () => {
-    const ref = assertCanonicalModelRef("deepseek/deepseek-v4-pro:xhigh", makeSource(BASELINE));
-    expect(ref).toEqual({ provider: "deepseek", id: "deepseek-v4-pro" });
-  });
-
-  it('":max" 后缀剥离后全等命中（THINKING_ORDER 含 max）', () => {
-    const ref = assertCanonicalModelRef("zai-coding-cn/GLM-5.3-Flash:max", makeSource(BASELINE));
-    expect(ref.id).toBe("GLM-5.3-Flash");
-  });
-
-  it('非白名单后缀（":foo"）不剥离 → 未命中拒单', () => {
-    expect(() =>
-      assertCanonicalModelRef("zai-coding-cn/GLM-5.3-Flash:foo", makeSource(BASELINE)),
-    ).toThrow(/is not a registry entry/);
-  });
-});
-
-// ============================================================
-// 孪生守卫（规则④）—— P-A2 拒单路径
-// ============================================================
-
-describe("assertCanonicalModelRef — twin guard (rule ④, P-A2)", () => {
-  /** 含大小写孪生的 registry 快照（模拟 models-store 刷新后 GLM-5.3-Flash 与 glm-5.3-flash 并存）。 */
-  const TWIN_SNAPSHOT: ReadonlyArray<{ provider: string; id: string }> = [
-    { provider: "zai-coding-cn", id: "GLM-5.3-Flash" },
-    { provider: "zai-coding-cn", id: "glm-5.3-flash" },
-    { provider: "deepseek", id: "deepseek-v4-pro" },
-  ];
-
-  it("P-A2 拒单路径：有孪生仍放行 = 守卫失效——全等命中（大写形态）也必须拒绝", () => {
-    let msg = "";
-    try {
-      // 输入与快照条目逐字符全等，但 registry 存在 case-insensitive 相等的另一条目
-      assertCanonicalModelRef("zai-coding-cn/GLM-5.3-Flash", makeSource(TWIN_SNAPSHOT));
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).toContain('Model "zai-coding-cn/GLM-5.3-Flash" matches a registry entry exactly');
-    expect(msg).toMatch(
-      /registry contains ambiguous case variants for zai-coding-cn\/GLM-5\.3-Flash: \[zai-coding-cn\/GLM-5\.3-Flash, zai-coding-cn\/glm-5\.3-flash\]/,
-    );
-    // 恢复指引：清理重复条目后重试
-    expect(msg).toMatch(/Recovery: remove the duplicate case variant from models\.json/);
-    expect(msg).toMatch(/then retry with the exact registry string\./);
-  });
-
-  it("P-A2 拒单路径：孪生快照下小写全等形态同样拒绝（两个方向都不放行）", () => {
-    expect(() =>
-      assertCanonicalModelRef("zai-coding-cn/glm-5.3-flash", makeSource(TWIN_SNAPSHOT)),
-    ).toThrow(/ambiguous case variants/);
-  });
-
-  it("无孪生快照下同串放行（守卫零误伤）", () => {
-    const ref = assertCanonicalModelRef("zai-coding-cn/GLM-5.3-Flash", makeSource(BASELINE));
-    expect(ref.id).toBe("GLM-5.3-Flash");
-  });
-
-  it("不同 provider 下的同形 id 不构成孪生（provider 精确作用域）", () => {
-    const snapshot = [
-      { provider: "zai-coding-cn", id: "GLM-5.3-Flash" },
-      { provider: "other-cn", id: "glm-5.3-flash" },
-    ];
-    const ref = assertCanonicalModelRef("zai-coding-cn/GLM-5.3-Flash", makeSource(snapshot));
-    expect(ref.id).toBe("GLM-5.3-Flash");
-  });
-});
-
-// ============================================================
-// 继承路径包装（D2 豁免口径）：modelRefFromVerified
-// ============================================================
-
-describe("modelRefFromVerified — ctxModel inheritance path (D2)", () => {
-  it("无孪生 → 包装为 ModelRef（{provider, id} 形态，供 ${provider}/${id} 拼接）", () => {
-    const ref = modelRefFromVerified(
-      { provider: "zai-coding-cn", id: "GLM-5.3-Flash" },
-      makeSource(BASELINE),
-    );
-    expect(ref).toEqual({ provider: "zai-coding-cn", id: "GLM-5.3-Flash" });
-  });
-
-  it("豁免存在性复查：ctxModel 不在 registry 快照中仍放行（运行时已验证）", () => {
-    // registry 为空（快照过期等）不阻塞继承——缺省继承是输入缺省而非变体放行
-    const ref = modelRefFromVerified(
-      { provider: "runtime-only", id: "live-model" },
-      makeSource([]),
-    );
-    expect(ref).toEqual({ provider: "runtime-only", id: "live-model" });
-  });
-
-  it("P-A2 双路径生效：含孪生快照下继承路径同样拒绝（豁免的只是存在性复查，不是孪生守卫）", () => {
-    const TWIN_SNAPSHOT = [
-      { provider: "zai-coding-cn", id: "GLM-5.3-Flash" },
-      { provider: "zai-coding-cn", id: "glm-5.3-flash" },
-    ];
-    expect(() =>
-      modelRefFromVerified({ provider: "zai-coding-cn", id: "GLM-5.3-Flash" }, makeSource(TWIN_SNAPSHOT)),
-    ).toThrow(/ambiguous case variants/);
-  });
-});
-
-// ============================================================
-// stripThinkingSuffix / assertThinkingLevel
-// ============================================================
-
-describe("stripThinkingSuffix", () => {
-  it("剥白名单后缀", () => {
-    expect(stripThinkingSuffix("p/m:high")).toBe("p/m");
-    expect(stripThinkingSuffix("p/m:off")).toBe("p/m");
-    expect(stripThinkingSuffix("p/m")).toBe("p/m");
-  });
-
-  it("非白名单冒号后缀不剥", () => {
-    expect(stripThinkingSuffix("p/m:foo")).toBe("p/m:foo");
-  });
-});
-
-describe("assertThinkingLevel", () => {
-  it("undefined 透传", () => {
-    expect(assertThinkingLevel(undefined)).toBeUndefined();
-  });
-
-  it("白名单值放行并窄化为字面量联合", () => {
-    expect(assertThinkingLevel("high")).toBe("high");
-    expect(assertThinkingLevel("max")).toBe("max");
-  });
-
-  it("非白名单值同步抛错（可操作文案：列出合法值）", () => {
-    expect(() => assertThinkingLevel("ultra")).toThrow(
-      /Invalid thinkingLevel "ultra"\. Allowed values: off, minimal, low, medium, high, xhigh, max\./,
-    );
-  });
-
-  it("THINKING_ORDER SSOT：白名单全集顺序稳定（低→高，含 max）", () => {
-    expect(THINKING_ORDER).toEqual(["off", "minimal", "low", "medium", "high", "xhigh", "max"]);
-  });
-});