@umang-boss/claudemon 1.0.0

package/src/server/tools/catch.ts

@@ -0,0 +1,295 @@
+/**
+ * buddy_catch tool — Attempt to catch a wild Pokemon from a pending encounter.
+ * Preview mode checks requirements only; confirm mode rolls against catch rate.
+ */
+
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OwnedPokemon, CodingStat, WildEncounter } from "../../engine/types.js";
+import { POKEMON_BY_ID } from "../../engine/pokemon-data.js";
+import { BELL, MAX_PARTY_SIZE, STAT_DISPLAY_NAMES } from "../../engine/constants.js";
+import { initCodingStats } from "../../engine/stats.js";
+import { canCatch } from "../../engine/encounters.js";
+import { checkNewAchievements, unlockAchievement } from "../../gamification/achievements.js";
+import { StateManager } from "../../state/state-manager.js";
+import { formatTypes, pad } from "./display-helpers.js";
+
+/** Check only the stat/level requirements without the catch-rate roll. */
+function meetsRequirements(
+  encounter: WildEncounter,
+  activePokemon: OwnedPokemon,
+): { met: boolean; reason: string } {
+  const species = POKEMON_BY_ID.get(encounter.pokemonId);
+  if (!species) return { met: false, reason: "Unknown Pokemon" };
+
+  const { requiredStat, minStatValue, requiredLevel } = encounter.catchCondition;
+
+  if (activePokemon.level < requiredLevel) {
+    return {
+      met: false,
+      reason: `Need level ${requiredLevel} to catch ${species.rarity} Pokemon (currently level ${activePokemon.level})`,
+    };
+  }
+
+  if (requiredStat !== null) {
+    const currentStat = activePokemon.codingStats[requiredStat as CodingStat];
+    if (currentStat < minStatValue) {
+      return {
+        met: false,
+        reason: `Need ${requiredStat.toUpperCase()} at ${minStatValue} to catch this Pokemon (currently ${currentStat})`,
+      };
+    }
+  }
+
+  return { met: true, reason: "" };
+}
+
+/** Registers the buddy_catch tool on the MCP server. */
+export function registerCatchTool(server: McpServer): void {
+  server.tool(
+    "buddy_catch",
+    "Attempt to catch a wild Pokemon from a pending encounter.",
+    { confirm: z.boolean().optional() },
+    async (params) => {
+      const stateManager = StateManager.getInstance();
+      const state = await stateManager.load();
+
+      if (!state || state.party.length === 0) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const encounter = state.pendingEncounter;
+      if (!encounter) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "No wild Pokemon nearby! Keep coding and one will appear.",
+            },
+          ],
+        };
+      }
+
+      const species = POKEMON_BY_ID.get(encounter.pokemonId);
+      if (!species) {
+        stateManager.clearPendingEncounter();
+        await stateManager.save();
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "The wild Pokemon vanished into the tall grass...",
+            },
+          ],
+        };
+      }
+
+      const active = stateManager.getActivePokemon();
+      if (!active) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "No active Pokemon found in your party.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const typeStr = formatTypes(species.types);
+      const { catchCondition } = encounter;
+
+      // Build condition description
+      const conditionParts: string[] = [];
+      if (catchCondition.requiredLevel > 1) {
+        conditionParts.push(`Level ${catchCondition.requiredLevel}+`);
+      }
+      if (catchCondition.requiredStat !== null) {
+        const statName = STAT_DISPLAY_NAMES[catchCondition.requiredStat as CodingStat];
+        conditionParts.push(`${statName} >= ${catchCondition.minStatValue}`);
+      }
+      const conditionStr = conditionParts.length > 0 ? conditionParts.join(", ") : "None";
+
+      // Check stat/level requirements (does NOT roll catch rate)
+      const reqCheck = meetsRequirements(encounter, active);
+
+      // Requirements not met — Pokemon flees
+      if (!reqCheck.met) {
+        const W = 42;
+        const border = "\u2500".repeat(W);
+        const lines: string[] = [];
+
+        lines.push(`\u250c${border}\u2510`);
+        lines.push(`\u2502  ${pad(`Wild ${species.name} appeared!`, W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad(`Type: ${typeStr}   Lv.${encounter.level}`, W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad(`Catch req: ${conditionStr}`, W - 2)}\u2502`);
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+        lines.push(`\u2502  ${pad(reqCheck.reason, W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad("It fled! Keep leveling up.", W - 2)}\u2502`);
+        lines.push(`\u2514${border}\u2518`);
+
+        // Clear encounter on flee
+        stateManager.clearPendingEncounter();
+        await stateManager.save();
+
+        return {
+          content: [{ type: "text" as const, text: lines.join("\n") }],
+        };
+      }
+
+      // Requirements met — show preview (no confirm) or attempt catch (confirm=true)
+      if (!params.confirm) {
+        const W = 42;
+        const border = "\u2500".repeat(W);
+        const lines: string[] = [];
+
+        lines.push(`\u250c${border}\u2510`);
+        lines.push(`\u2502  ${pad(`Wild ${species.name} appeared!`, W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad(`Type: ${typeStr}   Lv.${encounter.level}`, W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad(`Catch req: ${conditionStr}`, W - 2)}\u2502`);
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+        lines.push(`\u2502  ${pad(`Rarity: ${species.rarity}`, W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad(`"${species.description}"`, W - 2)}\u2502`);
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+        lines.push(`\u2502  ${pad("Use /buddy catch confirm to throw a Pokeball!", W - 2)}\u2502`);
+        lines.push(`\u2514${border}\u2518`);
+
+        return {
+          content: [{ type: "text" as const, text: lines.join("\n") }],
+        };
+      }
+
+      // Confirm — roll against catch rate via canCatch()
+      const catchResult = canCatch(encounter, active);
+
+      if (!catchResult.success) {
+        // Catch rate roll failed — broke free
+        const W = 42;
+        const border = "\u2500".repeat(W);
+        const lines: string[] = [];
+
+        lines.push(`\u250c${border}\u2510`);
+        lines.push(`\u2502  ${pad(`You threw a Pokeball at ${species.name}!`, W - 2)}\u2502`);
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+        lines.push(`\u2502  ${pad(catchResult.reason, W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad("Better luck next time...", W - 2)}\u2502`);
+        lines.push(`\u2514${border}\u2518`);
+
+        // Clear encounter on failed catch
+        stateManager.clearPendingEncounter();
+        await stateManager.save();
+
+        return {
+          content: [{ type: "text" as const, text: lines.join("\n") }],
+        };
+      }
+
+      // Catch succeeded — create OwnedPokemon
+      const now = new Date().toISOString();
+      const newPokemon: OwnedPokemon = {
+        id: crypto.randomUUID(),
+        pokemonId: encounter.pokemonId,
+        nickname: null,
+        level: encounter.level,
+        currentXp: 0,
+        totalXp: 0,
+        codingStats: initCodingStats(species.baseStats),
+        happiness: 70,
+        caughtAt: now,
+        evolvedAt: null,
+        isActive: false,
+        personality: null,
+        shiny: false,
+        isStarter: false,
+      };
+
+      // Add to party or PC box
+      let placedIn: "party" | "pcBox";
+      if (state.party.length < MAX_PARTY_SIZE) {
+        state.party.push(newPokemon);
+        placedIn = "party";
+      } else {
+        state.pcBox.push(newPokemon);
+        placedIn = "pcBox";
+      }
+
+      // Update pokedex
+      const existingEntry = state.pokedex.entries[encounter.pokemonId];
+      if (existingEntry) {
+        if (!existingEntry.caught) {
+          existingEntry.caught = true;
+          existingEntry.firstCaught = now;
+          state.pokedex.totalCaught += 1;
+        }
+      } else {
+        state.pokedex.entries[encounter.pokemonId] = {
+          seen: true,
+          caught: true,
+          firstSeen: now,
+          firstCaught: now,
+        };
+        state.pokedex.totalSeen += 1;
+        state.pokedex.totalCaught += 1;
+      }
+
+      // Clear pending encounter
+      stateManager.clearPendingEncounter();
+
+      // Check for new achievements
+      const newAchievements = checkNewAchievements(state);
+      for (const achievement of newAchievements) {
+        state.achievements.push(unlockAchievement(achievement.id));
+      }
+
+      // Save state
+      await stateManager.save();
+      await stateManager.writeStatus();
+
+      // Build celebration message
+      const W = 42;
+      const border = "\u2500".repeat(W);
+      const lines: string[] = [];
+
+      lines.push(`\u250c${border}\u2510`);
+      lines.push(`\u2502  ${pad(`Gotcha! ${species.name} was caught!`, W - 2)}\u2502`);
+      lines.push(`\u2502  ${pad(`Type: ${typeStr}   Lv.${encounter.level}`, W - 2)}\u2502`);
+      lines.push(`\u2502${" ".repeat(W)}\u2502`);
+
+      if (placedIn === "party") {
+        lines.push(`\u2502  ${pad(`${species.name} joined your party!`, W - 2)}\u2502`);
+      } else {
+        lines.push(`\u2502  ${pad(`Party full! Sent to PC Box.`, W - 2)}\u2502`);
+      }
+
+      lines.push(`\u2502  ${pad(`Pokedex: ${state.pokedex.totalCaught}/151 caught`, W - 2)}\u2502`);
+      lines.push(`\u2514${border}\u2518`);
+
+      // Show new achievements
+      if (newAchievements.length > 0) {
+        lines.push("");
+        for (const achievement of newAchievements) {
+          lines.push(`*** Achievement unlocked: ${achievement.name}! ***`);
+          lines.push(`    ${achievement.description}`);
+        }
+      }
+
+      // Terminal bell
+      if (state.config.bellEnabled) {
+        process.stderr.write(BELL);
+      }
+
+      return {
+        content: [{ type: "text" as const, text: lines.join("\n") }],
+      };
+    },
+  );
+}

