@umang-boss/claudemon 1.0.0

package/sprites/colorscripts/small/90-shellder.txt

@@ -0,0 +1,10 @@
+▄▀▀▄▄    ▄▀▀▀▀▄▄   
+ ▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀▀▄ 
+ ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 
+ ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ 
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀  ▀▀▀
+  ▀▀▀▀   ▀▀▀       
+

package/sprites/colorscripts/small/91-cloyster.txt

@@ -0,0 +1,18 @@
+   ▀▀▄                               
+   ▀▀▀▀▀▄                            
+    ▀▀▀▀▀▀                      ▄▄▀▀▄
+     ▀▀▀▀▀▀▀▀▄             ▄▄▄▀▀▀▀▀▀▀
+       ▄▀▀▀▀▀▀▀▀▄   ▄▄    ▀▀▀▀▀▀▀▀▀  
+     ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄▄▀▀▀▀▀▀▀▀   
+ ▄▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄        
+  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀        
+  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄       
+  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     
+   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀      
+   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀        
+     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀        
+      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀          
+        ▀▀      ▀▀▀▀▀▀ ▀▀▀▀▀         
+                 ▀▀      ▀▀          
+

package/sprites/colorscripts/small/92-gastly.txt

@@ -0,0 +1,12 @@
+          ▀▀ ▀         
+    ▄▄▀▀▀▄▄▄ ▄▀▀▄ ▀▀   
+   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     
+ ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▄▄   
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄▀
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀ 
+  ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   
+  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     
+    ▀▀▀▀▀▀▀▀▀ ▄▄       
+              ▀▀       
+

package/sprites/colorscripts/small/93-haunter.txt

@@ -0,0 +1,14 @@
+            ▄▀▄               
+           ▄▀▀▀▄              
+       ▀▀▄▄▀▀▀▀▀▀▀▀▄▄     ▄▄▄▄
+       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  
+        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄
+  ▄▄▀▀▄  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 
+▄▀▀▀▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄   
+▀▀▀▀▀▀▀▀▀▀ ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄ 
+ ▀▀ ▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+      ▀       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀  
+                  ▀▀▀▀▀▀▀▀▀   
+                    ▀▀▀ ▀▀▀   
+

package/sprites/colorscripts/small/94-gengar.txt

@@ -0,0 +1,19 @@
+   ▀▀▄                          
+   ▀▀▀▀▄▄        ▄▄           ▄▄
+    ▀▀▀▀▀▀▄  ▄ ▄▀▀▀ ▄▄    ▄▄▀▀▀▀
+     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▄▀▀▀▀▀▀▀ 
+     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  
+      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   
+    ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄   
+  ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄  
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   
+    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄  
+     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   
+      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄  
+       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 
+        ▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
+                  ▀▀▀▀▀▀▀       
+                     ▀▀         
+

package/sprites/colorscripts/small/95-onix.txt

@@ -0,0 +1,22 @@
+      ▄▀▄                        
+      ▀▀▀                        
+      ▀▀▀                        
+      ▀▀▀▄    ▄▄                 
+      ▀▀▀▀▄▄▀▀▀▀▀▀▄▄▀▀▀▀▀▄       
+    ▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄     
+  ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ 
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     ▀▀▀▀▀▀▀▀▀ 
+▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀       ▄▀▀▀▀▀▀▄ 
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀       ▀▀▀▀▀▀▀▀▀▀
+ ▀▀▀▀▀▀▀▀▀▀▀▀▀        ▀▀▀▀▀▀▀▀▀▀▀
+   ▀▀▀▀▀▀▀▀▀▀          ▀▀▀▀▀▀▀▀▀ 
+      ▀▀▀▀▀          ▄▀▀▀▀▀▀▀▄   
+                     ▀▀▀▀▀▀▀▀▀   
+         ▄▄▄ ▄▄▄ ▄▄▀▀▀▀▀▀▀▀▀▀    
+        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     
+         ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀         
+                  ▀▀▀▀           
+

package/sprites/colorscripts/small/96-drowzee.txt

@@ -0,0 +1,12 @@
+     ▄▀▀▀▄▄▄▄▄          
+      ▀▀▀▀▀▀▀▀▀▀▄▀▀▀▄   
+  ▄▄▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
+▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀      
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄   
+  ▀  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ 
+        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄
+       ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+                   ▀▀▀▀ 
+

package/sprites/colorscripts/small/97-hypno.txt

@@ -0,0 +1,19 @@
+                ▄▀▄      ▄              
+                ▀▀▀▀   ▄▀▀▀             
+               ▀▀▀▀▀▀▀▀▀▀▀▀▀▄           
+             ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀          
+            ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀         
+            ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀         
+             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀        
+          ▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀        
+  ▄▄▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄        
+▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  ▀▀▄▀▀▀▄ 
+▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     ▀▀▀▀▀▀▀
+    ▀▀▀▀      ▀▀▀▀▀▀▀▀▀▀▀▀▀      ▀▀▀▀▀▀▀
+                ▀▀▀▀▀▀▀▀▀▀▀▄       ▀▀▀  
+             ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄          
+            ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀         
+           ▄▀▀▀▀▀▀▀      ▀▀▀▀▀▀▀▄       
+           ▀▀▀▀▀▀▀▀       ▀▀▀▀▀▀▀▀      
+             ▀▀▀             ▀▀▀        
+

