Milestone 7: SDK Development & Migration Tools

[copyleftdev]

Overview

Provide ergonomic SDKs and migration tooling for easy adoption.

Timeline: Weeks 11-12

RFC References

• RFC-010: SDK Design

Tasks

• Rust SDK
  • Builder pattern API
  • Test helper macros (ouli_test!)
  • Comprehensive documentation with examples
  • Published to crates.io
• TypeScript SDK
  • NPM package with type definitions
  • Jest integration (global setup/teardown)
  • Binary auto-download script
  • Example project with tests
• Python SDK
  • PyPI package with type hints
  • pytest integration (fixtures)
  • Context manager support (with statement)
  • Example project with tests
• Migration tools
  • Import from test-server JSON format
  • Batch conversion utility
  • Validation and compatibility checks
  • Migration guide documentation
• CLI improvements
  • ouli migrate command
  • ouli stats for recording analysis
  • Helpful error messages
  • Shell completion scripts

Acceptance Criteria

• All 3 SDKs published to respective registries
• Migration tool achieves 100% test-server compatibility
• Examples for each SDK in /examples directory
• SDK documentation complete (README + API docs)
• Migration guide tested on real test-server projects
• CLI has comprehensive --help output
• Each SDK has >90% test coverage

Dependencies

• Blocked by: Milestone 4: Replay Engine #4 (replay engine needed for SDK testing)

Estimated Effort

2 weeks, 2-3 engineers