Files
streamline/satellite/test/server_scope_guide.test.ts
2026-11-16 17:26:44 -08:00

94 lines
4.8 KiB
TypeScript

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");
});
});