package/sprites/colorscripts/small/98-krabby.txt

@@ -0,0 +1,12 @@
+  ▄▀▀▀▄                     
+ ▄▀▀▀▀▀                     
+▀▀▀▀▀▀▀▄              ▄▀▀▄  
+▀▀▀▀▀▀▀▀▀ ▄         ▄▀▀▀▀▀▀▄
+ ▄▀▀▀▀▀▀ ▀▀▀ ▄▀▄  ▄▀▀▀▀▀▀▀▀▀
+ ▀▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀▀
+   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▀▀▀▀  
+  ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
+  ▀▀▀  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄  
+         ▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀  
+                      ▀▀    
+

package/sprites/colorscripts/small/99-kingler.txt

@@ -0,0 +1,20 @@
+                    ▄▀▀▀▀▀▄▄▄▄              
+                   ▀▀▀▀▀▀▀▀▀▀▀▀▄            
+                  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀           
+                ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄         
+  ▄▀▀▀▄         ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄       
+ ▀▀▀▀▀▀▄         ▀▀▀     ▀▀▀▀▀▀▀▀▀▀▀▀       
+▄▀▀▀▀▀▀▀       ▄   ▄▀▄ ▄▀▄▀▀▀▀▀▀▀▀▀▀        
+▀▀▀▀▀▀▀▀      ▀▀▀▄ ▀▀▀▄▀▀▀▄▄▀▀▀▀▀▀▀▀▄       
+▀▀▀▀▀▀▀▀▀▄     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀       
+ ▀▀▀▀▀▀▀▀▀      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀        
+  ▀▀▀▀▀▀ ▄   ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀       
+   ▀▀▀▄ ▀▀▀▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀       
+    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄       
+     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄     
+      ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
+    ▄▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄  
+   ▀▀▀▀▀        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀   ▀▀▀▀▄▀▀▀▀▀▄
+                                  ▀▀▀▀▄ ▀▀▀ 
+                                   ▀▀▀▀▀    
+

package/src/engine/constants.ts

@@ -0,0 +1,121 @@
+/**
+ * Shared constants for Claudemon.
+ * All magic numbers and configuration values live here.
+ */
+
+import type { XpEventType, CodingStat, TrainerTitle, Badge } from "./types.js";
+
+// ── Game Limits ────────────────────────────────────────────
+
+export const MAX_PARTY_SIZE = 6;
+export const MAX_LEVEL = 100;
+export const STARTER_LEVEL = 5;
+export const MAX_HAPPINESS = 255;
+export const TOTAL_POKEMON = 151;
+
+// ── XP Awards per Event ────────────────────────────────────
+
+export const XP_AWARDS: Record<
+  XpEventType,
+  { xp: number; stat: CodingStat | null; boost: number }
+> = {
+  commit: { xp: 15, stat: "velocity", boost: 1 },
+  test_pass: { xp: 12, stat: "stability", boost: 1 },
+  test_written: { xp: 10, stat: "stability", boost: 1 },
+  build_success: { xp: 10, stat: "stability", boost: 1 },
+  bug_fix: { xp: 8, stat: "debugging", boost: 1 },
+  lint_fix: { xp: 6, stat: "debugging", boost: 1 },
+  file_create: { xp: 5, stat: "velocity", boost: 0 },
+  file_edit: { xp: 3, stat: "velocity", boost: 0 },
+  search: { xp: 1, stat: "wisdom", boost: 0 },
+  large_refactor: { xp: 20, stat: "wisdom", boost: 2 },
+  session_start: { xp: 5, stat: "stamina", boost: 1 },
+  daily_streak: { xp: 15, stat: "stamina", boost: 1 },
+  pet: { xp: 2, stat: null, boost: 0 },
+};
+
+// ── Stat Display Names ─────────────────────────────────────
+
+export const STAT_DISPLAY_NAMES: Record<CodingStat, string> = {
+  stamina: "STAMINA",
+  debugging: "DEBUGGING",
+  stability: "STABILITY",
+  velocity: "VELOCITY",
+  wisdom: "WISDOM",
+};
+
+// ── Encounter Rate ─────────────────────────────────────────
+
+/** XP earned between wild encounters */
+export const XP_PER_ENCOUNTER = 500;
+
+// ── Reaction Cooldown ──────────────────────────────────────
+
+export const DEFAULT_REACTION_COOLDOWN_MS = 30_000;
+
+// ── Trainer Titles (by highest Pokemon level) ──────────────
+
+export const TRAINER_TITLES: readonly TrainerTitle[] = [
+  { minLevel: 1, title: "Bug Catcher" },
+  { minLevel: 6, title: "Youngster" },
+  { minLevel: 11, title: "Hiker" },
+  { minLevel: 21, title: "Ace Trainer" },
+  { minLevel: 31, title: "Cooltrainer" },
+  { minLevel: 41, title: "Veteran" },
+  { minLevel: 51, title: "Elite Four" },
+  { minLevel: 61, title: "Champion" },
+  { minLevel: 76, title: "Pokemon Master" },
+  { minLevel: 91, title: "Professor" },
+];
+
+// ── Badge Definitions ──────────────────────────────────────
+
+export const BADGES: readonly Badge[] = [
+  {
+    type: "blaze",
+    name: "Blaze Badge",
+    description: "Fix 50 bugs — unlocks Fire Stone evolutions",
+    condition: { type: "counter", counter: "bugs_fixed", threshold: 50 },
+  },
+  {
+    type: "flow",
+    name: "Flow Badge",
+    description: "Pass 100 tests — unlocks Water Stone evolutions",
+    condition: { type: "counter", counter: "tests_passed", threshold: 100 },
+  },
+  {
+    type: "spark",
+    name: "Spark Badge",
+    description: "Make 200 commits — unlocks Thunder Stone evolutions",
+    condition: { type: "counter", counter: "commits", threshold: 200 },
+  },
+  {
+    type: "lunar",
+    name: "Lunar Badge",
+    description: "Maintain a 30-day coding streak — unlocks Moon Stone evolutions",
+    condition: { type: "streak", minDays: 30 },
+  },
+  {
+    type: "growth",
+    name: "Growth Badge",
+    description: "Edit 500 files — unlocks Leaf Stone evolutions",
+    condition: { type: "counter", counter: "files_edited", threshold: 500 },
+  },
+];
+
+// ── State File Paths ───────────────────────────────────────
+
+/** Resolved at call time so tests can override HOME */
+export function getStateDir(): string {
+  return `${process.env["HOME"] ?? "~"}/.claudemon`;
+}
+export function getStateFile(): string {
+  return `${getStateDir()}/state.json`;
+}
+export function getStatusFile(): string {
+  return `${getStateDir()}/status.json`;
+}
+
+// ── Terminal Bell ──────────────────────────────────────────
+
+export const BELL = "\x07";

