History

jedarden b6b4d27267 feat(maps): add seed map library for initial deployment (plan §3.8) - Create maps/ directory with 50 maps per player count (2, 3, 4, 6) - Each map includes metadata: id, players, dimensions, wall density - Generate maps using acb-mapgen with rotational symmetry - Add scripts/generate-map-library.sh for regeneration - Add Makefile with map-library target Plan §3.8 specifies: "Pre-generated pool of 50+ maps per player count" Total: 200 maps (50 each for 2, 3, 4, and 6 players) Closes: bf-4mlv Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>		2026-05-25 08:42:12 -04:00
..
analyze-combat-deaths.sh	feat(monitoring): add combat death rate analysis script	2026-05-24 18:44:08 -04:00
build-wasm.sh	feat(acb-api): implement bot registration, job coordination, and replay endpoints per plan §12 Phase 4	2026-04-21 08:58:42 -04:00
cloudflare-setup.sh	feat(scripts): add Cloudflare setup and verification scripts	2026-03-29 14:50:08 -04:00
configure-dns.sh	docs(scripts): add DNS configuration script with Cloudflare API	2026-03-29 20:12:26 -04:00
deploy-pages.sh	docs(phase6): add deployment checklist and make scripts executable	2026-04-08 17:29:02 -04:00
generate-map-library.sh	feat(maps): add seed map library for initial deployment (plan §3.8)	2026-05-25 08:42:12 -04:00
generate-test-replays.sh	fix(scripts): add test replay generation and R2 upload tools	2026-05-24 21:54:36 -04:00
README.md	fix(scripts): add test replay generation and R2 upload tools	2026-05-24 21:54:36 -04:00
setup-r2.sh	feat(scripts): add R2 bucket setup script with custom domain config	2026-04-06 06:42:53 -04:00
upload-test-replays.sh	fix(scripts): add test replay generation and R2 upload tools	2026-05-24 21:54:36 -04:00
verify-combat-density.sh	fix(script): use 2 cores per player in combat density verification	2026-05-24 21:07:25 -04:00
verify-deployment.sh	feat(scripts): add Cloudflare setup and verification scripts	2026-03-29 14:50:08 -04:00

README.md

Scripts

This directory contains utility scripts for the AI Code Battle project.

Test Replay Management

Problem

The web viewer at /watch/replay loads replays from the R2 bucket (acb-data) via the Pages Function at web/functions/r2/[[path]].ts. The matches/index.json file lists test matches, but the corresponding replay files were never uploaded to R2, causing 404 errors.

Solution

Two scripts are provided to generate and upload test replays:

1. `generate-test-replays.sh`

Generates all test replays that match the entries in web/public/data/matches/index.json:

bash scripts/generate-test-replays.sh

This creates test-replays/*.json.gz files with proper match IDs.

2. `upload-test-replays.sh`

Uploads the generated replays to the R2 bucket:

# Install wrangler first (one-time)
npm install -g wrangler
wrangler login

# Upload the replays
bash scripts/upload-test-replays.sh

Verification

After uploading, verify the replays are accessible:

curl -I https://r2.aicodebattle.com/replays/m_test_upset_v1.json.gz

Or test directly in the viewer: https://ai-code-battle.pages.dev/#/watch/replay?url=/r2/replays/m_test_upset_v1.json.gz

R2 Bucket Configuration

Bucket Name: acb-data
Binding: ACB_BUCKET (configured in web/wrangler.toml)
Custom Domain: r2.aicodebattle.com
Public URL: https://r2.aicodebattle.com/

Expected R2 Layout

acb-data/
├── replays/           # Match replay JSON files (gzipped)
│   ├── m_test_upset_v1.json.gz
│   ├── m_test_6p_v1.json.gz
│   └── ...
├── matches/           # Per-match metadata
├── thumbnails/        # Match thumbnails
├── cards/            # Bot profile cards
└── evolution/        # Evolution live feed

Error Handling

The replay viewer (web/src/pages/replay.ts) already has proper error handling:

Checks response.ok before parsing JSON
Displays user-visible error messages via showLoadError()

No additional error handling code is needed.