refactor: 移除 success 字段，简化为 matched 单层判定模型

openspec/changes/archive/2026-05-10-abstract-target-expect-checkers/specs/command-checker/spec.md

@@ -0,0 +1,78 @@
+## ADDED Requirements
+
+### Requirement: command target 配置
+系统 SHALL 支持 `type: command` 的 target 配置，通过 `command.exec` 和 `command.args` 描述本地命令，并使用 command 专用字段配置工作目录、环境变量和输出限制。
+
+#### Scenario: 解析 command target
+- **WHEN** YAML 中 target 配置 `type: command`、`command.exec: "pgrep"` 和 `command.args: ["nginx"]`
+- **THEN** 系统 SHALL 将其解析为 command checker，并保留 exec、args、cwd、env、maxOutputBytes、interval、timeout 和 expect 配置
+
+#### Scenario: command target 缺少 exec
+- **WHEN** YAML 中 target 配置 `type: command` 但缺少 `command.exec`
+- **THEN** 系统 SHALL 以配置错误退出，并提示该 target 缺少 command.exec 字段
+
+#### Scenario: cwd 相对配置文件目录解析
+- **WHEN** command target 配置 `command.cwd: "scripts"` 且配置文件位于 `/opt/checker/probes.yaml`
+- **THEN** 系统 SHALL 将 cwd 解析为 `/opt/checker/scripts`
+
+#### Scenario: command 不使用 shell
+- **WHEN** command target 配置 `exec` 和 `args`
+- **THEN** 系统 MUST 直接执行该程序和参数，不通过 shell 解释整段命令字符串
+
+#### Scenario: env 默认继承并允许覆盖
+- **WHEN** command target 配置 `command.env: {LANG: "C"}` 且当前进程环境包含 `PATH`
+- **THEN** 系统 SHALL 继承当前进程的全部环境变量，并将 `LANG` 覆盖为 `"C"`
+
+#### Scenario: 不支持 stdin
+- **WHEN** command target 配置并执行命令
+- **THEN** 系统 MUST NOT 向子进程 stdin 写入数据，避免命令因等待输入而阻塞
+
+### Requirement: command checker 执行
+系统 SHALL 按 command target 配置执行本地命令，记录执行耗时、退出码、stdout 和 stderr，并在执行失败时产生结构化错误信息。
+
+#### Scenario: 命令正常退出
+- **WHEN** command target 执行的进程正常退出且 exit code 为 0
+- **THEN** 系统 SHALL 记录 `success=true`、`durationMs`、`statusDetail="exitCode=0"`，并进入 expect 校验
+
+#### Scenario: 命令非零退出
+- **WHEN** command target 执行的进程正常退出但 exit code 为 1
+- **THEN** 系统 SHALL 记录 `success=true` 和 `statusDetail="exitCode=1"`，并由 expect.exitCode 决定 matched 结果
+
+#### Scenario: 命令启动失败
+- **WHEN** command target 的 exec 不存在或无法启动
+- **THEN** 系统 SHALL 记录 `success=false`、`matched=false`，并在 failure 中写入 kind=`error`、phase=`exitCode` 和可读错误信息
+
+#### Scenario: 命令超时
+- **WHEN** command target 在 timeout 时间内未结束
+- **THEN** 系统 MUST 终止该子进程，记录 `success=false`、`matched=false`，并在 failure 中写入命令超时信息
+
+#### Scenario: 命令输出超限
+- **WHEN** command target 的 stdout 和 stderr 合计输出超过 `maxOutputBytes`
+- **THEN** 系统 MUST 停止收集输出并终止该检查，记录 `success=false`、`matched=false`，并在 failure 中写入输出超限信息
+
+### Requirement: command expect 校验
+系统 SHALL 支持 command 专用 expect，包括 `exitCode`、`stdout` 和 `stderr`，并按 exitCode、duration、stdout、stderr 的阶段顺序快速失败。
+
+#### Scenario: 默认 exitCode 成功语义
+- **WHEN** command target 未显式配置 `expect.exitCode`
+- **THEN** 系统 SHALL 使用默认 `expect.exitCode: [0]` 进行校验
+
+#### Scenario: 显式 exitCode 校验
+- **WHEN** command target 配置 `expect.exitCode: [0, 2]` 且实际 exit code 为 2
+- **THEN** 系统 SHALL 判定 exitCode 阶段通过，并继续后续 expect 阶段
+
+#### Scenario: exitCode 不匹配快速失败
+- **WHEN** command target 配置 `expect.exitCode: [0]` 且实际 exit code 为 1
+- **THEN** 系统 SHALL 立即返回 `matched=false`，并在 failure 中写入 phase=`exitCode`、path=`expect.exitCode`、expected 和 actual
+
+#### Scenario: stdout 按配置顺序校验
+- **WHEN** command target 配置 `expect.stdout` 为两个规则，第一条通过且第二条失败
+- **THEN** 系统 SHALL 先执行第一条 stdout 规则，再执行第二条，并将 failure.path 指向失败的 `expect.stdout[1]`
+
+#### Scenario: stderr 校验为空
+- **WHEN** command target 配置 `expect.stderr: [{empty: true}]` 且实际 stderr 为空字符串
+- **THEN** 系统 SHALL 判定 stderr 阶段通过
+
+#### Scenario: stdout 失败后不检查 stderr
+- **WHEN** command target 同时配置 stdout 和 stderr 规则，且 stdout 规则失败
+- **THEN** 系统 SHALL 快速失败并 MUST NOT 继续执行 stderr 规则