package/src/engine/encounter-pool.ts

@@ -0,0 +1,71 @@
+/**
+ * Pre-built encounter pools — computed once at module load.
+ * Maps each PokemonType to base-stage Pokemon IDs grouped by rarity.
+ */
+
+import type { PokemonType, RarityTier } from "./types.js";
+import { POKEDEX } from "./pokemon-data.js";
+import { EVOLUTION_CHAINS } from "./evolution-data.js";
+
+// ── Identify evolved Pokemon (targets of any evolution link) ──
+
+const EVOLVED_IDS: ReadonlySet<number> = new Set(
+  EVOLUTION_CHAINS.flatMap((chain) => chain.links.map((link) => link.to)),
+);
+
+/** Returns true if the Pokemon is the base stage of its evolution chain. */
+function isBaseStage(pokemonId: number): boolean {
+  return !EVOLVED_IDS.has(pokemonId);
+}
+
+// ── Rarity tiers eligible for wild encounters ─────────────────
+
+const WILD_RARITIES: ReadonlySet<RarityTier> = new Set(["common", "uncommon", "rare"]);
+
+// ── Build pools at module load ────────────────────────────────
+
+interface RarityPool {
+  readonly common: readonly number[];
+  readonly uncommon: readonly number[];
+  readonly rare: readonly number[];
+}
+
+function buildTypePools(): ReadonlyMap<PokemonType, RarityPool> {
+  const pools = new Map<PokemonType, { common: number[]; uncommon: number[]; rare: number[] }>();
+
+  for (const pokemon of POKEDEX) {
+    // Only base-stage Pokemon appear in wild encounters
+    if (!isBaseStage(pokemon.id)) continue;
+
+    // Legendary and mythical never appear in wild encounters
+    if (!WILD_RARITIES.has(pokemon.rarity)) continue;
+
+    for (const pokemonType of pokemon.types) {
+      if (pokemonType === undefined) continue;
+
+      let pool = pools.get(pokemonType);
+      if (!pool) {
+        pool = { common: [], uncommon: [], rare: [] };
+        pools.set(pokemonType, pool);
+      }
+
+      const rarity = pokemon.rarity as "common" | "uncommon" | "rare";
+      pool[rarity].push(pokemon.id);
+    }
+  }
+
+  // Freeze all inner arrays for immutability
+  const frozen = new Map<PokemonType, RarityPool>();
+  for (const [type, pool] of pools) {
+    frozen.set(type, {
+      common: Object.freeze(pool.common),
+      uncommon: Object.freeze(pool.uncommon),
+      rare: Object.freeze(pool.rare),
+    });
+  }
+
+  return frozen;
+}
+
+/** Map of PokemonType to Pokemon IDs of that type, grouped by rarity. */
+export const TYPE_POOLS: ReadonlyMap<PokemonType, RarityPool> = buildTypePools();