chore(release): prepare v0.28.0

CHANGELOG.md

@@ -6,13 +6,25 @@ details, release history over commit history.
 
 ## Unreleased
 
+## v0.28.0 — 2026-08-09
+
+### Retrieval that preserves lexical relevance
+
+- Constrained relationship-graph ranking to lexical near-ties. A candidate
+  below 85% of the strongest BM25 match keeps its lexical score but receives no
+  graph boost. This prevents a well-connected but weak match from displacing a
+  more relevant decision.
+- Extended `find --explain` with the fixed graph-floor ratio and an `applied` or
+  `clamped` gate result. This makes the ranking decision visible without
+  changing the default `find` response.
+
+### Diagnose missed decisions
+
 - Added `decided diagnose` for deterministic, named-target explain-miss traces,
   including no-match, partial-match, filtering, outranked, and result-window
   truncation reasons.
-- Constrained relationship-graph ranking to lexical near-ties: candidates below
-  85% of the strongest BM25 match keep their lexical score but receive no graph
-  boost. `--explain` now reports the fixed ratio and whether the gate was
-  applied or clamped.
+- Reused the production tokeniser, filters, and ranking path for diagnosis, so
+  the trace explains the result that `find` actually produced.
 
 ## v0.27.0 — 2026-08-08
 

docs/quickstart.md

@@ -30,7 +30,7 @@ In CI, pin a release tag rather than `latest`, or pin by digest for
 immutable builds (the release run prints the pushed digest in its summary):
 
 ```bash
-docker pull ghcr.io/asdecided/core:v0.27.0
+docker pull ghcr.io/asdecided/core:v0.28.0
 docker pull ghcr.io/asdecided/core@sha256:<digest>
 ```
 
@@ -41,7 +41,7 @@ can run script steps):
 ```yaml
 rac-gate:
   image:
-    name: ghcr.io/asdecided/core:v0.27.0
+    name: ghcr.io/asdecided/core:v0.28.0
     entrypoint: [""]
   script:
     - decided gate decisions/
@@ -55,7 +55,7 @@ pipelines:
     '**':
       - step:
           name: decided gate
-          image: ghcr.io/asdecided/core:v0.27.0
+          image: ghcr.io/asdecided/core:v0.28.0
           script:
             - decided gate decisions/
 ```
@@ -64,7 +64,7 @@ Jenkins (declarative pipeline, docker agent):
 
 ```groovy
 pipeline {
-  agent { docker { image 'ghcr.io/asdecided/core:v0.27.0' } }
+  agent { docker { image 'ghcr.io/asdecided/core:v0.28.0' } }
   stages {
     stage('decided gate') {
       steps { sh 'decided gate decisions/' }

rust/Cargo.toml

@@ -3,7 +3,7 @@ resolver = "2"
 members = ["rac-engine", "decided", "decided-mcp"]
 
 [workspace.package]
-version = "0.27.0"
+version = "0.28.0"
 edition = "2021"
 license = "Apache-2.0"
 repository = "https://github.com/asdecided/core"

rust/decided-mcp/Cargo.toml

@@ -13,6 +13,6 @@ categories = ["command-line-utilities", "development-tools"]
 publish = ["crates-io"]
 
 [dependencies]
-rac-engine = { package = "asdecided-core", version = "=0.27.0", path = "../rac-engine" }
+rac-engine = { package = "asdecided-core", version = "=0.28.0", path = "../rac-engine" }
 serde = { version = "1", features = ["derive"] }
 serde_json = { version = "1", features = ["preserve_order"] }

rust/decided/Cargo.toml

@@ -13,4 +13,4 @@ categories = ["command-line-utilities", "development-tools"]
 publish = ["crates-io"]
 
 [dependencies]
-rac-engine = { package = "asdecided-core", version = "=0.27.0", path = "../rac-engine" }
+rac-engine = { package = "asdecided-core", version = "=0.28.0", path = "../rac-engine" }

server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/asdecided/core",
     "source": "github"
   },
-  "version": "0.27.0",
+  "version": "0.28.0",
   "websiteUrl": "https://asdecided.com",
   "packages": [
     {
       "registryType": "oci",
-      "identifier": "ghcr.io/asdecided/core:mcp-v0.27.0",
+      "identifier": "ghcr.io/asdecided/core:mcp-v0.28.0",
       "transport": {
         "type": "stdio"
       }