health-check

1# Health Check
2 
3Run a comprehensive health check on the Agent Monitor system.
4 
5## Input
6 
7The user provides: **$ARGUMENTS**
8 
9This may be:
10- "full" or empty (default: run all checks)
11- "quick" for a fast connectivity check
12- "deep" for extended checks including database integrity
13 
14## Procedure
15 
16Run health checks in this order:
17 
18### 1. API Health
19```bash
20curl -sf http://localhost:4820/api/health
21```
22- Verify HTTP 200 response
23- Check response time (<500ms expected, <1000ms acceptable)
24- Confirm JSON response body
25 
26### 2. Database Health
27```bash
28curl -sf http://localhost:4820/api/stats
29```
30- Verify stats endpoint returns valid data
31- Check that counts are non-negative integers
32- Verify database file exists and has reasonable size
33 
34### 3. WebSocket Health
35- Check that the WebSocket server is listening
36- Verify WebSocket upgrade is supported on the dashboard port
37 
38### 4. API Endpoint Validation
39Test each major endpoint:
40```bash
41curl -sf http://localhost:4820/api/sessions?limit=1
42curl -sf http://localhost:4820/api/events?limit=1
43curl -sf http://localhost:4820/api/analytics
44curl -sf http://localhost:4820/api/pricing
45curl -sf http://localhost:4820/api/settings/info
46```
47 
48### 5. Hook Integration
49- Verify hook handler script exists
50- Check hooks are configured in `~/.claude/settings.json`
51- Verify the handler script targets the correct dashboard URL
52 
53### 6. Disk & Resource Usage (deep mode only)
54- Database file size
55- Log file sizes (if any)
56- Available disk space
57…