Roadmap and Status

Roadmap & Status

Implementation order and current state. The "why" behind each item lives in the Design spec; this page tracks sequence and progress only.

Phases

The critical path is scaffolding → codegen → service layer → client → DataFrame; everything else hangs off or beside it.

Phase	Work	Issues	Status
0	Confirm cluster endpoint details (port, extension list)	#43	open
1	Scaffolding; buf/protoc codegen; generated service layer	#33 #34 #35	✅ merged (PR #52)
1	Error hierarchy; codec	#38 #40	#38 ✅ · #40 open
2	Transport; auth & tenancy	#36 #37	✅ merged (PR #55)
2	DNS cluster discovery	#53	✅ engine merged (PR #54); constructor wiring in PR #55
3	Clappform client class	#39	✅ merged (PR #55)
4	LocalMock test double	#44	open
4	Collection handle + ReadResult (DataFrame flows)	#41	open
4	Saved-query handle + slug→UUID resolution	#42	open
5	Release pipeline (human-gated)	#47	open
5	Proto-sync automation	#46	open
6	Docs (MkDocs Material on RTD)	#48	open
—	Unit test harness (continuous)	#45	open
—	Namespace discoverability + cf-level shortcuts	#57	open

Backlog (post-6.0.0, in value order)

Work	Issue
Arrow/Polars output surfaces on ReadResult	#49
Parquet bulk-read path via the export service	#50
Async client (clappform.aio)	#51

Open decisions

Tracked in Design §12. Currently: gRPC port on the public hosts (443 vs 50051) and the canonical list of cluster extensions (#43).

Keep this table in sync when a PR merges or an issue is filed. It is the one place that maps design sections to tracked work.