open-plan-annotator 1.1.3 → 1.1.5

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Interactive plan annotation plugin for Claude Code",
-    "version": "1.1.3"
+    "version": "1.1.5"
   },
   "plugins": [
     {
       "name": "open-plan-annotator",
       "source": "./",
       "description": "Interactive plan annotation UI: review, strikethrough, and comment on Claude's plans before approving. Fully local, no external services.",
-      "version": "1.1.3",
+      "version": "1.1.5",
       "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.1.3",
+  "version": "1.1.5",
   "author": {
     "name": "ndom91"
   },

package/README.md

@@ -1,4 +1,4 @@
-![](.github/assets/header.jpg)
+![](.github/assets/header2.jpg)
 
 [![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)

package/bin/open-plan-annotator.mjs

@@ -8,7 +8,7 @@ import { buildCliHelpText, buildUnknownCommandPrefix } from "../shared/cliHelp.m
 import { resolveCliMode } from "../shared/cliMode.mjs";
 import { detectPackageManager } from "../shared/packageManager.mjs";
 import { resolveRuntimeBinary } from "../shared/runtimeResolver.mjs";
-import { buildUpdateInstructions } from "../shared/updateHints.mjs";
+import { buildUpdateMessage } from "../shared/updateMessage.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8")).version;
@@ -27,7 +27,7 @@ if (cliMode === "help") {
 }
 
 if (cliMode === "doctor") {
-  printDoctor();
+  await printDoctor();
   process.exit(0);
 }
 
@@ -51,7 +51,12 @@ if (cliMode === "hook") {
 }
 
 if (cliMode === "update") {
-  console.log(buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager({ installPath: fileURLToPath(import.meta.url) }) }));
+  console.log(
+    await buildUpdateMessage({
+      currentVersion: VERSION,
+      packageManager: detectPackageManager({ installPath: fileURLToPath(import.meta.url) }),
+    }),
+  );
   process.exit(0);
 }
 
@@ -118,8 +123,10 @@ child.on("error", (err) => {
   process.exit(1);
 });
 
-function printDoctor() {
+async function printDoctor() {
   const platformKey = `${process.platform}-${process.arch}`;
+  const packageManager = detectPackageManager({ installPath: fileURLToPath(import.meta.url) });
+  const latestVersionLine = `update: ${await buildUpdateMessage({ currentVersion: VERSION, packageManager })}`;
 
   try {
     const runtime = resolveRuntimeBinary({ parentUrl: import.meta.url });
@@ -128,7 +135,7 @@ function printDoctor() {
       `platform: ${platformKey}`,
       `runtime package: ${runtime.packageName}`,
       `runtime path: ${runtime.binaryPath}`,
-      `update: ${buildUpdateInstructions({ host: process.env.OPEN_PLAN_HOST, packageManager: detectPackageManager({ installPath: fileURLToPath(import.meta.url) }) })}`,
+      latestVersionLine,
     ].join("\n"));
   } catch (error) {
     console.log([
@@ -136,7 +143,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({ installPath: fileURLToPath(import.meta.url) }) })}`,
+      latestVersionLine,
     ].join("\n"));
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-plan-annotator",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "type": "module",
   "description": "Fully local plugin for interactive plan annotation from your Agentic assistants",
   "author": "ndom91",
@@ -29,8 +29,10 @@
     "shared/cliHelp.mjs",
     "shared/cliMode.mjs",
     "shared/packageManager.mjs",
+    "shared/updateMessage.mjs",
     "shared/runtimeResolver.mjs",
     "shared/updateHints.mjs",
+    "shared/versionInfo.mjs",
     ".claude-plugin/",
     "opencode/bridge.js",
     "opencode/config.js",
@@ -67,9 +69,9 @@
     "@opencode-ai/plugin": "^1.2.14"
   },
   "optionalDependencies": {
-    "@open-plan-annotator/runtime-darwin-arm64": "1.1.3",
-    "@open-plan-annotator/runtime-darwin-x64": "1.1.3",
-    "@open-plan-annotator/runtime-linux-arm64": "1.1.3",
-    "@open-plan-annotator/runtime-linux-x64": "1.1.3"
+    "@open-plan-annotator/runtime-darwin-arm64": "1.1.5",
+    "@open-plan-annotator/runtime-darwin-x64": "1.1.5",
+    "@open-plan-annotator/runtime-linux-arm64": "1.1.5",
+    "@open-plan-annotator/runtime-linux-x64": "1.1.5"
   }
 }

package/shared/updateHints.mjs

@@ -1,14 +1,23 @@
 export function buildUpdateInstructions(options = {}) {
   const host = options.host ?? process.env.OPEN_PLAN_HOST;
   const packageManager = options.packageManager ?? "npm";
+  const version = options.version ?? "latest";
 
   if (host === "opencode") {
-    return "Refresh the OpenCode plugin install, then restart OpenCode.";
+    return "Refresh the OpenCode plugin install and restart OpenCode.";
   }
 
   if (host === "claude-code") {
-    return "Refresh the Claude Code plugin or marketplace install, then restart Claude Code.";
+    return "Refresh the Claude Code plugin or marketplace install and restart Claude Code.";
   }
 
-  return `Update open-plan-annotator via ${packageManager}, then rerun it.`;
+  if (packageManager === "pnpm") {
+    return `Run \`pnpm i -g open-plan-annotator@${version}\`.`;
+  }
+
+  if (packageManager === "bun") {
+    return `Run \`bun add -g open-plan-annotator@${version}\`.`;
+  }
+
+  return `Run \`npm i -g open-plan-annotator@${version}\`.`;
 }

