Data Dictionary
Fields Behind The Ledger
Each card now exposes a small audit record. These fields prepare the site for revision logs, CSV and JSON exports, source challenges, and data-license products.
claimId
- Values
- asl:<slug> unless an explicit card ID is set
- Use
- Stable identifier for score revisions, source changes, exports, and correction requests.
evidenceQuality
- Values
- primary/court record; official/primary data; court record; official data; academic/data research; watchdog/index; press supported; advocacy/secondary; mixed
- Use
- Reader-facing summary of the strongest source class attached to the card.
factualMaturity
- Values
- documented; developing; contested; early
- Use
- Separates whether the underlying event is well established from whether the score is final.
legalPosture
- Values
- court-recorded; active or recently litigated; needs docket mapping; not primarily legal
- Use
- Shows whether a claim has docket support, needs legal mapping, or is not mainly a legal claim.
scoringMaturity
- Values
- score-ready; scored with caveats; seed score
- Use
- Flags whether the current score is ready for ranking use or still needs better data.
jurisdictionLevel
- Values
- federal/national; state/local; mixed; nonstate/private
- Use
- Keeps federal, state, municipal, and private-actor claims from being collapsed into one bucket.
sourceProfile
- Values
- Count by registered source type
- Use
- Shows source mix, such as court records, official data, watchdog reports, news, or advocacy sources.
sourceRoleProfile
- Values
- Count by source role: primary proof, denominator, analytical context, discovery, salience, counterargument
- Use
- Shows how attached sources are used. A tracker can discover a case; a docket or opinion proves legal posture.
Rules For Use
- Source types summarize support quality; they do not prove that a score is correct.
- A legal tracker can find a case, but court records are the scoring source.
- A public-data series can move a score only after the snapshot, units, denominator, geography, and retrieval date are saved.
- Press and NGO sources can start a card. They should not be the final record when a primary document or official dataset exists.
- A source role says why a URL is attached. It does not upgrade the source beyond what the record can prove.
- Methodology caveats are warning labels. They name limits in the source mix, legal posture, status, or dataset coverage.
Legal Record Fields
Legal records are attached only where the site has a cited docket, opinion, or court order. They describe procedural posture and what the record proves.
caseName
The public case caption or short case name.
court
The court or tribunal that issued the cited record.
docketId
Court docket number when it is stable and known.
status
decided; procedural ruling; appeal record; dismissed; active docket.
posture
Short procedural read of the case in relation to the ledger card.
holding
What the cited record supports. This should be narrower than the whole political claim.
caveat
A limit that prevents the case from being overread.
Methodology Caveats
Caveats name source limits that should stay visible next to the score. They do not replace the source list or the strongest counterargument.
Primary proof gap
Shown when no attached source is labeled primary proof.
Press use
Shown when press or wire citations support chronology, discovery, or salience.
Dataset coverage
Shown when counts or rates depend on coding rules, participation, geography, or revision dates.
Court mapping needed
Shown when a legal mechanism lacks a mapped docket or court record.
Status caution
Shown when the card is ongoing, emerging, or contested.