@umang-boss/claudemon 1.3.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/engine/constants.js

@@ -33,8 +33,14 @@ export const STAT_DISPLAY_NAMES = {
     wisdom: "WISDOM",
 };
 // ── Encounter Rate ─────────────────────────────────────────
-/** XP earned between wild encounters */
-export const XP_PER_ENCOUNTER = 500;
+/** XP thresholds for encounter triggers by speed setting */
+export const ENCOUNTER_THRESHOLDS = {
+    fast: 100,
+    normal: 250,
+    slow: 500,
+};
+/** Default encounter speed */
+export const DEFAULT_ENCOUNTER_SPEED = "normal";
 // ── Reaction Cooldown ──────────────────────────────────────
 export const DEFAULT_REACTION_COOLDOWN_MS = 30_000;
 // ── Trainer Titles (by highest Pokemon level) ──────────────
@@ -73,7 +79,7 @@ export const BADGES = [
     {
         type: "lunar",
         name: "Lunar Badge",
-        description: "Maintain a 30-day coding streak — unlocks Moon Stone evolutions",
+        description: "Code for 30 days (weekends off OK) — unlocks Moon Stone evolutions",
         condition: { type: "streak", minDays: 30 },
     },
     {

package/dist/src/engine/encounters.js

@@ -1,9 +1,10 @@
 /**
  * Wild encounter system.
- * Pokemon appear based on coding activity type and are catchable
- * based on the active Pokemon's stats and level.
+ * Pokemon appear based on coding activity type, streak bonuses,
+ * tool diversity, and time-of-day biases. Catch eligibility is
+ * determined by the active Pokemon's stats and level.
  */
-import { XP_PER_ENCOUNTER } from "./constants.js";
+import { ENCOUNTER_THRESHOLDS } from "./constants.js";
 import { POKEMON_BY_ID } from "./pokemon-data.js";
 import { TYPE_POOLS } from "./encounter-pool.js";
 // ── Activity to Pokemon Type Mapping ──────────────────────────
@@ -28,11 +29,40 @@ export function getEncounterTypes(eventType) {
 }
 // ── Encounter Trigger ─────────────────────────────────────────
 /**
- * Check if a wild encounter should trigger based on XP earned since last encounter.
- * Returns true roughly every XP_PER_ENCOUNTER (500) XP.
+ * Check if a wild encounter should trigger based on XP earned,
+ * encounter speed setting, and streak bonus.
+ * Streak bonus: 7+ day streak halves the threshold.
  */
-export function shouldTriggerEncounter(xpSinceLastEncounter) {
-    return xpSinceLastEncounter >= XP_PER_ENCOUNTER;
+export function shouldTriggerEncounter(ctx) {
+    const threshold = ENCOUNTER_THRESHOLDS[ctx.encounterSpeed];
+    // Streak bonus: 7+ day streak = halve the threshold
+    const streakMultiplier = ctx.currentStreak >= 7 ? 0.5 : 1;
+    const effectiveThreshold = Math.floor(threshold * streakMultiplier);
+    if (ctx.xpSinceLastEncounter < effectiveThreshold)
+        return false;
+    return true;
+}
+/** Check for bonus encounter (10% chance after a regular encounter). */
+export function shouldBonusEncounter() {
+    return Math.random() < 0.1;
+}
+/** Check for activity diversity bonus (3+ unique tool types in recent history). */
+export function shouldDiversityBonus(recentToolTypes) {
+    const uniqueTypes = new Set(recentToolTypes);
+    return uniqueTypes.size >= 3;
+}
+// ── Time-of-Day Bias ──────────────────────────────────────────
+/** Get time-of-day type biases for encounter generation. */
+export function getTimeOfDayBias(hour) {
+    if (hour >= 22 || hour < 5)
+        return ["Ghost", "Poison"]; // Night: Ghost types
+    if (hour >= 5 && hour < 9)
+        return ["Grass", "Bug"]; // Morning: Grass types
+    if (hour >= 12 && hour < 14)
+        return ["Fire", "Rock"]; // Midday: Fire types
+    if (hour >= 17 && hour < 20)
+        return ["Water", "Flying"]; // Evening: Water types
+    return []; // No bias
 }
 // ── Rarity Weights ────────────────────────────────────────────
 /** Relative weights for rarity-based selection. Higher = more likely to appear. */
@@ -186,11 +216,21 @@ function determineEncounterLevel(state, seed) {
 /**
  * Generate a wild encounter based on the activity type.
  * Picks a Pokemon from the matching type pool, weighted by rarity.
- * Excludes Pokemon already in the player's party/box (unless duplicates are common tier).
+ * If time-of-day bias types are provided, there is a 40% chance to
+ * use those types instead of the activity-based types.
+ * Excludes Pokemon already in the player's party/box (unless common tier).
  * Returns null if no eligible Pokemon found.
  */
-export function generateEncounter(eventType, state) {
-    const types = getEncounterTypes(eventType);
+export function generateEncounter(eventType, state, timeOfDayTypes) {
+    let types = getEncounterTypes(eventType);
+    // 40% chance to use time-of-day biased types if available
+    if (timeOfDayTypes && timeOfDayTypes.length > 0) {
+        const seed = Math.floor(Date.now() / 1000);
+        const biasRoll = seededRandom(seed + 42);
+        if (biasRoll < 0.4) {
+            types = timeOfDayTypes;
+        }
+    }
     const candidates = buildCandidatePool(types, state);
     if (candidates.length === 0)
         return null;

package/dist/src/engine/mood.js

@@ -0,0 +1,187 @@
+/**
+ * Mood engine for Claudemon.
+ * Pure functions that calculate mood based on recent events, time of day,
+ * and special triggers (evolution, achievements, catches).
+ */
+// ── Mood Decay Durations (milliseconds) ───────────────────
+/** How long each mood lasts before decaying back to neutral */
+const MOOD_DECAY_MS = {
+    happy: 600_000, // 10 minutes
+    worried: 300_000, // 5 minutes
+    sleepy: Infinity, // Resets based on time-of-day, not duration
+    energetic: 900_000, // 15 minutes
+    proud: 600_000, // 10 minutes
+    neutral: Infinity, // Never decays (it IS the default)
+};
+// ── XP Event Types That Trigger Moods ─────────────────────
+const POSITIVE_EVENTS = new Set(["test_pass", "build_success", "commit"]);
+const NEGATIVE_EVENTS = new Set(["test_fail", "build_fail", "error"]);
+// ── Mood Calculation ──────────────────────────────────────
+/**
+ * Calculate the current mood based on recent events, time, and special triggers.
+ *
+ * Priority order:
+ * 1. Sleepy (midnight to 5 AM)
+ * 2. Proud (just evolved/achieved/caught)
+ * 3. Worried (recent negative event)
+ * 4. Happy (recent positive event)
+ * 5. Energetic (morning + active streak)
+ * 6. Keep current mood if it hasn't decayed
+ * 7. Neutral (default fallback)
+ *
+ * @param recentEvent - The last XP event type, or null
+ * @param counters - Current event counters (for context)
+ * @param currentHour - Hour of day (0-23)
+ * @param lastMood - The previous mood
+ * @param moodSetAt - Timestamp when last mood was set
+ * @param hadEvolution - Whether the Pokemon just evolved
+ * @param hadAchievement - Whether the player just unlocked an achievement
+ * @param hadCatch - Whether the player just caught a Pokemon
+ * @returns The calculated mood
+ */
+export function calculateMood(recentEvent, counters, currentHour, lastMood, moodSetAt, hadEvolution, hadAchievement, hadCatch) {
+    // 1. Sleepy: midnight to 5 AM (hours 0-4)
+    if (currentHour >= 0 && currentHour < 5) {
+        return "sleepy";
+    }
+    // 2. Proud: just evolved, achieved, or caught a Pokemon
+    if (hadEvolution || hadAchievement || hadCatch) {
+        return "proud";
+    }
+    // 3. Worried: recent negative event
+    if (recentEvent !== null && NEGATIVE_EVENTS.has(recentEvent)) {
+        return "worried";
+    }
+    // 4. Happy: recent positive event
+    if (recentEvent !== null && POSITIVE_EVENTS.has(recentEvent)) {
+        return "happy";
+    }
+    // 5. Energetic: morning coding (5 AM - 10 AM) with an active streak
+    if (currentHour >= 5 && currentHour < 10) {
+        // Use a simple heuristic: if there have been any sessions, consider it an active streak
+        const hasStreak = counters.sessions > 0;
+        if (hasStreak) {
+            return "energetic";
+        }
+    }
+    // 6. Keep current mood if it hasn't decayed
+    if (!hasMoodDecayed(lastMood, moodSetAt, Date.now())) {
+        return lastMood;
+    }
+    // 7. Default fallback
+    return "neutral";
+}
+/**
+ * Check whether a mood has expired based on its decay duration.
+ *
+ * @param mood - The mood to check
+ * @param setAt - Timestamp when the mood was set
+ * @param now - Current timestamp
+ * @returns true if the mood has decayed (expired)
+ */
+export function hasMoodDecayed(mood, setAt, now) {
+    const duration = MOOD_DECAY_MS[mood];
+    if (duration === Infinity) {
+        // Sleepy decays when it's no longer midnight-5 AM (handled in calculateMood)
+        // Neutral never decays
+        return false;
+    }
+    return now - setAt >= duration;
+}
+// ── Mood Speeches ─────────────────────────────────────────
+/** Mood-specific speech lines for the status line. Name placeholder {name} is replaced at call time. */
+const MOOD_SPEECHES = {
+    happy: [
+        "*{name} is beaming with pride!*",
+        "*{name} does a little victory dance*",
+        "*{name} radiates positive energy*",
+        "*{name} bounces happily*",
+        "*{name} gives you a thumbs up*",
+    ],
+    worried: [
+        "*{name} looks concerned...*",
+        "*{name} nervously watches the errors*",
+        "*{name} hides behind the terminal*",
+        "*{name} paces back and forth*",
+        "*{name} offers you a virtual hug*",
+    ],
+    sleepy: [
+        "*{name} yawns widely*",
+        "*{name} dozes off... zzz*",
+        "*{name} rubs its eyes*",
+        "*{name} curls up near the keyboard*",
+        "*{name} mumbles in its sleep*",
+    ],
+    energetic: [
+        "*{name} is fired up! Let's go!*",
+        "*{name} bounces off the walls*",
+        "*{name} can't sit still!*",
+        "*{name} is ready to code all day!*",
+        "*{name} stretches and flexes*",
+    ],
+    proud: [
+        "*{name} puffs up with pride*",
+        "*{name} strikes a victory pose*",
+        "*{name} shows off to everyone*",
+        "*{name} earned bragging rights!*",
+        "*{name} stands tall and proud*",
+    ],
+    neutral: [
+        "*{name} looks at your code curiously*",
+        "*{name} nods along as you type*",
+        "*{name} is watching closely*",
+        "*{name} hums softly*",
+        "*{name} waits patiently*",
+        "*{name} tilts head at the screen*",
+        "*{name} chirps encouragingly*",
+        "*{name} peers at a variable name*",
+    ],
+};
+/**
+ * Get mood-specific speech messages with the Pokemon's name filled in.
+ *
+ * @param name - The Pokemon's display name
+ * @param mood - The current mood
+ * @returns Array of speech strings with the name interpolated
+ */
+export function getMoodSpeeches(name, mood) {
+    const templates = MOOD_SPEECHES[mood];
+    return templates.map((t) => t.replace("{name}", name));
+}
+// ── Mood Display Helpers ──────────────────────────────────
+/** Emoji representation for each mood */
+const MOOD_EMOJIS = {
+    happy: "\u{1F60A}", // 😊
+    worried: "\u{1F61F}", // 😟
+    sleepy: "\u{1F634}", // 😴
+    energetic: "\u{26A1}", // ⚡
+    proud: "\u{1F451}", // 👑
+    neutral: "\u{1F610}", // 😐
+};
+/** Human-readable mood descriptions */
+const MOOD_DESCRIPTIONS = {
+    happy: "Happy",
+    worried: "Worried",
+    sleepy: "Sleepy",
+    energetic: "Energetic",
+    proud: "Proud",
+    neutral: "Neutral",
+};
+/**
+ * Get the emoji for a mood.
+ *
+ * @param mood - The mood type
+ * @returns The emoji string
+ */
+export function getMoodEmoji(mood) {
+    return MOOD_EMOJIS[mood];
+}
+/**
+ * Get a human-readable description for a mood.
+ *
+ * @param mood - The mood type
+ * @returns The description string (e.g. "Happy")
+ */
+export function getMoodDescription(mood) {
+    return MOOD_DESCRIPTIONS[mood];
+}

package/dist/src/engine/types.js

@@ -2,6 +2,8 @@
  * Core type definitions for Claudemon.
  * Single source of truth for all shared interfaces and types.
  */
+// ── Mood Types ────────────────────────────────────────────
+export const MOOD_TYPES = ["happy", "worried", "sleepy", "energetic", "proud", "neutral"];
 // ── Pokemon Types ──────────────────────────────────────────
 export const POKEMON_TYPES = [
     "Normal",

package/dist/src/gamification/achievements.js

@@ -93,21 +93,21 @@ export const ACHIEVEMENTS = [
     {
         id: "iron_coder",
         name: "Iron Coder",
-        description: "Maintain a 7-day coding streak",
+        description: "Code for 7 days (weekends off OK)",
         category: "coding",
         condition: { type: "streak", minDays: 7 },
     },
     {
         id: "marathon",
         name: "Marathon",
-        description: "Maintain a 30-day coding streak",
+        description: "Code for 30 days (weekends off OK)",
         category: "coding",
         condition: { type: "streak", minDays: 30 },
     },
     {
         id: "centurion",
         name: "Centurion",
-        description: "Maintain a 100-day coding streak",
+        description: "Code for 100 days (weekends off OK)",
         category: "coding",
         condition: { type: "streak", minDays: 100 },
     },

package/dist/src/gamification/legendary-quests.js

@@ -12,7 +12,7 @@ export const LEGENDARY_QUESTS = [
         name: "The Ice Bird of Endurance",
         steps: [
             {
-                description: "Maintain a 30-day coding streak",
+                description: "Code for 30 days (weekends off OK)",
                 condition: { type: "streak", minDays: 30 },
             },
             {
@@ -21,7 +21,7 @@ export const LEGENDARY_QUESTS = [
                 condition: { type: "pokedex", minCaught: 3 },
             },
             {
-                description: "Maintain a 100-day coding streak",
+                description: "Code for 100 days (weekends off OK)",
                 condition: { type: "streak", minDays: 100 },
             },
             {
@@ -105,7 +105,7 @@ export const LEGENDARY_QUESTS = [
         name: "The Myth",
         steps: [
             {
-                description: "Maintain a 100-day coding streak",
+                description: "Code for 100 days (weekends off OK)",
                 condition: { type: "streak", minDays: 100 },
             },
             {
@@ -121,7 +121,7 @@ export const LEGENDARY_QUESTS = [
                 condition: { type: "pokedex", minCaught: 149 },
             },
             {
-                description: "Maintain a 365-day coding streak",
+                description: "Code for 365 days (weekends off OK)",
                 condition: { type: "streak", minDays: 365 },
             },
         ],