open-plan-annotator 1.0.13 → 1.0.15

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Interactive plan annotation plugin for Claude Code",
-    "version": "1.0.13"
+    "version": "1.0.15"
   },
   "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.0.13",
+      "version": "1.0.15",
       "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.13",
+  "version": "1.0.15",
   "author": {
     "name": "ndom91"
   },

package/bin/open-plan-annotator.mjs

@@ -4,6 +4,7 @@ import { execFileSync, spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { buildCliHelpText, buildUnknownCommandPrefix } from "../shared/cliHelp.mjs";
 import { resolveCliMode } from "../shared/cliMode.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -20,22 +21,12 @@ if (cliMode === "version") {
 }
 
 if (cliMode === "help") {
-  console.log(`open-plan-annotator v${VERSION}
-
-Usage:
-  open-plan-annotator              Show this help (interactive shell)
-  open-plan-annotator < event.json Run as a Claude Code hook (reads stdin)
-  open-plan-annotator update       Update the binary to the latest version
-  open-plan-annotator upgrade      Alias for update
-  open-plan-annotator --version    Print version
-  open-plan-annotator --help       Show this help
-
-https://github.com/ndom91/open-plan-annotator`);
+  console.log(buildCliHelpText(VERSION));
   process.exit(0);
 }
 
 if (cliMode === "unknown") {
-  console.error(`open-plan-annotator: unknown command \`${arg}\``);
+  console.error(buildUnknownCommandPrefix(arg));
   console.error("Run `open-plan-annotator --help` for usage.");
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-plan-annotator",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "type": "module",
   "description": "Fully local plugin for interactive plan annotation from your Agentic assistants",
   "author": "ndom91",

package/shared/cliHelp.mjs

@@ -0,0 +1,27 @@
+const REPOSITORY_URL = "https://github.com/ndom91/open-plan-annotator";
+
+const HELP_USAGE_LINES = [
+  "open-plan-annotator              Show this help",
+  "open-plan-annotator < event.json Run as a Claude Code hook (debug)",
+  "open-plan-annotator update       Update the binary to the latest version",
+  "open-plan-annotator upgrade      Alias for update",
+  "open-plan-annotator --version    Print version",
+  "open-plan-annotator --help       Show this help",
+];
+
+/**
+ * @param {string} version
+ * @returns {string}
+ */
+export function buildCliHelpText(version) {
+  const usage = HELP_USAGE_LINES.map((line) => `  ${line}`).join("\n");
+  return `open-plan-annotator v${version}\n\nUsage:\n${usage}\n\n${REPOSITORY_URL}`;
+}
+
+/**
+ * @param {string | undefined} command
+ * @returns {string}
+ */
+export function buildUnknownCommandPrefix(command) {
+  return `open-plan-annotator: unknown command \`${command ?? ""}\``;
+}

package/shared/cliHelp.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, test } from "bun:test";
+import { buildCliHelpText, buildUnknownCommandPrefix } from "./cliHelp.mjs";
+
+describe("buildCliHelpText", () => {
+  test("builds canonical help text for all entrypoints", () => {
+    expect(buildCliHelpText("1.2.3")).toBe(`open-plan-annotator v1.2.3
+
+Usage:
+  open-plan-annotator              Show this help
+  open-plan-annotator < event.json Run as a Claude Code hook (debug)
+  open-plan-annotator update       Update the binary to the latest version
+  open-plan-annotator upgrade      Alias for update
+  open-plan-annotator --version    Print version
+  open-plan-annotator --help       Show this help
+
+https://github.com/ndom91/open-plan-annotator`);
+  });
+});
+
+describe("buildUnknownCommandPrefix", () => {
+  test("formats unknown command prefix consistently", () => {
+    expect(buildUnknownCommandPrefix("wat")).toBe("open-plan-annotator: unknown command `wat`");
+  });
+
+  test("handles missing command safely", () => {
+    expect(buildUnknownCommandPrefix(undefined)).toBe("open-plan-annotator: unknown command ``");
+  });
+});