Problem
The README and docs link crates.io/crates/contextgraph-types (et al.) as if live, and PUBLISHING.md contains the full release runbook — but the crates do not appear to be published yet (cargo search contextgraph-types returns nothing). Until cargo add contextgraph-types works, every "build a provider today" claim in the README dead-ends at a 404, and the freeze criterion of independent implementations has nothing to build against.
Proposal
Execute the PUBLISHING.md runbook for 0.1.0:
- Pre-flight:
cargo publish --dry-run for each crate in dependency order (contextgraph-types → contextgraph-host → contextgraph-conformance); verify each crate's publish = true opt-in, license files, description/keywords/categories metadata, and README rendering on the crates.io page
- Verify docs.rs builds (features, no doc warnings under
--cfg docsrs if applicable)
- Move
CHANGELOG.md [Unreleased] → ## [0.1.0] - <date>
- Tag
v0.1.0, publish in dependency order
- Post-flight:
cargo add contextgraph-types in a scratch project compiles; README badges (crates.io version, docs.rs) added
- Decide the release cadence for pre-freeze
0.x bumps (per docs/stability.md, any 0.x → 0.y may break — batch normative changes into planned minors rather than trickling)
If the crates are in fact already published under names I could not see, close this after verifying the links and adding the badges.
Sequencing note: worth landing CI first (see the CI issue) so the release tag is cut from a commit the suite has verified, and ideally publishing via a tag-triggered workflow with a crates.io trusted publisher/token rather than a laptop.
Problem
The README and docs link
crates.io/crates/contextgraph-types(et al.) as if live, andPUBLISHING.mdcontains the full release runbook — but the crates do not appear to be published yet (cargo search contextgraph-typesreturns nothing). Untilcargo add contextgraph-typesworks, every "build a provider today" claim in the README dead-ends at a 404, and the freeze criterion of independent implementations has nothing to build against.Proposal
Execute the
PUBLISHING.mdrunbook for0.1.0:cargo publish --dry-runfor each crate in dependency order (contextgraph-types→contextgraph-host→contextgraph-conformance); verify each crate'spublish = trueopt-in, license files,description/keywords/categoriesmetadata, and README rendering on the crates.io page--cfg docsrsif applicable)CHANGELOG.md[Unreleased]→## [0.1.0] - <date>v0.1.0, publish in dependency ordercargo add contextgraph-typesin a scratch project compiles; README badges (crates.io version, docs.rs) added0.xbumps (perdocs/stability.md, any0.x → 0.ymay break — batch normative changes into planned minors rather than trickling)If the crates are in fact already published under names I could not see, close this after verifying the links and adding the badges.
Sequencing note: worth landing CI first (see the CI issue) so the release tag is cut from a commit the suite has verified, and ideally publishing via a tag-triggered workflow with a crates.io trusted publisher/token rather than a laptop.