feat: 新增两个 OpenSpec 变更提案 — CMD Checker 增强与前端指标增强

openspec/changes/cmd-checker-enhancement/specs/checker-runner-abstraction/spec.md

@@ -0,0 +1,43 @@
+## MODIFIED Requirements
+
+### Requirement: CheckerRegistry 注册中心
+系统 SHALL 在 `src/server/checker/runner/registry.ts` 中提供 `CheckerRegistry` 类，支持 `register(checker)`、`get(type)` 和 `supportedTypes`。重复注册同一 type SHALL 抛出错误。registry 内部 SHALL 存储 `CheckerDefinition`（使用默认泛型参数），对外提供类型擦除后的接口。
+
+#### Scenario: 查询支持的 type 列表
+- **WHEN** 注册了 "http" 和 "cmd" 两个 checker 后查询 `registry.supportedTypes`
+- **THEN** 返回的数组 SHALL 包含 `["http", "cmd"]`（按注册顺序）
+
+### Requirement: Command checker 提供契约片段
+系统 SHALL 支持 checker 提供自身 TypeBox 配置契约片段，用于描述该 checker 的 defaults 分组、target 领域分组和 expect 分组。
+
+#### Scenario: Cmd checker 提供契约片段
+- **WHEN** Cmd checker 被注册
+- **THEN** registry SHALL 能提供 Cmd defaults、Cmd target 和 Cmd expect 的 TypeBox 契约片段
+
+### Requirement: 配置解析通过 registry 委托 checker
+系统 SHALL 在 `config-loader.ts` 的配置加载流程中通过 `checkerRegistry` 发现已注册 checker，组合公共 TypeBox 契约与 checker 契约，并将 checker 专属语义校验和解析委托给对应 checker。
+
+#### Scenario: 配置解析委托 checker
+- **WHEN** config-loader 解析一个 type 为 "cmd" 的 target
+- **THEN** config-loader SHALL 调用 `checkerRegistry.get("cmd")` 获取对应 checker，并委托该 checker 执行语义校验和 resolve
+
+### Requirement: Command text 断言位于 Cmd 目录
+系统 SHALL 在 checker 专用目录中提供 text 断言函数。
+
+#### Scenario: Command text 断言位于 Cmd 目录
+- **WHEN** Cmd checker 需要对 stdout/stderr 执行文本规则校验
+- **THEN** SHALL 调用 `runner/cmd/text.ts` 中的 `checkTextRules(text, rules, phase)`
+
+### Requirement: Command 专用 expect
+系统 SHALL 在 checker 专用目录中提供 exitCode 断言函数。
+
+#### Scenario: Command 专用 expect
+- **WHEN** Cmd checker 需要校验退出码
+- **THEN** SHALL 调用 `runner/cmd/expect.ts` 中的 `checkExitCode()`
+
+### Requirement: Checker 接口定义
+系统 SHALL 在 `src/server/checker/runner/types.ts` 中定义面向扩展的泛型 `CheckerDefinition<TResolved extends ResolvedTargetBase = ResolvedTargetBase>`，包含 `type`、`configKey`、TypeBox 配置契约、启动期语义校验、`resolve`、`execute`、`serialize` 成员。
+
+#### Scenario: type 与 configKey 默认一致
+- **WHEN** checker 定义 `type: "cmd"`
+- **THEN** checker 的 `configKey` SHALL 默认使用 `"cmd"`，对应 target 的 `cmd` 分组和 defaults.cmd 分组

openspec/changes/cmd-checker-enhancement/specs/command-checker/spec.md

@@ -0,0 +1,33 @@
+## MODIFIED Requirements
+
+### Requirement: command target 配置
+系统 SHALL 支持 `type: cmd` 的 target 配置，通过 `cmd.exec` 和 `cmd.args` 描述本地命令，并使用 cmd 专用字段配置工作目录、环境变量和输出限制。
+
+#### Scenario: 解析 cmd target
+- **WHEN** YAML 中 target 配置 `type: cmd`、`cmd.exec: "pgrep"` 和 `cmd.args: ["nginx"]`
+- **THEN** 系统 SHALL 将其解析为 cmd checker，并保留 exec、args、cwd、env、maxOutputBytes、interval、timeout 和 expect 配置
+
+#### Scenario: cmd target 缺少 exec
+- **WHEN** YAML 中 target 配置 `type: cmd` 但缺少 `cmd.exec`
+- **THEN** 系统 SHALL 以配置错误退出，并提示该 target 缺少 cmd.exec 字段
+
+#### Scenario: cwd 相对配置文件目录解析
+- **WHEN** cmd target 配置 `cmd.cwd: "scripts"` 且配置文件位于 `/opt/checker/probes.yaml`
+- **THEN** 系统 SHALL 将 cwd 解析为 `/opt/checker/scripts`
+
+#### Scenario: cmd 不使用 shell
+- **WHEN** cmd target 配置 `exec` 和 `args`
+- **THEN** 系统 MUST 直接执行该程序和参数，不通过 shell 解释整段命令字符串
+
+#### Scenario: env 默认继承并允许覆盖
+- **WHEN** cmd target 配置 `cmd.env: {LANG: "C"}` 且当前进程环境包含 `PATH`
+- **THEN** 系统 SHALL 继承当前进程的全部环境变量，并将 `LANG` 覆盖为 `"C"`
+
+### Requirement: command checker 执行
+系统 SHALL 按 cmd target 配置执行本地命令，记录执行耗时、退出码、stdout 和 stderr，并在执行失败时产生结构化错误信息。
+
+### Requirement: command expect 校验
+系统 SHALL 支持 cmd 专用 expect，包括 `exitCode`、`stdout` 和 `stderr`，并按 exitCode、duration、stdout、stderr 的阶段顺序快速失败。
+
+### Requirement: command checker 启动期配置校验
+系统 SHALL 在启动期对 cmd checker 的配置契约和语义执行严格校验。Cmd target 的 `cmd` 分组 SHALL 只允许 `exec`、`args`、`cwd`、`env`、`maxOutputBytes` 字段；Cmd expect SHALL 只允许 `exitCode`、`maxDurationMs`、`stdout`、`stderr` 字段。未知字段、非法类型和不可编译正则 MUST 导致启动期配置错误。`expect.exitCode` SHALL 保留原有有限整数数组语义，不限制到特定平台范围。

