Staleness

Staleness

Site shows per-character dot and hover. Freshness lives per-section inside payload not on D1 row, because bundle pasted this minute can carry 9-day-old bank.

Thresholds Mirroring Addon ns.dot() In Init.lua

From src/lib/warband-import.ts same numbers both sides. If thresholds move, move both.

• Green fresh under 6 hours
• Yellow aging under 3 days
• Red stale beyond 3 days
• Grey never (stamp absent)

character_addon_cache.fetched_at_ms is "when user last pasted". Section dot is "how current is this section".

seenAt.{lastSeen,bag,bank,warbank,currency,instance,vault,mail,auctions,profession} Unix seconds WoW time() and GetServerTime(). Web converts milliseconds. Mistake reading seconds as milliseconds lands in 1970 all stale. Milliseconds as seconds lands in year 56000 all fresh forever. Tests assert both.

UI

• Site Inspector "Addon import" section
• Hover "Bags 2h ago, Bank 5d (open bank to refresh), Warbank 14d"
• Tonight Plan
  • 0 Phials fresh 20 minutes -> hard block "Hit auction house before raid"
  • 0 Phials 5 days old -> grey "Per last import 5 days ago verify" not block
• Preview table on import keeps old snapshot if character missing from bundle -> aging red, never deleted. Missing not gone.

Unknown Versus Zero

• Bank never opened -> omit -> UI "Not opened" not "0 free" (0 free reads as full, sends player to clear space they have)
• Consumables unknown until ID table filled -> absent not zero (Tonight Plan would hard block on 0)

Data never deletes, stale lowers confidence.

Warband Bank Trust

• Warbank seen 1 hour ago by Vocnar still present even if you exported from Voctara who did not open bank -> shared account-wide tabs.
• Dots "Warbank 1h (by Vocnar)" credit line.
• Tabs account-wide warband_bank_cache one row per user, character seenAt.warbank per character for who last stood at banker.

Freshness Line Why Sink Matters

Top-right [ Sync / Import ] bottom small API 12m · Addon 2h · Warbank 1d (by Vocnar) is immediate trust signal.

Addon Panel Freshness

Export header 6 characters · freshest 12m · Warbank 1h (by Vocnar) so you know before copying if content is stale.

Sync Consideration

Battle.net side $ sync refreshes roster, vitals, lockouts and reloads (deliberate, rail $ sync block is server-rendered, in-place would leave freshness readout stale). Addon import never reloads, only line stamped.

Tested

• Vectors v1-min.json sanity
• Manual: open bank -> export -> paste -> hover shows bank now fresh green