diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 448d10afc..9b4851fda 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "5.4.0"
+  ".": "5.4.1"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a4a06ce16..bff5c7d24 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.4.1](https://github.com/ooples/token-optimizer-mcp/compare/v5.4.0...v5.4.1) (2026-08-05)
+
+
+### Bug Fixes
+
+* **doctor:** report whether finding extraction is actually running ([#247](https://github.com/ooples/token-optimizer-mcp/issues/247)) ([7367250](https://github.com/ooples/token-optimizer-mcp/commit/7367250ecbea9a293a576b7edbe5214b7424b322))
+* **harness:** make the a/b measurement instrument repeatable ([#246](https://github.com/ooples/token-optimizer-mcp/issues/246)) ([219d62a](https://github.com/ooples/token-optimizer-mcp/commit/219d62ad49f7b81c8993791c70486c5d5385795a))
+* **metrics:** the causal measurement had never produced a single reading ([#251](https://github.com/ooples/token-optimizer-mcp/issues/251)) ([516a032](https://github.com/ooples/token-optimizer-mcp/commit/516a032b418c87bc8ee13a5bd6fdd5c0c1b846cd))
+* **release:** unblock the 5.4.0 publish, and stop the harvest worker crashing on exit ([#245](https://github.com/ooples/token-optimizer-mcp/issues/245)) ([1ecd165](https://github.com/ooples/token-optimizer-mcp/commit/1ecd165227cfa6a242ef3fa71f4eeafc710f37ba))
+* **search:** honour `path` and survive oversized result sets ([#249](https://github.com/ooples/token-optimizer-mcp/issues/249)) ([bf3870f](https://github.com/ooples/token-optimizer-mcp/commit/bf3870fcec33e7bf004c734f91b7790f266c3585))
+
 ## [5.4.0](https://github.com/ooples/token-optimizer-mcp/compare/v5.3.6...v5.4.0) (2026-08-04)
 
 
diff --git a/package-lock.json b/package-lock.json
index 7907cfdb1..d0c07ee79 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@ooples/token-optimizer-mcp",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ooples/token-optimizer-mcp",
-      "version": "5.4.0",
+      "version": "5.4.1",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
diff --git a/package.json b/package.json
index 973c6de00..7e991135a 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ooples/token-optimizer-mcp",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "mcpName": "io.github.ooples/token-optimizer-mcp",
   "description": "Intelligent context window optimization for Claude Code - store content externally via caching and compression, freeing up your context window for what matters",
   "main": "dist/server/index.js",
diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json
index 4952d3cec..47afda938 100644
--- a/plugin/.claude-plugin/plugin.json
+++ b/plugin/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "token-optimizer",
   "description": "Aggressive context-window optimization by DEFAULT: enforcing hooks route expensive built-in file, search and shell calls to cached/diffed MCP tools, cutting token usage 60-90% without the user configuring anything.",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "author": {
     "name": "ooples"
   },