๐About
Shield is a droid that monitors Carolโs health. It helps Guardian spot problems and decide when action is needed.
๐Usage
Shield supports Guardianโs monitoring work by observing and recording health checks. Its role is limited to monitoring Carol; it does not restart services or fix problems.
๐Purpose
Shield runs a two-stage health check on Carol every 5 minutes: verifying the worker thread is alive and then verifying the Claude CLI can actually respond. It records every check result to the database, giving Guardian the visibility he needs to spot problems early and decide what to do.
๐Duties
- Checks Carol's worker thread via /api/stats endpoint every 5 minutes
- Checks Claude CLI responsiveness via /api/probe endpoint (15-second timeout)
- Marks status 'ok' only if both checks pass; 'down' if either fails
- Records timestamp, response time, status, and error details to the database in Berlin timezone
๐Constraints
- Only observes and records โ doesn't restart services or fix problems
- Doesn't manage tunnels or monitor other infrastructure components
- Limited to Carol health checks; doesn't cover the Guardian apps themselves
๐คBelongs to
Source: Droid Families ยท Public information reflected here.