Expand augurScan protocol operations analytics

[KillariDev]

Summary

Completes the augurScan Protocol Operations and Analytics expansion and fixes A1–A8 at their shared indexer, database, API, and browser layers. Solidity behavior is unchanged.

Implemented features

• Operations: freshness header, evidence-first overview, semantic queues, reports, escalations, auctions, risk, forks, and recent transitions.
• Reports: chain-scoped OpenOracle identities, preserved rounds, exact block/timestamp lifecycle boundaries, settlement/coordinator evidence, catalogs and detail views.
• Escalations: outcome stake aggregation, phases, deposits, claims, continuation evidence, timelines, catalogs and detail views.
• Auctions: lifecycle, bids, demand, finalization/settlement evidence, exact analytics, catalogs and detail views.
• Risk: tagged pool/vault snapshots, coherent as-of boundaries, protocol state separated from scanner severity, bad debt, capacity, health, liquidation, approval lifecycles, and price validity.
• Timelines: canonical semantic timelines for reports, pools, vaults, questions, universes, forks, AMMs, and approvals.
• Address/trading/forks: address evidence and positions, AMM swaps/liquidity/volume/TWAP/candles, fork migration aggregation and continuation relationships.
• Price provenance: coordinator/OpenOracle plus Uniswap V2/V3/V4 REP/WETH, REP/native-ETH, and REP/USDC prices and liquidity, with exact ratios and freshness.
• UI corrections: removes Registry source and First protocol discovery block, renames Code present at to Deployed at, stabilizes loading layouts, and serializes live refresh/pagination work.

Root-cause fixes

• A provider reporting head 0 can no longer turn eth_getCode(latest) into a false “Deployed at #0” claim. Pre-index state is explicitly Awaiting indexed evidence.
• Fresh schema initialization uses one transaction boundary on the reserved advisory-lock connection, eliminating nested BEGIN/COMMIT warnings.
• Operations pagination follows EVM execution order (block_number, log_index, tx_hash), retains visible depth, and rejects stale boundary/network results.
• Manifest resets mark tagged snapshots stale and noncanonical so replay resamples current state.
• Approval associations require both registry and approval ID; consumed, unused released, and resulting debt balances remain distinct evidence.
• Fresh databases contain only the current timeline identities and block-global log ordering; no legacy cleanup path remains.

Architecture

• One authoritative schema.sql for disposable fresh databases; ordered migrations and in-place upgrades are removed.
• Typed, idempotent, canonical/reorg-aware projections and bounded tagged-block snapshots.
• Exact decimal-string JSON and rational price calculations.
• Keyset-paged API catalogs/details with indexed-head envelopes.
• Operations routes, accessible loading/empty/error states, evidence disclosures, responsive charts/tables, and SSE refresh coordination.
• Demo fixtures and documentation in README.md, PLAN.md, and STATE_MODEL.md.

Validation

• bun run tsc — passed.
• cd augurScan && bun test — 242 passed, 2 PostgreSQL-environment skips, 0 failed, 994 expectations.
• PostgreSQL 17 fresh-schema validation — empty initialization and current restart passed; legacy, malformed-marker, relation-, enum-, routine-, collation-, and operator-only schemas were rejected with wipe guidance and no partial tables; focused Operations integration passed with 39 expectations.
• Whole-repository test cycle — 2,942 passed, 16 external-network skips, 0 failed, 9,020 expectations.
• bun run format:check — passed.
• bun run check — passed.
• bun run knip — passed.
• git diff --check — passed. Branch merged with current origin/main, preserving the statoblast rename.
• Documentation review — 100/100, no findings.
• Visual review — 96/100, no findings.
• Final repository review — 100/100, no findings.

UI evidence

Operations overview

Reports and live pagination

Escalations

Auctions — mobile

Risk and approval evidence

System state price, liquidity, and OpenOracle history

Address interactions — mobile

Visual QA used Chrome 151 at 1440×900 and 390×844. It covered delayed pagination with multiple SSE refreshes, cross-network switching, dense exact values, stale and caught-up freshness, responsive wrapping, focus retention, and console/runtime errors (none observed).