From 4cad17681c9f3ed2483f0fb17d1d81099de6a6ce Mon Sep 17 00:00:00 2001 From: Aryam Goyal Date: Sun, 2 Aug 2026 11:33:59 +0530 Subject: [PATCH] release: FixMap v0.8.5 --- CHANGELOG.md | 22 ++++++++++++++++++++++ README.md | 18 +++++++++++------- apps/web/package.json | 2 +- package-lock.json | 16 ++++++++-------- package.json | 2 +- packages/action/package.json | 4 ++-- packages/cli/package.json | 4 ++-- packages/core/package.json | 2 +- server.json | 4 ++-- 9 files changed, 50 insertions(+), 24 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 302179f..67b29c1 100644 --- 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 index 7cd1674..76bd9a2 100644 --- 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 index f8401c5..3719621 100644 --- 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 index ab45c35..34eab90 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "fixmap-workspace", - "version": "0.8.4", + "version": "0.8.5", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "fixmap-workspace", - "version": "0.8.4", + "version": "0.8.5", "license": "MIT", "workspaces": [ "packages/*", @@ -30,7 +30,7 @@ "name": "@fixmap/web", "version": "0.0.0", "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", @@ -8553,18 +8553,18 @@ }, "packages/action": { "name": "@fixmap/action", - "version": "0.8.4", + "version": "0.8.5", "license": "MIT", "dependencies": { - "@aryam/fixmap-core": "0.8.4" + "@aryam/fixmap-core": "0.8.5" } }, "packages/cli": { "name": "@aryam/fixmap", - "version": "0.8.4", + "version": "0.8.5", "license": "MIT", "dependencies": { - "@aryam/fixmap-core": "0.8.4", + "@aryam/fixmap-core": "0.8.5", "@modelcontextprotocol/sdk": "1.30.0" }, "bin": { @@ -8576,7 +8576,7 @@ }, "packages/core": { "name": "@aryam/fixmap-core", - "version": "0.8.4", + "version": "0.8.5", "license": "MIT", "devDependencies": {}, "engines": { diff --git a/package.json b/package.json index 8947c87..2b5b511 100644 --- 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 index 4793b44..3e11857 100644 --- 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 index 4aa3f89..daa4f49 100644 --- 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 index a3cf043..bd2dd02 100644 --- 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 index b3bcc5c..7007f51 100644 --- 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" },