@umang-boss/claudemon 1.2.1 → 1.3.0

package/README.md

@@ -24,22 +24,31 @@ fill your Pokedex -- all while you code.
 
 ## Install
 
+**Recommended (global install — persistent):**
+```bash
+npm install -g @umang-boss/claudemon
+claudemon install
+```
+
+**Or quick try (npx — may need reinstall after cache clear):**
 ```bash
 npx @umang-boss/claudemon install
 ```
 
-That's it! Start a new Claude Code session and type `/buddy`.
+Start a new Claude Code session and type `/buddy` to begin!
 
 **Requirements:** Node.js 18+ (Bun optional, auto-detected for faster startup)
 
 ### Other CLI Commands
 
 ```bash
-npx @umang-boss/claudemon doctor     # Check installation health
-npx @umang-boss/claudemon update     # Re-register after updates
-npx @umang-boss/claudemon uninstall  # Remove (preserves save data)
+claudemon doctor     # Check installation health
+claudemon update     # Re-register after updates
+claudemon uninstall  # Remove (preserves save data)
 ```
 
+> **Note:** `npm install -g` is recommended over `npx` because the MCP server path needs to persist. With `npx`, the path points to a temporary cache that may be cleaned up.
+
 ## Commands
 
 Once installed, use `/buddy` in Claude Code:

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

@@ -56,10 +56,32 @@ async function getStarters() {
     catch {
         // No saved options or expired — generate new ones
     }
-    // Generate fresh random 3
+    // Generate fresh random 3 with different primary types
     const seed = hashString(`claudemon-${Date.now()}-${Math.random()}`);
     const shuffled = seededShuffle(STARTER_POOL, seed);
-    const starters = [shuffled[0], shuffled[1], shuffled[2]];
+    const starters = [];
+    const usedTypes = new Set();
+    for (const id of shuffled) {
+        if (starters.length >= 3)
+            break;
+        const pokemon = POKEMON_BY_ID.get(id);
+        if (!pokemon)
+            continue;
+        const primaryType = pokemon.types[0];
+        if (usedTypes.has(primaryType))
+            continue;
+        usedTypes.add(primaryType);
+        starters.push(id);
+    }
+    // Fallback if not enough unique types (shouldn't happen with 39 starters)
+    if (starters.length < 3) {
+        for (const id of shuffled) {
+            if (starters.length >= 3)
+                break;
+            if (!starters.includes(id))
+                starters.push(id);
+        }
+    }
     // Save for consistency until they pick
     try {
         const { writeFile, mkdir } = await import("node:fs/promises");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umang-boss/claudemon",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Pokemon coding companion for Claude Code — Gotta code 'em all!",
   "type": "module",
   "main": "dist/src/server/index.js",
@@ -33,8 +33,7 @@
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "format": "prettier --write \"src/**/*.ts\" \"cli/**/*.ts\" \"scripts/**/*.ts\" \"tests/**/*.ts\" --ignore-unknown",
-    "format:check": "prettier --check \"src/**/*.ts\" \"cli/**/*.ts\" \"scripts/**/*.ts\" \"tests/**/*.ts\" --ignore-unknown",
-    "prepare": "husky"
+    "format:check": "prettier --check \"src/**/*.ts\" \"cli/**/*.ts\" \"scripts/**/*.ts\" \"tests/**/*.ts\" --ignore-unknown"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",

package/src/server/tools/starter.ts

@@ -65,10 +65,29 @@ async function getStarters(): Promise<number[]> {
     // No saved options or expired — generate new ones
   }
 
-  // Generate fresh random 3
+  // Generate fresh random 3 with different primary types
   const seed = hashString(`claudemon-${Date.now()}-${Math.random()}`);
   const shuffled = seededShuffle(STARTER_POOL, seed);
-  const starters = [shuffled[0]!, shuffled[1]!, shuffled[2]!];
+  const starters: number[] = [];
+  const usedTypes = new Set<string>();
+
+  for (const id of shuffled) {
+    if (starters.length >= 3) break;
+    const pokemon = POKEMON_BY_ID.get(id);
+    if (!pokemon) continue;
+    const primaryType = pokemon.types[0];
+    if (usedTypes.has(primaryType)) continue;
+    usedTypes.add(primaryType);
+    starters.push(id);
+  }
+
+  // Fallback if not enough unique types (shouldn't happen with 39 starters)
+  if (starters.length < 3) {
+    for (const id of shuffled) {
+      if (starters.length >= 3) break;
+      if (!starters.includes(id)) starters.push(id);
+    }
+  }
 
   // Save for consistency until they pick
   try {