Files
republic-os/schemas/person.schema.json
Fabio aefa65f5b3 Validation: JSON Schemas + validator (the discipline, enforced)
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>
2026-07-03 23:43:56 -04:00

24 lines
1.1 KiB
JSON

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Person",
"description": "An officeholder — a person holding a public office at any level. OKF-conformant: only `type` is strictly required by OKF; this profile adds the fields Republic OS relies on. Unknown keys are tolerated.",
"type": "object",
"required": ["type", "title", "level", "confidence", "tags", "timestamp", "ids"],
"properties": {
"type": { "type": "string", "enum": ["Person"] },
"title": { "type": "string" },
"role": { "type": "string" },
"party": { "type": "string" },
"level": { "type": "string", "enum": ["federal", "state", "county", "municipal"] },
"branch": { "type": "string", "enum": ["executive", "legislative", "judicial"] },
"state": { "type": "string" },
"leadership": { "type": "array" },
"committees": { "type": "array" },
"ids": { "type": "object" },
"sources": { "type": "array" },
"confidence": { "type": "string", "enum": ["official", "reported", "inferred", "unverified"] },
"tags": { "type": "array" },
"timestamp": { "type": "string" }
}
}