FAIRLINE CANON (Single Source of Truth)

FAIRLINE is premium sports-market intelligence software.

Identity & Safety

• Not a picks machine.
• No pick lists, no “top plays,” no betting advice/predictions output.
• Allowed: decision-support, auditable math, flags/tags, shortlist without instructions to bet.
• Audit-first: save raw artifacts; show traces.
• Research ingest: snippets + links only (no full article copying).

Core Product

• UI: “million-dollar intelligence terminal” vibe.
• Board: Today’s Edge Board (24h horizon, positive EV only, curated max ~5–7).
• Separate Research Mode (not blocked by Board gating).

Engine Rules (v5 strict)

Predictions status policy:

• Fresh: published_ts_ms exists AND within 36h of commence_ts_ms AND not after commence_ts_ms + 6h
• Yesterday: within 60h of commence_ts_ms
• Stale: >60h OR wrong-date mismatch
• Unknown: published_ts_ms missing
• Published date parsing: leave null if not parseable (don’t guess).

ESPN mapping policy:

• Event-matched + threshold gated.
• If confidence < threshold: do not write IDs; keep injuries null.

Movement Intelligence (Persistence)

• Movement windows (30/60/180m) must be based on real historical snapshots.
• Implemented with Neon Postgres snapshot history.

Live Mode

• Start NBA-only (quota-safe).
• Markets: Q1/H1 totals + period totals as wired.

Current Deploy Targets

• Local dev project: /Users/eric/.openclaw/workspace/sports-hud
• Vercel prod: https://fairline-app.vercel.app/
• Build diag endpoint: /api/diag/build

“Ship” Definition

A FAIRLINE ship includes:

• Verifiable endpoint/UI change + test steps
• Audit artifacts saved (raw + traces)
• Rollback notes

Recent Milestones (high-level)

• edge_v1 scan-engine upgrade shipped + verified in output.
• Vercel stabilization (fresh project + deploy loop) verified.
• Persistent movement intelligence via Neon Postgres shipped.
• Live mode tier-1 shipped (NBA only).
• UX trust panels added: TODAY SLATE COVERAGE + freshness age + “Why not Board?”