buddy-battle 1.0.0 → 1.0.2

package/dist/app.js

@@ -42,15 +42,14 @@ export default function App() {
     }
     return (React.createElement(Box, { flexDirection: "column", padding: 1 },
         React.createElement(Box, { marginBottom: 1, flexDirection: "column" },
-            React.createElement(Text, { color: "gray" },
+            React.createElement(Text, { dimColor: true },
                 "Logged in as ",
                 trainerName ?? buddy.name,
                 " (",
                 buddy.rarity,
                 " ",
                 buddy.species,
-                ")"),
-            bunWarning && (React.createElement(Text, { color: "yellow" }, "\u26A0 Bun not found \u2014 buddy stats may be inaccurate. Install Bun: curl -fsSL https://bun.sh/install | bash"))),
+                ")")),
         view === 'loading' && (React.createElement(Text, { color: "cyan" }, "Authenticating profile...")),
         view === 'setup' && (React.createElement(Setup, { errorMsg: setupError, onComplete: async (name) => {
                 setSetupError(undefined);
@@ -63,7 +62,7 @@ export default function App() {
                     setSetupError(`Trainer name '${name}' is already taken. Please try another!`);
                 }
             } })),
-        view === 'menu' && (React.createElement(Menu, { onSelect: (opt) => setView(opt) })),
+        view === 'menu' && (React.createElement(Menu, { onSelect: (opt) => setView(opt), bunWarning: bunWarning })),
         view === 'leaderboard' && (React.createElement(Leaderboard, { onBack: () => setView('menu') })),
         view === 'matchmaking' && (React.createElement(Matchmaking, { myBuddy: sanitizeBuddyForNetwork(buddy, trainerName), onCancel: () => setView('menu'), onMatch: (opp, id) => {
                 setOpponent(opp);

package/dist/config/reader.js

@@ -26,21 +26,31 @@ const GUEST_BUDDY = {
     personality: 'Mysterious and ready to battle',
     hatchedAt: Date.now()
 };
-// Check if Bun is available in PATH
-function isBunAvailable() {
+// Find Bun path if available, checking PATH then ~/.bun/bin/bun directly
+function getBunPath() {
     try {
         execSync('bun --version', { timeout: 3000, stdio: 'pipe' });
-        return true;
+        return 'bun';
     }
-    catch {
-        return false;
+    catch { }
+    const isWin = os.platform() === 'win32';
+    const bunExecutable = isWin ? 'bun.exe' : 'bun';
+    const homeBunPath = path.join(os.homedir(), '.bun', 'bin', bunExecutable);
+    if (fs.existsSync(homeBunPath)) {
+        try {
+            execSync(`"${homeBunPath}" --version`, { timeout: 3000, stdio: 'pipe' });
+            return homeBunPath;
+        }
+        catch { }
     }
+    return null;
 }
 // Shell out to Bun to extract the real buddy bones using Bun.hash (wyhash).
 // Claude Code runs on Bun, so the deterministic RNG seed differs from Node's
 // FNV hash. Since Claude Code users already have Bun installed, we leverage it.
 function extractRealBones() {
-    if (!isBunAvailable())
+    const bunPath = getBunPath();
+    if (!bunPath)
         return null;
     try {
         // Try common locations relative to the project root
@@ -50,7 +60,7 @@ function extractRealBones() {
         ];
         for (const candidate of candidates) {
             if (fs.existsSync(candidate)) {
-                const result = execSync(`bun "${candidate}"`, { timeout: 5000, encoding: 'utf-8' });
+                const result = execSync(`"${bunPath}" "${candidate}"`, { timeout: 5000, encoding: 'utf-8' });
                 const parsed = JSON.parse(result.trim());
                 if (!parsed.error)
                     return parsed;

package/dist/engine/types.d.ts

@@ -59,7 +59,7 @@ export declare const RARITY_STARS: {
     readonly legendary: "★★★★★";
 };
 export declare const RARITY_COLORS: {
-    readonly common: "gray";
+    readonly common: "white";
     readonly uncommon: "green";
     readonly rare: "cyan";
     readonly epic: "magenta";

package/dist/engine/types.js

@@ -24,4 +24,4 @@ export const HATS = ['none', 'crown', 'tophat', 'propeller', 'halo', 'wizard', '
 export const STAT_NAMES = ['DEBUGGING', 'PATIENCE', 'CHAOS', 'WISDOM', 'SNARK'];
 export const RARITY_WEIGHTS = { common: 60, uncommon: 25, rare: 10, epic: 4, legendary: 1 };
 export const RARITY_STARS = { common: '★', uncommon: '★★', rare: '★★★', epic: '★★★★', legendary: '★★★★★' };
-export const RARITY_COLORS = { common: 'gray', uncommon: 'green', rare: 'cyan', epic: 'magenta', legendary: 'yellow' };
+export const RARITY_COLORS = { common: 'white', uncommon: 'green', rare: 'cyan', epic: 'magenta', legendary: 'yellow' };

package/dist/network/client.d.ts

@@ -22,7 +22,7 @@ export type NetworkBuddy = {
     };
 };
 export declare function sanitizeBuddyForNetwork(myBuddy: Companion, trainerName: string): NetworkBuddy;
-export declare function joinMatchmaking(myBuddy: NetworkBuddy, onMatchFound: (opponent: NetworkBuddy, battleId: string) => void): RealtimeChannel;
+export declare function joinMatchmaking(myBuddy: NetworkBuddy, onMatchFound: (opponent: NetworkBuddy, battleId: string) => void, onConnected?: () => void): RealtimeChannel;
 export declare function joinBattle(battleId: string, onActionReceived: (payloadData: any) => void, onOpponentDisconnect: () => void): RealtimeChannel;
 export declare function fetchCloudProfile(hashedId: string): Promise<string | null>;
 export declare function createCloudProfile(hashedId: string, trainerName: string): Promise<boolean>;

package/dist/network/client.js

@@ -26,7 +26,7 @@ export function sanitizeBuddyForNetwork(myBuddy, trainerName) {
         stats: myBuddy.stats,
     };
 }
-export function joinMatchmaking(myBuddy, onMatchFound) {
+export function joinMatchmaking(myBuddy, onMatchFound, onConnected) {
     debugLog(`Joining matchmaking as ${myBuddy.trainerName} (${SESSION_ID})`);
     const channel = supabase.channel('room:matchmaking-lobby');
     channel
@@ -57,6 +57,8 @@ export function joinMatchmaking(myBuddy, onMatchFound) {
         .subscribe(async (status, err) => {
         debugLog(`Matchmaking subscribe status: ${status} | err: ${err}`);
         if (status === 'SUBSCRIBED') {
+            if (onConnected)
+                onConnected();
             // Pre-register our battle token so opponents can claim victory if we lose/quit
             await supabase.rpc('create_battle_token', {
                 h_id: getHashedUserId(),

package/dist/ui/Arena.js

@@ -251,10 +251,10 @@ export function Arena({ myBuddy, myTrainerName, opponent, battleId, onLeave }) {
             React.createElement(BattleProjectiles, { activeMove: projectiles?.move || null, isPlayer1: projectiles?.p1 || false }),
             React.createElement(BuddySprite, { buddy: opponent, color: "cyan", isHit: p2Hit, isAttacking: p2Attacking })),
         React.createElement(Box, { flexDirection: "column", marginTop: 1 },
-            React.createElement(Box, { flexDirection: "column", width: "100%", height: 11, padding: 1, borderStyle: "round", borderColor: "gray" },
+            React.createElement(Box, { flexDirection: "column", width: "100%", height: 11, padding: 1, borderStyle: "round" },
                 !gameOver && (React.createElement(Box, { marginBottom: 1 },
-                    React.createElement(Text, { bold: true, color: isMyTurn ? 'yellow' : 'gray' }, isMyTurn ? `Your Turn! (${timeLeft}s)` : `Waiting... (${timeLeft}s)`))),
-                isMyTurn && !gameOver && (React.createElement(Box, { flexDirection: "column" }, moves.map((m, i) => (React.createElement(Text, { key: m.name, color: cursor === i ? 'white' : 'gray' },
+                    React.createElement(Text, { bold: true, color: isMyTurn ? 'yellow' : undefined, dimColor: !isMyTurn }, isMyTurn ? `Your Turn! (${timeLeft}s)` : `Waiting... (${timeLeft}s)`))),
+                isMyTurn && !gameOver && (React.createElement(Box, { flexDirection: "column" }, moves.map((m, i) => (React.createElement(Text, { key: m.name, color: cursor === i ? 'whiteBright' : undefined, dimColor: cursor !== i },
                     cursor === i ? '> ' : '  ',
                     m.name,
                     " ",

package/dist/ui/Matchmaking.js

@@ -2,17 +2,26 @@ import React, { useEffect, useState, useRef } from 'react';
 import { Box, Text, useInput } from 'ink';
 import { joinMatchmaking, cleanupChannel, debugLog } from '../network/client.js';
 export function Matchmaking({ myBuddy, onMatch, onCancel }) {
-    const [status, setStatus] = useState("Connecting to lobby...");
+    const [statusBase, setStatusBase] = useState("Connecting to lobby");
+    const [tick, setTick] = useState(0);
     const matched = useRef(false);
+    useEffect(() => {
+        const timer = setInterval(() => setTick(t => t + 1), 400);
+        return () => clearInterval(timer);
+    }, []);
     useEffect(() => {
         debugLog("Matchmaking component mounted");
         const channel = joinMatchmaking(myBuddy, (opponent, battleId) => {
             if (matched.current)
                 return;
             matched.current = true;
-            setStatus(`Found opponent: ${opponent.trainerName}. Joining match...`);
+            setStatusBase(`Found opponent: ${opponent.trainerName}. Joining match`);
             // Wait 2 seconds before executing onMatch so that any broadcasts have time to transmit
             setTimeout(() => onMatch(opponent, battleId), 2000);
+        }, () => {
+            if (!matched.current) {
+                setStatusBase("Awaiting opponent");
+            }
         });
         return () => {
             debugLog("Matchmaking component unmounted");
@@ -25,6 +34,10 @@ export function Matchmaking({ myBuddy, onMatch, onCancel }) {
             onCancel();
         }
     });
+    const dotFrames = ['   ', '.  ', '.. ', '...'];
+    const dots = dotFrames[tick % 4];
     return (React.createElement(Box, { flexDirection: "column", padding: 1, borderStyle: "round", borderColor: "cyan", width: 80, minHeight: 28, alignItems: "center", justifyContent: "center" },
-        React.createElement(Text, { color: "cyan" }, status)));
+        React.createElement(Text, { color: "cyan" },
+            statusBase,
+            dots)));
 }

package/dist/ui/Menu.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
-export declare function Menu({ onSelect }: {
+export declare function Menu({ onSelect, bunWarning }: {
     onSelect: (val: string) => void;
+    bunWarning?: boolean;
 }): React.JSX.Element;

package/dist/ui/Menu.js

@@ -1,6 +1,6 @@
 import React, { useState, useEffect } from 'react';
 import { Box, Text, useInput } from 'ink';
-export function Menu({ onSelect }) {
+export function Menu({ onSelect, bunWarning }) {
     const options = [
         { label: 'Find Online Match', value: 'matchmaking' },
         { label: 'View Leaderboard', value: 'leaderboard' },
@@ -46,7 +46,9 @@ export function Menu({ onSelect }) {
                     rumbleEnd))),
         React.createElement(Box, { flexDirection: "column", marginTop: 2 }, options.map((opt, i) => (React.createElement(Text, { key: opt.value },
             i === index ? (React.createElement(Text, { color: "yellowBright", bold: true }, '►► ')) : ('   '),
-            React.createElement(Text, { color: i === index ? 'white' : 'gray', bold: i === index }, opt.label))))),
-        React.createElement(Box, { marginTop: 3 },
-            React.createElement(Text, { dimColor: true }, "Use \u2191/\u2193 arrows to navigate, Enter to select."))));
+            React.createElement(Text, { color: i === index ? 'whiteBright' : undefined, dimColor: i !== index, bold: i === index }, opt.label))))),
+        React.createElement(Box, { marginTop: 3, flexDirection: "column", alignItems: "center" },
+            React.createElement(Text, { dimColor: true }, "Use \u2191/\u2193 arrows to navigate, Enter to select."),
+            bunWarning && (React.createElement(Box, { marginTop: 1 },
+                React.createElement(Text, { color: "yellow" }, "\u26A0 Bun not found \u2014 buddy stats may be inaccurate. Install Bun: curl -fsSL https://bun.sh/install | bash"))))));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "buddy-battle",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"license": "MIT",
 	"bin": "dist/cli.js",
 	"type": "module",

package/readme.md

@@ -8,80 +8,38 @@ Buddy Battle brings your Claude Code companion to life in a real-time, turn-base
 
 ## ✨ Features
 
-- **🎮 Real-Time PvP** — Fight other Claude Code users over Supabase Realtime
+- **🎮 Real-Time PvP** — Fight other Claude Code users globally 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
+- **⚔️ 4-Move Combat System** — Debug Smash, Chaos Bomb, Firewall, and Reboot — each scaled mathematically to 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
+- **🏆 Global Leaderboard** — ELO-tracked rankings
+- **🔗 X (Twitter) Integration** — Brag about your knockout victories directly to X from the terminal
+- **🔐 Secure Architecture** — Match validation tokens prevent forged wins, and your real Anthropic UUID is SHA-256 hashed to protect your identity.
 
 ## 🚀 Quick Start
 
-### 1. Clone & Install
+Ensure you have [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and have hatched a buddy using the `/buddy` command. 
 
-```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
+Then just jump right into the arena:
 
 ```bash
-cp .env.example .env
+npx buddy-battle
 ```
 
-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
-```
+*Note: For the most accurate buddy stats, ensure [Bun](https://bun.sh/) is installed on your machine so the client can perfectly match Anthropic's internal hashing algorithm.*
 
 ## 🎯 Combat System
 
+Every match is different because every buddy has unique stats! Combat has been completely mathematically balanced to ensure that even a level 100 stat won't instantly one-shot a level 0 buddy, but it will give you a major thematic advantage.
+
 | 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 |
+| **Debug Smash** | DEBUGGING | Fast, highly reliable light attack. |
+| **Chaos Bomb** | CHAOS | Heavy attack with a high chance to miss. |
+| **Firewall** | WISDOM | Defensive block. The higher your wisdom, the larger the percentage of the next incoming hit you block. |
+| **Reboot** | PATIENCE | Heals your buddy for a burst of HP. |
 
-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
+## 🏗️ Technical Architecture
 
 ```
 buddy-battle/
@@ -92,33 +50,20 @@ buddy-battle/
 │   ├── 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
+│   │   └── client.ts        # Supabase RPCs + Match Validators
 │   └── 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
+│       ├── Matchmaking.tsx   # Lobby + Match Validator Handshake
+│       └── ...
 ```
 
-### 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.
+### Key Security Decisions
 
-## ⚠️ 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
-```
+- **Match Validator Handshake**: To prevent ELO spoofing, players generate and exchange a cryptographic `battle_token` upon connecting. The winner must submit their opponent's token to securely claim the win via a locked-down PostgreSQL RPC.
+- **Embedded Client**: Server-side credentials are safely embedded right in the package — zero setup required for players. The database is strictly protected by Row Level Security (RLS) so the `anon` key cannot be abused.
 
 ## 📄 License