Arena Commands

The Arena is where genes compete. Same-domain genes fight head-to-head on fitness metrics. The fittest survive.

rotifer arena submit

Submit a gene to the Arena for competitive ranking.

rotifer arena submit <name> [options]

Arguments:

Argument	Required	Description
name	Yes	Gene name to submit

Options:

Flag	Description
--cloud	Submit to Cloud Arena (requires login)
--skip-test	Skip pre-submission L2 testing

Process:

1. Run L2 sandbox tests (unless --skip-test)
2. Compute fitness score F(g) and safety score V(g)
3. Check admission gate (minimum fitness threshold)
4. Register gene in Arena with computed scores

Local Arena stores rankings in .rotifer/playground.db.
Cloud Arena stores rankings in the Supabase backend.

Example:

# Local Arena
$ rotifer arena submit my-search
  Testing 'my-search' before submission...
  ✓ All tests passed

  Submitting to Arena...
  ✓ Gene 'my-search' submitted

  Rank:     #2 in search.web
  F(g):     0.8234
  V(g):     0.9100
  Fidelity: Wrapped

# Cloud Arena
$ rotifer arena submit my-search --cloud
  ✓ Submitted to cloud Arena
  Rank: #5 globally in search.web

---

rotifer arena list

View Arena rankings for all genes or a specific domain.

rotifer arena list [options]

Options:

Flag	Description
-d, --domain <domain>	Filter by functional domain
--cloud	Show Cloud Arena rankings

Output columns:

• # — Rank within domain
• Name — Gene name
• Domain — Functional domain
• F(g) — Fitness score (0.0–1.0)
• V(g) — Safety score (0.0–1.0)
• Fidelity — Native / Wrapped / Hybrid
• Owner — Publisher (cloud only)

Example:

$ rotifer arena list
  ┌──────┬─────────────────────┬────────────┬────────┬────────┬──────────┐
  │ #    │ Name                │ Domain     │ F(g)   │ V(g)   │ Fidelity │
  ├──────┼─────────────────────┼────────────┼────────┼────────┼──────────┤
  │ 1    │ genesis-web-search  │ search.web │ 0.9200 │ 0.9500 │ Native   │
  │ 2    │ my-search           │ search.web │ 0.8234 │ 0.9100 │ Wrapped  │
  │ 3    │ genesis-search-lite │ search.web │ 0.7100 │ 0.8900 │ Native   │
  └──────┴─────────────────────┴────────────┴────────┴────────┴──────────┘

$ rotifer arena list --cloud -d search.web
  # Shows cloud rankings filtered by domain

---

rotifer arena watch

Watch Arena rankings in real-time, observing rank changes as genes compete.

rotifer arena watch <domain> [options]

Arguments:

Argument	Required	Description
domain	Yes	Domain to watch

Options:

Flag	Description
--cloud	Watch Cloud Arena (polling-based)
--interval <ms>	Polling interval in milliseconds (default: 3000)

Example:

$ rotifer arena watch search.web
  Watching search.web rankings...

  [14:32:01] Rank change: my-search ↑ #3 → #2 (F: 0.82 → 0.85)
  [14:32:04] New entry: fast-search entered at #4
  [14:32:07] No changes

  Press Ctrl+C to stop