This directory contains the comprehensive planning documentation for the NTP Pool monitoring system. The plans are organized into design documents (timeless architecture) and implementation plans (actionable work items).
- JWT Authentication Implementation - Superseded API key auth plan with JWT+JWKS (commits: 10e2a70, deb9a16, 304cc1c)
- OpenTelemetry Migration - Complete client metrics migration (commit: 9aa4d39)
- Database Consolidation - Migrated to common/database package (commits: 650aeb9, 393a251, c86adf2)
- "New" Status Elimination - Removed from schema (commit: 64416d0)
- Performance-Based Replacement in Rule 5 - Candidates can now replace worse-performing testing monitors (commit: de5e03a)
- Emergency Override Consistency - Fixed candidate→testing promotion gap (commit: b6515b8)
- Helper Function Extraction - 47% code reduction in promotion logic (commit: 6c4ae72)
- Safety Logic Improvements - Fixed blocking constraint demotions (commit: e04e47a)
- Monitor Limit Enforcement - Complete implementation with Rule 1.5 and capacity limits
- Network Diversity Constraint - Fixed target state evaluation (commit: 6035139)
- Per-Status-Group Change Limits - Implemented separate limits for each transition type
- Dynamic Testing Pool Sizing - Added dynamic testing target calculation
- Test Coverage Improvement - From 53.6% to 80%+ target with recent safety test additions
- Grandfathering Logic - Non-functional implementation needs fixing
- Performance Optimizations - Database query optimization and testing improvements
- Quality Improvements - Code quality initiatives and technical debt cleanup
These documents describe "what the system is and how it works":
- api-design.md - API patterns, authentication, and configuration management
- monitoring-design.md - Monitor lifecycle, capacity management, and rule execution
- selector-design.md - Core selection algorithm architecture and constraint system
- testing-design.md - Testing strategies, coverage targets, and quality assurance
These documents describe "what needs to be done":
- grandfathering-fix.md - 🔄 Active: Functional grandfathering implementation
- performance-optimizations.md - 📋 TODO: Database and testing performance improvements
- quality-improvements.md - 🔄 Active: Test coverage and code quality
- remaining-bugs-active.md - 📋 TODO: Active bug tracking (grandfathering primary remaining issue)
- testing-strategy-unified.md - 🔄 Active: Unified testing approach (6% → 40-50% coverage)
- archive/README.md - Historical implementation context
- archive/completed-implementations/ - 9 completed plans with implementation details
- archive/releases/ - Release notes and version history
- archive/legacy/ - 2 superseded approaches
- Grandfathering Logic Implementation - Core functionality currently broken
- Test Coverage Improvement - Critical safety functions need comprehensive testing
- Eliminate "New" Status - Major architecture simplification ready for implementation
- Performance Optimizations - Database query optimization and testing improvements
- Quality Improvements - Code quality initiatives and technical debt reduction
- API Design Enhancements - Extended API functionality and metrics endpoints
- Advanced Testing Strategies - Chaos testing and performance regression prevention
- 47% Code Reduction in promotion logic through helper function extraction
- Consistent Emergency Handling across all promotion types
- Mathematical Consistency with proper working count tracking
- Emergency Recovery from zero monitors via constraint bypass
- Safety Logic Validation with comprehensive test coverage
- Constraint System Maturation with grandfathering support framework
- 80% Reduction in constraint checks through lazy evaluation
- Dynamic Capacity Management with real-time pool sizing
- Optimized Rule Execution with proper sequencing and limits
- Check Active Plans: Review in-progress items in implementation plans
- Reference Design Docs: Understand architecture from design documents
- Update Status: Mark completed items and update progress
- Archive Completed Work: Move finished implementations to archive
- LLM_CODING_AGENT.md - Implementation patterns and architectural decisions
- CONSOLIDATION-SUMMARY.md - History of plan organization and consolidation
- Main README.md - Project overview and installation instructions
This plans directory serves as the central hub for all implementation planning, combining current development needs with preserved institutional knowledge from completed work.