docs: 新增 checker-observation 变更提案，归档历史 openspec 变更记录

openspec/changes/checker-observation/specs/udp-checker/spec.md

@@ -0,0 +1,55 @@
+## MODIFIED Requirements
+
+### Requirement: udp checker 执行
+系统 SHALL 使用 Bun connected UDP socket 向目标发送单个 datagram，等待第一个 UDP 响应 datagram，记录完整执行耗时和 UDP observation，并在发送失败、超时、资源超限或底层 socket 错误时产生结构化失败信息。
+
+#### Scenario: UDP 请求响应成功
+- **WHEN** udp target 指向会返回 `PONG` 的 UDP 服务，且未配置 expect 或 `expect.responded` 为 `true`
+- **THEN** 系统 SHALL 记录 `matched=true`、`durationMs` 和包含响应大小的 observation，并关闭 socket
+
+#### Scenario: 使用 hostname 执行 UDP 探测
+- **WHEN** udp target 的 `udp.host` 为可解析域名或 `localhost`
+- **THEN** 系统 SHALL 使用 Bun connected UDP socket 完成发送和接收，不要求配置 IP 地址
+
+#### Scenario: 只处理第一个响应 datagram
+- **WHEN** UDP 服务对一次请求返回多个 datagram
+- **THEN** 系统 SHALL 仅使用第一个收到的 UDP datagram 执行 expect 校验，并关闭 socket
+
+#### Scenario: UDP 无响应且默认期望响应
+- **WHEN** udp target 指向在 timeout 内不返回 UDP datagram 的服务，且未配置 expect 或 `expect.responded` 为 `true`
+- **THEN** 系统 SHALL 在 `ctx.signal` abort 后记录 `matched=false`，observation SHALL 包含 responded=false 和 error，failure 的 kind 为 `error`，phase 为 `response`，message 包含超时或未响应信息
+
+#### Scenario: 期望无响应且实际无响应
+- **WHEN** udp target 配置 `expect.responded: false`，且 timeout 内未收到 UDP datagram
+- **THEN** 系统 SHALL 记录 `matched=true`，observation SHALL 包含 responded=false，API detail SHALL 表示未收到响应
+
+#### Scenario: 期望无响应但实际收到响应
+- **WHEN** udp target 配置 `expect.responded: false`，但收到了 UDP datagram
+- **THEN** 系统 SHALL 记录 `matched=false`，observation SHALL 包含 responded=true 和响应摘要，failure 的 kind 为 `mismatch`，phase 为 `responded`
+
+#### Scenario: UDP socket 底层错误
+- **WHEN** Bun UDP socket 在发送或接收过程中触发 error 事件
+- **THEN** 系统 SHALL best-effort 关闭 socket，并记录 `matched=false`、failure.kind=`error` 和可读错误信息，并在可收集时记录 observation
+
+#### Scenario: ICMP unreachable 不作为 UDP 响应
+- **WHEN** 底层系统因目标端口不可达产生 ICMP unreachable
+- **THEN** 系统 SHALL NOT 将其视为 `responded=true` 的 UDP datagram 响应
+
+#### Scenario: UDP 执行超时关闭 socket
+- **WHEN** 引擎注入的 `ctx.signal` 在 UDP 发送或等待响应过程中 abort
+- **THEN** 系统 SHALL best-effort 关闭 UDP socket，并记录结构化超时或未响应结果
+
+### Requirement: udp detail 摘要
+系统 SHALL 在 udp API 序列化时从 observation 动态生成简短 detail 摘要，展示关键结果并避免返回过长响应内容。
+
+#### Scenario: 收到响应的摘要
+- **WHEN** udp target 收到 4 字节响应且完整执行耗时为 12ms
+- **THEN** detail SHALL 包含 `responded in 12ms` 和 `4 bytes`
+
+#### Scenario: 未收到响应的摘要
+- **WHEN** udp target 配置 `expect.responded: false` 且 timeout 内未收到 UDP datagram
+- **THEN** detail SHALL 包含 `no response` 和执行耗时
+
+#### Scenario: 响应内容摘要截断
+- **WHEN** udp target 收到较长响应内容
+- **THEN** detail SHALL 只展示按 `responseEncoding` 转换并截断后的响应摘要