openspec/changes/cmd-checker-enhancement/specs/probe-config/spec.md

@@ -0,0 +1,25 @@
+## MODIFIED Requirements
+
+### Requirement: YAML 配置文件格式
+target MUST 使用 `type` 字段声明 checker 类型，HTTP 领域字段 MUST 放在 `http` 分组，cmd 领域字段 MUST 放在 `cmd` 分组。
+
+#### Scenario: 最简 command 配置文件解析
+- **WHEN** 系统读取只包含一个 `type: cmd` target 和 `cmd.exec` 的 YAML 配置文件
+- **THEN** 系统 SHALL 使用内置默认值填充未指定的字段（interval=30s, timeout=10s, cmd.cwd 为配置文件所在目录, cmd.maxOutputBytes=100MB）
+
+### Requirement: 配置校验
+
+#### Scenario: command target 缺少 exec
+- **WHEN** YAML 中某个 target 配置 `type: cmd` 但缺少 `cmd.exec`
+- **THEN** 系统 SHALL 以错误退出，提示该 target 缺少 cmd.exec 字段
+
+#### Scenario: 动态 env 字段允许
+- **WHEN** YAML 中 `cmd.env` 包含任意环境变量名称，且对应值为字符串
+- **THEN** 系统 SHALL 接受这些动态 env 名称
+
+### Requirement: expect 配置增强
+系统 SHALL 支持 typed target 的领域专用 expect 配置，包括 HTTP 的 `status`、`headers`、`body` 和 cmd 的 `exitCode`、`stdout`、`stderr`。
+
+#### Scenario: 解析 command expect 配置
+- **WHEN** YAML 配置文件中 cmd target 的 expect 包含 exitCode、stdout 和 stderr 规则数组
+- **THEN** 系统 SHALL 正确解析并存储为 cmd target 的 expect 字段

openspec/changes/cmd-checker-enhancement/specs/windows-test-compat/spec.md

@@ -0,0 +1,41 @@
+## MODIFIED Requirements
+
+### Requirement: 命令检测器测试 SHALL 使用跨平台命令
+命令检测器的测试 SHALL 使用 `bun -e` 脚本替代所有系统命令（包括 `true`、`false`、`sleep`、`bash`、`echo`、`yes | head`），确保测试在 Windows、macOS、Linux 三平台上行为一致。
+
+#### Scenario: 进程退出码 0
+- **WHEN** 测试需要一个正常退出的命令
+- **THEN** 测试 SHALL 使用 `bun -e "process.exit(0)"` 替代 `true`
+
+#### Scenario: 进程退出码非零
+- **WHEN** 测试需要一个失败退出的命令
+- **THEN** 测试 SHALL 使用 `bun -e "process.exit(1)"` 替代 `false`
+
+#### Scenario: stdout 输出
+- **WHEN** 测试需要一个输出文本到 stdout 的命令
+- **THEN** 测试 SHALL 使用 `bun -e "console.log('text')"` 替代 `echo text`
+
+#### Scenario: stderr 输出
+- **WHEN** 测试需要一个输出文本到 stderr 的命令
+- **THEN** 测试 SHALL 使用 `bun -e "process.stderr.write('error\n')"` 替代 `bash -c "echo error >&2"`
+
+#### Scenario: 长时间运行命令
+- **WHEN** 测试需要一个超时场景的长时间运行命令
+- **THEN** 测试 SHALL 使用 `bun -e "await Bun.sleep(10000)"` 替代 `sleep 10`
+
+#### Scenario: 大量输出
+- **WHEN** 测试需要一个产生大量输出的命令
+- **THEN** 测试 SHALL 使用 `bun -e "process.stdout.write('y\n'.repeat(N))"` 替代 `bash -c "yes | head -N"`
+
+#### Scenario: 验证非 shell 模式下特殊字符不被展开
+- **WHEN** 通过 `Bun.spawn` 执行 `bun -e "console.log('*')"` 并检查 stdout 包含 `*`
+- **THEN** 测试 SHALL 在 Windows、macOS 和 Linux 上均返回 `matched: true`
+
+## ADDED Requirements
+
+### Requirement: probes.example.yaml 使用跨平台示例
+probes.example.yaml 中的 cmd 类型示例 SHALL 使用跨平台命令（如 `bun -e "..."`、`bun --version`），不使用 Unix 专属命令（如 `uname`、`ls /tmp`、`date`）。
+
+#### Scenario: 示例命令跨平台可执行
+- **WHEN** 用户在 Windows、macOS 或 Linux 上直接使用 probes.example.yaml 中的 cmd 示例
+- **THEN** 所有 cmd 示例 SHALL 能正常执行，不依赖平台特定命令