feat(handlers): implement HttpHandler for OMN-237

.claude/settings.local.json

@@ -68,7 +68,10 @@
       "mcp__linear-server__get_team",
       "mcp__linear-server__create_issue",
       "mcp__linear-server__get_issue",
-      "Bash(git init:*)"
+      "Bash(git init:*)",
+      "Bash(poetry run pytest:*)",
+      "Bash(poetry run python:*)",
+      "Bash(poetry add:*)"
     ],
     "deny": [],
     "ask": []

.github/workflows/test.yml

@@ -10,7 +10,7 @@ on:
 env:
   POETRY_VERSION: "2.2.1"
   PYTHON_VERSION: "3.12"
-  CACHE_VERSION: "0.1.0"
+  CACHE_VERSION: "0.2.0"
 
 jobs:
   # Quick smoke test - fails fast on basic issues

CHANGELOG.md

@@ -0,0 +1,139 @@
+# Changelog
+
+All notable changes to the ONEX Infrastructure (omnibase_infra) will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+#### Handlers
+- **HttpHandler** (OMN-237, PR #26): HTTP REST protocol handler for MVP
+  - GET and POST operations using httpx async client
+  - Fixed 30s timeout (configurable timeout deferred to Beta)
+  - Returns `EnumHandlerType.HTTP`
+  - Error handling mapping to infrastructure errors (`InfraTimeoutError`, `InfraConnectionError`)
+  - Full lifecycle support (initialize, shutdown, health_check, describe)
+  - 46 unit tests with 97.93% coverage
+
+#### Event Bus
+- **InMemoryEventBus** (OMN-239, PR #25): In-memory event bus for local development and testing
+  - Implements `ProtocolEventBus` from omnibase_core
+  - Topic-based pub/sub with `asyncio.Queue` per topic
+  - Thread-safe subscription management
+  - Automatic cleanup on unsubscribe
+  - Consumer groups with load balancing
+  - Graceful shutdown with message draining
+  - Comprehensive error handling
+  - 1336+ lines of test coverage
+
+#### Runtime
+- **ProtocolBindingRegistry** (OMN-240, PR #24): Handler and event bus registration system
+  - Single source of truth for handler registration
+  - Thread-safe registration operations
+  - Support for handler type constants (HTTP, DATABASE, KAFKA, etc.)
+  - Event bus registry (InMemory, Kafka)
+  - Protocol resolution utilities
+
+#### Errors
+- **Infrastructure Error Taxonomy** (OMN-290, PR #23): Structured error hierarchy
+  - `RuntimeHostError`: Base infrastructure error class
+  - `ProtocolConfigurationError`: Protocol configuration validation errors
+  - `SecretResolutionError`: Secret/credential resolution errors
+  - `InfraConnectionError`: Infrastructure connection errors (transport-aware)
+  - `InfraTimeoutError`: Infrastructure timeout errors
+  - `InfraAuthenticationError`: Infrastructure authentication errors
+  - `InfraUnavailableError`: Infrastructure resource unavailable errors
+  - `ModelInfraErrorContext`: Structured error context model
+  - `EnumInfraTransportType`: Transport type classification
+
+#### Infrastructure
+- **Directory Structure** (OMN-236, PR #21): Initial MVP directory structure
+  - `handlers/`: Protocol handler implementations
+  - `event_bus/`: Event bus implementations
+  - `runtime/`: Runtime host components
+  - `errors/`: Infrastructure error classes
+  - `enums/`: Infrastructure enumerations
+  - `validation/`: Contract validation utilities
+
+### Changed
+
+#### CI/CD
+- **Pre-commit Configuration**: Migrated to fix deprecated stage warnings (PR #25)
+
+## [0.1.0] - Unreleased
+
+### Planned
+
+This version represents the MVP (Minimum Viable Product) for ONEX Runtime Host Infrastructure.
+
+#### Core Components (MVP)
+- **BaseRuntimeHostProcess** (OMN-249): Infrastructure wrapper owning event bus and driving NodeRuntime
+- **DbHandler** (OMN-238): PostgreSQL database protocol handler
+- **wiring.py** (OMN-240): Handler registration module ✅ (implemented as ProtocolBindingRegistry)
+
+#### Testing (MVP)
+- **E2E Flow Test** (OMN-254): InMemoryEventBus -> Runtime -> Handler flow
+- **Architecture Verification** (OMN-255): Architectural invariant checks
+
+#### Deployment (MVP)
+- **Dockerfile** (OMN-256): Basic container image for runtime host
+- **docker-compose** (OMN-264): Local development configuration
+
+#### Documentation (MVP)
+- **CLAUDE.md Updates** (OMN-265): Runtime Host architecture documentation
+
+### MVP Philosophy
+
+> **MVP (v0.1.0)**: Prove the architecture works end-to-end with minimal scope
+> - InMemoryEventBus only (no Kafka complexity)
+> - HTTP + DB handlers only (no Vault, no Consul)
+> - Simplified contract format
+> - Basic error handling
+> - Unit tests with mocks
+
+### Deferred to Beta (v0.2.0)
+
+- KafkaEventBus with backpressure
+- VaultHandler and ConsulHandler
+- Retry logic and rate limiting
+- Full graceful shutdown with drain
+- Integration tests with real services
+- Observability layer (structured logging, metrics)
+
+---
+
+## Architecture
+
+```
+omnibase_infra (YOU ARE HERE)
+    ├── handlers/          # Protocol handler implementations
+    │   ├── http_handler   # HTTP REST handler (MVP)
+    │   └── db_handler     # PostgreSQL handler (MVP)
+    ├── event_bus/         # Event bus implementations
+    │   ├── inmemory       # InMemory bus (MVP)
+    │   └── kafka          # Kafka bus (Beta)
+    ├── runtime/           # Runtime host components
+    │   ├── handler_registry
+    │   └── runtime_host_process
+    └── errors/            # Infrastructure errors
+        └── infra_errors
+
+DEPENDENCY RULE: infra -> spi -> core (never reverse)
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### ONEX Standards
+- Zero tolerance for `Any` types
+- Contract-driven development
+- Protocol-based dependency injection
+- Comprehensive test coverage (>80% target)
+
+## License
+
+MIT License - See LICENSE file for details