feat: platform health telemetry (Sentry-style incident tracking) - #20

Merged

styu12 merged 64 commits into

mainfrom

feat/health-telemetry

Apr 22, 2026

Commits on Apr 22, 2026

docs: health telemetry platform design spec

styu12
and
claude
committed
0297f4d
docs: health telemetry implementation plan

styu12
and
claude
committed
e94efa1
feat(health): add Severity enum with rank + max_severity helper
styu12
committed
2e04515
chore: sync uv.lock to project version 0.3.19
styu12
committed
742fca3
refactor(health): clarify severity _RANK rationale; tidy test imports
styu12
committed
5e95760
feat(types): enrich HealthEvent with severity/source/fingerprint/data
styu12
committed
9813b1c
fix(types): shallow-copy HealthEvent data in to_dict; tidy test placement

styu12
and
claude
committed
35afd86
feat(health): add WriterStats, Incident, IncidentArtifact, IncidentSnapshot
styu12
committed
50a3281
test(health): cover closed-incident anchor; tighten artifacts type
styu12
committed
0b2c055
feat(health): add Detector protocol + DetectorBase
styu12
committed
41cf1e7
fix(health): tighten Detector contracts — MRO-walking __init_subclass__ and Iterator types
styu12
committed
53cddc3
feat(health): add DetectorRegistry
styu12
committed
b8f0ff5
feat(health): add IncidentTracker with fingerprint grouping and close conditions

styu12
and
claude
committed
e0f6c62
fix(health): reject empty fingerprints in IncidentTracker.ingest
styu12
committed
456a687
feat(health): add HealthWorker (daemon thread with ingress queues and tick loop)

styu12
and
claude
committed
a08af9c
refactor(health): HealthWorker polish (anchor, comments, imports)
styu12
committed
23dc42b
feat(health): add AdapterEventPassthrough detector
styu12
committed
5d581f6
feat(health): add StreamStallDetector (platform-level silence detection)

styu12
and
claude
committed
156eec1
feat(health): add FpsDropDetector (target-relative or baseline-learning)
styu12
committed
a295bda
feat(health): add JitterDetector (p95-interval spike detector)

styu12
and
claude
committed
d65c8e1
feat(health): add StartupFailureDetector (connect / start_recording errors)
styu12
committed
463f450
fix(health): StartupFailureDetector clears pending on success signal
styu12
committed
196a6d2
feat(health): add BackpressureDetector (writer queue fullness + drop counter)

styu12
and
claude
committed
6f81de9
feat(health): add HealthSystem facade with default detector install

styu12
and
claude
committed
44445ac
fix(health): HealthSystem start() idempotency + register-after-start warning
styu12
committed
ed00154
feat(types): add StreamCapabilities.target_hz and FinalizationReport.incidents

styu12
and
claude
committed
70a53ef
feat(writer): add SessionLogWriter.log_incident + incidents.jsonl

styu12
and
claude
committed
141dc4a
feat(orchestrator): wire SessionOrchestrator to HealthSystem (samples, health, state, incidents)

styu12
and
claude
committed
7acb426
fix(health): resilient worker ingest + FakeStream health defaults

styu12
and
claude
committed
63bdf89
feat(health): add DepthAILoggerBridge (logging.Handler → HealthEvent)

styu12
and
claude
committed
917429b
feat(oak): declare target_hz, bridge depthai logger for health telemetry

styu12
and
claude
committed
1a42085
refactor(viewer): replace HealthEntry/health_count with IncidentSnapshot fields

styu12
and
claude
committed
11b896f
refactor(viewer-fe): mirror IncidentSnapshot + Severity; drop HealthEntry
styu12
committed
1f934bb
feat(viewer-fe): add IncidentPanel (replaces HealthTable)
styu12
committed
73e6c2c
feat(viewer-fe): stream card severity badge from active incidents
styu12
committed
2b82690
feat(adapters): declare target_hz on UVC / audio / Meta Quest / BLE IMU / sensors

styu12
and
claude
committed
967a026
fix(health): multi-listener callbacks, WriterStats emission, and target_hz threading

styu12
and
claude
committed
8ad2e25
refactor(health): simplify FpsDropDetector tick (remove O(N²) dip-start search)

styu12
and
claude
committed
58e7958
ci: build viewer frontend before pytest

styu12
and
claude
committed
20e3229
ci: install [all] extras so adapter tests can import their deps

styu12
and
claude
committed
786bc49
ci: install dev deps explicitly (dev is a dependency-group, not an extra)

styu12
and
claude
committed
b3be799
test: add future annotations for Python 3.9 compat

styu12
and
claude
committed
d334a1d
test: add future annotations to remaining tests for Python 3.9 compat

styu12
and
claude
committed
48ed479
docs: partial-connect UX design spec

styu12
and
claude
committed
5cf566e
docs: implementation plan for partial-connect UX

styu12
and
claude
committed
45bf93a
feat(health): add Detector.observe_connection_state hook

styu12
and
claude
committed
d510599
feat(health): add per-stream connection-state ingress to HealthWorker

styu12
and
claude
committed
86a9774
feat(health): expose observe_connection_state on HealthSystem

styu12
and
claude
committed
1ea763d
feat(health): add NoDataDetector for connected-but-silent streams

styu12
and
claude
committed
f64d8c6
feat(health): register NoDataDetector in default suite

styu12
and
claude
committed
4b7b790
feat(orchestrator): add per-stream connection-state dicts + helper

styu12
and
claude
committed
84236bb
feat(orchestrator): partial-connect — survive per-stream connect() failure

styu12
and
claude
committed
8cf253a
test(orchestrator): update pre-existing tests for partial-connect semantics

styu12
and
claude
committed
ae671b2
feat(orchestrator): skip failed streams in start/stop recording loops

styu12
and
claude
committed
f63161c
feat(orchestrator): disconnect() flips all tracked streams to 'disconnected'

styu12
and
claude
committed
87734e1
feat(viewer): add connection_state / connection_error to StreamSnapshot

styu12
and
claude
committed
82d1b25
feat(viewer): poller reads orchestrator stream state into snapshot

styu12
and
claude
committed
3a680fc
feat(viewer): emit connection_state / connection_error over WebSocket

styu12
and
claude
committed
8942ad1
feat(viewer-fe): mirror ConnectionState + StreamSnapshot additions

styu12
and
claude
committed
6d9feef
feat(viewer-fe): add Connecting / WaitingForData / Failed overlays

styu12
and
claude
committed
964e708
feat(viewer-fe): branch StreamCard body on connection_state

styu12
and
claude
committed
5f3deae
feat(viewer-fe): show degraded counter on header state chip

styu12
and
claude
committed
d5fec41
test(health): integration test for partial connect + incident persistence

styu12
and
claude
committed
1f4488a
test(health): integration test for NoDataDetector on real orchestrator

styu12
and
claude
committed
1b804eb