# PBJ320 reporter kit: New York, Q2 2026

PBJ320 is the analysis layer; every figure traces to a dated CMS or state source listed in `sources/source_register.csv`, and every claim in the brief is indexed in `sources/evidence_index.csv`.

## Source dates are independent
- PBJ staffing: Q2 2026 (compared with Q2 2025 and Q1 2026).
- CMS Provider Information: October 2026 release (CMS release 2026-10-28, processed 2026-10-01).
- SFF posting: October 2026 (published 2026-10-28), compared with September 2026.
- State law: PBJ320 staffing-law ledger at commit 32b994e.

## Staffing measures
Hours per resident day (HPRD) = total paid nurse hours in the quarter / total resident days in the quarter, summed across facilities (resident-day weighted). Year-over-year and quarter-over-quarter figures use a matched cohort: only facilities with resident days in both quarters. Facilities outside the cohort keep their single-quarter values in `facilities.csv` with the change left blank.
A facility-level change of 0.25 HPRD or more is counted as a material move. This is a reporting threshold, not a legal or clinical standard.

## Status changes
SFF changes compare the category sets on two dated CMS postings. They do not explain why CMS moved a facility. The CMS High Performing icon is CMS's own designation, reported in Provider Information. It is distinct from PBJ320's reconstructed risk-based-survey research and from an actual risk-based survey.

## State law
`state_law.csv` quotes each requirement from the official text with its citation and URL. `RESEARCH_INCOMPLETE` means not yet verified, never that no law exists. Retrieval and compilation dates are not effective dates. PBJ records daily paid hours. It cannot show simultaneous on-duty coverage, staff qualifications or legal exceptions, so a facility below any benchmark has not been shown to violate a law.

## Geography
Counties come from TIGER/Line 2024 point-in-polygon assignment of CMS facility coordinates. Map outlines come from Census 1:10m cartographic boundaries (us-atlas 3.0.1). Counties are the reporting unit; PBJ320 does not group them into official regions for this state.

## Reproduce
`python scripts/journalist/build_state_brief.py --state NY`. `manifest.json` lists the SHA-256 of every input and output.

Questions or expert comment: https://www.pbj320.com/press
