ADR-002-agent-health-dashboard

ADR-002: Agent Health Dashboard — idle vs timeout

Data: 2026-03-05 Status: Proposed

Kontekst

W trakcie sesji 2026-03-05 zaobserwowaliśmy że Qwentek, Orion i Bielik zawieszali się lub dawały “Request timed out” bez żadnego sygnału w UI. Clawharbor pokazuje status idle i working — ale nie rozróżnia między:

• idle — agent czeka na zadanie (OK)
• timeout — agent nie odpowiedział w czasie (problem)
• no-session — agent nigdy nie startował (problem)

Dowiedzieliśmy się o problemie post-factum z logu w water cooler chacie.

Propozycja

Dodać health dashboard — prosty widok zielony/żółty/czerwony per agent:

Kolor	Znaczenie
🟢 Zielony	Agent odpowiedział w ostatnich X minutach
🟡 Żółty	Agent idle > Y minut (może śpi)
🔴 Czerwony	Ostatnia odpowiedź to timeout/error

Możliwe implementacje

1. W Clawharbor UI — dodatkowa kolumna/ikona przy każdym NPC
2. W Obsidian — periodic raport generowany przez Orwila (heartbeat)
3. Osobna strona w Clawharbor — /health endpoint

Status

Do zaimplementowania. Najprostsze: rozszerzyć ~/.openclaw/.status/ o plik health.json który clawharbor czyta i wyświetla.

Powiązane

• Cold start checklist dla agentów (ADR-003 — do napisania)
• Clawharbor ↔ ACP integracja (architektura/clawharbor-acp-integracja.md)