{
  "name": "Warconomy live-data architecture",
  "asOf": "2026-06-05",
  "note": "How Warconomy thinks about live vs. delayed vs. manually-reviewed data, and what would have to change before any live/delayed layer could exist. Warconomy is static and manually maintained today; this adds no live capability and no numeric values, and makes no vendor claims.",
  "page": "https://warconomy.com/methodology/live-data",
  "notLive": "Warconomy is not live market data, not a live AIS tracker, and not a live closure monitor. Every value is manually reviewed and dated; nothing updates in real time.",
  "dataModeTiers": [
    {
      "mode": "Manually reviewed (static)",
      "whatItMeans": "A value transcribed by hand from a cited public source, with an as-of date and a last-reviewed date. Re-verifiable and citable, but not real-time and not automatically updated.",
      "warconomyToday": "This is the entire current architecture. Every live/static value is this mode."
    },
    {
      "mode": "Delayed / periodic",
      "whatItMeans": "A dated snapshot pulled on a cadence (e.g. daily or weekly) from a source whose terms permit publishing a derived value. Clearly labeled as delayed, never as 'now'.",
      "warconomyToday": "Not implemented. A future possibility only if a permissive, ideally free, source is found and approved."
    },
    {
      "mode": "Live / real-time",
      "whatItMeans": "A continuously-updating value. Requires a runtime service and a provider whose terms allow live redistribution — and carries the highest risk of implying certainty the data can't support.",
      "warconomyToday": "Explicitly out of scope. Warconomy does not and will not claim live market data or live tracking under the current rules."
    }
  ],
  "whyStatic": [
    "A citation engine needs every figure to be dated and re-verifiable from its source — static, hand-reviewed values guarantee that.",
    "The project rules forbid scraping, paid APIs, runtime services, scheduled jobs, and background workers by default.",
    "Static prerendered files have no keys, no rate limits, no servers, and no tracking — they are cheap, fast, and durable.",
    "Honest labeling (live/static vs. sample, with as-of and reviewed dates) is easier to keep truthful when nothing updates behind the reader's back."
  ],
  "whatLiveRequires": [
    {
      "area": "Runtime",
      "requirement": "A runtime service or scheduled fetch — neither exists today and both are out of scope by default."
    },
    {
      "area": "Provider terms",
      "requirement": "A source whose license permits publishing (and caching) a derived value, with attribution honored exactly."
    },
    {
      "area": "Caching",
      "requirement": "A storage/caching policy compatible with a prerendered, no-runtime architecture."
    },
    {
      "area": "Rate limits",
      "requirement": "Limits compatible with occasional, manual or low-frequency reads — not a live polling client."
    },
    {
      "area": "Cost",
      "requirement": "Zero cost, or a deliberately approved, bounded amount — paid APIs are out of scope by default."
    },
    {
      "area": "Data quality",
      "requirement": "A documented way to handle gaps, revisions, and spoofing, so a value is never presented as ground truth."
    },
    {
      "area": "Historical access",
      "requirement": "Access to history so any value can be dated and re-checked, not just 'now'."
    }
  ],
  "reviewGates": [
    "The exact source, value, unit, and period are known and directly readable (no inference from charts).",
    "The value is transcribed via the documented promotion workflow and recorded in the promotion log.",
    "An as-of date and a last-reviewed date are attached; freshness is computed against the source cadence.",
    "Sample rows stay labeled sample until a directly-verifiable official figure replaces them."
  ],
  "antiFalseLive": [
    "No page claims real-time data, live market prices, or live vessel positions.",
    "Dated snapshots are labeled with their as-of date; stale values are flagged for re-check, not silently refreshed.",
    "Schematics and explainers are clearly marked as conceptual, not live monitors.",
    "Caveats state plainly what the data is not (not investment, legal/compliance advice, or complete coverage)."
  ],
  "marketDataRoadmap": [
    {
      "family": "Official transit / canal indicators",
      "whatWouldBeUseful": "Dated transit counts, tonnage, or revenue from a canal/transit authority or intergovernmental body.",
      "constraint": "Best fit for the static model — but several are PDF-only or behind inaccessible pages today (see the operator workbench)."
    },
    {
      "family": "Oil & gas benchmarks",
      "whatWouldBeUseful": "Source-reported benchmark levels (e.g. an official statistical agency series), dated and re-verifiable.",
      "constraint": "Some official levels are in downloadable spreadsheets (binary), not readable HTML; no binary parsing."
    },
    {
      "family": "Freight & shipping-cost indicators",
      "whatWouldBeUseful": "War-risk insurance or freight-rate indicators associated with chokepoint disruption.",
      "constraint": "Frequently paywalled or licensed; would need an accessible, reusable source. Associative context, not causal."
    },
    {
      "family": "Maritime / AIS indicators",
      "whatWouldBeUseful": "Delayed vessel-density or tanker/LNG transit counts for a chokepoint region.",
      "constraint": "Covered in detail by the maritime data evaluation; spoofing and reuse-rights risks make links-only the safe default."
    }
  ],
  "maritimeEvaluation": "https://warconomy.com/methodology/maritime-data",
  "operator": "https://warconomy.com/operator"
}