Fabio
aefa65f5b3
The README claimed 'validated by JSON Schema' — now it is true. /schemas holds a JSON Schema for each entity type (Person, Body, Candidate, Jurisdiction): a stricter profile over OKF's permissive base, tolerating unknown keys by design. scripts/validate.py checks all 17,506 files with no third-party deps (hand-rolled frontmatter parser + minimal schema engine): 1. OKF conformance — every file has frontmatter with a non-empty type 2. Schema conformance — required fields, property types, enums 3. Link integrity — internal /-rooted links resolve Non-zero exit on failure, so it is a CI gate. Verified with a negative test: it catches bad enums and dead links. All 17,506 files pass today. Makefile ties it together: make build / validate / check. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
25 lines
1.0 KiB
JSON
25 lines
1.0 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"title": "Candidate",
|
|
"description": "A candidate for public office — someone running, distinct from a current officeholder. Sourced from FEC filings.",
|
|
"type": "object",
|
|
"required": ["type", "title", "office", "state", "confidence", "tags", "timestamp", "ids"],
|
|
"properties": {
|
|
"type": { "type": "string", "enum": ["Candidate"] },
|
|
"title": { "type": "string" },
|
|
"office": { "type": "string", "enum": ["U.S. House", "U.S. Senate"] },
|
|
"state": { "type": "string" },
|
|
"district": { "type": "string" },
|
|
"party": { "type": "string" },
|
|
"stance": { "type": "string", "enum": ["incumbent", "challenger", "open-seat"] },
|
|
"election_year": { "type": "integer" },
|
|
"status": { "type": "string" },
|
|
"committee": { "type": "object" },
|
|
"ids": { "type": "object" },
|
|
"sources": { "type": "array" },
|
|
"confidence": { "type": "string", "enum": ["official", "reported", "inferred", "unverified"] },
|
|
"tags": { "type": "array" },
|
|
"timestamp": { "type": "string" }
|
|
}
|
|
}
|