Align snapshot contract for v0.1.1

Author: a-a-k

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## v0.1.1 - 2026-03-14
+
+Patch technical-preview release focused on restoring the advertised snapshot compatibility surface with current Bering `io.mb3r.bering.snapshot@1.0.0`.
+
+Included in this release:
+
+- updated strict snapshot contract pin to the current published Bering `1.0.0` digest
+- synced vendored and mirrored snapshot schemas with the published Bering snapshot schema
+- updated snapshot loader to accept the current Bering snapshot envelope
+- refreshed checked-in snapshot sample and generated example outputs to match current upstream structure
+- added CI sanity checks that the published Bering model and snapshot schema URLs still match Sheaft pins and local schema copies
+
+Stable within the `v0.1.1` preview:
+
+- strict acceptance of current `io.mb3r.bering.model@1.0.0`
+- strict acceptance of current `io.mb3r.bering.snapshot@1.0.0`
+- checked-in model and snapshot smoke paths
+- deterministic batch execution for a fixed seed and config
+
+Still experimental in `v0.1.1`:
+
+- long-running `serve` / `watch` service mode
+- richer analysis config and operator-facing conventions
+- local `discover` helper
+
+Known limitations:
+
+- only the Bering `1.0.0` model and snapshot contracts are accepted
+- snapshot envelopes still rely on external predicate overlays or fallback journey resolution when richer predicate definitions are not embedded upstream
+- no new discovery pipeline is introduced in this release
+
 ## v0.1.0 - 2026-03-14
 
 First public Sheaft release, published as an experimental technical preview rather than a stable GA release.

README.md

@@ -91,6 +91,8 @@ Analysis example:
   --out-dir out/quickstart-analysis
 ```
 
+The checked-in snapshot sample mirrors the current Bering `io.mb3r.bering.snapshot@1.0.0` envelope. The accompanying analysis example layers explicit predicate and weight overrides on top of that snapshot sample.
+
 On Windows from a source checkout, the same path is:
 
 ```powershell