{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://civilytics.org/schemas/uscogdata/provenance-v1.json",
  "title": "uscogdata provenance v1",
  "type": "object",
  "required": ["verb", "target", "years", "scope", "manifest", "sql_query"],
  "properties": {
    "verb":           { "type": "string" },
    "call":           { "type": "string" },
    "target":         { "type": "object" },
    "years":          { "type": "array", "items": { "type": "integer" } },
    "category":       { "type": ["string", "array", "null"] },
    "basis":          { "type": ["string", "null"] },
    "basis_note":     { "type": ["string", "null"] },
    "expenditure_concept": {
      "type": "string",
      "enum": ["direct", "total"],
      "description": "Which spending concept produced this result. 'direct' is the government's own E/F/G spending; 'total' adds its intergovernmental payments (M to local governments, L to state governments). Only 'direct' is valid for results combined across governments."
    },
    "expenditure_concept_note": {
      "type": ["string", "null"],
      "description": "How the intergovernmental leg was assembled; null for 'direct'."
    },
    "harmonization":  { "type": "object" },
    "recipe":         { "type": ["object", "null"] },
    "suggestions":    { "type": "array" },
    "scope":          { "type": "object" },
    "codes_summed":   { "type": "object" },
    "aggregate_fallback": { "type": ["object", "null"] },
    "transformations":{ "type": "object" },
    "series_break_refs": { "type": "array", "items": { "type": "string" } },
    "manifest":       { "type": "object" },
    "sql_query":      { "type": "string" }
  }
}