Prepare edit-session 0.1.0-alpha.5 with packaged context checks

.github/workflows/publish.yml

@@ -37,6 +37,8 @@ jobs:
       - run: rustup toolchain install 1.88.0 --profile minimal --component rustfmt,clippy
       - run: cargo +1.88.0 test --locked
       - run: cargo +1.88.0 run --locked --example retry_command
+      - run: cargo +1.88.0 run --locked --example context_walkthrough
+      - run: python3 tools/context_evidence.py --check
       - run: cargo +1.88.0 fmt --check
       - run: cargo +1.88.0 clippy --locked --all-targets -- -D warnings
       - run: cargo +1.88.0 publish --dry-run --locked --registry crates-io
@@ -48,6 +50,8 @@ jobs:
           cd packaged/edit-session-*
           cargo +1.88.0 test --locked
           cargo +1.88.0 run --locked --example retry_command
+          cargo +1.88.0 run --locked --example context_walkthrough
+          python3 tools/context_evidence.py --check
           cd ../..
           sha256sum target/package/*.crate > SHA256SUMS
       - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2

CHANGELOG.md

@@ -1,13 +1,17 @@
 # Changelog
 
-## Unreleased
+## 0.1.0-alpha.5
+
+Examples and documentation release. Runtime behavior is unchanged.
 
 - Add a runnable context walkthrough: a host edit followed by Undo restores the
   value but invalidates an old draft; Reset does not rebase its captured context.
 - Generate a front-page diagram from the example's output and source hashes;
   verify both on Rust 1.88 and stable in CI. Include the renderer in source packages.
 - Put concrete behavior, local-helper trade-offs and host responsibilities first in
-  the README. Public API, runtime behavior and published versions are unchanged.
+  the README. Verify the context walkthrough and diagram from the packaged crate
+  before upload. Public API, runtime behavior, Rust 1.88 minimum and dependencies
+  are unchanged; use a new package version for the added examples and documentation.
 
 ## 0.1.0-alpha.4
 

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "edit-session"
-version = "0.1.0-alpha.4"
+version = "0.1.0-alpha.5"
 edition = "2024"
 rust-version = "1.88"
 description = "Toolkit-independent preview, validation and commit lifecycle"

PACKAGE.md

@@ -13,7 +13,7 @@ Add a published copy of this prerelease to your dependencies:
 
 ```toml
 [dependencies]
-edit-session = "=0.1.0-alpha.4"
+edit-session = "=0.1.0-alpha.5"
 ```
 
 This is an experimental alpha. Pin an exact version and keep `Cargo.lock` for

docs/RELEASING.md

@@ -1,5 +1,12 @@
 # Releases and alpha compatibility
 
+## Current candidate
+
+`0.1.0-alpha.5` packages the context walkthrough and feedback-driven documentation.
+Publication is pending. The public API, runtime behavior, Rust 1.88 minimum and zero
+runtime dependencies are unchanged. The release workflow runs both examples and
+checks the generated context diagram from the extracted crate before upload.
+
 ## Published prerelease
 
 **[0.1.0-alpha.4 on crates.io](https://crates.io/crates/edit-session/0.1.0-alpha.4)**
@@ -34,6 +41,8 @@ Update the version and changelog for the new candidate, then run:
 ```sh
 cargo test --locked
 cargo run --locked --example retry_command
+cargo run --locked --example context_walkthrough
+python3 tools/context_evidence.py --check
 cargo fmt --check
 cargo clippy --locked --all-targets -- -D warnings
 cargo package --locked --list