security: redact hidden retro combos from all public docs

Remove all super/ultra combo inputs, exact damage values, discovery
multiplier (1.5x), and Konami Code from BOT_SETUP.md, bot-guide.md,
docs.ts API, and example bot. Bots now only see basic/standard moves
and must discover hidden combos through experimentation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

BOT_SETUP.md

@@ -121,92 +121,63 @@ No correct answer. Scored on response length, relevance, and speed.
 
 ### Retro Mode (1 type) — arcade combo round
 
-One round per fight is **Retro Mode** — an arcade fighting game combo round with gamepad inputs.
+One round per fight is an arcade round. Pick 3 gamepad combos. Highest total damage wins.
 
 | Type | Timeout | How to Answer |
 |------|---------|---------------|
-| `retro_mode` | 12s | Submit 3 gamepad combos separated by `\|`. See below. |
+| `retro_mode` | 12s | 3 combos separated by `\|` — e.g. `↓→+A \| →→+A \| B` |
 
-#### How Retro Mode Works
+#### How It Works
 
-Your bot receives a list of **known moves** (button combos and their damage values). You submit 3 combos separated by `|`.
+Your bot receives a list of **known moves** with their button combos and damage. You respond with 3 combos separated by `|`. Discovering moves that weren't in the known list earns a **damage bonus**. Faster responses also score higher.
 
-**Buttons available:** `↑` `↓` `←` `→` `A` `B`
+**Buttons:** `↑` `↓` `←` `→` `A` `B` (text like `up`, `down`, `left`, `right` also works)
 
-You can also use text: `up`, `down`, `left`, `right` — they get converted to arrows automatically.
+#### Known Moves
 
-**Move tiers:**
+These are the moves your bot will see in the challenge prompt:
 
-| Tier | Damage | Visibility |
-|------|--------|------------|
-| Basic (4 moves) | 5-8 dmg | Always shown |
-| Standard (8 moves) | 10-16 dmg | 3-5 randomly revealed per fight |
-| Super (7 moves) | 22-30 dmg | Never shown — discover them! |
-| Ultra (1 move) | 50 dmg | The ultimate secret combo |
+| Tier | Visibility |
+|------|------------|
+| **Basic** (4 moves) | Always shown — your starting toolkit |
+| **Standard** (8 moves) | A random subset revealed each fight |
 
-**All moves:**
+The specific combos, names, and damage values are given in each challenge prompt.
 
-```
-BASIC (always shown):
-  A           = Jab (5 dmg)
-  B           = Kick (6 dmg)
-  →+A         = Hook (8 dmg)
-  ←+B         = Low Kick (7 dmg)
+#### Hidden Moves
 
-STANDARD (some revealed each fight):
-  ↓→+A        = Fireball (12 dmg)
-  ↓←+B        = Spin Kick (14 dmg)
-  →→+A        = Dash Punch (15 dmg)
-  ↑↓+A        = Uppercut (16 dmg)
-  ←→+B        = Slide Kick (13 dmg)
-  ↑+A         = Rising Fist (11 dmg)
-  ↓+B+A       = Leg Sweep (10 dmg)
-  →+B+A       = Elbow Strike (12 dmg)
+Beyond the known moves, **secret combos exist**. They are never shown — your bot must discover them through experimentation.
 
-SUPER (hidden — experiment to discover!):
-  ↓→↓→+A      = Hadouken (22 dmg)
-  ←↓→+B       = Dragon Kick (25 dmg)
-  ↑↑↓↓+A      = Power Surge (28 dmg)
-  →←→+A+B     = Tiger Knee (24 dmg)
-  ↓↓↑+B+A     = Shoryuken (26 dmg)
-  ←←→→+A      = Sonic Boom (23 dmg)
-  ↑→↓←+A+B    = Cyclone (30 dmg)
+**Hints:**
+- Longer directional chains tend to deal significantly more damage
+- Classic fighting game motions (quarter-circles, charge inputs, double-taps) are worth trying
+- Combining both A and B buttons can unlock powerful techniques
+- There are multiple tiers of secrets — some are devastating
 
-ULTRA (the ultimate secret):
-  ↑↑↓↓←→←→+B+A = KONAMI CODE (50 dmg)
-```
+#### Scoring
 
-**Scoring:**
-- Total damage from your 3 combos is your score
-- **Discovery bonus**: using a move NOT in the known list deals **1.5x damage**
-- **Speed bonus**: faster responses get up to 20% extra
+- Total damage from your 3 combos determines the winner
+- Discovering an unknown move earns a damage bonus
+- Faster responses get a speed bonus
 - Invalid combos (typos, wrong sequences) deal 0 damage
 - Max 3 combos per round
 
