feat(currency_wars): complete systems, settlement Rank SS, damage report, camera and recovery fixes

docs/cw-route-continuation-audit.md

@@ -1,5 +1,11 @@
 # Currency Wars route continuation audit
 
+**2026-10-31 update:** An initial xaodev-based generated EliteBranch factory
+has now been connected to the route fallback. The older unsupported-factory
+statements below describe the preceding implementation. The new code passes
+CW automated tests but has no Client gameplay confirmation; see
+`CW-XAODEV-CLAUDE-HANDOFF.md` for provenance, limits and pending integration checks.
+
 The captured route 2801 contains these node types after the first boss:
 
 | Chapter | Sections in order |
@@ -85,5 +91,16 @@ Client's obfuscated enum has matching numeric slots, but only Quit=1 has been
 confirmed for the current implementation. The reference `gfSettleSend` builds
 and archives a settlement record before sending the settlement notification.
 The names and fields of its rank/reward/archive components must be mapped to
-the current Client before a completion handler can safely persist rewards and
-clear the active run. No saved run has been modified by this audit.
+## Pipeline Integration Test Verification
+
+An automated end-to-end integration test (`TestCurrencyWarsSupplyToEncounterBattleSettlementPipeline`) in `internal/gameserver/currency_wars_xaodev_test.go` has verified the full generated route progression on an isolated temporary environment:
+1. **Supply Selection (Route 2801, Ch 2, Sec 2)**: Completes supply selection and advances to Ch 2, Sec 3 (`EliteBranch`).
+2. **Xaodev Encounter Generation**: Generates the two-branch encounter layer via `cwGenerateXaodevEncounter`, setting the server-side runtime marker `XaodevEncounter/2801/2/3:1` in `runtime.Rules`.
+3. **Round Preparation**: Transitions the round state to `SelectingEncounter` via `cwGeneratedRoundPreparation`.
+4. **Branch Selection & Difficulty Bonus**: Selecting Branch 2 correctly applies the branch difficulty bonus (`baseStage.EnemyHardLevel + branchAdd`) to `stage.ANJBLBEOJND.PIJBPDPEODG` and transitions to `ReturnPreparation`.
+5. **ReturnPreparation**: Safely clears the pending queue.
+6. **Battle Building**: `buildCurrencyWarsBattle` produces the scene battle info with matching hard level and verified battle avatars.
+7. **Settlement & Clean Difficulty Reset**: `finishCurrencyWarsBattle` credits rewards (gold and level/exp), advances the route to Ch 2, Sec 4 (`Monster`), and resets branch difficulty back to 0.
+8. **CAS Roundtrip Persistence**: Reloading from storage verifies that state updates, monotonic revisions, and difficulty resets persist accurately.
+
+*Note: All automated tests pass; actual in-game battle flow and client rendering await user verification.*