open-plan-annotator 1.0.20 → 1.1.1

package/.claude-plugin/marketplace.json

@@ -5,19 +5,14 @@
   },
   "metadata": {
     "description": "Interactive plan annotation plugin for Claude Code",
-    "version": "1.0.20"
+    "version": "1.1.1"
   },
   "plugins": [
     {
       "name": "open-plan-annotator",
-      "source": {
-        "npm": {
-          "package": "open-plan-annotator",
-          "version": "1.0.20"
-        }
-      },
+      "source": "./",
       "description": "Interactive plan annotation UI: review, strikethrough, and comment on Claude's plans before approving. Fully local, no external services.",
-      "version": "1.0.20",
+      "version": "1.1.1",
       "author": {
         "name": "ndom91"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "open-plan-annotator",
   "description": "Interactive plan annotation UI: review, strikethrough, and comment on Claude's plans before approving. Fully local, no external services.",
-  "version": "1.0.20",
+  "version": "1.1.1",
   "author": {
     "name": "ndom91"
   },

package/README.md

@@ -1,14 +1,13 @@
-# open-plan-annotator
+![](.github/assets/header.jpg)
 
-[![npm version](https://img.shields.io/npm/v/open-plan-annotator?style=flat-square)](https://www.npmjs.com/package/open-plan-annotator)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-pink?style=flat-square)]()
+[![npm version](https://img.shields.io/npm/v/open-plan-annotator?style=for-the-badge&labelColor=black&color=black)](https://www.npmjs.com/package/open-plan-annotator)
+[![License: MIT](https://img.shields.io/badge/license-MIT-orange.svg?style=for-the-badge&labelColor=black&color=black)](https://opensource.org/licenses/MIT)
+[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS-pink?style=for-the-badge&labelColor=black&color=black)]()
 
 A fully local agentic coding plugin that intercepts plan mode and opens an annotation UI in your browser. Mark up the plan, send structured feedback to the agent, and receive a revised version — iterate as many times as you need until you're ready to approve.
 
 Select text to <code>strikethrough</code>, <code>replace</code>, <code>insert</code>, or <code>comment</code> — then approve the plan or request changes
 
-![](.github/assets/screenshot.png)
 
 ## How It Works
 
@@ -20,6 +19,8 @@ Select text to <code>strikethrough</code>, <code>replace</code>, <code>insert</c
 
 Everything runs locally. Nothing leaves your machine.
 
+![](.github/assets/screenshot.png)
+
 ## Install
 
 > [!NOTE]
@@ -36,7 +37,7 @@ From within Claude Code, add the marketplace and install the plugin:
 /plugin install open-plan-annotator@ndom91-open-plan-annotator
 ```
 
-This installs the npm-backed plugin and registers the `ExitPlanMode` hook that launches the annotation UI.
+This installs the npm-backed plugin and registers the `ExitPlanMode` hook that launches the annotation UI. In Claude Code, third-party marketplaces have auto-update disabled by default, so also enable auto-update for the `ndom91-open-plan-annotator` marketplace in the Marketplace UI.
 
 ### OpenCode
 
@@ -44,7 +45,7 @@ Add `open-plan-annotator` to the `plugin` array in your OpenCode config (`openco
 
 ```json
 {
-  "plugin": ["open-plan-annotator"]
+  "plugin": ["open-plan-annotator@latest"]
 }
 ```
 
@@ -57,6 +58,9 @@ OpenCode will install the package and load it automatically. The plugin:
 
 To update, refresh the plugin through OpenCode and restart the app so it reloads the latest package-managed runtime.
 
+> [!NOTE]
+> The update mechanism changed significantly in `1.0.20+`: OpenCode now loads the npm package plus a platform runtime package instead of using the old in-place binary updater. If OpenCode appears to be stuck on an older plugin build, clear the cached `open-plan-annotator` entries under `~/.cache/opencode/node_modules/` and restart OpenCode.
+
 #### Implementation Handoff
 
 By default, after a plan is approved the plugin sends "Proceed with implementation." to a `build` agent. To customize or disable this, create `open-plan-annotator.json` in your project's `.opencode/` directory or globally in `~/.config/opencode/`:
@@ -77,6 +81,7 @@ Set `enabled` to `false` to disable auto-handoff. Project config overrides globa
 If you want to run the CLI standalone or install the package globally:
 
 ```sh
+pnpm add -g open-plan-annotator
 npm install -g open-plan-annotator
 ```
 

package/bin/open-plan-annotator.mjs

@@ -6,6 +6,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { buildCliHelpText, buildUnknownCommandPrefix } from "../shared/cliHelp.mjs";
 import { resolveCliMode } from "../shared/cliMode.mjs";
+import { detectPackageManager } from "../shared/packageManager.mjs";
 import { resolveRuntimeBinary } from "../shared/runtimeResolver.mjs";
 import { buildUpdateInstructions } from "../shared/updateHints.mjs";
 
@@ -50,19 +51,10 @@ if (cliMode === "hook") {
 }
 
 if (cliMode === "update") {
-  console.log(buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager() }));
+  console.log(buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager({ installPath: fileURLToPath(import.meta.url) }) }));
   process.exit(0);
 }
 
-// Detect package manager so the binary can suggest the right update command
-function detectPackageManager() {
-  const ua = process.env.npm_config_user_agent || "";
-  if (ua.startsWith("pnpm")) return "pnpm";
-  if (ua.startsWith("yarn")) return "yarn";
-  if (ua.startsWith("bun")) return "bun";
-  return "npm";
-}
-
 let runtime;
 try {
   runtime = resolveRuntimeBinary({ parentUrl: import.meta.url });
@@ -77,7 +69,7 @@ const child = spawn(runtime.binaryPath, process.argv.slice(2), {
   env: {
     ...process.env,
     OPEN_PLAN_HOST: process.env.OPEN_PLAN_HOST || "claude-code",
-    OPEN_PLAN_PKG_MANAGER: detectPackageManager(),
+    OPEN_PLAN_PKG_MANAGER: detectPackageManager({ installPath: fileURLToPath(import.meta.url) }),
   },
 });
 
@@ -136,7 +128,7 @@ function printDoctor() {
       `platform: ${platformKey}`,
       `runtime package: ${runtime.packageName}`,
       `runtime path: ${runtime.binaryPath}`,
-      `update: ${buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager() })}`,
+      `update: ${buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager({ installPath: fileURLToPath(import.meta.url) }) })}`,
     ].join("\n"));
   } catch (error) {
     console.log([
@@ -144,7 +136,7 @@ function printDoctor() {
       `platform: ${platformKey}`,
       `runtime: missing`,
       `error: ${error instanceof Error ? error.message : String(error)}`,
-      `update: ${buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager() })}`,
+      `update: ${buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager({ installPath: fileURLToPath(import.meta.url) }) })}`,
     ].join("\n"));
   }
 }

package/opencode/bridge.js

@@ -3,6 +3,7 @@ import { randomUUID } from "node:crypto";
 import { existsSync, statSync } from "node:fs";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { detectPackageManager } from "../shared/packageManager.mjs";
 import { resolveRuntimeBinary } from "../shared/runtimeResolver.mjs";
 
 const PKG_ROOT = fileURLToPath(new URL("..", import.meta.url));
@@ -98,14 +99,6 @@ function validateHookOutput(value) {
   throw new Error("unsupported decision payload");
 }
 
-function detectPackageManager() {
-  const ua = process.env.npm_config_user_agent || "";
-  if (ua.startsWith("pnpm")) return "pnpm";
-  if (ua.startsWith("yarn")) return "yarn";
-  if (ua.startsWith("bun")) return "bun";
-  return "npm";
-}
-
 /**
  * @param {{ plan: string, sessionId?: string, cwd?: string }} options
  */
@@ -134,7 +127,8 @@ export async function runPlanReview(options) {
       env: {
         ...process.env,
         OPEN_PLAN_HOST: "opencode",
-        OPEN_PLAN_PKG_MANAGER: process.env.OPEN_PLAN_PKG_MANAGER || detectPackageManager(),
+        OPEN_PLAN_PKG_MANAGER:
+          process.env.OPEN_PLAN_PKG_MANAGER || detectPackageManager({ installPath: fileURLToPath(import.meta.url) }),
       },
       detached: true,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-plan-annotator",
-  "version": "1.0.20",
+  "version": "1.1.1",
   "type": "module",
   "description": "Fully local plugin for interactive plan annotation from your Agentic assistants",
   "author": "ndom91",
@@ -37,10 +37,10 @@
     "test": "bun test",
     "typecheck": "tsgo --noEmit --project ui/tsconfig.json && tsgo --noEmit --project server/tsconfig.json",
     "build:ui": "cd ui && bun run vite build",
-    "build:platforms": "node scripts/build-platforms.mjs",
-    "build": "bun run build:ui && node scripts/build-platforms.mjs",
+    "build:platforms": "bun scripts/build-platforms.mjs",
+    "build": "bun run build:ui && bun run build:platforms",
     "release": "bun run build",
-    "pack:check": "node scripts/check-package-files.mjs",
+    "pack:check": "bun scripts/check-package-files.mjs",
     "dev:ui": "cd ui && bun run vite --port 5173",
     "dev:server": "NODE_ENV=development bun run server/index.ts",
     "dev": "NODE_ENV=development bun run server/index.ts & cd ui && bun run vite --port 5173",
@@ -48,11 +48,11 @@
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
     "do-release": "./scripts/release.sh",
-    "prepack": "node scripts/claude-pack-docs.mjs prepack",
-    "postpack": "node scripts/claude-pack-docs.mjs postpack"
+    "prepack": "bun scripts/claude-pack-docs.mjs prepack",
+    "postpack": "bun scripts/claude-pack-docs.mjs postpack"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.4",
+    "@biomejs/biome": "^2.4.6",
     "@types/node": "^25.3.0",
     "@types/bun": "^1.3.9",
     "@typescript/native-preview": "^7.0.0-dev.20260224.1"
@@ -61,9 +61,10 @@
     "@opencode-ai/plugin": "^1.2.14"
   },
   "optionalDependencies": {
-    "@open-plan-annotator/runtime-darwin-arm64": "1.0.20",
-    "@open-plan-annotator/runtime-darwin-x64": "1.0.20",
-    "@open-plan-annotator/runtime-linux-arm64": "1.0.20",
-    "@open-plan-annotator/runtime-linux-x64": "1.0.20"
-  }
+    "@open-plan-annotator/runtime-darwin-arm64": "1.1.1",
+    "@open-plan-annotator/runtime-darwin-x64": "1.1.1",
+    "@open-plan-annotator/runtime-linux-arm64": "1.1.1",
+    "@open-plan-annotator/runtime-linux-x64": "1.1.1"
+  },
+  "packageManager": "bun@1.3.9"
 }

package/shared/packageManager.mjs

@@ -0,0 +1,39 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+function detectFromValue(value) {
+  if (!value) return undefined;
+  const normalized = value.toLowerCase();
+  if (normalized.includes("pnpm")) return "pnpm";
+  if (normalized.includes("yarn")) return "yarn";
+  if (normalized.includes("bun")) return "bun";
+  if (normalized.includes("npm")) return "npm";
+  return undefined;
+}
+
+export function detectPackageManager(options = {}) {
+  const env = options.env ?? process.env;
+  const installPath = options.installPath;
+
+  const explicit = detectFromValue(env.OPEN_PLAN_PKG_MANAGER);
+  if (explicit) return explicit;
+
+  const userAgent = env.npm_config_user_agent;
+  if (typeof userAgent === "string") {
+    const name = userAgent.split("/")[0];
+    const detected = detectFromValue(name);
+    if (detected) return detected;
+  }
+
+  const packageManager = detectFromValue(env.npm_package_manager);
+  if (packageManager) return packageManager;
+
+  const execPath = detectFromValue(env.npm_execpath);
+  if (execPath) return execPath;
+
+  const resolvedInstallPath = installPath ?? fileURLToPath(import.meta.url);
+  const pathHint = detectFromValue(path.normalize(resolvedInstallPath));
+  if (pathHint) return pathHint;
+
+  return "npm";
+}

package/shared/packageManager.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, test } from "bun:test";
+import { detectPackageManager } from "./packageManager.mjs";
+
+describe("detectPackageManager", () => {
+  test("prefers explicit OPEN_PLAN_PKG_MANAGER", () => {
+    expect(detectPackageManager({ env: { OPEN_PLAN_PKG_MANAGER: "pnpm" } })).toBe("pnpm");
+  });
+
+  test("detects package manager from npm user agent", () => {
+    expect(detectPackageManager({ env: { npm_config_user_agent: "pnpm/10.0.0 node/v22.0.0" } })).toBe("pnpm");
+  });
+
+  test("detects package manager from npm execpath", () => {
+    expect(detectPackageManager({ env: { npm_execpath: "/usr/local/lib/node_modules/pnpm/bin/pnpm.cjs" } })).toBe(
+      "pnpm",
+    );
+  });
+
+  test("detects package manager from install path hints", () => {
+    expect(
+      detectPackageManager({
+        env: {},
+        installPath: "/Users/test/Library/pnpm/global/5/node_modules/open-plan-annotator/bin/open-plan-annotator.mjs",
+      }),
+    ).toBe("pnpm");
+  });
+
+  test("falls back to npm", () => {
+    expect(detectPackageManager({ env: {}, installPath: "/tmp/open-plan-annotator/bin/open-plan-annotator.mjs" })).toBe(
+      "npm",
+    );
+  });
+});