{
  "x-generated": "2026-11-05T18:05:31Z",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://seraphixsystems.com/data/schema/record.schema.json",
  "title": "Published record",
  "type": "object",
  "required": [
    "id",
    "url",
    "label",
    "scope",
    "section",
    "tag",
    "claim",
    "basis",
    "source",
    "dates",
    "record_date",
    "lifecycle",
    "version",
    "versions",
    "cite"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^SX-(07-[A-E]-\\d{4}|09-[A-Z]{2}-\\d{2,4})$",
      "description": "Stable. Never reused or renumbered."
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "json": {
      "type": "string",
      "format": "uri"
    },
    "label": {
      "type": "string",
      "description": "Exhibit label, e.g. RECORD SX 07-A // SITES // FILED 2026-11-02"
    },
    "scope": {
      "enum": [
        "entity",
        "state"
      ]
    },
    "entity": {
      "type": [
        "object",
        "null"
      ]
    },
    "state": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^[A-Z]{2}$"
    },
    "section": {
      "enum": [
        "sites",
        "power",
        "incentives",
        "water_permits",
        "policy"
      ]
    },
    "tag": {
      "enum": [
        "ENACTED",
        "STATED",
        "COMPANY DISCLOSURE",
        "MARKER",
        "REPORTED · PRIMARY PENDING"
      ],
      "description": "ENACTED only with the primary document attached; otherwise REPORTED · PRIMARY PENDING."
    },
    "instrument": {
      "type": [
        "string",
        "null"
      ]
    },
    "primary_pending": {
      "type": "boolean"
    },
    "claim": {
      "type": "string"
    },
    "quote": {
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "type": "object"
    },
    "basis": {
      "enum": [
        "regulator_hosted_filing",
        "official_code",
        "agency_record",
        "court_filing",
        "law_firm_summary",
        "press",
        "statute_text"
      ]
    },
    "basis_label": {
      "type": "string"
    },
    "source": {
      "type": "object",
      "required": [
        "title",
        "url",
        "publisher"
      ],
      "properties": {
        "title": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "publisher": {
          "type": "string"
        },
        "locator": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "also": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "url",
          "publisher"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "publisher": {
            "type": "string"
          },
          "locator": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "supporting": {
      "type": "array",
      "description": "Supporting source quotes shown next to the main quote (e.g. the table heading that states a table row's status). Each is verbatim in its source.",
      "items": {
        "type": "object",
        "required": [
          "quote",
          "url",
          "publisher"
        ],
        "additionalProperties": false,
        "properties": {
          "quote": {
            "type": "string",
            "minLength": 1
          },
          "locator": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "publisher": {
            "type": "string"
          },
          "filed": {
            "type": [
              "string",
              "null"
            ],
            "description": "YYYY, YYYY-MM, YYYY-MM-DD or RFC 3339; null when not stated in source"
          }
        }
      }
    },
    "history": {
      "type": "array",
      "description": "Other dated filings stating the same thing about this record's site, newest first. Read-only; not a correction.",
      "items": {
        "type": "object",
        "required": [
          "filed",
          "quote",
          "url",
          "publisher"
        ],
        "additionalProperties": false,
        "properties": {
          "filed": {
            "type": "string",
            "pattern": "^\\d{4}(-\\d{2}(-\\d{2})?)?$"
          },
          "form": {
            "type": "string"
          },
          "quote": {
            "type": "string",
            "minLength": 1
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "publisher": {
            "type": "string"
          }
        }
      }
    },
    "primary": {
      "type": [
        "object",
        "null"
      ]
    },
    "dates": {
      "type": "object",
      "properties": {
        "occurred": {
          "type": [
            "string",
            "null"
          ],
          "description": "YYYY, YYYY-MM, YYYY-MM-DD or RFC 3339; null when not stated in source"
        },
        "reported": {
          "type": [
            "string",
            "null"
          ],
          "description": "YYYY, YYYY-MM, YYYY-MM-DD or RFC 3339; null when not stated in source"
        },
        "source_published": {
          "type": [
            "string",
            "null"
          ],
          "description": "YYYY, YYYY-MM, YYYY-MM-DD or RFC 3339; null when not stated in source"
        },
        "first_seen": {
          "type": [
            "string",
            "null"
          ],
          "description": "YYYY, YYYY-MM, YYYY-MM-DD or RFC 3339; null when not stated in source"
        },
        "ingested": {
          "type": [
            "string",
            "null"
          ],
          "description": "YYYY, YYYY-MM, YYYY-MM-DD or RFC 3339; null when not stated in source"
        },
        "corrected": {
          "type": [
            "string",
            "null"
          ],
          "description": "YYYY, YYYY-MM, YYYY-MM-DD or RFC 3339; null when not stated in source"
        }
      }
    },
    "record_date": {
      "type": "string"
    },
    "published": {
      "type": "string",
      "description": "Date this ID first published"
    },
    "lifecycle": {
      "enum": [
        "active",
        "amended",
        "retracted",
        "disputed"
      ]
    },
    "version": {
      "type": "integer",
      "minimum": 1
    },
    "versions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "version",
          "claim",
          "url",
          "current"
        ]
      }
    },
    "cite": {
      "type": "object",
      "required": [
        "publisher",
        "record_id",
        "url",
        "version",
        "text"
      ],
      "properties": {
        "publisher": {
          "type": "string"
        },
        "record_id": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "version": {
          "type": "integer"
        },
        "title": {
          "type": "string"
        },
        "published": {
          "type": "string"
        },
        "text": {
          "type": "string"
        }
      }
    }
  }
}