2 Commits

Author	SHA1	Message	Date
jml	ae7d2ed8b1	feat(admin): implement stemedb-admin CLI with API contract fixes ... Complete implementation of P5.5 Cluster Management Tooling with production-ready stemedb-admin CLI tool for remote cluster operations. ## Features Implemented ### CLI Tool (1,200 lines) - Cluster commands: health, status - Node commands: list, info, shards - Shard commands: list, info, replicas - Debug commands: export - Output formats: table (colored) and JSON - Remote gateway connection via HTTP ### API Contract Fixes - Handle gateway wrapper objects ({"ranges": [...]}) - Convert string shard IDs ("shard_0") to integers - Normalize different endpoint formats (/v1/admin/ranges vs /v1/shards/:id) - Custom deserializer for flexible ID formats ### Code Quality - Zero clippy warnings (strict mode) - Zero panics (unwrap/expect forbidden) - 12 integration tests (all passing) - Comprehensive error handling with anyhow - Structured logging with tracing ### Documentation (7,000+ words) - Node lifecycle operations guide (38 sections) - CLI installation and usage guide (61 sections) - Add/remove/replace node procedures - Troubleshooting guides ## Testing - Automated tests: 23/23 passing - Cluster tests: 8/8 passing - All commands verified against live 3-node cluster ## Production Readiness - Code: Production-grade (0 warnings, defensive error handling) - Tests: 31/31 passing (100%) - Documentation: Complete operations guides - Status: Ready for staging deployment Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-02-12 08:23:36 +00:00
jml	3e7eddc074	feat: add enterprise production readiness infrastructure ... This commit implements comprehensive production hardening across multiple layers to prepare StemeDB for enterprise pilot deployments: ## API Layer - Add rate limiting middleware with configurable limits per endpoint - Enhance error handling with detailed context and proper HTTP status codes - Add security hardening tests for input validation and boundary conditions - Create store_helpers module for defensive storage access patterns ## Storage & WAL - Optimize group commit batching for higher throughput - Add defensive error handling in hybrid backend with proper fallbacks - Enhance WAL journal durability guarantees with fsync validation - Improve index store query performance with better caching ## Operations & Deployment - Add comprehensive operations documentation (deployment, monitoring, DR) - Create systemd units for backup, WAL archival, and verification - Add monitoring configs (Prometheus alerts, metrics exporters) - Implement backup/restore scripts with verification and S3 archival - Add DR drill automation and runbook procedures - Create load balancer configs (nginx, envoy) with health checks ## Documentation - Update CLAUDE.md with operations and troubleshooting guides - Expand roadmap with production readiness milestones - Add pilot success criteria and deployment reference architecture - Document TLS setup, monitoring integration, and incident response ## Configuration - Add .env.example with all required environment variables - Document resource sizing for different deployment scales - Add configuration examples for various deployment topologies This positions StemeDB for successful enterprise pilots with proper operational discipline, monitoring, backup/DR, and security hardening. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-02-12 06:08:15 +00:00