package/src/server/tools/display-helpers.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared display helper functions used across multiple tool files.
+ * Centralizes formatting logic to eliminate duplication.
+ */
+
+import type { CodingStat, BaseStats } from "../../engine/types.js";
+import { BASE_STAT_TO_CODING } from "../../engine/types.js";
+
+/** Format a Pokemon type array for display (e.g., "Fire/Flying"). */
+export function formatTypes(types: readonly [string, string?]): string {
+  return types.filter(Boolean).join("/");
+}
+
+/** Right-pad a string to a fixed width, truncating if needed. */
+export function pad(str: string, width: number): string {
+  if (str.length >= width) {
+    return str.slice(0, width);
+  }
+  return str + " ".repeat(width - str.length);
+}
+
+/** Render a compact XP progress bar using Unicode block characters. */
+export function renderXpBar(percent: number, width: number = 20): string {
+  const filled = Math.round((percent / 100) * width);
+  const empty = width - filled;
+  return "\u2588".repeat(filled) + "\u2591".repeat(empty);
+}
+
+/**
+ * Inverted BASE_STAT_TO_CODING map: coding stat -> base stat key.
+ * Used for stat comparison during evolution preview and Pokedex display.
+ */
+export const CODING_TO_BASE: Record<CodingStat, keyof BaseStats> = Object.fromEntries(
+  Object.entries(BASE_STAT_TO_CODING).map(([base, coding]) => [coding, base]),
+) as Record<CodingStat, keyof BaseStats>;

