{
 "standard": "data/schemas.json — the contracts every KPSGILL object satisfies. This file is the reference the templates and gates are written against.",
 "asOf": "2026-09-01T21:00:00-07:00",
 "metadata": {
  "note": "Fields are applied where relevant; empty fields are omitted rather than filled with placeholders.",
  "fields": [
   "id",
   "slug",
   "title",
   "shortTitle",
   "objectType",
   "status",
   "jurisdiction",
   "primaryTopic",
   "secondaryTopics",
   "organizations",
   "agencies",
   "laws",
   "regulations",
   "cases",
   "effectiveDate",
   "publishedDate",
   "contentModifiedAt",
   "sourcesCheckedAt",
   "recordThrough",
   "lastSubstantiveUpdate",
   "sourceTier",
   "primarySources",
   "secondarySources",
   "relatedRecords",
   "physicianRelevance",
   "patientRelevance",
   "policyRelevance",
   "evidenceStrength",
   "reviewState",
   "author",
   "approver",
   "correctionHistory"
  ],
  "dateFieldRule": "contentModifiedAt, sourcesCheckedAt, recordThrough, effectiveDate and lastSubstantiveUpdate are five distinct fields and are never used as synonyms. A template or navigation change advances contentModifiedAt only — it never advances sourcesCheckedAt or recordThrough. This is the rule that prevents a redesign from silently claiming re-verification."
 },
 "claimClasses": [
  {
   "code": "DOCUMENTED_FACT",
   "test": "A primary source states it."
  },
  {
   "code": "REPORTED_ALLEGATION",
   "test": "A complaint, charge or report asserts it. Never rendered as occurrence."
  },
  {
   "code": "LEGAL_CLAIM",
   "test": "A party asserts it as a legal position."
  },
  {
   "code": "AGENCY_POSITION",
   "test": "An agency states it. Distinct from law."
  },
  {
   "code": "COURT_FINDING",
   "test": "A court found it. Level and finality must be stated."
  },
  {
   "code": "RESEARCH_FINDING",
   "test": "A study reports it. Design and effect size must be stated."
  },
  {
   "code": "INTERPRETATION",
   "test": "KPSGILL reads the source this way. Labelled."
  },
  {
   "code": "INFERENCE",
   "test": "KPSGILL infers it. Labelled, with the inference shown."
  },
  {
   "code": "FORECAST",
   "test": "KPSGILL predicts it. Requires confidence, assumptions, competing scenario and falsification condition."
  },
  {
   "code": "POLICY_PROPOSAL",
   "test": "KPSGILL recommends it. Never rendered as law."
  }
 ],
 "prohibitedConversions": [
  "\"Complaint alleges X\" → \"X occurred\"",
  "\"Settled without admission\" → \"Defendant did X\"",
  "\"Agency proposes\" → \"Law requires\"",
  "\"Passed one house\" → \"Passed the Legislature\"",
  "\"Passed the Legislature\" → \"Enacted\"",
  "\"Signed\" → \"In effect\"",
  "\"In trials\" → \"Approved\" or \"Available\"",
  "\"Licensed for pathogen A\" → \"Effective against pathogen B\"",
  "\"Convened expert report\" → \"Formal WHO position\"",
  "\"Grant announced\" → \"Funds obligated\"",
  "\"Prioritised for review\" → \"Approved\" or \"Standard lowered\"",
  "\"Organisational enforcement priority\" → \"Wrongdoing by a named party\"",
  "\"Cap-exempt employer\" → \"Fee-exempt petition\"",
  "\"Not publicly stated\" → \"No\""
 ],
 "sourceTiers": [
  {
   "tier": 1,
   "label": "Primary / authoritative",
   "examples": [
    "statute",
    "regulation",
    "rulemaking docket",
    "court opinion",
    "docket document",
    "agency enforcement release",
    "official guidance",
    "government report",
    "official dataset",
    "regulator decision",
    "SEC filing",
    "legislative text",
    "chamber action history",
    "FDA record",
    "CMS record",
    "ClinicalTrials.gov",
    "WHO/EMA/MHRA/TGA/Health Canada publication",
    "peer-reviewed original research"
   ]
  },
  {
   "tier": 2,
   "label": "High-quality secondary",
   "examples": [
    "systematic reviews",
    "respected academic analysis",
    "official professional guidelines"
   ]
  },
  {
   "tier": 3,
   "label": "Journalism",
   "use": "Discovery of primary documents only. Never a substitute where the primary document is reasonably available."
  },
  {
   "tier": 4,
   "label": "Trade and secondary commentary",
   "use": "Lead generation only."
  },
  {
   "tier": "D",
   "label": "Community reports",
   "use": "For the IMG vertical: applicant forums identify questions. They never establish a programme requirement or a visa rule. Rendered only under an explicit UNVERIFIED APPLICANT REPORT label."
  }
 ],
 "noSourceLaundering": "Do not cite an article that cites a government source when the government source is accessible. Use journalism to find the document, then cite the document.",
 "researchStatus": [
  "proposed",
  "collecting",
  "primary-sources-located",
  "drafted",
  "verification-pending",
  "ready",
  "published",
  "update-required",
  "archived"
 ],
 "researchStatusRule": "A node may exist internally at any of these states. Only 'published' appears publicly. This is what lets the architecture be broad without pretending every node is complete.",
 "freshnessTiers": [
  {
   "tier": "A",
   "label": "Rapidly changing",
   "verticals": [
    "legislation",
    "litigation",
    "regulation",
    "FDA safety",
    "enforcement",
    "healthcare AI",
    "physician immigration",
    "Medicare",
    "Medicaid",
    "hospital closures",
    "bankruptcies"
   ],
   "staleAfterDays": 30
  },
  {
   "tier": "B",
   "label": "Moderate",
   "verticals": [
    "scope of practice",
    "corporate practice of medicine",
    "medical-board policy",
    "telemedicine",
    "privacy",
    "certification"
   ],
   "staleAfterDays": 180
  },
  {
   "tier": "C",
   "label": "Structural",
   "verticals": [
    "historical law",
    "institutional mechanics",
    "foundational comparative governance"
   ],
   "staleAfterDays": 365
  }
 ],
 "imgFreshnessRule": "Every IMG-facing operational page carries its applicable Match year and a rules-checked date. An immigration page older than 90 days during Match season enters update-required automatically, because a 2026 court order can invalidate a 2025 statement."
}