@umang-boss/claudemon 1.4.0 → 1.5.0

package/bin/claudemon.js

@@ -12,17 +12,25 @@ import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const args = process.argv.slice(2);
 
-// Try compiled JS first (dist/), then fall back to TS with bun
-const distCli = resolve(__dirname, "..", "dist", "cli", "index.js");
+// Try bundled ESM first, then old tsc output, then fall back to TS with bun
+const distCli = resolve(__dirname, "..", "dist", "cli.mjs");
+const distCliLegacy = resolve(__dirname, "..", "dist", "cli", "index.js");
 const srcCli = resolve(__dirname, "..", "cli", "index.ts");
 
 if (existsSync(distCli)) {
-  // Run compiled JS with node
+  // Run bundled ESM with node
   const result = spawnSync("node", [distCli, ...args], {
     stdio: "inherit",
     env: process.env,
   });
   process.exit(result.status ?? 1);
+} else if (existsSync(distCliLegacy)) {
+  // Run legacy tsc-compiled JS with node
+  const result = spawnSync("node", [distCliLegacy, ...args], {
+    stdio: "inherit",
+    env: process.env,
+  });
+  process.exit(result.status ?? 1);
 } else {
   // Fallback: try bun with source TS
   const home = process.env.HOME || "";

package/cli/doctor.ts

@@ -6,12 +6,13 @@
  */
 
 import { access, stat, unlink, readdir, readFile } from "node:fs/promises";
-import { constants as fsConstants } from "node:fs";
+import { constants as fsConstants, existsSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 import { StateManager } from "../src/state/state-manager.js";
 import { PlayerStateSchema } from "../src/state/schemas.js";
+import { checkForUpdate, getCurrentVersion } from "../src/engine/version-check.js";
 
 import type { ClaudeConfig, ClaudeSettings } from "./shared.js";
 import {
@@ -32,7 +33,20 @@ const LOCK_MAX_AGE_MS = 5000;
 const EXPECTED_SPRITE_COUNT = 151;
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const COLORSCRIPT_DIR = resolve(dirname(__dirname), "sprites/colorscripts/small");
+// Sprite dir: check multiple candidate paths (works from source, dist, and npm global)
+function findColorscriptDir(): string | null {
+  const candidates = [
+    resolve(dirname(__dirname), "sprites", "colorscripts", "small"),
+    resolve(dirname(__dirname), "..", "sprites", "colorscripts", "small"),
+    resolve(__dirname, "..", "sprites", "colorscripts", "small"),
+    resolve(__dirname, "..", "..", "sprites", "colorscripts", "small"),
+  ];
+  for (const c of candidates) {
+    if (existsSync(c)) return c;
+  }
+  return null;
+}
+const COLORSCRIPT_DIR = findColorscriptDir();
 
 // ── Helpers ──────────────────────────────────────────────────
 
@@ -236,6 +250,9 @@ async function checkStaleLock(): Promise<CheckResult> {
 
 async function checkSpriteCount(): Promise<CheckResult> {
   try {
+    if (!COLORSCRIPT_DIR) {
+      return { label: "Sprites", passed: false, detail: "colorscripts directory not found" };
+    }
     await access(COLORSCRIPT_DIR, fsConstants.F_OK);
     const entries = await readdir(COLORSCRIPT_DIR);
     const spriteFiles = entries.filter((f) => f.endsWith(".txt"));
@@ -294,6 +311,38 @@ async function checkStateValidity(): Promise<CheckResult> {
   }
 }
 
+// ── Check 12: Version ──────────────────────────────────────────
+
+async function checkVersion(): Promise<CheckResult> {
+  const current = getCurrentVersion();
+  if (current === "unknown") {
+    return { label: "Version", passed: false, detail: "could not determine current version" };
+  }
+
+  try {
+    const result = await checkForUpdate();
+    if (!result) {
+      return {
+        label: "Version",
+        passed: true,
+        detail: `v${current} (could not reach npm registry)`,
+      };
+    }
+
+    if (result.hasUpdate) {
+      return {
+        label: "Version",
+        passed: false,
+        detail: `v${current} (v${result.latest} available — run: npm install -g @umang-boss/claudemon)`,
+      };
+    }
+
+    return { label: "Version", passed: true, detail: `v${current} (latest)` };
+  } catch {
+    return { label: "Version", passed: true, detail: `v${current} (check skipped)` };
+  }
+}
+
 // ── Main ─────────────────────────────────────────────────────
 
 export async function doctor(): Promise<void> {
@@ -303,6 +352,7 @@ export async function doctor(): Promise<void> {
   console.log("");
 
   const checks: CheckResult[] = [
+    await checkVersion(),
     await checkBun(),
     await checkStateDir(),
     await checkStateFile(),

package/cli/index.ts

@@ -1,19 +1,36 @@
 #!/usr/bin/env bun
 /**
  * Claudemon CLI entry point.
- * Routes to install, uninstall, update, or doctor based on first argument.
- *
- * Usage:
- *   npx claudemon install
- *   npx claudemon uninstall
- *   npx claudemon update
- *   npx claudemon doctor
+ * Routes to install, uninstall, update, doctor, or --version.
  */
 
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
 export {};
 const command = process.argv[2];
 
 switch (command) {
+  case "--version":
+  case "-v":
+  case "version": {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pkgPaths = [
+      resolve(__dirname, "..", "package.json"),
+      resolve(__dirname, "..", "..", "package.json"),
+    ];
+    for (const p of pkgPaths) {
+      try {
+        const pkg = JSON.parse(readFileSync(p, "utf-8")) as { version: string };
+        console.log(`claudemon v${pkg.version}`);
+        break;
+      } catch {
+        continue;
+      }
+    }
+    break;
+  }
   case "install":
     await import("./install.js");
     break;
@@ -28,13 +45,14 @@ switch (command) {
     break;
   default:
     console.log(`
-Claudemon — Pokemon Gen 1 coding companion for Claude Code
+Claudemon — Pokemon coding companion for Claude Code
 
 Usage:
   claudemon install     Set up Claudemon (MCP server, hooks, skill, status line)
   claudemon uninstall   Remove Claudemon from Claude Code
   claudemon update      Re-register everything (preserves save data)
   claudemon doctor      Run diagnostics
+  claudemon --version   Show version
 
 After install, start a new Claude Code session and type /buddy
 `);

package/cli/shared.ts

@@ -5,7 +5,8 @@
 
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { existsSync } from "node:fs";
+import { existsSync, constants as fsConstants } from "node:fs";
+import { readFile, writeFile, access as fsAccess } from "node:fs/promises";
 
 // ── Config shape interfaces ──────────────────────────────────
 
@@ -73,11 +74,13 @@ export const STOP_HOOK_SCRIPT = `${PROJECT_DIR}/hooks/stop.sh`;
 export const USER_PROMPT_HOOK_SCRIPT = `${PROJECT_DIR}/hooks/user-prompt-submit.sh`;
 export const STATUSLINE_SCRIPT = `${PROJECT_DIR}/statusline/buddy-status.sh`;
 export const SERVER_ENTRY_TS = `${PROJECT_DIR}/src/server/index.ts`;
-export const SERVER_ENTRY_JS = `${PROJECT_DIR}/dist/src/server/index.js`;
+export const SERVER_ENTRY_JS = `${PROJECT_DIR}/dist/server.mjs`;
+/** Legacy tsc output path — kept for backward compatibility */
+export const SERVER_ENTRY_JS_LEGACY = `${PROJECT_DIR}/dist/src/server/index.js`;
 
-/** Find the best runtime and server entry — prefers bun (fast), falls back to node (compiled JS) */
+/** Find the best runtime — Bun (fastest) > bundled node > legacy node */
 export function getRuntime(): { command: string; serverEntry: string } {
-  // Check for bun (can run .ts directly)
+  // Prefer bun (fastest — native TS, ~120ms startup)
   const bunCandidates = [`${HOME}/.bun/bin/bun`, "/usr/local/bin/bun", "/usr/bin/bun"];
   for (const p of bunCandidates) {
     if (existsSync(p)) {
@@ -85,11 +88,16 @@ export function getRuntime(): { command: string; serverEntry: string } {
     }
   }
 
-  // Fall back to node (needs compiled .js from dist/)
+  // No bun — use bundled ESM with node (~600ms but works everywhere)
   if (existsSync(SERVER_ENTRY_JS)) {
     return { command: "node", serverEntry: SERVER_ENTRY_JS };
   }
 
+  // Fall back to legacy tsc output
+  if (existsSync(SERVER_ENTRY_JS_LEGACY)) {
+    return { command: "node", serverEntry: SERVER_ENTRY_JS_LEGACY };
+  }
+
   // Last resort: assume bun in PATH
   return { command: "bun", serverEntry: SERVER_ENTRY_TS };
 }
@@ -109,10 +117,8 @@ export function info(msg: string): void {
 }
 
 export async function readJson<T>(path: string): Promise<T | null> {
-  const { readFile, access } = await import("node:fs/promises");
-  const { constants } = await import("node:fs");
   try {
-    await access(path, constants.F_OK);
+    await fsAccess(path, fsConstants.F_OK);
     const text = await readFile(path, "utf-8");
     return JSON.parse(text) as T;
   } catch {
@@ -121,6 +127,5 @@ export async function readJson<T>(path: string): Promise<T | null> {
 }
 
 export async function writeJson(path: string, data: unknown): Promise<void> {
-  const { writeFile } = await import("node:fs/promises");
   await writeFile(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
 }