docs(agent-health): every check leg must appear in every report - a missing line is not a pass #111

Merged
abiba-bot merged 3 commits from fix/agent-health-mandatory-report-legs-20260917 into master 2026-09-17 03:12:58 +00:00
Showing only changes of commit dd6e1e8b22 - Show all commits
+10
View File
@@ -59,6 +59,16 @@ rules: any HTTP status = ALIVE; only 000/timeout/refused = probe-failed.
"Agent health check: OK". If `degraded` or `critical`, report the specific
failures and their severity.
**Mandatory report legs** (2026-09-17 decision, 1295.msg): Every report line
MUST include one clause per check leg, even when a leg is skipped or fails. A
missing leg must never look the same as a healthy leg. Required legs:
- `LiteLLM keys: N/M (names) status`
- `GPU ports: N/M (rtx3090, rtx5070, strixhalo) status` — or `GPU ports: SKIPPED (reason)` / `GPU ports: N/M (rtx3090 up; rtx5070 timeout; strixhalo 200)`
- `CTs: N/M running (names)`
- `Vault secrets: status`
The GPU leg is never skipped by configuration; it is only degraded when an SSH
probe fails, in which case the failure must be named per the probe rules.
### Probe Shape (per standing rules from 1150.msg)
1. **Any HTTP status means ALIVE.** 200, 301, 302, 401, 403, 404 all prove the