Update Healer Man server

docs/HEALER_MANA_RECOVERY_2026-10-06.md

@@ -0,0 +1,44 @@
+# Healer mana recovery
+
+A living player or NPC healer now supplies **Healer Mana Recovery** to living
+mana users in the local party between fights. The buff restores **15% of each
+recipient's maximum mana per second**, in addition to existing recovery. It
+supports primary and secondary mana pools, caps at maximum, and does not stack
+with multiple healers. It grants no recovery while any living enemy is engaged
+or has party threat. Dead recipients and parties without a living healer are
+excluded. Native RoM recovery formulas and pulse cadence remain unchanged.
+
+**Pause > Options > Gameplay and interface > Healer mana recovery** toggles
+the buff. It defaults to On, including for older profiles missing the setting.
+Changes use normal character settings persistence. Turning it off removes
+existing applications immediately. The player status panel and mana-using
+NPC frames show its icon and tooltip.
+
+## Ownership
+
+- `src/game/healerManaRecovery.ts`: definition, provider selection, recipients,
+  non-stacking lifecycle, and maximum-mana recovery amount.
+- `src/game/combatStore.ts`: saved setting, combat gating, player recovery.
+- `src/game/partyRuntime.ts`: companion recovery and shared aura refresh.
+- `src/ui/OptionsPanel.tsx`, `src/ui/PartyFrames.tsx`: menu and buff display.
+- Native recovery parity tests explicitly disable the convenience aura.
+
+## Verification
+
+136 focused tests pass across the new recovery integration, native recovery
+parity, combat store, Options, and AuraStrip suites. Ready-five verification
+passes (7 Vitest and 20 Python checks). The final production build, static bundle verification, and release
+candidate check pass.
+
+`scripts/playtest-healer-mana-recovery.cjs` enters Cellblock Rush through the
+normal dungeon picker using an isolated offline RoM Priest profile. The final
+run selected Targorr the Dread, as observed in its live Boss Guide. Pre-entry
+profile preparation sets level 30. Ordinary menu clicks switch the buff off
+and on; ordinary Urgent Heal spending is followed by natural idle recovery.
+Evidence lives in `artifacts/playtest/healer-mana-recovery/`, including loaded
+asset URLs, actual selected boss from the live guide, saved toggle state,
+resource samples, desktop and 960x540 menu screenshots, and runtime errors.
+Exact rate, combat transitions, NPC providers and recipients, no stacking,
+healer death, and maximum clamping are verified by focused integration tests.
+The browser run is an idle recovery and UI check, not a boss-clear or broader
+RoM balance certification.