From 67b0042bc34ae5e8c392cc2ba93d2750899311aa Mon Sep 17 00:00:00 2001
From: PerchAnton <101743951+PerchAnton@users.noreply.github.com>
Date: Tue, 27 Oct 2026 08:49:36 +0200
Subject: [PATCH] Prepare alpha 5 with packaged context walkthrough
 verification

---
 .github/workflows/publish.yml | 4 ++++
 CHANGELOG.md                  | 8 ++++++--
 Cargo.lock                    | 2 +-
 Cargo.toml                    | 2 +-
 PACKAGE.md                    | 2 +-
 docs/RELEASING.md             | 9 +++++++++
 6 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 7821d50..090e041 100644
--- a/.github/workflows/publish.yml
+++ b/.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
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 15674c1..f8fe290 100644
--- a/CHANGELOG.md
+++ b/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
 
diff --git a/Cargo.lock b/Cargo.lock
index b84cef9..70b46e8 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -4,4 +4,4 @@ version = 4
 
 [[package]]
 name = "edit-session"
-version = "0.1.0-alpha.4"
+version = "0.1.0-alpha.5"
diff --git a/Cargo.toml b/Cargo.toml
index 0a59c26..336a48d 100644
--- a/Cargo.toml
+++ b/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"
diff --git a/PACKAGE.md b/PACKAGE.md
index ee2d572..3f57896 100644
--- a/PACKAGE.md
+++ b/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
diff --git a/docs/RELEASING.md b/docs/RELEASING.md
index 756a6fb..ee60056 100644
--- a/docs/RELEASING.md
+++ b/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