package/src/server/tools/evolve.ts

@@ -0,0 +1,236 @@
+/**
+ * buddy_evolve tool — Evolve the active Pokemon when eligible.
+ * Shows a preview with stat comparison, or applies the evolution on confirm.
+ */
+
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { EvolutionMethod, CodingStat } from "../../engine/types.js";
+import { CODING_STATS } from "../../engine/types.js";
+import { POKEMON_BY_ID } from "../../engine/pokemon-data.js";
+import { STAT_DISPLAY_NAMES, BELL, BADGES } from "../../engine/constants.js";
+import { renderStatBar } from "../../engine/stats.js";
+import {
+  checkEvolution,
+  applyEvolution,
+  getEvolutionLinks,
+  getNewlyEarnedBadges,
+} from "../../engine/evolution.js";
+import { StateManager } from "../../state/state-manager.js";
+import { formatTypes, pad, CODING_TO_BASE } from "./display-helpers.js";
+
+/** Describe an evolution method in human-readable text. */
+function describeMethod(method: EvolutionMethod): string {
+  switch (method.type) {
+    case "level":
+      return `Reach Lv.${method.level}`;
+    case "badge": {
+      const badgeDef = BADGES.find((b) => b.type === method.badge);
+      const badgeName = badgeDef ? badgeDef.name : method.badge;
+      return `Earn the ${badgeName}`;
+    }
+    case "collaboration":
+      return "Merge 10 PRs (collaboration evolution)";
+    case "stat":
+      return `Reach Lv.25 with ${STAT_DISPLAY_NAMES[method.stat]} >= ${method.minValue}`;
+  }
+}
+
+/** Registers the buddy_evolve tool on the MCP server. */
+export function registerEvolveTool(server: McpServer): void {
+  server.tool(
+    "buddy_evolve",
+    "Evolve your active Pokemon if it meets the evolution requirements.",
+    { confirm: z.boolean().optional() },
+    async (params) => {
+      const stateManager = StateManager.getInstance();
+      const state = await stateManager.load();
+
+      if (!state || state.party.length === 0) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const active = stateManager.getActivePokemon();
+      if (!active) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "No active Pokemon found in your party.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const species = POKEMON_BY_ID.get(active.pokemonId);
+      if (!species) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Could not find species data for Pokemon ID ${active.pokemonId}.`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      // Check for newly earned badges before evolution check
+      const newBadges = getNewlyEarnedBadges(state);
+      const badgeLines: string[] = [];
+      if (newBadges.length > 0) {
+        for (const badge of newBadges) {
+          state.badges.push(badge);
+          const badgeDef = BADGES.find((b) => b.type === badge);
+          const badgeName = badgeDef ? badgeDef.name : badge;
+          badgeLines.push(`*** New badge earned: ${badgeName}! ***`);
+        }
+        await stateManager.save();
+      }
+
+      // Check evolution eligibility
+      const eligibleLink = checkEvolution(active, state);
+
+      if (!eligibleLink) {
+        // Not eligible — explain what's needed
+        const links = getEvolutionLinks(active.pokemonId);
+        const displayName = active.nickname ?? species.name;
+        const lines: string[] = [];
+
+        if (badgeLines.length > 0) {
+          lines.push(...badgeLines, "");
+        }
+
+        if (links.length === 0) {
+          lines.push(`${displayName} does not evolve.`);
+        } else {
+          lines.push(`${displayName} is not ready to evolve yet.`);
+          lines.push("");
+          lines.push("Evolution requirements:");
+          for (const link of links) {
+            const target = POKEMON_BY_ID.get(link.to);
+            const targetName = target ? target.name : `#${link.to}`;
+            lines.push(`  -> ${targetName}: ${describeMethod(link.method)}`);
+          }
+          lines.push("");
+          lines.push(`Current level: ${active.level}`);
+        }
+
+        return {
+          content: [{ type: "text" as const, text: lines.join("\n") }],
+        };
+      }
+
+      const targetSpecies = POKEMON_BY_ID.get(eligibleLink.to);
+      if (!targetSpecies) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Could not find target species data for Pokemon ID ${eligibleLink.to}.`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const displayName = active.nickname ?? species.name;
+
+      // Preview mode: show what the evolution will look like
+      if (!params.confirm) {
+        const W = 42;
+        const border = "\u2500".repeat(W);
+        const lines: string[] = [];
+
+        if (badgeLines.length > 0) {
+          lines.push(...badgeLines, "");
+        }
+
+        lines.push(`\u250c${border}\u2510`);
+        lines.push(`\u2502  ${pad(`What? ${displayName} is evolving!`, W - 2)}\u2502`);
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+        lines.push(`\u2502  ${pad(`${species.name}  \u2192  ${targetSpecies.name}`, W - 2)}\u2502`);
+        lines.push(
+          `\u2502  ${pad(`${formatTypes(species.types)}     ${formatTypes(targetSpecies.types)}`, W - 2)}\u2502`,
+        );
+        lines.push(`\u2502  ${pad(`Lv.${active.level}`, W - 2)}\u2502`);
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+        lines.push(`\u2502  ${pad("New base stats:", W - 2)}\u2502`);
+
+        // Show stat comparison (new base vs current)
+        for (const stat of CODING_STATS) {
+          const currentValue = active.codingStats[stat as CodingStat];
+          const label = STAT_DISPLAY_NAMES[stat as CodingStat].padEnd(10);
+          // Calculate what new stat would be after evolution (preview)
+          const oldBaseContrib = Math.floor(
+            species.baseStats[CODING_TO_BASE[stat as CodingStat]] * 0.5,
+          );
+          const activityBonus = Math.max(0, currentValue - oldBaseContrib);
+          const newBaseContrib = Math.floor(
+            targetSpecies.baseStats[CODING_TO_BASE[stat as CodingStat]] * 0.5,
+          );
+          const newValue = newBaseContrib + activityBonus;
+          const bar = renderStatBar(newValue);
+          const delta = newValue !== currentValue ? ` (was ${currentValue})` : "";
+          lines.push(
+            `\u2502  ${pad(`${label} ${bar}  ${String(newValue).padStart(3)}${delta}`, W - 2)}\u2502`,
+          );
+        }
+
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+        lines.push(`\u2502  ${pad("Use /buddy evolve confirm to proceed", W - 2)}\u2502`);
+        lines.push(`\u2502  ${pad("(or don't -- like pressing B!)", W - 2)}\u2502`);
+        lines.push(`\u2514${border}\u2518`);
+
+        return {
+          content: [{ type: "text" as const, text: lines.join("\n") }],
+        };
+      }
+
+      // Confirm mode: apply evolution
+      const { newName, newTypes } = applyEvolution(active, eligibleLink.to);
+
+      // Save state
+      await stateManager.save();
+      await stateManager.writeStatus();
+
+      // Build celebration message
+      const lines: string[] = [];
+
+      if (badgeLines.length > 0) {
+        lines.push(...badgeLines, "");
+      }
+
+      lines.push(`Congratulations! ${displayName} evolved into ${newName}!`);
+      lines.push(`Type: ${formatTypes(newTypes as readonly [string, string?])}`);
+      lines.push("");
+
+      // Show new stats
+      lines.push("Updated stats:");
+      for (const stat of CODING_STATS) {
+        const value = active.codingStats[stat as CodingStat];
+        const label = STAT_DISPLAY_NAMES[stat as CodingStat].padEnd(10);
+        const bar = renderStatBar(value);
+        lines.push(`  ${label} ${bar}  ${String(value).padStart(3)}`);
+      }
+
+      // Terminal bell
+      if (state.config.bellEnabled) {
+        process.stderr.write(BELL);
+      }
+
+      return {
+        content: [{ type: "text" as const, text: lines.join("\n") }],
+      };
+    },
+  );
+}

package/src/server/tools/legendary.ts

@@ -0,0 +1,78 @@
+/**
+ * buddy_legendary tool — Display progress on all 5 legendary quest chains.
+ * Each quest has multi-step conditions tied to sustained coding activity.
+ */
+
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { POKEMON_BY_ID } from "../../engine/pokemon-data.js";
+import { getQuestProgress } from "../../gamification/legendary-quests.js";
+import { StateManager } from "../../state/state-manager.js";
+import { pad } from "./display-helpers.js";
+
+/** Registers the buddy_legendary tool on the MCP server. */
+export function registerLegendaryTool(server: McpServer): void {
+  server.tool(
+    "buddy_legendary",
+    "View progress on all legendary Pokemon quest chains.",
+    {},
+    async () => {
+      const stateManager = StateManager.getInstance();
+      const state = await stateManager.load();
+
+      if (!state) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "You don't have a Pokemon yet! Use buddy_starter to begin your journey.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const progress = getQuestProgress(state);
+
+      const W = 48;
+      const border = "\u2500".repeat(W);
+      const lines: string[] = [];
+
+      lines.push("L E G E N D A R Y   Q U E S T S");
+      lines.push("");
+
+      for (const entry of progress) {
+        const { quest, stepsCompleted, totalSteps } = entry;
+        const species = POKEMON_BY_ID.get(quest.pokemonId);
+        const pokemonName = species?.name ?? `#${quest.pokemonId}`;
+
+        lines.push(
+          `\u250c\u2500 LEGENDARY QUEST: ${pokemonName} ${"\u2500".repeat(Math.max(0, W - 24 - pokemonName.length))}\u2510`,
+        );
+        lines.push(`\u2502  ${pad(quest.name, W - 2)}\u2502`);
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+
+        for (let i = 0; i < quest.steps.length; i++) {
+          const step = quest.steps[i]!;
+          const completed = i < stepsCompleted;
+          const marker = completed ? "\u2713" : "\u25cb";
+          const stepText = `Step ${i + 1}: ${marker} ${step.description}`;
+          lines.push(`\u2502  ${pad(stepText, W - 2)}\u2502`);
+        }
+
+        lines.push(`\u2502${" ".repeat(W)}\u2502`);
+
+        const allDone = stepsCompleted === totalSteps;
+        const progressStr = allDone
+          ? `COMPLETE! ${pokemonName} awaits you!`
+          : `Progress: ${stepsCompleted}/${totalSteps}`;
+        lines.push(`\u2502  ${pad(progressStr, W - 2)}\u2502`);
+        lines.push(`\u2514${border}\u2518`);
+        lines.push("");
+      }
+
+      return {
+        content: [{ type: "text" as const, text: lines.join("\n") }],
+      };
+    },
+  );
+}