release-readiness.md•4.82 kB
# Release Readiness Checklist: Watchtower DAP Windows Debugging
**Purpose**: Validate release readiness across Alpha, Beta, and GA milestones
**Created**: 2025-10-17
**Feature**: [Link to plan.md](../plan.md) | [Link to tasks.md](../tasks.md)
## Alpha Release Readiness (Node.js + Python Launch Debugging)
### Core Functionality
- [ ] REL001 Node.js debugging fully operational with breakpoints and stepping
- [ ] REL002 Python debugging fully operational with breakpoints and stepping
- [ ] REL003 dap.start, dap.setBreakpoints, dap.continue, dap.pause, dap.step working
- [ ] REL004 dap.threads, dap.stackTrace, dap.scopes, dap.variables functional
- [ ] REL005 dap.evaluate working for simple expression evaluation
- [ ] REL006 dap.events.poll implemented with basic event buffering
- [ ] REL007 dap.terminate and dap.disconnect properly clean up sessions
### Quality Gates
- [ ] REL008 All unit tests passing with >80% coverage
- [ ] REL009 Integration tests pass for Node.js and Python launch scenarios
- [ ] REL010 Performance targets met: TFFB ≤ 1000ms, Step p95 ≤ 200ms
- [ ] REL011 Security audit passed for Alpha release (no high-risk issues)
- [ ] REL012 Basic documentation with Node.js and Python quickstarts
### Release Artifacts
- [ ] REL013 MCP server builds successfully with esbuild
- [ ] REL014 Installation package includes necessary dependencies
- [ ] REL015 CLI 'watchtower serve' command functional
- [ ] REL016 Basic adapter validation included in diagnostics
## Beta Release Readiness (All Languages + Attach + Metrics)
### Multi-Language Support
- [ ] REL017 C# debugging via vsdbg/netcoredbg fully functional
- [ ] REL018 Dart/Flutter debugging via DAP adapter fully functional
- [ ] REL019 All four languages support both launch and attach flows
- [ ] REL020 Language-specific adapters validated with version pinning
- [ ] REL021 Source map support for TypeScript debugging
### Advanced Features
- [ ] REL022 TCP transport for remote debugging working
- [ ] REL023 Process discovery and attachment logic complete
- [ ] REL024 Event ring buffer with pagination and truncation
- [ ] REL025 Enhanced error handling with actionable diagnostics
- ] REL026 'watchtower doctor' diagnostic tool fully functional
### Observability & Performance
- [ ] REL027 OpenTelemetry metrics implemented (TFFB, STEP_p95, SR, BP1)
- [ ] REL028 Structured logging with env/args redaction active
- [ ] REL029 Performance monitoring and alerting configured
- ] REL030 Load testing for concurrent sessions completed
### Quality Gates
- [ ] REL031 All unit tests passing with >90% coverage
- [ ] REL032 Integration tests pass for all languages and attach scenarios
- [ ] REL033 Cross-language debugging sessions validated
- [ ] REL034 Performance regression testing completed
- [ ] REL035 Security audit passed for Beta release
### Documentation
- [ ] REL036 Comprehensive quickstart guide for all languages
- [ ] REL037 Attach recipes documented for each language
- [ ] REL038 Troubleshooting guide with common issues and solutions
- ] REL039 Claude Code MCP configuration snippet provided
## GA Release Readiness (Production Ready)
### Infrastructure & CI
- [ ] REL040 Windows CI integration tests complete debug cycle per language
- [ ] REL041 Automated build and deployment pipeline established
- [ ] REL042 Sample projects included for all target languages
- ] REL043 Adapter package management and version pinning documented
### Quality Assurance
- [ ] REL044 End-to-end automation testing covers all user stories
- ] REL045 Performance benchmarks established and documented
- ] REL046 Error recovery and graceful degradation tested
- ] REL047 User feedback incorporated from Alpha/Beta testers
### Documentation & Support
- [ ] REL048 API reference documentation complete
- [ ] REL049 Architecture documentation for maintainers
- ] REL050 Operational guide for deployment and monitoring
- ] REL051 Support channels and escalation procedures documented
### Final Validation
- [ ] REL052 All constitution principles compliance verified
- [ ] REL053 Security audit completed for GA release
- ] REL054 Performance targets consistently met across environments
- ] REL055 User satisfaction survey results documented
## Release Sign-off
### Alpha Release Sign-off
- Lead Developer: [ ]
- QA Lead: [ ]
- Product Owner: [ ]
### Beta Release Sign-off
- Lead Developer: [ ]
- QA Lead: [ ]
- Security Lead: [ ]
- Product Owner: [ ]
### GA Release Sign-off
- Engineering Manager: [ ]
- QA Lead: [ ]
- Security Lead: [ ]
- Product Owner: [ ]
- Operations Lead: [ ]
## Notes
- Check items off as completed: `[x]`
- Include version numbers and build artifacts for release artifacts
- Document any known limitations or outstanding issues
- Keep this checklist updated throughout the development process