What problem does it solve?
Health check and mechanical recovery — detect stale leases, expired candidates, stuck reviews, and blocked work items, then take safe recovery actions. It also enforces operating budgets and replays interrupted transactions. Use for routine health checks, when something seems stuck, or when the user says 'watchdog', 'health check', 'check for stale items', 'anything stuck?', 'run maintenance', 'check budgets', 'recovery sweep', or 'clean up orphaned leases'. Also appropriate after a session crash or long idle period.
Core Features & Use Cases
- Mechanical recovery actions: requeue and reset lease state for stale work items, clear ownership fields, and bump requeue counters.
- Budget and safety enforcement: verify effort against thresholds, emit budget_exceeded alerts, and replay interrupted transactions to preserve consistency.
- Observability & escalation: generate alerts for long-open gates, repeated failures, and orchestrator review triggers; support safe respawn and re-dispatch.
Quick Start
Run the watchdog tick to perform a health check and recovery sweep.