feat: add connection health monitor with metrics (#6)

Implements the HealthMonitor class for tracking connection health:
- Tracks connection states per stream (active, stale, disconnected)
- Records events and calculates throughput (events/second)
- Detects stale streams (no events for configurable threshold)
- Exposes Prometheus-compatible metrics endpoint (/metrics)
- Provides HTTP health endpoints (/health, /ready, /live)

Exports: HealthMonitor, HealthReport, HealthStatus, StreamHealth, StreamStatus

Tests: 47 comprehensive unit tests covering all functionality

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

This commit is contained in:

Patrick Selamy

2026-01-04 15:22:10 -05:00

co-authored by

Claude Opus 4.5

parent 3bf8e228b8

commit 7d32135bb9

4 changed files with 1143 additions and 0 deletions

									
										pyproject.toml
									
		+2
		
												View File
												
				@@ -14,6 +14,8 @@ dependencies = [

				    "pydantic>=2.0.0",

				    "python-dotenv>=1.0.0",

				    "websockets>=12.0",

				    "prometheus-client>=0.19.0",

				    "aiohttp>=3.9.0",

				]

				[project.optional-dependencies]