package/shared/updateMessage.mjs

@@ -0,0 +1,25 @@
+import { buildUpdateInstructions } from "./updateHints.mjs";
+import { fetchLatestVersion, isNewerVersion } from "./versionInfo.mjs";
+
+export async function buildUpdateMessage(options = {}) {
+  const currentVersion = options.currentVersion;
+  const packageManager = options.packageManager ?? "npm";
+  const host = options.host ?? process.env.OPEN_PLAN_HOST;
+
+  try {
+    const latestVersion = await fetchLatestVersion();
+    if (currentVersion && isNewerVersion(currentVersion, latestVersion)) {
+      return `latest v${latestVersion}; ${buildUpdateInstructions({ host, packageManager, version: latestVersion })}`;
+    }
+
+    if (currentVersion) {
+      return `latest v${latestVersion}; already up to date`;
+    }
+
+    return buildUpdateInstructions({ host, packageManager, version: latestVersion });
+  } catch {
+    return currentVersion
+      ? `latest unknown; ${buildUpdateInstructions({ host, packageManager })}`
+      : buildUpdateInstructions({ host, packageManager });
+  }
+}

package/shared/versionInfo.mjs

@@ -0,0 +1,85 @@
+const NPM_REGISTRY_BASE_URL = "https://registry.npmjs.org";
+
+export function normalizeVersion(version) {
+  return version.trim().replace(/^v/, "");
+}
+
+function parseSemver(version) {
+  const normalized = normalizeVersion(version);
+  const match = normalized.match(/^([0-9]+)\.([0-9]+)\.([0-9]+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);
+  if (!match) return null;
+
+  return {
+    major: Number.parseInt(match[1], 10),
+    minor: Number.parseInt(match[2], 10),
+    patch: Number.parseInt(match[3], 10),
+    prerelease: match[4] ? match[4].split(".") : [],
+  };
+}
+
+function comparePrereleaseIdentifier(a, b) {
+  const aIsNum = /^[0-9]+$/.test(a);
+  const bIsNum = /^[0-9]+$/.test(b);
+
+  if (aIsNum && bIsNum) {
+    const aNum = Number.parseInt(a, 10);
+    const bNum = Number.parseInt(b, 10);
+    return aNum === bNum ? 0 : aNum > bNum ? 1 : -1;
+  }
+
+  if (aIsNum) return -1;
+  if (bIsNum) return 1;
+  if (a === b) return 0;
+  return a > b ? 1 : -1;
+}
+
+function compareSemver(a, b) {
+  const parsedA = parseSemver(a);
+  const parsedB = parseSemver(b);
+  if (!parsedA || !parsedB) return 0;
+
+  if (parsedA.major !== parsedB.major) return parsedA.major > parsedB.major ? 1 : -1;
+  if (parsedA.minor !== parsedB.minor) return parsedA.minor > parsedB.minor ? 1 : -1;
+  if (parsedA.patch !== parsedB.patch) return parsedA.patch > parsedB.patch ? 1 : -1;
+
+  if (parsedA.prerelease.length === 0 && parsedB.prerelease.length === 0) return 0;
+  if (parsedA.prerelease.length === 0) return 1;
+  if (parsedB.prerelease.length === 0) return -1;
+
+  const maxLen = Math.max(parsedA.prerelease.length, parsedB.prerelease.length);
+  for (let i = 0; i < maxLen; i += 1) {
+    const aPart = parsedA.prerelease[i];
+    const bPart = parsedB.prerelease[i];
+    if (aPart === undefined) return -1;
+    if (bPart === undefined) return 1;
+    const diff = comparePrereleaseIdentifier(aPart, bPart);
+    if (diff !== 0) return diff;
+  }
+
+  return 0;
+}
+
+export function isNewerVersion(current, latest) {
+  const parsedCurrent = parseSemver(current);
+  const parsedLatest = parseSemver(latest);
+  if (!parsedCurrent || !parsedLatest) return false;
+  return compareSemver(latest, current) > 0;
+}
+
+export async function fetchLatestVersion(packageName = "open-plan-annotator") {
+  const response = await fetch(`${NPM_REGISTRY_BASE_URL}/${encodeURIComponent(packageName)}/latest`, {
+    headers: { "User-Agent": "open-plan-annotator-update-check", Accept: "application/json" },
+    signal: AbortSignal.timeout(10_000),
+  });
+
+  if (!response.ok) {
+    throw new Error(`npm registry responded with ${response.status}`);
+  }
+
+  const payload = await response.json();
+  if (!payload || typeof payload !== "object" || typeof payload.version !== "string") {
+    throw new Error("npm registry response did not include a version string");
+  }
+
+  return normalizeVersion(payload.version);
+}