Schemas

Submission schemas

Version 1.0 public submission schemas — illustrative and compatible with the v1.0 protocol; no participant data. The paper is authoritative if there is a conflict; examples are in examples/.

Version  Version 1.0 Status  pre-pilot protocol proposal Data  illustrative — no participant data no official submissions yet

These six schemas describe the shape of a Version 1.0 submission, from a single target instance through to a leaderboard reporting row. They are provided so a team can prepare a well-formed run; they do not by themselves grant a score, and no participant data ships with them. Schemas are illustrative — where wording differs from the paper, the paper governs.

The six schemas

Each file is a standalone JSON Schema. Follow the Schema link to read the raw file served from this site, or the GitHub link to view it in the repository.

participant.schema.json

A target instance: the record that identifies one target and the instance being forecast — the who and the what, with no outcome attached.

evidence_manifest.schema.json

The evidence tiers, observation window, and hashes: which evidence streams were available up to the sealed time t, at what tier, with content hashes for auditability. Evidence, never a scored state.

forecast.schema.json

The sealed probability vector over the discrete answer space A, emitted and hashed at time t before the outcome exists.

outcome.schema.json

The resolved label: the observable answer recorded at resolution time r under the pre-registered, deterministic resolution rule.

submission.schema.json

The run manifest: ties a set of sealed forecasts to the system, track, split, and version that produced them, with the attestations a run requires.

leaderboard.schema.json

The reporting row: skill vs R1 and R2, calibration status, permutation result, evidence-tier lift, resolved-forecast and independent-target counts, horizon, domain, and result status.

How the abstract forecast unit maps to fields

The paper defines a forecast unit as (i, E≤t, q, A, r) — an instance i, evidence up to sealed time t, a query q about a future state, a discrete answer space A, and a resolution time r > t. In the v1.0 personal-track schemas that abstract unit maps onto concrete fields as follows.

Abstract unitSchema fieldLives in
targetparticipant_idparticipant.schema.json
instance itask_idparticipant.schema.json / forecast.schema.json
question qtask_typeforecast.schema.json
answer space Aanswer_spaceforecast.schema.json
evidence E≤tevidence_manifestevidence_manifest.schema.json
labelobserved_answeroutcome.schema.json

Inclusion rule. A target state is scored only if it has a pre-registered observable resolution rule; otherwise it is evidence, not a scored state. Attention, affect, and inferred goals are evidence and are never scored states. Self-report may be evidence but is never the outcome label when it is also a model input.

Next steps

Run the harness

See how the schemas feed the reference checks — sealing, deterministic resolution, R1/R2 baselines, calibration, and the permutation gate — on synthetic data only.

Product quickstart

For teams mapping a product's longitudinal traces onto a well-formed v1.0 submission, from target instance to sealed forecast.

A high score under these schemas certifies calibrated prospective predictive skill only — a target-specific predictive representation distinguished from generic prediction or routine replay. It does not certify understanding, inner life, causation, or permission to act on any person.