{
  "schema_version": "0.1",
  "canonical": true,
  "dataset": "MENA-CAL",
  "title": "Historically versioned calendar-adjustment infrastructure for MENA economic data",
  "last_updated": "2026-08-21",
  "coverage_state": "schema-and-regime-seed-live; daily 1990-2050 coverage in build",
  "unit_of_observation": "country-date",
  "primary_key": ["country_code", "date"],
  "fields": [
    {"name":"date","type":"date","description":"Gregorian calendar date"},
    {"name":"country_code","type":"string","description":"ISO-like country identifier used by the Lab"},
    {"name":"country","type":"string","description":"Country name"},
    {"name":"weekday","type":"integer","description":"Weekday index"},
    {"name":"working_day","type":"boolean","description":"Whether the date is a normal working day under the historically applicable regime"},
    {"name":"weekend_regime","type":"string","description":"Historically applicable weekend / working-week regime"},
    {"name":"ramadan","type":"boolean","description":"Date falls within Ramadan"},
    {"name":"ramadan_day","type":"integer|null","description":"Ramadan day index where applicable"},
    {"name":"eid_fitr","type":"boolean","description":"Date falls within the coded Eid al-Fitr interval"},
    {"name":"eid_adha","type":"boolean","description":"Date falls within the coded Eid al-Adha interval"},
    {"name":"hajj_period","type":"boolean","description":"Date falls within the coded Hajj interval where economically relevant"},
    {"name":"national_holiday","type":"boolean","description":"Country-specific national/public holiday flag"},
    {"name":"school_holiday","type":"boolean|null","description":"School holiday flag when a verified historical series is available"},
    {"name":"working_hours_regime","type":"string|null","description":"Historically applicable working-hours regime"},
    {"name":"ramadan_work_hours","type":"boolean|null","description":"Special Ramadan working-hours regime flag"},
    {"name":"holiday_overlap","type":"integer","description":"Count of coded holiday/calendar regimes overlapping the date"},
    {"name":"gregorian_month","type":"integer","description":"Gregorian month"},
    {"name":"hijri_month","type":"integer|null","description":"Hijri month where verified conversion is available"},
    {"name":"fraction_ramadan_month","type":"number","description":"Monthly aggregate: fraction of Gregorian month falling in Ramadan"},
    {"name":"fraction_working_days_month","type":"number","description":"Monthly aggregate: share of calendar days coded as working days"},
    {"name":"regime_source","type":"string","description":"Source supporting the applicable historical calendar regime"},
    {"name":"retrieval_date","type":"date","description":"Date the Lab retrieved/verified the source"},
    {"name":"validation_state","type":"string","description":"Lab validation state"}
  ],
  "claim_boundary": "This schema defines the intended country-date contract. It does not imply complete 1990-2050 coverage. Country-date rows enter the release only after the relevant holiday, working-week and regime sources are verified."
}