aryamthecodebreaker · aryamthecodebreaker · Aug 2, 2026 · Aug 2, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,28 @@ Accuracy figures inside a released entry are the numbers measured **at that rele
 left as written. The current numbers live on the [evidence page](https://usefixmap.vercel.app/evidence),
 which is generated from the recorded results rather than transcribed by hand.
 
+## 0.8.5 - 2026-08-02
+
+### Fixed
+
+- The README, package guide, and website now lead with a proper global installation followed by the short `fixmap plan ...` command. CLI and MCP examples use the installed binary instead of repeating a long npm invocation.
+- The one-off npx path now states that npm may prefer an existing project-local binary. Doctor's exact-request detector is described accurately: it works when Doctor 0.8.4 or newer starts, while an older binary that wins first cannot contain newer diagnostic code. The printed running version is authoritative (#437).
+
+### Evidence
+
+- Reproduced the remaining boundary from a child project containing FixMap 0.8.3: an exact 0.8.4 npm request started the project-local 0.8.3 binary and that older Doctor reported only what its old code knew.
+- Verified the isolated-prefix/direct-shim procedure independently, and verified the installed-command website with web typechecking, lint, and a production build before release validation.
+
+### Installation
+
+```bash
+npm install --global @aryam/fixmap@0.8.5
+fixmap doctor
+fixmap plan --issue https://github.com/chalk/chalk/issues/624
+```
+
+The npm packages, MCP Registry entry, GitHub tag/release, Action tag, and production site must all resolve to 0.8.5 before the release is considered complete.
+
 ## 0.8.4 - 2026-08-02
 
 ### Fixed

diff --git a/README.md b/README.md
@@ -78,8 +78,8 @@ fixmap doctor
 Doctor 0.8.4 and newer compares an exact npm-requested version when that newer Doctor is the process npm starts. An older project-local binary can win before newer Doctor code runs, so no new version can diagnose that decision from inside the old process. Treat the printed running version as authoritative, update or remove the stale installation, or test an exact version in an isolated prefix and invoke that prefix's shim directly. This PowerShell sequence cannot be redirected to an older package in the current directory or one of its parents:
 
 ```powershell
-$fixmapPrefix = Join-Path $env:TEMP "fixmap-cli-0.8.4"
-npm install --global --prefix $fixmapPrefix @aryam/fixmap@0.8.4
+$fixmapPrefix = Join-Path $env:TEMP "fixmap-cli-0.8.5"
+npm install --global --prefix $fixmapPrefix @aryam/fixmap@0.8.5
 & "$fixmapPrefix\fixmap.cmd" --version
 ```
 
@@ -283,8 +283,8 @@ fixmap doctor
 ```text
 # FixMap Doctor
 
-- ok  Running version: 0.8.4
-- PROBLEM  Global install: 0.3.1 (this process is 0.8.4)
+- ok  Running version: 0.8.5
+- PROBLEM  Global install: 0.3.1 (this process is 0.8.5)
     A globally installed fixmap shadows the version npx was asked for. Run
     `npm uninstall -g @aryam/fixmap` or update the global installation. For a
     clean pinned run, use the isolated-prefix command above.
@@ -367,7 +367,7 @@ jobs:
         with:
           fetch-depth: 0
       - id: fixmap
-        uses: aryamthecodebreaker/FixMap@v0.8.4
+        uses: aryamthecodebreaker/FixMap@v0.8.5
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
 ```
@@ -378,7 +378,7 @@ To close the plan→edit→verify loop without leaving GitHub, save the plan as
 
 ```yaml
       - id: plan
-        uses: aryamthecodebreaker/FixMap@v0.8.4
+        uses: aryamthecodebreaker/FixMap@v0.8.5
         with:
           format: json
       - run: echo '${{ steps.plan.outputs.report }}' > fixmap-plan.json
@@ -388,7 +388,7 @@ To close the plan→edit→verify loop without leaving GitHub, save the plan as
           path: fixmap-plan.json
 
       # In a later run, after the fix is pushed:
-      - uses: aryamthecodebreaker/FixMap@v0.8.4
+      - uses: aryamthecodebreaker/FixMap@v0.8.5
         with:
           mode: verify
           report-path: fixmap-plan.json
@@ -471,6 +471,10 @@ Read the full [benchmark methodology and scanner measurements](docs/BENCHMARKS.m
 npm run evaluate:heldout
 ```
 
+## What changed in v0.8.5
+
+v0.8.5 makes the supported installation path unmistakable. Install once with `npm install --global @aryam/fixmap@latest`, then use the short `fixmap plan ...` command everywhere, including MCP setup. The one-off npx form remains documented, but now states that npm may prefer an existing project-local binary. Doctor's output and limitations are described precisely: the running version is authoritative, and an older binary that wins before new code starts cannot contain a newer detector (#437).
+
 ## What changed in v0.8.4
 
 v0.8.4 added an exact-request mismatch detector to Doctor and replaced the earlier npm exec recommendation with an isolated-prefix/direct-shim procedure. A post-release child-project test then established the detector's unavoidable boundary: it works when Doctor 0.8.4 or newer starts, but an older project-local binary can win before newer code runs. The printed running version remains authoritative (#437).

diff --git a/apps/web/package.json b/apps/web/package.json
@@ -15,7 +15,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@aryam/fixmap-core": "0.8.4",
+    "@aryam/fixmap-core": "0.8.5",
     "@phosphor-icons/react": "^2.1.10",
     "next": "16.2.11",
     "react": "19.2.7",

diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "fixmap-workspace",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "private": true,
   "description": "Local-first repo context for coding agents: paste a GitHub issue URL to get ranked files, test routes, and risks.",
   "license": "MIT",

diff --git a/packages/action/package.json b/packages/action/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@fixmap/action",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "GitHub Action wrapper for FixMap pull request reports.",
   "private": true,
   "license": "MIT",
@@ -11,6 +11,6 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@aryam/fixmap-core": "0.8.4"
+    "@aryam/fixmap-core": "0.8.5"
   }
 }
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aryam/fixmap",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "mcpName": "io.github.aryamthecodebreaker/fixmap",
   "description": "Local-first CLI and MCP server mapping GitHub issue URLs, tasks, and diffs to ranked files, tests, and risks.",
   "license": "MIT",
@@ -46,7 +46,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@aryam/fixmap-core": "0.8.4",
+    "@aryam/fixmap-core": "0.8.5",
     "@modelcontextprotocol/sdk": "1.30.0"
   },
   "engines": {

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aryam/fixmap-core",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Deterministic local-first repository scanner, context ranker, and report renderer for coding agents.",
   "license": "MIT",
   "repository": {

diff --git a/server.json b/server.json
@@ -6,12 +6,12 @@
     "url": "https://github.com/aryamthecodebreaker/FixMap",
     "source": "github"
   },
-  "version": "0.8.4",
+  "version": "0.8.5",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@aryam/fixmap",
-      "version": "0.8.4",
+      "version": "0.8.5",
       "transport": {
         "type": "stdio"
       },