promotional bannermobile promotional banner
premium banner

Cerebro-Support

Automated sync test harness for Cerebro sync

Description

Cerebro Support — Automated Sync Test Harness

One officer. One command. Fifteen seconds. A complete raid-wide sync health report — without ever touching your EPGP data.

Cerebro Support is a companion addon for Cerebro EPGP. It lets a single officer fire a fully automated diagnostic across every Cerebro Support user in the raid and aggregates the results into a single in-game report. No coordination, no manual command sequences, no second human required.

What it tells you

  • Who has Cerebro Support installed and is reachable — instant participation rate
  • Whether everyone is on the same Cerebro version — version drift detection
  • Whether your officer rosters are pre-converged — hash diversity at run start
  • Per-target whisper reachability — catches the silent "looks online but can't receive sync" bug class (Scenario S8)
  • Sync Leader gating health — flags the "multiple officers fan-out broadcasting" thundering-herd symptom (Scenario S9)
  • Per-participant V2 dispatch counts — passive measurement of how much sync traffic each client sees

The report opens in a movable, scrollable, selectable in-game frame — easy to read, easy to copy-paste into Discord. A /cbs export command writes the same data as JSON to your SavedVariables for out-of-game tooling.

Commands

<button class="copyButton_CEmTFw copyButton_-a7MRw" title="Copy code" aria-label="Copy code to clipboard"></button> 
/cbs status   — show contract version, officer status, observer state
/cbs run      — fire end-to-end health check (officer-only)
/cbs report   — re-display the most recent report
/cbs export   — write the most recent report as JSON to SavedVariables
/cbs help     — show command list

Safety

This addon is built around the Cerebro Support API contract (SPEC §8 in the Cerebro repository) which guarantees nine load-bearing safety invariants:

  • Test runs are officer-only — fails closed for non-officers
  • All production EPGP mutations are dropped while a test is active — never touched, never redirected
  • Test mode auto-exits after a bounded deadline (max 120 seconds), even if the orchestrator crashes
  • Test state never persists to SavedVariables — a /reload always restores production state
  • Combat gating remains in effect during tests
  • Contract version mismatches refuse to operate — no silent degradation if Cerebro is incompatible

Cerebro Support owns its own SavedVariables file and an exclusive AceComm prefix (CBST). It is physically incapable of touching CerebroDB or interfering with production sync traffic. This is enforced from the Cerebro side, not just promised by this addon.

Requirements

  • Cerebro 0.12.0 or later (required — introduces the Support API contract)
  • World of Warcraft Retail (Interface 110002 / 120001)

The addon will refuse to operate against incompatible Cerebro versions and print a clear diagnostic on login.

Raider opt-out

Raiders participate by default — their HELLOs and reports cost negligible bandwidth and provide the highest-value signal in the report. To opt out, set CerebroSupportDB.config.allowParticipation = false in your SavedVariables.

Who is this for?

  • Officer teams running raids who want to know their sync is healthy before loot drops
  • Cerebro maintainers who want quantitative data on sync behavior across real raids instead of "we ran a raid and it seemed fine"
  • Anyone debugging weird per-player sync inconsistencies — the per-target reachability and version drift KPIs surface problems that are otherwise invisible