import { test, expect, describe } from "bun:test"; import { SERVER_PSM_DISCOVERY_GUIDE } from "@bbbug/shared/server_prompt"; import { testSpecTemplateRules } from "@bbbug/shared/eval_prompt"; import { featureTemplateRules } from "../src/feature_evaluator"; /** * PSM 发现指引接入评估器 —— 钉住的是「不影响纯客户端需求」这条硬约束。 * * 线上绝大多数需求是纯客户端的。服务端能力接进来时用户定的标准是:**不能动它们**。 * 执行期靠的是 `serverBlock([]) === ""` 的紧贴契约,由 50 份 parity 夹具验收; * 但评估期没有同等机制 —— 评估器必须在**还不知道有没有服务端范围之前**就读到 * 这段话,所以字节不可能不变。 * * 于是这里守的是一条更弱但可证的性质:**分层**。 * * 「判定规则」那一段决定「要不要」声明服务端范围; * 发现指引决定「声明之后怎么把 PSM 填对」。 * * 纯客户端需求在判定规则那一步就写「无」,发现指引对它们是死文本。只要判定规则的 * 字节没被动过、指引严格排在三行之后并写明「写无就整段跳过」,它就改变不了任何一个 * 「要不要走服务端」的判断。下面的快照就是在守这条分层 —— 谁把发现能力的话术混进 * 判定规则,或者把指引挪到判定规则前面,这里立刻红。 */ const BUG_RULE = '(**判定规则,不要跳过也不要过度声明**:只有当这个 bug 的根因或修复**必须落在服务端代码**时才声明 PSM。仅仅"调用了某个服务端接口""数据是服务端给的"**不算** —— 客户端消费服务端已有数据是常态,不需要服务端改动。判断不了就用哨兵,让人在确认时决定。)'; const FEATURE_RULE = '(**判定规则,不要跳过也不要过度声明**:只有当这个需求**必须改服务端代码**才声明 PSM。仅仅"要调服务端接口""数据由服务端下发"**不算** —— 客户端消费服务端已有能力是常态。典型需要声明的情况:要新增/修改下发字段、要改接口行为、要新增服务端分群或配置逻辑。判断不了就用哨兵,让人在确认时决定。)'; const bug = testSpecTemplateRules("zh"); const feature = featureTemplateRules("zh"); describe("判定规则的字节没有被动过", () => { test("bug track —— 决定「要不要走服务端」的那段话逐字节不变", () => { expect(bug).toContain(BUG_RULE); }); test("feature track —— 同上", () => { expect(feature).toContain(FEATURE_RULE); }); test("判定规则里不提任何发现手段 —— 混进去就等于让工具影响判断", () => { for (const rule of [BUG_RULE, FEATURE_RULE]) { expect(rule).not.toContain("serverline"); expect(rule).not.toContain("discover"); } }); }); describe("指引严格排在判定之后", () => { test("两条 track 里,指引都出现在判定规则之后", () => { expect(bug.indexOf(SERVER_PSM_DISCOVERY_GUIDE)).toBeGreaterThan(bug.indexOf(BUG_RULE)); expect(feature.indexOf(SERVER_PSM_DISCOVERY_GUIDE)).toBeGreaterThan(feature.indexOf(FEATURE_RULE)); }); test("指引排在三行字段之后 —— 它读的是「上一行」,顺序错了语义就错了", () => { for (const t of [bug, feature]) { const psmLine = t.indexOf("形如 `tiktok.xxx.yyy`"); expect(psmLine).toBeGreaterThan(-1); expect(t.indexOf(SERVER_PSM_DISCOVERY_GUIDE)).toBeGreaterThan(psmLine); } }); test("指引写明了「写无就整段跳过」—— 这是纯客户端需求的出口", () => { expect(SERVER_PSM_DISCOVERY_GUIDE).toContain('上一行写"无"时整段跳过'); }); }); describe("单一来源", () => { test("两条 track 引的是同一个常量,不是各抄一份", () => { // spec 词表就栽在「同一张表建在三处、两处漏改」上,靠 parity 夹具的 11 处 diff // 才发现。这里从一开始就只写一次,并用这条断言钉住。 expect(bug).toContain(SERVER_PSM_DISCOVERY_GUIDE); expect(feature).toContain(SERVER_PSM_DISCOVERY_GUIDE); }); test("指引在每条 track 里只出现一次", () => { for (const t of [bug, feature]) { expect(t.split(SERVER_PSM_DISCOVERY_GUIDE).length - 1).toBe(1); } }); }); describe("不猜的纪律传递到了提示词层", () => { test("ambiguous / not-found 明确要求保留哨兵,而不是挑一个", () => { expect(SERVER_PSM_DISCOVERY_GUIDE).toContain("ambiguous"); expect(SERVER_PSM_DISCOVERY_GUIDE).toContain("not-found"); expect(SERVER_PSM_DISCOVERY_GUIDE).toContain("保留哨兵"); expect(SERVER_PSM_DISCOVERY_GUIDE).toContain("不要猜"); }); test("机器上没有 serverline 也走保留哨兵这条路 —— 不能因缺工具而阻塞或编造", () => { expect(SERVER_PSM_DISCOVERY_GUIDE).toContain("没有 serverline"); }); });