SyslogSolution/prose-contracts
7
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

docs(contracts): add the missing agent-health-check contract #107

Merged
abiba-bot merged 2 commits from fix/agent-health-check-contract-20260916 into master 2026-09-16 05:03:27 +00:00
Conversation 0 Commits 2 Files Changed 1
+14 -8
1 changed files with 14 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 5c1c8d7c19 - Show all commits
agent-health-check.prose.md
+14 -8
View File
@@ -3,11 +3,11 @@ kind: responsibility
name: agent-health-check
description: >
Consolidated agent health verification for the LiteLLM + GPU + Zulip +
gateway fleet. Wraps scripts/agent-health-check.py (v4). Runs every
10 minutes via cron and on-demand via "run contract: agent-health-check".
Verifies: LiteLLM key validity, GPU port conflicts, agent Zulip streaming,
gateway liveness, CT liveness, config YAML integrity, wrapper/CLI integrity,
vault secret non-emptiness. NEVER restarts anything.
gateway fleet. Wraps scripts/agent-health-check.py (v4). Runs every 4 hours
via cron and on-demand via "run contract: agent-health-check". Verifies:
LiteLLM key validity, GPU port conflicts, agent Zulip streaming, gateway
liveness, CT liveness, gateway log health, config YAML integrity,
wrapper/CLI integrity, vault secret non-emptiness. NEVER restarts anything.
title: Agent Health Check — Consolidated
version: 1.0.0
runtime_contract: 2
@@ -17,8 +17,9 @@ agent: abiba
# Agent Health Check
Consolidated health verification for the LiteLLM + GPU + Zulip + gateway fleet.
Runs every 10 minutes via cron (`*/10 * * * *`) and on-demand. Never restarts
anything — detects and reports only.
Runs every 4 hours (2, 6, 10, 14, 18, 22 UTC at :35) via cron (`35 2,6,10,14,18,22 * * *`) and on-demand. Never restarts anything — detects and reports only.
**Cadence rationale** (2026-08-28 decision): monitoring dispatches moved from hourly to every 4 hours to reduce probe load on GPU hosts while keeping detection latency acceptable (up to 4 hours).
## Requires
@@ -91,8 +92,13 @@ Report the specific CT. Do not restart — that's a destructive action.
### When config YAML is invalid
Report the specific file + parse error. Do not fix — that's a config change.
### When gateway log health is degraded
Report the specific gateway + log health status (error patterns, stale connections, connectivity issues). Do not restart — that's a destructive action.
Note: the script may perform additional diagnostics beyond the seven contract checks listed under Execution.
## Continuity
- **Every 10 minutes**: Scheduled cron check while Abiba is running
- **Every 4 hours** (2, 6, 10, 14, 18, 22 UTC at :35): Scheduled cron check while Abiba is running
- **On `agent-health` command**: Run on-demand and report to user
- **On critical alert**: Escalate to relay message immediately