refactor: checker 模块内聚化 — 每个 checker 自包含于独立目录

将 checker 架构重构为完全内聚模式：每个 checker 目录包含自身的
types、schema、validate、execute、expect 和 index，新增 checker
只需创建一个目录并在 runner/index.ts 添加一行注册。

主要变更：
- runner/shared/ 拆分：断言基础设施迁入 checker/expect/，
  body.ts 迁入 http/，text.ts 迁入 command/
- config-contract/ 重命名为 schema/，schema.ts → builder.ts
- size.ts + parseDuration 合并为 utils.ts
- 顶层 types.ts 改为 base interface + index signature，
  checker 专属类型下沉到各自 types.ts
- runner/index.ts 改为显式数组注册模式
- 更新 DEVELOPMENT.md 项目结构和开发新 Checker 指南

tests/server/app.test.ts

@@ -7,8 +7,8 @@ import type { HealthResponse, HistoryResponse, SummaryResponse, TargetStatus } f
 
 import { createFetchHandler, type StaticAssets } from "../../src/server/app";
 import { checkerRegistry } from "../../src/server/checker/runner";
-import { CommandChecker } from "../../src/server/checker/runner/command/runner";
-import { HttpChecker } from "../../src/server/checker/runner/http/runner";
+import { CommandChecker } from "../../src/server/checker/runner/command/execute";
+import { HttpChecker } from "../../src/server/checker/runner/http/execute";
 import { ProbeStore } from "../../src/server/checker/store";
 import { rmRetry } from "../helpers";
 

tests/server/checker/config-contract/validate.test.ts

@@ -1,10 +1,10 @@
 import Ajv from "ajv";
 import { describe, expect, test } from "bun:test";
 
-import { createProbeConfigJsonSchema } from "../../../../src/server/checker/config-contract/export";
-import { formatConfigIssues, issue } from "../../../../src/server/checker/config-contract/issues";
-import { validateProbeConfigContract } from "../../../../src/server/checker/config-contract/validate";
 import { createDefaultCheckerRegistry } from "../../../../src/server/checker/runner";