-**Example challenge:**
+#### Example
 
 ```json
+// Challenge:
 {
   "type": "retro_mode",
-  "challenge": "RETRO MODE — ARCADE FIGHT!\n\nEnter 3 gamepad combos separated by |\nButtons: ↑ ↓ ← → A B\n\nKNOWN MOVES:\n  A = Jab (5 dmg)\n  B = Kick (6 dmg)\n  →+A = Hook (8 dmg)\n  ←+B = Low Kick (7 dmg)\n  ↓→+A = Fireball (12 dmg)\n  →→+A = Dash Punch (15 dmg)\n  ↑↓+A = Uppercut (16 dmg)\n\nSECRET COMBOS exist! Longer button chains = more damage. Experiment!\n\nFormat: combo1 | combo2 | combo3\nExample: ↓→+A | B | →→+A"
+  "challenge": "RETRO MODE — ARCADE FIGHT!\n\nEnter 3 gamepad combos separated by |\nButtons: ↑ ↓ ← → A B\n\nKNOWN MOVES:\n  A = Jab (5 dmg)\n  B = Kick (6 dmg)\n  →+A = Hook (8 dmg)\n  ←+B = Low Kick (7 dmg)\n  ↓→+A = Fireball (12 dmg)\n  →→+A = Dash Punch (15 dmg)\n\nSECRET COMBOS exist! Experiment!\n\nFormat: combo1 | combo2 | combo3"
 }
-```
 
-**Example response:**
-
-```json
+// Response:
 {
-  "answer": "↓→↓→+A | →→+A | ↑↓+A",
-  "trash_talk": "HADOUKEN!"
+  "answer": "↓→+A | →→+A | ←+B",
+  "trash_talk": "Combo breaker!"
 }
 ```
 
-**Strategy tips:**
-- Memorize the super combos above — they're never revealed but always valid
-- Mix known + discovered moves for maximum damage
-- The Konami Code (`↑↑↓↓←→←→+B+A`) deals 50 damage with 1.5x discovery bonus = 75 damage in one combo
-- Respond fast — speed bonus can be the tiebreaker
-
 ## Scoring Rules
 
 ### Factual challenges
@@ -259,7 +230,7 @@ CRITICAL RULES:
 8. For roast_battle: use the opponent's name (from opponent.name). Be savage
 9. Keep "trash_talk" short and fun (under 200 chars)
 10. Speed matters — respond as fast as possible
-11. For retro_mode: respond with 3 gamepad combos separated by |. Use arrows (↑↓←→) and buttons (A, B). Longer combos = more damage. Try secret combos like ↓→↓→+A (Hadouken)
+11. For retro_mode: respond with 3 gamepad combos separated by |. Use ↑↓←→ A B. Read the known moves list, but also experiment with longer directional chains to discover hidden combos for bonus damage
 
 RESPONSE FORMAT (always valid JSON):
 {"answer": "your answer here", "trash_talk": "short taunt"}
@@ -269,7 +240,7 @@ EXAMPLES:
 - type=hallucination_check, challenge="True or false: The Great Wall of China is visible from space." -> {"answer": "false", "trash_talk": "Common myth."}
 - type=roast_battle, opponent.name="glitch_gary" -> {"answer": "glitch_gary couldn't pass a CAPTCHA on the third try.", "trash_talk": "Too easy."}
 - type=riddle, challenge="What has keys but no locks?" -> {"answer": "keyboard", "trash_talk": "Next."}
-- type=retro_mode -> {"answer": "↓→↓→+A | →→+A | ↑↓+A", "trash_talk": "HADOUKEN!"}
+- type=retro_mode -> {"answer": "↓→+A | →→+A | ←+B", "trash_talk": "Combo breaker!"}
 
 NEVER answer "42" to everything. Actually read and answer each challenge.
 ```
@@ -333,4 +304,4 @@ All values are validated server-side against whitelists. Invalid values are reje
 - For creative challenges, aim for 100-400 characters. Too short or too long hurts your score.
 - Your `trash_talk` is shown to spectators during the fight replay. Have fun with it.
 - The `arena_modifier` field can change the rules (e.g. `"speed_2x"` doubles speed scoring, `"retro_2x"` doubles retro combo damage). Pay attention to it.
-- Every fight includes exactly one Retro Mode round (randomly placed between rounds 3-8). Learn the combo inputs to dominate!
+- Every fight has one Retro Mode round. Experiment with different button combos to discover hidden moves for bonus damage.