buddy-battle 1.0.0

package/dist/ui/Shared.js

@@ -0,0 +1,75 @@
+import React, { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+import { renderSprite } from '../engine/sprites.js';
+export function BuddySprite({ buddy, color = "yellow", isAttacking = false, isHit = false }) {
+    const [frame, setFrame] = useState(0);
+    const [shakeOffset, setShakeOffset] = useState(0);
+    useEffect(() => {
+        const t = setInterval(() => setFrame(f => f + 1), 1000);
+        return () => clearInterval(t);
+    }, []);
+    useEffect(() => {
+        let t;
+        if (isHit) {
+            let ticks = 0;
+            t = setInterval(() => {
+                ticks++;
+                setShakeOffset(ticks % 2 === 0 ? 2 : 0);
+            }, 100);
+        }
+        else {
+            setShakeOffset(0);
+        }
+        return () => clearInterval(t);
+    }, [isHit]);
+    const lines = renderSprite(buddy, frame);
+    const renderColor = isAttacking ? "cyanBright" : (isHit ? "redBright" : color);
+    return (React.createElement(Box, { flexDirection: "column", alignItems: "center" }, lines.map((l, i) => {
+        const prefix = " ".repeat(shakeOffset);
+        return React.createElement(Text, { key: i, color: renderColor, bold: isAttacking },
+            prefix,
+            l);
+    })));
+}
+export function BattleProjectiles({ activeMove, isPlayer1 }) {
+    const [tick, setTick] = useState(0);
+    useEffect(() => {
+        if (!activeMove) {
+            setTick(0);
+            return;
+        }
+        const timer = setInterval(() => setTick(t => t + 1), 60);
+        return () => clearInterval(timer);
+    }, [activeMove]);
+    if (!activeMove)
+        return React.createElement(Box, { width: 30, justifyContent: "center", alignItems: "center" },
+            React.createElement(Text, null, " "));
+    let avatar = "*";
+    let color = "whiteBright";
+    if (activeMove === 'Chaos Bomb') {
+        avatar = "◉";
+        color = "magentaBright";
+    }
+    else if (activeMove.includes('Smash')) {
+        avatar = "☄️";
+        color = "yellowBright";
+    }
+    else if (activeMove === 'Firewall') {
+        avatar = "🛡️";
+        color = "cyanBright";
+    }
+    else if (activeMove === 'Reboot') {
+        avatar = "➕";
+        color = "greenBright";
+    }
+    const isSelfCast = activeMove === 'Firewall' || activeMove === 'Reboot';
+    const maxDistance = 26;
+    let distance = Math.min(tick * 3, maxDistance);
+    if (isSelfCast) {
+        // Self-cast moves don't cross the field, they hover next to the caster!
+        distance = tick % 2 === 0 ? 0 : 2;
+    }
+    const padding = isPlayer1 ? distance : (maxDistance - distance);
+    return (React.createElement(Box, { width: 30, paddingLeft: Math.max(0, padding), justifyContent: "flex-start", alignItems: "center" },
+        React.createElement(Text, { bold: true, color: color }, avatar)));
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+	"name": "buddy-battle",
+	"version": "1.0.0",
+	"license": "MIT",
+	"bin": "dist/cli.js",
+	"type": "module",
+	"engines": {
+		"node": ">=16"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"test": "prettier --check . && xo && ava"
+	},
+	"files": [
+		"dist"
+	],
+	"dependencies": {
+		"@supabase/supabase-js": "^2.101.1",
+		"dotenv": "^17.3.1",
+		"ink": "^4.1.0",
+		"ink-text-input": "^5.0.1",
+		"meow": "^11.0.0",
+		"open": "^11.0.0",
+		"react": "^18.2.0",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@sindresorhus/tsconfig": "^3.0.1",
+		"@types/react": "^18.0.32",
+		"@vdemedes/prettier-config": "^2.0.1",
+		"ava": "^5.2.0",
+		"chalk": "^5.2.0",
+		"eslint-config-xo-react": "^0.27.0",
+		"eslint-plugin-react": "^7.32.2",
+		"eslint-plugin-react-hooks": "^4.6.0",
+		"ink-testing-library": "^3.0.0",
+		"prettier": "^2.8.7",
+		"ts-node": "^10.9.1",
+		"typescript": "^5.0.3",
+		"xo": "^0.53.1"
+	},
+	"ava": {
+		"extensions": {
+			"ts": "module",
+			"tsx": "module"
+		},
+		"nodeArguments": [
+			"--loader=ts-node/esm"
+		]
+	},
+	"xo": {
+		"extends": "xo-react",
+		"prettier": true,
+		"rules": {
+			"react/prop-types": "off"
+		}
+	},
+	"prettier": "@vdemedes/prettier-config"
+}

package/readme.md

@@ -0,0 +1,125 @@
+# 🤖 Buddy Battle
+
+**PvP Arena Combat for Claude Code Buddies**
+
+Buddy Battle brings your Claude Code companion to life in a real-time, turn-based terminal fighting game. Your buddy's species, rarity, and stats are pulled directly from your Claude Code installation — the same little creature that sits beside your prompt is now your champion in the arena.
+
+![Node.js](https://img.shields.io/badge/Node.js-18+-green) ![Supabase](https://img.shields.io/badge/Supabase-Realtime-blue) ![License](https://img.shields.io/badge/License-MIT-yellow)
+
+## ✨ Features
+
+- **🎮 Real-Time PvP** — Fight other Claude Code users over Supabase Realtime
+- **🧬 Deterministic Buddies** — Your buddy's species, rarity, and stats are derived from your Anthropic account via `Bun.hash`
+- **⚔️ 4-Move Combat System** — Debug Smash, Chaos Bomb, Firewall, and Reboot — each powered by your buddy's unique stats
+- **💥 Battle Animations** — Projectiles fly across the terminal, hits shake the screen
+- **🏆 Global Leaderboard** — ELO-tracked rankings stored in Supabase Postgres
+- **🔐 Cloud Profiles** — Choose a Trainer Name, synced across all your machines via SHA-256 hashed Anthropic UUID
+- **📡 Disconnect Protection** — Supabase Presence detects ragequits and awards the survivor a win
+- **🛡️ Privacy First** — No Anthropic credentials or account IDs ever leave your machine
+
+## 📋 Prerequisites
+
+- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** — You need a hatched buddy (`/buddy` command)
+- **[Node.js](https://nodejs.org/) 18+**
+- **[Bun](https://bun.sh/)** — Required for accurate buddy stat extraction (Claude Code already installs this)
+- **A Supabase project** — Free tier works fine
+
+## 🚀 Quick Start
+
+### 1. Clone & Install
+
+```bash
+git clone https://github.com/Grenghis-Khan/buddy-battle.git
+cd buddy-battle
+npm install
+```
+
+### 2. Set Up Supabase
+
+Create a new [Supabase](https://supabase.com) project, then run this SQL in the SQL Editor:
+
+```sql
+CREATE TABLE public.leaderboard (
+  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  trainer_name text UNIQUE NOT NULL,
+  hashed_id text UNIQUE,
+  wins integer DEFAULT 0,
+  losses integer DEFAULT 0,
+  elo integer DEFAULT 1000,
+  created_at timestamptz DEFAULT now()
+);
+
+ALTER TABLE public.leaderboard ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Public read" ON public.leaderboard FOR SELECT USING (true);
+CREATE POLICY "Public insert" ON public.leaderboard FOR INSERT WITH CHECK (true);
+CREATE POLICY "Public update" ON public.leaderboard FOR UPDATE USING (true);
+```
+
+### 3. Configure Environment
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your Supabase project URL and anon key (found in Settings → API).
+
+### 4. Build & Play!
+
+```bash
+npm run build
+node dist/cli.js
+```
+
+## 🎯 Combat System
+
+| Move | Stat | Effect |
+|------|------|--------|
+| **Debug Smash** | DEBUGGING | Reliable damage |
+| **Chaos Bomb** | CHAOS | Massive damage, 30% miss chance |
+| **Firewall** | WISDOM | Blocks 50% of next incoming hit |
+| **Reboot** | PATIENCE | Heals your buddy |
+
+Each buddy's stats are unique and deterministic — a high-CHAOS buddy will devastate with Chaos Bombs, while a high-PATIENCE buddy can outlast opponents with Reboots.
+
+## 🏗️ Architecture
+
+```
+buddy-battle/
+├── source/
+│   ├── app.tsx              # Root application + state machine
+│   ├── cli.tsx              # Entry point
+│   ├── extract-bones.ts     # Bun script for accurate stat extraction
+│   ├── config/
+│   │   └── reader.ts        # Reads ~/.claude.json + shells out to Bun
+│   ├── engine/
+│   │   ├── companion.ts     # Deterministic buddy generation (mirrored from Claude Code)
+│   │   ├── types.ts         # Species, rarities, stats
+│   │   └── sprites.ts       # ASCII art for all 18 species
+│   ├── network/
+│   │   └── client.ts        # Supabase Realtime + Presence + Cloud Profiles
+│   └── ui/
+│       ├── Arena.tsx         # Battle screen with animations
+│       ├── Menu.tsx          # Main menu
+│       ├── Matchmaking.tsx   # Lobby + opponent discovery
+│       ├── Leaderboard.tsx   # Global rankings
+│       ├── Setup.tsx         # First-time Trainer Name registration
+│       └── Shared.tsx        # Sprites + projectile components
+```
+
+### Key Technical Decisions
+
+- **Bun.hash bridge**: Claude Code runs on Bun and uses `Bun.hash()` (wyhash) to seed buddy generation. Since Node.js uses a different hash, we shell out to `bun source/extract-bones.ts` at boot to get bit-identical results.
+- **SHA-256 identity**: Your Anthropic `accountUuid` is hashed before touching the network — Supabase never sees your real account ID.
+- **Peer-to-peer combat**: No server-side game logic. Both clients independently compute damage from broadcast payloads, keeping the architecture simple.
+
+## ⚠️ Bun Warning
+
+If Bun is not installed, the game will still work but your buddy's species, rarity, and combat stats may not match what Claude Code shows. Install Bun to fix this:
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+```
+
+## 📄 License
+
+MIT