lib

commit 849b59ebf5e6e327dafa592fd215ae3d9eecf01c
parent 1bd80a1fa7ae640cc805bc968c13406a0c233600
Author: triesap <tyson@radroots.org>
Date:   Mon,  2 Mar 2026 23:37:40 +0000

contract: align release version metadata to alpha.1

Diffstat:
M
contract/manifest.toml
 | 
2
+-
M
contract/release/checklist-0.1.0.md
 | 
6
+++---
M
contract/release/publish-set.toml
 | 
2
+-
M
contract/release/runbook.md
 | 
14
++++++++++++++
M
contract/version.toml
 | 
2
+-
M
crates/xtask/src/main.rs
 | 
6
+++++-

6 files changed, 25 insertions(+), 7 deletions(-)
diff --git a/contract/manifest.toml b/contract/manifest.toml
@@ -1,6 +1,6 @@
 [contract]
 name = "radroots-sdk-contract"
-version = "0.1.0"
+version = "0.1.0-alpha.1"
 source = "rust"
 
 [surface]
diff --git a/contract/release/checklist-0.1.0.md b/contract/release/checklist-0.1.0.md
@@ -1,11 +1,11 @@
-# 0.1.0 release checklist
+# release checklist
 
-- [ ] confirm `contract/version.toml` and `contract/release/publish-set.toml` both declare `0.1.0`
+- [ ] confirm `contract/manifest.toml`, `contract/version.toml`, and `contract/release/publish-set.toml` declare the same release version
 - [ ] run `cargo check -q`
 - [ ] run `cargo test -q -p xtask`
 - [ ] run `./scripts/ci/release_preflight.sh`
 - [ ] run `./scripts/ci/release_publish_order.sh dry-run`
 - [ ] confirm crates.io owner and token access for the publish account
 - [ ] run `./scripts/ci/release_publish_order.sh publish`
-- [ ] verify all publish-set crates are visible on crates.io at `0.1.0`
+- [ ] verify all publish-set crates are visible on crates.io at the configured release version
 - [ ] tag release in git and publish release notes
diff --git a/contract/release/publish-set.toml b/contract/release/publish-set.toml
@@ -1,5 +1,5 @@
 [release]
-version = "0.1.0"
+version = "0.1.0-alpha.1"
 
 [publish]
 crates = [
diff --git a/contract/release/runbook.md b/contract/release/runbook.md
@@ -24,6 +24,12 @@ This command validates:
 
 This runs `cargo publish --dry-run` in release order and reports deferred crates when they depend on earlier crates that are not yet published.
 
+GitHub Actions equivalent:
+
+- run workflow `publish crates`
+- set `dry_run = true`
+- optionally set `crates` (space or comma separated) to test a subset in release order
+
 ## publish
 
 ```bash
@@ -32,6 +38,14 @@ This runs `cargo publish --dry-run` in release order and reports deferred crates
 
 This publishes in `publish_order` and waits for each crate version to become visible on crates.io before continuing.
 
+GitHub Actions equivalent:
+
+- run workflow `publish crates`
+- set `dry_run = false`
+- ensure repository secret `CRATES_IO_TOKEN` is configured
+
+The workflow also accepts `CARGO_REGISTRY_TOKEN`; either secret can provide the cargo publish token.
+
 ## post-release verification
 
 ```bash
diff --git a/contract/version.toml b/contract/version.toml
@@ -1,5 +1,5 @@
 [contract]
-version = "0.1.0"
+version = "0.1.0-alpha.1"
 stability = "draft"
 
 [semver]
diff --git a/crates/xtask/src/main.rs b/crates/xtask/src/main.rs
@@ -151,7 +151,11 @@ fn validate_contract() -> Result<(), String> {
 fn release_preflight() -> Result<(), String> {
     let root = workspace_root()?;
     contract::validate_release_preflight(&root)?;
-    eprintln!("validated release preflight for contract 0.1.0");
+    let bundle = contract::load_contract_bundle(&root)?;
+    eprintln!(
+        "validated release preflight for contract {}",
+        bundle.version.contract.version
+    );
     Ok(())
 }