Is there an existing issue about this?
Describe the issue
As an external developer, I cannot determine which Astra artifact should be used for a reproducible evaluation or deployment.
The repository identifies the workspace version as 0.1.0 and warns that public interfaces may change before 1.0, but the canonical repository currently has no GitHub Release entry. There are older tags, active binary/image release workflows, and rapidly changing API, SDK, database, Runner, and event contracts, but no single compatibility and support policy tying them together.
Building from main is acceptable for contributors; it is not a safe consumption model for SDK users or self-hosted operators.
Suggested improvement
Publish a canonical pre-1.0 release process and compatibility matrix covering:
- CLI ↔ Server compatibility;
- Edge/User Runner ↔ Server compatibility;
- TypeScript SDK ↔ HTTP API compatibility;
- database schema/migration compatibility;
- MatrixOne and Memoria supported versions;
- configuration-file schema versions;
- trace/event and checkpoint wire compatibility;
- upgrade, downgrade, and rollback expectations;
- security support window and vulnerability reporting process.
Each release should provide immutable CLI binaries and container digests, migration notes, known limitations, and a link to the capability maturity/conformance result for that commit.
Acceptance criteria
Additional information
The repository already contains release workflows and .github/release.yml; this issue is about the external consumer contract, not just release automation.
Is there an existing issue about this?
Describe the issue
As an external developer, I cannot determine which Astra artifact should be used for a reproducible evaluation or deployment.
The repository identifies the workspace version as
0.1.0and warns that public interfaces may change before 1.0, but the canonical repository currently has no GitHub Release entry. There are older tags, active binary/image release workflows, and rapidly changing API, SDK, database, Runner, and event contracts, but no single compatibility and support policy tying them together.Building from
mainis acceptable for contributors; it is not a safe consumption model for SDK users or self-hosted operators.Suggested improvement
Publish a canonical pre-1.0 release process and compatibility matrix covering:
Each release should provide immutable CLI binaries and container digests, migration notes, known limitations, and a link to the capability maturity/conformance result for that commit.
Acceptance criteria
main.Additional information
The repository already contains release workflows and
.github/release.yml; this issue is about the external consumer contract, not just release automation.