docs: REPORT + CONTEXT + README for v0.90.0 channel health-check (live-validated, hub v0.20.0 allowlist)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Pg8ANF97SEeKYSN5Jxw3qJ
2026-06-29 20:43:13 +02:00
parent a277b18981
commit 0f7ba7b665
3 changed files with 104 additions and 57 deletions
@@ -7,7 +7,23 @@
 >
 > Ask Claude Code: "Please update CONTEXT.md with what we did today"

-Last updated: 2026-06-29 (OPS: R1 restore of agent local-API leaf — controller↔agent service restored)
+Last updated: 2026-06-29 (v0.90.0 — controller→agent channel health-check)
+
+> **2026-06-29 — v0.90.0: controller→agent channel health-check (self-health slice).** A ~60s
+> scheduler job (`internal/channelhealth`) probes the local-API channel via the PRODUCTION memoized
+> client (`Server.ProbeAgentChannel` → `s.agentClient()` + GET /storage — NOT a fresh client, per the
+> spike: self-heals, mirrors the disk UI, no transport leak). Classifies failures (spike Q1 map:
+> pin_mismatch/unauthorized/unreachable/timeout/misconfigured/construction_error/unknown), **debounces**
+> transient reasons (refused/timeout need N≥2 consecutive so the ~1s agent-restart blip doesn't page;
+> pin/401/DNS/construction alert first-obs), seeds the first observation silently, and on a transition
+> emits an **English operator-only** event (`Notifier.NotifyAgentChannelDown/Recovered`) + a Hungarian
+> dashboard banner (`AlertManager.SetAgentChannelAlert`). Closes the R1-incident gap (channel was only
+> checked once at startup). **Required a hub change** (felhom-hub v0.20.0): the `agent_channel_*` event
+> types were rejected by the hub's `allowedEventTypes` allowlist (HTTP 400) — controller-pushed events
+> are gated, unlike the hub-generated host_* ones. Live-validated: transient restart → no alert;
+> sustained stop → debounce(1/2) then DOWN transition + dashboard banner; start → recovered. No agent
+> change. Self-health story now: agent watches its own capabilities (v0.44.0) + controller watches its
+> link to the agent (this). Backlog: hub-side leaf-fp comparison.

 > **2026-06-29 — OPS (no code change): controller↔agent TLS leaf-pin mismatch RESOLVED via R1.**
 > The 2026-06-28 root→non-root agent migration regenerated the agent's local-API leaf