COUCHCORE WOW v0.3.0 — RETAIL WORLD OF WARCRAFT
=================================================

NEW IN v0.3.0
-------------
- Added persistent Test Mode.
- Test Mode compresses the four live progression phases into Levels 1–8:
  * Levels 1–5 = live Levels 1–29 rules
  * Level 6 = live Levels 30–39 rules
  * Level 7 = live Levels 40–49 rules
  * Level 8+ = live Level 50+ rules
- Added automatic phase explanation popups.
- Added a manual "View Phase Guide" button and /ccw phase.
- Added a visible TEST MODE indicator in the main dashboard.
- Added a distinct custom Couchcore UI style rather than mirroring Dragon Couch Points.

LIVE RULES
----------
ARMOR + CLOAK
- Levels 1–29: Common (White) maximum
- Levels 30–39: Uncommon (Green) maximum
- Levels 40–49: Rare (Blue) maximum
- Level 50+: Epic (Purple) maximum

WEAPONS + OFF-HANDS / SHIELDS
- Levels 1–39: Uncommon (Green) maximum
- Levels 40–49: Rare (Blue) maximum
- Level 50+: Epic (Purple) maximum

EMPTY SLOTS
- Neck
- Ring 1
- Ring 2
- Trinket 1
- Trinket 2

Shirts and tabards are ignored.

TEST MODE
---------
Test Mode changes only the level thresholds used to determine the current rule phase.
The actual rules inside each phase are identical to the live challenge.

- Levels 1–5 -> Phase I / live Level 1–29 rules
- Level 6 -> Phase II / live Level 30–39 rules
- Level 7 -> Phase III / live Level 40–49 rules
- Level 8+ -> Phase IV / live Level 50+ rules

Use the dashboard button, /ccw testmode, /ccw testmode on, or /ccw testmode off.
The setting is stored per character.

PHASE POPUPS
------------
Couchcore now presents a dedicated explanation card when a character first reaches each phase.
The card explains:
- Current phase and level range
- Armor/cloak maximum quality
- Weapon/off-hand/shield maximum quality
- Neck/ring/trinket restrictions
- 30-second accidental-equip grace rule

The current guide can always be reopened with the dashboard button or /ccw phase.

GRACE / VIOLATION LOGIC
-----------------------
1. Equipping illegal gear starts a 30-second correction window.
2. A large on-screen warning appears.
3. Removing all illegal gear before the deadline clears the warning and records nothing.
4. Entering combat while illegal gear is equipped immediately invalidates the challenge.
5. Equipping illegal gear while already in combat immediately invalidates the challenge.
6. Leaving illegal gear equipped for the full 30 seconds invalidates the challenge.
7. Grace state is stored per character. Reloading/logging out does not reset an active deadline.
8. Once invalidated, the character can keep playing; Couchcore WoW records the run as INVALID.

COMMANDS
--------
/ccw                     Toggle Couchcore dashboard
/couchcore               Toggle Couchcore dashboard
/cc                      Legacy convenience alias
/ccw status              Print run status, mode, and phase
/ccw rules               Print current phase rules
/ccw phase               Reopen current phase guide
/ccw check               Manually scan equipped gear
/ccw log                 Print violation history
/ccw testmode            Toggle Test Mode
/ccw testmode on         Enable Test Mode
/ccw testmode off        Disable Test Mode
/ccw testreset           ALPHA ONLY: reset local VALID/INVALID state and violation history

SUGGESTED TEST PASS
-------------------
1. Create/use a Level 1 Retail character.
2. /ccw testmode on
3. Confirm Levels 1–5 use White armor / Green weapon rules.
4. Reach Level 6 and confirm the Phase II popup appears and Green armor is legal.
5. Reach Level 7 and confirm the Phase III popup appears and Blue armor/weapons are legal.
6. Reach Level 8 and confirm the Phase IV popup appears and Purple armor/weapons are legal.
7. At every phase, confirm Neck/Rings/Trinkets remain illegal.
8. Test the 30-second grace rule and combat invalidation at more than one phase.
9. /reload during an active grace timer and confirm the original deadline is preserved.
10. Disable Test Mode and confirm live level thresholds immediately return.
