{
  "schema_version": "0.3",
  "published": "2026-09-11",
  "purpose": "One record contract for every state. Campus, project, parcel, building, operating facility and provider presence are distinct units. Utility-request MW, generation MW, company-design MW and critical IT MW are never interchangeable.",
  "record_units": {
    "campus": "A named campus that may contain several buildings.",
    "project": "A named development or agreement. It may sit under a campus and is not another campus.",
    "parcel": "A land record. It is not a building count.",
    "building": "A distinct physical building with an operator or municipal identity.",
    "operating_facility": "A physical facility with operating or operator-listed evidence. A tenant suite inside it is not another facility.",
    "provider_presence": "A service, tenant or network presence whose physical-building relationship is unresolved. Excluded from facility counts until reconciled.",
    "lifecycle_event": "A dated event attached to a stable entity. Never counted as another entity.",
    "municipal_project_lead": "A named municipal construction/project entry. Not an operating milestone."
  },
  "lifecycle_statuses": [
    "proposed",
    "approved",
    "construction",
    "preleasing",
    "operating",
    "expanding",
    "paused",
    "withdrawn",
    "expired",
    "closed",
    "demolished",
    "unknown"
  ],
  "common_fields": {
    "identity": [
      "stable_id",
      "record_unit",
      "current_name",
      "former_names",
      "developer",
      "owner",
      "operator",
      "tenant",
      "legal_entities"
    ],
    "location": [
      "address",
      "city",
      "county",
      "state",
      "parcel_or_site_notes",
      "coordinates",
      "coordinate_precision"
    ],
    "lifecycle": [
      "current_status",
      "status_basis",
      "first_announced",
      "opened_or_energized",
      "closed_or_withdrawn",
      "history_events"
    ],
    "physical_scale": [
      "building_count",
      "square_feet",
      "acres",
      "critical_it_mw",
      "utility_service_mw",
      "measured_load_mw",
      "capacity_scope"
    ],
    "power": [
      "utility",
      "grid_region",
      "interconnection_or_tariff",
      "grid_upgrades",
      "cost_allocation",
      "ratepayer_evidence"
    ],
    "water_and_cooling": [
      "cooling_architecture",
      "closed_loop_scope",
      "evaporative_role",
      "liquid_cooling_role",
      "source_water",
      "permitted_withdrawal",
      "measured_withdrawal",
      "measured_consumption",
      "discharge",
      "wue"
    ],
    "economics": [
      "announced_investment",
      "completed_investment",
      "construction_jobs",
      "permanent_jobs_promised",
      "permanent_jobs_observed",
      "taxes_paid",
      "incentives_authorized",
      "incentives_claimed",
      "public_expenditures",
      "community_payments"
    ],
    "evidence": [
      "claim_status",
      "source_title",
      "source_url",
      "source_type",
      "document_date",
      "page_or_clause",
      "last_verified",
      "confidence",
      "missing_evidence"
    ]
  },
  "null_rule": "Unknown, not disclosed, not yet due and not applicable are distinct values. Missing evidence never becomes zero.",
  "completeness_protocol": [
    "Build a discovery union from operator lists, state and local records, utility and commission dockets, permits, tax and incentive records, historical archives and commercial directories used only as leads unless licensed.",
    "Resolve every lead to a stable project, campus, building, provider-presence or historical-event identity; keep unresolved leads visible.",
    "Check current and former names, subsidiaries, acquisitions, closures and withdrawals so a rename neither deletes nor duplicates a site.",
    "Publish a statewide total only after the named source families and candidate queue have been reconciled to the same record unit.",
    "Continue monitoring after publication because a census is a dated snapshot, not a permanent claim of completeness."
  ],
  "coverage_audit": [
    {
      "state": "Indiana",
      "projects": "9 verified project/campus records in one file; one related expansion project; one unresolved group excluded from verified counts",
      "facilities": "21 research records; 16 address-resolved operating sites",
      "history": "withdrawn and expired records retained; dated events in the cross-state register",
      "map": "available for reviewed records with Census place centroids",
      "all_discoverable_records_reconciled": false
    },
    {
      "state": "Ohio",
      "projects": "17 reviewed project/campus records",
      "facilities": "29 operator-identified facility/building records; 43 separate New Albany municipal project leads",
      "history": "dated events retained; acquisitions are history, not extra facilities",
      "map": "Census geography centroids with disclosed offsets",
      "all_discoverable_records_reconciled": false
    }
  ],
  "hard_limit": "No public method can prove the absence of undisclosed private server rooms. 'Every' therefore means every evidence-identified facility, project and historical lifecycle record within a published, dated source audit—not every unobservable installation.",
  "capacity_contract": {
    "shape": {
      "value": "number or null",
      "unit": "MW|sqft|acres|gal|gal/yr|unknown",
      "kind": "critical_it|utility_request|utility_service|backup_generation_permitted|onsite_generation_planned|company_design|gross_facility|water|unknown",
      "scope": "building|campus|site|phase|full_buildout|unknown"
    },
    "rule": "Do not sum values with different kind or scope. Missing evidence never becomes zero."
  },
  "required_record_fields": [
    "stable_id",
    "parent_id",
    "record_unit",
    "current_name",
    "state",
    "city",
    "county",
    "lifecycle_status",
    "status_basis",
    "capacity",
    "sources",
    "confidence",
    "missing_evidence",
    "location",
    "history"
  ],
  "typed_field_rule": "city, county, lifecycle_status and capacity.kind are typed. They may be null. They may not hold a sentence.",
  "publication": {
    "license": null,
    "reuse_scope": "reference only unless a record is explicitly rights-cleared",
    "rights_manifest": "/data/rights-manifest.json"
  }
}