lanyuanxiaoyao/DiAL
1
0
Fork 0
Code Activity

feat: 重构配置生命周期为 Authoring/Normalized/Resolved 三层

Browse Source 
将变量替换和 expect 简写展开统一放入 Normalized 阶段，
运行时 AJV 使用 Normalized schema，导出 schema 面向 Authoring Config。

主要变更：
- 新增 normalizer.ts 实现 normalizeAuthoringConfig()
- 拆分 Authoring/Normalized 双 schema，checker 接口支持 authoring/normalized 片段
- config-loader 流程：normalize → Normalized AJV → semantic → resolve
- validator 兼容层自动分派 raw/normalized expect 形态
- 删除 rawExpect，store.expect 列写入 null
- Authoring schema 对 integer/boolean/enum 字段接受变量引用
- 修复 DB/HTTP validate 入口守卫和 LLM options integer 变量引用
- 优化 compact() 避免 undefined 覆盖隐患
- 移除 content.ts 恒为 true 的前置条件
- 同步 5 个主规范并归档 change
This commit is contained in:
兰缘小妖
2026-05-22 14:00:47 +08:00
parent 6e53c8130d
commit cf847ccd7a
56 changed files with 1717 additions and 656 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
tests/server/checker/runner/cmd/runner.test.ts
View File

@@ -183,7 +183,7 @@ describe("CommandChecker", () => {
test("resolve 未配置 expect 时物化默认 exitCode", () => {
const result = checker.resolve({ cmd: { exec: "true" }, id: "test", type: "cmd" }, makeResolveContext());
expect(result.rawExpect).toBeUndefined();
expect("rawExpect" in result).toBe(false);
expect(result.expect).toEqual({ exitCode: [0] });
});
});

2
tests/server/checker/runner/http/runner.test.ts
View File

@@ -975,7 +975,7 @@ describe("HttpChecker.resolve", () => {
makeResolveContext(),
);
expect(result.rawExpect).toBeUndefined();
expect("rawExpect" in result).toBe(false);
expect(result.expect).toEqual({ status: [200] });
});

2
tests/server/checker/runner/icmp/execute.test.ts
View File

@@ -128,7 +128,7 @@ describe("IcmpChecker resolve", () => {
);
expect(target.icmp).toEqual({ count: 3, host: "10.0.0.1", packetSize: 56 });
expect(target.group).toBe("default");
expect(target.rawExpect).toBeUndefined();
expect("rawExpect" in target).toBe(false);
expect(target.expect).toEqual({ alive: true });
});

6
tests/server/checker/runner/llm/registry.test.ts
View File

