# Comparability regimes. Trends are computed WITHIN a regime, never across a break.
# Because View 2 trends run on within-year standardized residuals (z), the trend is
# already scale-break-immune *and* demographic-adjusted; regimes additionally prevent
# fitting a slope across a structural discontinuity (e.g. the 2023 NextGen standards reset).
regimes:
  ela_math_regimes:
    description: >
      NY grades 3-8 ELA/Math. 2023 NextGen standards reset makes proficiency
      non-comparable pre/post 2023 (NYSED + NYCDOE state this directly). 2020 cancelled;
      2021 had ~21% participation (unusable for school-level rates).
    windows:
      - {id: A_commoncore, years: [2013, 2014, 2015, 2016, 2017, 2018, 2019]}
      - {id: B_nextgen,    years: [2023, 2024, 2025]}
    excluded_years: [2020, 2021]
    ambiguous_years: [2022]                 # old standards, recovery year
    cross_regime_reporting: standardized_only

  chronic_absenteeism_regimes:
    description: COVID structural break; post-pandemic levels are elevated citywide.
    windows:
      - {id: pre_covid,  years: [2016, 2017, 2018, 2019]}
      - {id: post_covid, years: [2022, 2023, 2024, 2025]}
    excluded_years: [2020, 2021]
    ambiguous_years: []
    cross_regime_reporting: standardized_only

  survey_regimes:
    description: >
      Placeholder. Set instrument-stable window(s) only AFTER verifying NYC School
      Survey item wording/scale continuity across years for each survey outcome.
    windows:
      - {id: TBD, years: []}
    excluded_years: []
    ambiguous_years: []
    cross_regime_reporting: standardized_only