@umang-boss/claudemon 1.4.0 → 1.4.1

package/cli/doctor.ts

@@ -6,7 +6,7 @@
  */
 
 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";
@@ -32,7 +32,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 +249,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"));

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/dist/cli/doctor.js

@@ -5,7 +5,7 @@
  * Usage: bun run cli/doctor.ts
  */
 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";
@@ -19,7 +19,21 @@ 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() {
+    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();
 function formatCheck(result) {
     const icon = result.passed ? "\u2713" : "\u2717";
     return `[${icon}] ${result.label}: ${result.detail}`;
@@ -188,6 +202,9 @@ async function checkStaleLock() {
 // ── Check 10: Sprite Count ──────────────────────────────────
 async function checkSpriteCount() {
     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"));

package/dist/cli/index.js

@@ -1,16 +1,33 @@
 #!/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";
 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"));
+                console.log(`claudemon v${pkg.version}`);
+                break;
+            }
+            catch {
+                continue;
+            }
+        }
+        break;
+    }
     case "install":
         await import("./install.js");
         break;
@@ -25,16 +42,16 @@ 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
 `);
         break;
 }
-export {};

package/dist/src/hooks/award-xp.js

@@ -44,6 +44,21 @@ const levelUp = addXp(pokemon, xpEvent.xp, pokemonData);
 if (xpEvent.statBoost && xpEvent.boostAmount > 0) {
     applyStatBoost(pokemon, xpEvent.statBoost, xpEvent.boostAmount);
 }
+// XP sharing: give inactive party members a percentage
+const sharePercent = state.config.xpSharePercent ?? 0;
+if (sharePercent > 0 && state.party.length > 1) {
+    const sharedXp = Math.floor((xpEvent.xp * sharePercent) / 100);
+    if (sharedXp > 0) {
+        for (const member of state.party) {
+            if (member.isActive)
+                continue;
+            const memberSpecies = POKEMON_BY_ID.get(member.pokemonId);
+            if (memberSpecies) {
+                addXp(member, sharedXp, memberSpecies);
+            }
+        }
+    }
+}
 // Track total XP earned by the trainer
 state.totalXpEarned += xpEvent.xp;
 // Increment the event counter directly on state (avoids extra save from incrementCounter)

package/dist/src/server/tools/settings.js

@@ -1,12 +1,11 @@
 /**
  * buddy_settings tool — Configure Claudemon settings.
- * Currently supports: encounter-speed (fast | normal | slow).
+ * Supports: encounter-speed, xp-share.
  */
 import { z } from "zod";
 import { StateManager } from "../../state/state-manager.js";
 import { ENCOUNTER_THRESHOLDS } from "../../engine/constants.js";
 const VALID_ENCOUNTER_SPEEDS = ["fast", "normal", "slow"];
-/** Speed descriptions for user-facing messages. */
 const SPEED_DESCRIPTIONS = {
     fast: "Fastest encounters — wild Pokemon appear every ~100 XP",
     normal: "Default pace — wild Pokemon appear every ~250 XP",
@@ -14,9 +13,9 @@ const SPEED_DESCRIPTIONS = {
 };
 /** Registers the buddy_settings tool on the MCP server. */
 export function registerSettingsTool(server) {
-    server.tool("buddy_settings", "Configure Claudemon settings (encounter speed, etc.)", {
-        setting: z.enum(["encounter-speed"]).describe("The setting to configure"),
-        value: z.string().describe("The value to set (for encounter-speed: fast, normal, or slow)"),
+    server.tool("buddy_settings", "Configure Claudemon settings (encounter-speed, xp-share)", {
+        setting: z.enum(["encounter-speed", "xp-share"]).describe("The setting to configure"),
+        value: z.string().describe("The value to set"),
     }, async (params) => {
         const stateManager = StateManager.getInstance();
         const state = await stateManager.load();
@@ -30,6 +29,7 @@ export function registerSettingsTool(server) {
                 ],
             };
         }
+        // ── Encounter Speed ──────────────────────────────────
         if (params.setting === "encounter-speed") {
             const speed = params.value.toLowerCase();
             if (!VALID_ENCOUNTER_SPEEDS.includes(speed)) {
@@ -57,7 +57,7 @@ export function registerSettingsTool(server) {
                     {
                         type: "text",
                         text: [
-                            `Encounter speed updated: ${previousSpeed} -> ${validSpeed}`,
+                            `Encounter speed: ${previousSpeed} → ${validSpeed}`,
                             "",
                             SPEED_DESCRIPTIONS[validSpeed],
                             `XP threshold: ${ENCOUNTER_THRESHOLDS[validSpeed]}`,
@@ -66,12 +66,48 @@ export function registerSettingsTool(server) {
                 ],
             };
         }
-        // Unreachable with the current enum, but guards against future additions
+        // ── XP Share ─────────────────────────────────────────
+        if (params.setting === "xp-share") {
+            const percent = parseInt(params.value, 10);
+            if (isNaN(percent) || percent < 0 || percent > 100) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `Invalid XP share value: "${params.value}"`,
+                                "",
+                                "Enter a number 0-100 (percentage of XP shared to inactive party):",
+                                "  0   — No XP sharing (only active Pokemon earns)",
+                                "  25  — Default (inactive get 25% of earned XP)",
+                                "  50  — Half XP shared to inactive party",
+                                "  100 — Full XP to everyone",
+                            ].join("\n"),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const previous = state.config.xpSharePercent ?? 25;
+            state.config.xpSharePercent = percent;
+            await stateManager.save();
+            const desc = percent === 0
+                ? "Disabled — only active Pokemon earns XP"
+                : `Inactive party members receive ${percent}% of earned XP`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [`XP share: ${previous}% → ${percent}%`, "", desc].join("\n"),
+                    },
+                ],
+            };
+        }
         return {
             content: [
                 {
                     type: "text",
-                    text: `Unknown setting: "${params.setting}". Available settings: encounter-speed`,
+                    text: `Unknown setting: "${params.setting}". Available: encounter-speed, xp-share`,
                 },
             ],
             isError: true,

package/dist/src/state/schemas.js

@@ -48,6 +48,7 @@ export const BuddyConfigSchema = z.object({
     statusLineEnabled: z.boolean().default(true),
     bellEnabled: z.boolean().default(true),
     encounterSpeed: z.enum(["fast", "normal", "slow"]).default("normal"),
+    xpSharePercent: z.number().min(0).max(100).default(25),
 });
 // ---- Pokedex ----
 export const PokedexEntrySchema = z.object({

package/dist/src/state/state-manager.js

@@ -31,6 +31,7 @@ function defaultConfig() {
         statusLineEnabled: true,
         bellEnabled: true,
         encounterSpeed: "normal",
+        xpSharePercent: 25,
     };
 }
 /** Build empty pokedex */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umang-boss/claudemon",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Pokemon coding companion for Claude Code — Gotta code 'em all!",
   "type": "module",
   "main": "dist/src/server/index.js",

package/skills/buddy/SKILL.md

@@ -56,6 +56,7 @@ This ensures first-time users get the starter selection flow automatically.
 | `settings encounter-speed fast` | `buddy_settings` with setting="encounter-speed", value="fast" — fastest encounters (100 XP) |
 | `settings encounter-speed normal` | `buddy_settings` with setting="encounter-speed", value="normal" — default (250 XP) |
 | `settings encounter-speed slow` | `buddy_settings` with setting="encounter-speed", value="slow" — less interruptions (500 XP) |
+| `settings xp-share N` | `buddy_settings` with setting="xp-share", value="N" — share N% XP to inactive party (0-100) |
 | `help` | List all available /buddy commands |
 
 Pass $ARGUMENTS to determine which subcommand to route to.

package/src/engine/types.ts

@@ -254,6 +254,7 @@ export interface BuddyConfig {
   statusLineEnabled: boolean;
   bellEnabled: boolean; // Terminal bell on level-up/encounters
   encounterSpeed: "fast" | "normal" | "slow"; // Configurable encounter frequency
+  xpSharePercent: number; // 0-100, default 25. Percentage of XP shared to inactive party
 }
 
 // ── XP Events (what triggers XP awards) ────────────────────

package/src/hooks/award-xp.ts

@@ -64,6 +64,21 @@ if (xpEvent.statBoost && xpEvent.boostAmount > 0) {
   applyStatBoost(pokemon, xpEvent.statBoost, xpEvent.boostAmount);
 }
 
+// XP sharing: give inactive party members a percentage
+const sharePercent = state.config.xpSharePercent ?? 0;
+if (sharePercent > 0 && state.party.length > 1) {
+  const sharedXp = Math.floor((xpEvent.xp * sharePercent) / 100);
+  if (sharedXp > 0) {
+    for (const member of state.party) {
+      if (member.isActive) continue;
+      const memberSpecies = POKEMON_BY_ID.get(member.pokemonId);
+      if (memberSpecies) {
+        addXp(member, sharedXp, memberSpecies);
+      }
+    }
+  }
+}
+
 // Track total XP earned by the trainer
 state.totalXpEarned += xpEvent.xp;
 

package/src/server/tools/settings.ts

@@ -1,6 +1,6 @@
 /**
  * buddy_settings tool — Configure Claudemon settings.
- * Currently supports: encounter-speed (fast | normal | slow).
+ * Supports: encounter-speed, xp-share.
  */
 
 import { z } from "zod";
@@ -11,7 +11,6 @@ import { ENCOUNTER_THRESHOLDS } from "../../engine/constants.js";
 
 const VALID_ENCOUNTER_SPEEDS: readonly EncounterSpeed[] = ["fast", "normal", "slow"];
 
-/** Speed descriptions for user-facing messages. */
 const SPEED_DESCRIPTIONS: Readonly<Record<EncounterSpeed, string>> = {
   fast: "Fastest encounters — wild Pokemon appear every ~100 XP",
   normal: "Default pace — wild Pokemon appear every ~250 XP",
@@ -22,12 +21,12 @@ const SPEED_DESCRIPTIONS: Readonly<Record<EncounterSpeed, string>> = {
 export function registerSettingsTool(server: McpServer): void {
   server.tool(
     "buddy_settings",
-    "Configure Claudemon settings (encounter speed, etc.)",
+    "Configure Claudemon settings (encounter-speed, xp-share)",
     {
-      setting: z.enum(["encounter-speed"]).describe("The setting to configure"),
-      value: z.string().describe("The value to set (for encounter-speed: fast, normal, or slow)"),
+      setting: z.enum(["encounter-speed", "xp-share"]).describe("The setting to configure"),
+      value: z.string().describe("The value to set"),
     },
-    async (params: { setting: "encounter-speed"; value: string }) => {
+    async (params: { setting: "encounter-speed" | "xp-share"; value: string }) => {
       const stateManager = StateManager.getInstance();
       const state = await stateManager.load();
 
@@ -42,6 +41,7 @@ export function registerSettingsTool(server: McpServer): void {
         };
       }
 
+      // ── Encounter Speed ──────────────────────────────────
       if (params.setting === "encounter-speed") {
         const speed = params.value.toLowerCase();
 
@@ -68,7 +68,6 @@ export function registerSettingsTool(server: McpServer): void {
         const validSpeed = speed as EncounterSpeed;
         const previousSpeed = state.config.encounterSpeed ?? "normal";
         state.config.encounterSpeed = validSpeed;
-
         await stateManager.save();
 
         return {
@@ -76,7 +75,7 @@ export function registerSettingsTool(server: McpServer): void {
             {
               type: "text" as const,
               text: [
-                `Encounter speed updated: ${previousSpeed} -> ${validSpeed}`,
+                `Encounter speed: ${previousSpeed} → ${validSpeed}`,
                 "",
                 SPEED_DESCRIPTIONS[validSpeed],
                 `XP threshold: ${ENCOUNTER_THRESHOLDS[validSpeed]}`,
@@ -86,12 +85,54 @@ export function registerSettingsTool(server: McpServer): void {
         };
       }
 
-      // Unreachable with the current enum, but guards against future additions
+      // ── XP Share ─────────────────────────────────────────
+      if (params.setting === "xp-share") {
+        const percent = parseInt(params.value, 10);
+
+        if (isNaN(percent) || percent < 0 || percent > 100) {
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: [
+                  `Invalid XP share value: "${params.value}"`,
+                  "",
+                  "Enter a number 0-100 (percentage of XP shared to inactive party):",
+                  "  0   — No XP sharing (only active Pokemon earns)",
+                  "  25  — Default (inactive get 25% of earned XP)",
+                  "  50  — Half XP shared to inactive party",
+                  "  100 — Full XP to everyone",
+                ].join("\n"),
+              },
+            ],
+            isError: true,
+          };
+        }
+
+        const previous = state.config.xpSharePercent ?? 25;
+        state.config.xpSharePercent = percent;
+        await stateManager.save();
+
+        const desc =
+          percent === 0
+            ? "Disabled — only active Pokemon earns XP"
+            : `Inactive party members receive ${percent}% of earned XP`;
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: [`XP share: ${previous}% → ${percent}%`, "", desc].join("\n"),
+            },
+          ],
+        };
+      }
+
       return {
         content: [
           {
             type: "text" as const,
-            text: `Unknown setting: "${params.setting}". Available settings: encounter-speed`,
+            text: `Unknown setting: "${params.setting}". Available: encounter-speed, xp-share`,
           },
         ],
         isError: true,

package/src/state/schemas.ts

@@ -71,6 +71,7 @@ export const BuddyConfigSchema = z.object({
   statusLineEnabled: z.boolean().default(true),
   bellEnabled: z.boolean().default(true),
   encounterSpeed: z.enum(["fast", "normal", "slow"]).default("normal"),
+  xpSharePercent: z.number().min(0).max(100).default(25),
 });
 
 // ---- Pokedex ----

package/src/state/state-manager.ts

@@ -56,6 +56,7 @@ function defaultConfig(): BuddyConfig {
     statusLineEnabled: true,
     bellEnabled: true,
     encounterSpeed: "normal",
+    xpSharePercent: 25,
   };
 }