Warband Integration

Warband.pro Integration — second-monitor flow

Goal

Make warband.pro answer "who do I play tonight" with truth, not API guesses.

Blizzard Profile API: 14 fields. Zero paths for gold, bank, bags, mail, auction, currencies, playtime, vault, lockouts (Warbandeer OpenAPI confirms 0 paths). Addon is only source.

Real behavior (design for this)

Not "install once, export once a month". Frequent, ambient, low-friction:

1. Log out, hit sync — roster screen already did LFR? Char logged. You glance second monitor, hit $ sync top-right, expect roster 1m ago now. Pure Battle.net side.
2. Loot meaningful / open vault / open warbank — Spark fragment, Vault 3/8→4/8, Warbank 200 crests, 20 phials from AH mail. Addon already snapped it (.5s throttle) without you remembering.
3. Tap to export/import — game primary monitor, eyes slide to web, i hotkey or click Import in [ ↻ sync / ↥ import ▼]. If clipboard already holds wb1! from 12s ago (/warband Enter Ctrl+C), web auto-grabs via navigator.clipboard.readText() inside that click — preview instantly, zero Ctrl+V. If denied, textarea auto-focused Ctrl+V.
4. Preview → Confirm → Tonight Plan flips — web shows 6 rows staleness dots. Confirm → D1 upserts each char. Missing chars stay, just stale (never deleted).
5. Repeat 4-10× per night — export <2 sec habit. Saturday before +12, paste once, all 6 current.

Omnipresent sink

Top-right MenuBar.astro combined:

[ ↻ sync / ↥ import ▼]

Every route — not tucked in Settings. Mirrors ghost sync buttons embedded in blocks (driven by same data-sync-all handler, so they never disagree about state).

Bottom line: API 12m · Addon freshest 2h · Warbank 1d (by Vocnar) — immediate trust signal.

Hotkeys

• 1-4 route switching, i opens import anywhere, ? help. ClientRouter does not re-execute scripts, so all client scripts init from astro:page-load.

When data matters

• 0 phials fresh → hard block "hit AH before raid"
• 0 phials 5d old (yellow) → grey "per last import 5d ago — verify?" not block
• Vault progress addon vs API — addon often fresher if you just opened vault on alt API hasn't fetched yet
• Crests/Tender near cap → "about to cap" warn when currencies surfaced later
• Warbank scattered — 47 Spark fragments across 3 chars suggests consolidate
• 120 phials in Warbank from Vocnar → don't block Vocgrim's +12, just "consolidate first"

Why not auto-upload?

Trust. You decide paste to your account. No background network. Stream-safe planned.

What does NOT happen

• No tooltip scanning (perf, taint)
• No full equipment scrape (API already has it)
• No mount/pet/toy full 10k list (counts only planned, too large)
• No guild bank (personal warbank only)
• No minimap button by default (Compartment is Blizzard's stated place, less bloat)

This flow is documented in warband-pro/app .wiki/wiki/topics/addon-import.md and shell-model.md §10 (import was route, then overlay, now rail field — why).