feat(healer): vitality healing, spell slot mutex, dead detection

[MahtraDR]

Summary

• Complete rewrite of healer.lic with parallel patient processing and non-blocking spell slot state machines
• Non-blocking queue via DownstreamHook: line monitor fires for every game line before it reaches the script buffer, so arrival/whisper/gesture triggers are never consumed by blocking bput/fput calls during patient processing
• Wounds before vitality: bleeding causes vitality loss, so wound transfer always takes priority over VH -- no more early VH claim while patient is still wounded
• Vitality Healing via VH spell (configurable vh waggle_set), with prep-first approach and reactive VH casting
• Spell slot mutex: FP, CD, and VH block each other (one at a time), while wound transfers interleave freely for other patients
• Dead patient detection: blocking heal via basic empathic link (no Unity), transfers all wounds in a loop with self-healing between rounds
• Emergency fall safety: if own vitality drops below 30%, fall to break all Unity links, enter recovery mode, resume when healthy
• Parasite/leech tending from perceived parasites (no spell needed, interleaves with wounds)
• Link Unity validation at startup via silent issue_command -- hard exit if not available
• VH waggle validation at startup -- prints example YAML config if vh waggle_set is missing
• Self-vitality floor (60%) safety net prevents taking vit when own health is dangerously low
• Spell slot timeout (45s) prevents permanent lock from stuck game state
• Friends-only filtering, moongate/arrival/gesture/lean/offer triggers
• Passive self-healing via Heal/Regenerate (30s max wait, spell-conflict-safe)

Architecture

DownstreamHook (IO thread)          Main loop (script thread)
  |                                   |
  v                                   v
queue_from_line(line)               drain buffer (gets?)
  |                                   |
  +-- match triggers? -> add_patient  process_queue()
  |                                     |
  +-- pass line through unchanged       +-- emergency check
                                        +-- spell slot processing (FP/CD/VH)
                                        +-- wound/patient processing
                                        +-- heal_self

The hook fires for every game line before it reaches the script buffer. Blocking operations in process_queue (bput, perceive_health_other, wait_for_passive_healing) consume lines from the buffer but can never consume trigger lines because the hook already processed them.

Settings

friends: [Tenuk, Navesi, Emeshest]
healer_waggle_set: healme
cambrinth: cambrinth ring
waggle_sets:
  vh:
    Vitality Healing:
      mana: 5
      cambrinth:
        - 5
      prep_time: 3

Test plan

• 65 RSpec examples pass (queue, spell slot, dead detection, triggers, parasites, VH state machine, afflictions, health checks, timeouts)
• Live test: patients no longer missed when healer is busy with other patients (DownstreamHook fix)
• Live test: wound healing, disease transfer, vitality healing end-to-end (Emeshest session)
• Live test: verify dead patient blocking heal cycle
• Live test: verify emergency fall recovery
• Live test: verify spell slot timeout recovery

🤖 Generated with Claude Code