# MVP roadmap

## Milestone 1 — Done

- Build workspace and crate boundaries.
- Provide REST and RPC runtime helpers.
- Add minimal resilience primitives.
- Add REST scaffold CLI.
- Validate examples and integration tests.

## Milestone 2 — Done

- Add `.api` parser crate.
- Generate Rust REST handlers and DTO types.
- Add OpenAPI export for parsed API specs.

## Milestone 3 — Done

- Add service discovery adapters.
- Add richer metrics and OpenTelemetry exporters.
- Add model/cache generation after runtime APIs stabilize.

## Milestone 4 — Done

- Add production discovery adapter boundaries for etcd v3 and Kubernetes.
- Add OTLP traces configuration and shutdown/flush handle.
- Add SQLx database helper crate and cache/Redis adapter crates.
- Extend model generation with SQLx and Redis skeleton options.

## Milestone 5 — Done

- Add goctl compatibility matrix and reduced golden fixture suite.
- Extend `.api` compatibility with local imports, stable formatting, server option preservation and OpenAPI prefix/group metadata.
- Extend model parsing for common goctl SQL fixture features and composite cache key generation.
- Add RPC proto subset parser and tonic-oriented skeleton generator.
- Add CLI entries for compatibility matrix, API formatting and RPC generation.

## Documentation system — Done

- Restructure README as the project entry point.
- Add docs navigation, quick start, tutorials, manual pages, best practices, troubleshooting, and production checklist.
- Add documentation link and sensitive pattern checks to workspace tests.