+import { createProbeConfigJsonSchema } from "../../../../src/server/checker/schema/export";
+import { formatConfigIssues, issue } from "../../../../src/server/checker/schema/issues";
+import { validateProbeConfigContract } from "../../../../src/server/checker/schema/validate";
 
 describe("config contract", () => {
   test("导出的 probe-config.schema.json 与 fragments 生成结果一致", async () => {

tests/server/checker/config-loader.test.ts

@@ -3,10 +3,13 @@ import { mkdir, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 
+import type { ResolvedCommandTarget } from "../../../src/server/checker/runner/command/types";
+import type { ResolvedHttpTarget } from "../../../src/server/checker/runner/http/types";
+
 import { loadConfig, parseDuration } from "../../../src/server/checker/config-loader";
 import { checkerRegistry } from "../../../src/server/checker/runner";
-import { CommandChecker } from "../../../src/server/checker/runner/command/runner";
-import { HttpChecker } from "../../../src/server/checker/runner/http/runner";
+import { CommandChecker } from "../../../src/server/checker/runner/command/execute";
+import { HttpChecker } from "../../../src/server/checker/runner/http/execute";
 import { readRuntimeConfig } from "../../../src/server/config";
 
 function ensureRegistered() {
@@ -106,19 +109,17 @@ describe("loadConfig", () => {
     expect(config.dataDir).toBe("./data");
     expect(config.maxConcurrentChecks).toBe(20);
     expect(config.targets).toHaveLength(1);
-    const t = config.targets[0]!;
+    const t = config.targets[0]! as ResolvedHttpTarget;
     expect(t.type).toBe("http");
-    if (t.type === "http") {
-      expect(t.name).toBe("test");
-      expect(t.http.url).toBe("http://example.com");
-      expect(t.http.method).toBe("GET");
-      expect(t.http.headers).toEqual({});
-      expect(t.http.ignoreSSL).toBe(false);
-      expect(t.http.maxBodyBytes).toBe(104857600);
-      expect(t.http.maxRedirects).toBe(0);
-      expect(t.intervalMs).toBe(30000);
-      expect(t.timeoutMs).toBe(10000);
-    }
+    expect(t.name).toBe("test");
+    expect(t.http.url).toBe("http://example.com");
+    expect(t.http.method).toBe("GET");
+    expect(t.http.headers).toEqual({});
+    expect(t.http.ignoreSSL).toBe(false);
+    expect(t.http.maxBodyBytes).toBe(104857600);
+    expect(t.http.maxRedirects).toBe(0);
+    expect(t.intervalMs).toBe(30000);
+    expect(t.timeoutMs).toBe(10000);
   });
 
   test("解析最简 command 配置", async () => {
@@ -138,16 +139,14 @@ describe("loadConfig", () => {
 
     const config = await loadConfig(configPath);
     expect(config.targets).toHaveLength(1);
-    const t = config.targets[0]!;
+    const t = config.targets[0]! as ResolvedCommandTarget;
     expect(t.type).toBe("command");
-    if (t.type === "command") {
-      expect(t.name).toBe("check-nginx");
-      expect(t.command.exec).toBe("pgrep");
-      expect(t.command.args).toEqual(["nginx"]);
-      expect(t.command.cwd).toBe(subdir);
-      expect(t.command.maxOutputBytes).toBe(104857600);
-      expect(t.command.env["PATH"]).toBeDefined();
-    }
+    expect(t.name).toBe("check-nginx");
+    expect(t.command.exec).toBe("pgrep");
+    expect(t.command.args).toEqual(["nginx"]);
+    expect(t.command.cwd).toBe(subdir);
+    expect(t.command.maxOutputBytes).toBe(104857600);
+    expect(t.command.env["PATH"]).toBeDefined();
   });
 
   test("解析完整配置", async () => {
@@ -200,27 +199,23 @@ targets:
     expect(config.maxConcurrentChecks).toBe(5);
     expect(config.targets).toHaveLength(2);
 
-    const http = config.targets[0]!;
+    const http = config.targets[0]! as ResolvedHttpTarget;
     expect(http.type).toBe("http");
-    if (http.type === "http") {
-      expect(http.http.url).toBe("http://example.com");
-      expect(http.http.method).toBe("POST");
-      expect(http.http.headers).toEqual({ Authorization: "Bearer token" });
-      expect(http.http.ignoreSSL).toBe(true);
-      expect(http.http.maxBodyBytes).toBe(52428800);
-      expect(http.http.maxRedirects).toBe(5);
-      expect(http.expect?.status).toEqual(["2xx", 301]);
-      expect(http.intervalMs).toBe(60000);
-      expect(http.timeoutMs).toBe(5000);
-    }
+    expect(http.http.url).toBe("http://example.com");
+    expect(http.http.method).toBe("POST");
+    expect(http.http.headers).toEqual({ Authorization: "Bearer token" });
+    expect(http.http.ignoreSSL).toBe(true);
+    expect(http.http.maxBodyBytes).toBe(52428800);
+    expect(http.http.maxRedirects).toBe(5);
+    expect(http.expect?.status).toEqual(["2xx", 301]);
+    expect(http.intervalMs).toBe(60000);
+    expect(http.timeoutMs).toBe(5000);
 
-    const cmd = config.targets[1]!;
+    const cmd = config.targets[1]! as ResolvedCommandTarget;
     expect(cmd.type).toBe("command");
-    if (cmd.type === "command") {
-      expect(cmd.command.exec).toBe("ls");
-      expect(cmd.command.args).toEqual(["/tmp"]);
-      expect(cmd.command.maxOutputBytes).toBe(10485760);
-    }
+    expect(cmd.command.exec).toBe("ls");
+    expect(cmd.command.args).toEqual(["/tmp"]);
+    expect(cmd.command.maxOutputBytes).toBe(10485760);
   });
 
   test("per-target 覆盖 defaults", async () => {
@@ -246,13 +241,11 @@ targets:
     );
 
     const config = await loadConfig(configPath);
-    const t = config.targets[0]!;
-    if (t.type === "http") {
-      expect(t.http.method).toBe("POST");
-      expect(t.intervalMs).toBe(300000);
-      expect(t.timeoutMs).toBe(30000);
-      expect(t.http.maxBodyBytes).toBe(1048576);
-    }
+    const t = config.targets[0]! as ResolvedHttpTarget;
+    expect(t.http.method).toBe("POST");
+    expect(t.intervalMs).toBe(300000);
+    expect(t.timeoutMs).toBe(30000);
+    expect(t.http.maxBodyBytes).toBe(1048576);
   });
 
   test("配置文件不存在抛出错误", async () => {
@@ -564,10 +557,8 @@ targets:
     );
 
     const config = await loadConfig(configPath);
-    const t = config.targets[0]!;
-    if (t.type === "command") {
-      expect(t.command.cwd).toBe(join(subdir, "scripts"));
-    }
+    const t = config.targets[0] as ResolvedCommandTarget;
+    expect(t.command.cwd).toBe(join(subdir, "scripts"));
   });
 
   test("command env 覆盖", async () => {
@@ -586,12 +577,10 @@ targets:
     );
 
     const config = await loadConfig(configPath);
-    const t = config.targets[0]!;
-    if (t.type === "command") {
-      expect(t.command.env["LANG"]).toBe("C");
-      expect(t.command.env["CUSTOM_VAR"]).toBe("test");
-      expect(t.command.env["PATH"]).toBeDefined();
-    }
+    const t = config.targets[0] as ResolvedCommandTarget;
+    expect(t.command.env["LANG"]).toBe("C");
+    expect(t.command.env["CUSTOM_VAR"]).toBe("test");
+    expect(t.command.env["PATH"]).toBeDefined();
   });
 
   test("解析 group 字段", async () => {
@@ -1049,9 +1038,9 @@ targets:
 `,
     );
     const config = await loadConfig(configPath);
-    const target = config.targets[0]!;
+    const target = config.targets[0] as ResolvedHttpTarget;
     expect(target.type).toBe("http");
-    if (target.type === "http") expect(target.http.method).toBe("POST");
+    expect(target.http.method).toBe("POST");
   });
 
   test("动态 headers 和 env 允许任意键名", async () => {
@@ -1082,15 +1071,13 @@ targets:
 `,
     );
     const config = await loadConfig(configPath);
-    const http = config.targets[0]!;
-    const command = config.targets[1]!;
+    const http = config.targets[0] as ResolvedHttpTarget;
+    const command = config.targets[1] as ResolvedCommandTarget;
     expect(http.type).toBe("http");
     expect(command.type).toBe("command");
-    if (http.type === "http") {
-      expect(http.http.headers["X-Default-Header"]).toBe("default");
-      expect(http.http.headers["X-Custom-Header"]).toBe("custom");
-    }
-    if (command.type === "command") expect(command.command.env["CUSTOM_ENV_NAME"]).toBe("custom");
+    expect(http.http.headers["X-Default-Header"]).toBe("default");
+    expect(http.http.headers["X-Custom-Header"]).toBe("custom");
+    expect(command.command.env["CUSTOM_ENV_NAME"]).toBe("custom");
   });
 
   test("command args 类型非法", async () => {

tests/server/checker/engine.test.ts

@@ -1,12 +1,14 @@
 import { describe, expect, test } from "bun:test";
 
+import type { ResolvedCommandTarget } from "../../../src/server/checker/runner/command/types";
+import type { ResolvedHttpTarget } from "../../../src/server/checker/runner/http/types";
 import type { ProbeStore } from "../../../src/server/checker/store";
-import type { ResolvedCommandTarget, ResolvedHttpTarget, ResolvedTarget } from "../../../src/server/checker/types";
+import type { ResolvedTargetBase } from "../../../src/server/checker/types";
 
 import { ProbeEngine } from "../../../src/server/checker/engine";
 import { checkerRegistry } from "../../../src/server/checker/runner";
-import { CommandChecker } from "../../../src/server/checker/runner/command/runner";
-import { HttpChecker } from "../../../src/server/checker/runner/http/runner";
+import { CommandChecker } from "../../../src/server/checker/runner/command/execute";
+import { HttpChecker } from "../../../src/server/checker/runner/http/execute";
 
 function createMockStore(targetNames: string[]) {
   let nextId = 1;
@@ -63,7 +65,7 @@ describe("ProbeEngine", () => {
   test("start/stop 不抛错", () => {
     ensureRegistered();
     const mockStore = createMockStore(["test"]) as unknown as ProbeStore;
-    const targets: ResolvedTarget[] = [makeCommandTarget("test")];
+    const targets: ResolvedTargetBase[] = [makeCommandTarget("test")];
     const engine = new ProbeEngine(mockStore, targets);
     engine.start();
     engine.stop();
@@ -75,9 +77,9 @@ describe("ProbeEngine", () => {
     const mockStore = createMockStore(["cmd-echo"]) as unknown as ProbeStore;
     const engine = new ProbeEngine(mockStore, [target]);
 
-    const probeGroup = (engine as unknown as { probeGroup: (t: ResolvedTarget[]) => Promise<void> }).probeGroup.bind(
-      engine,
-    );
+    const probeGroup = (
+      engine as unknown as { probeGroup: (t: ResolvedTargetBase[]) => Promise<void> }
+    ).probeGroup.bind(engine);
     await probeGroup([target]);
 
     const results = (mockStore as unknown as { _results: Array<Record<string, unknown>> })._results;
@@ -97,9 +99,9 @@ describe("ProbeEngine", () => {
     const mockStore = createMockStore(["echo-a", "echo-b"]) as unknown as ProbeStore;
     const engine = new ProbeEngine(mockStore, [targetA, targetB]);
 
-    const probeGroup = (engine as unknown as { probeGroup: (t: ResolvedTarget[]) => Promise<void> }).probeGroup.bind(
-      engine,
-    );
+    const probeGroup = (
+      engine as unknown as { probeGroup: (t: ResolvedTargetBase[]) => Promise<void> }
+    ).probeGroup.bind(engine);
     await probeGroup([targetA, targetB]);
 
     const results = (mockStore as unknown as { _results: Array<Record<string, unknown>> })._results;
@@ -115,9 +117,9 @@ describe("ProbeEngine", () => {
     const mockStore = createMockStore(["bad-cmd", "good-cmd"]) as unknown as ProbeStore;
     const engine = new ProbeEngine(mockStore, [badTarget, goodTarget]);
 
-    const probeGroup = (engine as unknown as { probeGroup: (t: ResolvedTarget[]) => Promise<void> }).probeGroup.bind(
-      engine,
-    );
+    const probeGroup = (
+      engine as unknown as { probeGroup: (t: ResolvedTargetBase[]) => Promise<void> }
+    ).probeGroup.bind(engine);
     await probeGroup([badTarget, goodTarget]);
 
     const results = (mockStore as unknown as { _results: Array<Record<string, unknown>> })._results;
@@ -139,9 +141,9 @@ describe("ProbeEngine", () => {
     const mockStore = createMockStore(targets.map((t) => t.name)) as unknown as ProbeStore;
     const engine = new ProbeEngine(mockStore, targets, 2);
 
-    const probeGroup = (engine as unknown as { probeGroup: (t: ResolvedTarget[]) => Promise<void> }).probeGroup.bind(
-      engine,
-    );
+    const probeGroup = (
+      engine as unknown as { probeGroup: (t: ResolvedTargetBase[]) => Promise<void> }
+    ).probeGroup.bind(engine);
     await probeGroup(targets);
 
     const results = (mockStore as unknown as { _results: Array<Record<string, unknown>> })._results;
@@ -168,9 +170,9 @@ describe("ProbeEngine", () => {
     const mockStore = createMockStore(["other-name"]) as unknown as ProbeStore;
     const engine = new ProbeEngine(mockStore, [target]);
 
-    const probeGroup = (engine as unknown as { probeGroup: (t: ResolvedTarget[]) => Promise<void> }).probeGroup.bind(
-      engine,
-    );
+    const probeGroup = (
+      engine as unknown as { probeGroup: (t: ResolvedTargetBase[]) => Promise<void> }
+    ).probeGroup.bind(engine);
     await probeGroup([target]);
 
     const results = (mockStore as unknown as { _results: Array<Record<string, unknown>> })._results;
@@ -205,9 +207,9 @@ describe("ProbeEngine", () => {
       const mockStore = createMockStore(["http-test"]) as unknown as ProbeStore;
       const engine = new ProbeEngine(mockStore, [httpTarget]);
 
-      const probeGroup = (engine as unknown as { probeGroup: (t: ResolvedTarget[]) => Promise<void> }).probeGroup.bind(
-        engine,
-      );
+      const probeGroup = (
+        engine as unknown as { probeGroup: (t: ResolvedTargetBase[]) => Promise<void> }
+      ).probeGroup.bind(engine);
       await probeGroup([httpTarget]);
 
       const results = (mockStore as unknown as { _results: Array<Record<string, unknown>> })._results;

tests/server/checker/runner/command/runner.test.ts

@@ -1,9 +1,9 @@
 import { describe, expect, test } from "bun:test";
 
+import type { ResolvedCommandTarget } from "../../../../../src/server/checker/runner/command/types";
 import type { CheckerContext } from "../../../../../src/server/checker/runner/types";
-import type { ResolvedCommandTarget } from "../../../../../src/server/checker/types";
 
-import { CommandChecker } from "../../../../../src/server/checker/runner/command/runner";
+import { CommandChecker } from "../../../../../src/server/checker/runner/command/execute";
 
 const checker = new CommandChecker();
 

tests/server/checker/runner/http/runner.test.ts

@@ -1,11 +1,11 @@
 import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 
+import type { ResolvedHttpTarget } from "../../../../../src/server/checker/runner/http/types";
 import type { CheckerContext, ResolveContext } from "../../../../../src/server/checker/runner/types";
-import type { ResolvedHttpTarget } from "../../../../../src/server/checker/types";
 
-import { formatConfigIssues } from "../../../../../src/server/checker/config-contract/issues";
+import { HttpChecker } from "../../../../../src/server/checker/runner/http/execute";
 import { checkStatus } from "../../../../../src/server/checker/runner/http/expect";
-import { HttpChecker } from "../../../../../src/server/checker/runner/http/runner";
+import { formatConfigIssues } from "../../../../../src/server/checker/schema/issues";
 
 const checker = new HttpChecker();
 

tests/server/checker/runner/registry.test.ts

@@ -2,7 +2,7 @@ import { Type } from "@sinclair/typebox";
 import { describe, expect, test } from "bun:test";
 
 import type { Checker } from "../../../../src/server/checker/runner/types";
-import type { CheckResult, ResolvedTarget } from "../../../../src/server/checker/types";
+import type { CheckResult, ResolvedTargetBase } from "../../../../src/server/checker/types";
 
 import { createDefaultCheckerRegistry } from "../../../../src/server/checker/runner";
 import { CheckerRegistry } from "../../../../src/server/checker/runner/registry";
@@ -11,7 +11,7 @@ function createChecker(type: string): Checker {
   return {
     configKey: type,
     execute: () => Promise.resolve<CheckResult>({} as unknown as CheckResult),
-    resolve: () => ({}) as unknown as ResolvedTarget,
+    resolve: () => ({}) as unknown as ResolvedTargetBase,
     schemas: {
       config: Type.Object({}, { additionalProperties: false }),
       defaults: Type.Object({}, { additionalProperties: false }),

tests/server/checker/runner/shared/body.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
 
-import { checkBodyExpect } from "../../../../../src/server/checker/runner/shared/body";
+import { checkBodyExpect } from "../../../../../src/server/checker/runner/http/body";
 
 describe("checkBodyExpect (BodyRule[])", () => {
   test("无规则返回匹配成功", () => {

tests/server/checker/runner/shared/duration.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
 
-import { checkDuration } from "../../../../../src/server/checker/runner/shared/duration";
+import { checkDuration } from "../../../../../src/server/checker/expect/duration";
 
 describe("checkDuration", () => {
   test("未配置 maxDurationMs 返回匹配成功", () => {

tests/server/checker/runner/shared/failure.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
 
-import { errorFailure, mismatchFailure, truncateActual } from "../../../../../src/server/checker/runner/shared/failure";
+import { errorFailure, mismatchFailure, truncateActual } from "../../../../../src/server/checker/expect/failure";
 
 describe("truncateActual", () => {
   test("短字符串不截断", () => {

tests/server/checker/runner/shared/operator.test.ts

@@ -1,10 +1,6 @@
 import { describe, expect, test } from "bun:test";
 
-import {
-  applyOperator,
-  checkExpectValue,
-  evaluateJsonPath,
-} from "../../../../../src/server/checker/runner/shared/operator";
+import { applyOperator, checkExpectValue, evaluateJsonPath } from "../../../../../src/server/checker/expect/operator";
 
 describe("evaluateJsonPath", () => {
   const obj = {

tests/server/checker/runner/shared/text.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
 
-import { checkTextRules } from "../../../../../src/server/checker/runner/shared/text";
+import { checkTextRules } from "../../../../../src/server/checker/runner/command/text";
 
 describe("checkTextRules", () => {
   test("无规则返回匹配成功", () => {

tests/server/checker/size.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
 
-import { parseSize } from "../../../src/server/checker/size";
+import { parseSize } from "../../../src/server/checker/utils";
 
 describe("parseSize", () => {
   test("解析 B", () => {

tests/server/checker/store.test.ts

@@ -3,11 +3,13 @@ import { mkdir } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 
-import type { CheckFailure, ResolvedTarget } from "../../../src/server/checker/types";
+import type { ResolvedCommandTarget } from "../../../src/server/checker/runner/command/types";
+import type { ResolvedHttpTarget } from "../../../src/server/checker/runner/http/types";
+import type { CheckFailure } from "../../../src/server/checker/types";
 
 import { checkerRegistry } from "../../../src/server/checker/runner";
-import { CommandChecker } from "../../../src/server/checker/runner/command/runner";
-import { HttpChecker } from "../../../src/server/checker/runner/http/runner";
+import { CommandChecker } from "../../../src/server/checker/runner/command/execute";
+import { HttpChecker } from "../../../src/server/checker/runner/http/execute";
 import { ProbeStore } from "../../../src/server/checker/store";
 import { rmRetry } from "../../helpers";
 
@@ -22,7 +24,7 @@ beforeAll(() => {
   ensureRegistered();
 });
 
-const httpTarget: ResolvedTarget = {
+const httpTarget: ResolvedHttpTarget = {
   expect: { maxDurationMs: 3000, status: [200] },
   group: "default",
   http: {
@@ -39,7 +41,7 @@ const httpTarget: ResolvedTarget = {
   type: "http",
 };
 
-const commandTarget: ResolvedTarget = {
+const commandTarget: ResolvedCommandTarget = {
   command: {
     args: ["-c", "1", "localhost"],
     cwd: "/tmp",
@@ -119,7 +121,7 @@ describe("ProbeStore", () => {
   });
 
   test("同步更新已有 target", () => {
-    const updated: ResolvedTarget = {
+    const updated: ResolvedHttpTarget = {
       ...httpTarget,
       http: { ...httpTarget.http, url: "https://example.com/v2" },
     };
@@ -287,7 +289,7 @@ describe("ProbeStore", () => {
 
   test("删除 target 级联删除 check_results", () => {
     const cascadeStore = new ProbeStore(join(tempDir, "cascade.db"));
-    const cascadeTarget: ResolvedTarget = {
+    const cascadeTarget: ResolvedHttpTarget = {
       group: "default",
       http: {
         headers: {},