ai-code-battle/wasm/bots/README.md
jedarden 98276903e2 feat(wasm): add separate WASM bot builds for browser sandbox (plan §11.1)
Add wasm/bots/ directory with separate WASM builds for each bot:
- gatherer (Go → WASM): energy-focused, avoids combat
- random (Go → WASM): random moves
- guardian (Go → WASM): defends own cores
- hunter (Go → WASM): hunts nearest enemy
- rusher (Rust → WASM): attacks enemy cores
- swarm (AssemblyScript → WASM): tight formations

Each bot exports the standard WASM interface:
- init(configJSON): initialize with game config
- compute_moves(stateJSON): return moves JSON
- free_result(ptr): no-op for Go/AS

Built WASM files output to wasm/dist/. Go WASM bots verified to build.

Closes: bf-2zi5

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 14:58:01 -04:00

1.5 KiB

WASM Bot Builds

This directory contains the WebAssembly builds for the browser sandbox. Each bot compiles to a separate WASM module with the standard interface.

Bot WASM Interface

Each WASM module exports three functions:

// Initialize the bot with game config
bot.init(configJSON: string): string // {ok: bool, error?: string}

// Compute moves for the current turn
bot.compute_moves(stateJSON: string): string // moves JSON array

// Free result (no-op for Go/AS, required for interface compatibility)
bot.free_result(ptr: number): void

Directory Structure

wasm/bots/
├── gatherer/     # Go → WASM (energy-focused, avoids combat)
├── random/       # Go → WASM (random moves)
├── guardian/     # Go → WASM (defends own cores)
├── hunter/       # Go → WASM (hunts nearest enemy)
├── rusher/       # Rust → WASM (attacks enemy cores)
└── swarm/        # TypeScript/AssemblyScript → WASM (tight formations)

Building

Build all bots:

cd wasm/bots
make all

Build individual bot:

cd wasm/bots/gatherer
./build.sh

Output directory: wasm/dist/

Bot Sizes (estimated)

Bot Language Size
gatherer Go → WASM ~12 MB
random Go → WASM ~10 MB
guardian Go → WASM ~12 MB
hunter Go → WASM ~12 MB
rusher Rust → WASM ~3 MB
swarm AssemblyScript → WASM ~5 MB

Plan Reference

This implements plan §11.1 lines 2566-2576 and plan §13.1 WASM sandbox.