release: 1.1.2 (docs/examples; wire crate README)

CHANGELOG.md

@@ -6,6 +6,13 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.1.2] - 2026-06-01
+
+No library or contract changes — the `tq1` envelope, exit codes, and
+`config_version` are byte-for-byte identical to 1.1.1. This is a
+documentation/examples release; it also wires the `anomalyx` crate's README so
+the crates.io landing page finally renders it.
+
 ### Examples
 
 - **`examples/synergy_market.py`** — pairs anomalyx with `agent-calc` (a sibling
@@ -18,8 +25,17 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   prediction market: pulls a market's price history from Polymarket's public APIs
   (read-only, no key), enriches with the per-step probability change, and scans —
   sharp probability jumps (`point` / `mv`) and sustained regime shifts in the odds
-  (`coll.cusum`), each mapped back to its UTC timestamp. Also lists the journal
-  example in `examples/README.md` (previously only in the changelog).
+  (`coll.cusum`), each mapped back to its UTC timestamp.
+
+### Documentation
+
+- README's Examples section now lists all four worked examples (stock, journal,
+  polymarket, synergy) with the `agent-calc` synergy called out; the journal
+  example is also listed in `examples/README.md`.
+- New mdbook page **"Worked examples"** (`docs/src/examples.md`) framing the
+  examples as consuming the `tq1` contract.
+- The `anomalyx` binary crate now sets `readme = "../../README.md"`, so the
+  crates.io page renders the project README (it had none before).
 
 ## [1.1.1] - 2026-06-01
 

Cargo.toml

@@ -9,7 +9,7 @@ members = [
 ]
 
 [workspace.package]
-version = "1.1.1"
+version = "1.1.2"
 edition = "2021"
 rust-version = "1.90"
 license = "MIT OR Apache-2.0"
@@ -22,9 +22,9 @@ authors = ["copyleftdev"]
 # `ax-*` names were taken), but the import/extern name stays `ax_core` etc. via
 # the dependency key + `package` rename — so no source code changes are needed.
 # Keep versions in sync with workspace.package.version above.
-ax-core = { path = "crates/ax-core", version = "1.1.1", package = "anomalyx-core" }
-ax-normalize = { path = "crates/ax-normalize", version = "1.1.1", package = "anomalyx-normalize" }
-ax-detect = { path = "crates/ax-detect", version = "1.1.1", package = "anomalyx-detect" }
+ax-core = { path = "crates/ax-core", version = "1.1.2", package = "anomalyx-core" }
+ax-normalize = { path = "crates/ax-normalize", version = "1.1.2", package = "anomalyx-normalize" }
+ax-detect = { path = "crates/ax-detect", version = "1.1.2", package = "anomalyx-detect" }
 
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"

crates/anomalyx/Cargo.toml

@@ -8,6 +8,7 @@ repository.workspace = true
 description = "anomalyx command-line contract surface: describe / schema / scan / explain"
 keywords = ["anomaly-detection", "outlier", "drift", "cli", "data-quality"]
 categories = ["command-line-utilities", "science"]
+readme = "../../README.md"
 
 [[bin]]
 name = "anomalyx"