#!/usr/bin/env python3 """ Buddymon PostToolUse hook. Reads tool event JSON from stdin, checks for: - Bug monster triggers (error patterns in Bash output) - New language encounters (new file extensions in Write/Edit) - Commit streaks (git commit via Bash) - Deep focus / refactor signals Outputs additionalContext JSON to stdout if an encounter or event fires. Always exits 0. """ import json import os import re import sys import random from pathlib import Path from datetime import datetime PLUGIN_ROOT = os.environ.get("CLAUDE_PLUGIN_ROOT", str(Path(__file__).parent.parent)) BUDDYMON_DIR = Path.home() / ".claude" / "buddymon" CATALOG_FILE = Path(PLUGIN_ROOT) / "lib" / "catalog.json" KNOWN_EXTENSIONS = { ".py": "Python", ".js": "JavaScript", ".ts": "TypeScript", ".jsx": "JavaScript/React", ".tsx": "TypeScript/React", ".rb": "Ruby", ".go": "Go", ".rs": "Rust", ".c": "C", ".cpp": "C++", ".java": "Java", ".cs": "C#", ".swift": "Swift", ".kt": "Kotlin", ".php": "PHP", ".lua": "Lua", ".ex": "Elixir", ".hs": "Haskell", ".ml": "OCaml", ".clj": "Clojure", ".r": "R", ".jl": "Julia", ".sh": "Shell", ".bash": "Shell", ".sql": "SQL", ".html": "HTML", ".css": "CSS", ".scss": "SCSS", ".vue": "Vue", ".svelte": "Svelte", } def load_json(path): try: with open(path) as f: return json.load(f) except Exception: return {} def save_json(path, data): try: with open(path, "w") as f: json.dump(data, f, indent=2) except Exception: pass def get_state(): active = load_json(BUDDYMON_DIR / "active.json") encounters = load_json(BUDDYMON_DIR / "encounters.json") roster = load_json(BUDDYMON_DIR / "roster.json") session = load_json(BUDDYMON_DIR / "session.json") return active, encounters, roster, session def add_session_xp(amount: int): active_file = BUDDYMON_DIR / "active.json" roster_file = BUDDYMON_DIR / "roster.json" active = load_json(active_file) active["session_xp"] = active.get("session_xp", 0) + amount buddy_id = active.get("buddymon_id") save_json(active_file, active) if buddy_id: roster = load_json(roster_file) if buddy_id in roster.get("owned", {}): roster["owned"][buddy_id]["xp"] = roster["owned"][buddy_id].get("xp", 0) + amount save_json(roster_file, roster) def get_languages_seen(): session = load_json(BUDDYMON_DIR / "session.json") return set(session.get("languages_seen", [])) def add_language_seen(lang: str): session_file = BUDDYMON_DIR / "session.json" session = load_json(session_file) langs = session.get("languages_seen", []) if lang not in langs: langs.append(lang) session["languages_seen"] = langs save_json(session_file, session) def increment_session_tools(): session_file = BUDDYMON_DIR / "session.json" session = load_json(session_file) session["tools_used"] = session.get("tools_used", 0) + 1 save_json(session_file, session) def is_starter_chosen(): roster = load_json(BUDDYMON_DIR / "roster.json") return roster.get("starter_chosen", False) def get_active_buddy_id(): active = load_json(BUDDYMON_DIR / "active.json") return active.get("buddymon_id") def get_active_encounter(): encounters = load_json(BUDDYMON_DIR / "encounters.json") return encounters.get("active_encounter") def set_active_encounter(encounter: dict): enc_file = BUDDYMON_DIR / "encounters.json" data = load_json(enc_file) data["active_encounter"] = encounter save_json(enc_file, data) def match_bug_monster(output_text: str, catalog: dict) -> dict | None: """Return the first matching bug monster from the catalog, or None.""" if not output_text: return None # Only check first 4000 chars to avoid scanning huge outputs sample = output_text[:4000] for monster_id, monster in catalog.get("bug_monsters", {}).items(): for pattern in monster.get("error_patterns", []): if re.search(pattern, sample, re.IGNORECASE): return monster return None def encounter_still_present(encounter: dict, output_text: str, catalog: dict) -> bool: """Return True if the active encounter's error patterns still appear in output.""" monster_id = encounter.get("id") monster = catalog.get("bug_monsters", {}).get(monster_id) if not monster or not output_text: return False sample = output_text[:4000] return any( re.search(pat, sample, re.IGNORECASE) for pat in monster.get("error_patterns", []) ) def auto_resolve_encounter(encounter: dict, buddy_id: str | None) -> tuple[int, str]: """Defeat encounter automatically, award XP, clear state. Returns (xp, message).""" from datetime import datetime, timezone enc_file = BUDDYMON_DIR / "encounters.json" active_file = BUDDYMON_DIR / "active.json" roster_file = BUDDYMON_DIR / "roster.json" xp = encounter.get("xp_reward", 50) active = load_json(active_file) active["session_xp"] = active.get("session_xp", 0) + xp save_json(active_file, active) if buddy_id: roster = load_json(roster_file) if buddy_id in roster.get("owned", {}): roster["owned"][buddy_id]["xp"] = roster["owned"][buddy_id].get("xp", 0) + xp save_json(roster_file, roster) data = load_json(enc_file) resolved = dict(encounter) resolved["outcome"] = "defeated" resolved["timestamp"] = datetime.now(timezone.utc).isoformat() data.setdefault("history", []).append(resolved) data["active_encounter"] = None save_json(enc_file, data) return xp, resolved["display"] def compute_strength(monster: dict, elapsed_minutes: float) -> int: """Scale monster strength based on how long the error has persisted.""" base = monster.get("base_strength", 50) if elapsed_minutes < 2: return max(10, int(base * 0.6)) elif elapsed_minutes < 15: return base elif elapsed_minutes < 60: return min(100, int(base * 1.4)) else: # Boss tier — persisted over an hour return min(100, int(base * 1.8)) def format_encounter_message(monster: dict, strength: int, buddy_display: str) -> str: rarity_stars = {"very_common": "★☆☆☆☆", "common": "★★☆☆☆", "uncommon": "★★★☆☆", "rare": "★★★★☆", "legendary": "★★★★★"} stars = rarity_stars.get(monster.get("rarity", "common"), "★★☆☆☆") defeatable = monster.get("defeatable", True) catch_note = "[catchable]" if monster.get("catchable") else "" fight_note = "" if defeatable else "⚠️ CANNOT BE DEFEATED — catch only" catchable_str = "[catchable · catch only]" if not defeatable else f"[{monster.get('rarity','?')} · {catch_note}]" lines = [ f"\n💀 **{monster['display']} appeared!** {catchable_str}", f" Strength: {strength}% · Rarity: {stars}", f" *{monster.get('flavor', '')}*", "", ] if fight_note: lines.append(f" {fight_note}") lines.append("") lines += [ f" **{buddy_display}** is ready to battle!", "", " `[FIGHT]` Beat the bug → your buddy defeats it → XP reward", " `[CATCH]` Weaken it first (write a test, isolate repro, add comment) → attempt catch", " `[FLEE]` Ignore → monster grows stronger", "", " Use `/buddymon fight` or `/buddymon catch` to weaken + catch it.", ] return "\n".join(lines) def format_new_language_message(lang: str, buddy_display: str) -> str: return ( f"\n🗺️ **New language spotted: {lang}!**\n" f" {buddy_display} is excited — this is new territory.\n" f" *Explorer XP bonus earned!* +15 XP\n" ) def format_commit_message(streak: int, buddy_display: str) -> str: if streak < 5: return "" milestone_xp = {5: 50, 10: 120, 25: 300, 50: 700} xp = milestone_xp.get(streak, 30) return ( f"\n🔥 **Commit streak: {streak}!**\n" f" {buddy_display} approves. +{xp} XP\n" ) def main(): try: data = json.load(sys.stdin) except Exception: sys.exit(0) # Gate: only run if starter chosen if not is_starter_chosen(): sys.exit(0) tool_name = data.get("tool_name", "") tool_input = data.get("tool_input", {}) tool_response = data.get("tool_response", {}) if not BUDDYMON_DIR.exists(): BUDDYMON_DIR.mkdir(parents=True, exist_ok=True) sys.exit(0) catalog = load_json(CATALOG_FILE) buddy_id = get_active_buddy_id() # Look up display name buddy_display = "your buddy" if buddy_id: b = (catalog.get("buddymon", {}).get(buddy_id) or catalog.get("evolutions", {}).get(buddy_id)) if b: buddy_display = b.get("display", buddy_id) increment_session_tools() messages = [] # ── Bash tool: error detection + auto-resolution + commit tracking ─────── if tool_name == "Bash": output = "" if isinstance(tool_response, dict): parts = [ tool_response.get("output", ""), tool_response.get("content", ""), tool_response.get("stderr", ""), tool_response.get("text", ""), ] output = "\n".join(p for p in parts if isinstance(p, str) and p) elif isinstance(tool_response, str): output = tool_response elif isinstance(tool_response, list): output = "\n".join( b.get("text", "") for b in tool_response if isinstance(b, dict) and b.get("type") == "text" ) existing = get_active_encounter() if existing: # Auto-resolve if the monster's patterns no longer appear in output if output and not encounter_still_present(existing, output, catalog): xp, display = auto_resolve_encounter(existing, buddy_id) messages.append( f"\n⚔️ **{buddy_display} defeated {display}!** (auto-resolved)\n" f" +{xp} XP\n" ) # else: monster persists, no message — don't spam every tool call elif output: # No active encounter — check for a new one monster = match_bug_monster(output, catalog) if monster: # 70% chance to trigger (avoids every minor warning spawning) if random.random() < 0.70: strength = compute_strength(monster, elapsed_minutes=0) encounter = { "id": monster["id"], "display": monster["display"], "base_strength": monster.get("base_strength", 50), "current_strength": strength, "catchable": monster.get("catchable", True), "defeatable": monster.get("defeatable", True), "xp_reward": monster.get("xp_reward", 50), "weakened_by": [], "announced": False, } set_active_encounter(encounter) # Commit detection command = tool_input.get("command", "") if "git commit" in command and "exit_code" not in str(tool_response): session_file = BUDDYMON_DIR / "session.json" session = load_json(session_file) session["commits_this_session"] = session.get("commits_this_session", 0) + 1 save_json(session_file, session) commit_xp = 20 add_session_xp(commit_xp) # ── Write / Edit: new language detection ────────────────────────────── elif tool_name in ("Write", "Edit", "MultiEdit"): file_path = tool_input.get("file_path", "") if file_path: ext = os.path.splitext(file_path)[1].lower() lang = KNOWN_EXTENSIONS.get(ext) if lang: seen = get_languages_seen() if lang not in seen: add_language_seen(lang) add_session_xp(15) msg = format_new_language_message(lang, buddy_display) messages.append(msg) # Small XP for every file edit add_session_xp(2) if not messages: sys.exit(0) combined = "\n".join(messages) result = { "hookSpecificOutput": { "hookEventName": "PostToolUse", "additionalContext": combined } } print(json.dumps(result)) sys.exit(0) if __name__ == "__main__": main()