@@ -16,8 +16,10 @@ describe("LLM registry integration", () => {
test("llm checker schemas 有效", () => {
const checker = checkerRegistry.get("llm");
expect(checker.schemas.config).toBeDefined();
expect(checker.schemas.expect).toBeDefined();
expect(checker.schemas.authoring.config).toBeDefined();
expect(checker.schemas.authoring.expect).toBeDefined();
expect(checker.schemas.normalized.config).toBeDefined();
expect(checker.schemas.normalized.expect).toBeDefined();
});
test("llm checker validate 方法可用", () => {

16
tests/server/checker/runner/llm/schema-validate-resolve.test.ts
View File

@@ -60,9 +60,11 @@ describe("LlmChecker schema", () => {
expect(checker?.configKey).toBe("llm");
});
test("schemas 包含 config、expect", () => {
test("schemas 包含 authoring 和 normalized config/expect", () => {
expect(checker).toBeDefined();
expect(Object.keys(checker!.schemas).sort()).toEqual(["config", "expect"].sort());
expect(Object.keys(checker!.schemas).sort()).toEqual(["authoring", "normalized"].sort());
expect(checker!.schemas.authoring.config).toBeDefined();
expect(checker!.schemas.normalized.expect).toBeDefined();
});
});
@@ -249,13 +251,13 @@ describe("LlmChecker resolve", () => {
expect(resolved.group).toBe("default");
expect(resolved.intervalMs).toBe(30000);
expect(resolved.timeoutMs).toBe(10000);
expect(resolved.rawExpect).toBeUndefined();
expect("rawExpect" in resolved).toBe(false);
expect(resolved.expect).toEqual({ status: [200] });
});
test("stream mode 未配置 expect.stream 时不物化 completed", () => {
const raw = makeRawTarget({
expect: { output: [{ contains: "OK" }] },
expect: { output: [{ kind: "value", matcher: { contains: "OK" } }] },
llm: {
mode: "stream",
model: "gpt-4o-mini",
@@ -267,13 +269,13 @@ describe("LlmChecker resolve", () => {
const resolved = asLlm(checker.resolve(raw, makeResolveContext()));
expect(resolved.rawExpect).toEqual({ output: [{ contains: "OK" }] });
expect("rawExpect" in resolved).toBe(false);
expect(resolved.expect?.stream).toBeUndefined();
});
test("配置 expect.stream 但省略 completed 时默认 true", () => {
const raw = makeRawTarget({
expect: { stream: { firstTokenMs: 100 } },
expect: { stream: { firstTokenMs: { equals: 100 } } },
llm: {
mode: "stream",
model: "gpt-4o-mini",
@@ -285,7 +287,7 @@ describe("LlmChecker resolve", () => {
const resolved = asLlm(checker.resolve(raw, makeResolveContext()));
expect(resolved.rawExpect).toEqual({ stream: { firstTokenMs: 100 } });
expect("rawExpect" in resolved).toBe(false);
expect(resolved.expect?.stream).toEqual({ completed: true, firstTokenMs: { equals: 100 } });
});

14
tests/server/checker/runner/registry.test.ts
View File

@@ -14,8 +14,14 @@ function createChecker(type: string): Checker {
execute: () => Promise.resolve<CheckResult>({} as unknown as CheckResult),
resolve: () => ({}) as unknown as ResolvedTargetBase,
schemas: {
config: Type.Object({}, { additionalProperties: false }),
expect: Type.Object({}, { additionalProperties: false }),
authoring: {
config: Type.Object({}, { additionalProperties: false }),
expect: Type.Object({}, { additionalProperties: false }),
},
normalized: {
config: Type.Object({}, { additionalProperties: false }),
expect: Type.Object({}, { additionalProperties: false }),
},
},
serialize: () => ({ config: "", target: "" }),
type,
@@ -68,7 +74,9 @@ describe("CheckerRegistry", () => {
expect(first.supportedTypes).toEqual(["http", "cmd", "db", "tcp", "icmp", "udp", "llm", "custom"]);
expect(second.supportedTypes).toEqual(["http", "cmd", "db", "tcp", "icmp", "udp", "llm"]);
expect(first.definitions.every((checker) => checker.schemas.config && checker.schemas.expect)).toBe(true);
expect(
first.definitions.every((checker) => checker.schemas.authoring.config && checker.schemas.normalized.expect),
).toBe(true);
});
test("默认 registry 注册 icmp type", () => {

43
tests/server/checker/runner/shared/duplicate-header-key.test.ts
View File

@@ -1,7 +1,9 @@
import { describe, expect, test } from "bun:test";
import type { CheckerValidationInput } from "../../../../../src/server/checker/runner/types";
import type { RawTargetConfig } from "../../../../../src/server/checker/types";
import { normalizeAuthoringConfig } from "../../../../../src/server/checker/normalizer";
import { validateDbConfig } from "../../../../../src/server/checker/runner/db/validate";
import { validateHttpConfig } from "../../../../../src/server/checker/runner/http/validate";
import { validateLlmConfig } from "../../../../../src/server/checker/runner/llm/validate";
@@ -52,14 +54,45 @@ describe("HTTP/LLM headers reject case-insensitive duplicate keys", () => {
expect(validateHttpConfig(input(target)).some((i) => i.code === "duplicate-key")).toBe(false);
});
test("DB rows 保留大小写敏感不触发 duplicate-key", () => {
const target = {
test("HTTP normalized headers 大小写不同的重复 key 报错", () => {
const authoring = {
expect: { headers: { "Content-Type": "application/json", "content-type": "text/plain" } },
http: { url: "https://example.com" },
id: "dup",
type: "http",
};
const result = normalizeAuthoringConfig({ targets: [authoring] });
const normalized = result.config as { targets: RawTargetConfig[] };
const issues = validateHttpConfig({ targets: normalized.targets });
expect(issues.some((i) => i.code === "duplicate-key" && i.path.includes("headers"))).toBe(true);
});
test("HTTP normalized headers unsafe regex 报错", () => {
const authoring = {
expect: { headers: { "x-test": { regex: "(\\d+)*x" } } },
http: { url: "https://example.com" },
id: "unsafe",
type: "http",
};
const result = normalizeAuthoringConfig({ targets: [authoring] });
const normalized = result.config as { targets: RawTargetConfig[] };
const issues = validateHttpConfig({ targets: normalized.targets });
expect(issues.some((i) => i.code === "unsafe-regex" && i.path.includes("headers"))).toBe(true);
});
test("DB normalized rows 通过校验", () => {
const authoring = {
db: { query: "SELECT 1", url: "sqlite://:memory:" },
expect: { rows: [{ Name: "a", name: "b" }] },
id: "dup-rows",
expect: { rows: [{ Name: "Alice" }] },
id: "db-rows",
type: "db",
};
expect(validateDbConfig(input(target)).some((i) => i.code === "duplicate-key")).toBe(false);
const result = normalizeAuthoringConfig({ targets: [authoring] });
const normalized = result.config as { targets: RawTargetConfig[] };
const issues = validateDbConfig({ targets: normalized.targets });
expect(issues).toHaveLength(0);
});
});

10
tests/server/checker/runner/tcp/execute.test.ts
View File

@@ -314,7 +314,7 @@ describe("TcpChecker resolve", () => {
expect(target.name).toBeNull();
expect(target.intervalMs).toBe(30000);
expect(target.timeoutMs).toBe(10000);
expect(target.rawExpect).toBeUndefined();
expect("rawExpect" in target).toBe(false);
expect(target.expect).toEqual({ connected: true });
});
@@ -343,7 +343,11 @@ describe("TcpChecker resolve", () => {
test("expect 配置解析", () => {
const target = checker.resolve(
{
expect: { banner: [{ contains: "ESMTP" }], connected: false, durationMs: { lte: 5000 } },
expect: {
banner: [{ kind: "value", matcher: { contains: "ESMTP" } }],
connected: false,
durationMs: { lte: 5000 },
},
id: "t",
tcp: { host: "127.0.0.1", port: 80, readBanner: true },
type: "tcp",
@@ -355,7 +359,7 @@ describe("TcpChecker resolve", () => {
connected: false,
durationMs: { lte: 5000 },
});
expect(target.rawExpect).toEqual({ banner: [{ contains: "ESMTP" }], connected: false, durationMs: { lte: 5000 } });
expect("rawExpect" in target).toBe(false);
});
test("name 和 group 解析", () => {

2
tests/server/checker/runner/udp/execute.test.ts
View File

@@ -340,7 +340,7 @@ describe("UdpChecker resolve", () => {
expect(target.udp.encoding).toBe("text");
expect(target.udp.responseEncoding).toBe("text");
expect(target.udp.maxResponseBytes).toBe(4096);
expect(target.rawExpect).toBeUndefined();
expect("rawExpect" in target).toBe(false);
expect(target.expect).toEqual({ responded: true });
});