{
 "release": "2026-10",
 "release_version": "vfa-data-release/1.0",
 "license": "CC-BY-4.0",
 "attribution": "Source: Values for America, Constitution Index, release 2026-10 (https://www.valuesforamerica.com/data/releases/2026-10), licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).",
 "citation": "Values for America, Constitution Index, release 2026-10. https://www.valuesforamerica.com/data/releases/2026-10",
 "conventions": {
  "datetime": "ISO 8601, UTC.",
  "json": "In CSV and Parquet, a JSON-encoded string; in JSON files, the value.",
  "empty": "An empty CSV cell or null means not recorded / not applicable."
 },
 "datasets": [
  {
   "name": "grades",
   "title": "Constitution Index grades",
   "description": "Every published constitutional grade of a bill or executive order, current and superseded. A grade is never overwritten: a re-grade adds a new row and marks the old one superseded. SI-generated analysis · published after automated checks · not individually reviewed by a person.",
   "files": [
    "grades.csv",
    "grades.json",
    "grades.parquet"
   ],
   "columns": [
    {
     "name": "grade_id",
     "type": "integer",
     "description": "Stable id of this grade version."
    },
    {
     "name": "permalink",
     "type": "string",
     "description": "Citable page for this grade version."
    },
    {
     "name": "measure_type",
     "type": "string",
     "description": "bill or executive_order."
    },
    {
     "name": "measure_id",
     "type": "string",
     "description": "VFA id of the measure (bills: type-congress-number, e.g. hr-119-1; executive orders: Federal Register document number)."
    },
    {
     "name": "measure_ref",
     "type": "string",
     "description": "Human reference, e.g. 'H.R. 1' or 'Executive Order 14321'."
    },
    {
     "name": "measure_title",
     "type": "string",
     "description": "Official title."
    },
    {
     "name": "measure_page",
     "type": "string",
     "description": "Canonical VFA page for the measure."
    },
    {
     "name": "official_source",
     "type": "string",
     "description": "Official source page (Congress.gov or the Federal Register)."
    },
    {
     "name": "grade",
     "type": "string",
     "description": "Letter grade A, B, C, D or F."
    },
    {
     "name": "grade_meaning",
     "type": "string",
     "description": "A Constitutional, B Mostly sound, C Significant issues, D Likely unconstitutional, F Direct violation."
    },
    {
     "name": "grade_band",
     "type": "string",
     "description": "A-B, C or D-F (the bands used by voting records)."
    },
    {
     "name": "checks_passed",
     "type": "integer",
     "description": "How many of the five rubric checks passed (0-5)."
    },
    {
     "name": "check_enumerated_powers_passed",
     "type": "boolean",
     "description": "Whether the measure passed the 'Enumerated powers' check of the five-check rubric."
    },
    {
     "name": "check_bill_of_rights_passed",
     "type": "boolean",
     "description": "Whether the measure passed the 'Bill of Rights' check of the five-check rubric."
    },
    {
     "name": "check_individual_sovereignty_passed",
     "type": "boolean",
     "description": "Whether the measure passed the 'Individual liberty' check of the five-check rubric."
    },
    {
     "name": "check_decentralization_passed",
     "type": "boolean",
     "description": "Whether the measure passed the 'Decentralization' check of the five-check rubric."
    },
    {
     "name": "check_due_process_takings_passed",
     "type": "boolean",
     "description": "Whether the measure passed the 'Due process and takings' check of the five-check rubric."
    },
    {
     "name": "explanation",
     "type": "string",
     "description": "The grade's explanation, citing the Constitution."
    },
    {
     "name": "rubric_version",
     "type": "string",
     "description": "Rubric the grade was issued under."
    },
    {
     "name": "source_hash",
     "type": "string",
     "description": "SHA-256 of the official source text that was graded."
    },
    {
     "name": "source_fetched_at",
     "type": "datetime",
     "description": "When that source text was fetched (UTC)."
    },
    {
     "name": "graded_at",
     "type": "datetime",
     "description": "When the grade was issued (UTC)."
    },
    {
     "name": "engine",
     "type": "string",
     "description": "primary SI engine or backup SI engine."
    },
    {
     "name": "gate_version",
     "type": "string",
     "description": "Version of the publication checks the grade passed."
    },
    {
     "name": "status",
     "type": "string",
     "description": "current or superseded."
    },
    {
     "name": "superseded_by_grade_id",
     "type": "integer",
     "description": "The grade that replaced this one, if any."
    },
    {
     "name": "superseded_at",
     "type": "datetime",
     "description": "When it was superseded (UTC)."
    },
    {
     "name": "citation",
     "type": "string",
     "description": "Ready citation for this grade."
    }
   ]
  },
  {
   "name": "voting_records",
   "title": "Constitutional Voting Records",
   "description": "One row per member of Congress: recorded passage votes on graded measures, counted by the current grade band of each measure. A factual aggregate of public roll-call votes, not an endorsement of any member. Shares appear only above the minimum-evidence threshold (10 counted votes on 5 graded measures).",
   "files": [
    "voting_records.csv",
    "voting_records.json",
    "voting_records.parquet"
   ],
   "columns": [
    {
     "name": "actor_id",
     "type": "integer",
     "description": "VFA member id."
    },
    {
     "name": "member_name",
     "type": "string",
     "description": "Member's name."
    },
    {
     "name": "member_title",
     "type": "string",
     "description": "Title, e.g. Representative or Senator."
    },
    {
     "name": "party",
     "type": "string",
     "description": "Party as recorded."
    },
    {
     "name": "state",
     "type": "string",
     "description": "State (two letters)."
    },
    {
     "name": "district",
     "type": "string",
     "description": "House district, when applicable."
    },
    {
     "name": "bioguide_id",
     "type": "string",
     "description": "Congressional Bioguide id."
    },
    {
     "name": "record_version",
     "type": "string",
     "description": "Version of the record method."
    },
    {
     "name": "computed_at",
     "type": "datetime",
     "description": "When the record was computed (UTC)."
    },
    {
     "name": "counted_votes",
     "type": "integer",
     "description": "Yea and Nay passage votes on graded measures."
    },
    {
     "name": "graded_measures",
     "type": "integer",
     "description": "Distinct graded measures voted on."
    },
    {
     "name": "meets_threshold",
     "type": "boolean",
     "description": "Whether the record meets the minimum evidence."
    },
    {
     "name": "yea_A-B",
     "type": "integer",
     "description": "Yea votes on measures graded A or B: constitutional or mostly sound."
    },
    {
     "name": "nay_A-B",
     "type": "integer",
     "description": "Nay votes on measures graded A or B: constitutional or mostly sound."
    },
    {
     "name": "present_or_not_voting_A-B",
     "type": "integer",
     "description": "Present or not-voting entries on measures graded A or B: constitutional or mostly sound."
    },
    {
     "name": "yea_share_A-B",
     "type": "number",
     "description": "Share of the member's Yea votes cast on A-B measures (threshold only)."
    },
    {
     "name": "yea_rate_A-B",
     "type": "number",
     "description": "Yea / (Yea + Nay) on A-B measures (threshold only)."
    },
    {
     "name": "yea_C",
     "type": "integer",
     "description": "Yea votes on measures graded C: significant issues."
    },
    {
     "name": "nay_C",
     "type": "integer",
     "description": "Nay votes on measures graded C: significant issues."
    },
    {
     "name": "present_or_not_voting_C",
     "type": "integer",
     "description": "Present or not-voting entries on measures graded C: significant issues."
    },
    {
     "name": "yea_share_C",
     "type": "number",
     "description": "Share of the member's Yea votes cast on C measures (threshold only)."
    },
    {
     "name": "yea_rate_C",
     "type": "number",
     "description": "Yea / (Yea + Nay) on C measures (threshold only)."
    },
    {
     "name": "yea_D-F",
     "type": "integer",
     "description": "Yea votes on measures graded D or F: likely unconstitutional or a direct violation."
    },
    {
     "name": "nay_D-F",
     "type": "integer",
     "description": "Nay votes on measures graded D or F: likely unconstitutional or a direct violation."
    },
    {
     "name": "present_or_not_voting_D-F",
     "type": "integer",
     "description": "Present or not-voting entries on measures graded D or F: likely unconstitutional or a direct violation."
    },
    {
     "name": "yea_share_D-F",
     "type": "number",
     "description": "Share of the member's Yea votes cast on D-F measures (threshold only)."
    },
    {
     "name": "yea_rate_D-F",
     "type": "number",
     "description": "Yea / (Yea + Nay) on D-F measures (threshold only)."
    },
    {
     "name": "excluded_procedural",
     "type": "integer",
     "description": "Procedural votes on graded measures (cloture, amendments, motions), not counted."
    },
    {
     "name": "member_page",
     "type": "string",
     "description": "VFA member page."
    },
    {
     "name": "evidence_url",
     "type": "string",
     "description": "JSON with every counted vote and its source."
    }
   ]
  },
  {
   "name": "constitutional_votes",
   "title": "Votes behind the voting records",
   "description": "One row per member per recorded passage vote on a graded measure: the evidence behind each Constitutional Voting Record, with the official roll-call source.",
   "files": [
    "constitutional_votes.csv",
    "constitutional_votes.json",
    "constitutional_votes.parquet"
   ],
   "columns": [
    {
     "name": "actor_id",
     "type": "integer",
     "description": "VFA member id."
    },
    {
     "name": "member_name",
     "type": "string",
     "description": "Member's name."
    },
    {
     "name": "measure_id",
     "type": "string",
     "description": "VFA id of the measure voted on."
    },
    {
     "name": "measure_ref",
     "type": "string",
     "description": "Human reference of the measure."
    },
    {
     "name": "measure_page",
     "type": "string",
     "description": "Canonical VFA page for the measure."
    },
    {
     "name": "grade_id",
     "type": "integer",
     "description": "Current grade of the measure (see grades)."
    },
    {
     "name": "grade",
     "type": "string",
     "description": "Letter grade."
    },
    {
     "name": "grade_band",
     "type": "string",
     "description": "A-B, C or D-F."
    },
    {
     "name": "vote",
     "type": "string",
     "description": "Yea, Nay, Present or Not voting."
    },
    {
     "name": "question",
     "type": "string",
     "description": "Roll-call question as recorded."
    },
    {
     "name": "vote_date",
     "type": "date",
     "description": "Date of the vote."
    },
    {
     "name": "roll_call",
     "type": "string",
     "description": "Roll-call id (chamber-year-number or chamber-congress-session-number)."
    },
    {
     "name": "source_url",
     "type": "string",
     "description": "Official clerk.house.gov or senate.gov roll-call record."
    }
   ]
  },
  {
   "name": "solutions",
   "title": "VFA SI Solutions",
   "description": "Published VFA SI Solutions: source-grounded, Constitution-cited bipartisan alternatives to bills, executive actions and Supreme Court opinions, with full text. VFA proposals, not law. SI-generated analysis · published after automated checks · not individually reviewed by a person (items marked review_mode=human were published by an editor).",
   "files": [
    "solutions.csv",
    "solutions.json",
    "solutions.parquet"
   ],
   "columns": [
    {
     "name": "solution_id",
     "type": "integer",
     "description": "Stable id."
    },
    {
     "name": "url",
     "type": "string",
     "description": "Public page."
    },
    {
     "name": "target_type",
     "type": "string",
     "description": "bill, executive_action or scotus_opinion."
    },
    {
     "name": "target_id",
     "type": "string",
     "description": "VFA id of the measure or opinion answered."
    },
    {
     "name": "target_ref",
     "type": "string",
     "description": "Human reference of the target, when known."
    },
    {
     "name": "target_page",
     "type": "string",
     "description": "VFA page of the target, when one exists."
    },
    {
     "name": "title",
     "type": "string",
     "description": "Solution title."
    },
    {
     "name": "original_goal",
     "type": "string",
     "description": "What the measure tries to do, from its official source."
    },
    {
     "name": "solution_text",
     "type": "string",
     "description": "Full text of the VFA proposal."
    },
    {
     "name": "bipartisan_rationale",
     "type": "string",
     "description": "VFA's assessment of the gains for each side."
    },
    {
     "name": "constitutional_citations",
     "type": "json",
     "description": "Constitutional provisions the proposal rests on."
    },
    {
     "name": "constitutional_concerns",
     "type": "json",
     "description": "Constitutional concerns with the original."
    },
    {
     "name": "operative_provisions",
     "type": "json",
     "description": "Funding cap, sunset, oversight, enforcement and source notes."
    },
    {
     "name": "review_mode",
     "type": "string",
     "description": "automated_si (published after automated checks), human (published by an editor) or empty (archived item)."
    },
    {
     "name": "gate_version",
     "type": "string",
     "description": "Version of the publication checks, when gated."
    },
    {
     "name": "gate_scores",
     "type": "json",
     "description": "Independent critic scores per rule (0-5), when gated."
    },
    {
     "name": "source_status",
     "type": "string",
     "description": "current, source_changed, stage_changed or empty."
    },
    {
     "name": "published_at",
     "type": "datetime",
     "description": "When it was published (UTC)."
    },
    {
     "name": "created_at",
     "type": "datetime",
     "description": "When the draft was created (UTC)."
    }
   ]
  },
  {
   "name": "think_tank_ideas",
   "title": "SI Think Tank ideas",
   "description": "Published SI Think Tank proposals: syntheses of common ground across published Solutions and original national proposals grounded in official records. VFA proposals. SI-generated analysis · published after automated checks · not individually reviewed by a person.",
   "files": [
    "think_tank_ideas.csv",
    "think_tank_ideas.json",
    "think_tank_ideas.parquet"
   ],
   "columns": [
    {
     "name": "idea_id",
     "type": "integer",
     "description": "Stable id."
    },
    {
     "name": "url",
     "type": "string",
     "description": "Public page."
    },
    {
     "name": "slug",
     "type": "string",
     "description": "URL slug."
    },
    {
     "name": "kind",
     "type": "string",
     "description": "synthesis or original."
    },
    {
     "name": "title",
     "type": "string",
     "description": "Title."
    },
    {
     "name": "subtitle",
     "type": "string",
     "description": "Subtitle."
    },
    {
     "name": "tldr",
     "type": "string",
     "description": "One-paragraph summary."
    },
    {
     "name": "vision_text",
     "type": "string",
     "description": "Full text."
    },
    {
     "name": "problem_statement",
     "type": "string",
     "description": "Problem in official records (original proposals)."
    },
    {
     "name": "bipartisan_rationale",
     "type": "string",
     "description": "VFA's assessment of the gains for each side."
    },
    {
     "name": "operative_provisions",
     "type": "json",
     "description": "Operative provisions (original proposals)."
    },
    {
     "name": "first_principles",
     "type": "json",
     "description": "First principles the idea rests on."
    },
    {
     "name": "topics",
     "type": "json",
     "description": "Topic tags."
    },
    {
     "name": "sources",
     "type": "json",
     "description": "Official records or published Solutions the idea is built on."
    },
    {
     "name": "source_status",
     "type": "string",
     "description": "Latest source check: current, source_changed, ..."
    },
    {
     "name": "source_checked_at",
     "type": "datetime",
     "description": "When the sources were last checked (UTC)."
    },
    {
     "name": "published_at",
     "type": "datetime",
     "description": "When it was published (UTC)."
    },
    {
     "name": "updated_at",
     "type": "datetime",
     "description": "Last update (UTC)."
    }
   ]
  },
  {
   "name": "adoption_log",
   "title": "Moved toward VFA (adoption log)",
   "description": "New official bill text that now includes a provision a published VFA Solution proposed, with verbatim quotes from both. Records a textual match only; it does not claim that VFA caused the change.",
   "files": [
    "adoption_log.csv",
    "adoption_log.json",
    "adoption_log.parquet"
   ],
   "columns": [
    {
     "name": "match_id",
     "type": "integer",
     "description": "Stable id."
    },
    {
     "name": "evidence_url",
     "type": "string",
     "description": "Public entry with both quotes side by side."
    },
    {
     "name": "line",
     "type": "string",
     "description": "Public summary line."
    },
    {
     "name": "facet",
     "type": "string",
     "description": "Kind of provision (sunset, cap, oversight, ...)."
    },
    {
     "name": "bill_id",
     "type": "string",
     "description": "VFA id of the bill."
    },
    {
     "name": "bill_ref",
     "type": "string",
     "description": "Human reference of the bill."
    },
    {
     "name": "bill_page",
     "type": "string",
     "description": "VFA page of the bill."
    },
    {
     "name": "bill_version",
     "type": "string",
     "description": "Official text version compared."
    },
    {
     "name": "bill_version_date",
     "type": "datetime",
     "description": "Date of that version."
    },
    {
     "name": "official_text",
     "type": "string",
     "description": "Official text of that version."
    },
    {
     "name": "bill_quote",
     "type": "string",
     "description": "Verbatim quote from the new official text."
    },
    {
     "name": "vfa_quote",
     "type": "string",
     "description": "Verbatim quote from the VFA Solution."
    },
    {
     "name": "solution_id",
     "type": "integer",
     "description": "The VFA Solution (see solutions)."
    },
    {
     "name": "solution_url",
     "type": "string",
     "description": "Its public page."
    },
    {
     "name": "match_strength",
     "type": "integer",
     "description": "Match strength (1-5)."
    },
    {
     "name": "confidence",
     "type": "number",
     "description": "Match confidence (0-1)."
    },
    {
     "name": "logged_at",
     "type": "datetime",
     "description": "When the entry was published (UTC)."
    }
   ]
  },
  {
   "name": "corrections",
   "title": "Corrections log",
   "description": "Every public correction: unpublished items, source or stage changes, corrections and retractions, with what changed and why. Entries are never deleted.",
   "files": [
    "corrections.csv",
    "corrections.json",
    "corrections.parquet"
   ],
   "columns": [
    {
     "name": "correction_id",
     "type": "integer",
     "description": "Stable id."
    },
    {
     "name": "log_url",
     "type": "string",
     "description": "Entry in the public corrections log."
    },
    {
     "name": "product",
     "type": "string",
     "description": "solution, parliament, think_tank, grade, ..."
    },
    {
     "name": "item_id",
     "type": "integer",
     "description": "Id of the affected item."
    },
    {
     "name": "item_title",
     "type": "string",
     "description": "Title of the affected item."
    },
    {
     "name": "item_url",
     "type": "string",
     "description": "Page of the item, when it is still public."
    },
    {
     "name": "kind",
     "type": "string",
     "description": "withdrawn, source_changed, stage_changed, correction, retraction or flagged."
    },
    {
     "name": "what_changed",
     "type": "string",
     "description": "What changed."
    },
    {
     "name": "why",
     "type": "string",
     "description": "Why."
    },
    {
     "name": "origin",
     "type": "string",
     "description": "What triggered it (freshness, report_recheck, admin, ...)."
    },
    {
     "name": "logged_at",
     "type": "datetime",
     "description": "When it was logged (UTC)."
    }
   ]
  }
 ]
}