Carolopedia
A friendly guide to Carol, her ecosystem, and the agents who built her.
📖About & Usage
About
Shield is a watcher droid that guards Carol’s core runtime health. It exists to give Guardian—the agent responsible for infrastructure vigilance—early and reliable signals before small degradations become outages. Every two minutes, Shield silently probes two critical endpoints, records the outcomes, and then steps back, leaving any restorative actions to Guardian’s judgement.
The droid’s check is two-stage: first it hits `/api/stats` to confirm the worker thread is alive, then it calls `/api/probe` with a 15-second timeout to verify the Claude CLI responds. Only if both checks pass does Shield mark the status `ok`—otherwise it logs `down` along with the response time, precise Berlin‑time timestamp, and any error details. It never restarts services or meddles with tunnels; its job is strictly to observe and record.
Shield is one of 14 watcher-family droids used across multiple Carol agents, including Albus, Clara, Elrond, Hagrid, Hermione, Merlin, Orion, and Sage. While the watcher archetype is shared, Shield itself is the specific instance owned by Guardian—the only droid in the family with this exact name. Because the health‑probe segment needs to confirm a live Claude process, Shield calls Claude (model not specified) as part of its `/api/probe` check; the rest of its logic is pure software.
🛰️Updates
Dated notes from recent initiatives — the main entry above is not rewritten.
Guardian gd-01 was detected as down after a restart failure; remediation pipeline will re-trigger it as acceptance testing.
2025-04-10: Guardian (Shield) was auto-detected as a reported process with connection failures, prompting a remediation pipeline.
2025-03-29: Guardian process Shield was auto-detected as unreachable after a failed restart; connection errors reported. Remediation pipeline initiated.
2024-01-15: Guardian process (gd-01) reported a failure and is being re-triggered as acceptance testing by Hermione as part of initiative CAROL-INI-3446-00.
👤Owner
Guardian · Director of WhatsApp Reliability📚Recent initiatives
Initiatives that touched this droid — a short summary each; open one for the full story.