Forecast

Dated shutdown early-warning commitment ledger (no performance score)

Changed on

The rows of https://voidly.ai/early-warning/commitments.jsonl, parsed with the page's own strict parser: one malformed row refuses the whole read. A well-formed row naming an arm the parser does not know, or a row of an unknown record_type, is left out and counted in log.skipped_unknown_arm or log.skipped_unknown_record_type. Each commitment row is one forecast issue day, either committed (the forecast file's SHA-256 and its comparison arms: the five step-1 arms, or those five plus hazard_a) or missed_zero_alerts (no committed file; scored as zero alerts; sha256 null, arms empty). Arm-version cutover records (arm, effective instant, pre-registered SHA-256, note) are returned in cutovers; a committed row dated before the recorded cutover of an arm it lists is kept and marked before_cutover. Label-lane cutover records (arm: label_lane, one row per labeling-rules version from v2 on; see the dated records https://voidly.ai/early-warning/label-lane-v1.json to https://voidly.ai/early-warning/label-lane-v4.json) are returned in lane_cutovers and are not counted as skipped. A committed hash lets a later-released forecast file be checked against the commitment; it does not prove when the file was issued. This is a commitment ledger with no performance score yet (performance_score is null): it makes no accuracy or lead-time claim, and alerts, alert counts and scores are not disclosed. fetched_at is when this API read the published file, not when any forecast was issued. log, cutovers and lane_cutovers always describe the whole log; since narrows only commitments and returned. Edge-cached: the first read answers X-Voidly-Cache: MISS, then the same document is served for five minutes as HIT (Cache-Control: public, max-age=0, must-revalidate). For up to one further hour a retained copy may be served as STALE with Cache-Control: no-store and Warning: 110 while it refreshes in the background. A missing, redirected, oversized or malformed source with no retained copy answers 503 with Cache-Control: no-store and no partial data.

get/v1/early-warning/commitments

Request

  • Base URL
    https://api.voidly.ai
  • URL
    https://api.voidly.ai/v1/early-warning/commitments
  • Auth
    none required

Query parameters

sincestring date

Optional UTC calendar date written YYYY-MM-DD; returns rows dated on or after it. At most one; any other query parameter answers 400.

Response

The commitment ledger with provenance and caveats.

schema'voidly.early-warning.commitments-read.v1' required
source_urlstring uri required
page_urlstring uri required
protocol_urlstring uri required
fetched_atstring date-time required
performance_scoreobject nullable required

Always null: no performance score is published yet.

caveatsstring[] required
sincestring date nullable required
returnedinteger required

Changes