{"ok":true,"catalog":{"version":"1.0","generated_at":"2026-11-09T03:03:32.415265+00:00"},"query":{"view":"all","q":null,"domain":null,"status":null},"summary":{"total_sources":895,"total_tools":69,"sources_by_domain":{"state":210,"commercial":100,"hospital":25,"provider_identity":40,"medicare":423,"drug":69,"curated":23,"provenance":5},"sources_by_stage":{"silver":503,"semantic_view":217,"curated":7,"mart":88,"index":1,"dim":60,"raw":4,"reference":9,"registry":5,"bronze":1},"sources_by_status":{"partial":249,"live":532,"planned":35,"retired":76,"design_locked":2,"blocked":1},"sources_with_documented_row_count":638,"tools_linked_to_a_source":54,"tools_unlinked":15,"tools_by_layer":{"L2":63,"L1":6},"warnings_count":9,"live_inspection":{"glue_available":false,"postgres_available":false}},"warnings":["2 asset(s) have no dataset assignment: dc_medicaid_enrollment_history, vw_medicaid_procurement_open_now","`known_gaps` differs between assets of the same dataset in 99 dataset(s); left on the asset. Assets that disagree about known_gaps may not belong to one source.","`freshness_sla` differs between assets of the same dataset in 80 dataset(s); left on the asset. Assets that disagree about freshness_sla may not belong to one source.","`recollection` differs between assets of the same dataset in 79 dataset(s); left on the asset. Assets that disagree about recollection may not belong to one source.","`provenance_chain_ref` differs between assets of the same dataset in 64 dataset(s); left on the asset. Assets that disagree about provenance_chain_ref may not belong to one source.","`commercial_terms` differs between assets of the same dataset in 40 dataset(s); left on the asset. Assets that disagree about commercial_terms may not belong to one source.","`context_doc_path` differs between assets of the same dataset in 26 dataset(s); left on the asset. Assets that disagree about context_doc_path may not belong to one source.","live inspection disabled via --no-live","95 of 288 join edge(s) are unvalidated and 164 have passed; no cross-source tool may be generated from an unvalidated edge (run ops/scripts/validate_join_edges.py)."],"domains":{"commercial":{"source_count":100,"tool_count":8,"sources":["medicare_semantic.vw_plan_attributes_puf_current","medicare_semantic.vw_benefits_cost_sharing_current","medicare_semantic.vw_plan_id_crosswalk_puf_current","medicare_silver.fact_machine_readable_url_puf_history","cms_transparency_qhp_coverage_puf","cms_marketplace_quality_puf","medicare_silver.fact_nationwide_qrs_puf_history","medicare_silver.fact_enrollee_survey_puf_history","medicare_semantic.vw_service_area_puf_current","medicare_semantic.vw_network_puf_current","medicare_semantic.vw_business_rules_puf_current","vlada_curated.fact_rate","vlada_curated.mart_rate_by_code","vlada_curated.idx_rate_lookup","vlada_curated.dim_payer","s3://vlada-platform-raw/commercial_v2","vlada_curated.rate_provider_edge","vlada_curated.mart_rate_by_entity","medicare_silver.fact_idr_determination","medicare_silver.fact_tc_puf_issuer_claims","medicare_silver.fact_rate_puf","insurer_silver.fact_insurer_mlr","insurer_silver.dim_insurer_mlr_identity","medicare_silver.fact_transparency_in_coverage_puf_history","medicare_silver.fact_quality_puf_history","medicare_silver.fact_exchange_plan_profile","medicare_silver.fact_idr_air_ambulance_determination","medicare_silver.fact_idr_qpa_offer","medicare_silver.fact_idr_supplemental_summary","medicare_silver.fact_idr_supplemental_state","medicare_silver.fact_idr_supplemental_party","medicare_silver.fact_idr_supplemental_qpa_band","medicare_silver.fact_idr_supplemental_specialty","medicare_silver.fact_marketplace_plan_enrollment_measure_history","medicare_silver.fact_marketplace_issuer_geography_enrollment_measure_history","medicare_semantic.vw_hix_state_enrollment_observation_v1","medicare_silver.fact_rate_review_puf_history","medicare_silver.fact_aca_risk_adjustment_transfer_history","medicare_silver.fact_marketplace_monthly_effectuated_enrollment_history","ga_georgia_access_puf","cms_independent_sbe_packages","va_vim_enrollment_metrics","ky_khbe_governors_metrics","ca_covered_california_enrollment_profiles","nj_getcoverednj_enrollment","nj_dobi_ihc_enrollment","wa_hbe_enrollment_reports","ny_nysoh_enrollment_data","vt_vhc_data_surfaces","ar_aid_marketplace_surfaces","medicare_silver.dim_hix_temporal_identity_bridge","medicare_silver.marketplace_issuer_parent_bridge_v1","medicare_semantic.vw_marketplace_enrollment_by_parent_v1","medicare_gold.mart_hix_*","medicare_semantic.vw_aca_risk_adjustment_transfer_current_v1","insurer_silver.vw_insurer_mlr_current","medicare_semantic.vw_machine_readable_url_puf_redacted_v1","medicare_silver.fact_exchange_plan_profile_v2","medicare_semantic.vw_rate_puf_current","medicare_silver.fact_rate_puf_history","medicare_silver.fact_sbe_plan_attributes_puf_history","medicare_silver.fact_sbe_benefits_cost_sharing_puf_history","medicare_silver.fact_sbe_business_rules_puf_history","medicare_silver.fact_sbe_service_area_puf_history","medicare_silver.fact_sbe_network_puf_history","medicare_silver.fact_sbe_rate_puf_history","medicare_semantic.vw_quality_puf_current","medicare_semantic.vw_nationwide_qrs_puf_current","medicare_semantic.vw_enrollee_survey_puf_current_v1","medicare_silver.fact_idr_bimonthly_status","medicare_silver.vw_fact_tx_tdi_idr_summary","medicare_silver.fact_va_boi_balance_billing_arbitration","medicare_silver.fact_urr_submission_history","medicare_semantic.vw_rate_review_puf_current_v1","medicare_silver.marketplace_state_rate_decision_v1","medicare_silver.marketplace_state_calendar_rule_v1","medicare_silver.marketplace_state_participation_event_v1","medicare_silver.marketplace_issuer_parent_v1","medicare_silver.marketplace_forward_exposure_v1","medicare_semantic.vw_rate_filing_market_v1","medicare_semantic.vw_rate_filing_yoy_drivers_v1","medicare_silver.marketplace_sbe_slcsp_county_v1","medicare_silver.marketplace_sbm_issuer_enrollment_history_v1","medicare_semantic.vw_hix_plan_v1","medicare_semantic.vw_hix_plan_premium_v1","medicare_semantic.vw_hix_plan_county_v1","medicare_semantic.vw_hix_county_benchmark_v1","medicare_semantic.vw_hix_county_benchmark_ages_v1","medicare_semantic.vw_hix_market_structure_v1","medicare_semantic.vw_hix_benchmark_change_v1","medicare_semantic.vw_hix_after_credit_v1","medicare_silver.hix_credit_schedule_v1","medicare_silver.hix_poverty_guidelines_v1","medicare_silver.hix_plan_county_v1","medicare_silver.hix_county_benchmark_v1","medicare_silver.hix_county_benchmark_ages_v1","medicare_silver.hix_market_structure_v1","medicare_silver.hix_benchmark_change_v1","medicare_silver.hix_sbe2027_state_rates_v1","medicare_silver.hix_sbe2027_state_service_area_v1"],"tools":["get_exchange_plan_profile","get_negotiated_rate","lookup_rates_for_npi","lookup_rates_for_tin","plan_commercial_price_proof","prove_commercial_price","query_substrate","replay_commercial_price_proof"]},"curated":{"source_count":23,"tool_count":14,"sources":["vlada_curated.mart_unified_pricing","drug_silver.dim_icd10cm","drug_silver.dim_icd10pcs","medicare_silver.dim_code_validity","medicare_silver.cpt_revcode_modal","vlada_curated.dim_code","vlada_curated.dim_geography","vlada_curated.dim_code_billing_class","vlada_curated.dim_state_metric","vlada_curated.dim_taxonomy_procedures","vlada_curated.agg_county_intelligence","vlada_curated.agg_care_site_payer_coverage","vlada_curated.agg_county_payer_landscape","vlada_curated.agg_state_payer_roster","vlada_curated.fact_policy_document","vlada_curated.fact_policy_doc_chunk","vlada_curated.dim_hcpcs","vlada_curated.dim_state","vlada_ontology.l1_entity","vlada_ontology.l1_identifier","vlada_ontology.l1_edge","vlada_ontology.l1_evidence","vlada_ontology.l1_event"],"tools":["certified_measure","describe_data_source","describe_entity","describe_schema","fetch_query","find_data_sources","find_views","how_to_join","poll_query","query","resolve_entity","search_tools","state_expert","submit_query"]},"drug":{"source_count":69,"tool_count":8,"sources":["drug_silver.fact_drug_acquisition_cost","drug_silver.fact_drug_asp_quarterly#drug_asp","drug_silver.fact_drug_asp_quarterly","drug_silver.fact_drug_asp_quarterly_v2","drug_silver.fact_asp_ndc_hcpcs_crosswalk","drug_silver.fact_form5500_insurance","drug_silver.fact_form5500_insurance_broker","drug_silver.fact_form5500_financials","drug_silver.fact_form5500_filing","drug_silver.fact_form5500_service_provider","drug_silver.fact_drug_consumer_price","drug_silver.fact_drug_hcai_sb17_wac_increase","drug_silver.fact_drug_reimbursement#ira_mfp","drug_logical.fact_drug_formulary_scaffold","drug_silver.fact_drug_formulary","drug_silver.vw_fact_drug_formulary_v2","drug_silver.fact_drug_formulary_excluded","drug_silver.dim_part_d_plan","drug_silver.vw_dim_part_d_plan_v3","drug_silver.vw_dim_part_d_plan_v4","drug_silver.fact_part_d_plan_service_area","drug_silver.fact_part_d_plan_cost_share","drug_silver.vw_fact_part_d_plan_cost_share_v3","drug_silver.fact_part_d_plan_drug_pricing","drug_silver.vw_fact_part_d_plan_drug_pricing_v2","drug_silver.dim_orange_book_product","drug_logical.dim_purple_book_product_reference","drug_silver.dim_purple_book_product","drug.dea_controlled_substances","drug_silver.dim_dea_ndc_schedule","drug_silver.fact_drug_payment_to_prescriber","drug_silver.dim_drug","drug_silver.fact_drug_spending_part_d","drug_silver.vw_fact_drug_spending_part_d_v2","drug_silver.fact_part_d_prescriber","drug_silver.fact_drug_spending_part_b","drug_silver.fact_drug_va_fss_price","drug_silver.fact_drug_medicaid_rebate_product","drug_silver.fact_drug_medicaid_utilization","drug_silver.fact_drug_shortage","drug_silver.fact_drug_recall","drug_silver.fact_fda_warning_letter","drug_silver.dim_rxclass_class","drug_silver.fact_rxclass_membership","drug_silver.fact_orange_book_patent","drug_silver.fact_orange_book_exclusivity","drug_silver.dim_drug_label","drug_silver.dim_drug_application","drug_silver.dim_dmf","drug_silver.fact_drug_clinical_trial","drug_silver.fact_form5500_service_provider_code","drug_silver.fact_drug_discarded_units","drug_silver.fact_faers_drug","medicare_silver.fact_part_d_spending_by_drug_quarterly","medicare_silver.fact_part_d_prescriber_by_provider","medicare_silver.fact_part_d_opioid_prescribing_geo","drug_silver.fact_part_d_insulin_cost_share","drug_silver.fact_part_d_indication_based_coverage","drug_silver.fact_part_d_plan_initial_coverage_limit","drug_silver.fact_part_d_plan_cost_share_gap_coverage","drug_silver.fact_drug_formulary_excluded_gap_coverage","drug_silver.vw_fact_drug_formulary_monthly_v2","drug_silver.vw_dim_part_d_plan_monthly_v3","drug_silver.vw_dim_part_d_plan_monthly_v4","drug_silver.fact_part_d_plan_service_area_monthly","drug_silver.fact_part_d_plan_cost_share_monthly","drug_silver.fact_drug_formulary_excluded_monthly","drug_silver.fact_part_d_pharmacy_network","vlada_curated.state_employer_plan_v1"],"tools":["asp_pricing_lookup","excluded_prescriber_payment_screen","formulary_churn","get_drug_source_inventory","ira_drug_label_risk_screen","ira_mfp_exposure","pbm_compensation_rollup","recall_spend_window"]},"hospital":{"source_count":25,"tool_count":7,"sources":["vlada_curated.fact_hospital_chargemaster","s3://vlada-platform-raw/hospital","medicare_silver.fact_hospital_quality_measure","medicare_silver.dim_hospital_quality","medicare_silver.fact_inpatient_payment_by_geo","medicare_silver.fact_outpatient_payment_by_geo","vlada_curated.vw_fact_hospital_chargemaster_comparable","vlada_curated.vw_fact_hospital_chargemaster_canonical","vlada_curated.vw_fact_hospital_chargemaster_current","vlada_curated.vw_fact_hospital_chargemaster_validated","vlada_curated.fact_hospital_comparability_mat","vlada_curated.mart_hospital_cell","vlada_curated.vw_hospital_comparison_mart","vlada_curated.mart_code_state_rollup","vlada_curated.mart_code_state_payer_rollup","vlada_curated.mart_hospital_dept_ccr","vlada_curated.mart_hospital_dept_ccr_history","medicare_silver.fact_hospital_service_area","medicare_silver.fact_hrrp","medicare_silver.fact_hvbp","medicare_silver.fact_hacrp","medicare_silver.state_facility_v1","vlada_curated.state_affiliation_edge_v1","vlada_curated.state_pricing_coverage_v1","vlada_curated.state_quality_v1"],"tools":["compare_hospital_rates","coverage_status","get_hospital_quality","get_service_line_prices","plan_hospital_price","prove_hospital_price","replay_hospital_price"]},"medicare":{"source_count":423,"tool_count":30,"sources":["medicare_silver.fact_pfs_rvu","medicare_silver.fact_opps_addendum_b","drug_silver.dim_msdrg","medicare_silver.fact_asc_addendum","medicare_silver.medicare_clfs_rates","medicare_silver.fact_clfs_national_rate","medicare_silver.ma_county_ratebook","medicare_semantic.vw_ma_county_ratebook_v3","medicare_silver.ma_rate_calculation_cell","medicare_silver.ma_rate_calculation_cell_v2","medicare_silver.ma_uspcc","medicare_semantic.vw_ma_uspcc_v2","medicare_silver.ma_part_d_benchmark_figure","medicare_silver.stars_ratings_summary","medicare_silver.stars_ratings_measure","medicare_silver.stars_cutpoints","medicare_silver.stars_cai","medicare_silver.stars_contracts","medicare_silver.stars_display_measures","medicare_silver.dim_stars_measures","medicare_silver.dim_stars_methodology","medicare_silver.dim_stars_measure_crosswalk","medicare_silver.hedis_general","medicare_semantic.vw_hedis_general_v2","medicare_silver.hedis_hos_frm","medicare_silver.hedis_hos_mui","medicare_silver.hedis_hos_oto","medicare_silver.hedis_hos_pao","medicare_silver.hedis_measures","medicare_silver.hedis_measures_v2","medicare_silver.hedis_national_rates","medicare_semantic.vw_hedis_national_rates_v2","medicare_silver.hedis_rau_measures","medicare_silver.hedis_service_area","medicare_semantic.vw_hedis_service_area_v2","medicare_silver.ma_contract_service_area","medicare_silver.ma_contract_service_area_v2","medicare_silver.ma_state_county_penetration","medicare_semantic.vw_ma_state_county_penetration_v2","medicare_semantic.vw_ma_state_county_penetration_v3","medicare_semantic.vw_ma_state_county_penetration_v4","medicare_silver.mpf_benefit_summary_annual","medicare_silver.pbp_changelog","medicare_silver.pbp_field_dictionary","medicare_silver.pbp_mrx","medicare_silver.pbp_mrx_gap_coverage","medicare_silver.pbp_mrx_p","medicare_silver.pbp_mrx_tier","medicare_silver.pbp_plan_area","medicare_silver.pbp_plan_region_area","medicare_silver.pbp_sas_schema","medicare_silver.pbp_section_a","medicare_silver.pbp_section_b10_amb_trans","medicare_silver.pbp_section_b11_dme_prosth_orth_sup","medicare_silver.pbp_section_b12_renal_dialysis","medicare_silver.pbp_section_b14_preventive","medicare_silver.pbp_section_b15_partb_rx_drugs","medicare_silver.pbp_section_b19_model_test","medicare_silver.pbp_section_b1a_inpat_hosp","medicare_silver.pbp_section_b1b_inpat_hosp_psych","medicare_silver.pbp_section_b20","medicare_silver.pbp_section_b2_snf","medicare_silver.pbp_section_b3_cardiac_rehab","medicare_silver.pbp_section_b3_corf","medicare_silver.pbp_section_b4_emerg_urgent","medicare_silver.pbp_section_b5_partial_hosp","medicare_silver.pbp_section_b6_home_health","medicare_silver.pbp_section_b7_health_prof","medicare_silver.pbp_section_b8_clin_diag_ther","medicare_silver.pbp_section_b9_outpat_hosp","medicare_silver.pbp_section_c","medicare_silver.pbp_section_c_oon","medicare_silver.pbp_section_c_pos","medicare_silver.pbp_section_d","medicare_silver.pbp_section_d_oon","medicare_silver.pbp_section_d_opt","medicare_silver.pbp_vbid_overlay","medicare_silver.snp_data","medicare_semantic.vw_snp_data_v2","medicare_silver.snp_data_v2","medicare_semantic.vw_snp_data_v3","medicare_semantic.vw_pbp_b19_combined_package","medicare_semantic.vw_pbp_cardiac_pulmonary_rehab","medicare_semantic.vw_pbp_clinical_diagnostic_therapeutic","medicare_semantic.vw_pbp_dental","medicare_semantic.vw_pbp_dme","medicare_semantic.vw_pbp_emergency_urgent","medicare_semantic.vw_pbp_health_professionals","medicare_semantic.vw_pbp_hearing","medicare_semantic.vw_pbp_home_health","medicare_semantic.vw_pbp_inpatient_hospital","medicare_semantic.vw_pbp_inpatient_psychiatric","medicare_semantic.vw_pbp_moop","medicare_semantic.vw_pbp_otc","medicare_semantic.vw_pbp_outpatient_hospital","medicare_semantic.vw_pbp_partb_rx_drugs","medicare_semantic.vw_pbp_partd_drugs","medicare_semantic.vw_pbp_partd_tier","medicare_semantic.vw_pbp_partial_hospitalization","medicare_semantic.vw_pbp_preventive","medicare_semantic.vw_pbp_renal_dialysis","medicare_semantic.vw_pbp_section_c_pos_oon","medicare_semantic.vw_pbp_snf","medicare_semantic.vw_pbp_supplemental_other","medicare_semantic.vw_pbp_transportation","medicare_semantic.vw_pbp_vision","medicare_semantic.vw_pbp_benefits","medicare_semantic.vw_pbp_plan_deductible","medicare_semantic.vw_pbp_dsnp_cost_share","medicare_semantic.vw_pbp_meals","medicare_semantic.vw_benefit_vector","medicare_semantic.vw_benefit_vector_v2_ext","medicare_semantic.vw_pbp_fitness","medicare_semantic.vw_pbp_worldwide","medicare_semantic.vw_pbp_ambulance","medicare_semantic.vw_pbp_supplemental_services","medicare_semantic.vw_pbp_combined_supplemental","medicare_semantic.vw_pbp_combined_benefits_group","medicare_semantic.vw_pbp_optional_package","medicare_semantic.vw_pbp_optional_supplemental","medicare_semantic.vw_pbp_plan_premium","vlada_curated.vw_medicare_benchmark_effective","vlada_curated.vw_ipps_hospital_base","medicare_silver.medicare_clfs_locality_rates","medicare_silver.snf_cost_report_overall","medicare_silver.snf_cost_report_dept","medicare_silver.cms_bsa_inpatient_claim","medicare_silver.cms_bsa_outpatient_procedure","medicare_silver.cms_bsa_carrier_line_item","medicare_silver.cms_bsa_dme_line_item","medicare_silver.cms_bsa_prescription_drug_event","medicare_silver.cms_bsa_prescription_drug_profile","medicare_silver.cms_bsa_chronic_condition","medicare_silver.cms_bsa_hha_beneficiary","medicare_silver.cms_bsa_hospice_beneficiary","medicare_silver.cms_bsa_snf_beneficiary","medicare_silver.cms_bsa_institutional_provider_beneficiary_summary","medicare_silver.cms_bsa_physician_supplier_beneficiary_summary","medicare_silver.cms_bsa_field","medicare_silver.cms_bsa_source_asset","medicare_silver.enrollment_monthly_county","medicare_semantic.vw_enrollment_monthly_county_v2","medicare_silver.enrollment_monthly_county_v4","medicare_semantic.vw_enrollment_monthly_county_v3","medicare_silver.enrollment_monthly_plan","medicare_semantic.vw_enrollment_monthly_plan_v2","medicare_silver.plan_crosswalks_annual","medicare_silver.monthly_contract_enrollment_summary","medicare_semantic.vw_monthly_contract_enrollment_summary_v2","medicare_silver.ma_mlr","medicare_silver.fact_ma_mlr","medicare_silver.fact_ma_mlr_v2","medicare_silver.hospital_cost_report_overall","medicare_silver.hospital_cost_report_dept","medicare_silver.facility_cost_report_unit","medicare_silver.fact_facility_cost_report_unit","medicare_silver.facility_cost_report_ccr","medicare_silver.fact_facility_cost_report_ccr","medicare_silver.hospital_outpatient_volume","medicare_silver.hcpcs_cost_center_crosswalk","medicare_silver.ma_plan_payment_part_c","medicare_silver.ma_plan_payment_part_c_v2","medicare_silver.ma_plan_payment_part_d","medicare_silver.ma_plan_payment_part_d_v2","medicare_silver.ma_plan_payment_county","medicare_silver.ma_plan_payment_county_v2","medicare_silver.dim_hcc_coefficients","medicare_silver.dim_hcc_coefficients_v2","medicare_semantic.vw_hcc_coefficients_current_v2","medicare_silver.dim_icd10_hcc_crosswalk","medicare_silver.dim_icd10_hcc_crosswalk_v3","medicare_semantic.vw_icd10_hcc_crosswalk_current_v1","medicare_silver.landscape_all","medicare_silver.fact_ma_landscape","medicare_silver.pbp_section_b13_other_services","medicare_silver.pbp_section_b16_dental","medicare_silver.pbp_section_b17_eye_exams_wear","medicare_silver.pbp_section_b18_hearing_exams_aids","medicare_silver.fact_ipps_wage_index","medicare_silver.fact_dme_payment_by_geo","medicare_silver.fact_physician_payment_by_geo","medicare_silver.fact_ipps_base_rate","medicare_silver.medicare_gpci_locality","medicare_silver.medicare_conversion_factor","medicare_silver.dim_anesthesia_base_unit","medicare_silver.medicare_county_to_locality","medicare_silver.medicare_zip_to_locality","medicare_silver.medicare_zip5_locality","vlada_curated.vw_medicare_benchmark","medicare_silver.landscape_ma_all","medicare_silver.ma_landscape_member_ledger","medicare_silver.fact_ma_landscape_edition","medicare_silver.ma_landscape_edition_ledger","medicare_silver.mpf_optional_supplemental_annual","medicare_silver.fact_medicare_geo_variation","medicare_silver.fact_esrd_qip","medicare_silver.ncci_ptp","medicare_silver.ref_ncci_ptp_edit","medicare_silver.medicare_pfs_indicators","medicare_silver.fact_physician_by_provider_service","medicare_silver.fact_inpatient_by_provider_service","medicare_silver.fact_outpatient_by_provider_service","medicare_silver.fact_dme_by_supplier_service","medicare_silver.fact_clfs_private_payer_rate","medicare_silver.fact_clfs_private_payer_rate_2026collection","medicare_silver.fact_clfs_preliminary_rate","medicare_silver.fact_market_saturation","medicare_silver.fact_post_acute_utilization","medicare_silver.fact_aco_participant","medicare_silver.fact_qpp_experience","medicare_silver.fact_medicaid_managed_care","medicare_silver.fact_psps","medicare_silver.fact_hcahps","medicare_silver.fact_hospice_quality","medicare_silver.fact_home_health_quality","medicare_silver.fact_nursing_home_quality","medicare_silver.fact_ambulance_fee_schedule","medicare_silver.fact_hospice_pps_rate","medicare_silver.fact_irf_pps_cmg_weight","medicare_silver.fact_hh_pdgm_weight","medicare_silver.fact_fqhc_pps_rate","medicare_silver.fact_snf_pdpm_rate","medicare_silver.fact_ltch_pps_drg_weight","medicare_silver.hospital_cost_report_utilization","medicare_silver.hospital_cost_report_financial","medicare_silver.hospital_cost_report_profile","medicare_silver.hospital_cost_report_report","medicare_silver.hospital_cost_report_numeric_cell","medicare_silver.hospital_cost_report_alpha_cell","medicare_silver.hospital_cost_report_payer_revenue","medicare_silver.mcd_document","medicare_silver.mcd_document_relationship","medicare_silver.mcd_document_component","medicare_silver.mcd_reference","medicare_silver.resdac_claim_reference_source_asset","medicare_silver.resdac_claim_code","medicare_silver.resdac_specialty_taxonomy_crosswalk","medicare_silver.x12_code_list_asset","medicare_silver.ahrq_source_asset","medicare_silver.ahrq_ccsr_mapping","medicare_silver.ahrq_ccsr_category","medicare_silver.ahrq_qi_value_set","medicare_silver.ahrq_qi_benchmark","medicare_silver.medpac_databook_source_asset","medicare_silver.medpac_databook_page","medicare_silver.medpac_databook_workbook_cell","medicare_silver.medpac_databook_exhibit","medicare_silver.medpac_databook_metric_observation","medicare_silver.fact_medicaid_core_set_quality","medicare_silver.ipps_payment_source_asset","medicare_silver.ipps_impact_provider_row","medicare_silver.inpatient_psf_provider_record","medicare_silver.qualitynet_methodology_source_asset","medicare_silver.qualitynet_methodology_document","medicare_silver.qualitynet_methodology_document_text","medicare_silver.qualitynet_methodology_table_row","medicare_silver.cssc_operations_source_asset","medicare_silver.cssc_operations_resource","medicare_silver.cssc_operations_attachment","medicare_silver.cssc_operational_edit","medicare_silver.cssc_acceptable_specialty","medicare_silver.cssc_sbsc_code","medicare_silver.fact_ahrq_nhqdr_quality","medicare_semantic.vw_state_quality_publisher","medicare_semantic.vw_state_quality_rollup","vlada_curated.dim_contract","medicare_silver.fact_pfs_gpci_locality","medicare_silver.fact_pfs_locality_config","medicare_semantic.fact_landscape_disposition_v1","medicare_semantic.fact_landscape_benefits_v1","medicare_semantic.fact_landscape_benefits_county_v1","medicare_semantic.fact_landscape_benefits_v2","medicare_semantic.fact_landscape_benefits_county_v2","medicare_semantic.vw_benefit_engine_atoms","medicare_semantic.benefit_engine_atoms_v20261005","medicare_semantic.benefit_engine_atoms_v20261006","medicare_semantic.benefit_engine_atoms_v20261006b","medicare_semantic.benefit_engine_atoms_v20261006c","medicare_semantic.benefit_engine_atoms_v20261007a","medicare_semantic.benefit_company_cells_v20261007a","medicare_semantic.benefit_company_cells_sd_v20261007a","medicare_semantic.vw_benefit_reading_atoms","medicare_semantic.vw_benefit_reading_matched","medicare_semantic.vw_benefit_contract_match","medicare_semantic.vw_benefit_contract_cells","medicare_semantic.vw_benefit_reading_transitions","medicare_semantic.vw_benefit_reading_simple","medicare_semantic.vw_benefit_reading_cells_sd","medicare_semantic.vw_benefit_reading_cells","medicare_semantic.benefit_engine_atoms_v20261008a","medicare_semantic.dim_stars_measure_identity_v7","medicare_semantic.vw_plan_value_national","medicare_semantic.vw_plan_value_county","medicare_semantic.vw_plan_value_plans","medicare_semantic.vw_plan_value_cells","medicare_semantic.vw_plan_value_pairs","medicare_semantic.plan_value_shelf_v18","medicare_semantic.plan_value_shelf_v18b","medicare_semantic.plan_value_shelf_v19d","medicare_semantic.plan_value_shelf_v19e","medicare_semantic.benvat_v1_plan_county","medicare_semantic.benvat_county_v1","medicare_semantic.dim_parent_alias_v1","medicare_semantic.fact_parent_lineage_event_v1","medicare_semantic.vw_ma_parent_resolved_v1","medicare_silver.lis_enrollment_plan","medicare_silver.lis_contract_county","medicare_silver.pdp_state_county_penetration","medicare_silver.pdp_contract_service_area","medicare_silver.state_service_area","medicare_silver.fact_plan_directory_contract","medicare_silver.fact_oec_monthly_enrollment","medicare_silver.fact_ma_part_d_corrective_action_plan","medicare_silver.fact_ma_claims_processing_contact","medicare_silver.snp_hedis_general","medicare_silver.snp_hedis_service_area","medicare_silver.snp_hedis_measures","medicare_silver.snp_hedis_rau_measures","medicare_semantic.vw_hos_puf_respondent_v2","medicare_silver.fact_ma_geographic_variation","medicare_silver.fact_medicare_monthly_enrollment","medicare_silver.fact_mssp_county_expenditure_risk","medicare_silver.fact_mssp_aco_performance_cell","medicare_silver.fact_retiree_drug_subsidy_sponsor","medicare_silver.fact_ma_part_d_warning_letter","medicare_silver.fact_dmepos_fee_schedule","medicare_silver.dsnp_integration_status_v1","medicare_silver.cms_dsnp_integration_status_list_v1","medicare_silver.cms_dsnp_lookalike_list_v1","medicare_semantic.vw_dsnp_medicaid_wrap_v5","medicare_semantic.vw_dsnp_medicaid_wrap_v4","medicare_semantic.vw_dsnp_medicaid_wrap_v3","medicare_semantic.vw_dsnp_medicaid_wrap_v2","medicare_semantic.vw_dsnp_medicaid_wrap_v1","medicare_semantic.ma_spine_county_v20261012a","medicare_semantic.ma_spine_landscape_county_v20261012b","medicare_semantic.ma_spine_parent_month_v20261012a","medicare_semantic.ma_spine_plan_lineage_v20261012a","medicare_semantic.ma_spine_plan_year_v20261012c","medicare_semantic.ma_spine_parent_month_v20261017a","medicare_bronze.ma_directory_plan_npi_site_v1","medicare_semantic.ma_spine_contract_stars_v20261012b","medicare_semantic.ma_spine_plan_stars_v20261012c","medicare_semantic.ma_spine_contract_measures_v20261012a","medicare_semantic.ma_spine_moves_v20261012a","medicare_semantic.ma_spine_plan_payment_v20261012a","medicare_semantic.ma_spine_contract_mlr_v20261012a","medicare_semantic.ma_spine_plan_econ_v20261012a","medicare_semantic.ma_spine_company_v20261012c","medicare_semantic.ma_spine_company_anchor_v20261012f","medicare_semantic.ma_spine_county_market_v20261012b","medicare_semantic.ma_spine_partd_plan_v20261012c","medicare_semantic.ma_spine_formulary_v20261012a","medicare_semantic.ma_spine_formulary_churn_v20261012b","medicare_semantic.ma_spine_enroll_plan_county_v20261012a","medicare_semantic.ma_spine_enroll_plan_month_v20261012a","medicare_semantic.ma_spine_enroll_parent_month_v20261012a","medicare_semantic.ma_spine_rules_v20261012b","medicare_semantic.ma_spine_plan_footprint_v20261012a","medicare_semantic.ma_spine_snp_v20261012a","medicare_semantic.ma_spine_plan_bid_v20261012a","medicare_semantic.ma_spine_pdp_plan_year_v20261012a","medicare_silver.ma_pdp_enrollment_by_state_v1","medicare_silver.ma_pdp_enrollment_by_state_county_contract_v1","medicare_silver.ma_pdp_enrollment_by_state_county_plan_type_v1","medicare_silver.ma_partd_agent_broker_compensation_limit_v1","medicare_silver.vw_ma_landscape_contract_year_v20261013a","medicare_silver.vw_pbp_mrx_current_v20261013a","medicare_semantic.cvi_plan_county_v4","medicare_semantic.cvi_county_v4","medicare_silver.ma_rate_notice_figure","medicare_silver.ma_rate_notice_value","medicare_silver.ma_rate_notice_document","medicare_silver.ma_rate_notice_stage_change","medicare_silver.ma_rate_notice_uspcc_estimate","medicare_silver.ma_rate_notice_risk_model_cell","medicare_silver.ma_rate_notice_part_d_parameter","medicare_silver.ma_rate_notice_payment_parameter","medicare_silver.ma_rate_notice_projection","medicare_silver.ma_rate_notice_call_letter","medicare_semantic.vw_state_medicare_al_v1","medicare_semantic.vw_state_medicare_ar_v1","medicare_semantic.vw_state_medicare_az_v1","medicare_semantic.vw_state_medicare_ca_v1","medicare_semantic.vw_state_medicare_co_v1","medicare_semantic.vw_state_medicare_ct_v1","medicare_semantic.vw_state_medicare_fl_v1","medicare_semantic.vw_state_medicare_ga_v1","medicare_semantic.vw_state_medicare_ia_v1","medicare_semantic.vw_state_medicare_il_v1","medicare_semantic.vw_state_medicare_in_v1","medicare_semantic.vw_state_medicare_ks_v1","medicare_semantic.vw_state_medicare_ky_v1","medicare_semantic.vw_state_medicare_la_v1","medicare_semantic.vw_state_medicare_ma_v1","medicare_semantic.vw_state_medicare_md_v1","medicare_semantic.vw_state_medicare_mi_v1","medicare_semantic.vw_state_medicare_mn_v1","medicare_semantic.vw_state_medicare_mo_v1","medicare_semantic.vw_state_medicare_ms_v1","medicare_semantic.vw_state_medicare_nc_v1","medicare_semantic.vw_state_medicare_nj_v1","medicare_semantic.vw_state_medicare_nv_v1","medicare_semantic.vw_state_medicare_ny_v1","medicare_semantic.vw_state_medicare_oh_v1","medicare_semantic.vw_state_medicare_ok_v1","medicare_semantic.vw_state_medicare_or_v1","medicare_semantic.vw_state_medicare_pa_v1","medicare_semantic.vw_state_medicare_sc_v1","medicare_semantic.vw_state_medicare_tn_v1","medicare_semantic.vw_state_medicare_tx_v1","medicare_semantic.vw_state_medicare_ut_v1","medicare_semantic.vw_state_medicare_va_v1","medicare_semantic.vw_state_medicare_wa_v1","medicare_semantic.vw_state_medicare_wi_v1","medicare_silver.dim_network_specialty_v1","medicare_silver.ma_network_provider_v1","medicare_silver.ma_network_plan_county_v1","medicare_silver.ma_network_plan_hospital_v1","medicare_silver.ma_network_change_v1","medicare_silver.ma_network_active_v1","medicare_silver.nppes_deactivated_npi_v1","medicare_silver.ma_network_contract_group_v1"],"tools":["get_benefit_change","get_contract_profile","get_contract_service_area","get_county_view","get_enrollment","get_hos","get_landscape","get_landscape_benefit_change","get_landscape_exits","get_market_share","get_medicaid_mco_enrollment","get_network_breadth","get_network_change","get_network_groups","get_network_system_change","get_pbp_benefit","get_plan_hospitals","get_plan_network","get_plan_value","get_quality_bonus","get_star_benchmark","get_star_decomposition","get_star_risk","get_stars","get_stars_cutpoints","get_stars_rollup","get_volatility_index","is_provider_in_plan","medicare_allowed","prove_ma_enrollment_trend"]},"provenance":{"source_count":5,"tool_count":0,"sources":["dim_substrate_mrf_version","medicare_source_registry_cache","drug_source_registry_cache","dim_mrf_version","medicare_silver.fact_hix_state_artifact_revision_history"],"tools":[]},"provider_identity":{"source_count":40,"tool_count":1,"sources":["vlada_curated.provider_facility_xref","s3://vlada-platform-raw/nppes","vlada_curated.dim_provider","vlada_curated.dim_provider_service","vlada_curated.dim_facility","vlada_curated.dim_clia_lab","vlada_curated.dim_asc","vlada_curated.dim_dialysis_facility","medicare_silver.dim_imaging_facility","drug_silver.dim_facility_affiliation","vlada_curated.dim_hospital_external","drug_silver.dim_nucc_taxonomy","medicare_silver.dim_snf","medicare_silver.dim_hha","medicare_silver.dim_hospice","medicare_silver.dim_rhc","medicare_silver.dim_fqhc","medicare_silver.dim_irf","medicare_silver.dim_ltch","drug_silver.dim_oig_leie","drug_silver.dim_hhs_oig_cia","drug_silver.dim_hrsa_covered_entity","drug_silver.fact_hrsa_ce_npi","vlada_curated.dim_care_site","vlada_curated.dim_ccn_cbsa","vlada_curated.dim_health_system","vlada_curated.dim_hospital_system","vlada_curated.dim_provider_facility_affiliation","vlada_curated.fact_care_site_verification","vlada_curated.vw_care_site_verified","vlada_curated.care_site_geo","medicare_silver.fact_provider_ownership","medicare_silver.dim_dialysis_facility_quality","medicare_silver.fact_pecos_enrollment","medicare_silver.facility_npi_ccn_xref","medicare_silver.fact_provider_of_services","medicare_silver.dim_mdpp_supplier","medicare_silver.fact_hpsa","drug_silver.dim_device_udi","vlada_curated.dim_provider_ccn"],"tools":["resolve_provider"]},"state":{"source_count":210,"tool_count":1,"sources":["medicare_silver.org_subcontract","medicare_silver.ny_medicaid_parent_native_product_component_202609_v1","vlada_curated.fact_state_medicaid_rate","vlada_curated.fact_md_hscrc_unit_rate","vlada_curated.fact_ma_chia_relative_price","vlada_curated.fact_ct_medicaid_provider_rate","vlada_curated.fact_ct_medicaid_drg_weight","vlada_curated.fact_md_hscrc_monthly_rev_vol","vlada_curated.fact_ma_chia_revenue_cost_ratio","vlada_curated.fact_ct_hospital_cost_to_charge","vlada_curated.fact_nj_hospital_financials","medicare_silver.macpac_macstats_source_asset","medicare_silver.macpac_macstats_page","medicare_silver.macpac_macstats_workbook_cell","medicare_silver.macpac_macstats_exhibit","medicare_silver.macpac_macstats_metric_observation","medicare_silver.fact_cdc_nhsn_state_hai","medicare_silver.fact_medicaid_health_home_quality","medicare_silver.cms_medicaid_chip_enrollment_source_asset","medicare_silver.cms_medicaid_chip_enrollment_workbook_cell","medicare_silver.cms_medicaid_chip_enrollment_monthly_state","medicare_silver.cms_medicaid_managed_care_plan_source_asset","medicare_silver.cms_medicaid_managed_care_plan_enrollment","medicare_semantic.vw_medicaid_managed_care_plan_enrollment_parent_v1","medicare_silver.fact_ca_medi_cal_managed_care_enrollment","medicare_semantic.vw_ny_medicaid_mco_enrollment_tracker_reported_observation_v7_candidate_20261023t221902z_c5e4c8dc","medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v7","medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v6","medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5","medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v4","medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v3","medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v2","medicare_semantic.vw_medicaid_mco_parent_share_monthly","medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z","medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926t2334z","medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926","medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3","medicare_semantic.vw_medicaid_mco_parent_share_monthly_v2","medicare_semantic.vw_medicaid_mco_parent_share_monthly_v1","medicare_silver.medicaid_plan_parent_crosswalk_v2","medicare_silver.medicaid_plan_parent_crosswalk_v1","medicare_semantic.vw_medicaid_plan_quality_measure_v1","medicare_silver.medicaid_plan_quality_measure_v1","medicare_silver.medicaid_plan_quality_plan_xwalk_v1","medicare_semantic.vw_medicaid_mcpar_plan_appeals_v1","medicare_silver.medicaid_mcpar_puf_v1","medicare_silver.medicaid_mcpar_puf_question_v1","medicare_silver.medicaid_mcpar_puf_plan_xwalk_v1","medicare_silver.medicaid_capitation_rate_cycle_v2","medicare_silver.medicaid_capitation_rate_cell_v2","medicare_silver.medicaid_capitation_rate_cycle_v1","medicare_silver.medicaid_capitation_rate_cell_v1","medicare_silver.ca_calaim_1915b_source_occurrence","medicare_silver.ca_calaim_1915b_pdf_page","medicare_silver.ca_calaim_1915b_workbook_cell","medicare_silver.ca_medi_cal_managed_care_contract_source_occurrence","medicare_silver.ca_medi_cal_managed_care_contract_index_snapshot","medicare_silver.ca_medi_cal_managed_care_contract_index_snapshot_text","medicare_silver.ca_medi_cal_managed_care_contract_pdf_page","medicare_silver.ca_medi_cal_mcp_roster_source_occurrence","medicare_silver.ca_medi_cal_mcp_roster_pdf_page","medicare_silver.ca_medi_cal_mcp_county_plan_roster","medicare_silver.ca_smhs_1915b_legacy_history_period","medicare_silver.ca_smhs_1915b_legacy_source_occurrence","medicare_silver.ca_smhs_1915b_legacy_pdf_page","medicare_silver.state_duals_kb_source_v5","medicare_silver.state_duals_kb_source_v4","medicare_silver.state_duals_kb_rule_v5","medicare_silver.state_duals_kb_rule_v4","medicare_silver.state_duals_kb_state_program_v5","medicare_silver.state_duals_kb_state_program_v4","medicare_silver.state_duals_kb_benefit_coverage_v5","medicare_silver.state_duals_kb_benefit_coverage_v4","medicare_silver.state_duals_kb_payer_chain_v5","medicare_silver.state_duals_kb_payer_chain_v4","medicare_silver.state_duals_kb_dsnp_requirement_v5","medicare_silver.state_duals_kb_dsnp_requirement_v4","medicare_silver.state_duals_kb_cost_sharing_v5","medicare_silver.state_duals_kb_cost_sharing_v4","medicare_silver.state_duals_kb_msp_limits_v5","medicare_silver.state_duals_kb_msp_limits_v4","medicare_silver.state_duals_kb_change_log_v5","medicare_silver.state_duals_kb_change_log_v4","medicare_silver.state_duals_kb_open_question_v5","medicare_silver.state_duals_kb_open_question_v4","medicare_silver.state_duals_kb_plan_effective_benefit_v5","medicare_silver.state_duals_kb_plan_effective_benefit_v4","medicare_silver.state_duals_kb_filing_patterns_v2","medicare_silver.state_duals_kb_filing_patterns_v1","medicare_silver.state_duals_kb_source_v3","medicare_silver.state_duals_kb_rule_v3","medicare_silver.state_duals_kb_state_program_v3","medicare_silver.state_duals_kb_benefit_coverage_v3","medicare_silver.state_duals_kb_payer_chain_v3","medicare_silver.state_duals_kb_dsnp_requirement_v3","medicare_silver.state_duals_kb_cost_sharing_v3","medicare_silver.state_duals_kb_msp_limits_v3","medicare_silver.state_duals_kb_change_log_v3","medicare_silver.state_duals_kb_open_question_v3","medicare_silver.state_duals_kb_plan_effective_benefit_v3","medicare_silver.state_duals_kb_source_v2","medicare_silver.state_duals_kb_rule_v2","medicare_silver.state_duals_kb_state_program_v2","medicare_silver.state_duals_kb_benefit_coverage_v2","medicare_silver.state_duals_kb_payer_chain_v2","medicare_silver.state_duals_kb_dsnp_requirement_v2","medicare_silver.state_duals_kb_cost_sharing_v2","medicare_silver.state_duals_kb_msp_limits_v2","medicare_silver.state_duals_kb_change_log_v2","medicare_silver.state_duals_kb_open_question_v2","medicare_silver.state_duals_kb_plan_effective_benefit_v2","medicare_silver.state_duals_kb_source_v1","medicare_silver.state_duals_kb_rule_v1","medicare_silver.state_duals_kb_state_program_v1","medicare_silver.state_duals_kb_benefit_coverage_v1","medicare_silver.state_duals_kb_payer_chain_v1","medicare_silver.state_duals_kb_dsnp_requirement_v1","medicare_silver.state_duals_kb_cost_sharing_v1","medicare_silver.state_duals_kb_msp_limits_v1","medicare_silver.state_duals_kb_change_log_v1","medicare_silver.state_duals_kb_open_question_v1","medicare_silver.state_duals_kb_plan_effective_benefit_v1","medicare_semantic.vw_medicaid_sdp_program_year_operative_v1","medicare_semantic.vw_medicaid_va_hospital_actual_payments_v1","medicare_semantic.vw_medicaid_la_hospital_actual_payments_v1","medicare_semantic.vw_medicaid_ut_provider_actual_payments_v1","medicare_semantic.vw_medicaid_ut_uumg_medical_group_payments_v1","medicare_semantic.vw_medicaid_ok_provider_actual_payments_v1","medicare_silver.dc_medicaid_enrollment_history_observation","medicare_semantic.vw_medicaid_wa_provider_actual_payments_v1","medicare_semantic.vw_medicaid_az_provider_actual_payments_v1","medicare_semantic.vw_medicaid_tx_sdp_reconciliation_calculations_v1","medicare_semantic.vw_medicaid_procurement_open_now","medicare_semantic.vw_medicaid_mco_rate_timing_v1","medicare_semantic.vw_medicaid_mco_upcoming_rate_events_v1","medicare_silver.medicaid_mco_forward_exposure_v1","vlada_curated.vw_state_medicaid_rate_v2","vlada_curated.vw_state_medicaid_rate_change_v1","vlada_curated.vw_state_medicaid_rate_compare_v1","vlada_curated.vw_state_medicaid_rate_vs_medicare_v1","medicare_semantic.vw_medicaid_procurement_contract_runway","medicare_semantic.vw_medicaid_mco_ownership_bridge_v1","medicare_silver.org_control_disclosure","medicare_semantic.vw_az_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_ca_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_fl_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_ga_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_il_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_in_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_ky_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_la_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_mi_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_mn_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_mo_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_ms_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_nc_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_nj_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_ny_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_oh_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_ok_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_pa_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_tx_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_va_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_wa_medicaid_mco_rate_procurement_exposure_v1","medicare_semantic.vw_medicaid_mcpar_plan_pdf_2025_v1","medicare_semantic.vw_medicaid_mlr_plan_v1","medicare_silver.state_coverage_block_v1","medicare_silver.medicaid_mco_state_month_reconciliation_mat_v1","medicare_silver.pa_medicaid_chc_enrollment_mco_population_v1","vlada_curated.parent_book_az_v1","vlada_curated.parent_book_ca_v1","vlada_curated.parent_book_fl_v1","vlada_curated.parent_book_ga_v1","vlada_curated.parent_book_il_v1","vlada_curated.parent_book_mi_v1","vlada_curated.parent_book_nc_v1","vlada_curated.parent_book_nj_v1","vlada_curated.parent_book_ny_v1","vlada_curated.parent_book_oh_v1","vlada_curated.parent_book_pa_v1","vlada_curated.parent_book_tn_v1","vlada_curated.parent_book_tx_v1","vlada_curated.parent_book_va_v1","vlada_curated.parent_book_wa_v1","medicare_silver.fact_tx_medicaid_mco_parent_share_sfy_final_v1","medicare_silver.medicaid_plan_subcontract_v1","medicare_semantic.vw_medicaid_mcpar_pdf_source_2025_v1","medicare_silver.medicaid_mco_duals_bridge_v1","medicare_silver.medicaid_state_monthly_total_recent_v1","medicare_silver.medicaid_mco_enrollment_tracker_v2","medicare_silver.medicaid_mco_enrollment_assumptions_v1","medicare_silver.medicaid_mco_enrollment_assumption_v1","medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_state_month","medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_national_month","medicare_silver.medicaid_mco_sec_tieout_v2","medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_sec_tieout","medicare_silver.medicaid_m1_program_observation_v1","medicare_silver.medicaid_mco_plan_enrollment_hunt_v1","medicare_silver.medicaid_mco_plan_enrollment_hunt_cogank_v1","medicare_silver.medicaid_mcpar_plan_avg_enrollment_v1","medicare_silver.medicaid_limited_benefit_plan_enrollment_v1","medicare_semantic.vw_medicaid_limited_benefit_parent_state_month_v1","medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month","medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_dated_national_month","medicare_silver.tx_medicaid_mco_fsr_member_months_v1","medicare_silver.tx_medicaid_mco_enrollment_other_sources_v1","vlada_curated.vw_state_medicaid_jcode_vs_asp_v1","vlada_curated.vw_state_medicaid_jcode_basis_v1","vlada_curated.vw_state_medicaid_jcode_computed_v1","vlada_curated.vw_state_medicaid_homecare_v1"],"tools":["get_medicaid_rate"]}},"counts":{"sources":895,"tools":69},"sources":[{"source_id":"medicaid_org_subcontract","source_fqn":"medicare_silver.org_subcontract","title":"Medicaid managed-care subcontract and delegated-function observations","domain":"state","stage":"silver","status":"partial","grain":"One source-reported prime-to-subcontractor observation per subcontract_id; source_relationship_basis separates functional delegation reports from Georgia's thresholded business transactions.","description":"Source-name subcontract observations from California, Georgia, Illinois, and Minnesota, including 282 additional Minnesota December 2018 delegation-form name cells with raw function and program flags. Evidence URL/SHA, date basis, and reported function are preserved. Legal identities and member attribution remain unresolved.","identity_key":"subcontract_id","row_count":506,"last_updated":"2026-10-26","raw_queryable_via":"Athena read-only: medicare_silver.org_subcontract. Filter state_code, program_type, function, and source_relationship_basis; inspect date_basis and evidence_sha256.","notes":"California Health Net to Molina is delegated network/services from 2024-01-01; neither risk transfer nor additive member count is established. Illinois and Minnesota rows are historical roster observations.","superseded_by":null,"tools":[],"dataset_id":"medicaid_managed_care_org_disclosures","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["subcontract_id"],"backing_store":"glue"},{"source_id":"ny_medicaid_parent_native_product_component_202609_v1","source_fqn":"medicare_silver.ny_medicaid_parent_native_product_component_202609_v1","title":"New York Medicaid parent enrollment by native product, September 2026","domain":"state","stage":"silver","status":"partial","grain":"One raw program, native product bucket, and effective-dated ultimate parent in NY September 2026; 33 unique groups from 152 exact publisher observation keys.","description":"Published NY Medicaid managed-care parent components for MAP, MLTC Partial, and MLTC PACE at the publisher's September 2026 report month. Values are reported component sums, not unduplicated people; the three product buckets must remain separate.","identity_key":"state_code,report_month,raw_program,native_product_bucket,parent_id","row_count":33,"last_updated":"2026-10-26","raw_queryable_via":"Governed query_substrate and /v1/studio/medicaid-mco/parent-native-products; pin state_code=NY and report_month=2026-09.","notes":"Immutable content-addressed Parquet, Glue version 0, 33 groups and 152 unique source keys. The four ElderServe source rows use the accepted 2025-09-01 CareSource owning-org edges; no backcast.","superseded_by":null,"tools":[],"dataset_id":"vlada_w8_ny_medicaid_parent_native_product_202609","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["native_product_bucket","parent_id","raw_program","report_month"],"backing_store":"glue"},{"source_id":"cms_plan_attributes_puf","source_fqn":"medicare_semantic.vw_plan_attributes_puf_current","title":"CMS CCIIO Plan Attributes PUF — Marketplace plan definition history","domain":"commercial","stage":"semantic_view","status":"live","grain":"One logical publisher CSV record within one immutable (business_year, source_zip_sha256, archive_member) artifact, keyed by one-based source_row_number.","description":"CMS Marketplace plan-variant definitions and the central bridge among issuers, products, networks, service areas, benefits, and rates across PY2014-PY2026. All raw publisher revisions are retained; no semantic current-plan winner is selected.","identity_key":"source_id,business_year,source_zip_sha256,archive_member,source_row_number","row_count":null,"last_updated":"2026-07-15","raw_queryable_via":"Not queryable: proposed medicare_silver.fact_plan_attributes_puf_history has not been created or loaded.","notes":"The source bytes contain 300,992 certified logical rows across 13 annual ZIPs and seven exact ordered-header schema eras; row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_plan_attributes_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["archive_member","business_year","source_id","source_row_number","source_zip_sha256"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_benefits_cost_sharing_puf","source_fqn":"medicare_semantic.vw_benefits_cost_sharing_current","title":"CMS CCIIO Benefits & Cost Sharing PUF — Marketplace benefit-template history","domain":"commercial","stage":"semantic_view","status":"live","grain":"One publisher benefit row of the current selected revision, keyed by (business_year, plan_id, benefit_name, source_row_number). A plan may list the same benefit more than once (e.g. per tier or cost-sharing variant); every such row is preserved — no plan/benefit collapse. The underlying physical history remains one row per source, year, member SHA-256, archive member, and source-row ordinal across all revisions.","description":"CMS Marketplace plan-variant benefit, coverage, raw cost-sharing, limit, exclusion, EHB-variance, and MOOP-exclusion text across PY2014-PY2026. The served view selects the latest reviewed revision for each business year and maps each era's ordered raw-cell array to named raw-text columns without amount parsing or blank-to-zero coercion.","identity_key":"business_year,plan_id,benefit_name,source_row_number","row_count":19692051,"last_updated":"2026-07-17","raw_queryable_via":"query_substrate (read-only SQL) over medicare_semantic.vw_benefits_cost_sharing_current. Revision-history access to medicare_silver.fact_benefits_cost_sharing_puf_history requires a separate operator-approved entitlement.","notes":"The physical history table contains 45,082,577 rows across PY2014-PY2026 and all reviewed revisions; the served view surfaces the 19,692,051-row current selection. The served view maps 32-column PY2014-PY2015 display headers, the 30-column PY2016 compact header, and the 24-column PY2017-PY2026 header through ordered_header_json plus raw_values_json. The view DDL is deployed to medicare_semantic and count-verified (2026-07-17); this change entitles the served FQN.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_benefits_cost_sharing_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:plan_id"],"entity_key_columns":{"cms:plan_id":["plan_id"]},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["benefit_name"],"backing_store":"glue"},{"source_id":"cms_plan_id_crosswalk_puf","source_fqn":"medicare_semantic.vw_plan_id_crosswalk_puf_current","title":"CMS CCIIO Plan ID Crosswalk PUF — directed plan-year continuity history","domain":"commercial","stage":"semantic_view","status":"live","grain":"One logical publisher CSV record within one immutable directed current-plan-year artifact, keyed by source, current year, ZIP SHA-256, archive member, and one-based source row number.","description":"CMS Marketplace standard-component continuity from plan year N-1 to N across PY2014→2015 through PY2025→2026, preserving ordinary, age-off, and bronze-to-silver publisher fields without projecting semantic routes.","identity_key":"source_id,current_plan_year,source_zip_sha256,archive_member,source_row_number","row_count":null,"last_updated":"2026-07-16","raw_queryable_via":"Not queryable: proposed medicare_silver.fact_plan_id_crosswalk_puf_history has not been created or loaded.","notes":"The source bytes contain 1,649,072 certified logical rows across 12 directed annual ZIPs and 12 exact annual headers; row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_plan_id_crosswalk_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["archive_member","source_id","source_row_number","source_zip_sha256"],"unmapped_key_tokens":["current_plan_year"],"backing_store":"glue"},{"source_id":"cms_machine_readable_url_puf","source_fqn":"medicare_silver.fact_machine_readable_url_puf_history","title":"CMS CCIIO Machine Readable URL PUF — restricted issuer URL assertion history","domain":"commercial","stage":"silver","status":"live","grain":"One nonempty publisher worksheet row within one immutable ZIP/XLSX artifact, keyed by source, plan year, ZIP SHA-256, archive member, and one-based logical source row number.","description":"CMS-published issuer/state assertions of submitted machine-readable index URLs for PY2016-PY2026, including eight recovered prior artifact revisions. Technical point-of-contact fields remain restricted; submitted URLs are inert values and linked issuer JSON is a separate source lane.","identity_key":"source_id,plan_year,source_zip_sha256,archive_member,source_row_number","row_count":null,"last_updated":"2026-07-16","freshness_sla":"Annual plan-year publication at mutable URLs; every observation requires exact source boundary, final URL/response metadata when available, bytes, SHA-256, archive inventory, CRC32, worksheet/header/schema era, row count, and official-document recertification.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["plan_year and a submitted URL are publisher assertions, not reachability or semantic-currentness proof.","Eight Wayback revisions have no publisher Last-Modified or ETag; capture time must never be relabeled as publisher modification time.","NOT SUBMITTED is a distinct sentinel, not a blank or URL.","Changed ZIP SHA bytes coexist as immutable revisions; runtime recollection and linked endpoint crawling remain disabled until separate acceptance."]},"raw_queryable_via":"Not queryable: proposed medicare_silver.fact_hix_machine_readable_url_puf_history has not been created or loaded.","commercial_terms":"Public CMS/CCIIO data; technical point-of-contact values are restricted and excluded from default products, logs, graph, Data Map, MCP, samples, and evidence.","known_gaps":["Production writes are disabled until the shared artifact registry represents absent publisher response headers honestly and dedicated compute proves content-addressed Bronze, registry, Iceberg history, reviewed current-pointer behavior, exact-byte no-op, and changed-SHA coexistence.","The cloud job contract has no Machine Readable URL specification and cannot yet express 19 artifact revisions across 11 plan years.","Official issuer-key overlap against accepted Plan Attributes, Network, and Service Area physical histories has not been reproduced; geography may only compose through Plan Attributes.","URL reachability, linked issuer index/provider/formulary/plan JSON, semantic currentness, Data Map, and MCP are outside this certified source boundary and remain disabled.","HELD AT THE DOOR (2026-10-13): loaded PY2016-2026 (4,045 rows, one artifact per year, Athena c51d5511), but every year carries the issuer Tech POC e-mail (4,017 rows). The table stays versioned in vlada/query/versioned_tables.json, so the door's is_current rule returns nothing; the customer read surface is medicare_semantic.vw_machine_readable_url_puf_redacted_v1."],"notes":"The certified bytes contain 7,071 logical rows across 19 distinct CMS/Wayback artifacts—11 live annual releases and eight prior revisions—plus five official PDFs; row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_machine_readable_url_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["archive_member","plan_year","source_id","source_row_number","source_zip_sha256"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_transparency_qhp_coverage_puf","source_fqn":"cms_transparency_qhp_coverage_puf","title":"CMS CCIIO Transparency in QHP Coverage PUF — lossless multi-grain workbook history","domain":"commercial","stage":"silver","status":"planned","grain":"One publisher data row within one worksheet of one immutable ZIP/workbook artifact, keyed by source, publication year, ZIP SHA-256, archive member, worksheet, and one-based logical source row number.","description":"CMS federal-Marketplace issuer- and plan-level claims, appeals, enrollment, disenrollment, and financial-information fields across PY2017-PY2026. Sixteen accepted current/Wayback XLSX artifacts contain 68,879 revision-qualified rows; one earlier byte-certified BIFF8 XLS has 398 candidate rows whose row adapter remains gated.","identity_key":"source_id,publication_year,source_zip_sha256,archive_member,worksheet_name,source_row_number","row_count":null,"last_updated":"2026-07-16","raw_queryable_via":"Not queryable: proposed medicare_silver.fact_tc_puf_history has not been created or loaded.","notes":"Accepted XLSX source history contains 68,879 revision-qualified rows across 16 artifacts; the 17th artifact is a byte-certified legacy XLS with 398 gated candidate rows. row_count is null because no production table exists. The live cms_tc_puf_issuer_claims source remains a separate 25,666-row partial derivative.","superseded_by":null,"tools":[],"dataset_id":"ds_cms_transparency","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["archive_member","source_id","source_row_number","source_zip_sha256"],"unmapped_key_tokens":["publication_year","worksheet_name"],"backing_store":"logical_not_ingested"},{"source_id":"cms_marketplace_quality_puf","source_fqn":"cms_marketplace_quality_puf","title":"CMS Marketplace Quality PUF — federal-platform display rating history","domain":"commercial","stage":"silver","status":"planned","grain":"One nonblank publisher plan row within one immutable annual ZIP or direct-XLSX artifact, keyed by source, display publication year, container SHA-256, data object, and one-based logical source row number.","description":"CMS federal-Marketplace plan display star ratings across PY2017-PY2026, preserving six exact schema eras, reporting-unit repetition, raw year-specific not-rated lexemes, pilot/platform scope, and honest direct-XLSX lineage.","identity_key":"source_id,publication_year,source_container_sha256,data_object_name,source_row_number","row_count":null,"last_updated":"2026-07-16","raw_queryable_via":"Not queryable: proposed medicare_silver.fact_marketplace_quality_puf_history has not been created or loaded.","notes":"Ten exact official artifacts contain 35,752 source rows; nine exact-URL Wayback captures are byte-equal to live and create no additional revisions. row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"ds_cms_marketplace","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id","source_row_number"],"unmapped_key_tokens":["data_object_name","publication_year","source_container_sha256"],"backing_store":"logical_not_ingested"},{"source_id":"cms_nationwide_qrs_puf","source_fqn":"medicare_silver.fact_nationwide_qrs_puf_history","title":"CMS Nationwide QRS PUF — Exchange reporting-unit quality history","domain":"commercial","stage":"silver","status":"live","grain":"One publisher reporting-unit row within one immutable annual CSV data unit, keyed by publication plan year, CSV SHA-256, and one-based source row number; container revisions are retained separately.","description":"CMS Nationwide Quality Rating System results across PY2019-PY2026 at issuer-state-product-type reporting-unit grain, preserving seven exact schema eras, ratings-year semantics, raw field-qualified publisher codes, dictionary matrices, and container-versus-data-unit revision identity.","identity_key":"source_id,publication_plan_year,csv_sha256,source_row_number","row_count":1986,"last_updated":"2026-10-13","freshness_sla":"Annual publication at mutable URLs; recertify live and recoverable bytes, container and member lineage, CSV data-unit identity, exact schema era, row/key/token profiles, dictionaries, supporting documents, and measured joins before accepting a new artifact.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Nationwide QRS does not publish ReportingUnitID; the exact issuer-state-product-type tuple is derived and labeled as such.","Publication plan year, ratings year, and measure-specific measurement period are separate.","Dot, blank, BR, CSR-I, CSR-NS, NB, NC, NG, NR, numeric zero, and absence are distinct field-qualified states.","Changed containers coexist as immutable revisions; an identical CSV data unit creates no duplicate fact rows.","watermark_field corrected 2026-09-04 to 'business_year', the physical column of fact_nationwide_qrs_puf_history that carries the publication plan year (the previously declared 'publication_plan_year' is not a column, per the 2026-09-01 columns snapshot); it is a publication label, not the ratings year or the measurement period."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_nationwide_qrs_puf_history","commercial_terms":"Public CMS Marketplace quality data; reporting-unit, time, source-code, scope, and connection qualifiers are mandatory.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_nationwide_qrs_puf_recovery_manifest.json","known_gaps":["Production writes are disabled; no Bronze objects, artifact registry, Iceberg history, reviewed current pointer, Data Map node, graph edge, or MCP query exists.","A dedicated bounded compute job has not been reviewed or executed; the existing Benefits-specific wrapper is not a generic source loader.","Loaded candidate tables have not reproduced the 1,986 fact rows, 23 current dictionary tabs, semantic-token totals, or measured Enrollee Survey, Marketplace Quality, and qualified Plan Attributes connections.","Measurement periods remain measure-specific and unresolved; publication plan year and ratings year cannot be relabeled as measurement year.","The generic Plan edge is disabled because the measured connection requires Individual, non-dental, on-Exchange/Both qualifiers and has physical fanout up to 2,739.","Loaded and served PY2019-2026 since 2026-10-12 (#3559): 1,986 rows (195, 198, 198, 209, 264, 276, 315, 331), one artifact per business_year (Athena e5f3d871). The 'production writes are disabled' gaps above describe the July 2026 certification state and are superseded. is_current is FALSE on every row (history_only).","Current read surface since 2026-10-13: medicare_semantic.vw_nationwide_qrs_puf_current (card cms_nationwide_qrs_puf_current, #3583) keeps one CMS artifact per business_year, so a later repost never double-counts; it is history_only at the door like this table (is_current false on every row, no filter injected)."],"notes":"Eight current official ZIPs and one distinct recovered PY2023 container revision produce eight unique CSV data units and 1,986 rows. The recovered PY2023 CSV is byte-identical to live, so its container and dictionary lineage coexist while its fact rows are a physical no-op. row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_nationwide_qrs_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id","source_row_number"],"unmapped_key_tokens":["csv_sha256","publication_plan_year"],"backing_store":"glue"},{"source_id":"cms_enrollee_survey_puf","source_fqn":"medicare_silver.fact_enrollee_survey_puf_history","title":"CMS QHP Enrollee Survey PUF — nationwide reporting-unit survey history","domain":"commercial","stage":"silver","status":"live","grain":"One publisher wide row within one immutable year-qualified data unit, with mandatory row_kind separating issuer-state-product reporting units from the annual National row; container revisions are retained separately.","description":"CMS nationwide Exchange enrollee-experience results for PY2022-PY2026, preserving publication year, survey year, prior experience period, four exact ordered-header eras, incomplete/missing dictionary provenance, raw blank/dot/count/score semantics, and container-versus-data-unit revision identity.","identity_key":"source_id,publication_plan_year,data_sha256,source_row_number","row_count":1586,"last_updated":"2026-10-13","freshness_sla":"Annual publication at mutable URLs; recertify live and recoverable bytes, ZIP member byte/compression/CRC lineage, year-qualified data-unit identity, exact ordered schema era, reporting-unit/National grain, value domains, guides/dictionaries, supporting-document revisions, and measured joins before accepting a new artifact.","recollection":{"cadence":"annual","watermark_field":"publication_plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["publication_plan_year is the annual publisher watermark; it is not survey fielding year or experience period.","ReportingUnitID is not a plan ID; no survey score is projected to plans.","Publication plan year, survey fielding year, and prior experience period are separate.","Blank, dot, numeric zero, suppression, and absent fields are distinct states.","National rows require a separate served grain and cannot be reconstructed from reporting units.","Changed containers coexist as immutable revisions; an identical year-qualified data unit creates no duplicate fact rows."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_enrollee_survey_puf_history","commercial_terms":"Public CMS Marketplace survey data; row grain, time, suppression, dictionary provenance, nationwide scope, and candidate-connection qualifiers are mandatory.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_enrollee_survey_puf_recovery_manifest.json","known_gaps":["Production writes are disabled; no Bronze objects, artifact/data-unit registry, Iceberg history, reviewed current pointer, reporting-unit/National views, Data Map node, graph edge, or MCP query exists.","Independent adversarial review passed for the local no-write contract; a dedicated bounded compute job and physical two-pass proof have not yet been completed.","Loaded candidate tables have not reproduced the 1,586 fact rows, semantic domains, or measured QRS, Quality, and three Plan Attributes temporal hypotheses.","PY2026 has no CDX capture; exact current live bytes are the recoverable public-history source limit.","The generic Plan edge is disabled because reporting units lack market and respondent-to-plan attribution, while physical fanout reaches 2,739.","Loaded and served PY2022-2026 since 2026-10-13 (#3559): 1,586 rows (266, 298, 325, 343, 354), one artifact per business_year; PY2026 is the survey results (354 rows, cms_vintage_sequence 2), not CMS's data dictionary (Athena 777a63e8). The 'production writes are disabled' gaps above describe the July 2026 certification state and are superseded. is_current is FALSE on every row (history_only).","WRITER DEFECT (open): the PY2026 reload DELETED the 423 data-dictionary rows (Iceberg snapshot 4474039638102032131) instead of appending a second revision (supersession mode 'replace'). They are recoverable by time travel to snapshot 8579488627642706436 and from bronze. Fix: append-only history like the #3561 writers.","Current read surface since 2026-10-13: medicare_semantic.vw_enrollee_survey_puf_current_v1 (card cms_enrollee_survey_puf_current, #3583) keeps one CMS artifact per business_year, so a later repost never double-counts; it is history_only at the door like this table (is_current false on every row, no filter injected)."],"notes":"Five current official ZIPs plus one distinct pre-508 PY2022 container revision produce five unique data units and 1,586 rows. The two PY2022 CSVs are byte-identical, so both document/container lineages coexist while their fact rows are a physical no-op. row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_enrollee_survey_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id","source_row_number"],"unmapped_key_tokens":["data_sha256","publication_plan_year"],"backing_store":"glue"},{"source_id":"cms_service_area_puf","source_fqn":"medicare_semantic.vw_service_area_puf_current","title":"CMS CCIIO Service Area PUF — Marketplace plan geography history","domain":"commercial","stage":"semantic_view","status":"live","grain":"One logical publisher CSV record within one immutable (business_year, source_zip_sha256) artifact, keyed by archive member and one-based source_row_number.","description":"CMS Marketplace issuer service-area geography across PY2014-PY2026, including entire-state, county, and publisher-supplied partial-county ZIP rules. Historical templates are versioned; this planned source does not select a current revision.","identity_key":"business_year,source_zip_sha256,archive_member,source_row_number","row_count":null,"last_updated":"2026-07-15","raw_queryable_via":"Not queryable: proposed medicare_silver.fact_service_area_puf_history has not been created or loaded.","notes":"The source bytes contain 158,759 certified logical rows across 13 annual ZIPs and five representation eras; row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_service_area_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["archive_member","business_year","source_row_number","source_zip_sha256"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_network_puf","source_fqn":"medicare_semantic.vw_network_puf_current","title":"CMS CCIIO Network PUF — issuer network metadata history","domain":"commercial","stage":"semantic_view","status":"live","grain":"One logical publisher CSV record within one immutable (business_year, source_zip_sha256) artifact, keyed by one-based source_row_number.","description":"CMS Marketplace issuer network names, state-generated NetworkIds, and publisher-supplied provider-directory URL strings across PY2014-PY2026. This source does not contain provider membership, plan IDs, ServiceAreaIds, URL availability, or directory contents.","identity_key":"business_year,source_zip_sha256,source_row_number","row_count":null,"last_updated":"2026-07-15","raw_queryable_via":"Not queryable: proposed medicare_silver.fact_network_puf_history has not been created or loaded.","notes":"The source bytes contain 10,514 certified logical rows across 13 annual ZIPs and three schema eras; row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_network_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number","source_zip_sha256"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_business_rules_puf","source_fqn":"medicare_semantic.vw_business_rules_puf_current","title":"CMS CCIIO Business Rules PUF — Marketplace rating-rule history","domain":"commercial","stage":"semantic_view","status":"live","grain":"One logical publisher CSV record within one immutable (business_year, source_zip_sha256) artifact, keyed by one-based source_row_number.","description":"CMS Marketplace rules that modify how plan rates apply to enrollees and families, including dependent limits, relationship/cohabitation rules, tobacco-free periods, age determination, and medical/dental context. All official PY2014-PY2026 live artifacts are byte-certified; this is not a premium or provider-price source.","identity_key":"business_year,source_zip_sha256,source_row_number","row_count":null,"last_updated":"2026-07-15","raw_queryable_via":"Not queryable: proposed medicare_silver.fact_business_rules_puf_history has not been created or loaded.","notes":"The source bytes contain 77,304 certified logical rows across 13 annual ZIPs and four schema eras; row_count is null because no production table exists.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_business_rules_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number","source_zip_sha256"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"commercial_fact_rate","source_fqn":"vlada_curated.fact_rate","title":"Commercial negotiated rates (TiC)","domain":"commercial","stage":"curated","status":"partial","grain":"One row per (payer, plan, NPI, code, modifier, billing_class, POS, negotiated_type) at a snapshot.","description":"Cleaned commercial-insurer negotiated rates extracted from payer Transparency-in-Coverage machine-readable files. The substrate of \"what does this payer actually pay this provider for this code.\"","identity_key":"npi","row_count":null,"last_updated":"2026-06-15","freshness_sla":"Payers publish monthly (1st per CMS rule); extracted within ~7 days.","recollection":{"cadence":"monthly","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Per-payer vintage is tracked in dim_substrate_mrf_version (content_sha256), not a column on fact_rate; extraction lags the monthly publish by ~7 days."]},"raw_queryable_via":"Athena workgroup vlada-analytics: vlada_curated.fact_rate (always filter ghost_rate_score < 0.5)","commercial_terms":"Public TiC files; redistributable as cleaned substrate.","provenance_chain_ref":"dim_substrate_mrf_version[substrate=commercial] (schema/migrations/033_dim_commercial_mrf_version.sql)","context_doc_path":"docs/context_library/commercial/fact_rate.md","known_gaps":["Extracted but not served as of 2026-06-15: UHC, Florida Blue, BCBS RI, BCBS LA, BCBS MS, and BCBS NC; BCBS MA and BCBS AR are partial extracts.","~33 payer profiles discovered but not extracted/currently refreshed; largest remaining not-run mega-nationals are Elevance, Aetna/CVS, and HCSC.","~92% of raw rates are ghost rates; must filter ghost_rate_score >= 0.5.","Provider-groups are rate-scoped not network-scoped (~1000x repetition)."],"notes":"Current commercial truth packet v5 has 30/46 configured payer/network profiles indexed/live: amerihealth_caritas, amerihealth_nj, bcbs_id, bcbs_sc, carefirst, centene, cigna, emblemhealth, excellus, fallon, geisinger, health_new_england, health_partners, highmark, johns_hopkins_hc, kaiser, la_care, mclaren_health_plan, medical_mutual, molina, mvp, premera, priority_health, priority_health_via_cigna, quartz, sentara_health_plans, summacare, the_health_plan, tufts, and wellmark. Excellus/MVP/Quartz ledger backfill is closed; Highmark required G4.5 hot indexes. NEVER aggregate across modifier groups (rate-component splitter).","superseded_by":null,"tools":["get_negotiated_rate","lookup_rates_for_npi","lookup_rates_for_tin","plan_commercial_price_proof","prove_commercial_price","replay_commercial_price_proof"],"dataset_id":"cms_transparency_in_coverage","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"derived","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"commercial_mart_rate_by_code","source_fqn":"vlada_curated.mart_rate_by_code","title":"Code-keyed commercial rate serving mart","domain":"commercial","stage":"mart","status":"retired","grain":"One row per fact_rate row (payer, state, rate_id), projected and partition-pruned by (payer_id, state, code_prefix).","description":"Gold serving mart shaped for cross-payer market queries — \"what does code X cost across payers in state Y?\". Pure projection from fact_rate (no edge join), partitioned by (payer_id, state, code_prefix). Backs compute_median_rate (code x state x payer rollups) and explain_rate (single-rate lookup by rate_id).","identity_key":"code","row_count":null,"last_updated":"2026-06-15","freshness_sla":"Rebuilt when fact_rate refreshes for a payer.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Serving mart: rebuilt when fact_rate refreshes for a payer — cadence follows the upstream commercial source, not a fixed clock."]},"raw_queryable_via":"RETIRED: not queryable through query_substrate (outside the queryable set). compute_median_rate / explain_rate return a deprecation steer, not data. Use the superseded_by path.","commercial_terms":"Derived from public TiC; redistributable.","provenance_chain_ref":"dim_substrate_mrf_version[substrate=commercial]","context_doc_path":"docs/context_library/commercial/mart_rate_by_code.md","known_gaps":["RETIRED 2026-05-10 (two-payer-proof era, Fallon-only rows) and FROZEN: never rebuilt since. Any number computed from it is a Fallon-era artifact, not a market figure. Superseded by the canonical-graph resolution engine (see superseded_by).","Coverage tracks fact_rate — current commercial truth packet v5 has 30/46 configured payer/network profiles indexed/live: amerihealth_caritas, amerihealth_nj, bcbs_id, bcbs_sc, carefirst, centene, cigna, emblemhealth, excellus, fallon, geisinger, health_new_england, health_partners, highmark, johns_hopkins_hc, kaiser, la_care, mclaren_health_plan, medical_mutual, molina, mvp, premera, priority_health, priority_health_via_cigna, quartz, sentara_health_plans, summacare, the_health_plan, tufts, and wellmark.","Live mart omits provider_npis/provider_count/source_files (builders project fact_rate scalar columns only; NPI-level lineage lives in the resolution engine). explain_rate/compute_median_rate read those fields and get empty defaults — use the resolution engine for NPI-level work.","quality_flags.is_ghost_candidate is hardcoded False in the Spark builder; the ghost gate is applied at the resolution-engine query layer, not materialized here.","Row count undocumented at table grain (one row per fact_rate row); Fallon parity measured at ~140.4M rows for a single payer-version."],"notes":"Canonical builder is the Spark port (pipelines/spark/commercial/build_mart_rate_by_code.py via EMR Serverless); the DuckDB builder under pipelines/curated/gold is DEPRECATED 2026-04-24. NEVER aggregate across modifier groups — see fact_rate gotchas.","superseded_by":"The canonical-graph resolution engine over per-payer S3 primitives (curated_intermediate/payer=<p>/version=<v>/idx_rate_lookup/), served by get_negotiated_rate / lookup_rates_for_npi / prove_commercial_price; for raw SQL use vlada_curated.fact_rate (apply its ghost-rate + modifier caveats). See docs/architecture/2026-04-29-canonical-graph-resolution-engine.md.","tools":[],"dataset_id":"cms_transparency_in_coverage","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["code"],"backing_store":"glue"},{"source_id":"commercial_idx_rate_lookup","source_fqn":"vlada_curated.idx_rate_lookup","title":"Canonical-graph rate lookup index","domain":"commercial","stage":"index","status":"partial","grain":"Inverted index keyed by rate identity; traversed via idx_npi_provider_group (NPI entry) or idx_tin_provider_group (EIN entry, tin_type='ein' slice only) -> idx_pg_set_provider_group.","description":"Inverted index in the canonical-graph resolution engine. The resolution engine traverses it instead of materializing payer-wide rate x NPI edges. idx_tin_provider_group (2026-07-05 TIN identity engine Phase 1) adds the EIN entry point, one row per (source_file, pg_id, tin_value) with tin_scope_class fanout metadata and tin_index_path provenance ('membership' | 'bridge' -- bridge rows are npi-link-capped whole-system groups, system-shared evidence with lower-bound fanout).","identity_key":"rate_id","row_count":null,"last_updated":"2026-06-15","freshness_sla":"Rebuilt with the canonical graph per payer version.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Canonical-graph index: rebuilt per payer version with the graph — cadence follows the upstream commercial source."]},"raw_queryable_via":"Internal — reached via services/api/resolution_engine.py, not direct SQL.","commercial_terms":"Internal index over public TiC.","provenance_chain_ref":"docs/architecture/2026-04-29-canonical-graph-resolution-engine.md","context_doc_path":"docs/context_library/joins_and_gotchas.md","known_gaps":["idx_rate_lookup lacks modifiers — rate-component split lives on fact_rate."],"notes":"No array<npi>; no LATERAL VIEW explode (flat-schema canonical-primitives lock).","superseded_by":null,"tools":["get_negotiated_rate","lookup_rates_for_npi","lookup_rates_for_tin"],"dataset_id":"cms_transparency_in_coverage","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"index","purpose":"lookup","entity_keys":[],"entity_key_columns":{},"technical_keys":["rate_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"commercial_dim_payer","source_fqn":"vlada_curated.dim_payer","title":"Payer dimension + carrier hierarchy","domain":"commercial","stage":"dim","status":"live","grain":"One row per canonical payer_id.","description":"Canonical payer slugs, human names, and carrier ownership hierarchy (e.g. Cigna Healthspring under Cigna). Resolves free-text payer names.","identity_key":"payer_id","row_count":null,"last_updated":"2026-05-28","raw_queryable_via":"Athena: vlada_curated.dim_payer","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w1_payer_identity","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["payer_id"],"backing_store":"glue"},{"source_id":"commercial_tic_raw","source_fqn":"s3://vlada-platform-raw/commercial_v2","title":"Raw TiC machine-readable files (bronze)","domain":"commercial","stage":"raw","status":"partial","grain":"One object per (payer, version, reporting period) raw MRF file.","description":"Archived raw bytes of payer TiC in-network-rate files (Best Evidence Rule). Partitioned payer=<payer>/version=<version>/.","identity_key":"source_file_id","row_count":null,"last_updated":"2026-05-28","raw_queryable_via":"S3 prefix s3://vlada-platform-raw/commercial_v2/ (object store; not row-queryable).","notes":"364K files tracked across ~54 payers configured.","superseded_by":null,"tools":[],"dataset_id":"ds_commercial_tic","dataset_assignment_basis":"source_id_prefix","layer":"raw","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_file_id"],"backing_store":"s3"},{"source_id":"hospital_fact_chargemaster","source_fqn":"vlada_curated.fact_hospital_chargemaster","title":"Hospital chargemaster + payer-specific rates (HPT)","domain":"hospital","stage":"curated","status":"live","grain":"One row per (CCN, payer_name, plan, code, code_type, methodology, charge_type) at the file snapshot.","description":"Cleaned hospital prices extracted from CMS Hospital Price Transparency machine-readable files. Gross / cash / min / max / payer_specific + v3.0 allowed-amount percentile charge types.","identity_key":"hospital_ccn","row_count":4350000000,"last_updated":"2026-05-28","freshness_sla":"Hospitals republish at least annually (CMS); many quarterly.","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Cadence is a CMS floor (republish at least annually); many hospitals refresh quarterly, so 'annual' is a lower bound, not a guarantee. Per-file vintage is tracked via dim_mrf_version (mrf_version_id)."]},"raw_queryable_via":"query_substrate (read-only SQL, the as-filed layer): vlada_curated.vw_fact_hospital_chargemaster_current (or this fact with is_current); hospital_state is required. Typed recipe: compare_hospital_rates.","commercial_terms":"Public HPT files; redistributable as cleaned substrate.","provenance_chain_ref":"dim_mrf_version (schema/migrations/027_dim_mrf_version.sql); FA-6 unify into dim_substrate_mrf_version pending.","context_doc_path":"docs/context_library/hospital/fact_hospital_chargemaster.md","known_gaps":["Coverage measured 2026-09-25 against CMS's hospital list (Care Compare general information): acute care 2,781 / 3,107 (89.5%), critical access 1,198 / 1,382 (86.7%), children's 83 / 94, psychiatric 428 / 624, rural emergency 29 / 43; VA and DoD hospitals are exempt and do not publish. Served: 5,224 hospitals. An absent hospital is a coverage gap, not a zero.","payer_name is free text, not canonical — use payer_parent_name / line_of_business on vw_fact_hospital_chargemaster_canonical.","methodology determines what rate means (dollars, percent of charge, algorithm); never aggregate across methodologies.","The raw door refuses four shapes: no hospital_state predicate; a dollar aggregate of rate across methodology families, across programs (line_of_business), or over rows not restricted to comparability_class = 'REAL_NEGOTIATED' (only the comparable view carries it)."],"notes":"5,224 hospitals served 2026-09-25 (4.56B current rows); 2,389 on the fixed build (fact_builder_version hospital_fact_v4c). v3.0 enforced 2026-04-01.","superseded_by":null,"tools":["plan_hospital_price","prove_hospital_price","replay_hospital_price","state_expert"],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"derived","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"provider_facility_xref","source_fqn":"vlada_curated.provider_facility_xref","title":"CCN <-> NPI facility bridge","domain":"provider_identity","stage":"curated","status":"live","grain":"One row per (hospital_ccn, npi) candidate match with confidence + method.","description":"Confidence-scored bridge between hospital CCNs and provider NPIs. The join key for hospital x commercial unification. Floor for use is confidence >= 0.80.","identity_key":"hospital_ccn","row_count":null,"last_updated":"2026-05-28","freshness_sla":"Rebuilt with hospital + NPPES refreshes.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Bridge: rebuilt with hospital + NPPES refreshes — cadence follows its upstreams."]},"raw_queryable_via":"Athena: vlada_curated.provider_facility_xref (filter confidence >= 0.80)","commercial_terms":"Derived from public NPPES + HPT.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/joins_and_gotchas.md","known_gaps":["match_method fuzzy_name_zip is 0.7-1.0; slice fails if matched/expected < 0.50 for a CCN."],"notes":"match_method direct_facility_npi (1.0) or fuzzy_name_zip (RapidFuzz token_sort_ratio >= 70 + state + ZIP).","superseded_by":null,"tools":["resolve_provider"],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"derived","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_hpt_raw","source_fqn":"s3://vlada-platform-raw/hospital","title":"Raw HPT machine-readable files (bronze)","domain":"hospital","stage":"raw","status":"live","grain":"One object per (CCN, version) raw HPT file.","description":"Archived raw bytes of hospital standard-charges files, partitioned ccn=<ccn>/version=<version>/.","identity_key":"hospital_ccn","row_count":null,"last_updated":"2026-05-28","raw_queryable_via":"S3 prefix s3://vlada-platform-raw/hospital/ (object store; not row-queryable).","notes":"Parsed by pipelines/streaming_hospital_parser.py.","superseded_by":null,"tools":[],"dataset_id":"ds_hospital_hpt","dataset_assignment_basis":"source_id_prefix","layer":"raw","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"s3"},{"source_id":"medicare_pfs","source_fqn":"medicare_silver.fact_pfs_rvu","title":"Medicare Physician Fee Schedule (PFS)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (hcpcs_code, modifier, calendar_year) -- CMS PFS RVU components (work/PE/MP RVUs + conversion_factor). DEEP CY2003-2026. Filter conversion_factor BETWEEN 20 AND 50. RBP prices at the claim service year (as-of). The shallow medicare_physician_fee_schedule is the deprecated recent-years RDS mirror.","description":"The universal benchmark denominator for the commercial-to-Medicare ratio (\"is this rate fair?\"). National payment is DERIVED (fact_pfs_rvu stores components, not precomputed totals): office = total_non_facility_rvu*conversion_factor, facility = total_facility_rvu*conversion_factor. MATCH MODIFIER vs commercial (26 read / TC technical / global = NULL). No locality column; join medicare_gpci_locality / medicare_zip5_locality for a locality-adjusted rate.","identity_key":"hcpcs_code","row_count":642307,"last_updated":"2026-06-03","freshness_sla":"Annual (CMS publishes ~early November, effective Jan 1); mirror refreshed from RDS.","recollection":{"cadence":"annual","watermark_field":"calendar_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'calendar_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","CMS publishes the next year in early November, effective Jan 1; conversion factor changes yearly."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_pfs_rvu -- JOIN vlada_curated.fact_rate ON code=hcpcs_code, match modifier+calendar_year for the ratio.","commercial_terms":"Public CMS data.","provenance_chain_ref":"RDS->Iceberg mirror 2026-06-03 (ops/scripts/_fee_mirror_export.py + _fee_mirror_build.py); mirror_source + asserted_at on every row.","context_doc_path":"docs/context_library/medicare/pfs.md","known_gaps":["National payment only — no locality column; join GPCI/locality tables for a locality-adjusted rate.","Source-truth 2026-07-05 found 1,432 CY2022-CY2025 rows with implausible conversion_factor/payment values; the universal benchmark view quarantines them, but the underlying table is still unrepaired.","18,866 CY2026 rows lack the original CMS source_file_id; mirror lineage exists via mirror_source/asserted_at but source-file URL/SHA lineage is not queryable in Athena.","CY2003-CY2021 official CMS RVU files are URL/SHA/dry-run pinned in docs/reference/source-audit/source-mastery/manifests/large-wave/medicare_pfs_resolved_cms_files.json; historical replay remains gated on repair, source lineage, effective-period/currentness, and CY2005 duplicate policy.","Point-in-time mirror; do not historical-replay through the current RDS->Iceberg export+build until the source-mastery repair gate is accepted.","DMEPOS / Anesthesia / ESRD use separate schedules; lab = CLFS — a missing code is 'not PFS-priced', not $0."],"notes":"CERTIFIED through the Source Acceptance Gate (product1-cert-pfs-v1). Proven: 99213 cigna 0.93x, premera 1.54x Medicare. The old medicare_silver.dim_medicare_pfs name was never built; no get_medicare_rate tool exists — write the SQL.","superseded_by":null,"tools":["medicare_allowed"],"dataset_id":"cms_pfs_relative_value_files","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_opps","source_fqn":"medicare_silver.fact_opps_addendum_b","title":"Medicare OPPS (hospital outpatient)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (hcpcs_code, calendar_year, effective_period) -- CMS OPPS Addendum B APC payment_rate + status_indicator. DEEP CY2004-2026; within-year corrections via effective_period_start + cms_vintage_sequence (no quarter column). RBP prices as-of the service quarter. The shallow medicare_opps_rates is the deprecated recent-years mirror.","description":"Outpatient Prospective Payment System rates — the hospital OUTPATIENT FACILITY benchmark (payment_rate). NOT PFS (benchmarking a facility charge against PFS is the #1 methodology error). EXCLUDE status_indicator G/K (pass-through drugs/biologicals; payment_rate up to ~$3.7M/unit for gene/cell therapies — real drug prices, not facility fees) and packaged status-N $0 rows from a facility-fee distribution.","identity_key":"hcpcs_code","row_count":1290799,"last_updated":"2026-06-03","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_opps_addendum_b -- JOIN vlada_curated.fact_hospital_chargemaster ON billing_code=hcpcs_code (outpatient).","notes":"CERTIFIED through the Source Acceptance Gate (product1-cert-opps-v1). The old medicare_silver.dim_medicare_opps name was never built. Historical source manifest: docs/reference/source-audit/source-mastery/manifests/large-wave/medicare_opps_resolved_cms_files.json.","superseded_by":null,"tools":["medicare_allowed"],"dataset_id":"cms_opps_addendum_b","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ipps","source_fqn":"drug_silver.dim_msdrg","title":"Medicare IPPS inpatient acuity (MS-DRG relative weights)","domain":"medicare","stage":"dim","status":"live","grain":"One row per (ms_drg, effective_period_start/fiscal-year) — CMS IPPS Table 5 relative weight + LOS. CERTIFIED 2026-06-03.","description":"The Medicare INPATIENT acuity benchmark — MS-DRG relative weight (weight_after_cap = final applied weight) + geometric/arithmetic LOS. RELATIVE weight only; an ABSOLUTE IPPS dollar payment is NOT computable (the IPPS base operating rate + hospital wage index are NOT loaded). Match hospital inpatient charges on MS-DRG, present relative acuity — do NOT quote an absolute Medicare inpatient payment. Physically in drug_silver (M-2 envelope sharing) but it is the Medicare inpatient benchmark.","identity_key":"ms_drg","row_count":764,"last_updated":"2026-06-03","freshness_sla":"Annual (federal fiscal year, Oct 1 start).","recollection":{"cadence":"annual","watermark_field":"effective_period_start","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'effective_period_start' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Federal fiscal year (not calendar year)."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_msdrg — match fact_hospital_chargemaster.billing_code=ms_drg (inpatient, code_type MS-DRG).","commercial_terms":"Public CMS data.","provenance_chain_ref":"drug_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/opps_and_ipps.md","known_gaps":["RELATIVE weight only — absolute IPPS dollars blocked (base rate + wage index NOT loaded).","IPPS pays per ADMISSION (whole DRG), not per code/line; itemized inpatient charges sum to far more by design.","Federal fiscal year (Oct 1), not calendar year — align the hospital file year to the IPPS fiscal year."],"notes":"CERTIFIED through the Source Acceptance Gate (product1-cert-msdrg-v1; DRG 470 weight 1.9289). The old medicare_silver.dim_medicare_ipps name was never built.","superseded_by":null,"tools":[],"dataset_id":"cms_ipps_final_rule","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:msdrg"],"entity_key_columns":{"cms:msdrg":["ms_drg"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_asc","source_fqn":"medicare_silver.fact_asc_addendum","title":"Medicare ASC (Ambulatory Surgery Center) rates","domain":"medicare","stage":"silver","status":"live","grain":"One row per (hcpcs_code, calendar_year, effective_period) -- Medicare ASC Addendum payment_rate + payment_indicator. DEEP 2001-2026. The shallow medicare_asc_rates is the deprecated recent-years mirror.","description":"Medicare Ambulatory Surgery Center payment schedule (payment_rate) — the benchmark for ASC-setting surgery, a SEPARATE sibling system from OPPS. Don't substitute ASC for hospital-outpatient OPPS or vice-versa.","identity_key":"hcpcs_code","row_count":462343,"last_updated":"2026-06-03","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_asc_addendum","notes":"CERTIFIED (product1-cert-asc-v1). Historical source manifest: docs/reference/source-audit/source-mastery/manifests/large-wave/medicare_asc_resolved_cms_files.json.","superseded_by":null,"tools":["medicare_allowed"],"dataset_id":"cms_asc_addenda","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_clfs","source_fqn":"medicare_silver.medicare_clfs_rates","title":"Medicare CLFS (Clinical Laboratory Fee Schedule)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (hcpcs_code, modifier, indicator, calendar_year, quarter) — CLFS national_limit_amount. Source Truth repaired 2026-07-02.","description":"Medicare Clinical Laboratory Fee Schedule — the benchmark for LAB tests (national_limit_amount). Use CLFS, NOT PFS, for lab HCPCS codes; labs are priced on this separate schedule.","identity_key":"hcpcs_code","row_count":61076,"last_updated":"2026-07-02","raw_queryable_via":"Athena (read-only via query_substrate): modern national table medicare_silver.medicare_clfs_rates; accepted legacy locality leg medicare_silver.medicare_clfs_locality_rates.","notes":"CERTIFIED (product1-cert-clfs-v2); Source Truth repaired for modern row-oriented CLFS releases through 2026 Q3 including recovered 20CLABQ2. Accepted legacy locality leg loaded 2008-2017 into medicare_silver.medicare_clfs_locality_rates; 2005-2007 remain a residual source-recovery gate.","superseded_by":"medicare_silver.fact_clfs_national_rate (stamped re-collection 2026-09-07: every quarterly release 2019Q1-2026Q3 incl. modifier rows, with source_url, sha256_content_hash, asserted_at; the legacy table held one release, 2025 Q1, unmodified rows only, and stays queryable until dropped)","tools":[],"dataset_id":"ds_medicare_clfs","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_fact_clfs_national_rate","source_fqn":"medicare_silver.fact_clfs_national_rate","title":"CMS Clinical Laboratory Fee Schedule national limitation amounts, quarterly releases 2019-2026, stamped","domain":"medicare","stage":"silver","status":"live","grain":"One row per calendar_year x quarter x HCPCS x modifier as published; natural key (calendar_year, quarter, row_seq); 55,116 rows over 29 releases (2019Q1-2026Q3) on 2026-09-07.","description":"Every quarterly CLFS release since 2019 re-collected through the provenance envelope on 2026-09-07: indicator and national_limit_amount as published, modifier rows kept (the legacy medicare_clfs_rates held a single release, 2025 Q1, unmodified rows only). The 2019 files come from CMS's old Downloads path; 2023Q4 and later sit behind the AMA CPT click-through license, accepted openly with the license page kept in bronze. CPT descriptors are not stored. release = the publisher slug (e.g. 26clabq3); 20clabq2 is a publisher gap (the release page names a file CMS no longer serves).","identity_key":"hcpcs_code","row_count":55116,"last_updated":"2026-09-07","freshness_sla":"Annual with quarterly addenda; refresh after each CMS CLFS release.","recollection":{"cadence":"quarterly","watermark_field":"quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A year's quarters are reloaded together; a new quarterly release replaces its calendar_year partition."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_clfs_national_rate","provenance_chain_ref":"pipelines/medicare/ingest/clfs_national_rates_runner.py (job build_medicare_clfs_national_rates) from the CLFS files page release pages; bronze medicare/bronze/cms_clfs_national_rates/; RDS registry medicare_source_registry_cache","context_doc_path":"docs/context_library/medicare/clfs.md","known_gaps":["20clabq2 (2020 Q2) is not served by CMS (HTTP 404 at the file the release page names); recorded as a publisher gap.","national_limit_amount is null for indicator X / unpriced codes by publisher design.","No CPT descriptors (AMA license); join to a licensed descriptor source if a name is needed."],"notes":"CERTIFIED (product1-cert-clfs-v2); Source Truth repaired for modern row-oriented CLFS releases through 2026 Q3 including recovered 20CLABQ2. Accepted legacy locality leg loaded 2008-2017 into medicare_silver.medicare_clfs_locality_rates; 2005-2007 remain a residual source-recovery gate.","superseded_by":null,"tools":["medicare_allowed"],"dataset_id":"cms_clfs_national_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_ratebook","source_fqn":"medicare_silver.ma_county_ratebook","title":"MA county ratebook — CMS plan payment rates by county","domain":"medicare","stage":"silver","status":"live","grain":"One row per (rate_year, county) — CMS MA county benchmark rates by quality-bonus tier. CERTIFIED 2026-06-03.","description":"The county BENCHMARK — what CMS pays an MA plan per member in a county, by the county's quality-bonus tier: rate_5pct_bonus / rate_3_5pct_bonus / rate_0pct_bonus, plus rate_esrd. The revenue-rate INPUT for the Wolfe MA model (actual payment ~= benchmark x member risk score x rebate share).","identity_key":"ssa_county_code","row_count":42200,"last_updated":"2026-07-11","freshness_sla":"Annual (CMS Rate Announcement, ~April for the following year).","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_county_ratebook","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["Current/modern 2015-2027 ratebook era remains loaded and served unchanged: 42,200 rows, 13 hashes, and zero duplicate (rate_year, ssa_county_code) groups.","The 25 official 1990-2014 legacy ZIPs are byte-secured with zero misses, 1,825,217 total bytes, and SHA-256 pins under s3://vlada-platform-raw/medicare/bronze/ma_ratebook_archive/{year}/; the acquisition manifest is s3://vlada-platform-raw/medicare/bronze/ma_ratebook_archive/acquisition_manifest_2026-07-11.json.","Exact deferred gate: accept lossless era-specific schema and grain for 1990-2011 AAPCC/CHOICE/risk-rate and 2012-2014 six-Star data; decide separate legacy table versus reviewed mapping; resolve 2001/2004 split-period identity; prove legacy SSA county-code validity, duplicate natural keys at the accepted grain, per-member byte/SHA, dry-run, and idempotency before any load.","Hard consumer guard: legacy ratebook data must not flow into the three-tier MCP tool or the MA revenue model until the deferred semantics gate is accepted.","This is the source of record for the published county rates. The same bonus-tier and ESRD rates also sit in medicare_silver.ma_rate_calculation_cell (equal on 3,247 of 3,247 counties, rate year 2026, Athena d50bb1d8); never add, average or double-source the two.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_ma_county_ratebook reads medicare_semantic.vw_ma_county_ratebook_v3 (card medicare_ma_ratebook_v3): the same rates to the cent, plus the 2016 ESRD rates this table holds NULL, the 18 territory-wide rows, and one state_code in every year (this table's state_name is the code through 2020 and the name from 2021). This table is the rollback."],"notes":"CERTIFIED (product1-cert-ma-ratebook-v1). Current modern era remains served unchanged; legacy 1990-2014 bytes are secured in an exact deferred lane.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_county_ratebook","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["ssa_county_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_ratebook_v3","source_fqn":"medicare_semantic.vw_ma_county_ratebook_v3","title":"MA county ratebook, exact cents, one state key, territory rows kept","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (rate_year, ssa_county_code). 42,218 rows over rate years 2015-2027: the served table's 42,200 rows plus 18 territory-wide rows (Athena 3800cd23).","description":"The county benchmark CMS publishes with each Rate Announcement, per SSA county and rate year: the rate at the 5%, 3.5% and 0% quality-bonus tiers and the ESRD rate, in exact cents (decimal(10,2)), with state_code taken from the SSA prefix so one key finds every year. A view over medicare_silver.ma_county_ratebook_v2 (parser 0.2.0); get_ma_county_ratebook reads it from 2026-10-05 and filters on state_code.","identity_key":"ssa_county_code","row_count":42218,"last_updated":"2026-10-05","freshness_sla":"Annual (CMS Rate Announcement, ~April for the following year); a new year appears when the v2 table loads it.","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage/currency column.","A new rate year lands in the v2 table only after every earlier year is in it (the versioned reload guard)."]},"raw_queryable_via":"Tool: get_ma_county_ratebook; Athena: medicare_semantic.vw_ma_county_ratebook_v3 (pin rate_year; filter state_code)","provenance_chain_ref":"Glue VIRTUAL_VIEW from pipelines/medicare/semantic/ma_county_ratebook_v3.sql over medicare_silver.ma_county_ratebook_v2, written 2026-10-05 by tools/ingest_ma_county_ratebook.py --backfill-history from the 13 CMS ratebook ZIPs (each CSV hashes to the served sha256_content_hash). Cell reconciliation PASS, 13 of 13 editions, 295,526 cells, 0 mismatches (docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). Rollback: medicare_semantic.vw_ma_county_ratebook_v2 over the untouched served table.","known_gaps":["Every rate of the served table is unchanged at the cent (42,200 rows joined, 0 differences in any tier or ESRD; the served floats differ by under 0.0002; Athena 956ee25d).","2016 ESRD (RATEBOOK-1): filled for 3,247 counties and American Samoa (served NULL). Autauga AL 2016 ESRD 6,357.60.","TERRITORY ROWS (RATEBOOK-2): 18 rows flagged territory_wide_row, code 64XXX (American Samoa) every year and 63XXX (Northern Mariana Islands) 2020-2024; they are territory-wide rates, not a county.","STATE (RATEBOOK-4): filter on state_code. state_name_legacy keeps CMS's text, the USPS code through 2020 and the full name from 2021 (title-cased by the parser), so a filter on it finds one era. Texas: 254 counties in each of 2015-2027 on state_code (Athena f02ef54b).","Three benchmark columns are one benchmark under three quality-bonus tiers; pick the tier, never average them. Keyed by SSA county code, not FIPS."],"notes":"Wave-1A reload (Data Tracker, docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md, defects RATEBOOK-1..4). Versioned, never overwritten; the legacy card stays live as the rollback.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_county_ratebook","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["ssa_county_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_ma_rate_calculation_data","source_fqn":"medicare_silver.ma_rate_calculation_cell","title":"MA Rate Calculation Data: how CMS computed each county's MA rate, 1999-2027","domain":"medicare","stage":"silver","status":"live","grain":"One row per published cell: (rate_year, rate_period, source_member, row_number, column_index). Long form; pivot by measure_key.","description":"CMS's ratebook supporting data: for every rate year and county, how the MA rate was built. The risk-rate build (prior FFS and pre-ACA rates, minimum update, GME/IME/KAC, AGA, credibility, the current FFS rate, the quartile (applicable) percent, the qualifying-county double bonus, the caps and the 0%, 3.5% and 5% bonus-tier rates, which are the ratebook), the pre-2012 aged and disabled builds, the PACE and ESRD builds, the county statutory component of the regional benchmarks, and the five-year county FFS risk-score history. Joins medicare_silver.ma_county_ratebook on (rate_year, geo_code = ssa_county_code).","identity_key":"rate_year,rate_period,source_member,row_number,column_index","row_count":8268673,"last_updated":"2026-09-29","freshness_sla":"Annual, with the Rate Announcement (first Monday of April) for the next rate year.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_calculation_cell","provenance_chain_ref":"M-2 envelope on every row (source_url + member_sha256 + sha256_content_hash + bronze_publication_id + asserted_at + parser_artifact_hash).","known_gaps":["Always filter table_kind (risk_rates is the benchmark build; aged_rates / disabled_rates 1999-2011; esrd_rates; risk_rates_pace; statutory_benchmark; risk_score_history and its PACE / dialysis kinds). The same measure name appears in several kinds.","2001 and 2004 have Jan-Feb and Mar-Dec editions (rate_period jan-feb / mar-dec); filter rate_period or the year is doubled.","N/A cells have value_num NULL (2,058,025 of 8,268,673); value_text keeps the printed cell. Never read NULL as zero.","Header wording changes by era: Quartile Percent and Qualifying County exist only from 2012; the FFS-rate header changes in 2022. Read column_header for the year before pivoting.","XLS/XLSX duplicates of the CSVs and the 2012 FFS county .xlsm workbooks are in bronze, not parsed. No rate calculation data is published before 1999.","SOURCE OF RECORD for published county rates is medicare_silver.ma_county_ratebook: the 0%/5% bonus-tier and ESRD rates here equal it on 3,247 of 3,247 counties for rate year 2026 (Athena d50bb1d8). This table explains how the rate was built; never add, average or double-source the two.","measure_key IS NOT UNIQUE WITHIN A MEMBER (defect RATECALC-1, measured 2026-09-30): 118 (rate_year, member, measure_key) groups carry two columns each, 725,442 cells in 19 rate years (Athena b9a7a740-bfd6-4b49-afe9-140381244eb7): the 1999-2006 FFS vs Risk HMO demographic factors and the rate category before vs after budget neutrality, the 2012-2013 and 2015-2016 county vs regional star / bonus tiers, the 2021-2027 ESRD non-PACE (a) vs PACE (c) rates after the user fee, the 2022-2027 non-PACE vs PACE state AGA factors. Pivoting by measure_key here mixes the two. Read medicare_silver.ma_rate_calculation_cell_v2 (parse revision 2, unique keys) or pivot on (column_group, measure_key, column_index)."],"notes":"Data Tracker lane F, loaded 2026-09-29: 8,268,673 cells, 29 rate years 1999-2027 (31 editions), 0 duplicate natural keys, 0 lineage nulls (Athena fa08f5a0-c0af-4f08-a31a-d7426998e0ea); rerun left every year unchanged. The bonus-tier rates equal ma_county_ratebook to the cent for all 126,600 values 2015-2027. Register source cms_ma_rate_calculation_data (w3). Superseded for pivoting by medicare_silver.ma_rate_calculation_cell_v2 (2026-09-30, RATECALC-1); this table is unchanged.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_calculation_data","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["row_number"],"unmapped_key_tokens":["column_index","rate_period","rate_year","source_member"],"backing_store":"glue"},{"source_id":"cms_ma_rate_calculation_data_v2","source_fqn":"medicare_silver.ma_rate_calculation_cell_v2","title":"MA Rate Calculation Data, parse revision 2: one measure_key per column, 1999-2027","domain":"medicare","stage":"silver","status":"live","grain":"One row per published cell: (rate_year, rate_period, source_member, row_number, column_index), the same 8,268,673 cells as medicare_silver.ma_rate_calculation_cell; measure_key is unique within (rate_year, rate_period, source_member).","description":"CMS's ratebook supporting data (how every county's MA rate was built, 1999-2027), re-parsed from the same SHA-pinned publisher zips with measure_key unique within each member. Revision 1 keyed a column by its own header stack only, so a sub-label CMS prints under two spanning labels collapsed into one key. Revision 2 changes ONLY those 725,442 cells: it carries in the spanning label that covers the column ('Medicare Aged Benes In 1996 | Demographic Factor | Part A' vs 'Risk HMO Aged Benes 12/97 | ...'; '{Y} Dialysis Rate (a) | After $6 user fee deduction' vs '{Y} Dialysis Rate for PACE Plan (c) | ...'; 'County Rate ... | 3 Stars' vs 'Region Rate ... | 3 Stars'; 'For Non PACE plan | {Y} AGA factor ...' vs 'For PACE plan | ...') or, where no spanning label separates them, names the rate the column follows ('Rate | Category (for: {Y} Rate | Before Budget | Neutr. Adj.)'). Every other key, value and column is identical to revision 1; measure_key_v1 carries the revision-1 key.","identity_key":"rate_year,rate_period,source_member,row_number,column_index","row_count":8268673,"last_updated":"2026-09-30","freshness_sla":"Annual, with the Rate Announcement (first Monday of April) for the next rate year; load new editions with tools/ingest_ma_rate_calculation.py --parse-revision 2.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_calculation_cell_v2","provenance_chain_ref":"M-2 envelope on every row (source_url + member_sha256 + sha256_content_hash + bronze_publication_id + asserted_at + parser_artifact_hash of ma_rate_calculation_parser@2.0.0) plus parse_revision (2) and measure_key_v1. Loaded 2026-09-30 from the 31 SHA-pinned zips in tools/medicare/data/ratebook_supporting_data_manifest.json by tools/ingest_ma_rate_calculation.py --all --parse-revision 2. Verified 2026-09-30: 8,268,673 cells, 29 rate years, 0 duplicate natural keys, 0 lineage nulls (Athena cbe0145b-fb0b-4db5-887e-d177dfec6b6b); 0 (year, member, key) groups with two columns (8d726f26-175e-4fc7-886b-ee986153d419); exactly 725,442 keys differ from v1 (11636739-cfe3-4052-a01b-83c3b5d4e0a7); every value and v1 key equals ma_rate_calculation_cell (87e807d1-9a93-4ada-8195-36d700aa0262).","known_gaps":["Pivot by measure_key within (rate_year, rate_period, table_kind): 0 groups carry two columns. Keys that were unique in revision 1 are byte-identical, so cross-year alignment is unchanged; only the 725,442 formerly colliding cells have new keys (measure_key <> measure_key_v1).","Always filter table_kind and rate_period (2001 and 2004 have Jan-Feb and Mar-Dec editions); N/A cells have value_num NULL, never zero.","SOURCE OF RECORD for published county rates is medicare_silver.ma_county_ratebook; this table explains how the rate was built. Never add or double-source the two, and never UNION this table with ma_rate_calculation_cell (the same cells twice)."],"notes":"New parse revision (Data Tracker served-defect lane, 2026-09-30, defect RATECALC-1) written to a NEW table; medicare_silver.ma_rate_calculation_cell stays queryable and unchanged. Record docs/reference/source-audit/source-mastery/records/cms_ma_rate_calculation_data.json field_dictionary.defects RATECALC-1.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_calculation_data","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["row_number"],"unmapped_key_tokens":["column_index","rate_period","rate_year","source_member"],"backing_store":"glue"},{"source_id":"cms_ma_uspcc","source_fqn":"medicare_silver.ma_uspcc","title":"USPCC (United States Per Capita Costs), rate years 2003-2027","domain":"medicare","stage":"silver","status":"live","grain":"One row per published value: (rate_year, rate_period, block, part, row_kind, calendar_year, calendar_period, column_index). Every rate_year restates the series.","description":"CMS's national Medicare cost per beneficiary per month by calendar year, Part A and Part B: the growth base behind every MA benchmark and, from 2020, the FFS USPCC that scales county FFS rates. Through 2012 the columns are retrospective (actual) against prospective (projected); from 2013 current against last year's estimate. Populations change by era: aged, disabled and ESRD (2003-2011); aged+disabled and dialysis-only (2012-2018); total (2019); non-ESRD total, non-ESRD FFS and dialysis-only (2020-2027); a growth-rate row from 2020.","identity_key":"rate_year,rate_period,block,part,row_kind,calendar_year,calendar_period,column_index","row_count":6033,"last_updated":"2026-09-29","freshness_sla":"Annual, with the Rate Announcement (first Monday of April) for the next rate year.","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the edition the Rate Announcement carries.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_uspcc","provenance_chain_ref":"M-2 envelope on every row (source_url + member_sha256 + sha256_content_hash + bronze_publication_id + asserted_at + parser_artifact_hash).","known_gaps":["Every edition restates history: filter rate_year (the edition) AND calendar_year (the year the cost is for).","The FFS USPCC (population non_esrd_ffs) exists only from 2020; earlier files publish total or aged+disabled. Never splice them into one FFS series.","The 2026 file prints its last Part B row as 2027 twice; calendar_year is corrected to 2028 and calendar_year_correction records it. Read calendar_year, not row_label.","The 2004 edition is the Mar-Dec page's file (rate_period mar-dec). The 1990-2002 year pages carry no USPCC file.","ONE SERIES, THREE POPULATION CODES (defect USPCC-1, measured 2026-09-30): the non-ESRD USPCC is population aged_disabled in 2007-2018 ('Aged + Disabled'), total in 2019-2020 ('Total USPCC', which does NOT include ESRD) and non_esrd_total in 2021-2027. Each file's last-year estimate equals the previous file's current figure across both relabels, 560 of 560 pairs (Athena 67d65244-dda3-45ae-917b-be63a67d250a). A trend filtered on one code loses the other years. Read medicare_semantic.vw_ma_uspcc_v2 and filter series = 'non_esrd_total' (21 rate years 2007-2027)."],"notes":"Data Tracker lane F, loaded 2026-09-29: 6,033 values, 25 rate years 2003-2027, 0 duplicate natural keys, 0 lineage nulls (Athena df99a912-a73d-4365-972c-c943a3ff3a21); rerun left every year unchanged. FFS USPCC A+B equals the risk-rate file's printed FFS USPCC 2020-2027 (8/8); dialysis-only equals the ESRD file 2013-2027 (15/15). Register source cms_ma_uspcc (w3).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_uspcc","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["block","calendar_period","calendar_year","column_index","part","rate_period","rate_year","row_kind"],"backing_store":"glue"},{"source_id":"cms_ma_uspcc_v2","source_fqn":"medicare_semantic.vw_ma_uspcc_v2","title":"USPCC (United States Per Capita Costs), one series key per CMS series, rate years 2003-2027","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per published value, the rows of medicare_silver.ma_uspcc (6,033; view minus table = 0, Athena b604a051-7993-489d-9688-272c1827670c).","description":"Every column of medicare_silver.ma_uspcc plus series: the non-ESRD USPCC that CMS labels 'Aged + Disabled' (2007-2018), 'Total USPCC' (2019-2020) and 'Non-ESRD total USPCC' (2021-2027) is series 'non_esrd_total' in every year; every other population keeps its code (aged, disabled, esrd, esrd_dialysis_only, non_esrd_ffs). population keeps the code as published.","identity_key":"rate_year,rate_period,block,part,row_kind,calendar_year,calendar_period,column_index","row_count":6033,"last_updated":"2026-09-30","freshness_sla":"Annual, with the Rate Announcement; a view over medicare_silver.ma_uspcc.","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the edition the Rate Announcement carries."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ma_uspcc_v2","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-09-30 (Athena c75ebf13-216f-48ba-b4eb-f1d485032896) from pipelines/medicare/semantic/ma_uspcc_v2.sql over medicare_silver.ma_uspcc; every row keeps the M-2 envelope. Rollback: DROP VIEW.","known_gaps":["series = 'non_esrd_total' spans 21 rate years 2007-2027 (population codes aged_disabled / total / non_esrd_total). Proof: each file's last-year estimate equals the previous file's current value, 560 of 560 pairs 2015-2027, both relabels included (Athena 67d65244-dda3-45ae-917b-be63a67d250a).","The FFS USPCC (non_esrd_ffs) exists only from 2020; never splice it with non_esrd_total. ESRD is separate: esrd 2003-2012, esrd_dialysis_only 2012-2027.","Every edition restates history: filter rate_year (the edition) AND calendar_year."],"notes":"Series-key view (Data Tracker served-defect lane, 2026-09-30, defect USPCC-1). Versioned, never overwritten. Record docs/reference/source-audit/source-mastery/records/cms_ma_uspcc.json field_dictionary.defects USPCC-1.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_uspcc","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["block","calendar_period","calendar_year","column_index","part","rate_period","rate_year","row_kind"],"backing_store":"glue"},{"source_id":"cms_regional_rates_part_d_benchmarks","source_fqn":"medicare_silver.ma_part_d_benchmark_figure","title":"MA regional benchmarks and Part D national and LIS benchmarks, CY2006-2027","domain":"medicare","stage":"silver","status":"live","grain":"One row per published figure: (rate_year, table_kind, region_code, measure), with the verbatim source_line it was read from.","description":"Per contract year: the MA regional benchmark components for the 26 MA regions (statutory and plan-bid), the Part D regional low-income premium subsidy amounts for the 34 PDP regions (the regional LIS benchmark), and the national Part D figures from the late-July announcement: NAMBA, base beneficiary premium, de minimis (from 2015) and the statutory / plan-bid weights. 2027: NAMBA $296.05, base beneficiary premium $41.33.","identity_key":"rate_year,table_kind,region_code,measure","row_count":3111,"last_updated":"2026-09-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_part_d_benchmark_figure","notes":"Data Tracker lane F, loaded 2026-09-29: 3,111 figures, CY2006-2027, 0 duplicate keys, 0 lineage nulls (Athena 00a4829c-4d46-446d-b1e5-29dd3ab5ed84); rerun unchanged. Every PDF figure re-found by a second engine (0 failures). The landscape lips_amount equals the LIS subsidy amount in all 34 regions 2025-2027. Register source cms_regional_rates_part_d_benchmarks (w3).","superseded_by":null,"tools":[],"dataset_id":"cms_regional_rates_part_d_benchmarks","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["measure","rate_year","region_code","table_kind"],"backing_store":"glue"},{"source_id":"medicare_ma_stars","source_fqn":"medicare_silver.stars_ratings_summary","title":"Medicare Advantage Star Ratings (summary)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, part, payment_year) on is_current — CMS Star ratings summary. CERTIFIED 2026-06-03.","description":"The contract's CMS Star rating (summary_star, 1.0-5.0). 4+ stars => a 5% benchmark bonus AND a higher rebate share — the single biggest swing in MA plan economics. Powers the Stars-trajectory analyses (Wolfe sell-side).","identity_key":"contract_id","row_count":29282,"last_updated":"2026-06-03","freshness_sla":"Annual (CMS publishes in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"payment_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'payment_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Published in October for the following plan year; measure set + weights change year over year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.stars_ratings_summary (filter is_current = true)","known_gaps":["summary_star NULL = not rated (new / too-low-enrollment contract) — exclude from rating analytics; null != 0 stars.","Filter is_current=true; `part` is C / D / overall — pick the right one.","Measure set + weights are reweighted by CMS year over year."],"notes":"CERTIFIED (product1-cert-ma-stars-v1). 14 payment years; summary_star range 1.5-5.0.","superseded_by":null,"tools":["get_county_view","get_quality_bonus","get_star_benchmark","get_star_decomposition","get_star_risk","get_stars","get_stars_rollup"],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_stars_measure","source_fqn":"medicare_silver.stars_ratings_measure","title":"MA Star Ratings — per-measure value + star","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, measure_id, rating_year) — the per-measure raw value plus earned 1-5 star.","description":"The measure-level layer beneath the summary star: each contract's value and star on each measure. Drives Stars-trajectory and measure-gap analysis (Wolfe sell-side).","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"Annual (CMS publishes Star Ratings in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"rating_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_year' is the source's documented vintage column (the published Star Ratings year).","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.stars_ratings_measure (filter is_current = true)","known_gaps":["measure_id is a DISPLAY ALIAS — join across years via medicare_silver.dim_stars_measure_crosswalk / CMIT #, never the raw code.","Filter is_current=true; scope by rating_year.","Uncertified (the acceptance-gate cert covers stars_ratings_summary only); grain-governed."],"notes":"Grain-governed (medicare_ma_stars). Powers the bit-exact RY2015-2027 recompute.","superseded_by":null,"tools":["get_star_benchmark","get_star_decomposition","get_star_risk","get_stars","get_stars_rollup"],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_stars_cutpoints","source_fqn":"medicare_silver.stars_cutpoints","title":"MA Star Ratings — measure cut points","domain":"medicare","stage":"silver","status":"live","grain":"One row per (measure_id, star_level, org_subtype, rating_year) — the CMS threshold converting a raw measure value into a star.","description":"The annual CMS cut points (thresholds) per measure, star-level and org-subtype. The inputs that turn a raw measure value into a star; consumed by the recompute.","identity_key":"measure_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"Annual (CMS publishes Star Ratings in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"rating_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_year' is the source's documented vintage column (the published Star Ratings year).","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.stars_cutpoints (filter is_current = true)","known_gaps":["Org-subtype-specific (cut points differ by contract type).","Tukey outlier deletion applies from RY2024.","Uncertified; grain-governed."],"notes":"Grain-governed (medicare_ma_stars).","superseded_by":null,"tools":["get_stars_cutpoints"],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["measure_id"],"backing_store":"glue"},{"source_id":"medicare_ma_stars_cai","source_fqn":"medicare_silver.stars_cai","title":"MA Star Ratings — Categorical Adjustment Index","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, part, fac_category, rating_year) — CAI input (final adjustment category plus LIS/DE/disabled mix).","description":"The Categorical Adjustment Index that adjusts summary stars for low-income/disabled enrollment mix. Carries a Puerto-Rico-Only flag.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"Annual (CMS publishes Star Ratings in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"rating_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_year' is the source's documented vintage column (the published Star Ratings year).","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.stars_cai (filter is_current = true)","known_gaps":["PR-Only contracts handled via a flag (see CR-C audit).","CAI active from RY2017; absent earlier.","Uncertified; grain-governed."],"notes":"Grain-governed (medicare_ma_stars).","superseded_by":null,"tools":["get_star_decomposition","get_star_risk"],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_stars_contracts","source_fqn":"medicare_silver.stars_contracts","title":"MA Star Ratings — contract metadata","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, rating_year) — org type, parent org, marketing name, SNP flag.","description":"Contract-level Stars metadata (org type, parent org, marketing name). The join spine from a Star rating to the carrier/parent for sell-side rollups.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"Annual (CMS publishes Star Ratings in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"rating_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_year' is the source's documented vintage column (the published Star Ratings year).","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.stars_contracts (filter is_current = true)","known_gaps":["PR contracts are first-class H-prefix rows.","For carrier rollups prefer CPSC parent_org where a cross-source identity is needed.","Uncertified; grain-governed."],"notes":"Grain-governed (medicare_ma_stars).","superseded_by":null,"tools":["get_stars_rollup"],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_stars_display_measures","source_fqn":"medicare_silver.stars_display_measures","title":"Part C and D Star Ratings Display Measures, per contract and measure, RY2012-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per rating_year x contract_id x display_file_family x measure_id (the publisher's measure id).","description":"Contract-level measures CMS publishes beside the Star Ratings but does not score: call center hold times and disconnects, grievance rate, disenrollment reasons, access problems, transitions of care, opioid safety, retired Star measures, and HEDIS for contracts below the Stars sample size, per rating year. Display measures are NOT part of the Star Rating calculation: CMS shows them, it does not score them, and they carry no star. 549,605 rows in 15 rating years, RY2012-RY2026 (Athena 45ff8e54); display_file_family hpms_display_measures (DMC/DMD/DME ids) or hedis_small_contract_display (Stars HEDIS ids C01...). value_text is the publisher's cell, whitespace-normalized; value_numeric is set only for percent, mm:ss hold times (stored as seconds) and plain numbers; every other cell is a publisher status in value_status.","identity_key":"rating_year,contract_id,display_file_family,measure_id","row_count":549605,"last_updated":"2026-10-07","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.stars_display_measures, filter is_current = true and pin rating_year; read measure_name with measure_id","notes":"Register source cms_stars_display_measures (w3, serve raw). RAW. Loaded 2026-10-07 (#3254, Data Tracker); registered 2026-10-07.","superseded_by":null,"tools":[],"dataset_id":"cms_stars_display_measures","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["display_file_family","measure_id","rating_year"],"backing_store":"glue"},{"source_id":"medicare_ma_stars_measure_dim","source_fqn":"medicare_silver.dim_stars_measures","title":"MA Star Ratings — measure dimension","domain":"medicare","stage":"silver","status":"live","grain":"One row per (measure_id, rating_year) — measure inventory plus CMIT #, canonical_name, weight, direction, data source, domain.","description":"The per-year measure dictionary. Stable identity is the CMIT #; the C0x/D0x measure_id is a per-year display alias.","identity_key":"measure_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"Annual (CMS publishes Star Ratings in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"rating_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_year' is the source's documented vintage column (the published Star Ratings year).","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_stars_measures (filter is_current = true)","known_gaps":["Stable identity = cmit_number; measure_id is a per-year display alias.","RY2015-2023 carry NO cmit_number (name is the only stable key those years).","Weights change year over year (e.g. patient-experience 4 to 2 in RY2026)."],"notes":"Grain-governed (medicare_ma_stars); seed methodology_seed.yaml.","superseded_by":null,"tools":["get_star_decomposition","get_stars","get_stars_cutpoints","get_stars_rollup"],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["measure_id"],"backing_store":"glue"},{"source_id":"medicare_ma_stars_methodology","source_fqn":"medicare_silver.dim_stars_methodology","title":"MA Star Ratings — methodology dimension","domain":"medicare","stage":"silver","status":"live","grain":"One row per rating_year — era flags (CAI active, Tukey active, hold-harmless-expanded), reward-factor formula, performance_year and payment_year, tech-notes sha.","description":"The year-by-year methodology record that drives the recompute and the AEP/payment-year mapping for the rating tables.","identity_key":"rating_year","row_count":null,"last_updated":"2026-06-06","freshness_sla":"Annual (CMS publishes Star Ratings in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"rating_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_year' is the source's documented vintage column (the published Star Ratings year).","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_stars_methodology (filter is_current = true)","known_gaps":["RY2021 reflects COVID hold-harmless (frozen 2020 HEDIS/CAHPS).","The AEP/payment-year offset for the rating tables lives here (performance_year/payment_year).","Uncertified; grain-governed."],"notes":"Grain-governed (medicare_ma_stars).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rating_year"],"backing_store":"glue"},{"source_id":"medicare_ma_stars_measure_crosswalk","source_fqn":"medicare_silver.dim_stars_measure_crosswalk","title":"MA Star Ratings — cross-year measure crosswalk","domain":"medicare","stage":"silver","status":"partial","grain":"One row per cross-year measure-identity edge (from to); crosswalk_type identity/renamed/etc; confidence certain/derived_name.","description":"The map that lets a measure be trended across CMS renumbering (e.g. C27 to C30). 84 certain (CMS Attachment J, RY2024-2026) plus 385 offline-derived (RY2015-2024).","identity_key":"from_measure_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"Annual (CMS publishes Star Ratings in October for the following plan year).","recollection":{"cadence":"annual","watermark_field":"rating_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_year' is the source's documented vintage column (the published Star Ratings year).","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_stars_measure_crosswalk (filter is_current = true)","known_gaps":["status=partial: the 385 derived_name edges (RY2015-2024) are UNVERIFIED offline canonical-name joins, NOT CMS-certain — filter by confidence.","55 measures remain unlinked (new/retired/re-introduced) pending CMS Attachment J — see the worklist artifact.","Uncertified; grain-governed."],"notes":"Grain-governed; backfilled by product1_stars_crosswalk_backfill_v1; see the crosswalk end-to-end plan.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_star_ratings","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["from_measure_id"],"backing_store":"glue"},{"source_id":"medicare_hedis_general","source_fqn":"medicare_silver.hedis_general","title":"MA hedis general (legacy column names; read vw_hedis_general_v2)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (contract, year). Contract metadata: organization type, plan type, Part D offering, enrollment count, region. Coded columns (General-0010 through General-0087) carry CMS Stars-Ratings semantics documented in `MADictionary{YEAR}.","description":"One row per (contract, year). Contract metadata: organization type, plan type, Part D offering, enrollment count, region. Coded columns (General-0010 through General-0087) carry CMS Stars-Ratings semantics documented in `MADictionary{YEAR}.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_general","known_gaps":["Coverage: 2019 → present (2020 MISSING — CMS COVID skip).","2020 entirely missing upstream (CMS COVID skip); column drift 2019-2021 -> 2022+.","Uncertified; grain-governed."],"notes":"RETIRED 2026-09-29 (HEDIS-fix lane): columns mislabeled at the 2026-05-15 build; superseded by medicare_semantic.vw_hedis_general_v2. Source family ma_hedis_annual; record docs/reference/source-audit/source-mastery/records/ma_hedis.json correction_2026_09_29.","superseded_by":"medicare_semantic.vw_hedis_general_v2 (2026-09-29): the same rows under the names CMS documents. This table mislabels five columns: offers_part_d holds General-0014 Offers SNP, offers_supplemental holds General-0016 Offers Part D, coverage_type holds General-0080 Patient Population, eghp_flag holds General-0085 Submitted HEDIS to NCQA, snp_flag holds General-0087 Included in HOS. It stays queryable and remains the physical storage the loader appends to; never read its column names as meaning.","tools":[],"dataset_id":"ds_medicare_hedis","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_general_v2","source_fqn":"medicare_semantic.vw_hedis_general_v2","title":"MA HEDIS contract file (general sheet), documented names","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (report_year, contract_id); 0 duplicate keys in every year (451 / 530 / 592 / 648 / 667 / 661 rows in 2019 / 2021-2025 = publisher rows).","description":"The MA HEDIS PUF general sheet per contract and report year, under the names CMS documents for each code: organization_type (General-0010), plan_type (-0011), offers_snp (-0014, Yes/No/N/A), offers_part_d (-0016 in the workbook, documented as -0015), enrollment (-0050, December of report_year - 1, MARx), region / region_name (-0060 / -0070), patient_population (-0080), submitted_hedis_to_ncqa (-0085), included_in_hos (-0087).","identity_key":"contract_id","row_count":3549,"last_updated":"2026-09-29","freshness_sla":"CMS publication cadence; a view over medicare_silver.hedis_general, so a new report year appears when the loader appends it.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hedis_general_v2","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-09-29 (Athena 389c9bde-110b-4351-bb30-1652fe1b51c2) from pipelines/medicare/semantic/hedis_general_v2.sql over medicare_silver.hedis_general; every row keeps source_url, sha256_content_hash, asserted_at.","known_gaps":["Coverage: 2019, 2021-2025 (2020 was never published, CMS COVID skip).","report_year is the PUF file year; the HEDIS measurement year is report_year - 1.","Verified 2026-09-29: offers_snp = Yes for 361 of 361 contracts in the CMS SNP comprehensive report 2024 and for none of the 300 No / N/A contracts (Athena fdd529a3); offers_part_d = No only on MSA and 1876 Cost contracts (plus H1302 in 2019)."],"notes":"Documented-name view (HEDIS-fix lane 2026-09-29); supersedes the column names of medicare_silver.hedis_general. Versioned, never overwritten.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_hedis_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_hos_frm","source_fqn":"medicare_silver.hedis_hos_frm","title":"MA hedis hos frm","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract, year). Health Outcomes Survey: Falls Risk Management. Two rates: (rate1) Talking with Doctor about Falling or Balance Problems, (rate2) Receiving Fall Risk Reduction Recommendation. ~600 rows per year.","description":"One row per (contract, year). Health Outcomes Survey: Falls Risk Management. Two rates: (rate1) Talking with Doctor about Falling or Balance Problems, (rate2) Receiving Fall Risk Reduction Recommendation. ~600 rows per year.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_hos_frm","notes":"Grain-governed; live in Glue / query_substrate. Source family ma_hedis_annual.","superseded_by":null,"tools":["get_hos"],"dataset_id":"cms_ma_hos","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_hos_mui","source_fqn":"medicare_silver.hedis_hos_mui","title":"MA hedis hos mui","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract, year). HOS Management of Urinary Incontinence. Three rates (rate1, rate2, rate3). Published 2021+ only.","description":"One row per (contract, year). HOS Management of Urinary Incontinence. Three rates (rate1, rate2, rate3). Published 2021+ only.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_hos_mui","notes":"Grain-governed; live in Glue / query_substrate. Source family ma_hedis_annual.","superseded_by":null,"tools":["get_hos"],"dataset_id":"cms_ma_hos","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_hos_oto","source_fqn":"medicare_silver.hedis_hos_oto","title":"MA hedis hos oto","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract, year). 3-column HOS sheet. Single rate column. Published 2019 and 2021 only; absent 2022+ (CMS appears to have renamed/retired in favor of hedishos_mui).","description":"One row per (contract, year). 3-column HOS sheet. Single rate column. Published 2019 and 2021 only; absent 2022+ (CMS appears to have renamed/retired in favor of hedishos_mui).","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_hos_oto","notes":"Grain-governed; live in Glue / query_substrate. Source family ma_hedis_annual.","superseded_by":null,"tools":["get_hos"],"dataset_id":"cms_ma_hos","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_hos_pao","source_fqn":"medicare_silver.hedis_hos_pao","title":"MA hedis hos pao","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract, year). 4-column HOS sheet. Two rates (rate1, rate2). Stable across 2019-2025 (excluding 2020 gap).","description":"One row per (contract, year). 4-column HOS sheet. Two rates (rate1, rate2). Stable across 2019-2025 (excluding 2020 gap).","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_hos_pao","notes":"Grain-governed; live in Glue / query_substrate. Source family ma_hedis_annual.","superseded_by":null,"tools":["get_hos"],"dataset_id":"cms_ma_hos","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_measures","source_fqn":"medicare_silver.hedis_measures","title":"MA hedis measures (retired v1; read hedis_measures_v2)","domain":"medicare","stage":"silver","status":"retired","grain":"Tall format: one row per (contract, HEDIS measure, indicator key, year). Reported rate plus confidence bounds (LCL/UCL), eligible population (2022+), denominator, numerator, member count (2022+). This is the Stars Ratings spine — every meas","description":"Tall format: one row per (contract, HEDIS measure, indicator key, year). Reported rate plus confidence bounds (LCL/UCL), eligible population (2022+), denominator, numerator, member count (2022+). This is the Stars Ratings spine — every meas","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_measures","known_gaps":["RETIRED 2026-09-29. 2019 numerator/denominator are TRUNCATED to integers (measured 2026-09-29): the 2019 file carries fractional risk-adjusted expected counts in these columns for 16,494 numerators and 14,106 denominators (H0028 PCR 201977_20: publisher 297.4300 served 297, Athena 74db59b1). Corrected rows go to medicare_silver.hedis_measures_v2 (double, plus rate_raw) by restatement; until that load is verified, do not use 2019 numerator/denominator of RAU-type measures (AHU, PCR, EDU, HPC ...).","Coverage: 2019 → present (2020 MISSING — CMS COVID skip).","2020 entirely missing upstream (CMS COVID skip); column drift 2019-2021 -> 2022+.","Uncertified; grain-governed."],"notes":"Grain-governed; live in Glue / query_substrate. Source family ma_hedis_annual.","superseded_by":"medicare_silver.hedis_measures_v2 (restated 2026-09-29 from the same six publisher files): numerator/denominator are double, so the 2019 fractional risk-adjusted expected counts this table truncated (16,494 numerators, 14,106 denominators) are kept, and rate_raw keeps the status codes. Never written again.","tools":[],"dataset_id":"ds_medicare_hedis","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_measures_v2","source_fqn":"medicare_silver.hedis_measures_v2","title":"MA HEDIS measures (restated v2)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (report_year, contract_id, measure_code, indicator_key); 0 duplicate keys per year. Rows = the v1 rows: 597,168 / 488,368 / 522,368 / 173,956 / 143,058 / 133,650 for 2019, 2021-2025.","description":"A contract's reported HEDIS rate per measure and indicator, with LCL/UCL, denominator, numerator, eligible population (2025) and member count (2024+), from the CMS MA HEDIS PUF hedis_measures sheet. numerator/denominator are double: in 2019 the risk-adjusted utilization rows carry fractional observed/expected counts there. rate_raw is the publisher's Rate cell verbatim (NB, NR, NA, BR status codes where rate is NULL).","identity_key":"contract_id","row_count":2058568,"last_updated":"2026-09-29","freshness_sla":"CMS publication cadence; the loader writes a new report year here.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_measures_v2","provenance_chain_ref":"Restatement of the held publisher ZIPs (same sha256_content_hash as v1, parse_revision 2) by ma_hedis_runner --restate-table; verification ops/reconciliation/medicare_ma_hedis_v2_restatement_verify.sql; record docs/reference/source-audit/source-mastery/records/ma_hedis.json correction_2026_09_29.","known_gaps":["Coverage: 2019, 2021-2025 (2020 was never published, CMS COVID skip).","In 2019 the RAU-type rows (AHU, PCR, EDU, HPC ...) carry observed/expected counts in numerator/denominator, not member counts; never sum them with process-measure counts.","Column drift: denominator/numerator absent in 2022-2023 files for most measures; eligible_population only 2025; member_count 2024+.","NEVER ADD SNP plan rows (medicare_silver.snp_hedis_*, contract x PBP) to these contract rows: summed SNP plan denominators equal the contract denominator on only 1,478 of 7,516 2025 keys (19.7%; Athena 00609dc7), and 36 SNP-reporting contracts in 2025 have no contract row here."],"notes":"Restated v2 (HEDIS-fix lane 2026-09-29); supersedes medicare_silver.hedis_measures. Never overwritten; a changed schema is a new version.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_hedis_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_national_rates","source_fqn":"medicare_silver.hedis_national_rates","title":"MA hedis national rates","domain":"medicare","stage":"silver","status":"live","grain":"CMS-published national weighted-average rate per (measure_code, indicator_key) per year. ~70-85 rows per year. The denominator for computing relative contract performance (Stars Ratings inputs).","description":"CMS-published national weighted-average rate per (measure_code, indicator_key) per year. ~70-85 rows per year. The denominator for computing relative contract performance (Stars Ratings inputs).","identity_key":"measure_code","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_national_rates","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["Coverage: 2019 → present (2020 MISSING — CMS COVID skip).","2020 entirely missing upstream (CMS COVID skip); column drift 2019-2021 -> 2022+.","Uncertified; grain-governed.","TWO COLUMNS ARE MISNAMED (defects MAHEDIS-NR-1 / NR-2, measured 2026-09-30): eligible_population holds NR-0070, 'The total number of enrollees in the contracts that submitted a numeric HEDIS rate for this measure and field' (HEDIS2025Documentation.pdf p.3), the weight of the national average, NOT the HEDIS eligible population (2025 AMM 200659_20: 32,353,193 here vs 632,928 summed from the contracts' EligiblePopulation; Athena 61eaea6a-18bf-44f2-b155-2e67bed2e0a7, 206a952a-ffad-4240-a192-075b9b1d34d7). measure_name holds NR-0030, the INDICATOR name. Read medicare_semantic.vw_hedis_national_rates_v2 (reporting_contract_enrollment, indicator_name) and join a contract's rate on (report_year, measure_code, indicator_key): a measure has several indicators with different national rates."],"notes":"Grain-governed; live in Glue / query_substrate. Source family ma_hedis_annual. get_hedis and get_hedis_national_benchmark read the documented names of medicare_semantic.vw_hedis_national_rates_v2 since 2026-09-30; this table is unchanged and stays the physical storage.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_hedis_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["measure_code"],"backing_store":"glue"},{"source_id":"medicare_hedis_national_rates_v2","source_fqn":"medicare_semantic.vw_hedis_national_rates_v2","title":"MA HEDIS national benchmark rates, documented names","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (report_year, measure_code, indicator_key); 0 duplicate keys; 68 / 64 / 85 / 82 / 88 / 84 rows in 2019 / 2021-2025 = the rows of medicare_silver.hedis_national_rates (Athena 206a952a-ffad-4240-a192-075b9b1d34d7).","description":"CMS's national enrollment-weighted HEDIS rate per measure indicator and report year, from the MA HEDIS PUF national_rates sheet, under the names CMS documents (HEDIS2025Documentation.pdf, REPORTING LEVEL - National, p.3): report_year (NR-0010), measure_code (-0020), indicator_name (-0030 \"Field\"), indicator_key (-0040), weighted_rate (-0050, the national rate), contracts_count (-0060, contracts with a numeric rate) and reporting_contract_enrollment (-0070, the enrollees of those contracts: TotE, the weight of the average). The national sheet publishes no eligible population.","identity_key":"measure_code","row_count":471,"last_updated":"2026-09-30","freshness_sla":"CMS publication cadence; a view over medicare_silver.hedis_national_rates, so a new report year appears when the loader appends it.","raw_queryable_via":"Tools: get_hedis (the benchmark), get_hedis_national_benchmark; Athena: medicare_semantic.vw_hedis_national_rates_v2","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-09-30 (Athena c3d5a7b5-cae8-498c-8961-d80db375b0b0) from pipelines/medicare/semantic/hedis_national_rates_v2.sql over medicare_silver.hedis_national_rates; every row keeps source_url, sha256_content_hash, asserted_at. Rollback: DROP VIEW after reverting the get_hedis repoint.","known_gaps":["Coverage: 2019, 2021-2025 (2020 was never published, CMS COVID skip); report_year is the PUF year, the measurement year is report_year - 1.","Join a contract's rate on (report_year, measure_code, indicator_key), never on the measure alone: 12-17 measures a year carry several indicators with different national rates. Joined on the measure alone, 44-60 indicators a year got another indicator's benchmark and 6 a year got one that CMS does not publish (Athena 14750188-c692-41e7-a1c5-3a4937b44bf4).","reporting_contract_enrollment is NOT an eligible population: 2025 AMM 200659_20 = 32,353,193 enrollees of the 477 reporting contracts; the contracts' own EligiblePopulation (medicare_silver.hedis_measures_v2, 2025 only) sums to 632,928.","In 2019 indicator_name joins measure and indicator ('Antidepressant Medication Management - Effective Acute Phase Treatment'); 2021+ carry the indicator alone."],"notes":"Documented-name view (Data Tracker served-defect lane, 2026-09-30, defects MAHEDIS-NR-1 / NR-2 / NR-3); supersedes the column names of medicare_silver.hedis_national_rates. Versioned, never overwritten. Record docs/reference/source-audit/source-mastery/records/ma_hedis.json served_corrections.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_hedis_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["measure_code"],"backing_store":"glue"},{"source_id":"medicare_hedis_rau_measures","source_fqn":"medicare_silver.hedis_rau_measures","title":"MA hedis rau measures","domain":"medicare","stage":"silver","status":"live","grain":"Tall format: one row per (contract, RAU measure, indicator, year). Reports observed vs expected counts (with variance) for risk- adjusted utilization measures (admissions, ED visits, etc.). Added to MA-HEDIS PUFs starting in 2021. Per-row c","description":"Tall format: one row per (contract, RAU measure, indicator, year). Reports observed vs expected counts (with variance) for risk- adjusted utilization measures (admissions, ED visits, etc.). Added to MA-HEDIS PUFs starting in 2021. Per-row c","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_rau_measures","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["Coverage: 2019 → present (2020 MISSING — CMS COVID skip).","2020 entirely missing upstream (CMS COVID skip); column drift 2019-2021 -> 2022+.","Uncertified; grain-governed."],"notes":"Grain-governed; live in Glue / query_substrate. Source family ma_hedis_annual.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_hedis_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_service_area","source_fqn":"medicare_silver.hedis_service_area","title":"MA hedis service area (legacy column names; read vw_hedis_service_area_v2)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (contract, county) per year. Long-format service area: contract operates in this county for this measurement year. Partial- county flag (SA-0070) indicates plans that cover only part of the county.","description":"One row per (contract, county) per year. Long-format service area: contract operates in this county for this measurement year. Partial- county flag (SA-0070) indicates plans that cover only part of the county.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hedis_service_area","known_gaps":["Coverage: 2019 → present (2020 MISSING — CMS COVID skip).","2020 entirely missing upstream (CMS COVID skip); column drift 2019-2021 -> 2022+.","Uncertified; grain-governed."],"notes":"RETIRED 2026-09-29 (HEDIS-fix lane): columns mislabeled and key under-declared at the 2026-05-15 build; superseded by medicare_semantic.vw_hedis_service_area_v2. Record docs/reference/source-audit/source-mastery/records/ma_hedis.json correction_2026_09_29.","superseded_by":"medicare_semantic.vw_hedis_service_area_v2 (2026-09-29): the same rows under the names CMS documents and with the key they satisfy. In this table state_fips holds SA-0030, the SSA state/county code; county_fips holds SA-0040, the FIPS county; partial_county holds SA-0070, the county-serves-only-EGHP flag (not a partial-county flag). (contract_id, county_fips, report_year) is not unique. It stays queryable and remains the physical storage the loader appends to.","tools":[],"dataset_id":"ds_medicare_hedis","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hedis_service_area_v2","source_fqn":"medicare_semantic.vw_hedis_service_area_v2","title":"MA HEDIS contract service area, documented names","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (report_year, contract_id, ssa_state_county_code, fips_state_county_code, eghp_only_county): 0 duplicate groups in every year (Athena 2e4d240e, ccba7dde). 2,453,366 rows 2019, 2021-2025.","description":"The counties in each MA contract's service area per HEDIS report year, from the HEDIS PUF service_area sheet, under CMS's documented names: ssa_state_county_code (SA-0030), fips_state_county_code (SA-0040, ANSI/FIPS INCITS 31-2009), fips_state_code (first two digits of SA-0040), state_code (SA-0050), county_name_raw (SA-0060), eghp_only_county (SA-0070: 1 = the county serves only Employer Group Health Plan members).","identity_key":"contract_id","row_count":2453366,"last_updated":"2026-09-29","freshness_sla":"CMS publication cadence; a view over medicare_silver.hedis_service_area, so a new report year appears when the loader appends it.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hedis_service_area_v2","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-09-29 (Athena b6f27e3d-e8de-4a04-a36c-911587b4b0af) from pipelines/medicare/semantic/hedis_service_area_v2.sql over medicare_silver.hedis_service_area; every row keeps source_url, sha256_content_hash, asserted_at.","known_gaps":["Coverage: 2019, 2021-2025 (2020 was never published, CMS COVID skip).","The key needs eghp_only_county: CMS lists some contract x county twice, once EGHP-only and once not (16 / 9 / 6 / 4 / 3 / 3 pairs in 2019 / 2021-2025). Both rows are kept.","fips_state_county_code is not unique within a contract: Los Angeles 06037 has two SSA codes and Guam 66010 has 22. Count counties with DISTINCT fips_state_county_code.","About 90% of rows are EGHP-only (national employer-group service areas); filter eghp_only_county = 0 for the individual-market footprint. Verified 2026-09-29 against CPSC county enrollment Dec 2024: every eghp_only_county = 0 cell of the 2025 file has a non-800-series plan enrolled (43,716 of 43,716), and 386,938 of 395,201 matched EGHP-only cells have only 800-series plans (Athena 8ee30bb2).","The legacy parser collapsed rows byte-identical in the publisher file (2021: 1, 2022: 1, 2023: 7, 2024: 7); rows = publisher rows minus those exact repeats."],"notes":"Documented-name view (HEDIS-fix lane 2026-09-29); supersedes the column names and key of medicare_silver.hedis_service_area. Versioned, never overwritten.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_hedis_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_contract_service_area","source_fqn":"medicare_silver.ma_contract_service_area","title":"MA ma contract service area","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, county) per month. Each row records the contract's organizational metadata (organization_name, plan_type, EGHP flag) plus the partial-county flag (TRUE when the contract covers only part of the county, per CMS's pu","description":"One row per (contract_id, county) per month. Each row records the contract's organizational metadata (organization_name, plan_type, EGHP flag) plus the partial-county flag (TRUE when the contract covers only part of the county, per CMS's pu","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column.","Standard CMS refresh cadence."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_contract_service_area","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["Coverage: 2006-10 onward, monthly; the newest month is max(report_month), loaded as CMS posts it (by the 15th).","Uncertified; grain-governed.","DEFECT: eghp and partial_county are FALSE on every row (89.8M rows, Athena 1134a56e; the parser reads CMS '*' as false). Do not read employer-only or partial-county status here, and never UNION with medicare_silver.pdp_contract_service_area, whose eghp is populated (134,095 of 151,719 TRUE in 2026-09, Athena 0249341c). The MA and PDP contract sets are disjoint (2026-09: 710 vs 48 contracts, 0 shared)."],"notes":"Grain-governed; live in Glue / query_substrate. Source family ma_contract_service_area.","superseded_by":"medicare_silver.ma_contract_service_area_v2 (parse revision 2, restated 2026-10-06 from the same CMS files): eghp and partial_county carry the publisher's flags, national service-area rows are kept (state_code NULL, national_service_area true), flag-split rows are kept, 2019-02 short codes fixed. This table is the frozen rollback.","tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_contract_service_area_v2","source_fqn":"medicare_silver.ma_contract_service_area_v2","title":"MA contract service area (revision 2)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, county, flag variant) per month: 89,865,222 rows in 239 months. A contract-county CMS splits across flag values appears on more than one row (3,788 split rows); national service-area rows have no county or state.","description":"Which counties each MA contract serves each month, from CMS's monthly contract service area file, with organization_name, plan_type, the EGHP (employer-only) flag and the partial-county flag as CMS prints them, and national_service_area for nationwide contracts (National PACE and similar).","identity_key":"contract_id","row_count":89865222,"last_updated":"2026-10-06","freshness_sla":"CMS publication cadence (by the 15th); new months land here after the medicare publish.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_contract_service_area_v2","provenance_chain_ref":"Restatement of the held publisher files (parse_revision 2) by tools/medicare/submit_ma_contract_service_area_restatement.py (#3105, MACSA-1..4); verification tools/data_tracker/verify_tracker_loads.py --only medicare_ma_contract_service_area:v2 (18/18 PASS) and reconcile_cells (cloud run 20261006T221023Z-a1b75d6e, PASS); record docs/reference/source-audit/source-mastery/records/medicare_ma_contract_service_area.json.","known_gaps":["National service-area rows (15,187) have state_code NULL and national_service_area = true; filter them out of state and county rollups.","Count contract-counties with COUNT(DISTINCT contract_id || county_ssa): flag-split contract-counties carry more than one row.","The MA and PDP contract sets are disjoint (2026-09: 710 vs 48 contracts, 0 shared); PDP service areas are medicare_silver.pdp_contract_service_area."],"notes":"Restated v2 (Data Tracker parse-loss lane, 2026-10-06); supersedes medicare_silver.ma_contract_service_area. Served by get_contract_service_area 0.2.0 (registered 2026-10-06; vlada.supersedes_revision_1 set 2026-10-06). Never overwritten; a changed schema is a new version.","superseded_by":null,"tools":["get_contract_service_area"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_state_county_penetration","source_fqn":"medicare_silver.ma_state_county_penetration","title":"MA ma state county penetration","domain":"medicare","stage":"silver","status":"live","grain":"One row per (county, month). Each row records eligibles (Medicare-eligible population), enrolled (MA-enrolled population), and penetration (enrolled / eligibles). Includes both FIPS-based and SSA-based county identifiers, plus human-readabl","description":"One row per (county, month). Each row records eligibles (Medicare-eligible population), enrolled (MA-enrolled population), and penetration (enrolled / eligibles). Includes both FIPS-based and SSA-based county identifiers, plus human-readabl","identity_key":"fipsst","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column.","Penetration monthly; suppression preserves bounds, NULL != 0."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_state_county_penetration","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["Coverage: 2008-06 onward, monthly; the newest month is max(report_month), loaded as CMS posts it (by the 15th).","Small-cell suppression: enrolled NULL but bounds [0,10] (NULL != 0); ~68 rows >100% are real CMS quirks.","Uncertified; deep-card grain-verified.","NEVER ADD eligibles to medicare_silver.pdp_state_county_penetration eligibles: they are equal on every county-month (707,500 of 707,500 over 220 shared months, Athena d61b392c). Take eligibles from one table; MA share + PDP share over the same eligibles is fine.","Connecticut is absent from 2024-08 on (26 months through 2026-09, Athena 127ce007): CMS's gap, not ours. The publisher's ReadMe says CT's new planning-region codes are not yet in CMS data; the CSV has 0 CT rows.","Does NOT tie to medicare_silver.fact_medicare_monthly_enrollment: tot_benes = eligibles on 501 of 95,994 county-months (0.5%) 2024-01..2026-06, and the January 2026 national total there is 1.8% higher (69,691,534 vs 68,469,878; Athena f27f2d84, b9c2bf7c). Never mix a numerator from one with a denominator from the other.","CODES LOSE THEIR LEADING ZEROS IN FOUR MONTHS (defect MASCP-1, measured 2026-09-30): in 2025-01, 2025-02, 2025-03 and 2026-08 CMS printed Autauga AL as fipsst '1', fipscnty '1', fips '1001', ssa '1000' and this table stores them as printed (2,040 / 2,040 / 2,040 / 2,013 rows carry a short code; Athena c5178649-bd99-42b0-b81a-49fbcfe8ad99, e3453fa3-d0de-4ea1-a2b9-b0126e156e85). A join on a 5-digit county FIPS drops every county in states 01-09 in those months (California 0 of 58 in 2025-02; Athena a5057c3e-4652-42fe-a79c-eb8efb2b5f5e). Read medicare_semantic.vw_ma_state_county_penetration_v2, which pads every code (2,907 -> 3,208 CPSC counties join in 2025-02; Athena 3da62476-d285-4092-ad69-10b6e5039162), or lpad the codes yourself.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_ma_penetration, get_market_share and get_county_view read medicare_semantic.vw_ma_state_county_penetration_v4 (card medicare_ma_state_county_penetration_v4) over the reconciled revision-2 table: every row here with the same values, codes padded, blank cells coded not_reported, combined territory figures flagged, plus CMS's 1,990 Pending rows of 2008-2016 this table dropped. This table is the rollback.","Alaska is absent from 2025-07 on (boroughs redistricted; the ReadMe inside each zip says so, like Connecticut's). National MA totals from this file run ~0.45M low from 2024-09; tools/ma_brain/ma_enrollment_series.py fills both states from enrollment_monthly_county. Found 2026-09-29."],"notes":"Grain-governed; live in Glue / query_substrate. Source family ma_state_county_penetration. get_market_share reads medicare_semantic.vw_ma_state_county_penetration_v2 since 2026-09-30 (MASCP-1); this table is unchanged. Invariant KeySetStable (fipsst) fails any month a state leaves the file unless the exit is known (CT 2024-08, AK 2025-07).","superseded_by":null,"tools":["get_market_share"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["fipsst"],"backing_store":"glue"},{"source_id":"medicare_ma_state_county_penetration_v2","source_fqn":"medicare_semantic.vw_ma_state_county_penetration_v2","title":"MA State/County Penetration, county codes at their documented width","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (fipsst, fipscnty, report_month); the rows of medicare_silver.ma_state_county_penetration (707,500 over 220 months, view minus table = 0 and 0 duplicate (fips, report_month); Athena 8614613f-53f9-495e-966d-95afcc5eb49c).","description":"Medicare eligibles, MA enrollees and MA penetration per county and month from CMS's MA State/County Penetration files, with FIPSST / SSAST padded to 2 digits, FIPSCNTY / SSACNTY to 3, and FIPS / SSA rebuilt as the concatenated state + county codes the publisher's readme defines (Read_Me_SC_Penetration_MA_YYYY.txt). CMS printed the codes without leading zeros in 2025-01, 2025-02, 2025-03 and 2026-08; every other month is unchanged. codes_padded_by_view marks the rows the view changed.","identity_key":"fips","row_count":707500,"last_updated":"2026-09-30","freshness_sla":"Monthly (CMS posts by the 15th); a view over medicare_silver.ma_state_county_penetration, so a new month appears when the loader appends it.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column.","Penetration monthly; suppression preserves bounds, NULL != 0."]},"raw_queryable_via":"Tool: get_market_share; Athena: medicare_semantic.vw_ma_state_county_penetration_v2 (pin report_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-09-30 (Athena 74ccfcf0-f16a-4e4f-890e-c8aac57c90e8) from pipelines/medicare/semantic/ma_state_county_penetration_v2.sql over medicare_silver.ma_state_county_penetration; every row keeps source_url, sha256_content_hash, asserted_at. Rollback: DROP VIEW after reverting the get_market_share repoint.","known_gaps":["Padded rows: 2,040 in each of 2025-01..03 and 2,013 in 2026-08; 0 in the other 216 months (Athena e3453fa3-d0de-4ea1-a2b9-b0126e156e85). CPSC counties that join on fips: 2025-02 2,907 -> 3,208, 2026-08 2,907 -> 3,186 (= 2026-09); California 58 of 58 in every month (Athena 3da62476-d285-4092-ad69-10b6e5039162, a5057c3e-4652-42fe-a79c-eb8efb2b5f5e).","Connecticut is absent from 2024-08 on (CMS's gap: the planning-region codes are not yet in CMS data).","NEVER ADD eligibles to the PDP penetration eligibles (one Medicare population); suppressed enrolled is NULL with bounds [0,10], never zero.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_market_share reads medicare_semantic.vw_ma_state_county_penetration_v4 (card medicare_ma_state_county_penetration_v4): every row of this view with the same values, plus the not_reported, pending_designation and counted-once columns and CMS's 2008-2016 Pending rows. This view is the rollback."],"notes":"Versioned view (Data Tracker served-defect lane, 2026-09-30, defect MASCP-1); supersedes the code columns of medicare_silver.ma_state_county_penetration. The MA runner pads from its next load (parser fix in the same PR). Record docs/reference/source-audit/source-mastery/records/medicare_ma_state_county_penetration.json.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["census:fips"],"entity_key_columns":{"census:fips":["fips"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_state_county_penetration_v3","source_fqn":"medicare_semantic.vw_ma_state_county_penetration_v3","title":"MA State/County Penetration with blank cells, Pending rows and combined territory figures marked","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (fipsst, fipscnty, report_month); the rows and values of medicare_semantic.vw_ma_state_county_penetration_v2 (707,500 over 220 months, 0 value differences; Athena 00f12625, 10f1ad30).","description":"Medicare eligibles, MA enrollees and MA penetration per county and month from CMS's MA State/County Penetration files, codes padded (MASCP-1), with three corrections a reader cannot make alone: a blank Enrolled cell is coded not_reported (MASCP-3); CMS's Pending State / Pending County Designation rows carry pending_designation; and the figure CMS prints once on every county of a combined territory group (VI St. John and St. Thomas; NMI Rota, Saipan and Tinian) is flagged, with eligibles_counts_once / enrolled_counts_once so a sum counts it once (MASCP-4). The tools read medicare_semantic.vw_ma_state_county_penetration_v4 (the same projection over the reconciled table); this view is its rollback.","identity_key":"fips","row_count":707500,"last_updated":"2026-10-05","freshness_sla":"Monthly (CMS posts by the 15th); a view over the served table, so a new month appears when the loader appends it.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column.","Penetration monthly; suppression preserves bounds, NULL != 0."]},"raw_queryable_via":"Athena: medicare_semantic.vw_ma_state_county_penetration_v3 (pin report_month); the tools read v4","provenance_chain_ref":"Glue VIRTUAL_VIEW from pipelines/medicare/semantic/ma_state_county_penetration_v3.sql over medicare_semantic.vw_ma_state_county_penetration_v2 and medicare_silver.ma_state_county_penetration. The revision-2 table medicare_silver.ma_state_county_penetration_v2 passed the cell reconciliation (220 of 220 months, 0 mismatches; docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md) and equals the served rows in every common cell; this view does not read it (vw_ma_state_county_penetration_v4 does), so the 1,990 pre-2017 Pending rows and the 2016-02 Bedford City value are not in this view. Rollback: medicare_semantic.vw_ma_state_county_penetration_v2.","known_gaps":["SUMS: SUM(CASE WHEN eligibles_counts_once THEN eligibles END) and SUM(CASE WHEN enrolled_counts_once THEN enrolled END). 2026-09 Virgin Islands enrolled: 8,870 summed naively, 5,733 counted once (Athena 68d29bda).","PENDING ROWS INCLUDE WHOLE TERRITORIES: American Samoa (fips 60050) and Guam (66010) are published only as a Pending County Designation row. Never drop them with NOT pending_designation when the intent is \"exclude unassigned county rows\": count a Pending row where it is the state's only row that month, and leave out the Pending State rows that carry no state. 212 Pending rows 2020-01..2026-09 (Athena 89dfc7dc).","not_reported: 270 rows where CMS left Enrolled blank (no bound), coded none in the served table (suppression_reason_code_legacy).","Connecticut is absent from 2024-08 on (CMS's gap). NEVER ADD eligibles to the PDP penetration eligibles (one Medicare population); suppressed enrolled is NULL with bounds [0,10], never zero."],"notes":"Versioned view (Data Tracker wave 1A, docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md, defects MASCP-3/-4). Never overwritten; vw_ma_state_county_penetration_v2 stays live as the rollback.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["census:fips"],"entity_key_columns":{"census:fips":["fips"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_state_county_penetration_v4","source_fqn":"medicare_semantic.vw_ma_state_county_penetration_v4","title":"MA State/County Penetration over the reconciled parse, with Pending rows, blank cells and combined territory figures marked","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (fipsst, fipscnty, state_name, report_month); 709,490 rows over 220 months 2008-06..2026-09, 2,202 Pending rows, 0 duplicate keys. Every row of vw_ma_state_county_penetration_v3 is here with equal values (707,500 joined, 0 differences except the 2016-02 Bedford City penetration; Athena 0a9416a2, 1c79d799).","description":"Medicare eligibles, MA enrollees and MA penetration per county and month from CMS's MA State/County Penetration files, the v3 projection over the reconciled parse-revision-2 table medicare_silver.ma_state_county_penetration_v2: codes padded (MASCP-1), blank Enrolled coded not_reported (MASCP-3), CMS's Pending State / Pending County Designation rows in every month (MASCP-2: +1,990 rows 2008-2016) with pending_designation set by the parser from CMS's labels, the 2016-02 Bedford City penetration recovered (36.0), and the figure CMS prints once on every county of a combined territory group flagged with eligibles_counts_once / enrolled_counts_once (MASCP-4). get_ma_penetration, get_market_share and get_county_view read this view from 2026-10-05.","identity_key":"fips","row_count":709490,"last_updated":"2026-10-05","freshness_sla":"Monthly (CMS posts by the 15th); a new month appears when the loader writes it to the revision-2 table.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column.","Penetration monthly; suppression preserves bounds, NULL != 0."]},"raw_queryable_via":"Tools: get_ma_penetration, get_market_share, get_county_view; Athena: medicare_semantic.vw_ma_state_county_penetration_v4 (pin report_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW from pipelines/medicare/semantic/ma_state_county_penetration_v4.sql (PR 3183) over medicare_silver.ma_state_county_penetration_v2, written by the restate_medicare_ma_state_county_penetration job from the 220 held bronze ZIPs. Cell reconciliation PASS, 220 of 220 editions, 8,513,880 cells, 0 mismatches (docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). Rollback: medicare_semantic.vw_ma_state_county_penetration_v3.","known_gaps":["PENDING ROWS INCLUDE WHOLE TERRITORIES (Tracker trap): American Samoa and Guam are published only as a Pending County Designation row (fipsst 60 / 66; fips 60050 / 66010 from 2020-12, NULL county codes before 2017), and Wake Island (79) only that way 2008-2016. Never drop them with NOT pending_designation when the intent is \"exclude unassigned county rows\". A state or national sum counts a Pending row only where it is the state's only row that month (AS, GU, Wake Island = their own totals) and leaves out the Pending County rows beside a state's own counties (2008-06..2016-12) and the Pending State rows with no state (fipsst 00, 99, UK or blank). get_ma_penetration does exactly this and reports what it left out.","SUMS: SUM(CASE WHEN eligibles_counts_once THEN eligibles END) and SUM(CASE WHEN enrolled_counts_once THEN enrolled END). 2026-09 Virgin Islands enrolled: 8,870 summed naively, 5,733 counted once.","PRE-2017 PENDING ROWS have NULL fipscnty and fips, so a county join never meets them; 2008-06..2010-12 the Pending State row prints FIPSST 'UK'.","not_reported: rows where CMS left Enrolled blank (no bound). Suppressed enrolled is NULL with bounds [0,10], never zero.","Connecticut is absent from 2024-08 on (CMS's gap). NEVER ADD eligibles to the PDP penetration eligibles (one Medicare population)."],"notes":"Versioned view (Data Tracker, PR 3183, over the wave-1A reload; defects MASCP-1..4). Never overwritten; vw_ma_state_county_penetration_v3 stays live as the rollback.","superseded_by":null,"tools":["get_county_view","get_market_share"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["census:fips"],"entity_key_columns":{"census:fips":["fips"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_mpf_benefit_summary_annual","source_fqn":"medicare_silver.mpf_benefit_summary_annual","title":"MA mpf benefit summary annual","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract, plan, segment, year, service category, service). Cost_share is human-readable (e.g. \"$25 copay\", \"20% coinsurance\", \"$0 copay\", \"Not covered\"). Includes Original Medicare baseline rows for FFS comparison. Categories f","description":"One row per (contract, plan, segment, year, service category, service). Cost_share is human-readable (e.g. \"$25 copay\", \"20% coinsurance\", \"$0 copay\", \"Not covered\"). Includes Original Medicare baseline rows for FFS comparison. Categories f","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"contract_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'contract_year' is the source's documented vintage column.","MPF is the consumer crosswalk; reconcile, don't substitute."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.mpf_benefit_summary_annual","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Coverage: 2020 → present (annual).","Consumer Plan Finder summary (2020+); use to RECONCILE PBP, not as PBP source of truth.","Uncertified; grain-governed."],"notes":"Grain-governed; live in Glue / query_substrate. Source family mpf_benefit_summary_report.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_finder_mpf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_changelog","source_fqn":"medicare_silver.pbp_changelog","title":"MA pbp changelog","domain":"medicare","stage":"silver","status":"partial","grain":"Parsed Readme_PBP_Benefits_YYYY.txt. Categories: column_length_change / variable_added / variable_removed / file_added / file_removed / policy_note / txt_sas_pairing / file_description / description. 2001-era Readmes have only description +","description":"Parsed Readme_PBP_Benefits_YYYY.txt. Categories: column_length_change / variable_added / variable_removed / file_added / file_removed / policy_note / txt_sas_pairing / file_description / description. 2001-era Readmes have only description +","identity_key":"report_year","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","PBP metadata/overlay; refresh-cadence only."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_changelog","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","PBP metadata/overlay table (not a benefit-amount fact).","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["report_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_field_dictionary","source_fqn":"medicare_silver.pbp_field_dictionary","title":"MA pbp field dictionary","domain":"medicare","stage":"silver","status":"partial","grain":"Parsed PBP{YEAR}_dictionary.xls/xlsx. 26K rows / year mapping (file, field) → (type, length, service category, codes). Substrate-as-self-documenting layer.","description":"Parsed PBP{YEAR}_dictionary.xls/xlsx. 26K rows / year mapping (file, field) → (type, length, service category, codes). Substrate-as-self-documenting layer.","identity_key":"report_year","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","PBP metadata/overlay; refresh-cadence only."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_field_dictionary","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","PBP metadata/overlay table (not a benefit-amount fact).","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["report_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_mrx","source_fqn":"medicare_silver.pbp_mrx","title":"MA pbp mrx","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, mrx_grp_type_id, mrx_grp_id, report_year, quarter). mrx_grp_type_id/mrx_grp_id are CMS-native 2006 legacy group identifiers; modern rows retain nulls where the source does not publish them.","description":"Part D Rx plan-level/group detail from mrx.txt. Coverage begins in 2006; insulin/IRA fields are added in later eras. Legacy repeated rows are retained at the source-native MRx group grain.","identity_key":"contract_id,plan_id,segment_id,version,mrx_grp_type_id,mrx_grp_id,report_year,quarter","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_mrx","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2006 → present (annual pre-2018 & 2025+; quarterly 2018-2024); 2001-2005 PBP ZIPs contain no MRx files.","Legacy key is source-native: mrx_grp_type_id + mrx_grp_id are required to retain repeated 2006 group rows; do not synthesize or collapse rows.","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned.","CY2020 PART D NUMERICS (Athena 07c23e2b, 2026-10-13): CY2020 Q1 (parse_revision 2, 7,300 rows) has every numeric mrx_* column empty, 0 of 1,713 Part D deductible amounts (mrx_alt_ded_charge = '2', mrx_alt_ded_amount null), and version 0 on every row, until its corrected revision is appended. Q2 (7,289 rows) and Q4 (7,299 rows) were appended 2026-10-13 as parse_revision 3 and are filled (1,701 deductible amounts each). CMS posted no CY2020 Q3. Read one revision per (report_year, quarter) from the current view (medicare_silver.vw_pbp_mrx_current_v20261013a). Reading this table directly would double-count CY2020 Q1 once its correction lands (docs/data-tracker/LANDSCAPE-PBP-DEFECTS-2026-10-13.md s2)."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year","version"],"unmapped_key_tokens":["mrx_grp_id","mrx_grp_type_id","quarter"],"backing_store":"glue"},{"source_id":"medicare_pbp_mrx_gap_coverage","source_fqn":"medicare_silver.pbp_mrx_gap_coverage","title":"MA pbp mrx gap coverage","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, mrx_tier_id, report_year, quarter). mrx_tier_id is the CMS-native legacy row identifier; null benefit amounts remain null.","description":"Part D coverage-gap detail keyed by the source-native MRx tier identifier. Folded into pbp_mrx in 2026. Coverage: 2008-2025.","identity_key":"contract_id,plan_id,segment_id,version,mrx_tier_id,report_year,quarter","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_mrx_gap_coverage","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2008-2025; the gapCoverage file first appears in the 2008 PBP ZIP and is folded into pbp_mrx in 2026.","The approved legacy key uses CMS-native mrx_tier_id; mrx_gap_id is not a reliable legacy identifier and must not be synthesized.","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year","version"],"unmapped_key_tokens":["mrx_tier_id","quarter"],"backing_store":"glue"},{"source_id":"medicare_pbp_mrx_p","source_fqn":"medicare_silver.pbp_mrx_p","title":"MA pbp mrx p","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, mrx_tier_post_id, mrx_tier_post_type_id, report_year, quarter). Keys are CMS-native post-tier identifiers. Coverage: 2007-present.","description":"Part D plan x pharmacy-tier formulary detail from mrx_p. The source-native post-tier identifiers retain repeated legacy rows without a synthetic mrx_p_id.","identity_key":"contract_id,plan_id,segment_id,version,mrx_tier_post_id,mrx_tier_post_type_id,report_year,quarter","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_mrx_p","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2007-present; mrx_p first appears in the 2007 PBP ZIP.","Use native mrx_tier_post_id + mrx_tier_post_type_id; do not collapse duplicate legacy groups or synthesize mrx_p_id.","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year","version"],"unmapped_key_tokens":["mrx_tier_post_id","mrx_tier_post_type_id","quarter"],"backing_store":"glue"},{"source_id":"medicare_pbp_mrx_tier","source_fqn":"medicare_silver.pbp_mrx_tier","title":"MA pbp mrx tier","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, mrx_tier_id, mrx_tier_type_id, report_year, quarter). Plan x native tier identifier. Coverage: 2007-present.","description":"Part D Rx tier detail from mrx_tier.txt, keyed by both CMS-native tier identifiers so legacy repeated rows remain distinct.","identity_key":"contract_id,plan_id,segment_id,version,mrx_tier_id,mrx_tier_type_id,report_year,quarter","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_mrx_tier","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2007-present; mrx_tier first appears in the 2007 PBP ZIP.","Native mrx_tier_id + mrx_tier_type_id are the certified legacy key; do not deduplicate by modern plan-level keys.","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year","version"],"unmapped_key_tokens":["mrx_tier_id","mrx_tier_type_id","quarter"],"backing_store":"glue"},{"source_id":"medicare_pbp_plan_area","source_fqn":"medicare_silver.pbp_plan_area","title":"MA pbp plan area","domain":"medicare","stage":"silver","status":"partial","grain":"Plan × county service area. ~2.3M rows per modern year. PlanArea + PlanRegionArea consolidated via area_type enum.","description":"Plan × county service area. ~2.3M rows per modern year. PlanArea + PlanRegionArea consolidated via area_type enum.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","PBP metadata/overlay; refresh-cadence only."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_plan_area","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","PBP metadata/overlay table (not a benefit-amount fact).","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_plan_region_area","source_fqn":"medicare_silver.pbp_plan_region_area","title":"MA pbp plan region area","domain":"medicare","stage":"silver","status":"partial","grain":"Regional-plan service area (parallel to plan_area for regional PPO). Coverage: 2006-present.","description":"Regional-plan service area (parallel to plan_area for regional PPO). Coverage: 2006-present.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","PBP metadata/overlay; refresh-cadence only."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_plan_region_area","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","PBP metadata/overlay table (not a benefit-amount fact).","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_sas_schema","source_fqn":"medicare_silver.pbp_sas_schema","title":"MA pbp sas schema","domain":"medicare","stage":"silver","status":"partial","grain":"SAS-parsed column manifest. One row per (table, year, column). Built from SAS files in the archive via sas_schema_parser primitive.","description":"SAS-parsed column manifest. One row per (table, year, column). Built from SAS files in the archive via sas_schema_parser primitive.","identity_key":"table_name","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","PBP metadata/overlay; refresh-cadence only."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_sas_schema","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","PBP metadata/overlay table (not a benefit-amount fact).","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["table_name"],"backing_store":"glue"},{"source_id":"medicare_pbp_section_a","source_fqn":"medicare_silver.pbp_section_a","title":"MA pbp section a","domain":"medicare","stage":"silver","status":"partial","grain":"Plan universe. One row per (contract, plan, segment, version) per (year, quarter). Era-1 (pre-2010) rows synthesize segment_id='', version=0.","description":"Plan universe. One row per (contract, plan, segment, version) per (year, quarter). Era-1 (pre-2010) rows synthesize segment_id='', version=0.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_a","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b10_amb_trans","source_fqn":"medicare_silver.pbp_section_b10_amb_trans","title":"MA pbp section b10 amb trans","domain":"medicare","stage":"silver","status":"partial","grain":"Section B10: Ambulance / transport cost-share. Coverage: All years.","description":"Section B10: Ambulance / transport cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b10_amb_trans","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b11_dme_prosth_orth_sup","source_fqn":"medicare_silver.pbp_section_b11_dme_prosth_orth_sup","title":"MA pbp section b11 dme prosth orth sup","domain":"medicare","stage":"silver","status":"partial","grain":"Section B11: Durable medical equipment, prosthetics, orthotics, supplies. Per-plan benefit detail (plaintiff use case).","description":"Section B11: Durable medical equipment, prosthetics, orthotics, supplies. Per-plan benefit detail (plaintiff use case).","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b11_dme_prosth_orth_sup","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b12_renal_dialysis","source_fqn":"medicare_silver.pbp_section_b12_renal_dialysis","title":"MA pbp section b12 renal dialysis","domain":"medicare","stage":"silver","status":"partial","grain":"Section B12: Renal dialysis cost-share. Coverage: All years.","description":"Section B12: Renal dialysis cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b12_renal_dialysis","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b14_preventive","source_fqn":"medicare_silver.pbp_section_b14_preventive","title":"MA pbp section b14 preventive","domain":"medicare","stage":"silver","status":"partial","grain":"Section B14: Preventive services. Widest single section (190 cols in 2026).","description":"Section B14: Preventive services. Widest single section (190 cols in 2026).","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b14_preventive","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b15_partb_rx_drugs","source_fqn":"medicare_silver.pbp_section_b15_partb_rx_drugs","title":"MA pbp section b15 partb rx drugs","domain":"medicare","stage":"silver","status":"partial","grain":"Section B15: Part B Rx drugs benefit detail. Drug-substrate join surface. Coverage: All years.","description":"Section B15: Part B Rx drugs benefit detail. Drug-substrate join surface. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b15_partb_rx_drugs","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b19_model_test","source_fqn":"medicare_silver.pbp_section_b19_model_test","title":"MA pbp section b19 model test","domain":"medicare","stage":"silver","status":"partial","grain":"Section B19: Model test slot. Net-new base file 2026 (was VBID-only pre-2026). Coverage: 2026-present.","description":"Section B19: Model test slot. Net-new base file 2026 (was VBID-only pre-2026). Coverage: 2026-present.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b19_model_test","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b1a_inpat_hosp","source_fqn":"medicare_silver.pbp_section_b1a_inpat_hosp","title":"MA pbp section b1a inpat hosp","domain":"medicare","stage":"silver","status":"partial","grain":"Section B1a: Inpatient hospital (acute) cost-share. Splits from b1b psych starting 2010. Coverage: All years.","description":"Section B1a: Inpatient hospital (acute) cost-share. Splits from b1b psych starting 2010. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b1a_inpat_hosp","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b1b_inpat_hosp_psych","source_fqn":"medicare_silver.pbp_section_b1b_inpat_hosp_psych","title":"MA pbp section b1b inpat hosp psych","domain":"medicare","stage":"silver","status":"partial","grain":"Section B1b: Inpatient hospital psych cost-share. Split from b1a in 2010. Coverage: 2010-present.","description":"Section B1b: Inpatient hospital psych cost-share. Split from b1a in 2010. Coverage: 2010-present.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b1b_inpat_hosp_psych","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b20","source_fqn":"medicare_silver.pbp_section_b20","title":"MA pbp section b20","domain":"medicare","stage":"silver","status":"partial","grain":"Section B20: Supplemental benefits — other / unclassified. Coverage: All years.","description":"Section B20: Supplemental benefits — other / unclassified. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b20","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b2_snf","source_fqn":"medicare_silver.pbp_section_b2_snf","title":"MA pbp section b2 snf","domain":"medicare","stage":"silver","status":"partial","grain":"Section B2: Skilled nursing facility cost-share. Coverage: All years.","description":"Section B2: Skilled nursing facility cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b2_snf","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b3_cardiac_rehab","source_fqn":"medicare_silver.pbp_section_b3_cardiac_rehab","title":"MA pbp section b3 cardiac rehab","domain":"medicare","stage":"silver","status":"partial","grain":"Section B3: Cardiac/pulmonary rehab cost-share. Renamed from CORF in 2020. Coverage: 2020-present.","description":"Section B3: Cardiac/pulmonary rehab cost-share. Renamed from CORF in 2020. Coverage: 2020-present.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b3_cardiac_rehab","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b3_corf","source_fqn":"medicare_silver.pbp_section_b3_corf","title":"MA pbp section b3 corf","domain":"medicare","stage":"silver","status":"partial","grain":"Section B3: Comprehensive Outpatient Rehab Facility (CORF) cost-share. Pre-2020; superseded by cardiac_rehab. Coverage: 2001-2019.","description":"Section B3: Comprehensive Outpatient Rehab Facility (CORF) cost-share. Pre-2020; superseded by cardiac_rehab. Coverage: 2001-2019.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b3_corf","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b4_emerg_urgent","source_fqn":"medicare_silver.pbp_section_b4_emerg_urgent","title":"MA pbp section b4 emerg urgent","domain":"medicare","stage":"silver","status":"partial","grain":"Section B4: Emergency / urgent care cost-share. Coverage: All years.","description":"Section B4: Emergency / urgent care cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b4_emerg_urgent","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b5_partial_hosp","source_fqn":"medicare_silver.pbp_section_b5_partial_hosp","title":"MA pbp section b5 partial hosp","domain":"medicare","stage":"silver","status":"partial","grain":"Section B5: Partial hospitalization cost-share. Coverage: All years.","description":"Section B5: Partial hospitalization cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b5_partial_hosp","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b6_home_health","source_fqn":"medicare_silver.pbp_section_b6_home_health","title":"MA pbp section b6 home health","domain":"medicare","stage":"silver","status":"partial","grain":"Section B6: Home health cost-share. Coverage: All years.","description":"Section B6: Home health cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b6_home_health","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b7_health_prof","source_fqn":"medicare_silver.pbp_section_b7_health_prof","title":"MA pbp section b7 health prof","domain":"medicare","stage":"silver","status":"partial","grain":"Section B7: Health professional services (PCP/specialist) cost-share. Wide schema. Coverage: All years.","description":"Section B7: Health professional services (PCP/specialist) cost-share. Wide schema. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b7_health_prof","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b8_clin_diag_ther","source_fqn":"medicare_silver.pbp_section_b8_clin_diag_ther","title":"MA pbp section b8 clin diag ther","domain":"medicare","stage":"silver","status":"partial","grain":"Section B8: Clinical/diagnostic/therapeutic services cost-share. Coverage: All years.","description":"Section B8: Clinical/diagnostic/therapeutic services cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b8_clin_diag_ther","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b9_outpat_hosp","source_fqn":"medicare_silver.pbp_section_b9_outpat_hosp","title":"MA pbp section b9 outpat hosp","domain":"medicare","stage":"silver","status":"partial","grain":"Section B9: Outpatient hospital cost-share. Coverage: All years.","description":"Section B9: Outpatient hospital cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_b9_outpat_hosp","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_c","source_fqn":"medicare_silver.pbp_section_c","title":"MA pbp section c","domain":"medicare","stage":"silver","status":"partial","grain":"Section C: Out-of-pocket maximums + optional supplemental benefits. 226 cols. Coverage: All years.","description":"Section C: Out-of-pocket maximums + optional supplemental benefits. 226 cols. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_c","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_c_oon","source_fqn":"medicare_silver.pbp_section_c_oon","title":"MA pbp section c oon","domain":"medicare","stage":"silver","status":"partial","grain":"Section C OON: Out-of-network cost-share detail. Coverage: All years (plans with OON only).","description":"Section C OON: Out-of-network cost-share detail. Coverage: All years (plans with OON only).","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_c_oon","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_c_pos","source_fqn":"medicare_silver.pbp_section_c_pos","title":"MA pbp section c pos","domain":"medicare","stage":"silver","status":"partial","grain":"Section C POS: Point-of-service cost-share detail. Coverage: All years (plans with POS only).","description":"Section C POS: Point-of-service cost-share detail. Coverage: All years (plans with POS only).","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_c_pos","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_d","source_fqn":"medicare_silver.pbp_section_d","title":"MA pbp section d","domain":"medicare","stage":"silver","status":"partial","grain":"Section D: Part D plan-level benefit detail. 463 cols (widest single file). Pharma use case.","description":"Section D: Part D plan-level benefit detail. 463 cols (widest single file). Pharma use case.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_d","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_d_oon","source_fqn":"medicare_silver.pbp_section_d_oon","title":"MA pbp section d oon","domain":"medicare","stage":"silver","status":"partial","grain":"Section D OON: Part D out-of-network cost-share. Coverage: All years.","description":"Section D OON: Part D out-of-network cost-share. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_d_oon","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_d_opt","source_fqn":"medicare_silver.pbp_section_d_opt","title":"MA pbp section d opt","domain":"medicare","stage":"silver","status":"partial","grain":"Section D opt: Part D optional supplemental drug benefits. Pre-2022 used `opts` spelling. Coverage: All years.","description":"Section D opt: Part D optional supplemental drug benefits. Pre-2022 used `opts` spelling. Coverage: All years.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_section_d_opt","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","Null numeric benefit amount is NOT $0 — apply docs/skills/pbp-semantics/SKILL.md.","Raw PBP is CMS-software-coded (era shifts, skip logic); for analysis prefer the cleaned vw_pbp_* views.","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_vbid_overlay","source_fqn":"medicare_silver.pbp_vbid_overlay","title":"MA pbp vbid overlay","domain":"medicare","stage":"silver","status":"partial","grain":"Union of 21-24 VBID overlay files. vbid_variant enum: {uf, ssbci, b19a_uf, b19a_ssbci, b19b_uf, b19b_ssbci, plain, discontinued_retained}. parent_section links to Section B (b13, b14, etc.). VBID introduced 2017; retained blanked 2026+.","description":"Union of 21-24 VBID overlay files. vbid_variant enum: {uf, ssbci, b19a_uf, b19a_ssbci, b19b_uf, b19b_ssbci, plain, discontinued_retained}. parent_section links to Section B (b13, b14, etc.). VBID introduced 2017; retained blanked 2026+.","identity_key":"contract_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage column.","PBP metadata/overlay; refresh-cadence only."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pbp_vbid_overlay","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["Coverage: 2001 → present (annual pre-2018 & 2025+; quarterly 2018-2024).","PBP metadata/overlay table (not a benefit-amount fact).","Row count unpinned."],"notes":"Grain-governed; live in Glue / query_substrate. Source family pbp_benefits.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_snp_data","source_fqn":"medicare_silver.snp_data","title":"MA snp data","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract, plan, segment) per month. Each row records plan enrollment count, plan_type (HMO/HMOPOS/PPO/PFFS/etc.), the SNP category (Chronic/Dual/Institutional), and for chronic-SNPs the specific specialty disease(s) the plan ta","description":"One row per (contract, plan, segment) per month. Each row records plan enrollment count, plan_type (HMO/HMOPOS/PPO/PFFS/etc.), the SNP category (Chronic/Dual/Institutional), and for chronic-SNPs the specific specialty disease(s) the plan ta","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column.","Standard CMS refresh cadence."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.snp_data","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["Coverage: 2007-05 onward, monthly; the newest month is max(report_month), loaded as CMS posts it (by the 15th).","Uncertified; grain-governed.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_snp_plan_details and get_enrollment read medicare_semantic.vw_snp_data_v3 (card medicare_snp_data_v3) over medicare_silver.snp_data_v2: the same plan rows and values plus the D-SNP integration columns, small-cell bounds and CMS's Under-11 rows (flagged). This table is the rollback."],"notes":"Grain-governed; live in Glue / query_substrate. Source family snp_data.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_snp_data_v2","source_fqn":"medicare_semantic.vw_snp_data_v2","title":"Special Needs Plans by plan and month, Plan ID at three digits","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_month); CMS repeats R1548-001 in 2022-07..2022-12.","description":"CMS's monthly SNP Comprehensive Report: every SNP plan since 2007-05 with SNP type (D-SNP, C-SNP, I-SNP), specialty diseases, enrollment and states, every row of medicare_silver.snp_data with plan_id at CMS's three-digit width (2022-01, 2022-09 and 2022-10 were stored unpadded); plan_id_legacy keeps the stored value.","identity_key":"contract_id,plan_id,segment_id","row_count":194930,"last_updated":"2026-10-01","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column.","Standard CMS refresh cadence."]},"raw_queryable_via":"Tool: get_enrollment (SNP type); Athena: medicare_semantic.vw_snp_data_v2","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-01 (Athena 3deff43e-6917-4adf-9283-040449d91ccc) from pipelines/medicare/semantic/snp_data_v2.sql over medicare_silver.snp_data; every row keeps source_url, sha256_content_hash, asserted_at.","known_gaps":["PLAN ID: three digits in every month here. medicare_silver.snp_data stores 3,263 ids without leading zeros in 2022-01, 2022-09 and 2022-10, where CMS wrote Plan ID as a number cell (defect SNPDATA-1 = SNPD-2); a month join to the enrollment tables matched 111 of ~1,198 plans there and matches 1,198 / 1,191 / 1,191 here (Athena 7bdbb2b6 -> d7b3c108).","SNP status is an annual designation: join on (contract_id, plan_id, year), deduplicating months and segments first.","Coverage: 2007-05 onward, monthly; the newest month is max(report_month), loaded as CMS posts it (by the 15th).","Uncertified; grain-governed.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_enrollment reads medicare_semantic.vw_snp_data_v3 WHERE NOT synthetic_under_11_row (card medicare_snp_data_v3), the same plan rows and values. This view is the rollback."],"notes":"Versioned view (Data Tracker small-served-fixes lane, 2026-10-01, defect SNPDATA-1, the same defect as the field dictionary's SNPD-2); the parser pads from its next load (snp_data_parser/v2). Record docs/reference/source-audit/source-mastery/records/medicare_snp_data.json (served_corrections).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_snp_data_revision3","source_fqn":"medicare_silver.snp_data_v2","title":"Special Needs Plans by plan and month, parse revision 3 (D-SNP integration status, small-cell bounds, Under-11 rows)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, segment_id, snp_type, state_list_raw, report_month) among is_current real rows; 195,628 current rows over 233 months 2007-05..2026-09 = the served 194,930 rows one for one plus CMS's 698 Under-11 rows (Athena a3e5cf73, 43cbe058).","description":"CMS's monthly SNP Comprehensive Report at parse revision 3: every SNP plan since 2007-05 with SNP type, specialty diseases, enrollment and states (Plan ID at three digits), plus the D-SNP integration status (CO / HIDE / FIDE, from 2022-07), applicable integrated plan, partial-dual-only and D-SNP-only-contract flags (from 2025-01), the [0, 10] bound on a blank enrollment cell, and CMS's Under-11 aggregate rows flagged synthetic_under_11_row. The tools read medicare_semantic.vw_snp_data_v3, this table's current vintage (card medicare_snp_data_v3).","identity_key":"contract_id,plan_id,segment_id","row_count":195628,"last_updated":"2026-10-05","freshness_sla":"Monthly (CMS posts by the 15th); the monthly load writes each file here as its CMS vintage.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column; cms_vintage_sequence counts CMS re-issues.","is_current marks the newest CMS vintage of each month."]},"raw_queryable_via":"Athena: medicare_silver.snp_data_v2 (WHERE is_current AND NOT synthetic_under_11_row for plans; pin report_month); prefer medicare_semantic.vw_snp_data_v3","provenance_chain_ref":"Iceberg table written 2026-10-05 by the restate_medicare_snp_data job (pipelines/medicare/ingest/snp_data_runner.py, snp_data_parser revision 3) from the held bronze ZIPs, one CMS vintage per write. Cell reconciliation PASS, 233 of 233 editions, 2,934,420 cells, 0 mismatches (docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). medicare_semantic.vw_snp_data_v3 (pipelines/medicare/semantic/snp_data_v3.sql) serves its current vintage. Rollback: medicare_semantic.vw_snp_data_v2 over the untouched medicare_silver.snp_data.","known_gaps":["UNDER-11 ROWS: contract_id 'Under-11', plan_id and segment_id '', one per SNP type and month (698 in 233 months; the 2023-08 Institutional row is missing from CMS's data table), plan_enrollment = the type's total over its blank plans (34,318 enrollee-months). A plan count or a plan total needs WHERE NOT synthetic_under_11_row.","CMS's printed Totals disagree with CMS's own rows in 22 months (2007-05..2008-05, 2017-08, 2019-05, 2022-07..12, 2023-08); never tie a figure to the printed Totals. Real rows sum to 750,705,067 enrollee-months, the served table's sum.","BLANK ENROLLMENT: NULL with plan_enrollment_lower_bound 0 and upper 10 (redacted_small_cell); 14,888 rows. The bound is [0, 10], not CMS's \"1 and 10\": CMS's own Under-11 totals show some blank plans are 0.","WHERE is_current: earlier CMS vintages of a month are kept beside the current one.","SNP status is an annual designation: join on (contract_id, plan_id, year), deduplicating months and segments first."],"notes":"Wave-1A reload (Data Tracker, docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md, defects SNPD-1/-3). Versioned, never overwritten; medicare_snp_data_v2 (vw_snp_data_v2) stays live as the rollback.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_snp_data_v3","source_fqn":"medicare_semantic.vw_snp_data_v3","title":"Special Needs Plans by plan and month, current CMS vintage, with D-SNP integration status, small-cell bounds and Under-11 rows","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, snp_type, state_list_raw, report_month) for real rows and one per (snp_type, report_month) for Under-11 rows; 195,628 rows over 233 months 2007-05..2026-09, 698 Under-11 rows, equal to medicare_silver.snp_data_v2 WHERE is_current row for row (Athena 0d8b8098, a97849fd).","description":"CMS's monthly SNP Comprehensive Report at parse revision 3, the current CMS vintage of each month: every SNP plan since 2007-05 with SNP type, specialty diseases, enrollment and states (Plan ID at three digits), the D-SNP integration status (CO / HIDE / FIDE, from 2022-07), applicable integrated plan, partial-dual-only and D-SNP-only-contract flags (from 2025-01), the [0, 10] bound on a blank enrollment cell, and CMS's Under-11 aggregate rows flagged synthetic_under_11_row. get_snp_plan_details and get_enrollment read this view from 2026-10-05.","identity_key":"contract_id,plan_id,segment_id","row_count":195628,"last_updated":"2026-10-05","freshness_sla":"Monthly (CMS posts by the 15th); a view over medicare_silver.snp_data_v2, so a new month appears when the load writes it.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage column."]},"raw_queryable_via":"Tools: get_snp_plan_details, get_enrollment (SNP type); Athena: medicare_semantic.vw_snp_data_v3 (WHERE NOT synthetic_under_11_row for plans; pin report_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW from pipelines/medicare/semantic/snp_data_v3.sql over medicare_silver.snp_data_v2 WHERE is_current (cell reconciliation PASS, 233 of 233 editions, 0 mismatches; docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). Rollback: medicare_semantic.vw_snp_data_v2 over the untouched medicare_silver.snp_data.","known_gaps":["UNDER-11 ROWS: contract_id 'Under-11', plan_id and segment_id '', one per SNP type and month (698), plan_enrollment = the type's total over its blank plans. A plan count or plan total needs WHERE NOT synthetic_under_11_row.","CMS's printed Totals disagree with CMS's own rows in 22 months (2007-05..2008-05, 2017-08, 2019-05, 2022-07..12, 2023-08); never tie a figure to the printed Totals. Real rows sum to 750,705,067 enrollee-months.","BLANK ENROLLMENT: NULL with bounds [0, 10] (redacted_small_cell); 14,888 rows.","SNP status is an annual designation: join on (contract_id, plan_id, year), deduplicating months and segments first.","2026-09 D-SNP: CO 667 / HIDE 314 / FIDE 101 rows, 6,486,024 members; the Dual-Eligible Under-11 row is 37."],"notes":"Versioned view (Data Tracker wave 1A, defects SNPD-1/-3). Never overwritten; vw_snp_data_v2 stays live as the rollback.","superseded_by":null,"tools":["get_stars_rollup"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_b19_combined_package","source_fqn":"medicare_semantic.vw_pbp_b19_combined_package","title":"PBP b19 combined package (cleaned view)","domain":"medicare","stage":"semantic_view","status":"partial","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned b19 combined package benefit.","description":"Cleaned source-faithful PBP b19 combined package rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning su","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_b19_combined_package","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/b19_combined_package/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_cardiac_pulmonary_rehab","source_fqn":"medicare_semantic.vw_pbp_cardiac_pulmonary_rehab","title":"PBP cardiac pulmonary rehab (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned cardiac pulmonary rehab benefit.","description":"Cleaned source-faithful PBP cardiac pulmonary rehab rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_cardiac_pulmonary_rehab","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/cardiac_pulmonary_rehab/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_clinical_diagnostic_therapeutic","source_fqn":"medicare_semantic.vw_pbp_clinical_diagnostic_therapeutic","title":"PBP clinical diagnostic therapeutic (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned clinical diagnostic therapeutic benefit.","description":"Cleaned source-faithful PBP clinical diagnostic therapeutic rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent r","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_clinical_diagnostic_therapeutic","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/clinical_diagnostic_therapeutic/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_dental","source_fqn":"medicare_semantic.vw_pbp_dental","title":"PBP dental (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned dental benefit.","description":"Cleaned source-faithful PBP dental rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for dent","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_dental","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/dental/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_dme","source_fqn":"medicare_semantic.vw_pbp_dme","title":"PBP dme (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned dme benefit.","description":"Cleaned source-faithful PBP dme rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for dme (vs","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_dme","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/dme/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_emergency_urgent","source_fqn":"medicare_semantic.vw_pbp_emergency_urgent","title":"PBP emergency urgent (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned emergency urgent benefit.","description":"Cleaned source-faithful PBP emergency urgent rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surfac","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_emergency_urgent","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/emergency_urgent/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_health_professionals","source_fqn":"medicare_semantic.vw_pbp_health_professionals","title":"PBP health professionals (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned health professionals benefit.","description":"Cleaned source-faithful PBP health professionals rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning su","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_health_professionals","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/health_professionals/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_hearing","source_fqn":"medicare_semantic.vw_pbp_hearing","title":"PBP hearing (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned hearing benefit.","description":"Cleaned source-faithful PBP hearing rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for hea","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_hearing","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/hearing/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_home_health","source_fqn":"medicare_semantic.vw_pbp_home_health","title":"PBP home health (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned home health benefit.","description":"Cleaned source-faithful PBP home health rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_home_health","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/home_health/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_inpatient_hospital","source_fqn":"medicare_semantic.vw_pbp_inpatient_hospital","title":"PBP inpatient hospital (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned inpatient hospital benefit.","description":"Cleaned source-faithful PBP inpatient hospital rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surf","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_inpatient_hospital","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/inpatient_hospital/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_inpatient_psychiatric","source_fqn":"medicare_semantic.vw_pbp_inpatient_psychiatric","title":"PBP inpatient psychiatric (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned inpatient psychiatric benefit.","description":"Cleaned source-faithful PBP inpatient psychiatric rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning s","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_inpatient_psychiatric","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/inpatient_psychiatric/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_moop","source_fqn":"medicare_semantic.vw_pbp_moop","title":"PBP moop (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned moop benefit.","description":"Cleaned source-faithful PBP moop rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for moop (","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_moop","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/moop/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_otc","source_fqn":"medicare_semantic.vw_pbp_otc","title":"PBP otc (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned otc benefit.","description":"Cleaned source-faithful PBP otc rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for otc (vs","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_otc","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/otc/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_outpatient_hospital","source_fqn":"medicare_semantic.vw_pbp_outpatient_hospital","title":"PBP outpatient hospital (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, outpatient_hospital_sub_benefit). quarter is the CMS release within the plan year. Plan years 2018, 2019 and 2023 hold 4 releases of every plan, 2020 and 2024 hold 3, 2022 holds 2; the other years hold 1. So for one plan year, keep only the latest release before you count or sum: rows with quarter = the highest quarter for that contract_id, plan_id, segment_id and report_year (then the highest version). Measured 2026-10-13 on serving v20261011b (Athena 9d5f8743-16b8-493f-a154-42a88608936a): CY2023 has 186,030 rows over 46,596 plan-segment-sub-benefits. Candidate v20261013a (not served yet) keeps one release per plan year in the view itself.","description":"Cleaned source-faithful PBP outpatient hospital rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning sur","identity_key":"contract_id,plan_id,segment_id,report_year,quarter,outpatient_hospital_sub_benefit","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_outpatient_hospital","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified.","Several releases per plan year (trap pbp_outpatient_one_release_per_plan_year): 2018-2020 and 2022-2024 repeat every plan 2-4 times, once per CMS quarterly release, so a count or sum over a plan year without the release pin is 2-4x (CY2023: 186,030 rows, 46,596 after the pin). Pin the latest release per plan year. A few plans changed a value between releases (H3388-014 2020: $0 in Q1, $350 in Q4); the latest release is the one to read. Fixed in the view by candidate v20261013a (created and railed 2026-10-13, not served until its pointer is applied)."],"notes":"Cleaned PBP reasoning surface (categories/outpatient_hospital/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year"],"unmapped_key_tokens":["outpatient_hospital_sub_benefit","quarter"],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_partb_rx_drugs","source_fqn":"medicare_semantic.vw_pbp_partb_rx_drugs","title":"PBP partb rx drugs (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned partb rx drugs benefit.","description":"Cleaned source-faithful PBP partb rx drugs rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_partb_rx_drugs","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/partb_rx_drugs/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_partd_drugs","source_fqn":"medicare_semantic.vw_pbp_partd_drugs","title":"PBP partd drugs (cleaned view)","domain":"medicare","stage":"semantic_view","status":"partial","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned partd drugs benefit.","description":"Cleaned source-faithful PBP partd drugs rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_partd_drugs","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/partd_drugs/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_partd_tier","source_fqn":"medicare_semantic.vw_pbp_partd_tier","title":"PBP partd tier (cleaned view)","domain":"medicare","stage":"semantic_view","status":"partial","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned partd tier benefit.","description":"Cleaned source-faithful PBP partd tier rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_partd_tier","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/partd_tier/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_partial_hospitalization","source_fqn":"medicare_semantic.vw_pbp_partial_hospitalization","title":"PBP partial hospitalization (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned partial hospitalization benefit.","description":"Cleaned source-faithful PBP partial hospitalization rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_partial_hospitalization","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/partial_hospitalization/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_preventive","source_fqn":"medicare_semantic.vw_pbp_preventive","title":"PBP preventive (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned preventive benefit.","description":"Cleaned source-faithful PBP preventive rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_preventive","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/preventive/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_renal_dialysis","source_fqn":"medicare_semantic.vw_pbp_renal_dialysis","title":"PBP renal dialysis (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned renal dialysis benefit.","description":"Cleaned source-faithful PBP renal dialysis rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_renal_dialysis","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/renal_dialysis/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_section_c_pos_oon","source_fqn":"medicare_semantic.vw_pbp_section_c_pos_oon","title":"PBP section c pos oon (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned section c pos oon benefit.","description":"Cleaned source-faithful PBP section c pos oon rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surfa","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_section_c_pos_oon","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/section_c_pos_oon/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_snf","source_fqn":"medicare_semantic.vw_pbp_snf","title":"PBP snf (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned snf benefit.","description":"Cleaned source-faithful PBP snf rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for snf (vs","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_snf","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/snf/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_supplemental_other","source_fqn":"medicare_semantic.vw_pbp_supplemental_other","title":"PBP supplemental other (cleaned view)","domain":"medicare","stage":"semantic_view","status":"partial","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned supplemental other benefit.","description":"Cleaned source-faithful PBP supplemental other rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surf","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_supplemental_other","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/supplemental_other/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_transportation","source_fqn":"medicare_semantic.vw_pbp_transportation","title":"PBP transportation (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned transportation benefit.","description":"Cleaned source-faithful PBP transportation rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_transportation","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/transportation/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_vision","source_fqn":"medicare_semantic.vw_pbp_vision","title":"PBP vision (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment, plan_year) cleaned vision benefit.","description":"Cleaned source-faithful PBP vision rows: era-normalized, CMS codes decoded, with offered_status/numeric_amount_observability/null_amount_reason/annualization_policy/combined_limit_policy/confidence_tier. The agent reasoning surface for visi","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-06","freshness_sla":"CMS publication cadence; see coverage notes.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage column.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_vision","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","CONDITIONAL: offline-validated; live values not yet certified."],"notes":"Cleaned PBP reasoning surface (categories/vision/contract.yaml); raw is pbp_section_*.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_benefits","source_fqn":"medicare_semantic.vw_pbp_benefits","title":"MA Plan Benefit Package (PBP) — semantic view","domain":"medicare","stage":"semantic_view","status":"retired","grain":"One row per (contract_id, plan_id, segment, benefit, plan_year).","description":"Semantic view over the CMS Plan Benefit Package files — cost-sharing, benefits, and supplemental-benefit detail per MA plan. Apply the pbp-semantics skill before benefit analysis.","identity_key":"plan_id","row_count":null,"last_updated":"2026-01-01","raw_queryable_via":"Athena: medicare_semantic.vw_pbp_benefits","notes":"25-view semantic layer; see docs/skills/pbp-semantics/SKILL.md.","superseded_by":"No such table in Glue (measured 2026-09-28, glue.get_table EntityNotFound): the 25-view layer this card described is the per-benefit views medicare_semantic.vw_pbp_<benefit> (dental, vision, hearing, otc, moop, ... plan_premium, plan_deductible, meals, ambulance, supplemental_services, combined_supplemental, optional_package), each with its own card; the tool is get_pbp_benefit.","tools":[],"dataset_id":"ds_medicare_pbp","dataset_assignment_basis":"source_id_prefix","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:plan_id"],"entity_key_columns":{"cms:plan_id":["plan_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_plan_deductible","source_fqn":"medicare_semantic.vw_pbp_plan_deductible","title":"PBP plan deductible (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"Plan-level deductible per plan, segment and plan year from PBP section D, era-normalized.","identity_key":"contract_id,plan_id,segment_id","row_count":163670,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_plan_deductible","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_d.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2014-2026, 163,670 rows, measured 2026-09-28."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_d. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_dsnp_cost_share","source_fqn":"medicare_semantic.vw_pbp_dsnp_cost_share","title":"PBP D-SNP cost-share flag (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"The D-SNP zero-dollar cost-share flag (2017 on) and the legacy dual population code (2008-2016) per plan and plan year, from PBP section A. Filed design; not what a dual pays after Medicaid.","identity_key":"contract_id,plan_id,segment_id","row_count":18874,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_dsnp_cost_share","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_a.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2008-2026, 18,874 rows, measured 2026-09-28.","Two eras with different meaning: section_a_dsnp_zero_dollar_flag (2017-2026) and section_a_legacy_dsnp_population_code (2008-2016); never trend across them as one field."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_a. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_meals","source_fqn":"medicare_semantic.vw_pbp_meals","title":"PBP meals benefit (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"Post-discharge and chronic-condition meal benefits per plan and plan year, from PBP section B13c, with the raw filed meal fields kept.","identity_key":"contract_id,plan_id,segment_id","row_count":201488,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_meals","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_b13_other_services.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2001-2026, 201,488 rows, measured 2026-09-28."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_b13_other_services. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"vlada_benefit_vector","source_fqn":"medicare_semantic.vw_benefit_vector","title":"Vlada benefit vector, every MA plan's filed benefit design, one row per plan-segment-year, 2015 to 2026","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per contract_id x plan_id x segment_id x report_year (2015-2026), 72,414 rows, 1,457 contracts, 243 columns (63 metrics each with <metric>__status; measured 2026-09-29, Athena ae557f34). The pointer follows the current version (v20260929g, promoted 13:53Z, a deterministic build with the pre-2019 fills; 2019-2026 identical to e); S (PDP) contracts excluded.","description":"The one defined benefit set for analysis (Ben 2026-09-28; Benefits lane CH): the PBP filing of record read by the platform's own rule into 63 metrics from primary care to the OTC card, each with a status column (a NULL is never $0), the D-SNP design headline with <metric>__dual_effective on the Medicare A/B cost shares, the five clocks (benefit_design_year, rebate_payment_year, stars_rating_year_paid, enrollment_weight_month), product_type as one column, market and is_employer_group, plan_enrollment, prev_contract_plans from the crosswalk and yoy_break_metrics. Reproduces the platform's national series to the cent (10 of 33,488 fields differ; two 2024 plans where the vector is right per segment). Registry ops/sb_llm/benefit_vector_registry.yaml; doc docs/skills/pbp-semantics/BENEFIT-VECTOR.md.","identity_key":"contract_id,plan_id,segment_id,report_year","row_count":72414,"last_updated":"2026-09-29","freshness_sla":"A new version when a category view is promoted, the platform rule changes, or CMS posts a filing year.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin report_year; is_ma_type and NOT is_employer_group for an MA figure; never pool D-SNP with non-SNP."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_vector","provenance_chain_ref":"ops/sb_llm/benefit_vector.py over the PBP category views (register cms_ma_pbp), the Landscape, enrollment and crosswalk; versions in ops/sb_llm/benefit_vector_registry.yaml; table medicare_semantic.benefit_vector_v20260929e at s3://vlada-platform-raw/medicare/gold/benefit_vector/v20260929e/","known_gaps":["ENROLLMENT IS CONTRACT-PLAN GRAIN and repeats on every segment row: collapse segments to the plan (MAX, the platform's rule) or use segments_in_plan; never SUM plan_enrollment over segment rows.","A NULL metric is never $0; read <metric>__status first (offered_no_number, not_offered, not_filed, per_stay_design, year_not_carried and the others in the registry).","The vector differs from the county spine on purpose (telehealth high end, observation per day, medical supplies and outpatient mental health, $0 Part D deductible); dsnp_integration_status only from CY2023; lineage_id is NULL (no served MA lineage id; prev_contract_plans carries the crosswalk predecessor); stars_rating_year_paid is the Y-1 ratings."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_vector","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"vlada_benefit_vector_v2_ext","source_fqn":"medicare_semantic.vw_benefit_vector_v2_ext","title":"Vlada benefit vector v2 extension, 191 more benefit columns per plan-segment-year with a catalog status each","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per contract_id x plan_id x segment_id x report_year, 90,464 rows, report_year 2015-2027, 1,582 contracts, 187 columns (measured 2026-09-29, Athena 7c1728a2); exactly one row per live vector key 2015-2026, plus S contracts and 2027 Landscape keys the vector excludes. The pointer follows the current version (v20260929co, a materialized Parquet table behind it, 195 columns with 8 SNF filed-coinsurance columns added; a contract-year probe answers in about 2 s).","description":"The catalog v2 extension of the benefit vector (Benefits lane CI, 2026-09-29): every MA benefit the catalog names beyond the 63 vector metrics (core medical cost shares, Part D and the insulin caps, supplemental benefits, SSBCI, VBID, D-SNP facts, money anchors), each column with a catalog status in ops/sb_llm/benefit_catalog_v2.yaml (trusted / filed_only / held / not_in_filing) that says whether the number is served with a tie to the filing, filed but not yet tied, held elsewhere, or not in the filing at all. Doc docs/skills/pbp-semantics/BENEFIT-CATALOG-V2.md.","identity_key":"contract_id,plan_id,segment_id,report_year","row_count":90464,"last_updated":"2026-09-29","freshness_sla":"A new version with the vector's; the pointer moves only when Lane CI's gates are green.","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin report_year; join from the vector, never the reverse."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_vector_v2_ext","provenance_chain_ref":"ops/sb_llm/tools/benefit_vector_v2_ddl.py over the PBP category views (register cms_ma_pbp); DDL ops/sql/benefit_catalog_v2/; columns ops/sql/benefit_catalog_v2/vw_benefit_vector_v2_ext_v20260929ci.columns.json","known_gaps":["LEFT JOIN from vw_benefit_vector on contract_id, plan_id, segment_id, report_year, never the reverse: this view also carries S contracts and 2027 Landscape keys the vector excludes.","Read each column's catalog status (trusted / filed_only / held / not_in_filing) in ops/sb_llm/benefit_catalog_v2.yaml before quoting it; a filed_only column is the filing as read, not yet tied to the platform.","ssbci_offered is empty for 2022-2024 (the SSBCI view lacks the package type those years), not \"not offered\"."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_vector","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_fitness","source_fqn":"medicare_semantic.vw_pbp_fitness","title":"PBP fitness benefit (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category, fitness_sub_benefit) cleaned row; 171,479 rows, report_year 2012-2026, 1,594 contracts (measured 2026-09-29, Athena 24b0afde).","description":"Fitness benefits per plan and plan year from PBP section B14c: offered status, the fitness types (activity tracker, physical fitness, memory fitness), mandatory or optional, copay and coinsurance, the benefit amount with its period and annualized value, with the raw filed fields kept. Built by the benefits lane (Lane CI, 2026-09-29) as a versioned view; the bare name is a pointer to the newest version.","identity_key":"contract_id,plan_id,segment_id","row_count":171479,"last_updated":"2026-09-29","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_fitness","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is the PBP section B14c silver table named in source_silver_table.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (offered_status explains why) — docs/skills/pbp-semantics/SKILL.md.","Offered plan-segments whose B14c form files no copay on fitness carry a null copay, not $0 (Lane CI)."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp. Rows measured 2026-09-29 (Athena).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_worldwide","source_fqn":"medicare_semantic.vw_pbp_worldwide","title":"PBP worldwide emergency, urgent care and transport benefit (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row; 100,805 rows, report_year 2018-2026, 876 contracts (measured 2026-09-29, Athena 88ad3222).","description":"Worldwide coverage per plan and plan year from PBP section B4c: emergency, urgent care and emergency transport, each with offered status, copay minimum and maximum and coinsurance, plus the combined maximum with its period and annualized value. Built by the benefits lane (Lane CI, 2026-09-29; checked against raw B4C, 5,365 matched) as a versioned view; the bare name is a pointer to the newest version.","identity_key":"contract_id,plan_id,segment_id","row_count":100805,"last_updated":"2026-09-29","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_worldwide","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate; raw is the PBP section B4c silver table (source_pbp_section on every row).","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 — docs/skills/pbp-semantics/SKILL.md.","The view starts at report_year 2018; earlier filings do not carry the worldwide fields in this shape."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp. Rows measured 2026-09-29 (Athena).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_ambulance","source_fqn":"medicare_semantic.vw_pbp_ambulance","title":"PBP ambulance cost share (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"Ambulance cost share per plan and plan year, from PBP section B10a, 2015 on.","identity_key":"contract_id,plan_id,segment_id","row_count":289486,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_ambulance","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_b10_amb_trans.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2015-2026, 289,486 rows, measured 2026-09-28."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_b10_amb_trans. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_supplemental_services","source_fqn":"medicare_semantic.vw_pbp_supplemental_services","title":"PBP supplemental services (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"Supplemental services (fitness, education, remote access and the other B14c/B13 items) per plan, service and plan year, with the CMS periodicity code decoded.","identity_key":"contract_id,plan_id,segment_id","row_count":486403,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_supplemental_services","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_b14_preventive.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2007-2026, 486,403 rows, measured 2026-09-28."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_b14_preventive. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_combined_supplemental","source_fqn":"medicare_semantic.vw_pbp_combined_supplemental","title":"PBP combined supplemental limit (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"The combined (pooled) supplemental benefit limit per plan and plan year from PBP section D, 2021 on: which benefits share one allowance and its periodicity.","identity_key":"contract_id,plan_id,segment_id","row_count":62702,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_combined_supplemental","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_d.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2021-2026, 62,702 rows, measured 2026-09-28.","A pooled allowance is not a per-benefit maximum; the OTC filing-form doctrine (docs/skills/pbp-semantics) says how to read it."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_d. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_combined_benefits_group","source_fqn":"medicare_semantic.vw_pbp_combined_benefits_group","title":"PBP combined benefit groups (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"The benefit groups pooled under one combined allowance per plan and plan year, from PBP section D, 2021 on.","identity_key":"contract_id,plan_id,segment_id","row_count":62626,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_combined_benefits_group","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_d.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2021-2026, 62,626 rows, measured 2026-09-28."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_d. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_optional_package","source_fqn":"medicare_semantic.vw_pbp_optional_package","title":"PBP optional supplemental packages (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"Optional supplemental packages (extra premium, opt-in) per plan and plan year from PBP section D-OPT, 2018 on; also reads the step 16/17b/18b worksheets where the package detail lives.","identity_key":"contract_id,plan_id,segment_id","row_count":51694,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_optional_package","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_d_opt.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2017-2026, 51,694 rows, measured 2026-09-28.","Reads pbp_step_16 / pbp_step_17b / pbp_step_18b for package detail; those step tables are worksheet intermediates and are not sources on their own."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_d_opt. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_optional_supplemental","source_fqn":"medicare_semantic.vw_pbp_optional_supplemental","title":"PBP optional supplemental premium and MOOP (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"Premium and MOOP of each optional supplemental package per plan and plan year from PBP section D-OPT, 2018 on.","identity_key":"contract_id,plan_id,segment_id","row_count":40968,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_optional_supplemental","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.pbp_section_d_opt.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2018-2026, 40,968 rows, measured 2026-09-28."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_pbp; raw is medicare_silver.pbp_section_d_opt. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_vw_pbp_plan_premium","source_fqn":"medicare_semantic.vw_pbp_plan_premium","title":"Plan premium by year, from the CMS Landscape (cleaned view)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_year, quarter, benefit_category) cleaned row.","description":"Monthly premium per plan and year, 2007 to 2027, built from the CMS Landscape (not the PBP filing): consolidated, Part C and Part D premium, the Part B premium reduction, and monthly_premium_basis naming which Landscape leg the number came from. Evidence grade cms_published.","identity_key":"contract_id,plan_id,segment_id","row_count":81375,"last_updated":"2026-09-28","freshness_sla":"CMS publication cadence (annual, plan-year aligned).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the filing year the row is true of.","A null numeric benefit amount is NOT $0 (see docs/skills/pbp-semantics/SKILL.md); this recollection block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pbp_plan_premium","commercial_terms":"Public CMS data.","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url on every row); raw is medicare_silver.fact_ma_landscape.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Null numeric benefit amount is NEVER $0 (null_amount_reason explains why) — docs/skills/pbp-semantics/SKILL.md.","consumer_document_reconciliation_status defaults not_checked; source-faithful != consumer-verified.","Not on the register until 2026-09-28 (built by the benefits lane 2026-09-24 as a versioned view; the bare name is a pointer to the newest version). Holds report_year 2007-2027, 81,375 rows, measured 2026-09-28.","SOURCE IS THE LANDSCAPE, NOT THE FILING: every row carries source_silver_table = medicare_silver.fact_ma_landscape and normalization_basis = cms_landscape_monthly_premium; the 2027 rows (5,561, 638 contracts, qid 573e3645) are the CY2027 Landscape, posted before the CY2027 PBP filing. On a D-SNP the premium is the plan design, not what a dual pays. Carry monthly_premium_basis on every read."],"notes":"Cleaned PBP reasoning surface; register source cms_ma_landscape; raw is medicare_silver.fact_ma_landscape. Rows measured 2026-09-28 (Athena).","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_landscape","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"vlada_medicare_benchmark_effective","source_fqn":"vlada_curated.vw_medicare_benchmark_effective","title":"Medicare benchmark, effective-dated (what Medicare would have paid on a date)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (billing_code, billing_class, facility_class, pfs_modifier, effective_period_start): the Medicare allowed amount in force from that date.","description":"The effective-dated Medicare benchmark: the allowed amount per billing code and setting for every effective period since 2001 (93 monthly periods), with the source schedule (PFS, OPPS, ASC, CLFS, DME) and the rate semantics. The current-only view vlada_curated.vw_medicare_benchmark is a projection of this; use this one for 'what would Medicare have paid on this date'.","identity_key":"billing_code,billing_class,facility_class,pfs_modifier,effective_period_start","row_count":1077582,"last_updated":"2026-09-28","freshness_sla":"Follows the underlying fee schedules (annual and quarterly).","recollection":{"cadence":"quarterly","watermark_field":"effective_period_start","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'effective_period_start' is the column the edition rides on.","Registered 2026-09-28 after the W2 inventory found it live in Glue and on no register; rows and years measured that day."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_medicare_benchmark_effective","provenance_chain_ref":"Measured 2026-09-28 on Athena (product lane W2 inventory, docs/offering/inventory).","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["One benchmark per (code, setting, date); never sum across settings.","Pin effective_period_start <= date < effective_period_end for an as-of answer; the current-only view answers 'today' only."],"notes":"Product lane 2026-09-28: 1,077,582 rows, effective periods 2001-01-01 to 2026-07-01 (93), measured on Athena. Register source vlada_w2_medicare_benchmarks.","superseded_by":null,"tools":["medicare_allowed"],"dataset_id":"vlada_w2_medicare_benchmarks","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["billing_class","billing_code","effective_period_start","facility_class","pfs_modifier"],"backing_store":"glue"},{"source_id":"vlada_ipps_hospital_base","source_fqn":"vlada_curated.vw_ipps_hospital_base","title":"IPPS hospital base payment per DRG weight, by hospital and fiscal year","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (fiscal_year, ccn): the hospital's wage-adjusted operating base, capital base, and base payment per DRG weight.","description":"Each IPPS hospital's payment base per DRG weight for a fiscal year, from the standardized amounts and its wage index: multiply by a DRG's relative weight for the unadjusted payment. FY2006 to FY2026.","identity_key":"fiscal_year,ccn","row_count":81029,"last_updated":"2026-09-28","freshness_sla":"Annual, with the IPPS final rule.","recollection":{"cadence":"annual","watermark_field":"fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fiscal_year' is the column the edition rides on.","Registered 2026-09-28 after the W2 inventory found it live in Glue and on no register; rows and years measured that day."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_ipps_hospital_base","provenance_chain_ref":"Measured 2026-09-28 on Athena (product lane W2 inventory, docs/offering/inventory).","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["FY2027 waits on the FY2027 standardized amounts and wage index (not loaded as of 2026-09-28; tracker mission medicare-fy2027-ipps-tables).","Excludes outlier, DSH, IME and other add-ons; a base, not a full claim payment."],"notes":"Product lane 2026-09-28: 81,029 rows, FY2006-FY2026, measured on Athena. Register source vlada_w2_medicare_benchmarks.","superseded_by":null,"tools":[],"dataset_id":"vlada_w2_medicare_benchmarks","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":["fiscal_year"],"backing_store":"glue"},{"source_id":"medicare_clfs_locality_rates","source_fqn":"medicare_silver.medicare_clfs_locality_rates","title":"Clinical Laboratory Fee Schedule, local amounts by carrier locality","domain":"medicare","stage":"silver","status":"live","grain":"One row per (release_label, hcpcs_code, modifier, carrier, locality): the local fee amounts and national limit for a lab code.","description":"The CLFS by carrier locality: base fee, national limitation amount, median and pricing amount at the 60% and 62% levels, with the gap-fill indicator, per release. The national table (fact_clfs_national_rate) holds the limit only; this holds the local amounts.","identity_key":"release_label,hcpcs_code,modifier,carrier,locality","row_count":1051939,"last_updated":"2026-09-28","freshness_sla":"Quarterly with the CLFS release.","recollection":{"cadence":"quarterly","watermark_field":"release_label","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'release_label' is the column the edition rides on.","Registered 2026-09-28 after the W2 inventory found it live in Glue and on no register; rows and years measured that day."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicare_clfs_locality_rates","provenance_chain_ref":"Measured 2026-09-28 on Athena (product lane W2 inventory, docs/offering/inventory).","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Editions ride release_label (no calendar_year filter proven yet); pin one release per read.","Legacy loader (pre-envelope): no source_url / sha256 columns; provenance is the release label."],"notes":"Product lane 2026-09-28: 1,051,939 rows, measured on Athena. Register source cms_clfs_national_rates.","superseded_by":null,"tools":[],"dataset_id":"cms_clfs_national_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":["carrier","locality","modifier","release_label"],"backing_store":"glue"},{"source_id":"medicare_snf_cost_report_overall","source_fqn":"medicare_silver.snf_cost_report_overall","title":"SNF cost reports, overall","domain":"medicare","stage":"silver","status":"live","grain":"One row per (ccn, fy_year, rpt_rec_num): the facility's total cost, total charge and overall cost-to-charge ratio.","description":"Skilled nursing facility cost reports (HCRIS 2540-10), the whole-facility view: total cost, total charges, overall cost-to-charge ratio, with a plausibility flag.","identity_key":"ccn,fy_year,rpt_rec_num","row_count":14698,"last_updated":"2026-09-28","freshness_sla":"Annual, as HCRIS quarterly files post.","recollection":{"cadence":"quarterly","watermark_field":"fy_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fy_year' is the column the edition rides on.","Registered 2026-09-28 after the W2 inventory found it live in Glue and on no register; rows and years measured that day."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.snf_cost_report_overall","provenance_chain_ref":"Measured 2026-09-28 on Athena (product lane W2 inventory, docs/offering/inventory).","known_gaps":["Years not yet measured per row (no year axis found in the columns snapshot); measure before quoting a range.","A missing ratio is not a zero cost."],"notes":"Product lane 2026-09-28: 14698 rows, measured on Athena. Register source cms_hcris_non_hospital_forms (w5).","superseded_by":null,"tools":[],"dataset_id":"cms_hcris_non_hospital_forms","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":["fy_year","rpt_rec_num"],"backing_store":"glue"},{"source_id":"medicare_snf_cost_report_dept","source_fqn":"medicare_silver.snf_cost_report_dept","title":"SNF cost reports, by department","domain":"medicare","stage":"silver","status":"live","grain":"One row per (ccn, fy_year, cost_center_line, rpt_rec_num): the department's cost, charges and ratio.","description":"Skilled nursing facility cost reports (HCRIS 2540-10) by department: cost, charges and the cost-to-charge ratio per cost center line.","identity_key":"ccn,fy_year,rpt_rec_num","row_count":101717,"last_updated":"2026-09-28","freshness_sla":"Annual, as HCRIS quarterly files post.","recollection":{"cadence":"quarterly","watermark_field":"fy_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fy_year' is the column the edition rides on.","Registered 2026-09-28 after the W2 inventory found it live in Glue and on no register; rows and years measured that day."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.snf_cost_report_dept","provenance_chain_ref":"Measured 2026-09-28 on Athena (product lane W2 inventory, docs/offering/inventory).","known_gaps":["Years not yet measured per row (no year axis found in the columns snapshot); measure before quoting a range.","A missing ratio is not a zero cost."],"notes":"Product lane 2026-09-28: 101717 rows, measured on Athena. Register source cms_hcris_non_hospital_forms (w5).","superseded_by":null,"tools":[],"dataset_id":"cms_hcris_non_hospital_forms","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":["fy_year","rpt_rec_num"],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_inpatient_claim","source_fqn":"medicare_silver.cms_bsa_inpatient_claim","title":"CMS Basic Stand Alone sample claims: inpatient claims","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, inpatient claims: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":588415,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_inpatient_claim","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_outpatient_procedure","source_fqn":"medicare_silver.cms_bsa_outpatient_procedure","title":"CMS Basic Stand Alone sample claims: outpatient procedures","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, outpatient procedures: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":33086687,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_outpatient_procedure","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_carrier_line_item","source_fqn":"medicare_silver.cms_bsa_carrier_line_item","title":"CMS Basic Stand Alone sample claims: carrier (physician) line items","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, carrier (physician) line items: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":70536735,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_carrier_line_item","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_dme_line_item","source_fqn":"medicare_silver.cms_bsa_dme_line_item","title":"CMS Basic Stand Alone sample claims: DME line items","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, DME line items: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":5246166,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_dme_line_item","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_prescription_drug_event","source_fqn":"medicare_silver.cms_bsa_prescription_drug_event","title":"CMS Basic Stand Alone sample claims: Part D prescription drug events","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, Part D prescription drug events: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":50325988,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_prescription_drug_event","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_prescription_drug_profile","source_fqn":"medicare_silver.cms_bsa_prescription_drug_profile","title":"CMS Basic Stand Alone sample claims: Part D beneficiary drug profiles","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, Part D beneficiary drug profiles: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":null,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_prescription_drug_profile","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_chronic_condition","source_fqn":"medicare_silver.cms_bsa_chronic_condition","title":"CMS Basic Stand Alone sample claims: chronic conditions","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, chronic conditions: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":43367,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_chronic_condition","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_hha_beneficiary","source_fqn":"medicare_silver.cms_bsa_hha_beneficiary","title":"CMS Basic Stand Alone sample claims: home health beneficiary summaries","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, home health beneficiary summaries: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":135368,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_hha_beneficiary","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_hospice_beneficiary","source_fqn":"medicare_silver.cms_bsa_hospice_beneficiary","title":"CMS Basic Stand Alone sample claims: hospice beneficiary summaries","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, hospice beneficiary summaries: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":55473,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_hospice_beneficiary","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_snf_beneficiary","source_fqn":"medicare_silver.cms_bsa_snf_beneficiary","title":"CMS Basic Stand Alone sample claims: SNF beneficiary summaries","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, SNF beneficiary summaries: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":64886,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_snf_beneficiary","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_institutional_provider_beneficiary_summary","source_fqn":"medicare_silver.cms_bsa_institutional_provider_beneficiary_summary","title":"CMS Basic Stand Alone sample claims: institutional provider beneficiary summaries","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, institutional provider beneficiary summaries: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":null,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_institutional_provider_beneficiary_summary","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_physician_supplier_beneficiary_summary","source_fqn":"medicare_silver.cms_bsa_physician_supplier_beneficiary_summary","title":"CMS Basic Stand Alone sample claims: physician/supplier beneficiary summaries","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, physician/supplier beneficiary summaries: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":null,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_physician_supplier_beneficiary_summary","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_field","source_fqn":"medicare_silver.cms_bsa_field","title":"CMS Basic Stand Alone sample claims: the field dictionary","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, the field dictionary: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":null,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_field","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_cms_bsa_source_asset","source_fqn":"medicare_silver.cms_bsa_source_asset","title":"CMS Basic Stand Alone sample claims: the source-asset ledger","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of the CMS BSA public use file (row_values_json carries the published columns; native_grain names the file's own grain).","description":"The CMS Basic Stand Alone (BSA) Medicare claims public use files, the source-asset ledger: a 5% beneficiary sample, de-identified, 2008 to 2010. Claim-level and real, and old; the only claim-level Medicare data that is public.","identity_key":"source_asset_id,source_row_number","row_count":null,"last_updated":"2026-09-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_bsa_source_asset","notes":"Product lane 2026-09-28: registered from the W2 inventory. Register source cms_bsa_sample_claims (w2).","superseded_by":null,"tools":[],"dataset_id":"cms_bsa_sample_claims","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_enrollment_monthly_county","source_fqn":"medicare_silver.enrollment_monthly_county","title":"MA/Part D enrollment — CPSC county grain","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, state_code, county_fips, month) enrollment count.","description":"CMS CPSC (Contract/Plan/State/County) monthly MA + Part D enrollment at county grain. The substrate behind get_enrollment_trend and the MA enrollment-trend proof rail. Includes EGHP (flagged); excludes Original Medicare (FFS). County cells with <=10 enrollees are CMS-suppressed (`*`) and carried as bounds [1,10] via enrollment_lower_bound/upper_bound + suppression_reason_code='redacted_small_cell'.","identity_key":"contract_id","row_count":null,"last_updated":"2026-05-11","freshness_sla":"Monthly (CMS CPSC release, ~15th of each month).","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Watermark column is named report_month on the Athena path and observed_period on the pyiceberg path (same grain, not reconciled in code); CPSC releases ~15th of each month."]},"raw_queryable_via":"Tool: get_enrollment_trend; Athena: medicare_silver.enrollment_monthly_county","provenance_chain_ref":"medicare_source_registry_cache","known_gaps":["Month column referenced as observed_period (pyiceberg path) and report_month (Athena path); same grain, name not reconciled in code.","Publication gaps 2016-12 / 2021-06 / 2025-03 RESOLVED 2026-05-11 (corrected URLs ingested; see pipelines/medicare/data/gap_registry.yaml).","Pre/post-2018 grain pivot empirically falsified 2026-05-11; no era enforcement applied.","SCOPE TRAP (learned 2026-07-26): this table is MA + Part D INCLUDING standalone PDP. Summing a county unfiltered overstates \"MA members\" (an agent reported LA County = 1.5M; true Dec-2025 MA enrolled = 963,559). For county-level MA use medicare_silver.ma_state_county_penetration (MA-scoped, carries eligibles + penetration + the FIPS<->SSA crosswalk) or filter CPSC to MA contract types. See docs/context_library/medicare/MA-CODEX.md (T2).","REPOINTED 2026-10-07 (CPSC-1/2/3): get_county_view 1.2.1 and get_market_share 0.3.1 read medicare_semantic.vw_enrollment_monthly_county_v3 with in_revision3_table AND county_code_system = 'fips' (old vs new identical on Athena). This table drops the rows CMS publishes with no State, no Plan ID or no county code, and in 2008-06..2009-08 holds an SSA code in county_fips on 24,297 rows (six codes, none a real county FIPS). Kept live as the rollback; the monthly CPSC load still writes it."],"notes":"County form of the catalogued aggregate medicare_silver.fact_ma_enrollment (source_id medicare_ma_enrollment). row_count null (a code comment cites ~612M rows, not catalog-measured).","superseded_by":"medicare_semantic.vw_enrollment_monthly_county_v3 over medicare_silver.enrollment_monthly_county_v4 (CPSC parse revision 4, rebuilt from bronze 2026-10-07, #3244) for reading. This revision-3 table drops the rows CMS publishes with no State, no Plan ID or no county code (1,767,320 rows in 243 months, CPSC-1/2) and holds an SSA code in county_fips on 24,297 rows in 2008-06..2009-08 (CPSC-3). v3 with in_revision3_table = true returns exactly this table's rows and figures in every month (Athena 2a9288a2). Kept live as the rollback and as the table the monthly CPSC load writes.","tools":["get_landscape_benefit_change","get_landscape_exits","get_stars_rollup","prove_ma_enrollment_trend"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_enrollment_monthly_county_v2","source_fqn":"medicare_semantic.vw_enrollment_monthly_county_v2","title":"MA/Part D enrollment, CPSC county grain, parent names as CMS wrote them","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, state_code, county_fips, month) enrollment count.","description":"CMS CPSC (Contract/Plan/State/County) monthly MA and Part D enrollment at county grain: every row of medicare_silver.enrollment_monthly_county with parent_org_raw restored where CMS's mixed encodings garbled it, and the stored value kept in parent_org_raw_legacy.","identity_key":"contract_id","row_count":629025628,"last_updated":"2026-10-01","freshness_sla":"Monthly (CMS CPSC release, ~15th of each month).","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Watermark column is named report_month on the Athena path and observed_period on the pyiceberg path (same grain, not reconciled in code); CPSC releases ~15th of each month."]},"raw_queryable_via":"Tool: get_county_view (parent names); Athena: medicare_semantic.vw_enrollment_monthly_county_v2 (pin report_month and a partition range on observed_period)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-01 (Athena c352d0be-3519-4943-addf-cdc0e30dc9a6) from pipelines/medicare/semantic/enrollment_monthly_county_v2.sql over medicare_silver.enrollment_monthly_county LEFT JOIN medicare_silver.enrollment_text_correction_v1; every row keeps source_url, sha256_content_hash, asserted_at.","known_gaps":["NAMES: CMS's own text is restored in this view. medicare_silver.enrollment_monthly_county keeps 8 garbled values from CMS's mixed encodings (e.g. 'St. Paul’s Episcopal Home' 2021-03..2026-09, 'Medicare y Mucho Mßs', 'Advantra« Freedom'); here parent_org_raw carry the corrected text and <column>_legacy the stored value (defect ENRTXT-1, medicare_silver.enrollment_text_correction_v1, 61 values each proved from the bronze bytes).","Month column referenced as observed_period (pyiceberg path) and report_month (Athena path); same grain, name not reconciled in code.","Publication gaps 2016-12 / 2021-06 / 2025-03 RESOLVED 2026-05-11 (corrected URLs ingested; see pipelines/medicare/data/gap_registry.yaml).","Pre/post-2018 grain pivot empirically falsified 2026-05-11; no era enforcement applied.","SCOPE TRAP (learned 2026-07-26): this table is MA + Part D INCLUDING standalone PDP. Summing a county unfiltered overstates \"MA members\" (an agent reported LA County = 1.5M; true Dec-2025 MA enrolled = 963,559). For county-level MA use medicare_silver.ma_state_county_penetration (MA-scoped, carries eligibles + penetration + the FIPS<->SSA crosswalk) or filter CPSC to MA contract types. See docs/context_library/medicare/MA-CODEX.md (T2)."],"notes":"Versioned view (Data Tracker small-served-fixes lane, 2026-10-01, defect ENRTXT-1): 516,636 rows carry a corrected parent name; view minus table = 0 (Athena 63a1c21d). The table is unchanged; the decoder is fixed from the next load. Record docs/reference/source-audit/source-mastery/records/medicare_enrollment.json (served_corrections).","superseded_by":"medicare_semantic.vw_enrollment_monthly_county_v3 (2026-10-07) for reading: the same corrected parent names (every month x parent equal, Athena 52eb622d) over the revision-4 table, which also keeps the rows CMS publishes with no State, no Plan ID or no county code. Filter v3 to in_revision3_table = true for this view's rows. Kept live as the rollback; get_county_view read it until 1.2.1.","tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_enrollment_monthly_county_v4","source_fqn":"medicare_silver.enrollment_monthly_county_v4","title":"MA/Part D enrollment, CPSC county grain, every row CMS publishes (parse revision 4)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, state_code, county_fips, county_ssa, report_month) as CMS publishes it: 630,792,948 rows in 243 months, 2006-07..2026-09, 0 duplicate native keys in every month (Tracker run 20261007T010009Z-cd1f8a6d). plan_id is '' where CMS left Plan ID blank; state_code and county_fips are NULL where CMS left them blank.","description":"CMS CPSC (Contract/Plan/State/County) monthly MA and Part D enrollment, re-parsed from the bronze bytes the served table was built from (parse revision 4, defects CPSC-1/2/3). It keeps every row CMS publishes for a contract: blank FIPS with only an SSA code (county_code_system 'ssa'), blank State, no county code ('none'), blank Plan ID; an SSA code is never written into county_fips. Same columns as medicare_silver.enrollment_monthly_county plus county_code_system. Read it through medicare_semantic.vw_enrollment_monthly_county_v3, which adds in_revision3_table and the corrected parent names.","identity_key":"contract_id","row_count":630792948,"last_updated":"2026-10-07","freshness_sla":"Monthly (CMS CPSC release, ~15th of each month). New months reach this table through the medicare fleet's monthly CPSC job once the artifact publish carries the revision-4 writer (#3115, #3230); until then it stops at 2026-09.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage/currency column.","New months arrive only after the medicare artifact publish carries the revision-4 writer (#3115, #3230)."]},"raw_queryable_via":"Athena: medicare_semantic.vw_enrollment_monthly_county_v3 (preferred: in_revision3_table, corrected parent names); medicare_silver.enrollment_monthly_county_v4 (pin report_month and a partition range on observed_period)","provenance_chain_ref":"tools/medicare/rebuild_cpsc_v2_silver.py --all --schema-revision 4 --target-table enrollment_monthly_county_v4 --from-bronze --resume on the tracker cloud runner (tracker-runs/20261007T010009Z-cd1f8a6d, EXIT 0), from s3://vlada-platform-raw/medicare/bronze/cpsc_monthly_enrollment/<YYYY-MM>/ chosen by the served month's sha256. Acceptance (Athena 2a9288a2): in all 243 months the revision-3 projection equals the served table on rows, enrollees and both bound sums. Every row keeps source_url, sha256_content_hash, asserted_at (the rebuild date, 2026-10-07). Plan: docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md.","known_gaps":["ROWS ADDED vs the revision-3 table (1,767,320; Athena 4a81e2d4): 1,650,120 with a blank State and only an SSA code (Alaska's six boroughs CMS prints only with an SSA code, partial localities such as AZ 03101 Pinal (Partial), out-of-area and unknown residence; every month), 116,038 with a blank Plan ID (1833 HCPP, Pilot and 1876 Cost contracts, 2008-05..2010-08), 1,162 with a blank State and no county code. Filter in_revision3_table = true (in v3) to reproduce the pre-v4 county totals.","county_code_system: 'fips' rows join to a county spine; 'ssa' rows carry only county_ssa (county_fips NULL); 'none' rows carry no code. Any county / FIPS join keeps county_code_system = 'fips'.","parent_org_raw: the 2021-2026 UTF-8 names are decoded here, but CMS's 2007-2019 DOS glyphs remain (7 values, 516,844 rows); vw_enrollment_monthly_county_v3 corrects them.","asserted_at is the rebuild date (2026-10-07) on every row, not the date each month was first loaded.","SCOPE TRAP: MA + Part D including standalone PDP, as in the revision-3 table. For county MA use the penetration file or filter to MA contract types."],"notes":"Data Tracker wave-1A, CPSC-1/2/3 (#3115 code, #3244 rebuild and acceptance). The revision-3 table medicare_silver.enrollment_monthly_county is unchanged and stays the rollback.","superseded_by":null,"tools":["get_county_view","get_market_share"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_enrollment_monthly_county_v3","source_fqn":"medicare_semantic.vw_enrollment_monthly_county_v3","title":"MA/Part D enrollment, CPSC county grain, every published row with the revision-3 flag","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, state_code, county_fips, county_ssa, report_month): 630,792,948 rows in 243 months, 2006-07..2026-09 (2026-09: 3,398,007 rows, 3,387,662 with in_revision3_table; Athena fc666995).","description":"CMS CPSC monthly MA and Part D enrollment at county grain over medicare_silver.enrollment_monthly_county_v4, with CMS's parent names restored as in vw_enrollment_monthly_county_v2. in_revision3_table marks the rows the revision-3 table holds (plan_id <> '', state_code present, a county code present); county_code_system says whether a row carries a FIPS code ('fips'), only an SSA code ('ssa') or none ('none').","identity_key":"contract_id","row_count":630792948,"last_updated":"2026-10-07","freshness_sla":"Follows medicare_silver.enrollment_monthly_county_v4 (monthly once the fleet writes revision 4; through 2026-09 until then).","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_month' is the source's documented vintage/currency column."]},"raw_queryable_via":"Tools: get_county_view (1.2.1), get_market_share (0.3.1); Athena: medicare_semantic.vw_enrollment_monthly_county_v3 (pin report_month and a partition range on observed_period; in_revision3_table = true for the pre-v4 county totals; county_code_system = 'fips' for any county join)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-07 (Athena 7eefce9d) from pipelines/medicare/semantic/enrollment_monthly_county_v3.sql over medicare_silver.enrollment_monthly_county_v4 LEFT JOIN medicare_silver.enrollment_text_correction_v1; every row keeps source_url, sha256_content_hash, asserted_at.","known_gaps":["Filter in_revision3_table = true to reproduce the pre-v4 county totals; without it you also count members CMS published with no county or no plan (CPSC-1/2 fix). 2008-06 adds 10,096 rows and ~146K enrollees (5,828 blank Plan ID rows with 143,631 of them). With the filter, every month equals the revision-3 table on rows, enrollees and both bounds (Athena 2a9288a2), and at (month, state, county_fips, contract) grain v3 with county_code_system = 'fips' differs from it only on the 24,297 CPSC-3 rows (Athena fbc67999).","county_code_system ssa vs fips: a county or FIPS join keeps county_code_system = 'fips'. 'ssa' rows have county_fips NULL and the code in county_ssa (2008-06..2009-08 CPSC-3 rows also have in_revision3_table = true: the revision-3 table wrote these six SSA codes into county_fips); 'none' rows have no code.","Contract, parent and national totals without the filter include out-of-area and unknown-residence members; a state total built from state_code still leaves out the blank-State rows (CMS gives them no state).","SCOPE TRAP: MA + Part D including standalone PDP. For county MA use medicare_semantic.vw_ma_state_county_penetration_v4 or filter to MA contract types."],"notes":"Read path for county enrollment from 2026-10-07 (get_county_view 1.2.1, get_market_share 0.3.1, both with in_revision3_table AND county_code_system = 'fips'; old vs new identical on Athena). Supersedes vw_enrollment_monthly_county_v2 and medicare_silver.enrollment_monthly_county for reading; both stay live as the rollback.","superseded_by":null,"tools":["get_county_view","get_market_share"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_enrollment_monthly_plan","source_fqn":"medicare_silver.enrollment_monthly_plan","title":"MA/Part D enrollment — plan grain","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, month) plan-level enrollment count.","description":"CMS monthly MA and Part D enrollment at contract-plan-month grain. Direct guarded queries support plan-level population filters and as-reported parent rollups; SNP status comes from a separate membership source.","identity_key":"contract_id","row_count":null,"last_updated":"2026-05-13","freshness_sla":"Monthly (CMS enrollment release).","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","report_month is the verified monthly DATE field. The metadata review date is not a new ingestion watermark."]},"raw_queryable_via":"Athena read-only via query_substrate: medicare_silver.enrollment_monthly_plan","provenance_chain_ref":"medicare_source_registry_cache","known_gaps":["Plan-level MA vocabulary includes separate HMO and HMOPOS labels; do not copy the contract-summary six-type filter. Use the source-bound taxonomy in vlada/semantic/ma_enrollment.py.","Raw plan enrollment is not certified by query success. December 2024 contracts H7245, H2765 and H9104 disagree with contract-summary totals in the original CMS files; stored suppression lower bounds also do not fully reconcile. Preserve source-specific values and disclose discrepancies.","December 2016-2025 periods and unique plan keys were verified on 2026-09-11. This is not a full-history or current-freshness certification; verify other requested periods and the annual SNP membership join."],"notes":"Live guarded query execution and ten-year parent rollups verified; 300 as-reported parent labels and 1486 parent-year records. Evidence: docs/product/2026-09-11-studio-ma-source-bound.ACTUAL.json. Live means queryable, not analytically certified.","superseded_by":null,"tools":["get_enrollment","get_stars_rollup","prove_ma_enrollment_trend"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_enrollment_monthly_plan_v2","source_fqn":"medicare_semantic.vw_enrollment_monthly_plan_v2","title":"MA monthly enrollment by contract and plan, names as CMS wrote them","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, month) plan-level enrollment count.","description":"CMS Monthly Enrollment by Contract/Plan: every row of medicare_silver.enrollment_monthly_plan with organization, marketing, plan and parent names restored where CMS's mixed encodings garbled them; the stored values are kept in <column>_legacy.","identity_key":"contract_id","row_count":1416620,"last_updated":"2026-10-01","freshness_sla":"Monthly (CMS enrollment release).","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","report_month is the verified monthly DATE field. The metadata review date is not a new ingestion watermark."]},"raw_queryable_via":"Tool: get_enrollment; Athena: medicare_semantic.vw_enrollment_monthly_plan_v2 (pin report_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-01 (Athena d14e2693-14ac-4c62-a5b4-eee78441c0bc) from pipelines/medicare/semantic/enrollment_monthly_plan_v2.sql over medicare_silver.enrollment_monthly_plan LEFT JOIN medicare_silver.enrollment_text_correction_v1; every row keeps source_url, sha256_content_hash, asserted_at.","known_gaps":["NAMES: CMS's own text is restored in this view. medicare_silver.enrollment_monthly_plan keeps 43 garbled values from CMS's mixed encodings (e.g. 'St. Paul’s Episcopal Home' 2021-03..2026-09, 'Medicare y Mucho Mßs', 'Advantra« Freedom'); here organization_name_raw, organization_marketing_name_raw, plan_name_raw and parent_org_raw carry the corrected text and <column>_legacy the stored value (defect ENRTXT-1, medicare_silver.enrollment_text_correction_v1, 61 values each proved from the bronze bytes).","Plan-level MA vocabulary includes separate HMO and HMOPOS labels; do not copy the contract-summary six-type filter. Use the source-bound taxonomy in vlada/semantic/ma_enrollment.py.","Raw plan enrollment is not certified by query success. December 2024 contracts H7245, H2765 and H9104 disagree with contract-summary totals in the original CMS files; stored suppression lower bounds also do not fully reconcile. Preserve source-specific values and disclose discrepancies.","December 2016-2025 periods and unique plan keys were verified on 2026-09-11. This is not a full-history or current-freshness certification; verify other requested periods and the annual SNP membership join."],"notes":"Versioned view (Data Tracker small-served-fixes lane, 2026-10-01, defect ENRTXT-1): 6,535 rows carry a corrected name; view minus table = 0 (Athena 63a1c21d). get_enrollment 0.3.0 reads it. Record docs/reference/source-audit/source-mastery/records/medicare_enrollment.json (served_corrections).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_plan_crosswalks_annual","source_fqn":"medicare_silver.plan_crosswalks_annual","title":"MA plan crosswalk — annual lineage (silver)","domain":"medicare","stage":"silver","status":"partial","grain":"Annual plan-crosswalk lineage edges across contract-years.","description":"CMS annual plan-crosswalk lineage (consolidations, renames, terminations) used by the MA enrollment-trend proof rail to stitch enrollment across plan-year boundaries. Pinned to its silver_published snapshot in the proof receipt's lineage_table slot.","identity_key":"contract_id","row_count":null,"last_updated":"2026-05-13","raw_queryable_via":"Tools: plan_ma_enrollment_trend_proof / prove_ma_enrollment_trend; Athena: medicare_silver.plan_crosswalks_annual","notes":"Annual-snapshot sibling of the catalogued medicare_silver.dim_plan_crosswalk (source_id medicare_plan_crosswalk). status=partial; schema not asserted beyond grain.","superseded_by":null,"tools":["get_county_view","get_landscape_benefit_change","get_landscape_exits","prove_ma_enrollment_trend"],"dataset_id":"cms_ma_plan_crosswalk","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_monthly_contract_enrollment_summary","source_fqn":"medicare_silver.monthly_contract_enrollment_summary","title":"MA enrollment — monthly contract summary","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, report_month) — CMS Monthly Enrollment by Contract (member counts). CERTIFIED 2026-06-03.","description":"CMS \"Monthly Enrollment by Contract\" — member counts per MA/Part D contract per month (enrollment_count). The member-volume input for MA revenue (revenue ~= enrollment x county benchmark x risk x rebate share).","identity_key":"contract_id","row_count":198917,"last_updated":"2026-06-03","freshness_sla":"Monthly (CMS enrollment release, by the 15th); the newest month is max(report_month).","recollection":{"cadence":"monthly","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Declared for snapshot-pinning; not directly read in current code (Phase 1 scaffolding) — watermark column not asserted beyond grain."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.monthly_contract_enrollment_summary","provenance_chain_ref":"M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["enrollment_count is NULL when CMS SUPPRESSED the cell (<11 members) — enrollment_lower/upper_bound carry the range. Null != 0 members.","CONTRACT-level; for PLAN-level use medicare_silver.enrollment_monthly_plan.","CARRIER ROLLUP: roll contract-level rows up to the parent/carrier on parent_org_raw, NEVER name-match organization_name (name-match badly undercounts: Humana via %HUMANA% = 37 contracts/$67.7B MLR, via parent_org_raw='Humana Inc.' = 48 contracts/$95.5B). parent_org_raw is the join key for rolling ANY contract-keyed MA source (mlr/payment/stars/hedis) up to the carrier.","parent_org_raw is TIME-VARYING (M&A/rebrands) — treat parent as AS-OF-DATE; pin a consistent report_month per year for a clean rollup.","COLUMN TRAP (learned 2026-07-26): enrollment_count (TOTAL) = ma_only_count (members WITHOUT drug coverage, ~8% of MA) + part_d_count (MA-PD). ma_only_count is NOT \"MA as opposed to PDP\" \\u2014 an agent summed it as national MA and reported 2.86M vs the true ~35.4M. TOTAL MA = SUM(enrollment_count) WHERE plan_type IN ('HMO/HMOPOS','Local PPO','Regional PPO','PFFS','MSA','Medicare-Medicaid Plan HMO/HMOPOS').","THIS TABLE ALSO CONTAINS NON-MA ROWS: standalone PDP (~23.5M members), Employer-direct PDP, PACE, 1876 Cost, HCPP. Excluding them is a WHERE clause on plan_type, never a column swap. Dec-2025 rails: national MA ~35.4M; PDP ~23.5M. See docs/context_library/medicare/MA-CODEX.md (D1/T1/T5)."],"notes":"CERTIFIED (product1-cert-ma-enrollment-v1) on 237 months through 2026-04 (e.g. 2026-04 Humana 3.73M members); months loaded after that are served but were not part of that certification.","superseded_by":null,"tools":["get_enrollment","get_stars_rollup","prove_ma_enrollment_trend"],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_monthly_contract_enrollment_summary_v2","source_fqn":"medicare_semantic.vw_monthly_contract_enrollment_summary_v2","title":"MA monthly enrollment by contract, names as CMS wrote them","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (contract_id, report_month) — CMS Monthly Enrollment by Contract (member counts). CERTIFIED 2026-06-03.","description":"CMS Monthly Enrollment by Contract: every row of medicare_silver.monthly_contract_enrollment_summary with organization, marketing and parent names restored where CMS's 2006-2019 files carry DOS glyphs; the stored values are kept in <column>_legacy.","identity_key":"contract_id","row_count":203758,"last_updated":"2026-10-01","freshness_sla":"Monthly (CMS enrollment release, by the 15th); the newest month is max(report_month).","recollection":{"cadence":"monthly","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Declared for snapshot-pinning; not directly read in current code (Phase 1 scaffolding) — watermark column not asserted beyond grain."]},"raw_queryable_via":"Tool: get_enrollment (contract grain); Athena: medicare_semantic.vw_monthly_contract_enrollment_summary_v2 (pin report_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-01 (Athena 99cd0c90-4b44-4f12-8d87-71d35257ff11) from pipelines/medicare/semantic/monthly_contract_enrollment_summary_v2.sql over medicare_silver.monthly_contract_enrollment_summary LEFT JOIN medicare_silver.enrollment_text_correction_v1; every row keeps source_url, sha256_content_hash, asserted_at.","known_gaps":["NAMES: CMS's own text is restored in this view. medicare_silver.monthly_contract_enrollment_summary keeps 10 garbled values from CMS's mixed encodings (e.g. 'St. Paul’s Episcopal Home' 2021-03..2026-09, 'Medicare y Mucho Mßs', 'Advantra« Freedom'); here organization_name_raw, organization_marketing_name_raw and parent_org_raw carry the corrected text and <column>_legacy the stored value (defect ENRTXT-1, medicare_silver.enrollment_text_correction_v1, 61 values each proved from the bronze bytes).","enrollment_count is NULL when CMS SUPPRESSED the cell (<11 members) — enrollment_lower/upper_bound carry the range. Null != 0 members.","CONTRACT-level; for PLAN-level use medicare_silver.enrollment_monthly_plan.","CARRIER ROLLUP: roll contract-level rows up to the parent/carrier on parent_org_raw, NEVER name-match organization_name (name-match badly undercounts: Humana via %HUMANA% = 37 contracts/$67.7B MLR, via parent_org_raw='Humana Inc.' = 48 contracts/$95.5B). parent_org_raw is the join key for rolling ANY contract-keyed MA source (mlr/payment/stars/hedis) up to the carrier.","parent_org_raw is TIME-VARYING (M&A/rebrands) — treat parent as AS-OF-DATE; pin a consistent report_month per year for a clean rollup.","COLUMN TRAP (learned 2026-07-26): enrollment_count (TOTAL) = ma_only_count (members WITHOUT drug coverage, ~8% of MA) + part_d_count (MA-PD). ma_only_count is NOT \"MA as opposed to PDP\" \\u2014 an agent summed it as national MA and reported 2.86M vs the true ~35.4M. TOTAL MA = SUM(enrollment_count) WHERE plan_type IN ('HMO/HMOPOS','Local PPO','Regional PPO','PFFS','MSA','Medicare-Medicaid Plan HMO/HMOPOS').","THIS TABLE ALSO CONTAINS NON-MA ROWS: standalone PDP (~23.5M members), Employer-direct PDP, PACE, 1876 Cost, HCPP. Excluding them is a WHERE clause on plan_type, never a column swap. Dec-2025 rails: national MA ~35.4M; PDP ~23.5M. See docs/context_library/medicare/MA-CODEX.md (D1/T1/T5)."],"notes":"Versioned view (Data Tracker small-served-fixes lane, 2026-10-01, defect ENRTXT-1): 1,452 rows carry a corrected name; view minus table = 0 (Athena 63a1c21d). Record docs/reference/source-audit/source-mastery/records/medicare_enrollment.json (served_corrections).","superseded_by":null,"tools":[],"dataset_id":"cms_ma_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_mlr","source_fqn":"medicare_silver.ma_mlr","title":"MA / Part-D Medical Loss Ratio (MLR)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (contract_id, contract_year). CMS MA/Part-D Medical Loss Ratio Public Use File, 4,984 rows across 2014-2023. Contract-level (no plan grain).","description":"The contract-level efficiency / profitability lens: adjusted_mlr (share of revenue spent on care + quality improvement vs admin/profit), remittance_amount (owed to CMS for missing the 0.85 floor), and in detailed years total_revenue, total_claims, member_months, the MLR numerator/denominator, and an incurred-claims split by supplemental benefit. The P&L input for the investor MA-VAT.","identity_key":"contract_id","row_count":4984,"last_updated":"2026-06-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_mlr","notes":"New source captured end-to-end (PRs","superseded_by":"medicare_silver.fact_ma_mlr (stamped re-collection 2026-09-07: same rows plus the provenance envelope (source_url, sha256_content_hash, asserted_at); the legacy table stays queryable until dropped)","tools":[],"dataset_id":"ds_medicare_ma","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_fact_ma_mlr","source_fqn":"medicare_silver.fact_ma_mlr","title":"CMS MA / Part D Medical Loss Ratio public-use files CY2014-CY2023, stamped","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract_year x contract; 4,984 rows over 10 contract years on 2026-09-07.","description":"The MLR public-use files re-collected through the provenance envelope on 2026-09-07 (identical row counts and spot values to the legacy ma_mlr). detail_available = 'true' marks the wide years (2014-2017, 2023) where every MLR report line is published; 2018-2022 carry only adjusted MLR and remittance. Strings; cast on read.","identity_key":"contract_id","row_count":4984,"last_updated":"2026-09-07","recollection":{"cadence":"annual","watermark_field":"contract_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'contract_year' is the MLR reporting year CMS names in the file; one release per contract_year, replaced whole on re-collection."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ma_mlr","provenance_chain_ref":"pipelines/medicare/ingest/ma_mlr_runner.py (job build_medicare_ma_mlr) from the CMS MLR page release zips (CY2014 under the legacy plan-payment path); header contracts pipelines/medicare/silver/ma_mlr_contracts.yaml; bronze medicare/bronze/cms_ma_mlr/","known_gaps":["Narrow years (2018-2022) publish five columns only; the wide-year detail columns are empty there by publisher design, not missing data.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_mlr reads medicare_silver.fact_ma_mlr_v2 (loader revision 2; card cms_fact_ma_mlr_v2): every cell here is unchanged there, and it adds the 39 report lines this table does not map. qi_fraud_reduction here is claims line 2.7 in 2014-2017 and QI line 4.8 in 2023 (MLR-2). This table is the rollback."],"notes":"New source captured end-to-end (PRs","superseded_by":null,"tools":[],"dataset_id":"cms_ma_mlr","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_fact_ma_mlr_v2","source_fqn":"medicare_silver.fact_ma_mlr_v2","title":"CMS MA / Part D Medical Loss Ratio public-use files CY2014-CY2023, loader revision 2 (every report line)","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract_year x contract among is_current rows; 4,984 rows over 10 contract years, the served table's rows one for one (Athena 0f0e7cdc).","description":"The MLR public-use files re-parsed from the held bytes with loader revision 2: every revision-1 column unchanged plus the 39 MLR report lines revision 1 never mapped (sequestration, premium reductions, risk corridor, reserves, incentive pools, fraud reduction and recoveries, the 2014-2017 Worksheet 2 lines, base credibility factor). detail_available = 'true' marks the wide years (2014-2017, 2023); 2018-2022 carry only adjusted MLR and remittance. Strings; cast on read. get_mlr reads this table from 2026-10-05.","identity_key":"contract_id","row_count":4984,"last_updated":"2026-10-05","recollection":{"cadence":"annual","watermark_field":"contract_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'contract_year' is the MLR reporting year CMS names in the file; is_current marks the newest vintage."]},"raw_queryable_via":"Tool: get_mlr; Athena: medicare_silver.fact_ma_mlr_v2 (WHERE is_current; pin contract_year)","provenance_chain_ref":"Iceberg table written 2026-10-05 by build_medicare_ma_mlr with revision 2 (pipelines/medicare/ingest/ma_mlr_runner.py) from the held bronze ZIPs. Cell reconciliation PASS, 10 of 10 editions, 498,400 cells, 0 mismatches, and every revision-1 cell equal to fact_ma_mlr (docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). Rollback: medicare_silver.fact_ma_mlr, untouched.","known_gaps":["FRAUD REDUCTION IS TWO LINES (MLR-2): qi_fraud_reduction holds claims line 2.7 'Allowable Fraud Reduction Expense' in 2014-2017 (inside total_claims) and QI line 4.8 'Fraud reduction activities' in 2023 (inside total_qi_expenses). Never sum it across those eras.","Cells CMS printed as SUPPRESSED (2023) are kept as text; five cells carry the word inside a number ('0.84SUPPRESSED99'); a cast gives NULL there, never zero, and nothing is imputed.","Narrow years (2018-2022) publish five columns only; the wide-year detail columns are empty there by publisher design.","WHERE is_current: the table keeps every CMS vintage of a contract year."],"notes":"Wave-1A reload (Data Tracker, docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md, defects MLR-1..3). Versioned, never overwritten; the legacy card stays live as the rollback.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_mlr","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hospital_cost_report_overall","source_fqn":"medicare_silver.hospital_cost_report_overall","title":"Hospital cost report — whole-hospital cost-to-charge (HCRIS 2552-10)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (ccn, fiscal-year-end). CMS Medicare Hospital Cost Report (HCRIS, form 2552-10) Worksheet C. 81,368 report-years, 6,949 hospitals, FY2010-2024.","description":"The whole-hospital ACTUAL-COST lens: overall_ccr (cost-to-charge ratio = total_cost / total_charge from Worksheet C). Applied to a billed charge it estimates the real cost of care. This is the COST leg reference-based-pricing vendors (Imagine360/ELAP) price against; joined to our MRF negotiated rate + Medicare it completes the cost / rate / Medicare / fair-RBP-price picture that no one else holds. Use the DEPT table for service-specific cost, this for the hospital-wide ratio.","identity_key":"ccn","row_count":81368,"last_updated":"2026-06-15","freshness_sla":"Annual (CMS HCRIS HOSP10 quarterly snapshot; reports lag ~12-21 months).","recollection":{"cadence":"annual","watermark_field":"fy_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fy_year' is the report's fiscal-year-end vintage.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: HCRIS lags 12-21 months and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_overall","commercial_terms":"Public CMS data.","provenance_chain_ref":"External CSV (OpenCSVSerde) from HCRIS HOSP10FY{year}.zip Worksheet C000001; cell-exact, A/B/C ties validated per fiscal year.","known_gaps":["CCR==1.0 SENTINEL: ~0.2% of hospitals (10 of 12 of them in New York, CCN prefix 33) file CHARGES AS COSTS (cost==charge), so overall_ccr pins to 1.000 across their entire history in fully-settled reports. est_cost = charge x 1.0 is NON-INFORMATIVE as a cost floor. The column charge_as_cost='true' flags these (|cost-charge|<1 or ccr>=0.99). EXCLUDE charge_as_cost='true' for any cost-floor analysis; it is NY-concentrated so it specifically contaminates Tri-State medians.","JOINS to our hospital MRF on ccn = hospital_ccn (vlada_curated.vw_fact_hospital_chargemaster_current); all 4,781 served hospitals match a cost report (100%).","CCR is a blunt average (~25-35% accurate at single-claim, reliable only aggregated to DRG/service level; Shwartz 1995). Use the DEPT grain for service-specific cost; overall_ccr overstates cost ~10x for low-CCR services like CT/MRI.","plausible=1 means 0.05<=overall_ccr<=2; rows outside that band (and charge_as_cost rows) should be screened. All columns are string (OpenCSVSerde): cast numerics on read.","rpt_status is the HCRIS settlement code; the highest rpt_rec_num per (ccn, fy_end) is the chosen version. FY2024 rows exist (a FY2023 file carries reports whose fiscal year ends in 2024)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hospital_cost_report_dept","source_fqn":"medicare_silver.hospital_cost_report_dept","title":"Hospital cost report — department cost-to-charge (HCRIS 2552-10 Worksheet C)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (ccn, fiscal-year-end, cost_center_line). 1,474,951 rows, 6,887 hospitals, FY2011-2024, 553 distinct cost centers.","description":"The SERVICE-SPECIFIC actual-cost lens, and the load-bearing one: dept_ccr (cost-to-charge ratio for one Worksheet C cost center). CCR spreads ~17x across departments (CT ~0.04 vs Clinic ~0.64), so a per-code cost estimate MUST use the service's own cost center via the HCPCS->cost-center crosswalk, never the hospital overall ratio. cost_center_label names the standard 2552-10 lines (Operating Room=50, CT=57, MRI=58, Cardiac Cath=59, Laboratory=60, Clinic=90, Emergency=91).","identity_key":"ccn","row_count":1474951,"last_updated":"2026-06-15","freshness_sla":"Annual (CMS HCRIS HOSP10 quarterly snapshot; reports lag ~12-21 months).","recollection":{"cadence":"annual","watermark_field":"fy_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fy_year' is the report's fiscal-year-end vintage.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: HCRIS lags 12-21 months and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_dept","commercial_terms":"Public CMS data.","provenance_chain_ref":"External CSV (OpenCSVSerde) from HCRIS HOSP10FY{year}.zip Worksheet C000001 col 9; every dept_ccr validated == col1/col8 per fiscal year.","known_gaps":["USE THE DEPARTMENT CCR, NEVER THE OVERALL. CCR varies ~17x across cost centers; using the overall or a wrong center overstates low-CCR service cost ~10x (the CT-vs-overall trap). Map a HCPCS/CPT to its cost_center_line via the crosswalk before applying dept_ccr.","cost_center_line is encoded as line x 100 (e.g. '05700'=line 57 CT, '09000'=line 90 Clinic, '05000'=line 50 OR); subscripted centers (e.g. '05701') roll under the parent line. cost_center_label is the human name.","CCR==1.0 SENTINEL same as the overall table: charge_as_cost='true' flags cost==charge non-informative filers (NY-concentrated). EXCLUDE them for cost-floor work.","E&M / professional-dominant codes (99xxx office visits -> Clinic center) carry a near-1.0 CCR because clinic cost is mostly professional labor with near-zero supply markup, so cost-plus floor ~= charge ~= rate and there is NO RBP arbitrage. The cost-plus lens applies to HIGH-MARKUP FACILITY services (imaging, surgery, lab); flag E&M as out-of-scope.","All columns are string (OpenCSVSerde): cast numerics on read. Joins to our MRF on ccn = hospital_ccn."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_facility_cost_report_unit","source_fqn":"medicare_silver.facility_cost_report_unit","title":"Facility cost reports — non-acute unit-cost metrics (HHA/hospice/ESRD/FQHC/RHC)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (facility_type, ccn, fiscal-year-end, worksheet line/service metric). 946,210 rows across HHA, hospice, ESRD, FQHC, and RHC HCRIS forms.","description":"The non-acute ACTUAL-COST unit lens. Most of these HCRIS forms do NOT publish a whole-facility cost-to-charge ratio; they publish cost per visit/day/treatment. Use computed_value as the direct unit cost, multiply by claim units/days/encounters, and pass it as direct_est_cost to the RBP kernel. Do not convert these rows into fake CCRs.","identity_key":"ccn","row_count":946210,"last_updated":"2026-06-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.facility_cost_report_unit","provenance_chain_ref":"ops/scripts/facility_hcris_cost_report_v1.py from CMS HCRIS HHA20FY{year}.ZIP, HOSPC14-REPORTS.ZIP, RNL11-REPORTS.ZIP, FQHC14-REPORTS.ZIP, and RHC17-REPORTS.ZIP; each reported unit value validated against total_cost / units where present.","known_gaps":["This table is a unit-cost table, not a CCR table. Hospice/ESRD/FQHC/RHC values are direct cost per day/treatment/visit; HHA Part I values are cost per visit by discipline.","Rows with validation_ok='false' are retained for audit but must not drive pricing. As of 2026-06-30 there are 5 source formula exceptions: 3 hospice rows and 2 ESRD rows.","All columns are string (OpenCSVSerde): cast numerics on read. The RBP lookup filters validation_ok='true' and plausible='true'.","Joining requires a real facility CCN. If upstream identity only has a 10-digit NPI fallback, this table must not be guessed onto the claim."],"notes":null,"superseded_by":"medicare_silver.fact_facility_cost_report_unit (stamped re-collection 2026-09-07: same rows and rules plus the provenance envelope (source_url, sha256_content_hash, asserted_at); the legacy table stays queryable until dropped)","tools":[],"dataset_id":"ds_medicare_facility","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_fact_facility_cost_report_unit","source_fqn":"medicare_silver.fact_facility_cost_report_unit","title":"Facility cost reports — non-acute unit-cost metrics, stamped (HHA/hospice/ESRD/FQHC/RHC)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (facility_type, ccn, fiscal-year-end, worksheet line/service metric); partitioned by partition_key = <form>_<fy_year>. 1,046,007 rows on 2026-09-07 across 57 form-years.","description":"The non-acute ACTUAL-COST unit lens, re-collected through the provenance envelope on 2026-09-07 (same cells, validation and plausibility rules as the legacy facility_cost_report_unit; every row carries source_url, sha256_content_hash, asserted_at). Use computed_value as the direct unit cost. Do not convert these rows into fake CCRs.","identity_key":"ccn","row_count":1046007,"last_updated":"2026-09-07","freshness_sla":"Annual/CMS HCRIS refresh; fiscal-year reports lag source operations.","recollection":{"cadence":"quarterly","watermark_field":"fy_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fy_year' is the report's fiscal-year-end vintage; CMS refreshes the all-years zips quarterly and HHA per fiscal year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_facility_cost_report_unit","provenance_chain_ref":"pipelines/medicare/ingest/hcris_non_hospital_runner.py (job build_medicare_hcris_non_hospital) from CMS HCRIS HHA20FY{year}.ZIP (per fiscal year) and HOSPC14 / RNL11 / FQHC14 / RHC17 -ALL-YEARS.zip; bronze medicare/bronze/cms_hcris_non_hospital_forms/; RDS registry medicare_source_registry_cache","known_gaps":["Unit-cost table, not a CCR table: hospice/ESRD/FQHC/RHC values are direct cost per day/treatment/visit; HHA Part I values are cost per visit by discipline.","Rows with validation_ok='false' are retained for audit and must not drive pricing (2 ESRD rows flagged on 2026-09-07).","All value columns are strings as published: cast numerics on read; filter validation_ok='true' and plausible='true'.","Joining requires a real facility CCN; never guess it onto an NPI."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_non_hospital_forms","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_facility_cost_report_ccr","source_fqn":"medicare_silver.facility_cost_report_ccr","title":"Facility cost reports — true non-acute cost-to-charge rows","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (facility_type, ccn, fiscal-year-end, worksheet line/service category) where the HCRIS form defines cost/charge/ratio cells. 26,021 rows, currently HHA Worksheet C Part II.","description":"The true non-acute CCR subset. HHA Worksheet C Part II supplies cost-to-charge ratios for medical supplies, vaccines/drugs, vaccine/drug administration, and covered disposable devices. Every row has computed_ratio = total_cost / total_charge validated against the reported ratio before it is eligible for pricing.","identity_key":"ccn","row_count":26021,"last_updated":"2026-06-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.facility_cost_report_ccr","provenance_chain_ref":"ops/scripts/facility_hcris_cost_report_v1.py from CMS HCRIS HHA20FY{year}.ZIP Worksheet C000000 Part II; 26,021/26,021 rows validated reported_ratio == total_cost/total_charge in Athena on 2026-06-30.","known_gaps":["Not a whole-HHA CCR. The form defines CCR rows only for specific supplies/drugs/devices service categories.","Rows flagged charge_as_cost='true' are non-informative and excluded from the RBP lookup.","All columns are string (OpenCSVSerde): cast numerics on read. The Athena max validation delta on 2026-06-30 was 5.000000058430487E-7."],"notes":null,"superseded_by":"medicare_silver.fact_facility_cost_report_ccr (stamped re-collection 2026-09-07: same rows and rules plus the provenance envelope (source_url, sha256_content_hash, asserted_at); the legacy table stays queryable until dropped)","tools":[],"dataset_id":"ds_medicare_facility","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_fact_facility_cost_report_ccr","source_fqn":"medicare_silver.fact_facility_cost_report_ccr","title":"Facility cost reports — HHA supplies/drugs/devices cost-to-charge rows, stamped","domain":"medicare","stage":"silver","status":"live","grain":"One row per (ccn, fiscal-year-end, HHA Worksheet C Part II line); partitioned by partition_key = hha_<fy_year>. 29,692 rows on 2026-09-07.","description":"HHA Worksheet C Part II cost-to-charge rows (medical supplies, vaccines/drugs, administration, covered disposable devices), re-collected through the provenance envelope on 2026-09-07 with the same validation and charge_as_cost rules as the legacy facility_cost_report_ccr. Not a whole-agency ratio.","identity_key":"ccn","row_count":29692,"last_updated":"2026-09-07","freshness_sla":"Annual/CMS HCRIS refresh; fiscal-year reports lag source operations.","recollection":{"cadence":"quarterly","watermark_field":"fy_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fy_year' is the report's fiscal-year-end vintage; HHA files are per fiscal year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_facility_cost_report_ccr","provenance_chain_ref":"pipelines/medicare/ingest/hcris_non_hospital_runner.py (job build_medicare_hcris_non_hospital) from CMS HCRIS HHA20FY{year}.ZIP; bronze medicare/bronze/cms_hcris_non_hospital_forms/","known_gaps":["HHA only; the other four forms publish no cost-to-charge lines.","Exclude charge_as_cost='true' rows (charges reported as costs) and rows with validation_ok='false' or plausible='false'.","All value columns are strings as published: cast on read."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_non_hospital_forms","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hospital_outpatient_volume","source_fqn":"medicare_silver.hospital_outpatient_volume","title":"Hospital outpatient facility VOLUME (Medicare, by provider & service)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (ccn, Comprehensive-APC, data_year). CMS Medicare Outpatient Hospitals by Provider & Service, 2015-2023. 892,793 rows, 3,773 hospitals.","description":"The FACILITY-side outpatient volume signal: per hospital (CCN), per Comprehensive APC, the service count (srvcs) and beneficiary count, plus average submitted charge / Medicare allowed / Medicare payment. The utilization weight for distributing a hospital's measured department cost across the services it actually performs. Joins to the cost reports on ccn (95% of its CCNs have a cost report).","identity_key":"ccn","row_count":892793,"last_updated":"2026-06-16","freshness_sla":"Annual (CMS Medicare Provider Utilization release, ~2-year lag).","recollection":{"cadence":"annual","watermark_field":"fy_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fy_year' is the data year; the release lags ~2 years.","freshness_threshold/expected_delta/stale_behavior intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_outpatient_volume","commercial_terms":"Public CMS data.","provenance_chain_ref":"ops/scripts/product1_medicare_outpatient_volume_v1.py — CMS metastore -> per-year CSV (schema stable across 2015-2023).","context_doc_path":"docs/context_library/medicare/hcris_cost_reports.md","known_gaps":["GRAIN IS COMPREHENSIVE-APC, NOT HCPCS. ~70 buckets, all bundled major outpatient PROCEDURES (surgery, endoscopy, vascular, cardiac, e.g. 'Level 3 Musculoskeletal Procedures'). Simple imaging, lab, ER and clinic are NOT in this file. For per-HCPCS or imaging/lab volume, pair with the physician PUF (vlada_curated.dim_provider_service, NPI-keyed, bridge NPI->CCN). Bridge HCPCS->APC via medicare_silver.medicare_opps_rates (carries both hcpcs_code and apc).","MEDICARE ONLY: counts are Medicare fee-for-service beneficiaries, not commercial. Use as the clean volume BACKBONE / mix prior; the commercial mix proxy is the chargemaster allowed_count (partial + needs cleaning).","Early years are thinner: the Comprehensive-APC program expanded 2015-2017 (DY2015 33k rows -> DY2017+ 110k), so service-line coverage grows over time. CMS suppresses cells with <11 beneficiaries. All columns string (OpenCSVSerde); cast on read."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_puf_outpatient_hospitals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_hcpcs_cost_center_crosswalk","source_fqn":"medicare_silver.hcpcs_cost_center_crosswalk","title":"HCPCS/CPT -> HCRIS cost-center crosswalk (the precision layer)","domain":"medicare","stage":"silver","status":"live","grain":"One row per HCPCS/CPT code. 28,328 codes -> their HCRIS 2552-10 Worksheet C cost center, so a code can be priced on the RIGHT department cost-to-charge ratio.","description":"The map that makes cost-based pricing accurate: each billing code -> the cost center where a hospital accumulates that service's cost (CT, MRI, Lab, OR, Clinic, ...). Derived from a 1.8-billion-row EMPIRICAL bridge (the modal UB-04 revenue code hospitals actually billed each code under, from our MRF) mapped through the authoritative CMS revenue-code -> cost-center spine, then adversarially validated by a sub-agent fleet (2,805 high-value codes). Join hcpcs -> cost_center_line, then use hospital_cost_report_dept for that center's CCR.","identity_key":"hcpcs","row_count":28328,"last_updated":"2026-06-15","freshness_sla":"Rebuilt when HCPCS code set or MRF revenue-code billing shifts.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Reference table; rebuilt on demand, no time vintage. watermark/threshold/delta intentionally null."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hcpcs_cost_center_crosswalk","commercial_terms":"Public CMS framework + our MRF-derived empirical bridge.","provenance_chain_ref":"ops/scripts/product1_hcris_crosswalk_v1.py: empirical modal revenue code -> CMS spine -> sub-agent fleet validation.","context_doc_path":"docs/context_library/medicare/hcris_cost_reports.md","known_gaps":["confidence + method tell you how each row was derived: empirical_rc (revenue-code bridge, high) > fleet_corrected/_confirmed (sub-agent validated) > structural (CPT-section guess, no revenue-code evidence) > unmapped. Filter on confidence for cost-floor work; ~46% of codes are confidence>=0.7.","is_em_professional='true' flags E&M / professional-dominant codes (99xxx) — their cost center has a near-1.0 CCR (no facility markup) so cost-plus RBP has no arbitrage; treat as out-of-scope, not a facility price.","cost_center_line 'PROF' = purely professional/physician work with no distinct facility cost center; '' = unmapped. Neither joins to a department CCR.","The empirical bridge reflects how hospitals ACTUALLY bill (modal revenue code), which can differ from a textbook CPT->cost-center mapping; modal_share is the strength of that signal. All columns are string (OpenCSVSerde)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_billing_code_vocabulary","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_plan_payment_part_c","source_fqn":"medicare_silver.ma_plan_payment_part_c","title":"MA plan payment — Part C (contract x plan x year)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (payment_year, contract_id, plan_id). 40,014 rows, 2015-2024.","description":"CMS Part C plan-payment summary: per MA contract+plan+year, the average risk-adjusted A/B payment per member per month (avg_ab_pmpm_payment), the average enrollee risk score (avg_part_c_risk_score), and the average rebate PMPM (avg_rebate_pmpm_payment). The revenue side of MA economics.","identity_key":"contract_id","row_count":40014,"last_updated":"2026-06-08","freshness_sla":"Annual (CMS plan payment data ZIPs; ~Feb of payment_year+2).","recollection":{"cadence":"annual","watermark_field":"payment_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'payment_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_plan_payment_part_c","provenance_chain_ref":"M-2 substrate.","known_gaps":["JOIN KEY is the composite (contract_id, plan_id, payment_year): within one payment_year, contract_id+plan_id alone is unique. identity_key=contract_id is only the rollup anchor, NOT the full grain.","Values are AVERAGES (PMPM / mean risk score), not a contract total: multiply by member-months (enrollment) to get dollars.","Roll up to carrier via parent_org_raw on monthly_contract_enrollment_summary, NEVER a name-match.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_plan_payment and get_ma_plan_payment read medicare_silver.ma_plan_payment_part_c_v2 (parser 0.4.0; card medicare_ma_plan_payment_part_c_v2): every value here is unchanged there, and it adds the 14 text rebates of 2006-2007 this table stores NULL and the MSA deposit 2006-2012. This table is the rollback."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_payment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_plan_payment_part_c_v2","source_fqn":"medicare_silver.ma_plan_payment_part_c_v2","title":"MA plan payment, Part C (contract x plan x year), parser 0.4.0","domain":"medicare","stage":"silver","status":"live","grain":"One row per (payment_year, contract_id, plan_id). 65,872 rows over 19 payment years 2006-2024, the served table's rows one for one (Athena 09c33b17, 2441fad6).","description":"CMS Part C plan-payment summary per MA contract, plan and payment year: the average A/B payment PMPM standardized to a 1.0 risk score (avg_ab_pmpm_payment, an amount, not the benchmark and not dollars paid), the average Part C risk score and the average rebate PMPM, plus the average MSA monthly deposit (2006-2012). Parser 0.4.0 reload of the same CMS workbooks; get_plan_payment and get_ma_plan_payment read this table from 2026-10-05.","identity_key":"contract_id","row_count":65872,"last_updated":"2026-10-05","freshness_sla":"Annual (CMS plan payment data ZIPs; ~Feb of payment_year+2).","recollection":{"cadence":"annual","watermark_field":"payment_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'payment_year' is the source's documented vintage/currency column.","A new payment year lands only after every earlier year is in the table (the versioned reload guard)."]},"raw_queryable_via":"Tools: get_plan_payment, get_ma_plan_payment; Athena: medicare_silver.ma_plan_payment_part_c_v2 (pin payment_year)","provenance_chain_ref":"Iceberg table written 2026-10-05 by tools/ingest_ma_plan_payment.py --backfill-history (parser 0.4.0) from the 19 CMS plan payment ZIPs; every member hashes to the served sha256_content_hash. Cell reconciliation PASS, 19 of 19 editions, 461,104 cells, 0 mismatches (docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). Rollback: medicare_silver.ma_plan_payment_part_c, untouched.","known_gaps":["Every value of the served table is unchanged (65,872 rows joined, 0 differences in payment, risk score or names; Athena 2441fad6) except 14 rebates of 2006-2007 the old parser stored NULL because CMS printed them as text ('$-0.46', '($0.46)'; MAPAY-2): H5434-002 2006 is -0.46 here. 0 NULL rebates in any year.","avg_msa_monthly_deposit_pmpm (MAPAY-4) is published for 2006-2012 (0 is a published zero for every non-MSA plan); from 2013 CMS does not print the column and it is NULL, which never means no deposit.","avg_ab_pmpm_payment is standardized to a 1.0 risk score (MAPAY-1, CMS Plan Payment Data Element document): multiply by the plan's risk score for the risk-adjusted amount.","JOIN KEY is the composite (contract_id, plan_id, payment_year); values are averages per member-month, not totals."],"notes":"Wave-1A reload (Data Tracker, docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md, defects MAPAY-2/-4). Versioned, never overwritten; the legacy card stays live as the rollback.","superseded_by":null,"tools":["get_quality_bonus"],"dataset_id":"cms_ma_plan_payment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_plan_payment_part_d","source_fqn":"medicare_silver.ma_plan_payment_part_d","title":"MA plan payment — Part D (plan x year)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (payment_year, contract_id, plan_id). 48,455 rows, 2015-2024.","description":"CMS Part D plan-payment reference: per plan+year averages of the federal subsidies CMS pays each MA-PD / standalone PDP (avg_direct_subsidy, avg_reinsurance, avg_low_income_cost_sharing) plus the plan's average Part D risk score (avg_part_d_risk_score).","identity_key":"contract_id","row_count":48455,"last_updated":"2026-06-08","freshness_sla":"Annual (CMS plan payment data ZIPs; ~Feb of payment_year+2).","recollection":{"cadence":"annual","watermark_field":"payment_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'payment_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_plan_payment_part_d","provenance_chain_ref":"M-2 substrate.","known_gaps":["JOIN KEY is the composite (payment_year, contract_id, plan_id): identity_key=contract_id is only the rollup anchor, NOT the full grain. (The auto-discovered glue stub mislabels the key as payment_year — this curated card corrects it.)","Covers MA-PD AND standalone PDP plans: filter by organization_type if you want MA-only.","Values are AVERAGES, not totals.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_plan_payment and get_ma_plan_payment read medicare_silver.ma_plan_payment_part_d_v2 (card medicare_ma_plan_payment_part_d_v2), which adds the 11 contract rows of 2006 flagged contract_level_row. This table is the rollback."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_payment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_plan_payment_part_d_v2","source_fqn":"medicare_silver.ma_plan_payment_part_d_v2","title":"MA plan payment, Part D (plan x year), parser 0.4.0","domain":"medicare","stage":"silver","status":"live","grain":"One row per (payment_year, contract_id, plan_id). 84,466 rows over 2006-2024: the served table's 84,455 rows one for one plus the 11 contract rows of 2006 (Athena 09c33b17, 2441fad6).","description":"CMS Part D plan-payment reference per plan and payment year: the average direct subsidy PMPM (standardized to a 1.0 risk score), reinsurance and low-income cost-sharing PMPMs and the average Part D risk score, for MA-PD and stand-alone PDP plans. Parser 0.4.0 reload; get_plan_payment and get_ma_plan_payment read this table from 2026-10-05.","identity_key":"contract_id","row_count":84466,"last_updated":"2026-10-05","freshness_sla":"Annual (CMS plan payment data ZIPs; ~Feb of payment_year+2).","recollection":{"cadence":"annual","watermark_field":"payment_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'payment_year' is the source's documented vintage/currency column.","A new payment year lands only after every earlier year is in the table (the versioned reload guard)."]},"raw_queryable_via":"Tools: get_plan_payment, get_ma_plan_payment; Athena: medicare_silver.ma_plan_payment_part_d_v2 (pin payment_year)","provenance_chain_ref":"Iceberg table written 2026-10-05 by tools/ingest_ma_plan_payment.py --backfill-history (parser 0.4.0). Cell reconciliation PASS, 19 of 19 editions, 591,262 cells, 0 mismatches (docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). Rollback: medicare_silver.ma_plan_payment_part_d, untouched.","known_gaps":["CONTRACT ROWS (MAPAY-3): in 2006 CMS printed 11 rows with a blank plan number (cost and chronic-care contracts such as H0502); they are served with plan_id '' and contract_level_row = true. They are contract figures: exclude them from any plan join (lpad('') would invent plan '000').","Every other value equals the served table (84,455 rows joined, 0 differences; Athena 2441fad6).","Covers MA-PD AND stand-alone PDP plans: filter organization_type for MA-only. Values are averages, not totals."],"notes":"Wave-1A reload (Data Tracker, docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md, defect MAPAY-3). Versioned, never overwritten; the legacy card stays live as the rollback.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_payment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_plan_payment_county","source_fqn":"medicare_silver.ma_plan_payment_county","title":"MA plan payment — county rollup","domain":"medicare","stage":"silver","status":"live","grain":"One row per (payment_year, ssa_county_code, plan_type, snp_plan_type). 140,291 rows, 2015-2024.","description":"CMS county-level summary of MA Part C payments and risk: average PMPM federal payment, average risk score, and average rebate dollars, broken out by county, plan type, and SNP type. The public benchmark for what Medicare pays MA plans in a county.","identity_key":"ssa_county_code","row_count":140291,"last_updated":"2026-06-08","freshness_sla":"Annual (CMS plan payment data ZIPs).","recollection":{"cadence":"annual","watermark_field":"payment_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'payment_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_plan_payment_county","provenance_chain_ref":"M-2 substrate.","known_gaps":["COUNTY grain, NOT contract-keyed: you CANNOT join this to contract-level sources directly. Bridge to a contract via its service-area counties (medicare_silver.ma_contract_service_area).","County code is the SSA county code (ssa_county_code), not FIPS: convert before joining to FIPS-keyed sources.","SUPERSEDED FOR READING (2026-10-05, wave-1A repoint): get_ma_plan_payment reads medicare_silver.ma_plan_payment_county_v2 (card medicare_ma_plan_payment_county_v2), which fills state_abbreviation on the 56,744 rows of 2006-2011 this table holds NULL and adds the MSA deposit 2006-2012. This table is the rollback."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_payment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["ssa_county_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_ma_plan_payment_county_v2","source_fqn":"medicare_silver.ma_plan_payment_county_v2","title":"MA plan payment, county rollup, parser 0.4.0","domain":"medicare","stage":"silver","status":"live","grain":"One row per (payment_year, ssa_county_code, plan_type, snp_plan_type). 232,368 rows over 2006-2024, the served table's rows one for one (Athena 09c33b17, 2441fad6).","description":"CMS county-level summary of MA Part C payments and risk by county, plan type and SNP type: average A/B payment PMPM (standardized to a 1.0 risk score), average risk score, average rebate PMPM and the average MSA monthly deposit (2006-2012). Parser 0.4.0 reload; get_ma_plan_payment (level county) reads this table from 2026-10-05.","identity_key":"ssa_county_code","row_count":232368,"last_updated":"2026-10-05","freshness_sla":"Annual (CMS plan payment data ZIPs).","recollection":{"cadence":"annual","watermark_field":"payment_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'payment_year' is the source's documented vintage/currency column.","A new payment year lands only after every earlier year is in the table (the versioned reload guard)."]},"raw_queryable_via":"Tool: get_ma_plan_payment (level county); Athena: medicare_silver.ma_plan_payment_county_v2 (pin payment_year)","provenance_chain_ref":"Iceberg table written 2026-10-05 by tools/ingest_ma_plan_payment.py --backfill-history (parser 0.4.0). Cell reconciliation PASS, 19 of 19 editions, 1,394,208 cells, 0 mismatches (docs/data-tracker/CELL-RECONCILIATION-WAVE1A-V2-2026-10-05.md). Rollback: medicare_silver.ma_plan_payment_county, untouched.","known_gaps":["STATE 2006-2011 (MAPAY-5): state_abbreviation is filled on all 56,744 rows of 2006-2011, where the served table holds NULL (CMS's header there reads 'State'). Every other value equals the served table (232,368 rows joined, 0 differences; Athena 2441fad6).","avg_msa_monthly_deposit_pmpm is published for 2006-2012 (0 is a published zero); from 2013 it is NULL because CMS does not print the column.","COUNTY grain keyed by the SSA county code, not FIPS, and not contract-keyed: bridge to a contract through its service-area counties."],"notes":"Wave-1A reload (Data Tracker, docs/data-tracker/RELOAD-PLAN-WAVE1A-MA-LOADERS-2026-10-01.md, defects MAPAY-4/-5). Versioned, never overwritten; the legacy card stays live as the rollback.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_payment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["ssa_county_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_dim_hcc_coefficients","source_fqn":"medicare_silver.dim_hcc_coefficients","title":"HCC risk-model coefficients (reference)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (rate_year, model_version, variable, segment) = one risk-model coefficient. 8,805 rows.","description":"CMS risk-adjustment COEFFICIENT tables (Part C HCC + Part D RxHCC). Each row is one numeric risk weight a CMS scoring engine multiplies against a member's 0/1 flag for a demographic cell or condition category, for a given payment year, model version, and population segment. A reference lookup, not contract data.","identity_key":"rate_year","row_count":8805,"last_updated":"2026-07-11","freshness_sla":"Annual (CMS risk-adjustment model updates).","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_hcc_coefficients","provenance_chain_ref":"M-2 substrate.","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Current table remains clean at 8,805 rows for payment years 2026-2027; historical coefficients are not served.","Archive recovery is complete for every payment year 2008-2025: 24 live CMS HTTP-200 artifacts, 18,151,638 bytes, zero misses, and SHA-256 pins under s3://vlada-platform-raw/medicare/bronze/hcc_coefficients_archive/py{YYYY}/; manifest: s3://vlada-platform-raw/medicare/bronze/hcc_coefficients_archive/acquisition_manifest_2026-07-11.json.","Format ground truth: NO XLS/CSV exists. Coefficients ship as fixed-width .TXT relative-factor tables with C####/F#### members inside nested SAS model-software zips; PDF duplicates ride along.","Model-version matrix: V12 era PY2008-2015; V21 first appears PY2013; V22 PY2014; V23 blend PY2019; V24 first PY2020; V28 first PY2024; 33/67 phase-in confirmed in Rate Announcement text. ESRD + RxHCC sub-packages are bundled in the same outer zips for 2009-2025.","Exact deferred lane: fixed-width SAS-text C####/F#### parser adapters plus model-version x payment-year x population-segment acceptance for community/institutional/new-enrollee segments, ESRD dialysis/graft semantics, RxHCC, explicit PACE in/out, and ICD-9-era mapping pre-2016; then per-year dry-run expected counts, zero duplicate certified keys, and idempotent rerun proof. Consumers must not read historical coefficients until this acceptance (MA risk-score math guard).","Source limits: PY2008 RxHCC has no year-specific artifact (nearest 2006/2007-vintage files); PY2010 standalone ESRD is covered only by combined ESRD_2010_2011_Software.zip published under PY2011. Normalization factors are not in these files and require a separate authoritative source decision.","REFERENCE table (not contract-keyed): the lookup key is the composite (variable, model_version, rate_year, segment) and all four grain columns are required.","Reached from dim_icd10_hcc_crosswalk: map a diagnosis to its hcc_category there, then join here on (hcc/variable, model_version, rate_year) to get the weight.","Layer-2 tool: get_risk_model.","REPOINTED 2026-10-07: the Layer-2 tool above (get_risk_model 0.4.0) and get_hcc_coefficient 0.2.0 now read medicare_semantic.vw_hcc_coefficients_current_v2 (over medicare_silver.dim_hcc_coefficients_v2, every package 2016-2027, package chosen by population). This table is superseded and kept live only as the rollback; do not read it."],"notes":null,"superseded_by":"medicare_silver.dim_hcc_coefficients_v2 (every CMS-HCC / ESRD / RxHCC package of every posting 2016-2027, restated 2026-10-07, #3246), read through medicare_semantic.vw_hcc_coefficients_current_v2. This table holds payment years 2026-2027 only, keyed without the package, so the RxHCC packages (2026 T/X, 2027 T2/Y1/Y2) overwrote each other and RXHCC111/112/260/396 are missing in 2027; it dropped CMS's 0.0 cells and the ESRD graft-duration / transplant terms, and stored float32 values. Kept frozen as the rollback.","tools":[],"dataset_id":"cms_ma_risk_adjustment_model","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rate_year"],"backing_store":"glue"},{"source_id":"medicare_dim_hcc_coefficients_v2","source_fqn":"medicare_silver.dim_hcc_coefficients_v2","title":"HCC risk-model coefficients, every CMS posting and package 2016-2027 (v2)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (rate_year, software_edition, software_package, segment, variable): 75,521 rows, 16 CMS model-software postings (initial, midyear_final, final) for payment years 2016-2027, 92 package postings, 29 distinct coefficient libraries (Athena efce68d2-a999-40ab-a009-ee0f00fde64c; 0 duplicate keys, 0 null lineage, Athena 56fcd67c).","description":"Every CMS-HCC, ESRD and RxHCC coefficient (relative factor) CMS published in its risk-adjustment model software for payment years 2016-2027, decoded from the SAS PROC CPORT coefficient libraries inside each posting (the only machine-readable form before 2026). One row per package x segment x variable: model_family (CMS-HCC / ESRD / RxHCC), model_version (the coefficient name: V21, V22, V23, V24, V28, RxHCC_V05, RxHCC_V08), xw_model_version (the ICD-10 crosswalk label: ESRD_V21 / ESRD_V24 for ESRD and the 2016-2019 CMS-HCC V21 PACE model), software_package (e.g. V2826.115.T1), segment (CMS's 2026 Python CSV headers for every year), variable (CMS's SAS name), hcc_number, coefficient_value (double), label, plus the library, ZIP and content SHA-256 for each row.","identity_key":"rate_year,software_edition,software_package,segment,variable","row_count":75521,"last_updated":"2026-10-07","freshness_sla":"Annual initial posting plus a midyear final per payment year; a new posting lands as a new (rate_year, software_edition) partition, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage column; software_edition is the second edition axis.","CMS posts an initial and a midyear final (or a single final) model software per payment year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_hcc_coefficients_v2 (pin rate_year AND software_edition AND software_package, or read medicare_semantic.vw_hcc_coefficients_current_v2)","provenance_chain_ref":"pipelines/medicare/ingest/hcc_coefficients_v2_runner.py over 16 SHA-256-pinned CMS model-software ZIPs (bronze s3://vlada-platform-raw/medicare/bronze/hcc_model_software_archive/), decoder pipelines/medicare/silver/sas_cport.py (#3246). Load run 20261007T111733Z-85a01b26 (16 partitions, 75,521 rows), idempotent rerun 20261007T111940Z-85a01b26 (16/16 no-op), independent reconciliation 20261007T112758Z-8b9e6eea (75,521/75,521 equal; CMS Python CSVs 2026/2027 0 value differences), silver invariants 20261007T113259Z-e1594e89 (24/24). Adversarial review PASS-WITH-FIXES: 2,033 Rate Announcement table rows across 2016/2019/2021/2023/2025 with 0 wrong, a second decode of all 73 libraries with 0 differences, hccinfhir 2025/2026 files equal. Record: docs/reference/source-audit/source-mastery/records/medicare_dim_hcc_coefficients.json (v2_all_postings_2026_10_07).","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Holds EVERY posting and EVERY package: an initial and a midyear final for 2023-2026, so summing across software_edition double counts; pin it or read medicare_semantic.vw_hcc_coefficients_current_v2 (one posting per year, each package labelled with the population it applies to).","Several packages of one model share a year (RxHCC 2022 P1/S1, 2025 T/W, 2026 T/X, 2027 T2/Y1/Y2; ESRD V21 2020-2022 P1/P2). NEVER sum or average across packages; pick by the population CMS applies each to (package_applies_to in the current view), never by the package letter: CMS swapped the ESRD P1/P2 letters between 2021 and 2022 (2022 P1 = the 2020 models).","variable is CMS's raw SAS name and is NOT a key across segments or models (V23 community HCC85_gDiabetesMellit = institutional DIABETES_CHF; ART_OPENINGS_PRESSURE_ULCER vs ART_OPENINGS_PRESS_ULCER). Join diagnoses through hcc_number; compare interaction terms only by CMS's label.","CMS-HCC V24 and ESRD V24 share model_version V24 (and CMS-HCC V21 / ESRD V21 share V21 in 2016-2019): filter model_family or join on xw_model_version.","0.0 is a published (constrained) coefficient, never a blank; CMS's Python CSVs show it blank (121 cells 2026, 210 cells 2027).","Coefficients are relative factors, not dollars, and not a payment risk score: normalization factors, the MA coding-pattern adjustment and the MA blend percentages come from each year's Rate Announcement and are not in this table.","Payment years 2008-2015 (ICD-9 era) are archived in bronze but not loaded."],"notes":"Restated by Data Tracker 2026-10-07 (#3246). Supersedes medicare_silver.dim_hcc_coefficients (2026-2027 only, RxHCC packages overwritten; frozen rollback). Release rule: load the 2027 midyear final software as a new partition when CMS posts it; the current view switches automatically.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_risk_adjustment_model","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rate_year","segment","software_edition","software_package","variable"],"backing_store":"glue"},{"source_id":"medicare_vw_hcc_coefficients_current_v2","source_fqn":"medicare_semantic.vw_hcc_coefficients_current_v2","title":"HCC risk-model coefficients, current posting per payment year, package-labelled","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (rate_year, software_package, segment, variable) for the one CMS posting chosen per payment year: 52,463 rows, 12 payment years 2016-2027, 66 packages, unique on that key (Athena 52d9f563-a9cf-4679-b35c-cac14d8bcbf1, 882c4101-b8f0-4c5b-9999-4db6d06ad7e2).","description":"Every CMS-HCC / ESRD / RxHCC coefficient package of the current CMS model-software posting per payment year (midyear final or final when held, else the initial: 2027 is the initial posting until CMS posts its midyear final), each row joined to the 92-row package seed that cites the year's Rate Announcement page: package_calibration, package_applies_to (all / non-PACE / PACE / non-PACE;PACE / MA-PD;PACE / PDP), payment_use (CMS's blend weight for the year), announcement_url, announcement_pages, value_check. Same columns as medicare_silver.dim_hcc_coefficients_v2 otherwise, including xw_model_version and hcc_number for the join from medicare_semantic.vw_icd10_hcc_crosswalk_current_v1.","identity_key":"rate_year,software_package,segment,variable","row_count":52463,"last_updated":"2026-10-07","freshness_sla":"Follows medicare_silver.dim_hcc_coefficients_v2; a newly loaded final posting replaces the initial for its year automatically.","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage column."]},"raw_queryable_via":"Tools: get_risk_model, get_hcc_coefficient; Athena: medicare_semantic.vw_hcc_coefficients_current_v2 (pin rate_year, model_family and the population via package_applies_to)","provenance_chain_ref":"Glue VIRTUAL_VIEW rendered from pipelines/medicare/silver/hcc_coefficient_packages_seed.csv by pipelines/medicare/semantic/hcc_coefficients_view_v2.py (committed render vw_hcc_coefficients_current_v2.sql; created by run 20261007T124839Z-1ea0bc80, view qid f2744ec6-35a6-4d49-8985-1f49c6868bc7; the build refuses unless every package in the table has exactly one seed row). Every RxHCC continuing-enrollee table the Announcements print matched exactly one package value for value (run 20261007T124211Z-f288067d). Rollback: medicare_silver.dim_hcc_coefficients.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Pick the package by POPULATION: package_applies_to contains the population (non-PACE / PACE; for Part D MA-PD / PDP / PACE, where non-PACE covers both MA-PD and PDP and all covers everyone). NEVER sum or average across packages, and never key logic on the package letter (ESRD P1/P2 swap meaning in 2022).","Blends: where two packages apply to one population in one year, payment_use states each one's weight (2019 non-PACE V22 75% + V23 25%; 2020 V22 50% + V24 50% and ESRD 2019 models P1 50% + 2020 models P2 50%; 2021 25% / 75%; 2024 V24 67% + V28 33%; 2025 33% / 67%; 2026 PACE 90% V22 + 10% V28 and the same for ESRD and RxHCC T/X; 2027 PACE 50% / 50%, RxHCC T2 + Y1). Weight each separately computed score; the weights sum to 100% for every year x model family x population.","2027 RxHCC: Y1 = MA-PD, Y2 = PDP, PACE = 50% T2 + 50% Y1 (MA-PD relative factors). 2022-2024 PACE Part D uses the 2020 RxHCC model (V05) while non-PACE uses the newer one.","variable is CMS's raw SAS name, not a key across segments or models; join the crosswalk on (rate_year, xw_model_version = model_version, hcc_number). That join is 100% of mapped categories for all 53 year x model cells 2016-2027 (Athena a14a9b0c-335f-42b4-b621-95b30d8f0ab4).","Relative factors only: normalization factors, the MA coding-pattern adjustment and the MA blend percentage applied to the final score come from the Rate Announcement and are not in this view, so a sum of factors is a raw risk score, not a payment risk score.","2027 is the initial posting until CMS posts the midyear final."],"notes":"Read path for HCC coefficients from 2026-10-07 (get_risk_model 0.4.0, get_hcc_coefficient 0.2.0). Every posting stays in medicare_silver.dim_hcc_coefficients_v2. medicare_semantic.vw_hcc_coefficients_current_v1 (same rows, no package labels) exists in Glue but is not registered: it cannot tell the packages apart.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_risk_adjustment_model","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rate_year","segment","software_package","variable"],"backing_store":"glue"},{"source_id":"medicare_dim_icd10_hcc_crosswalk","source_fqn":"medicare_silver.dim_icd10_hcc_crosswalk","title":"ICD-10 to HCC crosswalk (reference)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (rate_year, model_version, icd_code, hcc_category); an ICD-10 code may map to multiple HCCs.","description":"CMS reference crosswalk mapping each ICD-10-CM diagnosis to its Hierarchical Condition Category under a specific risk-model version and payment year. The diagnosis-to-risk-bucket dictionary behind MA / Part D risk scoring.","identity_key":"rate_year,model_version,icd_code,hcc_category","row_count":171676,"last_updated":"2026-06-08","freshness_sla":"Annual (CMS risk-adjustment model updates).","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_icd10_hcc_crosswalk","provenance_chain_ref":"M-2 substrate.","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["REFERENCE crosswalk (not contract-keyed): the certified row grain is (rate_year, model_version, icd_code, hcc_category); do not collapse multiple HCC mappings.","JOIN to dim_hcc_coefficients on (hcc_category, model_version, rate_year) to turn a diagnosis into a risk weight. Always pin model_version (V22/V24/V28) and rate_year on BOTH sides: a code's HCC changes across model versions.","Layer-2 tool: get_risk_model."],"notes":null,"superseded_by":"medicare_silver.dim_icd10_hcc_crosswalk_v3 (every CMS mapping edition 2016-2027, restated 2026-10-07, #3237), read through medicare_semantic.vw_icd10_hcc_crosswalk_current_v1. This table matched only 2024-era header spellings, so it is missing CMS-HCC V23 (2019), CMS-HCC V24 (2020-2025), the 2021 V21 column, all RxHCC V05 and 5,384 multi-HCC rows; its 'V21' / 'V24' are the ESRD models and its RxHCC categories are spelled HCC<n>. Kept frozen as the rollback.","tools":[],"dataset_id":"cms_ma_risk_adjustment_model","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["hcc_category","icd_code","model_version","rate_year"],"backing_store":"glue"},{"source_id":"medicare_dim_icd10_hcc_crosswalk_v3","source_fqn":"medicare_silver.dim_icd10_hcc_crosswalk_v3","title":"ICD-10 to HCC / RxHCC crosswalk, every CMS edition (v3)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (rate_year, mapping_edition, model_version, icd_code, hcc_category): 707,821 rows, 12 payment years 2016-2027, 17 CMS editions (initial, midyear_final, final), 8 model labels (Athena 8d7dff41). An ICD-10 code that maps to more than one HCC in a model has one row per HCC.","description":"The CMS ICD-10-CM to HCC / RxHCC mapping files, every edition CMS lists on its risk-adjustment year pages, read from the publisher's own headers. Labels: CMS-HCC V22, V23 (2019), V24 (2020-2025), V28 (2024+); ESRD_V21 and ESRD_V24 for the ESRD models; RxHCC_V05 (2016-2024) and RxHCC_V08 (2023+) for Part D, with categories spelled RXHCC<n>. coefficient_model_version carries the dim_hcc_coefficients model name (ESRD_V21 -> V21, ESRD_V24 -> V24). Every row keeps the verbatim source column header, its payment-year flag, the CSV line and the ZIP and CSV hashes.","identity_key":"rate_year,mapping_edition,model_version,icd_code,hcc_category","row_count":707821,"last_updated":"2026-10-07","freshness_sla":"Annual, plus a midyear final per payment year; a new edition lands as a new (rate_year, mapping_edition) partition, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage column; mapping_edition is the second edition axis.","CMS posts an initial and a midyear final (or final) mapping per payment year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_icd10_hcc_crosswalk_v3 (pin rate_year AND mapping_edition, or read medicare_semantic.vw_icd10_hcc_crosswalk_current_v1)","provenance_chain_ref":"pipelines/medicare/ingest/icd10_hcc_crosswalk_v3_runner.py over 17 SHA-256-pinned CMS ZIPs archived under s3://vlada-platform-raw/medicare/bronze/hcc_icd10_mappings_archive/ (#3237). Load run 20261007T020401Z-50c850c0 (17 partitions appended), idempotent rerun 20261007T020614Z-50c850c0 (17/17 no-op), independent reconciliation against the live CMS files 20261007T020819Z-50c850c0 (17/17 PASS, 0 missing, 0 extra), silver invariants 20261007T021223Z-90bf9041 (24/24); adversarial review PASS-WITH-FIXES, all four fixes applied. Record: docs/reference/source-audit/source-mastery/records/medicare_dim_icd10_hcc_crosswalk.json (v3_all_editions_2026_10_07).","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Holds every edition: an INITIAL edition for year N is the prior year's final code set (2026 initial = 2025 midyear final, 2027 initial = 2026 final, byte for byte). Pin mapping_edition, or read medicare_semantic.vw_icd10_hcc_crosswalk_current_v1, which keeps one edition per year. Summing across editions double counts.","V24 is CMS-HCC V24 (2020-2025; absent from the 2026/2027 files). The ESRD V24 model is ESRD_V24. The superseded v1 table called the ESRD models V21 / V24.","V28 HCC 223 is conditional (CMS note, 2024+): the codes mapped to HCC223 earn it only when the same person also has a code mapped to HCC224, 225 or 226.","In 2016-2019 the V21 column is CMS's \"PACE/ESRD\" model (PACE and ESRD share V21); it is labelled ESRD_V21 and source_column keeps the header.","Join to medicare_semantic.vw_hcc_coefficients_current_v2 on (rate_year, model_version = xw_model_version, hcc_number): 100% of mapped categories for all 53 year x model cells 2016-2027 (Athena a14a9b0c-335f-42b4-b621-95b30d8f0ab4). Never join on CMS's variable name, and pick the coefficient package by population (package_applies_to). coefficient_model_version V24 names both CMS-HCC V24 and ESRD V24, so it is not a join key on its own. The superseded medicare_silver.dim_hcc_coefficients held 2026-2027 only.","Model coverage differs by year by publisher design: 3 models 2016-2018, 4 in 2019-2022, 6-7 in 2023-2025, 5 in 2026-2027.","Layer-2 tools: get_risk_model, get_icd10_hcc_mapping (both read the current view)."],"notes":"Restated by Data Tracker 2026-10-07 (#3237). Supersedes medicare_silver.dim_icd10_hcc_crosswalk (frozen rollback). medicare_silver.dim_icd10_hcc_crosswalk_v2 (one edition per year, wrong edition for 2024/2025) is not served. Release rule: load the 2027 midyear final as a new partition when CMS posts it; the current view switches automatically.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_risk_adjustment_model","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["hcc_category","icd_code","mapping_edition","model_version","rate_year"],"backing_store":"glue"},{"source_id":"medicare_vw_icd10_hcc_crosswalk_current_v1","source_fqn":"medicare_semantic.vw_icd10_hcc_crosswalk_current_v1","title":"ICD-10 to HCC / RxHCC crosswalk, current edition per payment year","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (rate_year, model_version, icd_code, hcc_category) for the one CMS edition chosen per payment year: 457,917 rows, 12 payment years 2016-2027, 12 editions (Athena 5ca177af). 2025 = midyear final (54,440), 2026 = final (44,860), 2027 = initial (44,860).","description":"The CMS ICD-10-CM to HCC / RxHCC mapping with one edition per payment year: the midyear final or final when CMS has posted it, else the initial. 2027 serves the initial edition (the 2026 final code set) until CMS posts the 2027 midyear final, then switches with no code change. Same columns as medicare_silver.dim_icd10_hcc_crosswalk_v3, including model_version + hcc_number for the join to medicare_semantic.vw_hcc_coefficients_current_v2.","identity_key":"rate_year,model_version,icd_code,hcc_category","row_count":457917,"last_updated":"2026-10-07","freshness_sla":"Follows medicare_silver.dim_icd10_hcc_crosswalk_v3; a newly loaded final edition replaces the initial for its year automatically.","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rate_year' is the source's documented vintage column."]},"raw_queryable_via":"Tools: get_risk_model, get_icd10_hcc_mapping; Athena: medicare_semantic.vw_icd10_hcc_crosswalk_current_v1 (pin rate_year and model_version)","provenance_chain_ref":"Glue VIRTUAL_VIEW from pipelines/medicare/semantic/vw_icd10_hcc_crosswalk_current_v1.sql (#3237, created qid 2669fdeb-c21d-4fe3-9aeb-a63888be0d94) over medicare_silver.dim_icd10_hcc_crosswalk_v3. Independent reconciliation of the chosen edition per year PASS (qid 2e3c214e-6529-44de-9fc1-3d846e59005a, run 20261007T020819Z-50c850c0). Rollback: medicare_silver.dim_icd10_hcc_crosswalk.","context_doc_path":"docs/context_library/medicare/MA-CODEX.md","known_gaps":["Model labels: CMS-HCC V22 / V23 / V24 / V28, ESRD_V21 / ESRD_V24, RxHCC_V05 / RxHCC_V08 (categories RXHCC<n>). V24 is CMS-HCC V24 (2020-2025, absent from 2026/2027); the superseded v1 table's V21 / V24 were the ESRD models.","V28 HCC 223 is conditional: the codes mapped to HCC223 earn it only when the same person also has a code mapped to HCC224, 225 or 226. The crosswalk row alone does not award HCC223.","In 2016-2019 the ESRD_V21 rows are CMS's \"PACE/ESRD\" V21 column.","Risk weights: join medicare_semantic.vw_hcc_coefficients_current_v2 on (rate_year, model_version = xw_model_version, hcc_number), 100% of mapped categories 2016-2027 (Athena a14a9b0c); choose the package by population (package_applies_to), never sum packages. Report unmatched rows, never drop them.","2027 is the initial edition until CMS posts the midyear final; the initial for year N is the prior year's final code set."],"notes":"Read path for the ICD-10 -> HCC crosswalk from 2026-10-07 (get_risk_model 0.4.0, get_icd10_hcc_mapping 0.3.0). Every edition stays in medicare_silver.dim_icd10_hcc_crosswalk_v3.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_risk_adjustment_model","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["hcc_category","icd_code","model_version","rate_year"],"backing_store":"glue"},{"source_id":"medicare_landscape_all","source_fqn":"medicare_silver.landscape_all","title":"MA / Part-D Landscape (premium / MOOP / stars / service area)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (report_year, category, contract_id, plan_id, segment_id, state, county). Unified CMS Landscape 2007-2026, all categories MA/PDP/SNP/MMP/Cost.","description":"The CMS Landscape files normalized into one table across every year and plan category, tagged by category. The consumer view published ~early September, ahead of the October PBP/benefits drop: consolidated_premium, part_c/part_d premium, part_d_deductible, moop_in_network, overall_star_rating, and the county-level service area. Carries what PBP does not.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":"2026-06-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.landscape_all","notes":null,"superseded_by":"medicare_silver.fact_ma_landscape (stamped re-collection 2026-09-07: same rows plus the provenance envelope (source_url, sha256_content_hash, asserted_at); the legacy table stays queryable until dropped)","tools":[],"dataset_id":"ds_ma_enrollment_cpsc","dataset_assignment_basis":"context_doc","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_fact_ma_landscape","source_fqn":"medicare_silver.fact_ma_landscape","title":"CMS MA / Part D Landscape, every era CY2006-CY2027, stamped","domain":"medicare","stage":"silver","status":"live","grain":"One row per report_year x record_family x category x plan (contract, plan, segment) as published; natural key (report_year, row_seq); 1,684,158 landscape rows + plan-and-premium rows; 78 year x category partitions on 2026-09-07.","description":"The CMS Landscape files re-collected through the provenance envelope on 2026-09-07: 38 header signatures across three publisher eras (2006 premium-only; 2007-2024 per-category files; CY2025+ one combined file) resolved by exact header contracts (pipelines/medicare/silver/ma_landscape_contracts.yaml); every row carries source_url, sha256_content_hash, asserted_at. Filter record_family = 'landscape' AND is_current for the plan roster; record_family = 'plan_premium' holds the plan-and-premium files. Column mapping stress-tested (docs/knowledge/recollection/landscape-stress-test-2026-09-06.md); the 2010 MA 'MOOP $3,400' column is the Yes/No flag moop_at_or_below_3400_flag, not an amount.","identity_key":"contract_id,plan_id,segment_id","row_count":1684158,"last_updated":"2026-09-28","freshness_sla":"Annual (CMS Landscape consumer view, ~early September for the following plan year).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The next contract year's file drops in late September; in-year revisions (e.g. 2026 202608) replace the year's partition.","watermark_field 'report_year' is the contract year the file describes; the next year's file drops in late September and an in-year revision replaces that report_year partition."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ma_landscape","commercial_terms":"Public CMS data.","provenance_chain_ref":"pipelines/medicare/ingest/ma_landscape_runner.py (job build_medicare_ma_landscape) from https://www.cms.gov/files/zip/cy2006-cy2025-landscape-files.zip (sha 3f034779fe00...) and cy2026-landscape-202608.zip (sha a7c016028815...); member ledger medicare_silver.ma_landscape_member_ledger; bronze medicare/bronze/cms_ma_landscape/","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Strings as published ('$-', 'Not Applicable', '($12.60)', 'x' are legitimate publisher tokens); cast on read.","The 2026 file carries the July 2026 star update; stars_ratings_summary holds the October 2025 release (47 contracts differ).","plan_crosswalks_annual has no plan_year 2025 rows, so 2025 departures cannot be classified against the crosswalk.","CY2027 IS LOADED (2026-09-28: 130,307 rows, 654 contracts, audited against the CMS zip with 0 diffs; report_year min/max 2006-2027 measured the same day). A card or description that says the holdings end at 2026 is stale, not the table.","SNP is its own category: category IN ('MA','SNP') is Medicare Advantage; category = 'MA' alone drops every D-SNP, C-SNP and I-SNP. PDP (S contracts) is a separate market.","No enrollment in the file: averages over Landscape rows are per plan. Join enrollment_monthly_county (contract_id + plan_id + county, report_month pinned) for member-weighted figures, or say 'per plan'.","Product type is derived, not a column: plan_type + snp_type + dsnp_integration_status -> non-SNP HMO / non-SNP PPO / D-SNP HMO / D-SNP PPO / C-SNP / I-SNP (regex of record tools/ma_brain/landscape_analysis.py); vocabulary drifts by year; never pool product types.","Same plan is not the same ID year over year: renumbered and merged plans read as an exit plus a new plan on a contract+plan+segment join. Same-store needs plan_crosswalks_annual (CY2027 crosswalk posts early October 2026); until then continuing = contract+plan+segment AND county still listed.","Day-One star is empty: the September file's overall_star_rating is null for the coming year (CY2024-CY2027 measured); the October revision fills it. Null 2027 star = Day One, not a missing plan.","PLAN AND PREMIUM ROWS STAMPED ONE YEAR EARLY (record_family = 'plan_premium' only; the 'landscape' family is right): report_year 2016 holds two contract years (CY2016, 38,376 rows, and CY2017, 38,787 rows); report_year 2017-2022 each hold the NEXT contract year (2017 = CY2018, 42,428; 2018 = CY2019, 49,351; 2019 = CY2020, 58,345; 2020 = CY2021, 70,416; 2021 = CY2022, 85,878; 2022 = CY2023, 105,412). There is no 2023 stamp, so CY2023 sits under 2022 and CY2018 is held, under stamp 2017. 2007-2015 and 2024 are right. The cause: the old loader (parser <= 1.2.0) took the year from the release date in the member file name; fixed in code by #3107, the served rows were never restamped. Read the true contract year from the corrected view (medicare_silver.vw_ma_landscape_contract_year_v20261013a), column contract_year, for any Part C / Part D premium split before CY2025 (Athena 90fe0ec2, 2026-10-13; docs/data-tracker/LANDSCAPE-PBP-DEFECTS-2026-10-13.md)."],"notes":null,"superseded_by":null,"tools":["get_county_view","get_landscape","get_landscape_benefit_change","get_landscape_exits","get_network_breadth","get_network_groups","get_network_system_change","get_pbp_benefit","get_plan_network"],"dataset_id":"cms_ma_landscape","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_nadac","source_fqn":"drug_silver.fact_drug_acquisition_cost","title":"NADAC — National Average Drug Acquisition Cost","domain":"drug","stage":"silver","status":"live","grain":"One row per (ndc11, observed_period_start/week, price_type). CERTIFIED 2026-06-03; history gap CLOSED and re-measured 2026-08-10 (see known_gaps).","description":"Pharmacy ACQUISITION cost (\"what the pharmacy paid\" — a cost FLOOR, not a payment, list price, or ASP). unit_price_usd is per pricing_unit (EA/ML/GM); normalize to the same unit + package_size before comparing across NDCs.","identity_key":"ndc11","row_count":16260115,"last_updated":"2026-08-10","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_acquisition_cost (is_current = true)","notes":"CERTIFIED (product1-cert-nadac-v1). Full 2013-2026 history served; the former current-window scoping is retired. Acquisition cost != payment/list/net.","superseded_by":null,"tools":[],"dataset_id":"cms_nadac","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_asp","source_fqn":"drug_silver.fact_drug_asp_quarterly#drug_asp","title":"ASP — Medicare Part B drug Average Sales Price","domain":"drug","stage":"silver","status":"live","grain":"One row per (HCPCS code, effective quarter).","description":"Medicare Part B quarterly ASP/payment-limit benchmark by HCPCS billing unit. This is the denominator for J-code drug markup analysis against commercial infusion rates.","identity_key":"hcpcs_code","row_count":18027,"last_updated":null,"raw_queryable_via":"Tool: asp_pricing_lookup; Athena: drug_silver.fact_drug_asp_quarterly (filter is_current = true).","notes":"Logical catalog alias over physical table drug_silver.fact_drug_asp_quarterly; HCPCS<->NDC crosswalk is a separate quarterly drop.","superseded_by":null,"tools":[],"dataset_id":"ds_drug_asp","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_asp_quarterly","source_fqn":"drug_silver.fact_drug_asp_quarterly","title":"ASP Pricing File — Medicare Part B quarterly ASP (raw CMS drop)","domain":"drug","stage":"silver","status":"live","grain":"One row per (hcpcs_code, release_quarter).","description":"The raw CMS Medicare Part B ASP Pricing File, quarter by quarter: HCPCS payment limit (ASP+6%), coinsurance %, and the vaccine / blood / clotting-factor pricing columns. This is the physical table the asp_pricing_lookup MCP tool reads; drug_asp is the product-level logical alias over the same served table.","identity_key":"hcpcs_code","row_count":18027,"last_updated":null,"freshness_sla":"Quarterly (CMS ASP Pricing File releases).","recollection":{"cadence":"quarterly","watermark_field":"release_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'release_quarter' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","is_current flag marks the live vintage; ~6-month publication lag."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_asp_quarterly (filter is_current = true). The Medicare Part B drug benchmark — JOIN commercial fact_rate on code=hcpcs_code (HCPCS), normalize billing units.","provenance_chain_ref":"drug_source_registry_cache","known_gaps":["23 quarters (2021Q1-2026Q3, 18,027 is_current rows) verified 2026-07-03 by Athena; one source URL/hash per quarter and zero duplicate current (HCPCS, quarter) groups.","Pre-2021 ASP history (2005-2020) is not resolved by the current CMS URL pattern; sampled standard URLs for 2005, 2010, and 2015 return 404 and need archive/Wayback research before any load.","~6-month publication lag — a fast-moving drug's published ASP can be materially stale (see medicare/asp.md).","CY2026 era break: IRA MFP layers into ASP from 2026Q1 (vintage_tag asp_2026_plus_mfp_layered) — do not draw a smooth trend across 2026Q1 for negotiated drugs.","Priced per HCPCS billing unit (hcpcs_dosage), NOT per NDC — crosswalk + unit-normalize before any NADAC/WAC comparison.","SUPERSEDED FOR READING (2026-10-05): drug_silver.fact_drug_asp_quarterly_v2 (parse revision 2) holds the same keys with 8,021 payment limits this table stores NULL (Q2 2006 - Q3 2009, 77 rows of Q1 2005), Q1 2006 AWP% as percent not fraction, clotting_factor_usd as a flag, and CMS's 09/08/2026 revisions of Jan/Apr/Jul 2026 (this table keeps the superseded first versions). asp_pricing_lookup, drug_price_composite and prove_drug_reimbursement_decision read v2; this table is their rollback."],"notes":"CERTIFIED (product1-cert-asp-v1, refreshed source-truth proof 2026-07-03). One J-code -> many NDCs.","superseded_by":null,"tools":[],"dataset_id":"cms_asp_pricing_files","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_asp_quarterly_v2","source_fqn":"drug_silver.fact_drug_asp_quarterly_v2","title":"ASP Pricing File, Medicare Part B quarterly payment limits (parse revision 2, every CMS revision kept)","domain":"drug","stage":"silver","status":"live","grain":"One row per (hcpcs_code, release_quarter, cms_vintage_sequence); among is_current rows (hcpcs_code, effective_period_start) is unique: 55,035 rows = 55,035 keys over 88 quarterly editions, Q1 2005 to Q4 2026 (Athena e3c215d1, f0abf87e).","description":"Medicare Part B payment limits per HCPCS billing unit, every quarter Q1 2005 onward, parse revision 2 (ASP parser 2.0.0). Each CMS revision of a quarter is kept (cms_vintage_sequence); use WHERE is_current for the latest. The payment limit is 106% of ASP on a two-quarter lag, not the ASP. 2005-2009 limits are the publisher's '$' text parsed exactly; clotting_factor_flag marks clotting-factor codes (a flag, not dollars). Infusion AWP% / DME infusion limit exist 2005-2016 only; Independent ESRD limit 2005 only. asp_pricing_lookup, drug_price_composite and prove_drug_reimbursement_decision read this table from 2026-10-05.","identity_key":"hcpcs_code,effective_period_start","row_count":55035,"last_updated":"2026-10-05","freshness_sla":"Quarterly (CMS ASP Pricing File releases); a CMS re-post of a quarter lands as the next cms_vintage_sequence.","recollection":{"cadence":"quarterly","watermark_field":"release_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'release_quarter' is the source's documented vintage/currency column; cms_vintage_sequence counts CMS re-posts of one quarter.","is_current marks the newest CMS version of each quarter."]},"raw_queryable_via":"Tools: asp_pricing_lookup, drug_price_composite; Athena: drug_silver.fact_drug_asp_quarterly_v2 (filter is_current = true)","provenance_chain_ref":"Iceberg table written 2026-10-05 by tools/data_tracker/asp_restate_v2.py (91 editions, 57,687 rows incl. the three superseded revision-1 quarters) from held bronze; parser pipelines/drug/silver/asp_quarterly_writer.py 2.0.0; record docs/reference/source-audit/source-mastery/records/drug_asp.json; plan docs/data-tracker/DRUG-LOADER-RELOAD-PLAN-2026-10-01.md. Rollback: drug_silver.fact_drug_asp_quarterly (v1), unchanged and still served.","known_gaps":["Same is_current keys as v1 in every edition (0 only in v1, 0 only in v2; Athena 50ec4968). payment_limit_usd recovered on 8,021 rows v1 stored NULL (Q2 2006 - Q3 2009 and 77 rows of Q1 2005: '$' / '%' cells the v1 parser dropped); 0 other limits differ except the 7 CMS revised on 09/08/2026 (J1299 x2, J1303 x2, J1939, J0174, J1811), which carry notes 'Updated October 2026'. Value-level acceptance PASS with 0 perturbation survivors (records/drug_asp.json).","Jan, Apr and Jul 2026 each hold two CMS versions (cms_vintage_sequence 1 and 2); WHERE is_current keeps the newest (2,652 current rows are sequence 2). Without the filter those quarters count twice.","CY2026 era break: IRA maximum fair prices layer into ASP from 2026-01-01 for negotiated drugs; do not draw a smooth trend across Q1 2026 for those drugs.","Priced per HCPCS billing unit (hcpcs_dosage), NOT per NDC; crosswalk and unit-normalize before any NADAC/WAC comparison.","52 is_current rows carry no payment limit (publisher blank)."],"notes":"Parse revision 2 of the same CMS files (Data Tracker drug wave 1B, PR 3114, defects ASP-1..ASP-5). Versioned, never overwritten; the v1 card stays live as the rollback.","superseded_by":null,"tools":["asp_pricing_lookup"],"dataset_id":"cms_asp_pricing_files","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":["effective_period_start"],"backing_store":"glue"},{"source_id":"drug_asp_ndc_hcpcs_crosswalk","source_fqn":"drug_silver.fact_asp_ndc_hcpcs_crosswalk","title":"ASP NDC-HCPCS Crosswalk — Medicare Part B drug-identity bridge (raw CMS drop)","domain":"drug","stage":"silver","status":"live","grain":"One row per (hcpcs_code, ndc11).","description":"The CMS Medicare Part B ASP NDC-HCPCS Crosswalk: each Part-B HCPCS (J-code etc.) mapped to the NDCs billable under it, with labeler/drug name, HCPCS dosage, package size/qty, and billing units. This is the drug-IDENTITY bridge previously flagged missing — it lets a J-code resolve to its NDC set (drug_silver.dim_drug.ndc11) and an NDC resolve back to its HCPCS (vlada_curated.dim_code.code), unifying the drug catalog with the medical/HCPCS graph. Sibling of the ASP Pricing File (fact_drug_asp_quarterly) in the same quarterly ASP release.","identity_key":"hcpcs_code","row_count":7366,"last_updated":null,"freshness_sla":"Quarterly (CMS ASP release, NDC-HCPCS Crosswalk ZIP).","recollection":{"cadence":"quarterly","watermark_field":"release_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'release_quarter' is the source's documented vintage/currency column.","is_current flag marks the live vintage; ~6-month publication lag."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_asp_ndc_hcpcs_crosswalk (filter is_current = true). hcpcs_code JOINs vlada_curated.dim_code.code (measured 850/850 = 100%); ndc11 JOINs drug_silver.dim_drug.ndc11 (measured 7,140/7,189 = 99.3%). NDC stored canonical 11-digit (segment-aware); ndc_raw preserves the source dashed form.","provenance_chain_ref":"drug_source_registry_cache","known_gaps":["July 2026 quarter loaded (7,366 rows, 850 HCPCS, 7,189 NDC11) verified 2026-07-14 by Athena. Runner is idempotent by ZIP SHA + replace-mode per quarter partition.","Only the ASP crosswalk member is loaded; the AWP / OPPS / PrEP NDC-HCPCS Crosswalk siblings in the same ZIP are deferred (separate billing settings).","Historical quarters (2021Q1+) are discoverable from the same CMS page but not yet backfilled — current snapshot only.","billunits / billunitspkg are per-package HCPCS billing-unit conversions — unit-normalize before any per-NDC dose or price math."],"notes":"The drug-identity NDC<->HCPCS bridge (2026-07-14). Unified the previously-disjoint drug + medical graph components — see docs/architecture/2026-07-14-source-connection-node-graph.md. One J-code -> many NDCs.","superseded_by":null,"tools":[],"dataset_id":"cms_asp_pricing_files","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_form5500_insurance","source_fqn":"drug_silver.fact_form5500_insurance","title":"Form 5500 Schedule A insurance contracts (carrier, premiums, broker totals)","domain":"drug","stage":"silver","status":"live","grain":"One row per (filing, Schedule A attachment) - key (ack_id, plan_year, form_id); served plan years 2009-2025. Plan year 2025 is PARTIAL.","description":"DOL EFAST2 Form 5500 Schedule A insurance-contract rows: carrier identity and NAIC, premiums, persons covered, aggregate broker commission and fee totals, and welfare-benefit-type indicators (health/dental/vision/stop-loss/HMO/PPO/indemnity). Presence of a Schedule A row is evidence the plan is at least partially insured; is_stop_loss disambiguates insured from self-funded-with-stop-loss. First loaded 2026-07-26.","identity_key":"ack_id","row_count":5112373,"last_updated":"2026-07-26","freshness_sla":"Annual (DOL EFAST2 Latest archive per plan year).","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the Form 5500 plan year of the filing, the DOL EFAST2 edition axis (one Latest archive per plan year); it is not the date DOL released the archive.","The newest plan year is always partial because DOL refreshes a plan year's Latest archive as late filings arrive: PY2025 holds 53,926 rows against a 288,195-339,145 norm, so never trend it; the last complete plan year is 2024.","Amended filings coexist in the table; read is_current = true.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena: drug_silver.fact_form5500_insurance (filter is_current = true)","commercial_terms":"Public DOL EFAST2 data.","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/form5500_schedule_a.md","known_gaps":["OUTLIER CONTAMINATION: naive sum(broker_comm_tot_usd) is $576 trillion - as-filed filer error, not a real total. Never aggregate without an explicit outlier policy; prefer row-level reporting traced to ack_id.","986,069 of 5,112,373 rows are health contracts; the rest are dental, vision, life, disability and pension. Filter is_health before any health-plan claim.","Plan year 2025 is PARTIAL (53,926 rows vs a 288,195-339,145 norm); never trend it. Last complete plan year is 2024.","Broker commissions here cover INSURED products only. Self-funded vendor fees live on Schedule C (fact_form5500_service_provider); a complete broker-fee answer needs both."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"dol_form5500_efast2","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["ack_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_form5500_insurance_broker","source_fqn":"drug_silver.fact_form5500_insurance_broker","title":"Form 5500 Schedule A named brokers (per-broker commission and fees paid)","domain":"drug","stage":"silver","status":"live","grain":"One row per (filing, Schedule A attachment, named broker) - key (ack_id, plan_year, form_id, row_order); served plan years 2009-2025. Plan year 2025 is PARTIAL.","description":"DOL EFAST2 Form 5500 Schedule A PART1 rows: the named broker on each insurance contract with the commission and fees actually paid to them. 6,733,606 rows across 17 plan years - the per-broker compensation record for insured arrangements. First loaded 2026-07-26.","identity_key":"ack_id","row_count":6733606,"last_updated":"2026-07-26","freshness_sla":"Annual (DOL EFAST2 Latest archive per plan year).","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the Form 5500 plan year of the filing the broker row is attached to, the DOL EFAST2 edition axis (one Latest archive per plan year); it is not the date DOL released the archive.","The newest plan year is always partial because DOL refreshes a plan year's Latest archive as late filings arrive: PY2025 holds 80,515 rows against a 372,280-449,092 norm, so never trend it.","Amended filings coexist in the table; read is_current = true.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena: drug_silver.fact_form5500_insurance_broker (filter is_current = true)","commercial_terms":"Public DOL EFAST2 data.","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/form5500_schedule_a.md","known_gaps":["EXTREME OUTLIER CONCENTRATION: a SINGLE row carries $563,333,333,333,333 of the $573,158,066,326,117 naive sum(broker_comm_paid_usd) - 98.2% in one filer-entered value. Five rows exceed $1B; median is $2,119. Never sum naively.","397,021 distinct broker_name strings are RAW filer text with no entity canonicalization; the same broker appears under many spellings. Distinct names are not distinct firms.","Plan year 2025 is PARTIAL (80,515 rows vs a 372,280-449,092 norm); never trend it.","INSURED contracts only; self-funded vendor fees live on Schedule C."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"dol_form5500_efast2","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["ack_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_form5500_financials","source_fqn":"drug_silver.fact_form5500_financials","title":"Form 5500 Schedule H plan financials (claims paid, admin expenses, assets)","domain":"drug","stage":"silver","status":"live","grain":"One row per filing that attached a Schedule H - key ack_id ALONE (Schedule H has no FORM_ID column); served plan years 2009-2025. Plan year 2025 is PARTIAL.","description":"DOL EFAST2 Form 5500 Schedule H rows: benefits actually paid (tot_distrib_bnft_usd), carrier-paid benefits, the itemized administrative-expense block including contract-administrator/TPA fees, contributions, income and beginning/end-of-year assets. This is the CLAIMS-PAID denominator: Schedule C says what the plan paid its vendors, Schedule A says what it paid its carrier and broker, and only Schedule H says what it paid for CARE. All 1,513,019 rows join to fact_form5500_filing on ack_id. First loaded 2026-07-26.","identity_key":"ack_id","row_count":1513019,"last_updated":"2026-07-26","freshness_sla":"Annual (DOL EFAST2 Latest archive per plan year).","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the Form 5500 plan year of the filing (the DOL EFAST2 edition axis and the table's partition); Schedule H has no FORM_ID, so ack_id alone is the key within a plan year.","The newest plan year is always partial because DOL refreshes a plan year's Latest archive as late filings arrive: PY2025 holds 2,548 rows against an 86,077-100,501 norm, so never trend it; the last complete plan year is 2024.","Amended filings coexist in the table; read is_current = true.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena: drug_silver.fact_form5500_financials (filter is_current = true)","commercial_terms":"Public DOL EFAST2 data.","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/form5500_schedule_h.md","known_gaps":["PENSION CONTAMINATION: only 64,574 of 1,513,019 rows (4.3%) belong to a plan flagged is_health_plan; 1,281,230 carry a pension benefit code. Unfiltered sum(tot_distrib_bnft_usd) is $13.56T of which only $2.39T (17.6%) is health. The largest rows are GM PY2012 $27.6B, IBM PY2022 $19.7B, AT&T PY2023 $12.5B - all pension. ALWAYS join fact_form5500_filing and filter is_health_plan.","LARGE-PLAN-ONLY: Schedule H is filed by 100+ participant plans; small plans file Schedule I, which is NOT ingested. PY2024 has 86,077 Schedule H rows against 221,777 filings. Absence of a row is not evidence of zero claims.","The usable HEALTH universe is ~3,300-5,000 plan-years per year (64,574 across the era, 7,108 distinct sponsor EINs), not ~86,000. Most large health plans are unfunded or insured and file no Schedule H.","Fee-to-claims exposure ratio is computable for 56,959 of 64,574 health plan-years (88.2%) - those carrying both a Schedule H and a Schedule C row on the same ack_id.","FOUR SCHEMA ERAS (143/153/158/166 columns at 2009/2015/2022/2023). Projection is name-based and every field was verified in all four eras. Seven 2023+ fee fields are deliberately not projected because a null across two thirds of the range reads as 'no fee'.","contract_admin_fees_usd is populated on only 49.7% of rows and is an INDEPENDENT filing from Schedule C; the two need not agree.","AS-FILED: 228 rows are negative (min -$142,949,953) and 119,590 are exactly zero. tot_expenses_usd INCLUDES benefits paid and is not a fee figure.","Plan year 2025 is PARTIAL (2,548 rows vs an 86,077-100,501 norm); never trend it. Last complete plan year is 2024."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"dol_form5500_efast2","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["ack_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_form5500_filing","source_fqn":"drug_silver.fact_form5500_filing","title":"Form 5500 filings (DOL EFAST2 main filing)","domain":"drug","stage":"silver","status":"live","grain":"One row per DOL EFAST2 Form 5500 main filing (natural key ack_id); served plan years 2009-2025. Pre-EFAST2 1999-2008 is secured but deferred to a separate legacy table family keyed by FILING_ID.","description":"DOL EBSA public Form 5500 main-filing rows. The certified EFAST2 table is served for plan years 2009-2025 through pipelines/drug/ingest/form5500_runner.py; all pre-EFAST2 1999-2008 archive bytes are secured but remain outside the certified EFAST2 facts pending the exact deferred legacy lane.","identity_key":"ack_id","row_count":4330525,"last_updated":"2026-07-26","freshness_sla":"Annual (DOL EFAST2 Latest archive per plan year; pre-EFAST2 files are frozen October 2010 archive bytes).","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","DOL EFAST2 Latest archive per plan year; pre-EFAST2 1999-2008 files are frozen October 2010 bytes and remain in the exact deferred legacy lane."]},"raw_queryable_via":"Athena: drug_silver.fact_form5500_filing (filter is_current = true)","commercial_terms":"Public DOL EFAST2 data.","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/form5500_schedule_c.md","known_gaps":["EFAST2 2009-2025 is loaded at 4,330,525 filing rows; the SIX-table EFAST2 family totals 32,402,086 rows (filing, Schedule C providers + codes, Schedule A insurance + brokers, Schedule H financials). The prior 'three-table family / 13,037,746 rows' figure predates the 2026-07-26 Schedule A and Schedule H loads.","All ten pre-EFAST2 years 1999-2008 are recoverable and byte-secured: 160 files totaling 1,973,997,290 bytes, zero misses, SHA-256-pinned under s3://vlada-platform-raw/drug/bronze/form5500_efast1_archive/{year}/, with the full per-file manifest at s3://vlada-platform-raw/drug/bronze/form5500_efast1_archive/acquisition_manifest_2026-07-11.json.","Pre-EFAST2 serving is deferred: use a separate table family keyed by FILING_ID, preserve the split Schedule C main/PART1/PART2 schemas, and never merge into the certified EFAST2 facts.","Before legacy serving, run the Fargate-lane parse against archived S3 bytes with layout.txt dictionaries, add era guards to vlada/tools/employer_cpd_carve_out.py and vlada/tools/pbm_compensation_rollup.py, and require an explicit identity-layer as-of/ranking rule."],"notes":"Terminal state complete_and_served with a documented pre-EFAST2 source limit; legacy archive inventory and S3 manifest: docs/reference/source-audit/source-mastery/manifests/large-wave/form5500.json.","superseded_by":null,"tools":["pbm_compensation_rollup"],"dataset_id":"dol_form5500_efast2","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["ack_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_form5500_service_provider","source_fqn":"drug_silver.fact_form5500_service_provider","title":"Form 5500 Schedule C service providers (PBM compensation)","domain":"drug","stage":"silver","status":"live","grain":"One row per Form 5500 Schedule C Part 1 Item 2 service provider per filing (ack_id x row_order); served plan years 2009-2025. Pre-EFAST2 1999-2008 is secured but deferred to a separate legacy table family.","description":"DOL EFAST2 Form 5500 Schedule C Part 1 Item 2 service-provider rows served for plan years 2009-2025 through pipelines/drug/ingest/form5500_runner.py. The pre-EFAST2 Schedule C main/PART1/PART2 archive is byte-secured but is not merged into this certified EFAST2 table.","identity_key":"ack_id","row_count":4147907,"last_updated":"2026-07-26","freshness_sla":"Annual (DOL EFAST2 Latest archive per plan year).","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage/currency column on the parent filing.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Vintage is carried on the parent filing's plan_year (join on ack_id) + the is_current flag for the served EFAST2 era; pre-EFAST2 uses a separate FILING_ID legacy lane."]},"raw_queryable_via":"Athena: drug_silver.fact_form5500_service_provider (filter is_current = true)","commercial_terms":"Public DOL EFAST2 data.","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/form5500_schedule_c.md","known_gaps":["EFAST2 2009-2025 is loaded at 4,147,907 service-provider rows; the SIX-table EFAST2 family totals 32,402,086 rows. Schedule C covers SELF-FUNDED vendor compensation only; broker commissions on insured products live on fact_form5500_insurance_broker and claims paid live on fact_form5500_financials.","Pre-EFAST2 1999-2008 bytes are secured in 160 files totaling 1,973,997,290 bytes with zero misses and the full SHA-256/S3 manifest, but the legacy lane is intentionally deferred.","Pre-2009 keys on FILING_ID, not ACK_ID; Schedule C PART1 contains itemized provider compensation and PART2 contains terminated providers, so those schemas must remain separate from the EFAST2 service-provider fact.","Linked tools require era guards before any legacy serving; identity-layer use requires an explicit as-of/ranking rule."],"notes":"Terminal state complete_and_served for the EFAST2 era with a documented pre-EFAST2 source limit; archive manifest: docs/reference/source-audit/source-mastery/manifests/large-wave/form5500.json.","superseded_by":null,"tools":["pbm_compensation_rollup"],"dataset_id":"dol_form5500_efast2","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["ack_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_consumer_price","source_fqn":"drug_silver.fact_drug_consumer_price","title":"Consumer cash-price reference (Cost Plus Drugs snapshot)","domain":"drug","stage":"silver","status":"partial","grain":"One row per consumer cash-price SKU (source x sku x quantity); current snapshot includes Cost Plus Drugs plus a second consumer-price source.","description":"Consumer cash-price reference table; currently a single snapshot of the Cost Plus Drugs (Mark Cuban CPD) public catalog (source='costplusdrugs'). Columns: source, ndc11, total_price_usd, quantity, retail_comparison_price_usd, drug_name, unit, source_captured_at. Read by employer_cpd_carve_out for the CPD reprice demo.","identity_key":"ndc11","row_count":2386,"last_updated":"2026-05-16","raw_queryable_via":"Athena: drug_silver.fact_drug_consumer_price (filter source; employer_cpd_carve_out uses source = 'costplusdrugs')","notes":"Linked tool employer_cpd_carve_out (#23 only; pbm_compensation_rollup does not read it). Source-surface catalogue only - pricing is CPD's published consumer price, not a Vlada claim.","superseded_by":null,"tools":[],"dataset_id":"cost_plus_drugs_consumer_prices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_wac","source_fqn":"drug_silver.fact_drug_hcai_sb17_wac_increase","title":"WAC increases — California HCAI SB 17 notices","domain":"drug","stage":"silver","status":"partial","grain":"One row per (report_year, oshpd_id, NDC11, wac_effective_date, drug_category) increase notice; NULL drug_category coalesces to '' in the certified key (revised per the 2026-07-02 accepted gate design -- a genuine 2025 Brand/Generic publisher pair shares the old 4-column key).","description":"Event-level Wholesale Acquisition Cost increase notices with manufacturer explanations (CA HCAI SB 17). The public lens on WAC list-price actions.","identity_key":"ndc11","row_count":null,"last_updated":null,"raw_queryable_via":"Tool: wac_pricing_lookup; Athena: drug_silver.fact_drug_hcai_sb17_wac_increase","notes":"2024-04-01 regulatory change swapped unit-sales for gross-sales-USD.","superseded_by":null,"tools":[],"dataset_id":"ca_hcai_sb17_wac_increases","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_ira_mfp","source_fqn":"drug_silver.fact_drug_reimbursement#ira_mfp","title":"IRA Maximum Fair Price (CMS-negotiated)","domain":"drug","stage":"silver","status":"live","grain":"One row per valid (NDC11, IPAY program_year, MFP effective_period_start, MFP effective_period_end) negotiated MFP price period.","description":"CMS Inflation-Reduction-Act negotiated maximum fair prices. Current official selected-drug publication has valid priced periods effective in 2026 and 2027; selected-only 2028 rows are not price facts until CMS publishes MFP amounts.","identity_key":"ndc11","row_count":null,"last_updated":"2026-05-25","raw_queryable_via":"Tool: ira_mfp_exposure; Athena: drug_silver.fact_drug_reimbursement (filter price_type='ira_mfp' and is_current=true)","notes":"Implemented end-to-end (pipelines/drug/silver/ira_mfp_*); parser serves only valid MFP price intervals and profiles raw CMS update rows separately.","superseded_by":null,"tools":["ira_drug_label_risk_screen","ira_mfp_exposure"],"dataset_id":"ds_drug_ira","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_formularies","source_fqn":"drug_logical.fact_drug_formulary_scaffold","title":"Drug formulary coverage scaffold (superseded)","domain":"drug","stage":"silver","status":"planned","grain":"One row per (contract_id, plan_id, NDC11, observed_month).","description":"Original empty scaffold for Part D formulary coverage (never populated). Superseded by the CMS SPUF substrate — the live formulary data is in drug_silver.fact_drug_formulary (see source_id drug_spuf_formulary).","identity_key":"ndc11","row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":"Empty scaffold — use drug_spuf_formulary (drug_silver.fact_drug_formulary) for live formulary data.","notes":"Retained for traceability; see docs/architecture/2026-05-17-spuf-formulary-substrate-assignment.md.","superseded_by":null,"tools":[],"dataset_id":"ds_drug_formularies","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_formulary","source_fqn":"drug_silver.fact_drug_formulary","title":"Part D formulary coverage (CMS SPUF)","domain":"drug","stage":"silver","status":"live","grain":"One row per (formulary_id, NDC11, report_quarter).","description":"NDC-grained Part D formulary coverage from CMS SPUF: tier_level_value, prior authorization, step therapy, quantity limits, and selected-drug flag across all MA-PD + PDP formularies. The coverage lens for employer audits. Resolve plan -> formulary_id via dim_part_d_plan.","identity_key":"ndc11","row_count":42858106,"last_updated":"2026-05-18","freshness_sla":"Quarterly (CMS SPUF release).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","CMS SPUF release; filter is_current = true; grain is formulary (not plan)."]},"raw_queryable_via":"Tools: formulary_lens, formulary_churn, formulary_coverage_lookup; Athena: drug_silver.fact_drug_formulary","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/spuf_part_d_formulary.md","known_gaps":["29 quarters (2019-Q1..2026-Q1); promoted 2026-05-18 (enterprise_v1) — confirm latest quarter against live substrate.","~29.41% of SPUF NDCs don't resolve to dim_drug (legacy NDC gap); brand->NDC lookups miss historical NDCs.","tier_level_value is coverage, not a dollar amount; filter is_current = true.","NEVER COMBINE with the monthly Formulary and Pharmacy Network tables (drug_silver.*_monthly): at each quarter's last month the rows are identical to this SPUF quarter (2026-06 = 2026-Q2: 0 rows differ either way in all five shared tables, Athena 3d5d3d50; all 30 quarters 2019-Q1..2026-Q2 have a monthly twin), but the file checksum (sha256_content_hash) differs at all 30 quarter ends (Athena 63bc51b4). Never UNION the two cadences, and dedupe by row content, never by checksum.","selected_drug_yn IS FALSE WHERE CMS PUBLISHED NO FLAG (defect PDPM-4, measured 2026-09-30): the column first appears in the 2025-Q4 file (PUFRecordLayout-2026 p.7; the 2019-Q1..2025-Q3 headers end at STEP_THERAPY_YN, read from bronze), but the loader turned the missing cell into FALSE, so 40,614,502 rows of 2019-Q1..2025-Q3 read 'not a negotiation drug' (Athena 61c626a3-3183-464e-b804-e7200c4b5b3b). Read drug_silver.vw_fact_drug_formulary_v2 (NULL before 2025-Q4) or treat selected_drug_yn before 2025-Q4 as unpublished. Every other column here is unaffected."],"notes":"SPUF substrate sibling of fact_drug_formulary_excluded; grain is formulary (not plan) — many plans share a formulary_id.","superseded_by":null,"tools":["formulary_churn"],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_formulary_v2","source_fqn":"drug_silver.vw_fact_drug_formulary_v2","title":"Part D formulary coverage (CMS SPUF), selected-drug flag only where CMS published it","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (formulary_id, NDC11, report_quarter); the rows of drug_silver.fact_drug_formulary (43,982,692 on 2026-09-30, Athena fb131d6c-9b07-4531-9918-737b89902038; view minus table = 0, bbce86c6-7078-4783-a6d6-0c0027744f12).","description":"Every column of drug_silver.fact_drug_formulary, with selected_drug_yn as CMS published it: the flag (Does this NDC represent one of the Part D drugs selected for negotiation under the Medicare Drug Price Negotiation Program?, PUFRecordLayout-2026 p.7) from 2025-Q4 on, NULL for 2019-Q1..2025-Q3, whose files carry no such column. selected_drug_yn_legacy keeps the stored FALSE.","identity_key":"ndc11","row_count":43982692,"last_updated":"2026-09-30","freshness_sla":"Quarterly; a view over drug_silver.fact_drug_formulary, so a new SPUF quarter appears when the loader appends it.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","CMS SPUF release; filter is_current = true; grain is formulary (not plan)."]},"raw_queryable_via":"Athena: drug_silver.vw_fact_drug_formulary_v2 (filter is_current = true, pin report_quarter)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-09-30 (Athena 8a957e99-c9b0-4f11-9f81-7d51b2b52e14) from pipelines/drug/semantic/fact_drug_formulary_v2.sql over drug_silver.fact_drug_formulary; every row keeps source_url, sha256_content_hash, bronze_object_key, asserted_at. Rollback: DROP VIEW.","context_doc_path":"docs/context_library/drug/spuf_part_d_formulary.md","known_gaps":["selected_drug_yn: NULL for 40,614,502 rows of 2019-Q1..2025-Q3 (no column in those files); 2025-Q4..2026-Q2: 40,470 true of 3,368,190 (Athena 61c626a3-3183-464e-b804-e7200c4b5b3b). The boundary is the measured header of every held quarter's basic-formulary member.","tier_level_value is coverage, not a dollar amount; filter is_current = true and pin report_quarter.","NEVER COMBINE with the monthly tables (drug_silver.*_monthly or drug_silver.vw_fact_drug_formulary_monthly_v2): the quarter-end month repeats this quarter row for row."],"notes":"Versioned view (Data Tracker served-defect lane, 2026-09-30, defect PDPM-4); supersedes selected_drug_yn of drug_silver.fact_drug_formulary. The customer tools formulary_lens / formulary_coverage_lookup apply the same rule in code. Record docs/reference/source-audit/source-mastery/records/cms_monthly_pdp_formulary.json field_dictionary.defects PDPM-4.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_formulary_excluded","source_fqn":"drug_silver.fact_drug_formulary_excluded","title":"Part D formulary exclusion list (CMS SPUF)","domain":"drug","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, drug_identifier, drug_identifier_type, report_quarter).","description":"Plan-level explicit drug-exclusion list from CMS SPUF, with tier, prior-auth, step-therapy, quantity-limit, and capped-benefit flags. The cross-cut \"which plans exclude drug X / how the exclusion list grew\" lens.","identity_key":"drug_identifier","row_count":355140,"last_updated":"2026-05-18","freshness_sla":"Quarterly (CMS SPUF release).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","CMS SPUF release; filter is_current = true; the drug_identifier type varies by quarter (ndc 2019, rxcui 2020-Q1 on; Athena 809be7df); filter on drug_identifier_type, never assume NDC11."]},"raw_queryable_via":"Tools: exclusion_lens, formulary_coverage_lookup; Athena: drug_silver.fact_drug_formulary_excluded","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/spuf_part_d_formulary.md","known_gaps":["The identifier type varies by quarter: drug_identifier_type is 'ndc' for 2019-Q1..2019-Q4 (19,537 rows) and 'rxcui' from 2020-Q1 on (349,320 rows through 2026-Q2; 2019-Q1..2024-Q3 alone: 249,030 RxCUI vs 19,537 NDC); every row is is_current = true (Athena 809be7df-1c13-44b7-a6cb-261b09679cd0, 2026-10-06). Earlier text said NDC11 for 2019-2024 and RxCUI only from 2025: wrong for 2020-2024. ALWAYS filter on drug_identifier_type before matching and never assume NDC11; an NDC lookup finds nothing after 2019 without an NDC->RxCUI crosswalk.","29 quarters (2019-Q1..2026-Q1); promoted 2026-05-18 (enterprise_v1) — confirm latest quarter against live substrate.","NEVER COMBINE with the monthly Formulary and Pharmacy Network tables (drug_silver.*_monthly): at each quarter's last month the rows are identical to this SPUF quarter (2026-06 = 2026-Q2: 0 rows differ either way in all five shared tables, Athena 3d5d3d50; all 30 quarters 2019-Q1..2026-Q2 have a monthly twin), but the file checksum (sha256_content_hash) differs at all 30 quarter ends (Athena 63bc51b4). Never UNION the two cadences, and dedupe by row content, never by checksum."],"notes":"SPUF substrate sibling of fact_drug_formulary; filter is_current = true.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["drug_identifier"],"backing_store":"glue"},{"source_id":"drug_spuf_plan_dim","source_fqn":"drug_silver.dim_part_d_plan","title":"Part D plan dimension (CMS SPUF)","domain":"drug","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_quarter).","description":"The Part D plan-identity dim from CMS SPUF: the plan -> formulary bridge and carrier/plan attribution for the whole SPUF family. Columns (from DIM_PART_D_PLAN_SCHEMA in pipelines/drug/silver/spuf_writers.py): contract_name, plan_name, formulary_id, premium, deductible, ma_region_code, pdp_region_code, snp, plan_suppressed_yn, plan_type, plus the is_current vintage flag. Resolve contract_id/plan_id -> formulary_id here before joining fact_drug_formulary. Geography (state, county_code) is NOT here — it moved to fact_part_d_plan_service_area on 2026-05-17 after Gate A.5 caught 4,587 PK collisions (one dim row was being written once per served county).","identity_key":"contract_id,plan_id,segment_id","row_count":160922,"last_updated":"2026-05-18","freshness_sla":"Quarterly (CMS SPUF release; publishes ~6 weeks after quarter close).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true."]},"raw_queryable_via":"Tools: plan_landscape, cost_share_lens, pricing_lens (+ all formulary tools resolve plan->formulary here); Athena: drug_silver.dim_part_d_plan (filter is_current = true)","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["160,922 rows; 29 quarters (2019-Q1..2026-Q1); promoted 2026-05-18 (enterprise_v1) — confirm latest quarter against live substrate.","Geography is NOT on this dim — ANY state/county filter must join fact_part_d_plan_service_area.","formulary_id -> dim resolution is 100% (all 12,337 formulary-quarters resolve); pricing plan -> dim is 100% (159,984 plan-quarters).","NEVER COMBINE with the monthly Formulary and Pharmacy Network tables (drug_silver.*_monthly): at each quarter's last month the rows are identical to this SPUF quarter (2026-06 = 2026-Q2: 0 rows differ either way in all five shared tables, Athena 3d5d3d50; all 30 quarters 2019-Q1..2026-Q2 have a monthly twin), but the file checksum (sha256_content_hash) differs at all 30 quarter ends (Athena 63bc51b4). Never UNION the two cadences, and dedupe by row content, never by checksum.","plan_type IS WRONG FOR EVERY LOCAL MA-PD PLAN (defect PDPM-1, measured 2026-09-30): the parser set 'MA-PD' only when MA_REGION_CODE is filled, and CMS fills it only for R contracts (PUFRecordLayout-2026 p.3), so every H plan is 'OTHER' (2026-Q2: 5,123 H 'OTHER', 28 R 'MA-PD', 367 S 'PDP'; Athena 2d5899da-2620-4616-b3d2-9449e9f21c15). Read plan_type from drug_silver.vw_dim_part_d_plan_v3, which takes it from CMS's organization type for the contract (2026-Q2: 5,141 MA-PD, 10 COST, 367 PDP; Athena 3059920a-59de-4b44-9f5b-43a323d55319). The contract-id prefix alone is NOT a plan type: H contracts also hold 1876 Cost and Medicare-Medicaid demo plans. Every other column here is right."],"notes":"SPUF plan-identity dim shared by cost_share_lens, pricing_lens, and (for plan->formulary) the formulary tools; filter is_current = true. plan_landscape and formulary_coverage_lookup read drug_silver.vw_dim_part_d_plan_v3 since 2026-09-30 (PDPM-1); this table is unchanged and stays the physical storage.","superseded_by":null,"tools":["formulary_churn"],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_plan_dim_v3","source_fqn":"drug_silver.vw_dim_part_d_plan_v3","title":"Part D plan dimension (CMS SPUF), plan type from CMS's organization type","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_quarter) among is_current rows; 0 duplicate keys, 166,440 rows = drug_silver.dim_part_d_plan (Athena 622fdb61-469e-4096-90b8-2719a68c363b).","description":"The SPUF Part D plan dim (every column of drug_silver.dim_part_d_plan) with plan_type from CMS's own organization type for the contract, read from CMS Monthly Enrollment by Contract/Plan (medicare_silver.enrollment_monthly_plan): 'MA-PD' (Local CCP, Regional CCP, PFFS, MSA), 'COST' (1876 Cost, HCPP - 1833 Cost), 'DEMO' (Demo: Medicare-Medicaid Plans), 'PACE' (National PACE), 'PDP'. cms_organization_type carries CMS's wording verbatim; plan_type_source says 'cms_contract_file' or, where CMS's contract file has no row for the contract, 'contract_prefix_fallback' (the record layout's H/R = MA, S = PDP rule); contract_id_prefix is the letter alone; plan_type_legacy keeps the stored value, which called every local MA-PD plan 'OTHER'.","identity_key":"contract_id,plan_id,segment_id","row_count":166440,"last_updated":"2026-09-30","freshness_sla":"Quarterly; a view over drug_silver.dim_part_d_plan and medicare_silver.enrollment_monthly_plan, so a new SPUF quarter appears when the loader appends it.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true."]},"raw_queryable_via":"Tools: plan_landscape, formulary_coverage_lookup; Athena: drug_silver.vw_dim_part_d_plan_v3 (filter is_current = true)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-09-30 (Athena ebb39d54-1e3c-4e88-841d-a4e308566561) from pipelines/drug/semantic/dim_part_d_plan_v3.sql over drug_silver.dim_part_d_plan LEFT JOIN a contract-level organization type from medicare_silver.enrollment_monthly_plan; every row keeps source_url, sha256_content_hash, bronze_object_key, asserted_at. Rollback: repoint the tools to _v2 in git, then DROP VIEW.","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["2026-Q2: 5,141 MA-PD, 10 COST, 367 PDP, all from CMS's contract file (Athena 3059920a-59de-4b44-9f5b-43a323d55319). Over 30 quarters: MA-PD 142,178 + 13 by prefix fallback (one contract, H7394, absent from CMS's contract file), DEMO 1,018, COST 414, PDP 22,817 (Athena 79a801df-31b9-4dd8-a99a-f1b991fcd3eb).","The organization type is contract-level and exact across quarters: 0 contracts carry two organization types in any year since 2018 (Athena 3d52c658-118c-485b-b509-4a3a08ccf874). A SPUF Q4 file already carries the next contract year.","Supersedes drug_silver.vw_dim_part_d_plan_v2 (2026-09-30, never served), whose prefix rule labelled H-numbered 1876 Cost and Medicare-Medicaid demo plans 'MA-PD' (#3064 adversarial review, Athena 04d25008). The v2 view stays in Glue, unread.","Geography is NOT on this dim; any state/county filter joins fact_part_d_plan_service_area.","NEVER COMBINE with the monthly Formulary and Pharmacy Network tables (drug_silver.*_monthly; the monthly twin is drug_silver.vw_dim_part_d_plan_monthly_v3, register cms_monthly_pdp_formulary_pharmacy_network)."],"notes":"Versioned view (Data Tracker served-defect lane, 2026-09-30, defect PDPM-1 revision 3). Versioned, never overwritten; record docs/reference/source-audit/source-mastery/records/cms_monthly_pdp_formulary.json field_dictionary.defects PDPM-1.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_plan_dim_v4","source_fqn":"drug_silver.vw_dim_part_d_plan_v4","title":"Part D plan dimension (CMS SPUF), plan type from CMS's organization type, names as CMS wrote them","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, report_quarter) among is_current rows; 0 duplicate keys, 166,440 rows = drug_silver.dim_part_d_plan (Athena 622fdb61-469e-4096-90b8-2719a68c363b).","description":"The SPUF Part D plan dim (every column of drug_silver.dim_part_d_plan) with plan_type from CMS's own organization type for the contract, read from CMS Monthly Enrollment by Contract/Plan (medicare_silver.enrollment_monthly_plan): 'MA-PD' (Local CCP, Regional CCP, PFFS, MSA), 'COST' (1876 Cost, HCPP - 1833 Cost), 'DEMO' (Demo: Medicare-Medicaid Plans), 'PACE' (National PACE), 'PDP'. cms_organization_type carries CMS's wording verbatim; plan_type_source says 'cms_contract_file' or, where CMS's contract file has no row for the contract, 'contract_prefix_fallback' (the record layout's H/R = MA, S = PDP rule); contract_id_prefix is the letter alone; plan_type_legacy keeps the stored value, which called every local MA-PD plan 'OTHER'. Plan names carry CMS's accented letters (v4).","identity_key":"contract_id,plan_id,segment_id","row_count":166440,"last_updated":"2026-10-01","freshness_sla":"Quarterly; a view over drug_silver.dim_part_d_plan and medicare_silver.enrollment_monthly_plan, so a new SPUF quarter appears when the loader appends it.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true."]},"raw_queryable_via":"Tools: plan_landscape, formulary_coverage_lookup; Athena: drug_silver.vw_dim_part_d_plan_v4 (filter is_current = true)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-01 (Athena c7985634-3ee9-432b-bd4d-f908ff234b17) from pipelines/drug/semantic/dim_part_d_plan_v4.sql over drug_silver.vw_dim_part_d_plan_v3 LEFT JOIN drug_silver.part_d_plan_name_correction_v1.","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["PLAN NAMES: CMS writes the Puerto Rico and other accented plan names in Windows-1252; v3 serves 121 rows with U+FFFD in place of the letter ('�ptimo Plus (PPO)'). Here plan_name is re-read from each row's bronze plan-information member and decoded as cp1252 ('Óptimo Plus (PPO)'); plan_name_legacy keeps v3's value and plan_name_source says which (defect PDPM-5, drug_silver.part_d_plan_name_correction_v1).","2026-Q2: 5,141 MA-PD, 10 COST, 367 PDP, all from CMS's contract file (Athena 3059920a-59de-4b44-9f5b-43a323d55319). Over 30 quarters: MA-PD 142,178 + 13 by prefix fallback (one contract, H7394, absent from CMS's contract file), DEMO 1,018, COST 414, PDP 22,817 (Athena 79a801df-31b9-4dd8-a99a-f1b991fcd3eb).","The organization type is contract-level and exact across quarters: 0 contracts carry two organization types in any year since 2018 (Athena 3d52c658-118c-485b-b509-4a3a08ccf874). A SPUF Q4 file already carries the next contract year.","Supersedes drug_silver.vw_dim_part_d_plan_v2 (2026-09-30, never served), whose prefix rule labelled H-numbered 1876 Cost and Medicare-Medicaid demo plans 'MA-PD' (#3064 adversarial review, Athena 04d25008). The v2 view stays in Glue, unread.","Geography is NOT on this dim; any state/county filter joins fact_part_d_plan_service_area.","NEVER COMBINE with the monthly Formulary and Pharmacy Network tables (drug_silver.*_monthly; the monthly twin is drug_silver.vw_dim_part_d_plan_monthly_v4, register cms_monthly_pdp_formulary_pharmacy_network)."],"notes":"Versioned view (Data Tracker small-served-fixes lane, 2026-10-01, defect PDPM-5 history): v3 plus the 121 corrected plan names; v4 minus v3 rows = 0 (Athena 4d442f75). Record docs/reference/source-audit/source-mastery/records/cms_monthly_pdp_formulary.json (served_corrections).","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_plan_service_area","source_fqn":"drug_silver.fact_part_d_plan_service_area","title":"Part D plan service area (CMS SPUF)","domain":"drug","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, segment_id, state, county_code, report_quarter).","description":"Plan x geography fact from CMS SPUF — which counties each Part D plan serves. Split out of dim_part_d_plan on 2026-05-17 (Gate A.5) because a plan serves many counties and the source row is plan x service-area, not plan alone. Columns: contract_id, plan_id, segment_id, state, county_code (FIPS), report_quarter, plus is_current. The geographic-filter axis for plan_landscape.","identity_key":"contract_id,plan_id,segment_id","row_count":2387499,"last_updated":"2026-05-18","freshness_sla":"Quarterly (CMS SPUF release; publishes ~6 weeks after quarter close).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true."]},"raw_queryable_via":"Tool: plan_landscape; Athena: drug_silver.fact_part_d_plan_service_area (filter is_current = true)","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["2,387,499 rows ([40,136..115,564] per quarter); 29 quarters (2019-Q1..2026-Q1); promoted 2026-05-18 — confirm latest quarter against live substrate.","No county_name column — county identity is the FIPS county_code only; join an external FIPS->name crosswalk for display.","Plan identity attributes (name, premium, formulary_id) are NOT here — join dim_part_d_plan on (contract_id, plan_id, segment_id, report_quarter).","NEVER COMBINE with the monthly Formulary and Pharmacy Network tables (drug_silver.*_monthly): at each quarter's last month the rows are identical to this SPUF quarter (2026-06 = 2026-Q2: 0 rows differ either way in all five shared tables, Athena 3d5d3d50; all 30 quarters 2019-Q1..2026-Q2 have a monthly twin), but the file checksum (sha256_content_hash) differs at all 30 quarter ends (Athena 63bc51b4). Never UNION the two cadences, and dedupe by row content, never by checksum.","Holds MA-PD (H/R) contracts only: 660 H contracts and 0 S contracts in 2026-Q2 (Athena 088b9110). The stand-alone PDP county footprint is medicare_silver.pdp_contract_service_area, not this table."],"notes":"SPUF service-area fact; PK widened from the dim per feedback_family_acceptance_standard (widen-where-structurally-needed). Filter is_current = true.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_plan_cost_share","source_fqn":"drug_silver.fact_part_d_plan_cost_share","title":"Part D plan cost-share (CMS SPUF)","domain":"drug","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, segment_id, coverage_level, tier, days_supply, report_quarter).","description":"Beneficiary cost-share fact from CMS SPUF — copay/coinsurance by coverage phase x tier x days_supply. The fact stores cost as cost_type_pref (CMS enum: 1=copay/dollar, 2=coinsurance/fraction) + cost_amt_pref plus min/max and preferred/non-preferred/mail-order variants (see FACT_PART_D_PLAN_COST_SHARE_SCHEMA). coverage_level int maps (per CMS SPUF Tech Notes) 0=pre_initial/deductible, 1=initial_coverage, 2=coverage_gap (donut hole), 3=catastrophic. Carries tier_specialty_yn, ded_applies_yn, and a methodology_era stamp.","identity_key":"contract_id,plan_id,segment_id","row_count":4939689,"last_updated":"2026-05-18","freshness_sla":"Quarterly (CMS SPUF release; publishes ~6 weeks after quarter close).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true; do NOT aggregate across the CY2025 IRA Part-D redesign era boundary (from the 2024-Q4 release)."]},"raw_queryable_via":"Tools: cost_share_lens, formulary_coverage_lookup; Athena: drug_silver.fact_part_d_plan_cost_share (filter is_current = true)","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["4,939,689 rows ([132,565..189,649] per quarter); 29 quarters (2019-Q1..2026-Q1); promoted 2026-05-18 — confirm latest quarter against live substrate.","IRA Part-D redesign (contract year 2025, first in the 2024-Q4 release; a Q4 release carries the next contract year) eliminates the coverage gap + adds a $2,000 OOP cap: the coverage_level enum + copay structure differ structurally before vs from CY2025; do NOT aggregate across the boundary (gap_registry: ira_part_d_redesign_2026; CMS Methodology-SPUF-2026.pdf p.1).","cost_share is beneficiary OOP, NOT a net price; cost_type_pref discriminates copay (dollars) vs coinsurance (fraction-of-allowed) — never compare the two raw amounts.","NEVER COMBINE with the monthly Formulary and Pharmacy Network tables (drug_silver.*_monthly): at each quarter's last month the rows are identical to this SPUF quarter (2026-06 = 2026-Q2: 0 rows differ either way in all five shared tables, Athena 3d5d3d50; all 30 quarters 2019-Q1..2026-Q2 have a monthly twin), but the file checksum (sha256_content_hash) differs at all 30 quarter ends (Athena 63bc51b4). Never UNION the two cadences, and dedupe by row content, never by checksum.","SUPERSEDED FOR READING (2026-10-05): days_supply here is CMS's CODE (1 = 30 days, 2 = 90, 4 = 60), not days, so a filter or join on 30 / 60 / 90 matches nothing or the wrong rows; methodology_era says pre_ira on the CY2025/CY2026 releases; the cost_min_amt_* NULLs at coverage_level 3 in 2020-Q2..2023-Q3 are CMS's statutory-minimum tokens. Read drug_silver.vw_fact_part_d_plan_cost_share_v3 (row for row this table, Athena 948b3c7d); cost_share_lens reads it. This table is its rollback."],"notes":"SPUF cost-share fact; the cross-cut companion to formulary_coverage_lookup (single-(drug,plan)). Filter is_current = true.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_plan_cost_share_v3","source_fqn":"drug_silver.vw_fact_part_d_plan_cost_share_v3","title":"Part D plan cost share (CMS SPUF), days supply in days, era by contract year, catastrophic statutory-minimum tokens","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, coverage_level, tier, days_supply_code, report_quarter); row for row drug_silver.fact_part_d_plan_cost_share (5,112,331 = 5,112,331 rows, 30 of 30 quarters equal, no fan-out from the token join; every cost_type_pref / cost_amt_pref equal; Athena 948b3c7d, 00dc28ba).","description":"Quarterly SPUF beneficiary cost share by plan x coverage level x tier x days supply. days_supply_code is CMS's code (1=30, 2=90, 3=other, 4=60 days); days_supply_days is the days it means: filter and join pricing on days_supply_days. contract_year / methodology_era / ira_phase as the pricing view (a Q4 release carries the next contract year). cost_min_amt_*_code and cost_min_amt_*_basis carry CMS's '*' (generic statutory minimum) and '**' (brand statutory minimum) tokens where the catastrophic minimum cell printed a token instead of dollars (2020-Q2..2023-Q3). cost_share_lens reads this view from 2026-10-05.","identity_key":"contract_id,plan_id,segment_id,coverage_level,tier,days_supply_code","row_count":5112331,"last_updated":"2026-10-05","freshness_sla":"Quarterly; a view over drug_silver.vw_fact_part_d_plan_cost_share_v2 (itself over the table) and drug_silver.fact_part_d_plan_cost_share_catastrophic_token.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the release quarter; contract_year is the plan year it describes.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true."]},"raw_queryable_via":"Tools: cost_share_lens; Athena: drug_silver.vw_fact_part_d_plan_cost_share_v3 (filter is_current = true; pin report_quarter)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-05 from pipelines/drug/semantic/fact_part_d_plan_cost_share_v3.sql over vw_fact_part_d_plan_cost_share_v2 LEFT JOIN drug_silver.fact_part_d_plan_cost_share_catastrophic_token (defects SPUFQ-2, SPUFQ-3, SPUFQ-4; record docs/reference/source-audit/source-mastery/records/partd_spuf.json). Rollback: repoint the tool to the table in git; the table is unchanged and still served.","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["days_supply is a CODE in the table (1 = 30 days, 2 = 90, 4 = 60; 3 = other, never observed): is_current rows 1,941,749 at 30 days, 1,787,770 at 90, 1,382,812 at 60 (Athena f21836ea). There is deliberately no column named days_supply here.","CATASTROPHIC TOKENS: 1,154,187 rows (2020-Q2..2023-Q3) carry '*' / '**' in a cost_min_amt_*_code column, where the table holds NULL: the statutory minimum (generic / brand), not an unknown. Value-level acceptance PASS, 0 perturbation survivors (docs/data-tracker/DRUG-LOADER-RELOAD-PLAN-2026-10-01.md).","IRA Part D redesign is contract year 2025 (first in the 2024-Q4 release): three phases instead of four, coverage gap eliminated, $2,000 out-of-pocket cap (Methodology-SPUF-2026 p.1). Never aggregate cost share across CY2024 -> CY2025; filter on contract_year.","cost_share is beneficiary out-of-pocket, NOT a price; cost_type_pref discriminates copay (dollars) vs coinsurance (fraction); never compare the two raw amounts.","NEVER COMBINE with the monthly cost-share table (drug_silver.fact_part_d_plan_cost_share_monthly); its catastrophic tokens are not restored yet (3,279,780 CY2020-2023 rows NULL, the monthly bronze was not kept)."],"notes":"Versioned view (Data Tracker drug wave 1B, PR 3114). drug_silver.vw_fact_part_d_plan_cost_share_v2 (the same without the tokens) stays in Glue unregistered; v3 is the served version. Versioned, never overwritten.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["coverage_level","days_supply_code","tier"],"backing_store":"glue"},{"source_id":"drug_spuf_plan_drug_pricing","source_fqn":"drug_silver.fact_part_d_plan_drug_pricing","title":"Part D plan drug pricing (CMS SPUF)","domain":"drug","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, segment_id, ndc11, days_supply, report_quarter).","description":"Plan x NDC unit-cost fact from CMS SPUF — THE BIG ONE (~43M-61M rows/quarter). Columns: contract_id, plan_id, segment_id, ndc11, days_supply, report_quarter, unit_cost (USD), methodology_era, plus is_current. The unit-cost / pricing-trend / plan-to-plan variance axis. Resolve brand_name -> NDC via dim_drug_label (uncatalogued shared label dim) and plan identity via dim_part_d_plan.","identity_key":"contract_id,plan_id,segment_id,ndc11","row_count":1593644611,"last_updated":"2026-05-18","freshness_sla":"Quarterly (CMS SPUF release; publishes ~6 weeks after quarter close).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true and ALWAYS pin report_quarter (1.59B rows)."]},"raw_queryable_via":"Tools: pricing_lens, formulary_coverage_lookup; Athena: drug_silver.fact_part_d_plan_drug_pricing (filter is_current = true; ALWAYS pin report_quarter — 1.59B rows)","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["1,593,644,611 rows (1.59B; [43.1M..61.3M] per quarter); 29 quarters (2019-Q1..2026-Q1); promoted 2026-05-18 — confirm latest quarter against live substrate. ALWAYS pin report_quarter; full scans are prohibitively large.","unit_cost is a plan LIST unit cost, NOT a net (post-rebate) price — the substrate does not see confidential rebates.","Cross-era pricing trends cross the IRA boundaries by CONTRACT year (CY2025 redesign from the 2024-Q4 release; CY2026 negotiated prices for the ten selected drugs from the 2025-Q4 release); gross unit_cost is more comparable than cost-share but flag the era break (gap_registry: ira_era_break_2026; CMS Methodology-SPUF-2026.pdf p.1-2).","~29.41% of SPUF NDCs don't resolve to dim_drug (legacy NDC gap); brand_name -> NDC lookups miss historical NDCs.","PLAN<->FORMULARY/COST-SHARE JOIN RECIPE: this table keys by (contract_id, plan_id, segment_id, ndc11, days_supply, report_quarter) and ties to the MA plan via contract_id+plan_id (same keys as the MA enrollment/payment tables). fact_drug_formulary keys by FORMULARY_ID, not contract/plan (many plans share one formulary), so to attach tier/PA you must hop through dim_part_d_plan to get formulary_id. Recipe: pr JOIN drug_silver.dim_part_d_plan d ON (pr.contract_id=d.contract_id AND pr.plan_id=d.plan_id AND pr.segment_id=d.segment_id AND pr.report_quarter=d.report_quarter) JOIN drug_silver.fact_drug_formulary f ON (d.formulary_id=f.formulary_id AND pr.ndc11=f.ndc11 AND pr.report_quarter=f.report_quarter) -> f.tier_level_value (tier), f.prior_authorization_yn (PA). For member cost-share, join drug_silver.fact_part_d_plan_cost_share on (contract_id,plan_id,segment_id,report_quarter) + tier_level_value + coverage_level + days_supply. ALWAYS pin contract_id+plan_id+report_quarter. This is how an agent answers 'what does MA plan H####-### cover and charge for drug X' from raw SQL, no baked tool needed.","SUPERSEDED FOR READING (2026-10-05): unit_cost in report quarters 2019-Q1..Q3 is a cost per FILL (CY2019 COST), not a unit price (130,754,320 rows), and methodology_era says pre_ira on the CY2025/CY2026 releases 2024-Q4..2025-Q4; the days_supply here is days, the cost-share table's is a code. Read drug_silver.vw_fact_part_d_plan_drug_pricing_v2 (row for row this table, Athena 2d01f782); pricing_lens, formulary_coverage_lookup, drug_price_composite and monitor_drug_price_shocks read it. This table is their rollback."],"notes":"SPUF pricing fact; the cross-cut companion to formulary_coverage_lookup. dim_drug_label (brand->NDC) stays uncatalogued — shared cross-cutting label dim. Filter is_current = true.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","fda:ndc"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_spuf_plan_drug_pricing_v2","source_fqn":"drug_silver.vw_fact_part_d_plan_drug_pricing_v2","title":"Part D plan drug pricing (CMS SPUF), per-unit price with the CY2019 cost-per-fill set apart and the era by contract year","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (contract_id, plan_id, segment_id, ndc11, days_supply, report_quarter, cms_vintage_sequence); row for row drug_silver.fact_part_d_plan_drug_pricing (1,647,406,675 = 1,647,406,675 rows over 30 of 30 quarters, 2019-Q1..2026-Q2; Athena 2d01f782).","description":"Quarterly SPUF Plan Finder retail point-of-sale price per unit (not net of rebates), by plan x NDC x days supply (days). 2019-Q1..Q3 published only a cost per fill: unit_cost is NULL there and fill_cost_cy2019 holds it. contract_year is the plan year the release describes (a Q4 release carries the next year); methodology_era is pre_ira through CY2024 and ira_oop_cap from CY2025; 'pre_ira' means before the CY2025 benefit redesign, not untouched by the IRA (CY2023 insulin cap, CY2024 catastrophic cost share removed): filter on contract_year for those. ira_phase splits CY2025 (redesign) from CY2026 (first negotiated prices). unit_cost_legacy and methodology_era_legacy keep the stored values.","identity_key":"contract_id,plan_id,segment_id,ndc11","row_count":1647406675,"last_updated":"2026-10-05","freshness_sla":"Quarterly; a view over drug_silver.fact_part_d_plan_drug_pricing, so a new SPUF quarter appears when the loader appends it.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the release quarter; contract_year is the plan year it describes.","CMS SPUF release (~6 weeks after quarter close); filter is_current = true and ALWAYS pin report_quarter."]},"raw_queryable_via":"Tools: pricing_lens, formulary_coverage_lookup, drug_price_composite, monitor_drug_price_shocks; Athena: drug_silver.vw_fact_part_d_plan_drug_pricing_v2 (filter is_current = true; ALWAYS pin report_quarter, 1.65B rows)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-05 from pipelines/drug/semantic/fact_part_d_plan_drug_pricing_v2.sql over drug_silver.fact_part_d_plan_drug_pricing (defects SPUFQ-1, SPUFQ-2; record docs/reference/source-audit/source-mastery/records/partd_spuf.json). Every row keeps source_url, sha256_content_hash, bronze_object_key, asserted_at. Rollback: repoint the tools to the table in git; the table is unchanged and still served.","context_doc_path":"docs/context_library/drug/spuf_part_d_plan_pricing.md","known_gaps":["CY2019 COST PER FILL: report quarters 2019-Q1..Q3 published COST, \"Average cost for specified days supply\" (PricingSPUFRecordLayout_2019.xlsx), not UNIT_COST. 130,754,320 rows carry unit_cost NULL and fill_cost_cy2019 = that fill cost (unit_cost_basis 'cost_per_fill_cy2019'). Eliquis 00003089421 2019-Q2: median 894.41 per fill vs 4.15 per unit in 2026-Q2 (Athena fc032aaf). A per-unit CY2019 value needs COMMON_QTY, loaded only by the planned _v3.","unit_cost is the Medicare Plan Finder in-area retail point-of-sale price per unit as published, NOT net of rebates or manufacturer discounts (Methodology-SPUF-2026 p.1: \"These files do not reflect discounts applied to these drugs\").","IRA boundaries are by CONTRACT year: CY2025 (benefit redesign, first in the 2024-Q4 release) and CY2026 (the ten negotiated-price drugs of IPAY 2026, first in the 2025-Q4 release). 2024-Q4..2025-Q4 carry methodology_era ira_oop_cap here and pre_ira in the table (275,278,136 rows).","days_supply here is DAYS (30 / 60 / 90). The cost-share table's days_supply is a CODE: join cost share through drug_silver.vw_fact_part_d_plan_cost_share_v3.days_supply_days.","ALWAYS pin report_quarter and filter is_current; an unpinned scan is ~1.65B rows."],"notes":"Versioned view (Data Tracker drug wave 1B, PR 3114). Versioned, never overwritten; the table card stays live as the rollback.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","fda:ndc"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_orange_book","source_fqn":"drug_silver.dim_orange_book_product","title":"FDA Orange Book (patents + exclusivity)","domain":"drug","stage":"silver","status":"partial","grain":"One row per (application_number, product_id, observed_month).","description":"FDA approved-drug products with therapeutic-equivalence, patent, and exclusivity metadata. Drives generic-launch timing queries.","identity_key":"application_number","row_count":null,"last_updated":null,"freshness_sla":"Monthly (FDA Orange Book data files).","recollection":{"cadence":"monthly","watermark_field":"observed_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'observed_month' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","FDA Orange Book monthly data files; patent/exclusivity date formats vary across vintages."]},"raw_queryable_via":"Tool: prove_drug_patent_status; Athena: drug_silver.dim_orange_book_product","commercial_terms":"Public FDA data.","provenance_chain_ref":"drug_source_registry_cache","context_doc_path":"docs/context_library/drug/nadac_wac_and_formulary.md","known_gaps":["Tilde-delimited; patent/exclusivity date formats vary across vintages."],"notes":"Companion facts fact_orange_book_patent + fact_orange_book_exclusivity.","superseded_by":null,"tools":[],"dataset_id":"fda_orange_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["application_number"],"backing_store":"glue"},{"source_id":"drug_purple_book","source_fqn":"drug_logical.dim_purple_book_product_reference","title":"FDA Purple Book (biosimilars + reference products)","domain":"drug","stage":"reference","status":"planned","grain":"One row per (BLA_number, product_id, observed_quarter).","description":"FDA licensed biological products with biosimilar interchangeability designations. The biosimilar-substitution lens.","identity_key":"bla_number","row_count":null,"last_updated":null,"raw_queryable_via":null,"notes":"Reference-domain logical entry; the live queryable surface is the silver table drug_purple_book_silver. Status planned in the drug source catalog (phase_4_plus).","superseded_by":null,"tools":[],"dataset_id":"ds_drug_purple","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["bla_number"],"backing_store":"glue"},{"source_id":"drug_purple_book_silver","source_fqn":"drug_silver.dim_purple_book_product","title":"FDA Purple Book — licensed biologics + biosimilars (silver)","domain":"drug","stage":"silver","status":"partial","grain":"One row per (bla_number, product_number) per snapshot.","description":"The promoted silver Purple Book: FDA licensed biological products with license_type (351(a) reference biologic vs 351(k) biosimilar / interchangeable), reference-product linkage, and exclusivity dates. The biosimilar-substitution lens behind the biosimilar_window MCP tool.","identity_key":"bla_number","row_count":null,"last_updated":null,"raw_queryable_via":"Tool: biosimilar_window; Athena: drug_silver.dim_purple_book_product","notes":"Promoted silver behind the planned reference entry drug_purple_book (drug_silver.dim_purple_book_product); biosimilar_window also overlays fact_drug_spending_part_d (not catalogued in this lane).","superseded_by":null,"tools":[],"dataset_id":"fda_purple_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["bla_number"],"backing_store":"glue"},{"source_id":"drug_dea_schedules","source_fqn":"drug.dea_controlled_substances","title":"DEA Controlled Substance Schedules","domain":"drug","stage":"reference","status":"planned","grain":"One row per (registrant/substance, observed_date) schedule designation.","description":"DEA Schedule II-V controlled-substance designations. Legally load-bearing flags for Part D / Sunshine analysis.","identity_key":"dea_number","row_count":null,"last_updated":null,"raw_queryable_via":"Tool: dea_schedule_lookup (catalog metadata + scouted parser)","notes":"Reference-domain logical entry; the live queryable surface is the silver table drug_dea_ndc_schedule. Tool surface exists; full ingest is phase_4_plus.","superseded_by":null,"tools":[],"dataset_id":"ds_drug_dea","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["dea_number"],"backing_store":"glue"},{"source_id":"drug_dea_ndc_schedule","source_fqn":"drug_silver.dim_dea_ndc_schedule","title":"DEA controlled-substance schedule by NDC (silver)","domain":"drug","stage":"silver","status":"planned","grain":"One row per (ndc11, ingredient_key) — combo drugs carry one row per ingredient.","description":"NDC-level DEA Controlled Substances Act schedule (I–V, or NULL for non-controlled / secondary-ingredient rows) with narcotic flag and DEA drug code, partitioned by csa_schedule. The legally load-bearing scheduling dimension behind the dea_schedule_lookup MCP tool.","identity_key":"ndc11","row_count":null,"last_updated":null,"raw_queryable_via":"Tool: dea_schedule_lookup; Athena: drug_silver.dim_dea_ndc_schedule","notes":"Promoted silver behind the planned reference entry drug_dea_schedules (drug.dea_controlled_substances); dea_schedule_lookup also reads dim_drug_label (brand->NDC), not catalogued in this lane.","superseded_by":null,"tools":[],"dataset_id":"dea_controlled_substance_schedules","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_open_payments","source_fqn":"drug_silver.fact_drug_payment_to_prescriber","title":"CMS Open Payments (Sunshine Act)","domain":"drug","stage":"silver","status":"live","grain":"One row per exploded General Payment drug/biological slot at (program_year, payment_id, npi, ndc11/drug name) grain; pure device/no-drug rows are intentionally out of this drug fact.","description":"CMS Open Payments General Payment transfers from drug and device manufacturers/GPOs to covered recipients, filtered here to drug/biological payment slots and joined by NPI/NDC for conflict-of-interest and integrity analysis.","identity_key":"payment_id","row_count":56372438,"last_updated":"2026-05-19","raw_queryable_via":"Tool: open_payments_prescriber_corr; Athena: drug_silver.fact_drug_payment_to_prescriber","notes":"Source Truth 2026-07-02 prepared historical/restatement replay manifest; production replay remains acceptance-gated and must run on worker/Fargate due multi-GB annual files. 2026-08-03 added the device-slice parser/writer under a separate acceptance gate; the drug ingest path is unchanged and device parsing is off unless --with-device is passed.","superseded_by":null,"tools":["excluded_prescriber_payment_screen"],"dataset_id":"cms_open_payments","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["payment_id"],"backing_store":"glue"},{"source_id":"cms_nppes_data_dissemination","source_fqn":"s3://vlada-platform-raw/nppes","title":"CMS NPPES Data Dissemination release bundle","domain":"provider_identity","stage":"raw","status":"design_locked","grain":"Publication bundle with separate grains: NPI main row; NPI x practice location; NPI x alias; NPI x endpoint; monthly deactivation NPI.","description":"Immutable upstream CMS NPPES V2 full-replacement bundle plus the separate monthly deactivation report. Shadow observations preserve all locations, taxonomies, other identifiers, aliases, endpoints, status, and row-level lineage; no NPI=care-site assertion.","identity_key":"observation_id (release + member + source row + observation family + family subkey + canonical row hash)","row_count":56874736,"last_updated":"2026-07-21","raw_queryable_via":"S3 immutable observations under the certified July release prefix; no accepted serving pointer.","notes":"Public EIN and parent-organization TIN are suppressed; never infer. NPI issuance does not validate licensure or credentialing.","superseded_by":null,"tools":[],"dataset_id":"ds_cms_nppes","dataset_assignment_basis":"source_id_prefix","layer":"raw","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["canonical","family","hash","member","observation","observation_id","release","row","source","subkey"],"backing_store":"s3"},{"source_id":"provider_dim_provider","source_fqn":"vlada_curated.dim_provider","title":"NPPES provider directory","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per NPI.","description":"NPPES-derived provider directory: name, entity type (individual/org), taxonomy/specialty, location, and parent organizational NPI. Resolves any NPI emitted by a rate query. From nppes_version 2026-09, taxonomy is the PRIMARY taxonomy (Primary Taxonomy Switch = Y); taxonomy_code_1 keeps Taxonomy Code_1 as printed (the pre-2026-09 meaning).","identity_key":"npi","row_count":9798758,"last_updated":"2026-09-23","raw_queryable_via":"Tool: provider_substrate_lookup; Athena: vlada_curated.dim_provider","provenance_chain_ref":null,"notes":"entity_type 1 = individual, 2 = organization. taxonomy semantics are versioned: through 2026-03 Taxonomy Code_1 as printed; from 2026-09 the primary taxonomy (differs from Code_1 for 976,458 of 9,798,758 NPIs in the September 2026 release); taxonomy_basis names the rule; nppes_source_sha256 is the release zip.","superseded_by":null,"tools":["resolve_provider"],"dataset_id":"cms_nppes_data_dissemination","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"provider_dim_provider_service","source_fqn":"vlada_curated.dim_provider_service","title":"Medicare PUF (NPI x HCPCS utilization)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per (npi, hcpcs_cd, place_of_service) — most recent CMS PUF observation (current cache; data_year 2021-2023 reflects per-key recency)","description":"Medicare Physician & Other Practitioners PUF — current deduped provider-service cache used by the ghost-rate filter and provider-service lookups. The cache keeps the most recent CMS PUF observation for each (npi, hcpcs_cd, place_of_service) key.","identity_key":"npi,hcpcs_cd,place_of_service","row_count":14161974,"last_updated":"2026-07-10","freshness_sla":"Annual (CMS PUF release).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field data_year is the per-key recency field, not a vintage dimension."]},"raw_queryable_via":"Athena: vlada_curated.dim_provider_service","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/provider_dim_provider_service.json","context_doc_path":"docs/context_library/joins_and_gotchas.md","known_gaps":["Current-cache semantics: data_year is per-key recency, not a vintage dimension; do not use this table for time series.","Historical provider-service trends for 2013-2020 PUF years (~4.8GB) and 2024 availability are deferred until that product need is real; a separate year-preserving table and worker-fleet build would be required.","Do not backfill historical years through the current runner: it silently discards older observations on key collision (manifest lines 18-28)."],"notes":"14,161,974 rows; zero duplicate (npi,hcpcs_cd,place_of_service) keys; data_year 2021-2023 reflects per-key recency; single loaded_at batch. Current cache serves the ghost-rate filter and provider-service lookups, not historical trends.","superseded_by":null,"tools":[],"dataset_id":"vlada_w2_medicare_benchmarks","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:hcpcs","nppes:npi"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"],"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":["place_of_service"],"backing_store":"glue"},{"source_id":"provider_dim_facility","source_fqn":"vlada_curated.dim_facility","title":"Facility dimension","domain":"provider_identity","stage":"dim","status":"partial","grain":"One row per facility (CCN/organizational NPI) with metadata.","description":"Facility-level metadata (CCN, organizational NPI, name, location) used to anchor the CCN<->NPI bridge and hospital identity spine.","identity_key":"hospital_ccn","row_count":null,"last_updated":"2026-05-28","freshness_sla":"Updated with NPPES + hospital discovery.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","Facility dim: updated with NPPES + hospital discovery — cadence follows its upstreams."]},"raw_queryable_via":"Athena: vlada_curated.dim_facility","commercial_terms":"Public NPPES/CMS data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/joins_and_gotchas.md","known_gaps":[],"notes":null,"superseded_by":null,"tools":["resolve_provider"],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_clia_lab_roster","source_fqn":"vlada_curated.dim_clia_lab","title":"CMS POS-CLIA Clinical Laboratory Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per certified CLIA laboratory (by CLIA number) per quarterly POS snapshot.","description":"CMS Provider of Services File — Clinical Laboratories (POS-CLIA): the quarterly roster of every CLIA-certified clinical laboratory in the US, published by CMS on data.cms.gov. ~103 source columns reduced to the roster spine — CLIA number, facility name(s), city/state/ZIP, composed 5-digit county FIPS, Medicare/CCN-style number, active flag (from the termination code), and the ownership/facility/certificate/lab-class category codes. Identifies and locates the lab side of diagnostic care (county join + a possible CCN bridge via CLIA_MDCR_NUM). Refreshed each quarter; the runner discovers the current CSV from data.cms.gov's data.json so it always pulls the latest quarter.","identity_key":"clia_number","row_count":null,"last_updated":null,"raw_queryable_via":"Athena: vlada_curated.dim_clia_lab (Iceberg: medicare_silver.dim_clia_lab)","provenance_chain_ref":null,"notes":"Iceberg table medicare_silver.dim_clia_lab, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_pos_clia_laboratory_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["clia_number"],"backing_store":"glue"},{"source_id":"cms_pos_asc_roster","source_fqn":"vlada_curated.dim_asc","title":"CMS POS Ambulatory Surgical Center Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified ambulatory surgical center (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, iQIES distribution (\"Provider of Services File - Internet Quality Improvement and Evaluation System\"): the quarterly multi-provider-type POS file, FILTERED to ASC rows (prvdr_type_id = \"11\"). ASCs were migrated off the legacy OSCAR/QIES \"Hospital_and_other\" file onto iQIES, so this is the current home of the certified-ASC roster. ~182 source columns reduced to the roster spine — CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag (from pgm_trmntn_cd), provider type/subtype, ownership/control code, and ASC begin-service date. The runner discovers the current CSV from data.cms.gov's data.json so it always pulls the latest quarter.","identity_key":"ccn","row_count":null,"last_updated":null,"freshness_sla":"Quarterly (CMS POS iQIES quarterly files).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena: vlada_curated.dim_asc (Iceberg: medicare_silver.dim_asc)","provenance_chain_ref":null,"context_doc_path":"docs/context_library/medicare/cms_pos_asc_roster.md","known_gaps":["ASCs are NOT in the legacy Hospital_and_other QIES file; they live in the iQIES file, filtered by prvdr_type_id = '11' (no PRVDR_CTGRY_CD column exists; the '23' category-code lore does not apply).","Terminated ASCs remain in the file; filter is_active = true for the live roster (pgm_trmntn_cd '00' = not terminated).","iQIES encodes missing values as literal 'Not Applicable'/'Not Available' strings (coerced to null); control_type_cd is currently unpopulated for ASCs.","POS is the Medicare-certified universe only; cash-only / non-Medicare surgery centers need an NPPES tail (taxonomy 261QA1903X).","county_fips is null when either FIPS component is blank/sentinel — never a fabricated partial code."],"notes":"Iceberg table medicare_silver.dim_asc, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_medicare_dialysis_facilities","source_fqn":"vlada_curated.dim_dialysis_facility","title":"CMS Medicare Dialysis Facilities Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per (observed_period, ccn) — 18 annual FY vintages 2009-2026.","description":"CMS Medicare Dialysis Facilities (Dialysis Facility Reports): the annual roster of every Medicare-certified dialysis facility published by CMS on data.cms.gov. The mastered base table preserves one row per (observed_period, ccn) across FY2009-FY2026; the curated source_fqn is a current-vintage view.","identity_key":"observed_period,ccn","row_count":125408,"last_updated":"2026-07-10","raw_queryable_via":"Athena: vlada_curated.dim_dialysis_facility (VIEW serving max(observed_period)); historian base table: medicare_silver.dim_dialysis_facility","notes":"The source_fqn vlada_curated.dim_dialysis_facility is a VIEW serving only the current vintage over base table medicare_silver.dim_dialysis_facility; historians must query the base table. The view pins max(observed_period), because is_current is per-CCN latest assertion and is not current-roster truth.","superseded_by":null,"tools":[],"dataset_id":"cms_medicare_dialysis_facilities","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":["observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"mart_unified_pricing","source_fqn":"vlada_curated.mart_unified_pricing","title":"Hospital x commercial unified pricing mart","domain":"curated","stage":"mart","status":"design_locked","grain":"One row per unified (CCN/NPI, payer, code, methodology) fact with markup + methodology-compat flag.","description":"The differentiated join: hospital prices x commercial negotiated rates with provenance and a methodology-compatibility gate. markup_ratio is NULL whenever methodologies are incompatible (fiduciary-grade).","identity_key":"hospital_ccn","row_count":null,"last_updated":null,"raw_queryable_via":"Builder pipelines/spark/marts/build_mart_unified_pricing_b1.py (B1 slice); gold table not yet promoted.","notes":"Governed by docs/architecture/2026-04-25-hospital-commercial-unification.md.","superseded_by":null,"tools":[],"dataset_id":"ds_mart_unified","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"provenance_substrate_mrf_version","source_fqn":"dim_substrate_mrf_version","title":"Unified substrate MRF version ledger","domain":"provenance","stage":"registry","status":"live","grain":"One row per (substrate, natural_key, content_sha256) observed MRF file.","description":"Substrate-wide audit chain: every fetched MRF (commercial / hospital / medicare) gets a row with content hash, raw S3 key, parser artifact hash, and first/last-seen timestamps. The provenance backbone for receipts + replay.","identity_key":"content_sha256","row_count":null,"last_updated":"2026-05-28","raw_queryable_via":"Postgres vlada_enterprise: dim_substrate_mrf_version","notes":"dim_commercial_mrf_version is a back-compat view over this table.","superseded_by":null,"tools":[],"dataset_id":"ds_provenance_substrate","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"registry","purpose":"provenance","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["content_sha256"],"backing_store":"postgres"},{"source_id":"provenance_medicare_source_registry","source_fqn":"medicare_source_registry_cache","title":"Medicare source registry cache","domain":"provenance","stage":"registry","status":"live","grain":"One row per (source_id, observed_period, s3_object).","description":"Postgres mirror of the medicare_silver source-registry Iceberg table — bronze manifest in queryable form for restatement detection + replay.","identity_key":"source_id","row_count":null,"last_updated":"2026-05-28","raw_queryable_via":"Postgres vlada_enterprise: medicare_source_registry_cache","known_gaps":[],"notes":"Tracks cms_vintage_sequence + parse_revision + restatement chain.","superseded_by":null,"tools":[],"dataset_id":"ds_provenance_medicare","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"registry","purpose":"provenance","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":[],"backing_store":"postgres"},{"source_id":"provenance_drug_source_registry","source_fqn":"drug_source_registry_cache","title":"Drug source registry cache","domain":"provenance","stage":"registry","status":"live","grain":"One row per (source_id, observed_period, s3_object).","description":"Drug-side mirror of medicare_source_registry_cache. source_publication_date generalizes cms_publication_date (FDA / DOL / NLM / HRSA / SEC / state DOIs).","identity_key":"source_id","row_count":null,"last_updated":"2026-05-28","raw_queryable_via":"Postgres vlada_enterprise: drug_source_registry_cache","known_gaps":[],"notes":"Same column shape as migration 031, drug-specific natural-key naming.","superseded_by":null,"tools":[],"dataset_id":"ds_provenance_drug","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"registry","purpose":"provenance","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":[],"backing_store":"postgres"},{"source_id":"provenance_hospital_mrf_version","source_fqn":"dim_mrf_version","title":"Hospital MRF version ledger","domain":"provenance","stage":"registry","status":"live","grain":"One row per (hospital_ccn, content_sha256) observed HPT file.","description":"Per-MRF-fetch version tracking for the hospital substrate. fact_hospital_ chargemaster rows reference it via mrf_version_id. Detects ping-only updates.","identity_key":"hospital_ccn","row_count":null,"last_updated":"2026-05-28","raw_queryable_via":"Postgres vlada_enterprise: dim_mrf_version","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_provenance_hospital","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"registry","purpose":"provenance","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"postgres"},{"source_id":"medicare_pbp_section_b13_other_services","source_fqn":"medicare_silver.pbp_section_b13_other_services","title":"PBP Section B13 — Other Services (silver)","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, report_year, quarter) PBP segment record.","description":"Medicare Plan Benefit Package (PBP) Section B13 \"Other Services\" silver table, built by pipelines/medicare/ingest/pbp_runner.py from the CMS PBP SAS source into a medicare_silver Iceberg table. This is the exact source surface the PBP benefit tools read for this section; the entry catalogues table identity only, not benefit semantics.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":null,"freshness_sla":"annual","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","PBP grain carries report_year (+ quarter); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018) and pre-2010 PK is synthesized (PBP-PK-PRE-2010).","PBP source: a null numeric benefit amount is NOT $0 — consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation; this block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"athena","commercial_terms":"public-domain (CMS)","provenance_chain_ref":null,"context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["row_count not pinned (null) — no checked-in artifact measures it; catalog never invents counts.","Field-level benefit semantics are governed by the PBP semantic policy + docs/skills/pbp-semantics/SKILL.md, not this entry. Null numeric amount is NOT $0.","Pre-2010 PK synthesized (PBP-PK-PRE-2010); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018), per pipelines/medicare/data/grain/."],"notes":"Source-surface catalogue only. Null numeric benefit amounts are NOT $0 and field availability is not benefit semantics; consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation. Shared by compare_pbp_benefits, find_pbp_plans_by_benefit, get_pbp_benefit, and get_pbp_consumer_reconciliation_candidates.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b16_dental","source_fqn":"medicare_silver.pbp_section_b16_dental","title":"PBP Section B16 — Dental (silver)","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, report_year, quarter) PBP segment record.","description":"Medicare Plan Benefit Package (PBP) Section B16 dental-benefit silver table, built by pipelines/medicare/ingest/pbp_runner.py from the CMS PBP SAS source into a medicare_silver Iceberg table. This is the exact source surface the PBP benefit tools read for this section; the entry catalogues table identity only, not benefit semantics.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":null,"freshness_sla":"annual","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","PBP grain carries report_year (+ quarter); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018) and pre-2010 PK is synthesized (PBP-PK-PRE-2010).","PBP source: a null numeric benefit amount is NOT $0 — consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation; this block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"athena","commercial_terms":"public-domain (CMS)","provenance_chain_ref":null,"context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["row_count not pinned (null) — no checked-in artifact measures it; catalog never invents counts.","Field-level benefit semantics are governed by the PBP semantic policy + docs/skills/pbp-semantics/SKILL.md, not this entry. Null numeric amount is NOT $0.","Pre-2010 PK synthesized (PBP-PK-PRE-2010); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018), per pipelines/medicare/data/grain/."],"notes":"Source-surface catalogue only. Null numeric benefit amounts are NOT $0 and field availability is not benefit semantics; consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation. Shared by compare_pbp_benefits, find_pbp_plans_by_benefit, get_pbp_benefit, and get_pbp_consumer_reconciliation_candidates.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b17_eye_exams_wear","source_fqn":"medicare_silver.pbp_section_b17_eye_exams_wear","title":"PBP Section B17 — Eye Exams / Eyewear (silver)","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, report_year, quarter) PBP segment record.","description":"Medicare Plan Benefit Package (PBP) Section B17 eye-exam / eyewear silver table, built by pipelines/medicare/ingest/pbp_runner.py from the CMS PBP SAS source into a medicare_silver Iceberg table. This is the exact source surface the PBP benefit tools read for this section; the entry catalogues table identity only, not benefit semantics.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":null,"freshness_sla":"annual","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","PBP grain carries report_year (+ quarter); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018) and pre-2010 PK is synthesized (PBP-PK-PRE-2010).","PBP source: a null numeric benefit amount is NOT $0 — consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation; this block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"athena","commercial_terms":"public-domain (CMS)","provenance_chain_ref":null,"context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["row_count not pinned (null) — no checked-in artifact measures it; catalog never invents counts.","Field-level benefit semantics are governed by the PBP semantic policy + docs/skills/pbp-semantics/SKILL.md, not this entry. Null numeric amount is NOT $0.","Pre-2010 PK synthesized (PBP-PK-PRE-2010); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018), per pipelines/medicare/data/grain/."],"notes":"Source-surface catalogue only. Null numeric benefit amounts are NOT $0 and field availability is not benefit semantics; consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation. Shared by compare_pbp_benefits, find_pbp_plans_by_benefit, get_pbp_benefit, and get_pbp_consumer_reconciliation_candidates.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_section_b18_hearing_exams_aids","source_fqn":"medicare_silver.pbp_section_b18_hearing_exams_aids","title":"PBP Section B18 — Hearing Exams / Aids (silver)","domain":"medicare","stage":"silver","status":"partial","grain":"One row per (contract_id, plan_id, segment_id, version, report_year, quarter) PBP segment record.","description":"Medicare Plan Benefit Package (PBP) Section B18 hearing-exam / hearing-aid silver table, built by pipelines/medicare/ingest/pbp_runner.py from the CMS PBP SAS source into a medicare_silver Iceberg table. This is the exact source surface the PBP benefit tools read for this section; the entry catalogues table identity only, not benefit semantics.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":null,"freshness_sla":"annual","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","PBP grain carries report_year (+ quarter); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018) and pre-2010 PK is synthesized (PBP-PK-PRE-2010).","PBP source: a null numeric benefit amount is NOT $0 — consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation; this block governs refresh cadence only, not benefit semantics."]},"raw_queryable_via":"athena","commercial_terms":"public-domain (CMS)","provenance_chain_ref":null,"context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["row_count not pinned (null) — no checked-in artifact measures it; catalog never invents counts.","Field-level benefit semantics are governed by the PBP semantic policy + docs/skills/pbp-semantics/SKILL.md, not this entry. Null numeric amount is NOT $0.","Pre-2010 PK synthesized (PBP-PK-PRE-2010); quarterly grain not published pre-2018 (PBP-QUARTERLY-PRE-2018), per pipelines/medicare/data/grain/."],"notes":"Source-surface catalogue only. Null numeric benefit amounts are NOT $0 and field availability is not benefit semantics; consult docs/skills/pbp-semantics/SKILL.md before any benefit interpretation. Shared by compare_pbp_benefits, find_pbp_plans_by_benefit, get_pbp_benefit, and get_pbp_consumer_reconciliation_candidates.","superseded_by":null,"tools":["get_pbp_benefit"],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_idtf_imaging_roster","source_fqn":"medicare_silver.dim_imaging_facility","title":"CMS PECOS Public Provider Enrollment — IDTF (imaging) Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per approved Independent Diagnostic Testing Facility enrollment (by enrollment_id) per PPEF extract.","description":"A slice of the CMS Medicare Fee-For-Service Public Provider Enrollment (PPEF) file, FILTERED to Independent Diagnostic Testing Facilities (IDTF; provider_type_cd in the 12-47 enrollment-type band). This is the imaging / diagnostic-testing leg of the care-site spine — it locates fixed-base and mobile imaging facilities that bill Medicare Part B. One PPEF extract fully restates the IDTF roster (supersession by extract, not row-level delta).","identity_key":"enrollment_id","row_count":null,"last_updated":null,"freshness_sla":"Refreshed when CMS republishes the PPEF extract (no fixed clock).","recollection":{"cadence":"event_driven","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_imaging_facility","context_doc_path":"docs/context_library/medicare/cms_pos_idtf_imaging_roster.md","known_gaps":["IDTF only — the PPEF file carries every Medicare-enrolled provider type, but only provider_type_cd 12-47 (IDTF) is extracted today; physicians/NPPs/hospitals/other enrollment types are NOT loaded.","PECOS-enrolled universe only; cash-only / non-Medicare imaging needs an NPPES taxonomy tail."],"notes":"Iceberg table medicare_silver.dim_imaging_facility; one extract fully restates the roster (idempotent by SHA-256). Runner: pipelines/medicare/ingest/idtf_runner.py.","superseded_by":null,"tools":[],"dataset_id":"cms_pecos_public_provider_enrollment","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["enrollment_id"],"backing_store":"glue"},{"source_id":"cms_facility_affiliation","source_fqn":"drug_silver.dim_facility_affiliation","title":"CMS Facility Affiliation (Doctors & Clinicians) — NPI→CCN bridge","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per clinician NPI ↔ affiliated facility (CCN) edge, partitioned by facility_type.","description":"The CMS \"Facility Affiliation\" file from the Doctors and Clinicians / Provider Data Catalog — maps each clinician NPI to the facilities they are affiliated with (Hospital, Home health agency, Hospice, SNF, etc.), carrying the facility CCN. The standing NPI→CCN affiliation bridge used for provider substrate lookups and RBP duplicate-discount screening. Partitioned by facility_type so a single category scans without a full-table read.","identity_key":"npi","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_facility_affiliation","notes":"Iceberg table drug_silver.dim_facility_affiliation (physically in drug_silver for M-2 envelope sharing; conceptually a provider-identity bridge). Runner: pipelines/drug/ingest/facility_affiliation_runner.py.","superseded_by":null,"tools":[],"dataset_id":"cms_doctors_clinicians_facility_affiliation","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_dim_external_bridge","source_fqn":"vlada_curated.dim_hospital_external","title":"Hospital Identity Crosswalk — CCN ↔ NPI ↔ EIN bridge","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per hospital identity, keyed by CCN, carrying the resolved NPI and (where recovered) EIN.","description":"The hospital identity crosswalk that joins the commercial (NPI), hospital (CCN), and tax-entity (EIN) namespaces. The employer agent uses it to resolve EIN/tax-id → CCN when a claim line has no usable NPI, and the county/flywheel tools use it for CCN↔NPI dedup. Distinct from dim_hospital_identity (the broader hospital spine); this is the external-id bridge specifically.","identity_key":"ccn","row_count":null,"last_updated":null,"freshness_sla":"Derived; rebuilt when the hospital spine / chargemaster reprocess runs.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt as a derived bridge when the hospital chargemaster/spine reprocesses; no independent publication clock."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_hospital_external","commercial_terms":"Derived from public CMS/NPPES data; freely redistributable.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/hospital_dim_external_bridge.md","known_gaps":["EIN is the weakest column — recovered from chargemaster source-URL filenames (CMS names files <EIN>_name_standardcharges) and not fully back-populated; a 2026-06 audit found EIN on ~2.7k of ~6k CCNs while NPI was ~100%. Treat null EIN as 'not recovered', not 'no EIN'.","EIN→CCN resolution is only safe on a UNIQUE match; multi-CCN tax entities (systems) must not collapse to one CCN."],"notes":"Iceberg table vlada_curated.dim_hospital_external. See memory project_hospital_identity_crosswalk_2026-06-26 for the audited counts.","superseded_by":null,"tools":["resolve_provider"],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"nucc_provider_taxonomy","source_fqn":"drug_silver.dim_nucc_taxonomy","title":"NUCC Healthcare Provider Taxonomy Code Set","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per NUCC taxonomy code per published version (vintage snapshot).","description":"The NUCC Healthcare Provider Taxonomy — the specialty/classification code set (e.g. 207K00000X = Allergy & Immunology) that every NPI in NPPES carries 1-N of. Decodes provider specialty for cross-vertical code lookups and provider classification. Published biannually (version <YY><M>, M=1 Jan / 2 Jul); ~900 rows. Codes are stable once issued; each version is a snapshot.","identity_key":"code","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_nucc_taxonomy","notes":"Iceberg table drug_silver.dim_nucc_taxonomy (physically in drug_silver for M-2 envelope sharing; conceptually a provider-identity vocabulary). Runner: pipelines/drug/ingest/nucc_taxonomy_runner.py.","superseded_by":null,"tools":[],"dataset_id":"nucc_provider_taxonomy_code_set","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["code"],"backing_store":"glue"},{"source_id":"icd10cm_code_dim","source_fqn":"drug_silver.dim_icd10cm","title":"ICD-10-CM Diagnosis Code Dimension","domain":"curated","stage":"dim","status":"live","grain":"One row per (effective FY vintage, code)","description":"The full ICD-10-CM diagnosis code set (code + description) by federal fiscal-year vintage — the diagnosis vocabulary that grounds claim-line diagnosis fields, the ICD-10→HCC crosswalk, and clinical interpretation. Distinct from the medicare_dim_icd10_hcc_crosswalk (which only maps the HCC-relevant subset); this is the complete code dimension.","identity_key":"icd10cm_code","row_count":1490532,"last_updated":"2026-07-12","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_icd10cm","notes":"Iceberg table drug_silver.dim_icd10cm. Runner: pipelines/drug/ingest/icd10cm_runner.py.","superseded_by":null,"tools":[],"dataset_id":"cms_icd10_cm_code_set","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["icd10cm_code"],"backing_store":"glue"},{"source_id":"icd10pcs_code_dim","source_fqn":"drug_silver.dim_icd10pcs","title":"ICD-10-PCS Inpatient Procedure Code Dimension","domain":"curated","stage":"dim","status":"live","grain":"One row per (effective FY vintage, code)","description":"The full ICD-10-PCS inpatient procedure code set (code + description) by federal fiscal-year vintage — the inpatient procedure vocabulary that feeds MS-DRG grouping logic and inpatient claim interpretation.","identity_key":"icd10pcs_code","row_count":1221444,"last_updated":"2026-07-12","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_icd10pcs","notes":"Iceberg table drug_silver.dim_icd10pcs. Runner: pipelines/drug/ingest/icd10pcs_runner.py.","superseded_by":null,"tools":[],"dataset_id":"cms_icd10_pcs_code_set","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["icd10pcs_code"],"backing_store":"glue"},{"source_id":"fda_ndc_directory","source_fqn":"drug_silver.dim_drug","title":"FDA NDC Directory (drug product dimension)","domain":"drug","stage":"dim","status":"live","grain":"One row per NDC (11-digit, product+package) — the FDA drug product/package dimension.","description":"The FDA National Drug Code Directory — the authoritative drug product dimension (NDC11, product code, package code, labeler, proprietary/ non-proprietary name, dosage form, route). The identity spine for every NDC that appears in NADAC, ASP, WAC, Part D pricing, and formulary tables.","identity_key":"ndc11","row_count":null,"last_updated":"2026-07-11","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_drug","notes":"Iceberg table drug_silver.dim_drug. Runner: pipelines/drug/ingest/fda_ndc_directory_runner.py.","superseded_by":null,"tools":["ira_mfp_exposure","recall_spend_window"],"dataset_id":"fda_ndc_directory","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_part_d_spending","source_fqn":"drug_silver.fact_drug_spending_part_d","title":"Medicare Part D Spending by Drug (PUF)","domain":"drug","stage":"silver","status":"live","grain":"One row per drug (brand/generic) per data_year — aggregate Medicare Part D spending.","description":"The Medicare Part D Spending by Drug public-use file — annual aggregate Part D spend, claim counts, beneficiary counts, and unit cost trend per drug. The macro drug-spend lens (which drugs drive Part D dollars and how unit costs move year over year), complementing the NDC-level pricing tables.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":"Annual (CMS Part D spending dashboard release).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage/currency column."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_spending_part_d","provenance_chain_ref":"drug_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","known_gaps":["Aggregate per-drug-per-year only — no provider, plan, or beneficiary grain; not joinable to a specific NDC without the drug-name crosswalk.","NEVER BOTH with the Quarterly Part D Spending by Drug file (medicare_silver.fact_part_d_spending_by_drug_quarterly, preliminary, year to date; 2025 Q1-Q4 + 2026 Q1): the two will share 2025 once the annual 2025 release lands (~2027). For a settled year read this annual table only.","COLUMN NAMES RETIRED (2026-10-05, PDSPD-1): chg_avg_spend_per_dsg_unt_22_23_usd and cagr_avg_spend_per_dsg_unt_19_23_pct hold the SOURCE FILE's window (2023->2024 and 2020->2024 on data_year 2020-2024 rows; 2022->2023 and 2019->2023 on 2019 rows) as FRACTIONS, not USD or percent. Read drug_silver.vw_fact_drug_spending_part_d_v2 (row for row this table), which names them file_chg_* / file_cagr_* with their windows."],"notes":"Iceberg table drug_silver.fact_drug_spending_part_d. Runner: pipelines/drug/ingest/part_d_spending_runner.py.","superseded_by":null,"tools":["ira_mfp_exposure","recall_spend_window"],"dataset_id":"cms_part_d_spending_by_drug","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_part_d_spending_v2","source_fqn":"drug_silver.vw_fact_drug_spending_part_d_v2","title":"Medicare Part D Spending by Drug (PUF), the file's change and CAGR columns named for their window","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (brand_name, generic_name, manufacturer_name, data_year); row for row drug_silver.fact_drug_spending_part_d (71,853 = 71,853 rows, total_spending_usd sums equal; Athena 3e7c390d).","description":"Part D spending by drug and manufacturer per data year, gross of rebates. file_chg_* / file_cagr_* are drug-level constants of the SOURCE FILE, as fractions, repeated on every data_year row: they do not describe the row's year. The change runs DY-1->DY. The CAGR runs from the drug's first year with data (file_cagr_from_year, 2020 for most RY26 drugs, later for drugs new to the market) to DY, over file_cagr_years years; file_cagr_from_year is NULL on 100 data_year-2019 rows whose start year is not held. 'Overall' manufacturer rows are the brand total; filter manufacturer_name or you double count.","identity_key":null,"row_count":71853,"last_updated":"2026-10-05","freshness_sla":"Annual; a view over drug_silver.fact_drug_spending_part_d.","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the benefit year of the row; file_data_year_end is the source file's last year."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.vw_fact_drug_spending_part_d_v2 (filter is_current = true)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-05 from pipelines/drug/semantic/fact_drug_spending_part_d_v2.sql over drug_silver.fact_drug_spending_part_d (defect PDSPD-1; record docs/reference/source-audit/source-mastery/records/drug_part_d_spending.json). Rollback: the table, unchanged and still served.","known_gaps":["The legacy column names chg_avg_spend_per_dsg_unt_22_23_usd / cagr_avg_spend_per_dsg_unt_19_23_pct are retired here: they held the source file's window (2023->24 / 2020->24 on data_year 2020-2024 rows) as FRACTIONS, not USD or percent. Read file_chg_avg_spend_per_dosage_unit_frac / file_cagr_avg_spend_per_dosage_unit_frac with their from/to years (recomputed and matched on 10,208/10,208 RY26 and 9,990/9,990 RY25 rows; CAGR window per drug on 13,376/13,376 and 13,148/13,148).","Aggregate per-drug-per-year only; no provider, plan, or beneficiary grain.","NEVER BOTH with the Quarterly Part D Spending by Drug file (medicare_silver.fact_part_d_spending_by_drug_quarterly); for a settled year read this annual data only."],"notes":"Versioned view (Data Tracker drug wave 1B, PR 3114). recall_spend_window and the other spending readers read only columns this view passes through unchanged (total_spending_usd and the counts), so they stay on the table. Versioned, never overwritten.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spending_by_drug","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ipps_wage_index","source_fqn":"medicare_silver.fact_ipps_wage_index","title":"Medicare IPPS Wage Index (geographic wage adjustment)","domain":"medicare","stage":"reference","status":"live","grain":"One row per (fiscal_year, hospital CCN) -- IPPS wage index (with cap) for inpatient localization. DEEP FY2006-2026.","description":"The CMS IPPS Wage Index with Cap (FY2026), per hospital CCN — the geographic labor-cost adjustment factor used to localize the inpatient operating payment to a hospital's labor market. Bundled as a reference CSV and consumed directly by the RBP pricing engine (wage_index_for(ccn)); it is the wage-localization leg the dim_msdrg entry flags as \"not loaded\" for absolute IPPS dollars — this is where it lives.","identity_key":"ccn","row_count":84746,"last_updated":"2026-06-27","freshness_sla":"Annual (federal fiscal year, Oct 1 start).","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Refreshed by replacing the bundled CSV at each IPPS final rule; no in-row vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ipps_wage_index (per fiscal_year, ccn). Also Python: vlada.rbp.wageindex.wage_index_for(ccn).","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/medicare/ipps_wage_index.md","known_gaps":["Bundled reference CSV, NOT an Iceberg/Athena table — not reachable via query_substrate; reached through the RBP Python helper.","Single fiscal-year snapshot in serving (FY2026 bundled CSV); official CMS FY2026 is loaded/proven in additive medicare_silver.fact_ipps_wage_index_source_truth, and FY2006 plus FY2008-FY2026 artifacts are dry-run proven. FY2008-FY2025 are not replayed/served until asserted-date/currentness/RBP migration policy is accepted; FY2006 also needs accepted handling for 584 nonnumeric '*' wage-index source rows.","FY2026 bundled file has 3,222 rows and omits official alphanumeric CCNs; alpha-CCN policy is part of the servability gate.","Wage index alone does not yield an absolute IPPS payment without the IPPS base operating rate (also not loaded as a queryable source)."],"notes":"Loaded by vlada/rbp/wageindex.py from vlada/rbp/ref/ipps_wage_index_2026.csv; source-truth dry-runs prove FY2006 and FY2008-FY2026 official CMS Table 2 artifacts, and build-ipps-wage-index writes the additive fact_ipps_wage_index_source_truth table with explicit asserted_at. Runner same-SHA skips verify intended rows before skipping. Serving remains Python-bundle scoped until accepted.","superseded_by":null,"tools":[],"dataset_id":"cms_ipps_final_rule","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_snf_roster","source_fqn":"medicare_silver.dim_snf","title":"CMS POS Skilled Nursing Facility Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified skilled nursing facility (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, iQIES distribution — the quarterly multi-provider-type POS file, FILTERED to skilled-nursing rows (prvdr_type_id = \"20\"). Same source file as dim_asc; this is the post-acute tail the ASC runner discards. Roster spine — CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag (from pgm_trmntn_cd), provider type/subtype, ownership/control code. The runner downloads the iQIES CSV once and buckets SNF/HHA/Hospice by provider type.","identity_key":"ccn","row_count":17067,"last_updated":null,"freshness_sla":"Quarterly (CMS POS iQIES quarterly files).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_snf","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_pos_post_acute_rosters.md","known_gaps":["row_count 17067 is the Q1-2026 total; ~14,710 were active (pgm_trmntn_cd '00'). Filter is_active = true for the live roster.","prvdr_type_id = '20' confirmed empirically against POS_File_iQIES_Q1_2026.csv (sample names: nursing/rehab centers); re-confirm if CMS renumbers types.","POS is the Medicare-certified universe only; non-Medicare facilities need an NPPES tail.","county_fips is null when either FIPS component is blank/sentinel — never a fabricated partial code."],"notes":"Iceberg table medicare_silver.dim_snf, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256). Shares the iQIES download with dim_hha + dim_hospice.","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_hha_roster","source_fqn":"medicare_silver.dim_hha","title":"CMS POS Home Health Agency Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified home health agency (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, iQIES distribution — the quarterly multi-provider-type POS file, FILTERED to home-health rows (prvdr_type_id = \"3\"). Same source file as dim_asc; the post-acute tail the ASC runner discards. Roster spine — CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag, provider type/subtype, ownership/control code.","identity_key":"ccn","row_count":23562,"last_updated":null,"freshness_sla":"Quarterly (CMS POS iQIES quarterly files).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_hha","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_pos_post_acute_rosters.md","known_gaps":["row_count 23562 is the Q1-2026 total; ~12,634 were active (pgm_trmntn_cd '00'). Filter is_active = true for the live roster.","prvdr_type_id = '3' confirmed empirically against POS_File_iQIES_Q1_2026.csv (sample names: home health agencies); re-confirm if CMS renumbers types.","POS is the Medicare-certified universe only; non-Medicare agencies need an NPPES tail.","county_fips is null when either FIPS component is blank/sentinel — never a fabricated partial code."],"notes":"Iceberg table medicare_silver.dim_hha, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256). Shares the iQIES download with dim_snf + dim_hospice.","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_hospice_roster","source_fqn":"medicare_silver.dim_hospice","title":"CMS POS Hospice Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified hospice (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, iQIES distribution — the quarterly multi-provider-type POS file, FILTERED to hospice rows (prvdr_type_id = \"12\"). Same source file as dim_asc; the post-acute tail the ASC runner discards. Roster spine — CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag, provider type/subtype, ownership/control code.","identity_key":"ccn","row_count":9240,"last_updated":null,"freshness_sla":"Quarterly (CMS POS iQIES quarterly files).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_hospice","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_pos_post_acute_rosters.md","known_gaps":["row_count 9240 is the Q1-2026 total; ~6,649 were active (pgm_trmntn_cd '00'). Filter is_active = true for the live roster.","prvdr_type_id = '12' confirmed empirically against POS_File_iQIES_Q1_2026.csv (sample names: hospice & palliative care); re-confirm if CMS renumbers types.","POS is the Medicare-certified universe only; non-Medicare hospices need an NPPES tail.","county_fips is null when either FIPS component is blank/sentinel — never a fabricated partial code."],"notes":"Iceberg table medicare_silver.dim_hospice, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256). Shares the iQIES download with dim_snf + dim_hha. IRF/LTCH are NOT in the iQIES file (no such prvdr_type_id) — they are a separate, unbuilt source.","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_rhc_roster","source_fqn":"medicare_silver.dim_rhc","title":"CMS POS Rural Health Clinic Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified rural health clinic (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, legacy QIES/Hospital_and_other distribution, FILTERED to rural-health-clinic rows (prvdr_ctgry_cd = '12' and prvdr_ctgry_sbtyp_cd = '01'). Roster spine -- CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag, provider category/subtype, ownership/control code. The runner downloads the POS CSV once and buckets RHC/FQHC by category.","identity_key":"ccn","row_count":12864,"last_updated":null,"freshness_sla":"Quarterly (CMS POS hospital-file quarterly snapshots).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_rhc","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_pos_rhc_fqhc_rosters.md","known_gaps":["row_count 12864 is the Q1-2026 total; ~5,756 were active (pgm_trmntn_cd '00'). Filter is_active = true for the live roster.","prvdr_ctgry_cd = '12' and prvdr_ctgry_sbtyp_cd = '01' verified 2026-06-30 by joining 2026 fact_provider_of_services to rhc facility_cost_report_unit CCNs (1,756 of 1,763 cost-report CCNs present in POS).","POS is the Medicare-certified roster, broader than the HCRIS unit-cost subset; cost pricing still requires a validated facility_cost_report_unit row for the resolved CCN."],"notes":"Iceberg table medicare_silver.dim_rhc, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256). Shares the POS download with dim_fqhc.","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_fqhc_roster","source_fqn":"medicare_silver.dim_fqhc","title":"CMS POS Federally Qualified Health Center Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified federally qualified health center site (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, legacy QIES/Hospital_and_other distribution, FILTERED to federally-qualified-health-center rows (prvdr_ctgry_cd = '21' and prvdr_ctgry_sbtyp_cd = '01'). Roster spine -- CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag, provider category/subtype, ownership/control code. The runner downloads the POS CSV once and buckets RHC/FQHC by category.","identity_key":"ccn","row_count":15324,"last_updated":null,"freshness_sla":"Quarterly (CMS POS hospital-file quarterly snapshots).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_fqhc","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_pos_rhc_fqhc_rosters.md","known_gaps":["row_count 15324 is the Q1-2026 total; ~12,969 were active (pgm_trmntn_cd '00'). Filter is_active = true for the live roster.","prvdr_ctgry_cd = '21' and prvdr_ctgry_sbtyp_cd = '01' verified 2026-06-30 by joining 2026 fact_provider_of_services to fqhc facility_cost_report_unit CCNs (4,018 of 4,072 cost-report CCNs present in POS).","POS is the Medicare-certified roster, broader than the HCRIS unit-cost subset; cost pricing still requires a validated facility_cost_report_unit row for the resolved CCN."],"notes":"Iceberg table medicare_silver.dim_fqhc, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256). Shares the POS download with dim_rhc.","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_irf_roster","source_fqn":"medicare_silver.dim_irf","title":"CMS POS Inpatient Rehabilitation Facility Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified inpatient rehabilitation facility (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, the LEGACY \"Hospital_and_other\" distribution (dataset \"Provider of Services File - Quality Improvement and Evaluation System\"), FILTERED to inpatient rehabilitation facilities (prvdr_ctgry_sbtyp_cd = \"05\"). IRFs are hospital SUBTYPES, not in the iQIES file dim_asc/dim_snf read — this is the hospital-file sibling. Roster spine — CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag (from pgm_trmntn_cd), provider subtype/category, ownership/control code. The runner downloads the hospital POS CSV once and buckets IRF/LTCH.","identity_key":"ccn","row_count":666,"last_updated":null,"freshness_sla":"Quarterly (CMS POS hospital-file quarterly snapshots).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_irf","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_pos_irf_ltch_rosters.md","known_gaps":["row_count 666 is the Q1-2026 total; ~409 were active (pgm_trmntn_cd '00'). Filter is_active = true for the live roster.","prvdr_ctgry_sbtyp_cd = '05' confirmed empirically against Hospital_and_other.DATA.Q1_2026.csv (cross-checks CCN last-4 3025-3099); re-confirm if CMS renumbers subtypes.","Rehab UNITS of acute hospitals (vs freestanding IRFs) may carry the parent hospital's CCN and not appear as a distinct '05' row.","county_fips is null when either FIPS component is blank/sentinel — never a fabricated partial code."],"notes":"Iceberg table medicare_silver.dim_irf, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256). Shares the hospital-POS download with dim_ltch.","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pos_ltch_roster","source_fqn":"medicare_silver.dim_ltch","title":"CMS POS Long-Term Care Hospital Roster","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare-certified long-term care hospital (by CCN) per quarterly POS snapshot.","description":"CMS Provider of Services File, the LEGACY \"Hospital_and_other\" distribution, FILTERED to long-term care hospitals (prvdr_ctgry_sbtyp_cd = \"02\"). LTCHs are hospital SUBTYPES, not in the iQIES file — the hospital-file sibling of the post-acute rosters. Roster spine — CCN, facility name, city/state/ZIP, composed 5-digit county FIPS, active flag, provider subtype/category, ownership/control code.","identity_key":"ccn","row_count":655,"last_updated":null,"freshness_sla":"Quarterly (CMS POS hospital-file quarterly snapshots).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for this snapshot; the source carries no in-row period column, so freshness is judged against the publication date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_ltch","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_pos_irf_ltch_rosters.md","known_gaps":["row_count 655 is the Q1-2026 total; ~313 were active (pgm_trmntn_cd '00'). Filter is_active = true for the live roster.","prvdr_ctgry_sbtyp_cd = '02' confirmed empirically against Hospital_and_other.DATA.Q1_2026.csv (cross-checks CCN last-4 2000-2299); re-confirm if CMS renumbers subtypes.","county_fips is null when either FIPS component is blank/sentinel — never a fabricated partial code."],"notes":"Iceberg table medicare_silver.dim_ltch, partitioned by state_cd; one atomic per-state replace per quarterly ingest (idempotent by SHA-256). Shares the hospital-POS download with dim_irf.","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_dme_payment_by_geo","source_fqn":"medicare_silver.fact_dme_payment_by_geo","title":"Medicare DME by Geography & Service (avg allowed/payment per HCPCS)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (geography [National|State], HCPCS, rental-indicator) per data year.","description":"CMS public-use file \"Medicare Durable Medical Equipment, Devices & Supplies - by Geography and Service\" — annual, claims-derived average Medicare ALLOWED and PAYMENT per DME HCPCS at national + per-state granularity, with submitted charge, standardized payment, and provider/supplier/beneficiary/claim/service counts. This is the pragmatic Medicare DME benchmark for repricing DME claim lines (the lines that had no Medicare anchor). NOTE: it is the claims-derived average, NOT the contractual DMEPOS Fee Schedule price list (a separate quarterly cms.gov ZIP, not yet ingested).","identity_key":"hcpcs_cd","row_count":38675,"last_updated":null,"freshness_sla":"Annual (CMS DME PUF release).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage/currency column (parsed from the filename)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_dme_payment_by_geo","context_doc_path":"docs/context_library/medicare/medicare_dme_payment_by_geo.md","known_gaps":["Claims-DERIVED average allowed/payment, NOT the contractual DMEPOS Fee Schedule (separate quarterly cms.gov ZIP; not ingested).","row_count 38,675 is the 2023 data year (ry25 release): 1,488 HCPCS x 61 geographies (National + states/territories) x rental-indicator.","CMS suppresses small cells; treat null amounts as 'not reported', not zero.","One data year per file; multi-year history needs explicit historical --source-url backfills."],"notes":"Iceberg table medicare_silver.fact_dme_payment_by_geo, partitioned by data_year; one annual file fully restates its year (replace, idempotent by SHA-256). Data year parsed from the filename (dy23 -> 2023).","superseded_by":null,"tools":[],"dataset_id":"cms_puf_dme_devices_supplies","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hospital_quality_measure","source_fqn":"medicare_silver.fact_hospital_quality_measure","title":"CMS Care Compare Hospital Quality Measures (mortality / readmissions / timely / infections / imaging / maternal)","domain":"hospital","stage":"silver","status":"live","grain":"One row per (measure_source, hospital CCN, measure_id) — the measure score + bounds.","description":"Long-format hospital quality measures from the CMS Provider Data Catalog (Care Compare), unioned across SIX source datasets into one fact, partitioned by measure_source: \"Complications and Deaths\" (mortality + complication rates), \"Unplanned Hospital Visits\" (readmission / ED-return rates), \"Timely and Effective Care\" (timeliness), \"Healthcare Associated Infections\" (HAI / SIR), \"Outpatient Imaging Efficiency\" (appropriate-imaging measures), and \"Maternal Health\" (maternal-care measures). Each row carries the raw score string + a parsed score_numeric, plus compared-to-national, denominator/sample, lower/higher estimate, footnote, and the measurement start/end dates. The QUALITY axis joinable by CCN to the hospital chargemaster spine — i.e. expensive-and-low-quality detection.","identity_key":"ccn","row_count":510084,"last_updated":null,"freshness_sla":"Refreshed when CMS republishes Care Compare (roughly quarterly).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp; the measurement window is carried per-row as start_date/end_date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hospital_quality_measure","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_hospital_quality.md","known_gaps":["row_count ~510,084 across 6 measure_sources: complications_deaths 95,840 + unplanned_visits 67,088 + timely_care 138,173 + healthcare_assoc_infections 172,512 + outpatient_imaging_efficiency 18,512 + maternal_health 17,959 (2026-06 release).","score is the RAW string ('Not Available' coerced to null); score_numeric is null for non-numeric scores. Always check footnote for suppression.","measure_id semantics differ per measure_source; join measure_id to its measure_name, do not compare scores across unlike measures.","HCAHPS (patient survey: question/answer/star format) + HRRP + HVBP have different shapes and are NOT in this fact (separate targeted sources / follow-up)."],"notes":"Iceberg table medicare_silver.fact_hospital_quality_measure, partitioned by measure_source; one source dataset fully restates its partition (replace, idempotent by SHA-256). One runner downloads all six by title.","superseded_by":null,"tools":["get_hospital_quality"],"dataset_id":"cms_care_compare_hospitals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hospital_general_information","source_fqn":"medicare_silver.dim_hospital_quality","title":"CMS Care Compare Hospital General Information (overall star rating per CCN)","domain":"hospital","stage":"dim","status":"live","grain":"One row per Medicare-certified hospital (by CCN) — overall star rating + type + ownership.","description":"The compact hospital quality summary from CMS Care Compare \"Hospital General Information\": one row per CCN with the headline overall star rating (1-5), hospital type, ownership, emergency-services flag, and birthing-friendly designation. The quality spine; per-measure detail lives in fact_hospital_quality_measure.","identity_key":"ccn","row_count":5432,"last_updated":null,"freshness_sla":"Refreshed when CMS republishes Care Compare (roughly quarterly).","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for the Care Compare snapshot."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_hospital_quality","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/cms_hospital_quality.md","known_gaps":["row_count 5,432 hospitals (2026-06 release); only ~3,182 carry an overall_rating (rest null — too few measures or footnoted).","overall_rating is null for hospitals CMS does not rate; treat null as 'unrated', not 0."],"notes":"Iceberg table medicare_silver.dim_hospital_quality, partitioned by state_cd; replace supersession (idempotent by SHA-256). Ingested by the same build-hospital-quality runner as the measure fact.","superseded_by":null,"tools":["get_hospital_quality"],"dataset_id":"cms_care_compare_hospitals","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_physician_payment_by_geo","source_fqn":"medicare_silver.fact_physician_payment_by_geo","title":"Medicare Physician & Other Practitioners by Geography (avg allowed/payment per HCPCS)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (geography [National|State], HCPCS, place-of-service) per data year.","description":"CMS public-use file \"Medicare Physician & Other Practitioners - by Geography and Service\" — annual, claims-derived average Medicare ALLOWED and PAYMENT per professional HCPCS at national + per-state granularity, split by place-of-service (F = facility, O = office/non-facility), with submitted charge, standardized payment, and provider/beneficiary/service counts. The Medicare benchmark for repricing PROFESSIONAL (physician / NPP) claim lines — the largest claim category, where geographic (GPCI) variation matters. Complements the contractual national medicare_physician_fee_schedule with geographic + actual-allowed detail.","identity_key":"hcpcs_cd","row_count":268350,"last_updated":null,"freshness_sla":"Annual (CMS Physician & Other Practitioners PUF release).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage/currency column (parsed from the filename)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_physician_payment_by_geo","context_doc_path":"docs/context_library/medicare/medicare_physician_payment_by_geo.md","known_gaps":["Claims-DERIVED average allowed/payment, NOT the contractual PFS rate (see medicare_physician_fee_schedule for the national fee-schedule).","row_count 268,350 is the 2024 data year (R26 release): 9,403 HCPCS x 63 geographies (National + states/territories) x place-of-service.","place_of_srvc 'F' = facility, 'O' = office/non-facility — the same split that drives PFS facility vs non-facility pricing; pick the POS matching the claim setting.","CMS suppresses small cells; treat null amounts as 'not reported', not zero. One data year per file; multi-year needs historical --source-url backfills."],"notes":"Iceberg table medicare_silver.fact_physician_payment_by_geo, partitioned by data_year; one annual file fully restates its year (replace, idempotent by SHA-256). Data year parsed from the filename (D24 -> 2024).","superseded_by":null,"tools":[],"dataset_id":"cms_puf_physician_other_practitioners","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_inpatient_payment_by_geo","source_fqn":"medicare_silver.fact_inpatient_payment_by_geo","title":"Medicare Inpatient Hospitals by Geography (avg payments per MS-DRG)","domain":"hospital","stage":"silver","status":"live","grain":"One row per (geography [National|State], MS-DRG) per data year.","description":"CMS public-use file \"Medicare Inpatient Hospitals - by Geography and Service\" — annual, claims-derived: discharges + avg submitted covered charge / total payment / Medicare payment per MS-DRG at national + per-state. The DRG-level Medicare INPATIENT payment benchmark — pairs with the hospital chargemaster (HPT) and the IPPS relative weights (dim_msdrg) to anchor inpatient repricing. Claims-derived averages, NOT the contractual IPPS rate tables.","identity_key":"drg_cd","row_count":331464,"last_updated":null,"freshness_sla":"Annual (CMS Inpatient Hospitals PUF release).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage/currency column (parsed from the filename)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_inpatient_payment_by_geo","context_doc_path":"docs/context_library/medicare/medicare_hospital_payment_by_geo.md","known_gaps":["Claims-DERIVED average payments, NOT the contractual IPPS rate tables (use dim_msdrg for IPPS relative weights).","row_count 26,571 is the 2024 data year (RY26 release): MS-DRG x national + states.","Avg_Tot_Pymt_Amt includes all payers' coordination; Avg_Mdcr_Pymt_Amt is the Medicare share. CMS suppresses small cells."],"notes":"Iceberg table medicare_silver.fact_inpatient_payment_by_geo, partitioned by data_year (replace, idempotent by SHA-256). Data year parsed from filename (DY24 -> 2024). Ingested by the same build-medicare-hospital-geo runner.","superseded_by":null,"tools":[],"dataset_id":"cms_puf_inpatient_hospitals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["drg_cd"],"backing_store":"glue"},{"source_id":"medicare_outpatient_payment_by_geo","source_fqn":"medicare_silver.fact_outpatient_payment_by_geo","title":"Medicare Outpatient Hospitals by Geography (avg payments per APC/HCPCS)","domain":"hospital","stage":"silver","status":"live","grain":"One row per (geography [National|State], APC or HCPCS) per data year.","description":"CMS public-use file \"Medicare Outpatient Hospitals - by Geography and Service\" — annual, claims-derived: beneficiary/service counts + avg submitted charge / Medicare allowed / Medicare payment / outlier per APC (Ambulatory Payment Classification) or HCPCS at national + per-state. The OUTPATIENT facility payment benchmark — pairs with the chargemaster to anchor outpatient repricing. Claims-derived averages, NOT the contractual OPPS rate tables.","identity_key":"apc_cd","row_count":758776,"last_updated":null,"freshness_sla":"Annual (CMS Outpatient Hospitals PUF release).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage/currency column (parsed from the filename)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_outpatient_payment_by_geo","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/medicare_hospital_payment_by_geo.md","known_gaps":["Claims-DERIVED average payments, NOT the contractual OPPS rate tables.","row_count 89,021 is the 2024 data year (RY26 release): srvc_lvl is APC or HCPCS; hcpcs_cd is null on APC-level rows.","CMS suppresses small cells; treat null amounts as 'not reported', not zero."],"notes":"Iceberg table medicare_silver.fact_outpatient_payment_by_geo, partitioned by data_year (replace, idempotent by SHA-256). Data year parsed from filename (DY24 -> 2024). Ingested by the same build-medicare-hospital-geo runner.","superseded_by":null,"tools":[],"dataset_id":"cms_puf_outpatient_hospitals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["apc_cd"],"backing_store":"glue"},{"source_id":"medicare_ipps_base_rate","source_fqn":"medicare_silver.fact_ipps_base_rate","title":"Medicare IPPS Base Rate (operating + capital standardized amounts)","domain":"medicare","stage":"dim","status":"live","grain":"One row per (fiscal_year, capital_area, rate_context vintage) -- national IPPS standardized base = operating_std_amount + capital_std_amount. DEEP FY2006-2026; select capital_area=national, final_rule (a correction supersedes only when no final rule loaded), as-of fiscal year. The shallow dim_ipps_base_rate is deprecated.","description":"The CMS IPPS base payment rates per fiscal year: operating standardized amount, capital standardized amount, and labor-related share. The MISSING LEG that makes an ABSOLUTE Medicare inpatient dollar computable — combine with the MS-DRG relative weight (drug_silver.dim_msdrg) and the hospital wage index (vlada/rbp/ref) to localize: payment ≈ base × DRG weight × (labor_share × wage_index + non_labor_share).","identity_key":"fiscal_year","row_count":66,"last_updated":null,"freshness_sla":"Annual (IPPS final rule, federal fiscal year Oct 1).","recollection":{"cadence":"annual","watermark_field":"fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'fiscal_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ipps_base_rate","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":"External/Athena reference; current served table provenance is incomplete. Additive source-truth writer/runner exists for medicare_silver.fact_ipps_base_rate_source_truth and FY2026 official Table 1A-1E is loaded/proven there. FY2008-FY2026 official source URLs/SHAs/values are pinned in the source-mastery manifest, but historical replay and serving-table derivation remain gated on asserted-date, labor-share, final-rule/correction/IFC precedence, and serving-shape policy.","context_doc_path":"docs/context_library/medicare/medicare_pfs_ipps_localization.md","known_gaps":["Few rows (one per loaded fiscal year); load the FY matching the claim's discharge date.","Only FY2024-FY2025 are held in the served dim. FY2026 is held in the additive source-truth table with both labor-share regimes but is not yet served through this dim. FY2008-FY2023 are primary-source URL/SHA/value proven and should be written only after accepted final-rule/correction/IFC precedence, asserted-date, and effective-period metadata. FY2006-FY2007 remain source-recovery residuals.","Current builder is a hardcoded drop/recreate reference script with source_note strings but no row-level source URL/SHA fields; do not expand without an accepted source-truth replay design."],"notes":"Completes absolute IPPS pricing with dim_msdrg (weights) + the wage index.","superseded_by":null,"tools":[],"dataset_id":"cms_ipps_final_rule","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["fiscal_year"],"backing_store":"glue"},{"source_id":"medicare_gpci_locality","source_fqn":"medicare_silver.medicare_gpci_locality","title":"Medicare GPCI by Locality (geographic practice cost indices)","domain":"medicare","stage":"dim","status":"retired","grain":"One row per (locality_number, calendar_year) — work/PE/MP GPCIs.","description":"The CMS Geographic Practice Cost Indices per Medicare locality and year: work_gpci, pe_gpci (practice expense), mp_gpci (malpractice), composite_gpci, plus frontier/HPSA flags and MAC/carrier. With the conversion factor and a code's RVUs this localizes the Physician Fee Schedule to an ABSOLUTE geographic dollar. Locality resolves from county/ZIP via the locality crosswalks.","identity_key":"locality_number","row_count":1111,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicare_gpci_locality","notes":null,"superseded_by":"medicare_silver.fact_pfs_gpci_locality (stamped re-collection 2026-09-07: every RVU release CY2017-2026 GPCI file at source grain with source_url, sha256_content_hash, asserted_at; the legacy table was a single CY2025 RDS mirror snapshot of 109 rows; the legacy table stays queryable until dropped)","tools":[],"dataset_id":"ds_medicare_gpci","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["locality_number"],"backing_store":"glue"},{"source_id":"medicare_conversion_factor","source_fqn":"medicare_silver.medicare_conversion_factor","title":"Medicare PFS Conversion Factor (by effective period)","domain":"medicare","stage":"dim","status":"live","grain":"One row per (calendar_year, effective_date, payment_track) — payment_track null pre-2026 (single-track era), qpp/nonqpp from CY2026.","description":"The CMS Physician Fee Schedule conversion factor (dollars per RVU), keyed by calendar year, effective date, and payment track so mid-year changes and the CY2026 qpp/nonqpp split do not collapse into one scalar. Default/general serving is nonqpp, the full fee schedule; qpp applies only to qualifying APM participants.","identity_key":"calendar_year,effective_date,payment_track","row_count":27,"last_updated":"2026-07-10","freshness_sla":"Annual (PFS final rule + any mid-year legislative update).","recollection":{"cadence":"annual","watermark_field":"calendar_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'calendar_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicare_conversion_factor","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":"Direct CMS PPRRVU source-truth rows in medicare_silver for CY2003-CY2025 plus RVU26C qpp/nonqpp rows, with source URL/SHA/effective-period/payment-track lineage; 25 pre-2026 rows remain payment_track NULL and the stale id=7 CY2026 seed was superseded.","context_doc_path":"docs/context_library/medicare/medicare_pfs_ipps_localization.md","known_gaps":["Mid-year legislative CF changes can produce more than one effective value per year; joins must honor effective_date/end_date.","CY2003-CY2025 are source-truth loaded/proven from official CMS PPRRVU ZIPs; CY2010 and CY2024 each have two effective-period rows.","CY2026 serving policy is explicit: select payment_track; default/general is nonqpp, the full fee schedule, and qpp applies only to qualifying APM participants. Pre-2026 rows have payment_track NULL (single-track era).","anesthesia_cf_source_url for the 2026 rows is null pending the ops backfill patch pattern because the runner has no argument for it; anesthesia CY2003-CY2019 remains gated per docs/reference/source-audit/source-mastery/anesthesia_conversion_factor_evidence.md.","Concurrent same-year qpp/nonqpp track loads are unsafe because a stale partition merge can lose a track; serialize track loads.","RVU quarterly releases may revise values; RVU26D is expected Oct and refreshes use the same gated path.","anesthesia_conversion_factor is source-truth backfilled for CY2020-CY2025 (national anesthesia CF, ops/scripts/medicare_anesthesia_cf_backfill.py; CY2024 has two effective-period rows 20.4349 / 20.7739); CY2026 serves QP 20.599835 vs non-QP 20.49754 by payment_track, while anesthesia_cf_source_url is null pending the ops backfill patch pattern; CY2003-CY2019 stays gated (evidence pack in docs/reference/source-audit/source-mastery/anesthesia_conversion_factor_evidence.md).","rule_number/public_law are populated per effective period alongside the anesthesia CF backfill; source_file_id stays null (M-2 source_url/SHA carry provenance)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_pfs_relative_value_files","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":["effective_date"],"unmapped_key_tokens":["calendar_year","payment_track"],"backing_store":"glue"},{"source_id":"cms_anesthesia_base_unit","source_fqn":"medicare_silver.dim_anesthesia_base_unit","title":"CMS Anesthesia Base Units (00100-01999)","domain":"medicare","stage":"dim","status":"live","grain":"One row per (hcpcs_code, calendar_year) - the integer anesthesia base-unit count for each anesthesia CPT code, per CMS publication year.","description":"The standalone CMS Anesthesia Base Units schedule (Anesthesiologists Center ZIPs). Base units are the fixed leg of Medicare anesthesia payment: payment = (base_units + time_units) x anesthesia_conversion_factor. SEPARATE schedule - never in the PFS PPRRVU RVU file (those anesthesia rows carry status indicator J, RVU=0). A code absent from this table is 'not anesthesia-priced', not $0. Qualifying-circumstance codes (99100/99116/99135/99140) are NOT in the CMS file. calendar_year is the CMS PUBLICATION year; CMS republishes only in change years and states values are 'unchanged for CY 20xx' otherwise, so each vintage GOVERNS every service year until the next published file (encoded in effective_period_start/end): CY2014 governs 2014-2017, CY2018 governs 2018-2021, CY2022 governs 2022 onward.","identity_key":"hcpcs_code,calendar_year","row_count":1933,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_anesthesia_base_unit - as-of a service year, use the row whose effective_period_start/end spans it (equivalently max(calendar_year) <= service_year).","notes":"Iceberg medicare_silver.dim_anesthesia_base_unit, partition by calendar_year, supersession=replace. Runner pipelines/medicare/ingest/anesthesia_base_unit_runner.py; CLI python -m pipelines.curated build-anesthesia-base-unit (worker build_anesthesia_base_unit).","superseded_by":null,"tools":[],"dataset_id":"cms_anesthesia_base_units","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":["calendar_year"],"backing_store":"glue"},{"source_id":"medicare_county_to_locality","source_fqn":"medicare_silver.medicare_county_to_locality","title":"Medicare PFS Locality Configuration (LOCCO)","domain":"medicare","stage":"dim","status":"retired","grain":"One row per (calendar_year, state, MAC/carrier, locality_number, official CMS Counties text) after exact duplicate source rows are dropped.","description":"Official CMS LOCCO locality-configuration rows from the PFS RVU ZIPs. The table maps each source Counties text/group to a Medicare payment locality and MAC/carrier for a year; it is not a county-FIPS crosswalk.","identity_key":"state_locality_counties_year","row_count":2381,"last_updated":"2026-07-02","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicare_county_to_locality","notes":null,"superseded_by":"medicare_silver.fact_pfs_locality_config (stamped re-collection 2026-09-07: every RVU release CY2003-2026 LOCCO file at source grain with source_url, sha256_content_hash, asserted_at; the legacy table was a single CY2025 RDS mirror snapshot of 100 rows; the legacy table stays queryable until dropped)","tools":[],"dataset_id":"ds_medicare_county","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["state_locality_counties_year"],"backing_store":"glue"},{"source_id":"medicare_zip_to_locality","source_fqn":"medicare_silver.medicare_zip_to_locality","title":"Legacy Medicare ZIP → Payment Locality Crosswalk (superseded)","domain":"medicare","stage":"dim","status":"live","grain":"One row per (zip_code, calendar_year) → CMS payment locality (+ CBSA, rurality).","description":"Legacy RDS-mirrored ZIP-to-locality surface retained for compatibility only. It is not the canonical PFS ZIP locality resolver because it collapses big-metro ZIPs into rest-of-state localities; use cms_zip5_locality / medicare_silver.medicare_zip5_locality instead.","identity_key":"zip_code","row_count":31913,"last_updated":null,"freshness_sla":"Annual (with quarterly ZIP-locality updates).","recollection":{"cadence":"annual","watermark_field":"calendar_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'calendar_year' is the CMS payment-locality year a ZIP row maps for (the grain's year key); the quarterly ZIP-locality updates within a year are not distinguished by it."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicare_zip_to_locality","provenance_chain_ref":"medicare_silver M-2 substrate.","known_gaps":["is_statewide_locality flags states with one locality; ZIP→locality can change mid-year (effective_date/end_date).","DEGRADED/SUPERSEDED: live Athena query 9a5bea83-5577-4e92-ba59-ef1579be0bf4 shows 31,913 CY2025 rows, only 64 state/locality pairs, and empty CBSA/rural/effective-date columns; query 693054c4-d019-454a-9b65-442b6438094b shows 90001 and 94110 misrouted to REST OF CALIFORNIA. Use cms_zip5_locality for canonical PFS localization.","Live recheck 1a949d2a-c655-4dc6-8996-fb7daec548fb upheld the degraded shape. Canonical replacement medicare_zip5_locality has 687,053 rows across 2011-2026, 16 hashes, zero lineage nulls (1f7658ef-38d8-4f5e-a8aa-2bbbd965c375), and zero duplicate (year,zip_code) groups (db44371c-2fef-4f91-a19c-22bb9982cd1e)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_pfs_zip_carrier_locality","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["usps:zip"],"entity_key_columns":{"usps:zip":["zip_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_zip5_locality","source_fqn":"medicare_silver.medicare_zip5_locality","title":"CMS ZIP5 → PFS Locality Crosswalk (authoritative)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (loaded year, 5-digit ZIP) from the CMS Zip Code to Carrier Locality File (ZIP5) \\u2014 state, carrier/MAC, PFS pricing locality, rural indicator, and CMS year-quarter.","description":"The authoritative CMS Zip Code to Carrier Locality File (ZIP5) — maps every 5-digit ZIP to its Medicare PFS pricing locality (+ carrier/MAC, state, rural indicator). This is the routing table GPCI localization needs to price a professional claim to the provider's geography. It supersedes medicare_zip_to_locality, which collapsed big-metro ZIPs into rest-of-state. Annual end-of-year ZIP5 history is loaded for 2011-2025 plus the current 2026Q3 file; 94110 -> SF locality 05, 90001 -> LA 18, 10001 -> Manhattan 01.","identity_key":"zip_code","row_count":687053,"last_updated":"2026-07-02","freshness_sla":"Refreshed quarterly when CMS republishes the Zip Code to Carrier Locality File.","recollection":{"cadence":"quarterly","watermark_field":"year_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Current table stores one loaded ZIP5 file per year; richer quarterly replay is gated until the table grain changes.","watermark_field 'year_quarter' is the CMS year-quarter label carried on each ZIP5 file row (parsed from the fixed-width file); because the table holds one loaded ZIP5 file per year it identifies which quarterly file was loaded, not a full quarterly history."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicare_zip5_locality","provenance_chain_ref":"pipelines/medicare/ingest/zip5_locality_runner.py \\u2014 CMS ZIP5 fixed-width file parsed positionally, M-2 envelope (asserted_at + sha256 + source_url) on every row.","known_gaps":["Annual EOY history is loaded for recovered 2011-2025 plus current 2026Q3; pre-2011 annual ZIP5 history was not recovered in this wave.","Quarterly intra-year ZIP5 files are recoverable for some years, but not loaded because the current writer replaces by year; replay requires a reviewed year_quarter/effective-period grain.","Local run could not reach medicare_source_registry_cache RDS, so registry rows were not recorded; row-level M-2 source_url/asserted_at/sha256 fields are present in Iceberg."],"notes":"Iceberg table medicare_silver.medicare_zip5_locality. Fixed-width ZIP5 layout (state 1-2, zip 3-7, carrier 8-12, locality 13-14). Read per-book by vlada/rbp/gpci.py (resolve_localities). Source-truth manifest docs/reference/source-audit/source-mastery/manifests/cms_zip5_locality_recovery_manifest.json.","superseded_by":null,"tools":[],"dataset_id":"cms_pfs_zip_carrier_locality","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:zip"],"entity_key_columns":{"usps:zip":["zip_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_code_validity","source_fqn":"medicare_silver.dim_code_validity","title":"Code Vintage Validity (which years a billing code is valid)","domain":"curated","stage":"dim","status":"live","grain":"One row per (code, code_system) — first_year, last_year, year_count of validity.","description":"For each billing code (HCPCS/CPT/DRG/etc.) the years it is valid: first_year, last_year, and the count of years observed. The reference that lets repricing resolve a claim's code against the RIGHT vintage and flag retired/not-yet-introduced codes instead of guessing — the code-vintage gap, now grounded in data (20,523 codes).","identity_key":"code","row_count":20523,"last_updated":null,"freshness_sla":"Derived; rebuilt as code sets refresh.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt when code sets refresh; no independent publication clock."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_code_validity","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":"medicare_silver M-2 substrate.","context_doc_path":"docs/context_library/medicare/code_vintage_and_revcode.md","known_gaps":["Validity is observed from the loaded code sets; a code absent here is unknown, not necessarily invalid."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_billing_code_vocabulary","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["code"],"backing_store":"glue"},{"source_id":"cpt_revcode_modal","source_fqn":"medicare_silver.cpt_revcode_modal","title":"CPT/HCPCS → modal UB-04 Revenue Code mapping","domain":"curated","stage":"dim","status":"live","grain":"One row per billing_code — its modal (most-common) UB-04 revenue code + support.","description":"Empirical CPT/HCPCS → UB-04 revenue-code mapping: for each billing code, the MODAL revenue code observed, the modal count, total rows, and modal share. Lets facility lines be related to a revenue code (and vice versa) — part of the fix for revenue-only facility lines being unpriceable.","identity_key":"billing_code","row_count":null,"last_updated":null,"freshness_sla":"Derived; rebuilt from the rate/claims corpus.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Empirical modal mapping; rebuilt when the underlying corpus changes."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cpt_revcode_modal","commercial_terms":"Derived from public data.","provenance_chain_ref":"medicare_silver M-2 substrate.","context_doc_path":"docs/context_library/medicare/code_vintage_and_revcode.md","known_gaps":["Modal mapping is empirical/probabilistic (use modal_share to gauge confidence), not an authoritative NUBC crosswalk (NUBC revenue codes are copyrighted)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_billing_code_vocabulary","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["billing_code"],"backing_store":"glue"},{"source_id":"oig_leie_exclusions","source_fqn":"drug_silver.dim_oig_leie","title":"OIG List of Excluded Individuals/Entities (LEIE)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per (observed_period, LEIE row_uid) active-exclusion snapshot row; current roster is the latest is_current row per row_uid.","description":"The HHS-OIG List of Excluded Individuals/Entities — providers/entities BARRED from billing federal healthcare programs, with NPI/UPIN, name or business name, exclusion type and date, and any reinstatement/waiver. The integrity / accountability layer: screen a book's providers for exclusions, and join to the facility/provider spine by NPI.","identity_key":"row_uid","row_count":249886,"last_updated":"2026-07-02","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_oig_leie","notes":"Source Truth 2026-07-02 prepared historical replay; production historical backfill remains acceptance-gated because full snapshots and monthly supplement events have different semantics.","superseded_by":null,"tools":["excluded_prescriber_payment_screen"],"dataset_id":"oig_leie_exclusions","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["row_uid"],"backing_store":"glue"},{"source_id":"oig_corporate_integrity_agreements","source_fqn":"drug_silver.dim_hhs_oig_cia","title":"HHS-OIG Corporate Integrity Agreements (CIA)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Corporate Integrity Agreement (by entity).","description":"HHS-OIG Corporate Integrity Agreements — entities under a CIA following a fraud/abuse settlement, with settlement amount, location, and effective date. Accountability signal on health systems / providers (often paired with LEIE for the integrity picture).","identity_key":"entity_slug","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_hhs_oig_cia","notes":null,"superseded_by":null,"tools":[],"dataset_id":"oig_corporate_integrity_agreements","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["entity_slug"],"backing_store":"glue"},{"source_id":"hrsa_340b_covered_entity","source_fqn":"drug_silver.dim_hrsa_covered_entity","title":"HRSA 340B Covered Entity Registry (OPAIS)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per 340B covered entity (by id_340b).","description":"The HRSA OPAIS registry of 340B covered entities — hospitals/clinics eligible to buy outpatient drugs at 340B ceiling prices, with entity type, name/sub-name, participation status + start date, grant number, address, and contacts. Identifies 340B-eligible providers (the spread between 340B acquisition and billed price is a known overpayment vector).","identity_key":"id_340b","row_count":92814,"last_updated":null,"freshness_sla":"Refreshed when HRSA republishes OPAIS (frequent).","recollection":{"cadence":"derived","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp for the OPAIS snapshot.","HRSA republishes OPAIS frequently; refresh on fetch (no fixed enum cadence)."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_hrsa_covered_entity","known_gaps":["Covered-entity registry only; 340B CEILING PRICES (the discounted acquisition cost) are restricted and NOT included.","Join to providers via fact_hrsa_ce_npi (id_340b -> NPI)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"hrsa_340b_opais","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["id_340b"],"backing_store":"glue"},{"source_id":"hrsa_340b_entity_npi","source_fqn":"drug_silver.fact_hrsa_ce_npi","title":"HRSA 340B Covered Entity → NPI bridge","domain":"provider_identity","stage":"silver","status":"live","grain":"One row per (340B covered entity id_340b, NPI).","description":"Bridge from each HRSA 340B covered entity (id_340b) to its associated NPI(s), with state. Lets a claim's provider NPI be checked for 340B eligibility and joined to dim_hrsa_covered_entity.","identity_key":"npi_number","row_count":null,"last_updated":null,"freshness_sla":"Refreshed with the OPAIS registry.","recollection":{"cadence":"derived","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp; refreshed with OPAIS.","Refreshed with the OPAIS registry; no fixed enum cadence."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_hrsa_ce_npi","known_gaps":["An entity can map to multiple NPIs; not every covered entity publishes an NPI."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"hrsa_340b_opais","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["npi_number"],"backing_store":"glue"},{"source_id":"medicare_part_d_prescriber","source_fqn":"drug_silver.fact_part_d_prescriber","title":"Medicare Part D Prescriber PUF (prescribing by provider × drug × year)","domain":"drug","stage":"silver","status":"live","grain":"One row per (prescriber NPI, drug [brand+generic], data_year).","description":"The CMS Medicare Part D Prescriber public-use file — prescribing volume and cost per prescriber, drug, and year: total_claims, 30-day fills, day supply, total_drug_cost_usd, beneficiaries, prescriber type/specialty/geography. The provider-level drug-prescribing lens (~103M rows) — outlier prescribing, drug-mix by specialty, brand-vs-generic behavior.","identity_key":"prescriber_npi","row_count":103105990,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_part_d_prescriber","notes":null,"superseded_by":null,"tools":["excluded_prescriber_payment_screen"],"dataset_id":"cms_part_d_prescriber_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["prescriber_npi"],"backing_store":"glue"},{"source_id":"medicare_drug_spending_part_b","source_fqn":"drug_silver.fact_drug_spending_part_b","title":"Medicare Part B Drug Spending (by HCPCS × year)","domain":"drug","stage":"silver","status":"live","grain":"One row per (HCPCS, data_year) — Part B drug spend + ASP price.","description":"The CMS Medicare Part B Spending by Drug public-use file — physician- administered (Part B) drug spend per HCPCS J-code per year: total_spending, dosage units, claims, beneficiaries, avg spend per unit/claim/beneficiary, the ASP price, and unit-cost trend (YoY change + CAGR). The Part B counterpart to the Part D spending PUF.","identity_key":"hcpcs_code","row_count":3164,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_spending_part_b","notes":null,"superseded_by":null,"tools":["ira_mfp_exposure"],"dataset_id":"cms_part_b_drug_spending","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_va_fss_price","source_fqn":"drug_silver.fact_drug_va_fss_price","title":"VA Federal Supply Schedule (FSS) drug prices","domain":"drug","stage":"silver","status":"live","grain":"One row per (NDC, contract, price_start_date) — the VA FSS contract price.","description":"VA Federal Supply Schedule drug prices by NDC — the negotiated federal contract price (price_usd, price_type), vendor, contract window, generic flag, VA class. A government-negotiated price benchmark distinct from ASP / NADAC / WAC — useful as a low-water reference for drug pricing.","identity_key":"ndc11","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_va_fss_price","notes":null,"superseded_by":null,"tools":[],"dataset_id":"va_fss_pharmaceutical_prices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_medicaid_rebate_product","source_fqn":"drug_silver.fact_drug_medicaid_rebate_product","title":"Medicaid Drug Rebate Program — product file","domain":"drug","stage":"silver","status":"live","grain":"One row per (NDC, data_year, data_quarter) — MDRP product attributes.","description":"The Medicaid Drug Rebate Program product file by NDC and quarter — labeler, FDA product name + application number, drug category/type, unit type, units per package, therapeutic-equivalence code, COD status. The drug-product reference for Medicaid rebate eligibility (pairs with the utilization file).","identity_key":"ndc11","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_medicaid_rebate_product","notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicaid_drug_rebate_program_product_file","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"drug_medicaid_utilization","source_fqn":"drug_silver.fact_drug_medicaid_utilization","title":"Medicaid State Drug Utilization (by state × NDC × quarter)","domain":"drug","stage":"silver","status":"live","grain":"One row per (utilization_type, state, NDC, data_year, data_quarter).","description":"CMS State Drug Utilization Data — Medicaid units reimbursed, prescriptions, and total / Medicaid / non-Medicaid amounts reimbursed by state, NDC, and quarter (FFS vs MCO via utilization_type). The Medicaid DRUG spend lens by state (NOTE: this is Medicaid drug utilization, not Medicaid MEDICAL rates, which remain absent).","identity_key":"ndc11","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_medicaid_utilization","notes":null,"superseded_by":null,"tools":["ira_mfp_exposure","recall_spend_window"],"dataset_id":"cms_state_drug_utilization_data","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"fda_drug_shortage","source_fqn":"drug_silver.fact_drug_shortage","title":"FDA Drug Shortages","domain":"drug","stage":"silver","status":"live","grain":"One row per drug-shortage record (by package NDC + posting).","description":"The FDA drug-shortage list — current/resolved shortages by package NDC with availability status, generic name, manufacturer, route, and openFDA enrichments (brand, RxCUI, application number). Supply-risk signal for a drug book (1,733 records).","identity_key":"package_ndc","row_count":1733,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_shortage","notes":null,"superseded_by":null,"tools":[],"dataset_id":"fda_drug_shortages","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["package_ndc"],"backing_store":"glue"},{"source_id":"fda_drug_recall","source_fqn":"drug_silver.fact_drug_recall","title":"FDA Drug Recalls (Enforcement Reports)","domain":"drug","stage":"silver","status":"live","grain":"One row per recall (by recall_number).","description":"FDA Enforcement Reports for drug recalls — classification (Class I/II/III), status, voluntary/mandated, product description, quantity, reason for recall, recalling firm + location, distribution pattern. Quality/safety signal.","identity_key":"recall_number","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_recall","notes":null,"superseded_by":null,"tools":["recall_spend_window"],"dataset_id":"fda_enforcement_reports_drug_recalls","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["recall_number"],"backing_store":"glue"},{"source_id":"fda_warning_letter","source_fqn":"drug_silver.fact_fda_warning_letter","title":"FDA Warning Letters","domain":"drug","stage":"silver","status":"live","grain":"One row per FDA warning letter (by letter_id).","description":"FDA warning letters — issuing office, company, subject, issue/posted dates, and response/closeout dates. Regulatory-accountability signal on manufacturers/firms (pairs with recalls + OIG for the integrity picture).","identity_key":"letter_id","row_count":3673,"last_updated":"2026-09-23","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_fda_warning_letter","notes":null,"superseded_by":null,"tools":[],"dataset_id":"fda_warning_letters","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["letter_id"],"backing_store":"glue"},{"source_id":"rxclass_class","source_fqn":"drug_silver.dim_rxclass_class","title":"NLM RxClass — drug class dimension","domain":"drug","stage":"dim","status":"live","grain":"One row per (class_id, class_type) — a drug class (ATC/EPC/MoA/…).","description":"The NLM RxClass class dimension — drug classes across class systems (ATC, Established Pharmacologic Class, Mechanism of Action, therapeutic, etc.). The vocabulary for rolling drugs up to a clinical/therapeutic class.","identity_key":"class_id","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_rxclass_class","known_gaps":["class_id is unique within a class_type; always carry class_type."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"nlm_rxclass","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["class_id"],"backing_store":"glue"},{"source_id":"rxclass_membership","source_fqn":"drug_silver.fact_rxclass_membership","title":"NLM RxClass — drug → class membership","domain":"drug","stage":"silver","status":"live","grain":"One row per (class_id, RxCUI) — a drug-to-class membership edge.","description":"RxClass membership edges — maps each RxNorm concept (RxCUI + name + term type) to its drug class(es), with the relationship + source. Bridges NDC/drug (via RxCUI) to clinical/therapeutic classes for class-level analysis.","identity_key":"rxcui","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_rxclass_membership","known_gaps":["RxCUI→NDC requires an RxNorm NDC crosswalk; membership is RxCUI-keyed."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"nlm_rxclass","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["nlm:rxcui"],"entity_key_columns":{"nlm:rxcui":["rxcui"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"fda_orange_book_patent","source_fqn":"drug_silver.fact_orange_book_patent","title":"FDA Orange Book — patents","domain":"drug","stage":"silver","status":"live","grain":"One row per (application, product, patent) — Orange Book patent listing.","description":"FDA Orange Book patent listings — patents protecting approved drugs by application/product, with patent number, use code, expiry, and substance/product flags. Drives generic-entry timing analysis (when patent protection lapses).","identity_key":"patent_no","row_count":null,"last_updated":null,"freshness_sla":"Monthly (FDA Orange Book).","recollection":{"cadence":"monthly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp; monthly Orange Book."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_orange_book_patent","commercial_terms":"Public FDA data; freely redistributable.","provenance_chain_ref":"drug_silver M-2 substrate.","context_doc_path":"docs/context_library/drug/drug_reference_rxclass_orangebook.md","known_gaps":["Dates are text fields (patent_expire_date_text) — parse defensively."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"fda_orange_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["patent_no"],"backing_store":"glue"},{"source_id":"fda_orange_book_exclusivity","source_fqn":"drug_silver.fact_orange_book_exclusivity","title":"FDA Orange Book — exclusivity","domain":"drug","stage":"silver","status":"live","grain":"One row per (application, product, exclusivity_code) — market exclusivity.","description":"FDA Orange Book exclusivity periods by application/product — exclusivity code and expiry. Complements patents for generic/biosimilar entry-timing analysis.","identity_key":"exclusivity_code","row_count":null,"last_updated":null,"freshness_sla":"Monthly (FDA Orange Book).","recollection":{"cadence":"monthly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp; monthly Orange Book."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_orange_book_exclusivity","commercial_terms":"Public FDA data; freely redistributable.","provenance_chain_ref":"drug_silver M-2 substrate.","context_doc_path":"docs/context_library/drug/drug_reference_rxclass_orangebook.md","known_gaps":["Exclusivity dates are text (exclusivity_date_text); parse defensively."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"fda_orange_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["exclusivity_code"],"backing_store":"glue"},{"source_id":"fda_drug_label","source_fqn":"drug_silver.dim_drug_label","title":"FDA Structured Product Labels (SPL) — drug label dimension","domain":"drug","stage":"dim","status":"live","grain":"One row per SPL (by spl_id) — a drug label with safety flags.","description":"FDA Structured Product Labels — brand/generic, product NDC, product type, substance, manufacturer, and safety flags (boxed warning, pregnancy, pediatric/geriatric use, REMS). The label-level safety reference per drug.","identity_key":"product_ndc","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_drug_label","notes":null,"superseded_by":null,"tools":["ira_drug_label_risk_screen"],"dataset_id":"fda_spl_drug_labels","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["product_ndc"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"fda_drug_application","source_fqn":"drug_silver.dim_drug_application","title":"FDA Drug Applications (NDA/ANDA/BLA dimension)","domain":"drug","stage":"dim","status":"live","grain":"One row per FDA application (by application_number).","description":"FDA drug applications — application type (NDA/ANDA/BLA), sponsor, product and submission counts, earliest/latest submission dates + status. The application-level spine linking Orange Book, labels, and approvals.","identity_key":"application_number","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_drug_application","notes":null,"superseded_by":null,"tools":["ira_drug_label_risk_screen"],"dataset_id":"fda_drugs_at_fda_applications","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["application_number"],"backing_store":"glue"},{"source_id":"curated_dim_code","source_fqn":"vlada_curated.dim_code","title":"Billing Code Vocabulary (HCPCS/CPT/etc.)","domain":"curated","stage":"dim","status":"live","grain":"One row per (code, code_system) — the billing-code vocabulary.","description":"The canonical billing-code dimension: code + code_system + descriptions + effective window + source. The vocabulary tools join to for a human label on any HCPCS code. Derived CURRENT vocabulary: exact union of valid HCPCS codes across the five canonical Medicare/ASP Iceberg tables (PFS/OPPS/ASC/CLFS/ASP is_current) at pinned snapshots, fail-closed validated.","identity_key":"code","row_count":20196,"last_updated":"2026-07-10","freshness_sla":"Regenerate via load-dim-code on upstream (PFS/OPPS/ASC/CLFS/ASP) refresh.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived current vocabulary; regenerated by pipelines.curated load-dim-code, no in-row publication clock."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_code","commercial_terms":"Public CMS/AMA-derived; HCPCS public, CPT descriptions are AMA-licensed.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["CPT long descriptions are AMA-copyrighted; short/derived labels only for redistribution."],"notes":"Rebuilt + proven 2026-07-10: 20,196 rows = exact canonical union (anti-join 0 both ways), 0 malformed, semantic idempotency checksum A9DC27EFB14A92C9. source_year is descriptor provenance (2005-2026), not a publication series.","superseded_by":null,"tools":[],"dataset_id":"vlada_spine_billing_code_vocabulary","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["code"],"backing_store":"glue"},{"source_id":"curated_dim_geography","source_fqn":"vlada_curated.dim_geography","title":"Geography Hierarchy (ZIP → county → CBSA → CSA → state)","domain":"curated","stage":"dim","status":"live","grain":"One row per ZIP code — county/CBSA/CSA hierarchy + population/area.","description":"The geography spine: ZIP → county (FIPS) → CBSA → CSA → state, with centroid, population, and land area. The geographic join key for county/market rollups across the substrate.","identity_key":"zip_code","row_count":33791,"last_updated":null,"freshness_sla":"Annual (Census vintage).","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Census vintage; rebuilt on refresh."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_geography","commercial_terms":"Public Census data; freely redistributable.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["ZIP→county is a best-fit (ZIPs can span counties); use for rollups, not legal boundaries."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_geography_hierarchy","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["usps:zip"],"entity_key_columns":{"usps:zip":["zip_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"curated_dim_care_site","source_fqn":"vlada_curated.dim_care_site","title":"Care-Site Spine (NPI/CCN-keyed facility identity)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per care site (care_site_id) — NPI/CCN, class, tier, geography.","description":"The care-site identity spine: care_site_id with NPI, CCN, legal name, NPPES taxonomy, care_site_class, tier, entity type, and geography (geo_id + county FIPS). The unifying facility identity the county/care-site fleet and pricing tools resolve against.","identity_key":"care_site_id","row_count":null,"last_updated":null,"freshness_sla":"Derived (rebuilt with roster/NPPES refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt with roster/NPPES refresh."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_care_site","commercial_terms":"Derived from public CMS/NPPES data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["care_site_class/tier are assigned by the fleet; see fact_care_site_verification for verified status."],"notes":null,"superseded_by":null,"tools":["state_expert"],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["care_site_id"],"backing_store":"glue"},{"source_id":"curated_dim_ccn_cbsa","source_fqn":"vlada_curated.dim_ccn_cbsa","title":"CCN → CBSA + Wage Index crosswalk","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per hospital CCN — its CBSA, county FIPS, and IPPS wage index.","description":"Maps each hospital CCN to its geographic CBSA, county FIPS, and IPPS wage index. The bridge for wage-index localization of inpatient payment and for placing a hospital in its market.","identity_key":"ccn","row_count":null,"last_updated":null,"freshness_sla":"Annual (with the IPPS wage index).","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt with the annual wage index."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_ccn_cbsa","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["Wage index here is the per-CCN value; the bundled FY CSV (ipps_wage_index) is the authoritative reference."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w2_medicare_benchmarks","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"curated_dim_health_system","source_fqn":"vlada_curated.dim_health_system","title":"Health System list","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per health system (system_name) — type, HQ state, multi-facility flag.","description":"A roster of health systems with system type, HQ state, and a multi-facility flag. A lightweight system list (the richer hierarchy is dim_hospital_system).","identity_key":"system_name","row_count":null,"last_updated":null,"freshness_sla":"Derived.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived roster."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_health_system","commercial_terms":"Derived.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["system_name is the key — normalize before joining; dim_hospital_system has the normalized hierarchy."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["system_name"],"backing_store":"glue"},{"source_id":"curated_dim_hospital_system","source_fqn":"vlada_curated.dim_hospital_system","title":"Hospital System Hierarchy (parent / ultimate parent / ownership)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per hospital system (system_id) — name, parent + ultimate-parent, ownership, EIN, HQ.","description":"The hospital-system hierarchy: normalized system name, parent_system_id and ultimate_parent_id, ownership_level + ownership_type, EIN, and HQ. A PARTIAL ownership-rollup (system → parent → ultimate parent) — the closest thing we have to ownership intelligence until the PECOS \"All Owners\" datasets are ingested.","identity_key":"system_id","row_count":null,"last_updated":null,"freshness_sla":"Derived.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Curated ownership rollup; rebuilt on refresh."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_hospital_system","commercial_terms":"Derived from public data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["Parent/ultimate-parent is a curated rollup, NOT the PECOS owner-entity chain (the 'All Owners' datasets remain absent)."],"notes":null,"superseded_by":null,"tools":["resolve_provider"],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["system_id"],"backing_store":"glue"},{"source_id":"curated_dim_code_billing_class","source_fqn":"vlada_curated.dim_code_billing_class","title":"Billing-code institutional-vs-professional class","domain":"curated","stage":"dim","status":"live","grain":"One row per (code_system, billing_code) — learned institutional/professional class.","description":"For each billing code, the learned billing class (institutional vs professional) from observed counts: n_institutional, n_professional, institutional_frac, learned_class. Routes a claim line to the right benchmark (facility vs professional).","identity_key":"billing_code","row_count":null,"last_updated":null,"freshness_sla":"Derived (from the rate corpus).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Empirical; rebuilt from the corpus."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_code_billing_class","commercial_terms":"Derived.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["Learned/empirical (use institutional_frac as confidence), not an authoritative code-class registry."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_billing_code_vocabulary","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["billing_code"],"backing_store":"glue"},{"source_id":"curated_dim_state_metric","source_fqn":"vlada_curated.dim_state_metric","title":"State Metrics (demographics / health context, integrated)","domain":"curated","stage":"dim","status":"live","grain":"One row per (state_code, domain, metric, data_year) — a metric value.","description":"Integrated state-level metrics across domains (demographics, health outcomes, access) with value, unit, geo_level, source, and data_year. Backs the state-agent/state-KB context.","identity_key":"state_code","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_state_metric","provenance_chain_ref":null,"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_state_context_metrics","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"curated_dim_taxonomy_procedures","source_fqn":"vlada_curated.dim_taxonomy_procedures","title":"Provider-type → procedure (HCPCS) profile","domain":"curated","stage":"dim","status":"live","grain":"One row per (provider_type, HCPCS) — provider/service volume + rank.","description":"Which HCPCS each provider type performs, with provider_count, total_services, and rank. Helps map a specialty to its typical procedures (and sanity-check provider↔procedure plausibility).","identity_key":"hcpcs_cd","row_count":null,"last_updated":null,"freshness_sla":"Derived (from utilization data).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Empirical; rebuilt from utilization."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_taxonomy_procedures","commercial_terms":"Public CMS-derived.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["Empirical ranking from utilization; not an authoritative scope-of-practice mapping."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_billing_code_vocabulary","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"curated_provider_facility_affiliation","source_fqn":"vlada_curated.dim_provider_facility_affiliation","title":"Provider → Facility affiliation (curated)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per (clinician_npi, facility_ccn) affiliation edge.","description":"Curated clinician-NPI → facility-CCN affiliation edges (with facility_type and PAC ID). The curated provider↔facility bridge (the silver source is drug_silver.dim_facility_affiliation / cms_facility_affiliation).","identity_key":"clinician_npi","row_count":null,"last_updated":null,"freshness_sla":"Derived (with the CMS affiliation refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt with the CMS affiliation refresh."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.dim_provider_facility_affiliation","commercial_terms":"Public CMS data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["Affiliation is self-reported; absence of an edge is not proof of no relationship."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["clinician_npi"],"backing_store":"glue"},{"source_id":"commercial_rate_provider_edge","source_fqn":"vlada_curated.rate_provider_edge","title":"Commercial rate ↔ provider (NPI) edge","domain":"commercial","stage":"curated","status":"live","grain":"One row per (rate_id, NPI) — links a negotiated rate to a provider.","description":"The normalized rate↔provider edge of the commercial substrate: rate_id → NPI (bucketed), payer, state, version, code, negotiated_rate/type. The join that attaches TiC negotiated rates to specific providers (NPI lookups).","identity_key":"rate_id","row_count":null,"last_updated":null,"freshness_sla":"Per payer MRF version.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt per payer MRF version."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.rate_provider_edge","commercial_terms":"Public TiC data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/commercial/rate_model_and_serving.md","known_gaps":["High-fanout payers explode this edge; partition-prune by payer_id/state."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_transparency_in_coverage","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"derived","entity_keys":[],"entity_key_columns":{},"technical_keys":["rate_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"commercial_mart_rate_by_entity","source_fqn":"vlada_curated.mart_rate_by_entity","title":"Commercial gold mart — rate by entity","domain":"commercial","stage":"mart","status":"live","grain":"One row per (payer, entity, code) — entity-keyed negotiated rate.","description":"Gold serving mart projecting fact_rate by negotiating entity: payer, entity, code (+prefix), negotiated_rate/type, billing_class, state. Entity-level rate serving (complements mart_rate_by_code).","identity_key":"rate_id","row_count":null,"last_updated":null,"freshness_sla":"Derived (rebuilt from silver).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt from silver."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.mart_rate_by_entity","commercial_terms":"Public TiC data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/commercial/rate_model_and_serving.md","known_gaps":["Entity rollup; for code-level serving use mart_rate_by_code."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_transparency_in_coverage","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":["rate_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_chargemaster_comparable","source_fqn":"vlada_curated.vw_fact_hospital_chargemaster_comparable","title":"Hospital chargemaster — comparable view (real-negotiated, classified)","domain":"hospital","stage":"semantic_view","status":"live","grain":"One row per (CCN, billing_code, payer, plan, billing_class) — comparable rate.","description":"The serving view over the hospital chargemaster, FILTERED to comparable / real-negotiated rates with payer entity/plan structure resolved and a comparability class. The surface the pricing engine reads for hospital rates (backed by fact_hospital_comparability_mat).","identity_key":"hospital_ccn","row_count":null,"last_updated":null,"freshness_sla":"Derived (per hospital reprocess).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt on hospital reprocess."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_fact_hospital_chargemaster_comparable","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/chargemaster_serving_views.md","known_gaps":["Every row carries comparability_class; dollar medians use comparability_class = 'REAL_NEGOTIATED' only (percent-of-charge rows carry rate_type negotiated_dollar, so rate_type is not enough).","hospital_state is required; one methodology family and one line_of_business per median (the raw door refuses otherwise and returns the corrected SQL).","A materialized snapshot of the canonical view (Glue view over the newest fact_hospital_comparability_mat_v<ts>); rows filed after its build appear on _canonical first."],"notes":null,"superseded_by":null,"tools":["compare_hospital_rates"],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_chargemaster_canonical","source_fqn":"vlada_curated.vw_fact_hospital_chargemaster_canonical","title":"Hospital chargemaster — canonical view","domain":"hospital","stage":"semantic_view","status":"live","grain":"One row per canonical hospital rate (CCN, billing_code, payer, plan).","description":"Canonical hospital-chargemaster view: resolved code system, payer/plan, rate type, billing class, rate, gross charge. The canonicalized rate surface (broader than _comparable; before the comparability filter).","identity_key":"hospital_ccn","row_count":null,"last_updated":null,"freshness_sla":"Derived.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived view."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_fact_hospital_chargemaster_canonical","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/chargemaster_serving_views.md","known_gaps":["Includes rates the comparable view excludes; check rate_type/billing_class.","The normalized layer (payer parent, line_of_business, plan_classify_method, methodology_norm) with no comparability class; a dollar median of rate belongs on vw_fact_hospital_chargemaster_comparable (the raw door refuses it here and names the corrected SQL).","hospital_state is required."],"notes":null,"superseded_by":null,"tools":["compare_hospital_rates","coverage_status"],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_chargemaster_current","source_fqn":"vlada_curated.vw_fact_hospital_chargemaster_current","title":"Hospital chargemaster — current (full, wide) view","domain":"hospital","stage":"semantic_view","status":"live","grain":"One row per current chargemaster rate_id (full 93-column detail).","description":"The widest current-vintage hospital-chargemaster view (rate_id grain, ~93 cols incl alt-code arrays, all payer/plan/rate attributes). The full-detail surface for deep inspection / lineage; downstream views project from it.","identity_key":"rate_id","row_count":null,"last_updated":null,"freshness_sla":"Derived (current vintage).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Current-vintage view."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_fact_hospital_chargemaster_current","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/chargemaster_serving_views.md","known_gaps":["Very wide (93 cols) — select only needed columns.","The as-filed layer, with file provenance per row (source_url, sha256_content_hash, raw_s3_key, mrf_version_id, parser_version, fact_builder_version). hospital_state is required; for proof, not math."],"notes":null,"superseded_by":null,"tools":["coverage_status"],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["rate_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_chargemaster_validated","source_fqn":"vlada_curated.vw_fact_hospital_chargemaster_validated","title":"Hospital chargemaster — validated view","domain":"hospital","stage":"semantic_view","status":"retired","grain":"One row per validated hospital rate (rate_id).","description":"The validated hospital-chargemaster view: rates passing validation, with description, payer/plan, rate type, rate, gross charge. The quality-gated rate surface.","identity_key":"rate_id","row_count":null,"last_updated":null,"freshness_sla":"Derived.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived view."]},"raw_queryable_via":"Not queryable (retired); read vlada_curated.vw_fact_hospital_chargemaster_canonical.","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/chargemaster_serving_views.md","known_gaps":["Validation gate may drop edge cases present in _canonical."],"notes":null,"superseded_by":"vlada_curated.vw_fact_hospital_chargemaster_canonical (the normalized layer; comparability lives on vw_fact_hospital_chargemaster_comparable). Retired 2026-09-25: a June view (Glue UpdateTime 2026-06-08) over the bare fact with a pre-cascade is_comparable heuristic, read by no production code.","tools":[],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["rate_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_comparability_mat","source_fqn":"vlada_curated.fact_hospital_comparability_mat","title":"Hospital comparability materialized table (per-state)","domain":"hospital","stage":"mart","status":"retired","grain":"One row per (CCN, billing_code, payer, plan, billing_class) with comparability class.","description":"The materialized table backing vw_fact_hospital_chargemaster_comparable — hospital rates with payer entity/plan structure + comparability_class precomputed per state. The physical mart the pricing live-fetcher reads.","identity_key":"hospital_ccn","row_count":null,"last_updated":null,"freshness_sla":"Derived (per-state build).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Per-state materialization."]},"raw_queryable_via":"Not queryable (retired bare name); read vlada_curated.vw_fact_hospital_chargemaster_comparable.","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/chargemaster_serving_views.md","known_gaps":["Built per-state; a partition gap = a missing state (see the HPT serving DQ lesson)."],"notes":null,"superseded_by":"vlada_curated.vw_fact_hospital_chargemaster_comparable (the view over the newest fact_hospital_comparability_mat_v<ts>). This bare name was orphaned when the mat moved to timestamped artifacts: Glue UpdateTime 2026-06-18, nothing repoints it (vlada/substrate/serving.py FORBIDDEN_MATERIALIZATION).","tools":[],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_mart_cell","source_fqn":"vlada_curated.mart_hospital_cell","title":"Hospital price-cell mart","domain":"hospital","stage":"mart","status":"live","grain":"One row per (CCN, billing_code, payer, plan, LOB, methodology, rate_type) price cell.","description":"The hospital price-cell serving mart — one materialized cell per (hospital, code, payer, plan, line_of_business, methodology, rate_type) with the rate. The precomputed serving grain for hospital price answers.","identity_key":"hospital_ccn","row_count":null,"last_updated":null,"freshness_sla":"Derived (incremental cell build).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Incremental cell build."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.mart_hospital_cell","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/chargemaster_serving_views.md","known_gaps":["Incremental mart; reads gated by VLADA_HPT_CELL_TABLE serving flag.","A Glue view over the newest mart_hospital_cell_v<ts> (2026-09-22 at writing, 4.56B rows, built per state); it mixes states on the fixed build and pre-fix states.","hospital_state is required; dollar medians of rate take comparability_class = 'REAL_NEGOTIATED', one methodology family and one line_of_business."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_comparison_mart","source_fqn":"vlada_curated.vw_hospital_comparison_mart","title":"Hospital price comparison mart (answered layer)","domain":"hospital","stage":"mart","status":"live","grain":"One row per (grain_level, code_system, billing_code, hospital_state, line_of_business, billing_class, methodology family, payer parent) statistic, plus the stored cheapest window rows (grain_level = 'cheapest').","description":"The precomputed answers compare_hospital_rates reads first (p10 / median / p90, n rows, n hospitals, the Medicare multiple and the cheapest window) per code, state, program and methodology family, built from the comparable surface with the tool's own floors and quarantine list. Each row carries build_id and as_of.","identity_key":"billing_code","row_count":null,"last_updated":"2026-09-19","freshness_sla":"Rebuilt by ops/scripts/build_hospital_comparison_mart.py on a cadence; as_of on every row.","recollection":{"cadence":"derived","watermark_field":"as_of","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt from the comparable surface; as_of on every row is its build date."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_hospital_comparison_mart","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/HOSPITAL-END-TO-END.md","known_gaps":["Filter grain_level first (all, code_system, family, family_blended, methodology, payer, cheapest); statistics at different grain levels are not additive.","Built 2026-09-19 (view over mart_hospital_comparison_v20260919T025717Z); states and labels changed after that date are not in it until the rebuild."],"notes":"The answered layer of the hospital price product (docs/architecture/2026-09-25-hospital-price-product.md).","superseded_by":null,"tools":["compare_hospital_rates"],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["billing_code"],"backing_store":"glue"},{"source_id":"hospital_code_state_rollup","source_fqn":"vlada_curated.mart_code_state_rollup","title":"Hospital price rollup by code x state x line of business","domain":"hospital","stage":"mart","status":"live","grain":"One row per (billing_code, code_system_resolved, hospital_state, line_of_business).","description":"Negotiated-rate min / median / max, the Medicare multiple, gross and cash medians, hospital and rate counts, and the count of rows excluded as percent-of-charges or other non-comparable classes, per code, state and program.","identity_key":"billing_code","row_count":null,"last_updated":"2026-08-03","freshness_sla":"Rebuilt by ops/scripts/build_code_state_rollup.py from mart_hospital_cell.","recollection":{"cadence":"derived","watermark_field":"rollup_vintage","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt from mart_hospital_cell; rollup_vintage on every row is its build date."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.mart_code_state_rollup","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/HOSPITAL-END-TO-END.md","known_gaps":["Built 2026-08-03 (rollup_vintage, cell_vintage on every row) from the cell mart of that date; it predates the re-grab of most certified states and the September label corrections. Prefer vw_hospital_comparison_mart or the comparable view until the rebuild.","Medians pool methodology families within a program; use the comparable view grouped by methodology_norm for a one-family median."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["billing_code"],"backing_store":"glue"},{"source_id":"hospital_code_state_payer_rollup","source_fqn":"vlada_curated.mart_code_state_payer_rollup","title":"Hospital price rollup by code x state x payer parent x line of business","domain":"hospital","stage":"mart","status":"live","grain":"One row per (billing_code, code_system_resolved, hospital_state, payer_parent_name, line_of_business).","description":"Negotiated-rate min / median / max, the Medicare multiple, and hospital, plan and rate counts per code, state, payer parent and program, with the counts of rows excluded as non-comparable.","identity_key":"billing_code","row_count":null,"last_updated":"2026-08-03","freshness_sla":"Rebuilt by ops/scripts/build_code_state_payer_rollup.py from mart_hospital_cell.","recollection":{"cadence":"derived","watermark_field":"rollup_vintage","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt from mart_hospital_cell; rollup_vintage on every row is its build date."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.mart_code_state_payer_rollup","commercial_terms":"Public HPT data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/hospital/HOSPITAL-END-TO-END.md","known_gaps":["Built 2026-08-03 (rollup_vintage, cell_vintage on every row) from the cell mart of that date; it predates the re-grab of most certified states, the September label corrections and the payer mapping in service now. Prefer the comparable view grouped by payer_parent_name until the rebuild.","Medians pool methodology families within a payer and program."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hospital_price_transparency","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["billing_code"],"backing_store":"glue"},{"source_id":"hospital_dept_ccr","source_fqn":"vlada_curated.mart_hospital_dept_ccr","title":"Hospital department cost ratios from Medicare cost reports (latest fiscal year per department)","domain":"hospital","stage":"mart","status":"live","grain":"One row per (hospital_ccn, cost_center_line), the latest usable fiscal year of that pair, plus one whole-hospital row per CCN under cost_center_line '__OVERALL__' (ccr_basis 'overall'). 138,458 rows, 6,909 hospitals (6,708 with the overall row), FY2011-2024 (measured 2026-09-27, qid 2d22e8a5).","description":"The normalized cost lens over the raw HCRIS Worksheet C table (medicare_silver.hospital_cost_report_dept): typed dept_ccr (double), the charge_as_cost 1.0 sentinel excluded, ratios at or above 10 excluded as parse or units defects, one row per hospital and department. Estimated cost of a service = its gross charge x the dept_ccr of the service's own cost center, found through medicare_silver.hcpcs_cost_center_crosswalk (hcpcs -> cost_center_line). An inpatient MS-DRG spans departments and uses the __OVERALL__ row, labelled by ccr_basis.","identity_key":"hospital_ccn","row_count":138458,"last_updated":"2026-07-28","freshness_sla":"Rebuilt by ops/scripts/build_hospital_dept_ccr.py (--probe then --build) after each HCRIS refresh; ccr_vintage on every row is its build.","recollection":{"cadence":"derived","watermark_field":"ccr_vintage","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived from HCRIS; ccr_vintage on every row is its build date, fy_year the cost-report year."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.mart_hospital_dept_ccr","commercial_terms":"Public CMS data.","provenance_chain_ref":"ops/scripts/build_hospital_dept_ccr.py from medicare_silver.hospital_cost_report_dept and medicare_silver.hospital_cost_report_overall (HCRIS HOSP10 2552-10).","known_gaps":["LATEST PER DEPARTMENT, NOT PER HOSPITAL. fy_year is chosen per (hospital, cost center), so one hospital's MRI and CT ratios can come from different years; the row's fy_year says which. 1,201 CCNs have at least one department whose latest usable year is FY2011, mostly closed or merged hospitals; check fy_year before comparing. For a trend, read mart_hospital_dept_ccr_history.","Join to prices on hospital_ccn and the service's cost center: JOIN medicare_silver.hcpcs_cost_center_crosswalk x ON x.hcpcs = <code> AND x.cost_center_line = c.cost_center_line. Never apply the __OVERALL__ ratio to an outpatient HCPCS: department ratios spread about 17x (CT median 0.043, MRI 0.091, Laboratory 0.200, Emergency 0.236, Operating Room 0.262 over all history).","A hospital can file no row for a department it runs (the service billed under a subscripted or different line); a missing CCR is not a zero cost. est_cost also needs a gross charge, and some hospitals post none.","E&M and professional-dominant codes map to the Clinic center with a near-1.0 ratio; the cost lens is for high-markup facility services (imaging, surgery, laboratory).","Built 2026-07-28 from the HCRIS snapshot of that date; a later HCRIS refresh is not in it until the rebuild."],"notes":"Normalized layer of the cost lens; the raw layer is medicare_silver.hospital_cost_report_dept (string columns, sentinel rows included).","superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hospital_dept_ccr_history","source_fqn":"vlada_curated.mart_hospital_dept_ccr_history","title":"Hospital department cost ratio history from Medicare cost reports (FY2011-2024)","domain":"hospital","stage":"mart","status":"live","grain":"One row per (hospital_ccn, cost_center_line, fy_year), with cost_center_label; the whole-hospital ratio under '__OVERALL__'. 1,359,025 rows, 6,909 hospitals, 14 fiscal years, 533 cost centers (measured 2026-09-27, qid 582e78d9).","description":"The same normalized department ratios as mart_hospital_dept_ccr for every recoverable fiscal year, for trends (a department's cost ratio over time) and for matching a price to the cost report of its own year.","identity_key":"hospital_ccn","row_count":1359025,"last_updated":"2026-07-29","freshness_sla":"View over mart_hospital_dept_ccr_history_v20260729b; rebuilt with the latest-year mart after an HCRIS refresh.","recollection":{"cadence":"derived","watermark_field":"ccr_vintage","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived from HCRIS; ccr_vintage on every row is its build date, fy_year the cost-report year."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.mart_hospital_dept_ccr_history","commercial_terms":"Public CMS data.","provenance_chain_ref":"Built 2026-07-29 (PR 1485) from medicare_silver.hospital_cost_report_dept with the latest-year mart's exclusions; the build DDL is not in the repo (known gap).","known_gaps":["Every dept_ccr is below 1.0 (measured); the 1.0 charge_as_cost sentinel rows of the raw table are not here.","Filing coverage grows over time (the cost report's latest years are still arriving; FY2024 is partial). Compare a department across years within one hospital, and count hospitals per year before reading a national trend.","The build DDL is not in the repo; rebuild it with ops/scripts/build_hospital_dept_ccr.py once that script carries a history mode."],"notes":"For a single current ratio use mart_hospital_dept_ccr.","superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_benchmark_view","source_fqn":"vlada_curated.vw_medicare_benchmark","title":"Medicare benchmark view (allowed by code × class)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (billing_code, billing_class) — Medicare allowed + source/year.","description":"A unified Medicare-allowed benchmark view by billing code + class, with the medicare_source (PFS/OPPS/etc.) and year. The single benchmark surface the RBP pricing router reads for \"Medicare allowed for this code\".","identity_key":"billing_code","row_count":null,"last_updated":null,"freshness_sla":"Derived (from the Medicare fee schedules).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived from the fee schedules."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_medicare_benchmark","provenance_chain_ref":null,"context_doc_path":"docs/context_library/medicare/medicare_pfs_ipps_localization.md","known_gaps":["National benchmark; for geographic detail use fact_*_payment_by_geo + localization."],"notes":null,"superseded_by":null,"tools":["compare_hospital_rates","medicare_allowed"],"dataset_id":"vlada_w2_medicare_benchmarks","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["billing_code"],"backing_store":"glue"},{"source_id":"care_site_verification_fact","source_fqn":"vlada_curated.fact_care_site_verification","title":"Care-site verification (county-fleet promoted truth)","domain":"provider_identity","stage":"curated","status":"live","grain":"One row per (NPI, county, care_site_class) — verified care-site verdict.","description":"The county-fleet promoted verification table: per NPI/county/class, the fleet_status (verified/reclassified/duplicate/unresolved), canonical site id, parent system, true facility type, confidence. The audited truth of which care sites are real (vw_care_site_verified serves it enriched).","identity_key":"npi","row_count":null,"last_updated":null,"freshness_sla":"Derived (per county-fleet vintage).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Per county-fleet vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.fact_care_site_verification","commercial_terms":"Derived from public data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/county_care_site_fleet.md","known_gaps":["Coverage = counties the fleet has run; absence = not-yet-verified, not invalid."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"derived","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"care_site_verified_view","source_fqn":"vlada_curated.vw_care_site_verified","title":"Care-site verified view (enriched)","domain":"provider_identity","stage":"semantic_view","status":"live","grain":"One row per verified care site (NPI) with identity + geography enrichment.","description":"Serving view unioning dim_care_site with fact_care_site_verification — verified care sites with legal name, CCN, class, county, parent system. The surface county_expert/county_intelligence read.","identity_key":"npi","row_count":null,"last_updated":null,"freshness_sla":"Derived.","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Derived view."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_care_site_verified","commercial_terms":"Derived from public data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/county_care_site_fleet.md","known_gaps":["Honors the fleet's care_site_class; only verified sites surface."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"care_site_geo","source_fqn":"vlada_curated.care_site_geo","title":"Care-site geography (CCN → CBSA/county/ZIP)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per care site (hospital_ccn) — its CBSA/county/ZIP geography.","description":"Care-site geography: hospital_ccn → care_site_type, CBSA, county FIPS, ZIP, city, state with geo source + vintage. Places each care site in its market.","identity_key":"hospital_ccn","row_count":null,"last_updated":null,"freshness_sla":"Derived.","recollection":{"cadence":"derived","watermark_field":"geo_vintage","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'geo_vintage' stamps the geocoding vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.care_site_geo","commercial_terms":"Derived from public data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/county_care_site_fleet.md","known_gaps":["geo_source/geo_vintage record provenance; geocoding can be approximate."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_spine_geography_hierarchy","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["hospital_ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"agg_county_intelligence","source_fqn":"vlada_curated.agg_county_intelligence","title":"County intelligence aggregate (supply by class)","domain":"curated","stage":"mart","status":"live","grain":"One row per (county_fips, care_site_class) — verified site count + ownership/ccn flags.","description":"County-fleet serving aggregate: per county and care-site class, the verified site_count, tier, ownership_resolved and ccn_linked flags. Backs the county_intelligence / county_expert supply answers.","identity_key":"county_fips","row_count":null,"last_updated":null,"freshness_sla":"Derived (per county-fleet vintage).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Per county-fleet vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.agg_county_intelligence","commercial_terms":"Derived from public data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/curated/county_care_site_fleet.md","known_gaps":["Counties present = fleet-run counties."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["census:county_fips"],"entity_key_columns":{"census:county_fips":["county_fips"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"agg_care_site_payer_coverage","source_fqn":"vlada_curated.agg_care_site_payer_coverage","title":"Care-site × payer coverage aggregate","domain":"curated","stage":"mart","status":"live","grain":"One row per (NPI, care_site_class, county, payer) — coverage + rate/contract shape.","description":"Aggregate of which payers have rates for each care site: NPI × class × county × payer with resolved flag, provider_group_count, rate_count, contract_shape. Backs county payer-coverage answers + the pricing flywheel.","identity_key":"npi","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.agg_care_site_payer_coverage","provenance_chain_ref":null,"known_gaps":["Coverage reflects extracted payers; absence != no contract."],"notes":null,"superseded_by":null,"tools":["state_expert"],"dataset_id":"vlada_w1_coverage_aggregates","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"agg_county_payer_landscape","source_fqn":"vlada_curated.agg_county_payer_landscape","title":"County × payer landscape aggregate","domain":"curated","stage":"mart","status":"live","grain":"One row per (county_fips, payer_id) — hospital MRF row count + status.","description":"Per county and payer, the hospital MRF coverage (hospital_mrf_rows) + status. A coverage map of which payers have hospital pricing in each county.","identity_key":"county_fips","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.agg_county_payer_landscape","provenance_chain_ref":null,"known_gaps":["Coverage of extracted payers only."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w1_coverage_aggregates","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["census:county_fips"],"entity_key_columns":{"census:county_fips":["county_fips"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"agg_state_payer_roster","source_fqn":"vlada_curated.agg_state_payer_roster","title":"State × payer roster aggregate","domain":"curated","stage":"mart","status":"live","grain":"One row per (state, payer_id) — coverage + build/action status.","description":"Per state and payer, coverage counts (ct_hospitals, mrf_rows), in_rds/built flags, and a recommended action. The operator-facing roster of payer coverage + what to build next per state.","identity_key":"state","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.agg_state_payer_roster","provenance_chain_ref":null,"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_agg_state","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"policy_document","source_fqn":"vlada_curated.fact_policy_document","title":"Policy document corpus (state/federal regulation docs)","domain":"curated","stage":"curated","status":"live","grain":"One row per policy document (doc_id) — title, citation, authority, S3 refs.","description":"The document-grounded policy corpus: per regulation document, title, citation, authority, format, size, status, and S3 raw/text pointers. The foundation that grounds state/federal effective-policy claims in cited docs.","identity_key":"doc_id","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.fact_policy_document","provenance_chain_ref":null,"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_policy_document","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"derived","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["doc_id"],"backing_store":"glue"},{"source_id":"policy_doc_chunk","source_fqn":"vlada_curated.fact_policy_doc_chunk","title":"Policy document chunks (retrieval units with citations)","domain":"curated","stage":"curated","status":"live","grain":"One row per (doc_id, chunk_no) — a citation-anchored text chunk.","description":"Chunked policy text for retrieval: doc_id, chunk_no, anchor, citation, text. The retrieval grain for document-grounded policy answers (every claim ties to a cited chunk).","identity_key":"doc_id","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.fact_policy_doc_chunk","provenance_chain_ref":null,"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_policy_doc","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"derived","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["doc_id"],"backing_store":"glue"},{"source_id":"medicare_landscape_ma_all","source_fqn":"medicare_silver.landscape_ma_all","title":"Medicare Advantage Landscape (plans by county × year)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per (report_year, contract, plan, segment, county) — MA plan + premiums.","description":"The CMS MA Landscape file — every MA/Part D plan offered by county and year with org/plan name, plan type, and premiums (consolidated, Part C, Part D). The plan-availability + premium spine for MA market analysis.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.landscape_ma_all","notes":null,"superseded_by":"medicare_silver.ma_landscape_member_ledger (stamped re-collection 2026-09-07: same rows plus the provenance envelope (source_url, sha256_content_hash, asserted_at); the legacy table stays queryable until dropped)","tools":[],"dataset_id":"ds_ma_landscape","dataset_assignment_basis":"context_doc","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_ma_landscape_member_ledger","source_fqn":"medicare_silver.ma_landscape_member_ledger","title":"CMS MA / Part D Landscape member ledger (one row per publisher CSV member parsed)","domain":"medicare","stage":"silver","status":"live","grain":"One row per parsed CSV member per report_year: member name, sha256, header signature, mapping applied, ignored columns, rows parsed/skipped; 169 members on 2026-09-07.","description":"The parse ledger behind fact_ma_landscape: which publisher file member produced which year and category, under which header signature, with the exact header-to-column mapping applied. Read it to explain any Landscape number back to its file.","identity_key":"contract_id,plan_id,segment_id","row_count":169,"last_updated":"2026-09-07","freshness_sla":"Annual (CMS Landscape, AEP).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' follows fact_ma_landscape; one ledger row per parsed member per report_year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_landscape_member_ledger","commercial_terms":"Public CMS data.","provenance_chain_ref":"pipelines/medicare/ingest/ma_landscape_runner.py; written in the same commit as fact_ma_landscape","context_doc_path":"docs/context_library/medicare/ma_landscape.md","known_gaps":["18 members of the CY2006-CY2025 bundle are skipped by design (plan-and-premium duplicates and non-data members); they are listed as skipped, not silently dropped."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_landscape","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_fact_ma_landscape_edition","source_fqn":"medicare_silver.fact_ma_landscape_edition","title":"CMS MA / Part D Landscape, EVERY edition held (Wayback originals + revisions + served copy), one partition per publisher zip","domain":"medicare","stage":"silver","status":"live","grain":"One row per edition x report_year x record_family x category x plan (contract, plan, segment) as published; natural key (edition, report_year, row_seq); 24 editions, 4,034,483 landscape rows (6,066,778 incl. plan-and-premium rows) on 2026-09-08.","description":"Sibling of fact_ma_landscape (which holds ONE edition per report_year: the copy CMS serves today, a REVISED bundle for CY2006-CY2025 with the star column re-stamped and sanctioned rows removed). This table holds every edition we have of a year side by side: the original September publication captured from the Wayback Machine (22 zips, CY2021-CY2026, bronze initial_editions/ with SHA-256), each mid-year revision, and the served copy. edition = the publisher zip stem (cy2026-landscape-202509 = the original CY2026 file of Sept 2025; cy2026-landscape-202608 = the Aug 2026 revision; cy2006-cy2025-landscape-files = the served bundle). Same columns as fact_ma_landscape plus edition; strings as published, cast on read. Use for what the market saw on Landscape day and the original-vs-revised diff; use fact_ma_landscape for the single served view.","identity_key":"contract_id,plan_id,segment_id","row_count":6066778,"last_updated":"2026-09-08","freshness_sla":"Event-driven (a new CMS revision or Wayback capture = one more zip under bronze initial_editions/ + a manifest line + one more partition).","recollection":{"cadence":"event_driven","watermark_field":"edition","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A replace of one edition partition never touches another edition or fact_ma_landscape."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ma_landscape_edition","commercial_terms":"Public CMS data (Wayback Machine captures of CMS-published zips).","provenance_chain_ref":"pipelines/medicare/ingest/ma_landscape_edition_runner.py (job build_medicare_ma_landscape_editions) from s3://vlada-platform-raw/medicare/bronze/cms_ma_landscape/initial_editions/manifest.jsonl (22 SHA-verified originals) + the held zips under the same prefix; edition inventory docs/knowledge/ma/landscape-editions-ledger.md; parse ledger medicare_silver.ma_landscape_edition_ledger","context_doc_path":"docs/context_library/medicare/ma_landscape.md","known_gaps":["Originals exist only from CY2021 (Wayback has no earlier September captures found); CY2006-CY2020 are present only as the served revised bundle.","asserted_at is the load date (2026-09-08), not the publisher's publication date; the publication month is in the edition label, the first Wayback capture in the editions ledger."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_landscape","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_ma_landscape_edition_ledger","source_fqn":"medicare_silver.ma_landscape_edition_ledger","title":"CMS MA / Part D Landscape edition ledger (one row per publisher CSV member parsed, per edition)","domain":"medicare","stage":"silver","status":"live","grain":"One row per edition x parsed CSV member: member name, sha256, header signature, mapping applied, ignored columns, rows parsed/skipped; 276 members on 2026-09-08.","description":"The parse ledger behind fact_ma_landscape_edition: which member of which edition zip produced which year and category, under which header signature (47 signatures in pipelines/medicare/silver/ma_landscape_contracts.yaml, 9 of them seen only in original editions), with the exact header-to-column mapping applied.","identity_key":"contract_id,plan_id,segment_id","row_count":276,"last_updated":"2026-09-08","freshness_sla":"Event-driven (with fact_ma_landscape_edition).","recollection":{"cadence":"event_driven","watermark_field":"edition","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["One row per edition x member; a replace of one edition partition never touches another edition."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_landscape_edition_ledger","commercial_terms":"Public CMS data.","provenance_chain_ref":"pipelines/medicare/ingest/ma_landscape_edition_runner.py; written in the same commit as fact_ma_landscape_edition","context_doc_path":"docs/context_library/medicare/ma_landscape.md","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_landscape","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_mpf_optional_supplemental","source_fqn":"medicare_silver.mpf_optional_supplemental_annual","title":"Medicare Plan Finder — optional supplemental benefits (annual)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract, plan, segment, package, service category, year) — supplemental benefit + cost share.","description":"Medicare Plan Finder optional supplemental benefit packages by plan and year: package, service category, whether offered, cost-share type and amount. The optional-supplemental benefit detail layer for MA plans.","identity_key":"contract_id,plan_id,segment_id","row_count":null,"last_updated":null,"freshness_sla":"Annual.","recollection":{"cadence":"annual","watermark_field":"contract_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'contract_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.mpf_optional_supplemental_annual","provenance_chain_ref":"medicare_silver M-2 substrate.","context_doc_path":"docs/context_library/medicare/ma_landscape.md","known_gaps":["Optional supplemental packages only; mandatory benefits are in PBP. Null cost_share != $0 — see PBP semantics."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_finder_mpf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"fda_drug_master_file","source_fqn":"drug_silver.dim_dmf","title":"FDA Drug Master Files (DMF)","domain":"drug","stage":"dim","status":"live","grain":"One row per Drug Master File (dmf_number) — type, status, holder, subject.","description":"FDA Drug Master Files — confidential filings (type, status, holder, subject, submit date) referenced by drug applications. Supply-chain / API-source reference for a drug.","identity_key":"dmf_number","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_dmf","notes":null,"superseded_by":null,"tools":[],"dataset_id":"fda_drug_master_files","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["dmf_number"],"backing_store":"glue"},{"source_id":"drug_clinical_trial","source_fqn":"drug_silver.fact_drug_clinical_trial","title":"Clinical Trials (ClinicalTrials.gov, drug-regulated)","domain":"drug","stage":"silver","status":"live","grain":"One row per trial (nct_id, data_year) — status, phase, sponsor, enrollment.","description":"ClinicalTrials.gov records (drug-regulated): NCT id, title, overall status, study type, phase, enrollment, lead sponsor + class, FDA-regulated flag, has_results. The pipeline/evidence context for a drug.","identity_key":"nct_id","row_count":null,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_clinical_trial","notes":null,"superseded_by":null,"tools":[],"dataset_id":"nlm_clinicaltrials_gov","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["nct_id"],"backing_store":"glue"},{"source_id":"form5500_service_provider_code","source_fqn":"drug_silver.fact_form5500_service_provider_code","title":"Form 5500 — service provider codes (Schedule C)","domain":"drug","stage":"silver","status":"live","grain":"One row per (filing ack_id, plan_year, service code) — provider service code; served plan years 2009-2025. Pre-EFAST2 1999-2008 is secured but deferred to a separate legacy table family.","description":"The EFAST2 Form 5500 Schedule C service-provider service codes per filing for plan years 2009-2025. The pre-EFAST2 Schedule C archive is byte-secured but is not merged into this certified EFAST2 sidecar.","identity_key":"ack_id","row_count":10564656,"last_updated":"2026-07-26","freshness_sla":"Annual (DOL Form 5500).","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the source's documented vintage/currency column.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs.","The served sidecar joins to the served provider rows by ack_id; pre-EFAST2 remains in the separate deferred legacy lane."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_form5500_service_provider_code","commercial_terms":"Public DOL data.","provenance_chain_ref":"drug_silver M-2 substrate","context_doc_path":"docs/context_library/drug/form5500_schedule_c.md","known_gaps":["EFAST2 2009-2025 is loaded at 10,564,656 service-code rows (re-measured 2026-07-26 after the 2020-2024 refresh; the prior catalog figure of 10,554,124 was the pre-refresh count). The SIX-table EFAST2 family totals 32,402,086 rows.","This sidecar is the only one of the six Form 5500 tables that is NOT source-certified; its claim ceiling is queryable. The other five carry product1-source-acceptance/v1 artifacts.","Pre-EFAST2 1999-2008 bytes are secured in 160 files totaling 1,973,997,290 bytes with zero misses and the full SHA-256/S3 manifest, but legacy code serving is intentionally deferred.","Pre-2009 service-code semantics belong to the separate FILING_ID-keyed legacy table family; do not join them to ACK_ID or union them into the EFAST2 sidecar."],"notes":"Terminal state complete_and_served for the EFAST2 era with a documented pre-EFAST2 source limit; archive manifest: docs/reference/source-audit/source-mastery/manifests/large-wave/form5500.json.","superseded_by":null,"tools":[],"dataset_id":"dol_form5500_efast2","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["ack_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_provider_ownership","source_fqn":"medicare_silver.fact_provider_ownership","title":"CMS PECOS Provider Ownership (\"All Owners\", PE-rollup layer)","domain":"provider_identity","stage":"silver","status":"live","grain":"One row per facility ↔ owner edge (enrollment_id × owner), partitioned by facility_type.","description":"The CMS PECOS \"All Owners\" ownership records, unified across six facility types (hospital, hha, hospice, snf, fqhc, rhc). One row per facility↔owner edge: owner identity (individual or org name/DBA/address), percentage ownership, role, association date, and the owner-type flags that drive accountability/PE analysis — PRIVATE EQUITY, REIT, HOLDING COMPANY, INVESTMENT FIRM, CHAIN HOME OFFICE, PARENT COMPANY, TRUST/TRUSTEE, FOR/NON PROFIT, plus an indirect-chain \"owned by another org\" flag. THE ownership / private-equity-rollup intelligence layer (who really owns each facility).","identity_key":"enrollment_id","row_count":814242,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_provider_ownership","notes":"Iceberg table medicare_silver.fact_provider_ownership, partitioned by facility_type; one All-Owners file fully restates its type (replace, idempotent by SHA-256). One runner ingests all six datasets.","superseded_by":null,"tools":["resolve_provider"],"dataset_id":"cms_pecos_all_owners","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["enrollment_id"],"backing_store":"glue"},{"source_id":"cms_hospital_service_area","source_fqn":"medicare_silver.fact_hospital_service_area","title":"CMS Hospital Service Area (referral geography by CCN × ZIP)","domain":"hospital","stage":"silver","status":"live","grain":"One row per (data_year, hospital CCN, patient ZIP) — cases/days/charges.","description":"The CMS Hospital Service Area file — for each hospital (CCN) the ZIP codes its Medicare FFS patients reside in, with total_cases, total_days_of_care, total_charges. The referral-GEOGRAPHY layer: which markets a hospital draws from, and (inverted) which hospitals serve a ZIP / compete in a market. Multi-year (2015–2024), partitioned by data_year.","identity_key":"ccn","row_count":1155777,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hospital_service_area","notes":"Iceberg table medicare_silver.fact_hospital_service_area, partitioned by data_year (replace per year, idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_hospital_service_area","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_medicare_geo_variation","source_fqn":"medicare_silver.fact_medicare_geo_variation","title":"CMS Medicare Geographic Variation (per-capita cost + utilization by geography)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (year, bene_geo_level, bene_geo_code, bene_age_level) — National/State/County.","description":"The CMS Medicare Geographic Variation PUF — Medicare FFS standardized per-capita cost and utilization by geography and year (National / State / County), curated to the high-value subset: population + demographics, total standardized per-capita payment, per-service-category standardized per-capita cost (IP, OP, ASC, SNF, HH, hospice, E&M, procedures, tests, imaging, DME, FQHC/RHC, ambulance), and key utilization (IP stays /1,000, readmission %, ER visits /1,000, imaging events /1,000). THE medical geographic-variation benchmark — how Medicare spend per beneficiary varies by market (the cost counterpart to the drug geo-variation we already had).","identity_key":"bene_geo_code","row_count":37000,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_medicare_geo_variation","notes":"Iceberg table medicare_silver.fact_medicare_geo_variation, partitioned by year (replace per year, single source file with an in-row YEAR column).","superseded_by":null,"tools":[],"dataset_id":"cms_geographic_variation_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["bene_geo_code"],"backing_store":"glue"},{"source_id":"cms_hrrp","source_fqn":"medicare_silver.fact_hrrp","title":"CMS Hospital Readmissions Reduction Program (HRRP)","domain":"hospital","stage":"silver","status":"live","grain":"One row per (fiscal_year, ccn, measure_name) — full HRRP program history FY2013-FY2026","description":"The CMS Hospital Readmissions Reduction Program file — per hospital CCN, fiscal year, and condition measure, carrying excess readmission ratio, predicted and expected readmission rates, discharges, and readmissions.","identity_key":"fiscal_year,ccn,measure_name","row_count":245914,"last_updated":"2026-07-11","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hrrp","notes":"Iceberg medicare_silver.fact_hrrp, partition by fiscal_year with FY-scoped replace semantics. Natural key is (fiscal_year,ccn,measure_name); registry ids are cms_hrrp#fy<year>.","superseded_by":null,"tools":["get_hospital_quality"],"dataset_id":"cms_hrrp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":["fiscal_year","measure_name"],"backing_store":"glue"},{"source_id":"cms_hvbp","source_fqn":"medicare_silver.fact_hvbp","title":"CMS Hospital Value-Based Purchasing (HVBP) Total Performance Score","domain":"hospital","stage":"silver","status":"live","grain":"One row per (fiscal_year, hospital CCN) — domain scores + total performance score.","description":"The CMS Hospital Value-Based Purchasing Total Performance Score file — per hospital and fiscal year the four domain scores (Clinical Outcomes, Person & Community Engagement, Safety, Efficiency & Cost Reduction; unweighted + weighted) and the overall Total Performance Score that drives the VBP payment adjustment. The value-based-purchasing accountability layer.","identity_key":"ccn","row_count":2455,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hvbp","notes":"Iceberg medicare_silver.fact_hvbp, partition by fiscal_year, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_hvbp","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hacrp","source_fqn":"medicare_silver.fact_hacrp","title":"CMS Hospital-Acquired Condition Reduction Program (HACRP)","domain":"hospital","stage":"silver","status":"live","grain":"One row per (fiscal_year, hospital CCN) with PSI-90, five HAI measures, Total HAC Score, and payment-reduction status.","description":"The CMS HAC Reduction Program hospital file. It carries PSI-90, CLABSI, CAUTI, SSI, CDI, and MRSA values and standardized scores, the Total HAC Score, and whether the hospital receives the one-percent Medicare payment reduction.","identity_key":"fiscal_year,ccn","row_count":3055,"last_updated":"2026-08-08","raw_queryable_via":"Athena (read-only): medicare_silver.fact_hacrp","notes":"FY2026 is live at 3055 rows and 3055 unique CCNs with zero duplicate FY+CCN keys or required-lineage nulls. Exact replay returned IDEMPOTENT_SKIP. Current rows overlap 3045 hospital-quality CCNs and 3050 hospital-price-spine CCNs.","superseded_by":null,"tools":[],"dataset_id":"ds_cms_hacrp","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":["fiscal_year"],"backing_store":"glue"},{"source_id":"cms_esrd_qip","source_fqn":"medicare_silver.fact_esrd_qip","title":"CMS ESRD QIP Total Performance Score (dialysis pay-for-performance)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (payment_year, dialysis facility CCN) — TPS + payment reduction.","description":"The CMS ESRD Quality Incentive Program Total Performance Score — per dialysis facility the Total Performance Score vs state and national averages, and the resulting payment_reduction_pct (0–2%). The dialysis pay-for-performance / penalty layer (the dialysis counterpart to HVBP/HRRP for hospitals).","identity_key":"ccn","row_count":7558,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_esrd_qip","notes":"Iceberg medicare_silver.fact_esrd_qip, partition by payment_year, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_esrd_qip","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_dialysis_facility_quality","source_fqn":"medicare_silver.dim_dialysis_facility_quality","title":"CMS Dialysis Facility quality (five-star + facility attributes)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per dialysis facility CCN — five-star rating + ownership/services/mortality.","description":"Curated subset of the CMS Dialysis Facility Listing (142-col): five-star rating, profit/non-profit, chain owned + chain organization, number of dialysis stations, services offered (in-center HD / peritoneal / home HD training), and facility mortality rate. The dialysis facility quality + attribute enrichment (complements the dim_dialysis_facility roster + the ESRD QIP performance score).","identity_key":"ccn","row_count":7557,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_dialysis_facility_quality","notes":"Iceberg medicare_silver.dim_dialysis_facility_quality, partition by state, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_care_compare_dialysis","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_pecos_enrollment","source_fqn":"medicare_silver.fact_pecos_enrollment","title":"CMS Medicare FFS Public Provider Enrollment (PECOS NPI↔enrollment bridge)","domain":"provider_identity","stage":"silver","status":"live","grain":"One row per Medicare enrollment (enrollment_id) — NPI + associate_id + provider type.","description":"The CMS Medicare Fee-For-Service Public Provider Enrollment registry — one row per PECOS enrollment linking NPI ↔ enrollment_id (ENRLMT_ID) ↔ associate_id (PECOS_ASCT_CNTL_ID), with provider type and name. THE bridge that resolves fact_provider_ownership (keyed on enrollment_id / owner_associate_id) to a provider NPI — closing the ownership→NPI gap. ~2.98M enrollments / 2.56M NPIs.","identity_key":"npi","row_count":2981799,"last_updated":null,"freshness_sla":"Refreshed when CMS republishes the public enrollment file (~quarterly).","recollection":{"cadence":"derived","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp (current snapshot)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_pecos_enrollment","context_doc_path":"docs/context_library/medicare/pecos_enrollment.md","known_gaps":["~2.98M enrollments; an NPI can have multiple enrollments (multiple_npi_flag) — join carefully.","Carries NPI + associate_id, not CCN directly; CCN comes via the per-type Enrollments files (future) or dim_hospital_external."],"notes":"Iceberg medicare_silver.fact_pecos_enrollment, partition by state, replace (idempotent by SHA-256).","superseded_by":null,"tools":["resolve_provider"],"dataset_id":"cms_pecos_public_provider_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_facility_npi_ccn_xref","source_fqn":"medicare_silver.facility_npi_ccn_xref","title":"CMS Facility Organization NPI to CCN Crosswalk","domain":"provider_identity","stage":"silver","status":"live","grain":"One row per exact CMS-published facility organization NPI to Medicare CCN edge, by facility type and source file.","description":"Exact facility NPI<->CCN bridge derived from CMS per-provider-type Public Provider Enrollment files: Home Health Agency Enrollments, Hospice Enrollments, Skilled Nursing Facility Enrollments, Rural Health Clinic Enrollments, and Federally Qualified Health Center Enrollments. Each source row carries both NPI and CCN; the pipeline emits direct edges only, with no fuzzy matching, name similarity, or address matching.","identity_key":"npi","row_count":null,"last_updated":null,"freshness_sla":"Refreshed when CMS republishes per-type enrollment files (generally monthly/quarterly by file).","recollection":{"cadence":"derived","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp (current snapshot)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.facility_npi_ccn_xref","context_doc_path":"docs/context_library/medicare/facility_npi_ccn_xref.md","known_gaps":["Current-snapshot enrollment files only; no historical NPI<->CCN intervals.","Multi-CCN NPIs can exist; FacilityCcnResolver treats those NPIs as ambiguous and falls back to exact name+ZIP/state only when available.","Covers HHA, hospice, SNF, RHC, and FQHC per-type enrollment files. ESRD/dialysis already resolves through vlada_curated.dim_dialysis_facility."],"notes":"Iceberg table medicare_silver.facility_npi_ccn_xref, partitioned by facility_type; one atomic per-facility-type replace per ingest. Source rows are exact CMS-published enrollment edges.","superseded_by":null,"tools":[],"dataset_id":"cms_pecos_public_provider_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_ncci_ptp","source_fqn":"medicare_silver.ncci_ptp","title":"CMS NCCI Procedure-to-Procedure (PTP) Edits — Practitioner","domain":"medicare","stage":"silver","status":"retired","grain":"One row per active CMS NCCI PTP edit pair (Column-1 comprehensive code, Column-2 component code) with its modifier indicator and setting.","description":"CMS National Correct Coding Initiative Procedure-to-Procedure edits: pairs of HCPCS/CPT codes that are NOT separately payable when billed together for the same patient on the same date. Each edit names a Column-1 (comprehensive) code and the Column-2 (component) code bundled into it, plus a modifier indicator (0=never bypassable; 1/9=a distinct-procedure modifier such as 59/XE/XS/XP/XU can separate the pair). Used by the claims-repricing engine to bundle component lines so professional (and outpatient) claims are not double-counted. Quarterly CMS file (2026 Q3, ccipra v322r0); active edits only.","identity_key":"column_1_code","row_count":1728585,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ncci_ptp","notes":"Iceberg table medicare_silver.ncci_ptp. Loaded from the CMS 2026 Q3 Practitioner PTP 4-part text export (>2.6M rows) deduped to 1,728,585 active unique pairs. The pricer queries it per-book (edits among present codes only), not a full in-memory load.","superseded_by":"medicare_silver.ref_ncci_ptp_edit (stamped re-collection 2026-09-07: every quarterly edition, both settings, deleted pairs kept with their deletion dates; filter deletion_date IS NULL for the active set)","tools":[],"dataset_id":"ds_cms_ncci","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["column_1_code"],"backing_store":"glue"},{"source_id":"cms_ncci_ptp_edit_editions","source_fqn":"medicare_silver.ref_ncci_ptp_edit","title":"CMS NCCI Procedure-to-Procedure (PTP) edits — quarterly editions, practitioner and hospital, stamped","domain":"medicare","stage":"silver","status":"live","grain":"One row per (edition, setting, pair as published) including pairs carrying a deletion_date; natural key (edition, row_seq); 4,506,527 rows for 2026Q4 (practitioner 2,637,645 / hospital 1,868,882).","description":"CMS NCCI PTP edits re-collected through the provenance envelope on 2026-09-07: both settings, every pair as published with effective and deletion dates, modifier indicator and rationale. Filter deletion_date IS NULL for the active edit set (the legacy ncci_ptp was that active practitioner set for one quarter). CPT descriptors are not stored (AMA license accepted openly; the license page is kept in bronze).","identity_key":"column_1_code","row_count":4506527,"last_updated":"2026-09-07","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ref_ncci_ptp_edit","notes":"Iceberg table medicare_silver.ncci_ptp. Loaded from the CMS 2026 Q3 Practitioner PTP 4-part text export (>2.6M rows) deduped to 1,728,585 active unique pairs. The pricer queries it per-book (edits among present codes only), not a full in-memory load.","superseded_by":null,"tools":[],"dataset_id":"cms_ncci_ptp_edits","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["column_1_code"],"backing_store":"glue"},{"source_id":"cms_pfs_indicators","source_fqn":"medicare_silver.medicare_pfs_indicators","title":"CMS PFS Payment-Policy Indicators (PPRRVU)","domain":"medicare","stage":"silver","status":"live","grain":"One row per HCPCS x modifier from the CMS PFS Relative Value File — the status / global / PC-TC / multiple-procedure / bilateral indicators.","description":"Per HCPCS x modifier, the payment-policy indicators from the CMS PFS Relative Value File (PPRRVU) that the National Physician Fee Schedule pricing files drop: status_code (A/B/N/X...), global_period (000/010/090/XXX...), pctc_ind (PC/TC split), mult_proc_ind (the multiple-procedure reduction rule: 2=standard surgical MPPR 100/50/50, 3=endoscopy, 4=imaging, 5=therapy, 9=n/a), and bilat_ind (the bilateral rule: 1=150% adjustment applies). Used by the claims-repricing engine to apply the multiple-procedure reduction and bilateral adjustment so professional claims aren't paid in full where Medicare reduces. Quarterly CMS release (2026, rvu26c).","identity_key":"hcpcs","row_count":19356,"last_updated":null,"freshness_sla":"Refreshed when CMS posts a new quarterly PFS Relative Value File.","recollection":{"cadence":"quarterly","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'asserted_at' is the M-2 publication-date stamp (current snapshot)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicare_pfs_indicators","commercial_terms":"Public CMS data (references AMA CPT code identifiers); freely downloadable from cms.gov.","provenance_chain_ref":"pipelines/medicare/ingest/pfs_indicators_runner.py — PPRRVU CSV parsed positionally, M-2 envelope (asserted_at + sha256 + source_url) on every row.","context_doc_path":"docs/context_library/medicare/pfs_indicators.md","known_gaps":["Current-snapshot indicators (latest release); historical indicator changes not retained beyond the partition year.","Carries the policy indicators only (status/global/pctc/mult-proc/bilateral); the RVUs/conversion factor live in medicare_physician_fee_schedule."],"notes":"Iceberg table medicare_silver.medicare_pfs_indicators, partitioned by year. Parsed by stable PPRRVU column position (the multi-row header has ambiguous names). The pricer queries it per-book (codes present only).","superseded_by":null,"tools":[],"dataset_id":"cms_pfs_relative_value_files","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_physician_by_provider_service","source_fqn":"medicare_silver.fact_physician_by_provider_service","title":"Medicare Physician & Other Practitioners — by Provider and Service (granular price)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (data_year, rendering NPI, HCPCS, place of service) — charge/allowed/paid.","description":"The CMS Medicare Physician & Other Practitioners PUF at the **provider×service** grain: per rendering NPI, HCPCS, and place of service, the average submitted charge, **Medicare allowed**, Medicare paid, and standardized amounts, plus beneficiary/service counts. The GRANULAR per-provider price — the provider-level counterpart to the geo benchmark (`fact_physician_payment_by_geo`). ~9.8M rows/year, partitioned by data_year (2013-2024 available).","identity_key":"rndrng_npi","row_count":116297407,"last_updated":null,"freshness_sla":"Annual (CMS Physician & Other Practitioners PUF).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_physician_by_provider_service","context_doc_path":"docs/context_library/medicare/physician_by_provider.md","known_gaps":["~9.8M rows PER YEAR; ALWAYS filter data_year (+ ideally state/HCPCS) — full scans are very expensive.","CURATED ~21-col subset of the 28-col PUF (kept identity + geo + the 4 value amounts + 3 counts; dropped street address / MI / RUCA desc).","HEAVY COMPUTE: future annual refresh/replay runs on the worker fleet (job_type build_physician_by_provider), not a laptop. Full 2013-2024 history is live/proven in Iceberg at 116,297,407 rows.","avg_medicare_standardized is wage/geography-adjusted (comparable across markets); avg_submitted_charge is billed, not paid."],"notes":"Iceberg medicare_silver.fact_physician_by_provider_service, partition by data_year; bulk-load (append_buffered per 500k-row chunk → flush_buffered_replace_partitions per year, atomic, idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_puf_physician_other_practitioners","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rndrng_npi"],"backing_store":"glue"},{"source_id":"cms_inpatient_by_provider_service","source_fqn":"medicare_silver.fact_inpatient_by_provider_service","title":"Medicare Inpatient Hospitals — by Provider and Service (granular DRG price)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (data_year, hospital CCN, MS-DRG) — discharges + charge + payments.","description":"The CMS Medicare Inpatient Hospitals PUF at the provider×DRG grain: per hospital (CCN) and MS-DRG, total discharges, average submitted covered charge, average total payment, and average Medicare payment. The granular per-hospital inpatient price (provider-level counterpart to fact_inpatient_payment_by_geo). FY2011-FY2024 are loaded; FY2011-FY2013 are the CMS top-100-DRG era, while FY2014+ are broader all-DRG files.","identity_key":"ccn","row_count":2451944,"last_updated":null,"freshness_sla":"Annual (CMS Inpatient PUF).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_inpatient_by_provider_service","context_doc_path":"docs/context_library/medicare/hospital_by_provider.md","known_gaps":["FY2011-FY2013 are CMS top-100 most frequently billed MS-DRG era files; FY2014+ are broader all-DRG files.","Curated subset (CCN/geo + DRG + discharges + 3 payment amounts; dropped street/city/RUCA-desc).","avg_submitted_charge is billed; avg_medicare_payment is what Medicare paid; avg_total_payment includes other payers' share."],"notes":"Iceberg medicare_silver.fact_inpatient_by_provider_service, partition by data_year, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_puf_inpatient_hospitals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_outpatient_by_provider_service","source_fqn":"medicare_silver.fact_outpatient_by_provider_service","title":"Medicare Outpatient Hospitals — by Provider and Service (granular APC price)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (data_year, hospital CCN, APC) — bene/services + charge + Medicare allowed/paid + outlier.","description":"The CMS Medicare Outpatient Hospitals PUF at the provider×APC grain: per hospital (CCN) and comprehensive APC, beneficiary/service counts plus average submitted charge, Medicare allowed, Medicare paid, and outlier amounts. The complete official C-APC series is loaded for 2015-2024 at 1,008,975 rows. This is a claims-derived provider benchmark, not the contractual OPPS fee schedule.","identity_key":"ccn","row_count":1008975,"last_updated":null,"freshness_sla":"Annual (CMS Outpatient PUF).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_outpatient_by_provider_service","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/hospital_by_provider.md","known_gaps":["CMS states that the current C-APC series begins in 2015; the incompatible pre-2015 predecessor PUF is not a missing vintage of this series.","Curated subset (CCN/geo + APC + counts + allowed/paid + outlier; dropped street/city/RUCA-desc).","APC grain, not HCPCS. The amount fields are claims-derived averages and are not the statutory OPPS payment-rate table.","Upstream CMS-value anomaly guardrail: 9 rows have capc_services >= 10,000; 4 have >=100 services per populated beneficiary and 7 pair >=10,000 services with avg_medicare_allowed < $100. Review/quarantine these rows before volume-weighted analysis.","CCN joins require a unique partner row. The 2026-07-10 overlap audit found 2024 coverage of 97.31% to care_site_geo and 98.59% to dim_hospital_external, but care_site_geo has 76 multi-row CCNs and can fan out unless deduplicated."],"notes":"Iceberg medicare_silver.fact_outpatient_by_provider_service, partition by data_year, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_puf_outpatient_hospitals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_dme_by_supplier_service","source_fqn":"medicare_silver.fact_dme_by_supplier_service","title":"Medicare DME, Devices & Supplies — by Supplier and Service (granular supplier price)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (data_year, supplier NPI, HCPCS) — charge/allowed/paid/standardized.","description":"The CMS Medicare DME PUF at the supplier×HCPCS grain: per supplier NPI and HCPCS, the avg submitted charge, Medicare allowed, paid, and standardized amounts + bene/claim/service counts, with RBCS clinical category, specialty, and rental indicator. The granular per-supplier DME price (provider-level counterpart to fact_dme_payment_by_geo). ~464k rows/year, 2014-2023, partition by data_year.","identity_key":"suplr_npi","row_count":463784,"last_updated":null,"freshness_sla":"Annual (CMS DME PUF).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_dme_by_supplier_service","context_doc_path":"docs/context_library/medicare/dme_and_clfs_private.md","known_gaps":["~464k rows/year (2014-2023); curated subset (supplier/geo + specialty + RBCS + HCPCS + rental + counts + 4 amounts; dropped street/MI/credentials).","suplr_rentl_ind flags rented vs purchased; avg_medicare_standardized is geography-adjusted."],"notes":"Iceberg medicare_silver.fact_dme_by_supplier_service, partition by data_year, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_puf_dme_devices_supplies","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["suplr_npi"],"backing_store":"glue"},{"source_id":"cms_clfs_private_payer_rate","source_fqn":"medicare_silver.fact_clfs_private_payer_rate","title":"Medicare CLFS Private Payer Rates and Volumes (PAMA)","domain":"medicare","stage":"silver","status":"live","grain":"One row per reported (collection_year, row_seq) private-payer rate/volume observation, keyed to HCPCS.","description":"The PAMA \"applicable information\" — private-payer rates and volumes labs report to CMS, per HCPCS. A RARE public private-rate signal (distinct from the standard CLFS fee schedule `medicare_clfs`). The CMS-computed weighted median of these sets the CLFS; this is the underlying per-observation distribution.","identity_key":"hcpcs_cd","row_count":7515432,"last_updated":"2026-09-23","freshness_sla":"Per PAMA data-collection cycle (every 3 years).","recollection":{"cadence":"derived","watermark_field":"collection_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'collection_year' is the PAMA data-collection cycle year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_clfs_private_payer_rate","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/dme_and_clfs_private.md","known_gaps":["RAW per-observation rows, two collections: 2018 (967,129 rows, 1,013 codes; set CY2021-2026 rates) and 2026 (6,548,303 rows, 1,528 codes; sets CY2027 rates, loaded 2026-09-23 through the PAMA runner and reconciled per code to CMS's CSV). Many rows per HCPCS; always filter collection_year and aggregate (e.g. weighted median) per hcpcs_cd for a single benchmark.","The 2026 file's column names differ (Payment_Rate, Volume); the parser maps them to the same two columns. Identical rows are separate observations (row_seq keeps them).","Codes reported by fewer than 10 TINs are withheld by CMS by statute.","volume_text is a text field (may be ranges); private_payer_rate is the reported rate amount."],"notes":"Iceberg medicare_silver.fact_clfs_private_payer_rate, partition by collection_year, replace (idempotent by SHA-256). row_seq makes each observation unique.","superseded_by":null,"tools":[],"dataset_id":"cms_clfs_pama_private_payer_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_clfs_private_payer_rate_2026collection","source_fqn":"medicare_silver.fact_clfs_private_payer_rate_2026collection","title":"Medicare CLFS Private Payer Rates and Volumes (PAMA), 2026 collection (sets CY2027 rates)","domain":"medicare","stage":"silver","status":"retired","grain":"One row per reported private-payer rate/volume observation (collection_year 2026), keyed to HCPCS; no row_seq, many rows per hcpcs_cd.","description":"The 2026 PAMA data collection: 6,548,302 private-payer rate and volume observations across 1,528 HCPCS codes, the observations behind CMS's preliminary CY2027 CLFS rates (published 2026-09-21). Codes reported by fewer than 10 TINs are withheld by CMS by statute. Landed 2026-09-22 as its own table; the 2018 collection is medicare_silver.fact_clfs_private_payer_rate.","identity_key":"hcpcs_cd","row_count":6548302,"last_updated":"2026-09-22","freshness_sla":"Per PAMA data-collection cycle (every 3 years); this is the 2026 cycle.","recollection":{"cadence":"derived","watermark_field":"collection_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["collection_year is the PAMA data-collection cycle year (2026); the rates it sets are CY2027."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_clfs_private_payer_rate_2026collection","provenance_chain_ref":"medicare/bronze/cms_clfs_pama_private_payer_rates/cy2027_preliminary_20260921/manifest.json (sha256 per artifact; every row carries source_url + sha256_content_hash + asserted_at).","context_doc_path":"docs/context_library/medicare/clfs_pama_2027_preliminary.md","known_gaps":["RAW per-observation rows; aggregate (weighted median) per hcpcs_cd for a benchmark, never read one row as the rate.","volume_text is text (may be ranges); private_payer_rate is the reported rate amount.","Loaded by a one-off CTAS from the CMS CSV on 2026-09-22, not by the PAMA runner; not merged into fact_clfs_private_payer_rate (which holds the 2018 collection with row_seq).","ONE ROW SHORT (measured 2026-09-23 against the CMS CSV, 6,548,303 rows) - the CTAS dropped the file's first data row, 0001U at $1,872.58 volume 1 (Athena 9f4b2530). Every other code's row count matches. Identical rows are real separate observations (3,549,528 rows in 766,842 identical groups, same as the file).","SUPERSEDED 2026-09-23 - use medicare_silver.fact_clfs_private_payer_rate WHERE collection_year = 2026, which holds all 6,548,303 rows keyed by row_seq (Athena decad0cf). This table stays readable until its retirement is decided."],"notes":"Iceberg, one collection_year (2026). Source bytes s3://vlada-platform-raw/medicare/bronze/cms_clfs_pama_private_payer_rates/cy2027_preliminary_20260921/.","superseded_by":"medicare_silver.fact_clfs_private_payer_rate WHERE collection_year = 2026 (loaded 2026-09-23 through the PAMA runner: all 6,548,303 rows keyed by row_seq, reconciled per code to the CMS CSV; this one-off CTAS table is one row short). Retired from the register 2026-09-23 on Ben's decision; the table stays in Glue until dropped.","tools":[],"dataset_id":"cms_clfs_pama_private_payer_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_clfs_preliminary_rate","source_fqn":"medicare_silver.fact_clfs_preliminary_rate","title":"Medicare CLFS preliminary CY2027 rates (PAMA weighted medians, raw vs trimmed, capped)","domain":"medicare","stage":"silver","status":"live","grain":"One row per HCPCS code in CMS's preliminary CY2027 CLFS rate calculation file (rate_year, hcpcs_code).","description":"CMS's preliminary CY2027 Clinical Laboratory Fee Schedule per code: the 2026 CLFS rate, the raw and trimmed private-payor weighted medians, the percent change, the reporting-TIN count (withheld under 10), and the CY2027 rate after the 15% payment-reduction cap. Published 2026-09-21; comment window 30 days; final rates post November 2026 and supersede this edition.","identity_key":"hcpcs_code","row_count":1924,"last_updated":"2026-09-22","freshness_sla":"Annual; preliminary in late September, final in November (stage column says which).","recollection":{"cadence":"annual","watermark_field":"rate_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["rate_year is the year the rates apply (2027); collection_year is the PAMA cycle (2026); stage distinguishes preliminary from final."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_clfs_preliminary_rate","provenance_chain_ref":"medicare/bronze/cms_clfs_pama_private_payer_rates/cy2027_preliminary_20260921/manifest.json (sha256 per artifact; every row carries source_url + sha256_content_hash + asserted_at).","context_doc_path":"docs/context_library/medicare/clfs_pama_2027_preliminary.md","known_gaps":["PRELIMINARY (stage='preliminary'); the final CY2027 rates replace this edition in November 2026.","414 of 1,924 codes have no 2026 rate or no 2027 rate (new, crosswalked, or unpriced); rate_2027_preliminary is null there, never zero.","reporting_tins_text is text; a non-numeric value means CMS withheld the count (fewer than 10 TINs, 787 codes).","The 23 Pap smear codes CMS marks with an asterisk (88142-88175, G0123, G0143-G0148, P3000, Q0111, Q0115) are ABSENT - CMS's file lists 1,947 codes, this table 1,924. Their rates are set under section 1833(h)(7), not by PAMA, so the file carries no 2027 rate for them; absence here does not mean the code is unpriced (measured 2026-09-23)."],"notes":"Iceberg, one edition (rate_year 2027, stage preliminary). Loaded 2026-09-22 by CTAS from the CMS HCPCS_Prelim_Wgt_Meds_Simple tab.","superseded_by":null,"tools":[],"dataset_id":"cms_clfs_pama_private_payer_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_market_saturation","source_fqn":"medicare_silver.fact_market_saturation","title":"CMS Market Saturation & Utilization (provider competition by county × service)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (reference_period, type_of_service, aggregation_level, state_fips, county_fips) — providers/users/payment.","description":"The CMS Market Saturation & Utilization file — per rolling reference period, service type, and county: number of FFS beneficiaries, number of providers, number of users, average users-per-provider, average providers-per-county, dual-eligible user counts/percentages, and total payment. The provider COMPETITION / market-concentration signal (high providers-per-county = saturated; used to flag over/under-supply). Curated subset of the dashboard file (drops *_dual_color / *_description / *_change rendering columns).","identity_key":"county_fips","row_count":2455330,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_market_saturation","notes":"Iceberg medicare_silver.fact_market_saturation, partition by reference_period, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_market_saturation_utilization","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["census:county_fips"],"entity_key_columns":{"census:county_fips":["county_fips"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_provider_of_services","source_fqn":"medicare_silver.fact_provider_of_services","title":"CMS Provider of Services (POS) File — facility characteristics + bed counts","domain":"provider_identity","stage":"silver","status":"live","grain":"One row per (data_year, facility CCN) — category, control type, location, beds, status.","description":"The CMS Provider of Services File (QIES extract) — facility characteristics for every Medicare-certified facility: provider category + subtype, ownership control type, address/CBSA/FIPS location, certification + original participation + termination dates, and BED COUNTS (total, certified, Medicare SNF, hospice, rehab, psych/rehab unit) + affiliated-facility counts (HHA/SNF/hospice). The facility-structure layer (beds, ownership type, certification status) joinable by CCN. Curated ~30-col subset of the 473-col POS file, 2011-2026, partition by data_year.","identity_key":"prvdr_num","row_count":44429,"last_updated":null,"freshness_sla":"Annual (CMS POS File).","recollection":{"cadence":"annual","watermark_field":"data_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'data_year' is the source's documented vintage column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_provider_of_services","provenance_chain_ref":"medicare_silver M-2 substrate (sha256_content_hash + source_url + asserted_at on every row).","context_doc_path":"docs/context_library/medicare/provider_of_services.md","known_gaps":["~44k facilities/year (QIES extract; not the separate Clinical-Labs POS file); 37 years (2011-2026), partition by data_year.","CURATED ~30-col subset of 473 (identity/location/status/control-type + bed counts + key affiliated counts; full POS has many more service-availability switches at the source URL).","control_type_cd + provider_category_cd are CMS code values (decode via the POS data dictionary)."],"notes":"Iceberg medicare_silver.fact_provider_of_services, partition by data_year, replace (idempotent by SHA-256).","superseded_by":null,"tools":[],"dataset_id":"cms_provider_of_services_file","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["prvdr_num"],"backing_store":"glue"},{"source_id":"cms_post_acute_utilization","source_fqn":"medicare_silver.fact_post_acute_utilization","title":"Medicare Post-Acute Care Utilization — by Provider (SNF/HHA/Hospice/IRF/LTCH)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (setting, year, provider, summary/service category) — episodes/days/charge/allowed/payment.","description":"The CMS Medicare Post-Acute Care Utilization PUFs, unified across the five post-acute settings (SNF, HHA, hospice, IRF, LTCH) into one fact partitioned by (setting, year). Per provider: distinct beneficiaries, episodes/stays, service days, total charge, total allowed, total Medicare payment + standardized payment, plus beneficiary mix (dual %, rural %, avg age, avg risk score). The provider-level post-acute utilization + cost layer — completes provider-level coverage alongside physician / inpatient / outpatient / DME by provider.","identity_key":"prvdr_id","row_count":14214,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_post_acute_utilization","notes":"Iceberg medicare_silver.fact_post_acute_utilization, partitioned by (setting, year) so each setting-year CSV is its own replace-safe partition.","superseded_by":null,"tools":[],"dataset_id":"cms_puf_post_acute_care","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["prvdr_id"],"backing_store":"glue"},{"source_id":"cms_aco_participant","source_fqn":"medicare_silver.fact_aco_participant","title":"CMS Accountable Care Organization (ACO) Participants — Shared Savings Program","domain":"medicare","stage":"silver","status":"live","grain":"One source row per (performance_year, ACO, participant legal business name); participant TIN is not retained, so this nominal key is not unique.","description":"The CMS Medicare Shared Savings Program ACO Participants list per ACO and participating organization: ACO id/name, service area, agreement period, track, revenue class, assignment type, and address. Production holds 2016-2026. Official 2014-2015 files are ID-less and owner-deferred; 2013 was not recovered.","identity_key":"aco_id","row_count":183710,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_aco_participant","notes":"Iceberg medicare_silver.fact_aco_participant, partition by performance_year, replace.","superseded_by":null,"tools":[],"dataset_id":"cms_mssp_aco_participants","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["aco_id"],"backing_store":"glue"},{"source_id":"cms_mdpp_supplier","source_fqn":"medicare_silver.dim_mdpp_supplier","title":"Medicare Diabetes Prevention Program (MDPP) Suppliers","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per MDPP supplier location (by row_seq within state).","description":"The roster of Medicare Diabetes Prevention Program (MDPP) suppliers — CMMI-model organizations enrolled to furnish the DPP benefit, with organization/location name, address, NPI, and category. The DPP innovation- model participation list (~1,037 suppliers).","identity_key":"npi","row_count":1037,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_mdpp_supplier","notes":"Iceberg medicare_silver.dim_mdpp_supplier, partition by state, replace.","superseded_by":null,"tools":[],"dataset_id":"cms_mdpp_suppliers","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_qpp_experience","source_fqn":"medicare_silver.fact_qpp_experience","title":"CMS Quality Payment Program (QPP/MIPS) Experience — clinician scores","domain":"medicare","stage":"silver","status":"live","grain":"One row per (data_year, clinician record) — MIPS final score + category scores + payment adjustment.","description":"The CMS Quality Payment Program Experience file — per clinician (provider key / NPI) the MIPS final score, payment adjustment percentage, and the four category scores (quality, promoting interoperability, improvement activities, cost), plus practice size, specialty, participation option, and small/rural/ HPSA status. The clinician value-based-performance layer. ~500k-1.05M clinicians/year, 2017-2024. Curated ~21-col subset of the 212-col file.","identity_key":"npi","row_count":503917,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_qpp_experience","notes":"Iceberg medicare_silver.fact_qpp_experience, partition by data_year, replace.","superseded_by":null,"tools":[],"dataset_id":"cms_qpp_experience","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_medicaid_managed_care","source_fqn":"medicare_silver.fact_medicaid_managed_care","title":"CMS Medicaid Managed Care (utilization by MCO × county)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (calendar_year, state, county, MCO, service category).","description":"CMS Medicaid Managed Care utilization — per state, county, managed-care organization, and service category: active patients, eligible MCO patients, providers, % of eligible receiving services, services per active patient. The Medicaid MCO access/utilization lens (note: Medicaid managed-care utilization, not medical rates — those remain unavailable).","identity_key":"mco_name","row_count":19559,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_medicaid_managed_care","notes":"Iceberg medicare_silver.fact_medicaid_managed_care, partition by calendar_year, replace.","superseded_by":null,"tools":["get_medicaid_mco_enrollment"],"dataset_id":"cms_medicaid_managed_care_utilization_by_mco","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["mco_name"],"backing_store":"glue"},{"source_id":"cms_idr_determination","source_fqn":"medicare_silver.fact_idr_determination","title":"CMS Federal IDR (No Surprises Act) Determinations — OON arbitration fair price","domain":"commercial","stage":"silver","status":"live","grain":"One row per OON dispute line item (year, quarter, row_seq) — outcome + offers as % of QPA.","description":"The CMS Federal Independent Dispute Resolution (No Surprises Act) OON Emergency and Non-Emergency line-item PUF. It reports who prevailed and provider, plan, and prevailing offers as a percentage of QPA by service code, place of service, location, specialty, practice size, and plan type. Air Ambulance and QPA/Offers are separate accepted grains.","identity_key":"provider_npi","row_count":8233903,"last_updated":"2026-07-22","freshness_sla":"Quarterly (CMS No Surprises reports page) + bi-monthly interim.","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' (+ quarter) is the source's documented vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_determination","commercial_terms":"Public CMS data; freely redistributable (per PUF user agreement).","provenance_chain_ref":"medicare_silver M-2 substrate (sha256 + source_url + asserted_at on every row).","known_gaps":["HEAVY: 2025Q3/Q4 ZIPs exceed 600MB/1.2GB; full backfill runs only on the compute fleet (job_type build_idr_determination).","Excel percentage-formatted numeric cells are stored as fractions; parser v2 converts raw 1.64 with a percent format to 164 percentage points. Never apply another x100.","Offer percentages can legitimately exceed 100%; explicit analytics flags quarantine implausible values without deleting raw/source-status evidence."],"notes":"Iceberg medicare_silver.fact_idr_determination, partition by (year, quarter); bulk-load (append_buffered per 200k chunk -> flush_buffered_replace_partitions per quarter, atomic). row_seq makes each line-item row unique.","superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["provider_npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_psps","source_fqn":"medicare_silver.fact_psps","title":"CMS Physician/Supplier Procedure Summary (PSPS) — granular Part B allowed","domain":"medicare","stage":"silver","status":"live","grain":"One row per (data_year, HCPCS × modifiers × specialty × carrier-locality × type-of-service × place-of-service).","description":"The CMS Physician/Supplier Procedure Summary — Part B submitted/allowed/ denied service counts + charges + NCH payment at HCPCS × modifier × provider specialty × carrier-locality × type-of-service × place-of-service. The most granular public Part B allowed-amount benchmark (finer than the by-geography PUFs). ~14.4M rows/year, 2010-2024, partition by data_year.","identity_key":"hcpcs_cd","row_count":14377293,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_psps","notes":"Iceberg medicare_silver.fact_psps, partition by data_year; bulk-load (append_buffered 300k -> flush per year).","superseded_by":null,"tools":[],"dataset_id":"cms_psps","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_drug_discarded_units","source_fqn":"drug_silver.fact_drug_discarded_units","title":"CMS Medicare Part B Discarded Drug Units (JW/JZ waste)","domain":"drug","stage":"silver","status":"live","grain":"One row per (data_year, HCPCS) — administered vs discarded allowed amount + % units.","description":"CMS Medicare Part B Discarded Drug Units — per drug HCPCS the total Medicare allowed amount split into administered vs discarded, plus % administered/ discarded units. The drug-WASTE / IRA single-dose-vial refund overpayment vector — join to ASP to value waste and surface JW-refund recovery.","identity_key":"hcpcs_cd","row_count":824,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_discarded_units","notes":"Iceberg drug_silver.fact_drug_discarded_units, partition by data_year, replace.","superseded_by":null,"tools":[],"dataset_id":"cms_part_b_discarded_drug_units","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_cd"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_tc_puf_issuer_claims","source_fqn":"medicare_silver.fact_tc_puf_issuer_claims","title":"CMS Transparency in QHP Coverage PUF — partial Individual QHP serving derivative","domain":"commercial","stage":"silver","status":"live","grain":"Partial table: one Individual-QHP row per (publication-year label stored as plan_year, 14-character Plan_ID); issuer-level measures repeat across plan rows.","description":"A 25,666-row partial derivative of the CMS CCIIO Transparency in QHP Coverage PUF: only the Individual QHP tabs from publication years 2022-2026. Those publications contain measurement data from 2020-2024 respectively. Do not treat plan_year as the measure year, aggregate repeated issuer measures across plans, or publish payer rankings until denominator and suppression semantics pass review.","identity_key":"plan_year,plan_id","row_count":25666,"last_updated":null,"freshness_sla":"Annual publication; measures lag the publication label by two years.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' stores the PUF publication label, not the claims/enrollment measurement year; data_year = plan_year - 2."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_tc_puf_issuer_claims","commercial_terms":"Public CMS/CCIIO data; freely redistributable.","provenance_chain_ref":"medicare_silver M-2 substrate.","context_doc_path":"docs/context_library/commercial/tc_puf_issuer_claims.md","known_gaps":["The official family has 40,222 data rows across PY2017-2026; 14,556 are outside this table (all PY2017-2021 rows plus PY2022-2026 Individual SADP/SHOP rows).","PY2017-2019 are issuer-level without Plan_ID; PY2020 is a mixed plan-level sheet without explicit market/dental scope. They cannot be appended to this table honestly.","PY2023 Individual SADP contains three non-identical duplicate plan keys; the lossless source key requires sheet and source-row identity.","Suppressed cells (* / ** / *** / N/A) were coerced to null in this derivative. They are distinct source states, not zero.","Issuer measures repeat across plan rows; denominator-safe semantic views are acceptance-gated."],"notes":"Iceberg table remains live and unchanged. The canonical manifest-driven runner is now no-write certification only; production execution is disabled pending a lossless history writer and semantic review.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_transparency_in_coverage_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:plan_id"],"entity_key_columns":{"cms:plan_id":["plan_id"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hpsa","source_fqn":"medicare_silver.fact_hpsa","title":"HRSA Health Professional Shortage Areas (HPSA) — PC / Dental / Mental Health","domain":"provider_identity","stage":"silver","status":"live","grain":"One row per (observed_period, discipline, row_seq) — Wayback-vintage snapshots 2020-2026 plus the current HRSA extract","description":"The mastered HRSA HPSA cumulative daily extract across primary care, dental, and mental health: 1,040,138 rows across 22 (observed_period, discipline) vintage slices.","identity_key":"observed_period,discipline,row_seq","row_count":1040138,"last_updated":"2026-07-11","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hpsa","notes":"Iceberg medicare_silver.fact_hpsa, partition and replace scoped by (observed_period, discipline); identifiers are (observed_period, discipline, row_seq); one SHA per slice; registry skips distinguish IDEMPOTENT_SKIP from DUPLICATE_CONTENT_SKIP.","superseded_by":null,"tools":[],"dataset_id":"hrsa_hpsa_designations","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period"],"unmapped_key_tokens":["discipline","row_seq"],"backing_store":"glue"},{"source_id":"fda_gudid_device","source_fqn":"drug_silver.dim_device_udi","title":"NLM AccessGUDID — Device Identity (FDA Global UDI Database)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per device (release_month, PrimaryDI) — brand/model/company + flags.","description":"The FDA Global UDI Database (via NLM AccessGUDID) — every marketed medical device by its Device Identifier (PrimaryDI): brand, version/model, catalog number, company (DUNS), description, commercial-distribution status, and flags (single-use, sterile, MRI safety, Rx/OTC, kit, combination product). Resolves the UDI/DI on an itemized bill or implant log to canonical device identity — de-anonymizes high-cost implant/device line items driving chargemaster markups. ~5.1M devices, partition by release_month.","identity_key":"primary_di","row_count":5129241,"last_updated":"2026-07-12","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.dim_device_udi","notes":"Iceberg drug_silver.dim_device_udi, partition by release_month; bulk-load (append_buffered 300k -> flush).","superseded_by":null,"tools":[],"dataset_id":"nlm_accessgudid","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["primary_di"],"backing_store":"glue"},{"source_id":"cms_rate_puf","source_fqn":"medicare_silver.fact_rate_puf","title":"CMS CCIIO Rate PUF — ACA Marketplace QHP plan premium rates","domain":"commercial","stage":"silver","status":"live","grain":"One row per (business_year, issuer × plan × rating-area × age × tobacco) — individual + family premiums.","description":"The CMS CCIIO Rate PUF (data.healthcare.gov) — the actual filed monthly premium for every ACA Marketplace QHP by issuer × plan × rating area × age × tobacco status: individual rate, individual-tobacco rate, and family-tier rates (couple, +1/+2/+3 dependents). A commercial PRICE signal (plan premium geography by issuer/area/age) independent of TiC negotiated rates + hospital chargemaster — the premium side of the commercial market. ~2-3M rows/year, PY2014-2026, partition by business_year.","identity_key":"issuer_id","row_count":32902283,"last_updated":null,"freshness_sla":"Annual (plan year).","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the source's documented plan-year column."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_rate_puf","commercial_terms":"Public CMS/CCIIO data; freely redistributable.","provenance_chain_ref":"medicare_silver M-2 substrate.","known_gaps":["Premium rates (the price of coverage), NOT provider payment rates — complements TiC (what the plan pays providers) with what the member pays for the plan.","~2-3M rows/year; ALWAYS filter business_year. Age is a string bucket ('0-14','21','64 and over'); rating_area_id is the CCIIO geographic rating area.","13 years PY2014-2026; bulk-load (append_buffered 300k -> flush per year).","SUPERSEDED FOR READING (2026-10-13): read medicare_semantic.vw_rate_puf_current. This table came from data.healthcare.gov mirrors: PY2015 is truncated at 1,048,575 rows in 6 of 37 states (CMS: 4,676,092 rows), PY2017 holds 3,092,684 rows against CMS's 3,098,756 and differs in 14 states, and PY2018 has CMS's row count but 3,672 different rate values (NH, NJ) (Athena 68dc03cf, 5189dd09). get_exchange_plan_profile reads the view after #3588."],"notes":"Iceberg medicare_silver.fact_rate_puf, partition by business_year; bulk-load. row_seq keys each row.","superseded_by":"medicare_semantic.vw_rate_puf_current over medicare_silver.fact_rate_puf_history (cards cms_rate_puf_current and cms_rate_puf_history, #3568/#3576): every plan year read from the official CMS ZIPs, one revision per business_year. This table stays queryable as the rollback.","tools":[],"dataset_id":"cms_cciio_rate_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["issuer_id"],"backing_store":"glue"},{"source_id":"cms_hcahps_hospital","source_fqn":"medicare_silver.fact_hcahps","title":"CMS Care Compare HCAHPS — Hospital patient-experience survey","domain":"medicare","stage":"silver","status":"live","grain":"One row per (reporting_year, CCN × HCAHPS measure) — long-format measure row; writer key (reporting_year,row_seq).","description":"The HCAHPS hospital patient-experience survey (CMS Care Compare): one long-format row per hospital CCN and HCAHPS measure for each reporting_year, carrying patient-survey star rating, answer percent, linear-mean value, completed surveys, and response rate.","identity_key":"ccn","row_count":4208689,"last_updated":"2026-07-11","freshness_sla":"CMS Care Compare refresh; use reporting_year as the vintage selector.","recollection":{"cadence":"annual","watermark_field":"reporting_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field reporting_year is derived from the survey end_date.","Live readback Athena query 4efc78f6-e858-4eae-8706-2813c6f0344b proves reporting_year 2014-2025, 4,208,689 rows, one SHA per year, and zero source_url nulls."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hcahps","provenance_chain_ref":"medicare_silver M-2 substrate.","context_doc_path":"docs/context_library/medicare/hcahps.md","known_gaps":["hcahps_mdb_era_gate: 2008-2011 official Hospital Compare archives contain HCAHPS only inside monolithic MS Access Hospital.mdb; reviewed MDB extraction (mdbtools) plus schema mapping is required.","hcahps_wide_format_era_gate: 2012-2013 official Hospital Compare CSVs are wide-format with one row per hospital, per-question percent columns, and Provider Number; reviewed wide-to-long melt plus question-text-to-measure-ID crosswalk is required, and the fail-closed parser rejects them today.","Live coverage is reporting_year 2014-2025 with 4,208,689 rows; 2014 has a smaller measure set and row count as source reality, not a defect.","No direct repo consumers. Hold vintage and measure constant; cross-era comparisons must hold measure ID + answer description constant because no cross-era crosswalk exists.","Official archive URLs are case-sensitive: the 2015 path uses FlatFiles capitalization."],"notes":"Iceberg medicare_silver.fact_hcahps, partition by reporting_year with replace semantics. Join ccn to dim_facility / fact_hospital_quality_measure.","superseded_by":null,"tools":["get_hospital_quality"],"dataset_id":"cms_care_compare_hospitals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hospice_quality","source_fqn":"medicare_silver.fact_hospice_quality","title":"CMS Care Compare Hospice provider-quality measures","domain":"medicare","stage":"silver","status":"live","grain":"One row per (reporting_year, hospice CCN × measure code) — quality score.","description":"CMS Care Compare hospice provider-quality (long format): per hospice (CCN) × quality measure code/name → score (+ footnote). The post-acute (hospice) quality comparability dimension, alongside hospital quality / HCAHPS / SNF. ~459k rows, partition by reporting_year.","identity_key":"ccn","row_count":459084,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hospice_quality","notes":"Iceberg medicare_silver.fact_hospice_quality, partition by reporting_year, replace. Join ccn to dim_hospice.","superseded_by":null,"tools":[],"dataset_id":"cms_care_compare_hospice","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_medicaid_fee_schedule","source_fqn":"vlada_curated.fact_state_medicaid_rate","title":"State Medicaid Fee Schedule (rate per CPT/HCPCS)","domain":"state","stage":"silver","status":"live","grain":"One row per (state, procedure/HCPCS) — Medicaid allowed rate.","description":"Per-state Medicaid rate per code (the Medicaid floor). MD professional ingested (9,152). Tool ingest_state_medicaid.py; M-2 temporal.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"state_medicaid_fee_schedules","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"md_hscrc_unit_rate","source_fqn":"vlada_curated.fact_md_hscrc_unit_rate","title":"MD HSCRC All-Payer Hospital Unit Rates","domain":"state","stage":"silver","status":"live","grain":"One row per (rate_year, hospid, cost_center, effective_date, line_seq)","description":"MD all-payer approved unit rate per HSCRC hospital id and cost center across RY2013-RY2024 and RY2026 (22,588 rows). Effective-date changes and source-real split rate lines are preserved. Federal CCN/NPI joins require a bridge. Tool ingest_hscrc_rates.py.","identity_key":null,"row_count":22588,"last_updated":"2026-07-11","raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"notes":null,"superseded_by":null,"tools":[],"dataset_id":"md_hscrc_unit_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ma_chia_relative_price","source_fqn":"vlada_curated.fact_ma_chia_relative_price","title":"MA CHIA Relative Price (commercial price variation)","domain":"state","stage":"silver","status":"live","grain":"One row per (payer, hospital) — MA commercial relative price (1.0=statewide median).","description":"MA commercial price variation per payer x hospital (CY2023, 4,357; 1.0=statewide median). Tool ingest_chia_relative_price.py.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ma_chia_relative_price","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_home_health_quality","source_fqn":"medicare_silver.fact_home_health_quality","title":"CMS Care Compare Home Health Agencies — per-agency quality","domain":"medicare","stage":"silver","status":"live","grain":"One row per (reporting_year, home-health agency CCN) — star rating, measure rates, DTC/PPR/PPH, spending.","description":"CMS Care Compare Home Health Agencies (wide per-agency): identity + ownership + service-offering flags + patient-care star rating + key quality-measure rates + DTC/PPR/PPH risk-standardized rates + Medicare spending ratio. The home-health quality comparability dimension. ~12.4k agencies, curated ~30 of 96 columns.","identity_key":"ccn","row_count":12392,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_home_health_quality","notes":"Iceberg medicare_silver.fact_home_health_quality, partition by reporting_year, replace. Join ccn to dim_hha.","superseded_by":null,"tools":[],"dataset_id":"cms_care_compare_home_health","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_nursing_home_quality","source_fqn":"medicare_silver.fact_nursing_home_quality","title":"CMS Care Compare Nursing Home (Provider Information) — 5-star quality","domain":"medicare","stage":"silver","status":"live","grain":"One row per (reporting_year, nursing-home CCN) — 5-star ratings, beds, staffing, deficiencies.","description":"CMS Care Compare Nursing Home Provider Information (wide per-facility): the 5-star ratings (overall / health-inspection / QM / long+short-stay / staffing), certified beds, ownership + chain, staffing hours-per-resident-per-day + turnover, deficiency/fine/penalty counts + geo. The nursing-home quality comparability dimension. ~14.7k facilities, curated ~45 of 99 columns.","identity_key":"ccn","row_count":14695,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_nursing_home_quality","notes":"Iceberg medicare_silver.fact_nursing_home_quality, partition by reporting_year, replace. Join ccn to dim_snf.","superseded_by":null,"tools":[],"dataset_id":"cms_care_compare_nursing_homes","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"fda_faers_drug","source_fqn":"drug_silver.fact_faers_drug","title":"FDA FAERS — Adverse-Event Drug Involvement (DRUG file)","domain":"drug","stage":"silver","status":"live","grain":"One row per line of a quarter's FAERS DRUG file: physical key (report_quarter, row_seq), row_seq = the line's position in that quarter's file (accepted 2026-09-23). (report_quarter, primaryid, drug_seq) is NOT a key: the publisher repeats it (21,797 duplicate groups / 68,550 rows in 2025Q1). Quarters are noncumulative and case-versioned; count cases with the current-case rule in the context doc, never rows or distinct primaryid.","description":"FDA FAERS (Adverse Event Reporting System) DRUG file — per adverse-event report × drug: the drug's role (PS primary-suspect / SS secondary / C concomitant / I interacting), drug name, active ingredient, NDA number, route/dose, dechallenge/ rechallenge. The drug-safety surveillance signal — links adverse events to the drug substrate (join drugname/prod_ai/nda_num to dim_drug / dim_drug_application). ~1.6-2.2M rows/quarter; 2025Q1-2026Q2 loaded (six quarters).","identity_key":"report_quarter,row_seq","row_count":11131453,"last_updated":"2026-09-23","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_faers_drug","notes":"Iceberg drug_silver.fact_faers_drug, partition by report_quarter; bulk-load (append_buffered 300k -> flush_buffered_replace_partitions); a rerun of a loaded quarter skips on the ZIP SHA-256 recorded in medicare_source_registry_cache.","superseded_by":null,"tools":[],"dataset_id":"fda_faers","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["report_quarter","row_seq"],"backing_store":"glue"},{"source_id":"ct_medicaid_provider_rate","source_fqn":"vlada_curated.fact_ct_medicaid_provider_rate","title":"CT Medicaid Inpatient Hospital Base Rates","domain":"state","stage":"silver","status":"live","grain":"One row per (CT Medicaid provider/procedure) — Medicaid allowed rate.","description":"CT Medicaid (CMAP) inpatient per-hospital base rate keyed to CCN, EULA-free DRG Calculator. 48 hospitals. Tool ingest_ct_medicaid_inpatient.py.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ct_dss_medicaid_hospital_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ct_medicaid_drg_weight","source_fqn":"vlada_curated.fact_ct_medicaid_drg_weight","title":"CT Medicaid DRG Weights","domain":"state","stage":"silver","status":"live","grain":"One row per (DRG) — CT Medicaid inpatient DRG relative weight.","description":"CT Medicaid DRG weights/ALOS/outlier (1,342). payment=base_rate x weight. Tool ingest_ct_medicaid_inpatient.py.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ct_dss_medicaid_hospital_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_ambulance_fee_schedule","source_fqn":"medicare_silver.fact_ambulance_fee_schedule","title":"CMS Medicare Ambulance Fee Schedule (AFS) Public Use File","domain":"medicare","stage":"silver","status":"live","grain":"One row per (year, effective_period_start, effective_period_end, HCPCS × carrier × locality) — ambulance fee-schedule rates.","description":"The standalone CMS Medicare Ambulance Fee Schedule (AFS PUF) — per HCPCS (A0425-A0436 + mileage) × carrier × locality: RVU, GPCI, base rate, and urban/rural base + mileage rates. NOT inside PFS/OPPS/CLFS/DMEPOS/ASC; the reference benchmark for repricing ambulance claims (a top balance-billing / overpayment category). ~1.3k rows/year, CY2004-CY2026, partition by year; CY2004 is represented by two effective-period half-year vintages.","identity_key":"hcpcs","row_count":29160,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ambulance_fee_schedule","notes":"Iceberg medicare_silver.fact_ambulance_fee_schedule, partition by year, replace. Source = cms.gov AFS PUF annual/semiannual zip. Current proof: 29,160 rows, CY2004-CY2026, 24 source hashes, zero lineage-null rows, zero duplicate effective-period keys.","superseded_by":null,"tools":[],"dataset_id":"cms_ambulance_fee_schedule","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"md_hscrc_monthly_rev_vol","source_fqn":"vlada_curated.fact_md_hscrc_monthly_rev_vol","title":"MD HSCRC Monthly Revenue & Volumes","domain":"state","stage":"silver","status":"live","grain":"One row per (hospital, month) — MD HSCRC monthly revenue/volume.","description":"MD hospital revenue+volume per hospital x month x rate-center (the operationalized GBR). 15,432 rows, 61 hospitals. Tool ingest_hscrc_monthly.py.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"md_hscrc_monthly_revenue_volume","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ma_chia_revenue_cost_ratio","source_fqn":"vlada_curated.fact_ma_chia_revenue_cost_ratio","title":"MA CHIA Revenue-to-Cost Ratio by Payer","domain":"state","stage":"silver","status":"live","grain":"One row per (hospital, year) — MA CHIA revenue-to-cost ratio.","description":"MA per-hospital revenue-to-cost ratio by payer (commercial 1.25x vs Medicaid 0.82x cost). 61 hospitals. Tool ingest_chia_profiles.py.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ma_chia_hospital_financial_performance","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hospice_pps_rate","source_fqn":"medicare_silver.fact_hospice_pps_rate","title":"CMS Hospice PPS Per-Diem Rates (Federal Register final rule)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (fiscal_year, quality_compliant, level_of_care) — hospice per-diem rate.","description":"CMS Hospice PPS per-diem payment rates, extracted from CMS transmittals and Federal Register final-rule tables: Routine Home Care, Continuous Home Care (+ hourly), Inpatient Respite Care, General Inpatient Care — full rates + reduced rates for hospices not meeting quality reporting. The hospice repricing benchmark for the 9k+ hospices we roster (dim_hospice); wage index applies by CBSA on top. Each load is VALIDATED against the rule's stated rate. FY2005-FY2026 are live and proven: FY2005-FY2013 standard pre-HQRP CMS transmittal years, FY2014-FY2015 legacy single-RHC years, FY2016's exact Oct-Dec single-RHC plus Jan-Sep two-tier transition, and FY2017-FY2026 modern two-tier-RHC years.","identity_key":"level_of_care","row_count":164,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hospice_pps_rate","notes":"Iceberg medicare_silver.fact_hospice_pps_rate, partition by fiscal_year, replace. Sourced via pipelines/medicare/ingest/hospice_pps_runner.py using CMS transmittal PDFs, structured FR XML, explicitly accepted PDF text, or SHA-locked verified image-table maps. Parser 1.0.3 adds the SHA-locked FY2016 transition adapter plus a pre-write natural-key/effective-period guard.","superseded_by":null,"tools":[],"dataset_id":"cms_hospice_pps_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["level_of_care"],"backing_store":"glue"},{"source_id":"ct_hospital_cost_to_charge","source_fqn":"vlada_curated.fact_ct_hospital_cost_to_charge","title":"CT OHS Hospital Cost-to-Charge Ratios","domain":"state","stage":"silver","status":"live","grain":"One row per (hospital, year) — CT hospital cost-to-charge ratio.","description":"CT per-hospital cost-to-charge ratio (RCC, FY2024), 27 hospitals/6 systems. JS-rendered /-/media/ link found via headless browse. Tool ingest_ct_ohs_ccr.py.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"context_doc_path":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ct_ohs_hospital_cost_to_charge","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_irf_pps_cmg_weight","source_fqn":"medicare_silver.fact_irf_pps_cmg_weight","title":"CMS IRF PPS CMG Relative Weights (rule data files)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (fiscal_year, effective_period_start, effective_period_end, CMG, comorbidity tier) — relative weight + ALOS + standard payment amount.","description":"CMS Inpatient Rehabilitation Facility PPS case-mix table — per Case-Mix Group (CMG) x comorbidity tier (1/2/3/none): the relative weight, average length of stay, and the official IRF standard payment conversion factor. Sourced from annual IRF PPS rule data files and FY2006 CMS-1290-F Table 4, anchor-VALIDATED against published weights. Reprices IRF claims for the 666 IRFs we roster (dim_irf): payment ~= std_payment_amount x relative_weight x wage index x adjustments. Source-truth coverage is FY2006-FY2026 after the 2026-07-05 effective-period replay, FY2014 recovery, and FY2006 Table 4 recovery.","identity_key":"cmg","row_count":8443,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_irf_pps_cmg_weight","notes":"Iceberg medicare_silver.fact_irf_pps_cmg_weight, partition by fiscal_year, replace. Source = CMS rule data-files zip (nested CMG_ALOS CSV) plus FY2006 CMS-1290-F Table 4 PDF extraction. Current proof: 8,443 rows, 21 fiscal-year vintages, 20 source hashes, zero duplicate effective-period keys, zero lineage-null rows.","superseded_by":null,"tools":[],"dataset_id":"cms_irf_pps_cmg_weights","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["cmg"],"backing_store":"glue"},{"source_id":"cms_hh_pdgm_weight","source_fqn":"medicare_silver.fact_hh_pdgm_weight","title":"CMS Home Health PDGM Case-Mix Weights","domain":"medicare","stage":"silver","status":"live","grain":"One row per (calendar_year, HIPPS) — recalibrated PDGM case-mix weight + LUPA threshold.","description":"CMS Home Health Patient-Driven Groupings Model (PDGM) case-mix table — per HIPPS code (432): clinical group + admission source/timing + comorbidity adjustment, the recalibrated case-mix WEIGHT, and the LUPA visit threshold. Sourced from the CMS Home Health PPS Case-Mix Weights zip (clean XLSX) and anchor-VALIDATED (HIPPS 1FC11 = 1.0804). Reprices HH 30-day periods for the 23k+ HHAs we roster (dim_hha): payment ~= 30-day base rate x recalibrated_weight x wage index. CY2026 live. Third full non-acute repricer.","identity_key":"hipps","row_count":432,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_hh_pdgm_weight","notes":"Iceberg medicare_silver.fact_hh_pdgm_weight, partition by calendar_year, replace. Source = CMS HH PPS Case-Mix Weights annual zip.","superseded_by":null,"tools":[],"dataset_id":"cms_home_health_pdgm_weights","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["hipps"],"backing_store":"glue"},{"source_id":"cms_fqhc_pps_rate","source_fqn":"medicare_silver.fact_fqhc_pps_rate","title":"CMS FQHC PPS Base Payment Rate","domain":"medicare","stage":"silver","status":"live","grain":"One row per calendar_year — the national FQHC PPS per-visit base payment rate.","description":"CMS Federally Qualified Health Center PPS national per-visit base payment rate, extracted from the annual CMS Pricer-update transmittal and anchor-VALIDATED (CY2026 = $207.72). The FQHC repricing base for the FQHCs we roster — adjusted per FQHC by the Geographic Adjustment Factor (derived from the PFS GPCIs we already hold in medicare_gpci_locality) + the new-patient/IPPE/AWV adjustment. CY2025 ($202.65) + CY2026 ($207.72) live. Fifth non-acute repricer; completes the cleanly-sourceable non-acute rate set.","identity_key":"calendar_year","row_count":2,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_fqhc_pps_rate","notes":"Iceberg medicare_silver.fact_fqhc_pps_rate, partition by calendar_year, replace. Source = CMS Pricer-update transmittal PDF (validated extraction).","superseded_by":null,"tools":[],"dataset_id":"cms_fqhc_pps_rate","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["calendar_year"],"backing_store":"glue"},{"source_id":"cms_snf_pdpm_rate","source_fqn":"medicare_silver.fact_snf_pdpm_rate","title":"CMS SNF PPS PDPM Case-Mix-Adjusted Rates (urban & rural)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (fiscal_year, urban_rural, PDPM grid row) — PT/OT/SLP/Nursing/NTA CMIs + component rates.","description":"CMS Skilled Nursing Facility PPS PDPM case-mix-adjusted federal rates by fiscal year and urban/rural setting. The complete PDPM program era FY2020-FY2026 is live: FY2020-FY2022 are SHA-locked Federal Register final-rule tables and FY2023-FY2026 are CMS 508 CSV ZIPs. Each year has the 25-row A-Y wide grid for PT, OT, SLP, Nursing, and NTA CMIs and adjusted component rates.","identity_key":"pdpm_group","row_count":350,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_snf_pdpm_rate","notes":"Iceberg medicare_silver.fact_snf_pdpm_rate, partition by fiscal_year, replace. FY2020-FY2022 source = SHA-locked GovInfo Federal Register PDFs; FY2023-FY2026 source = CMS urban/rural 508 CSV ZIPs.","superseded_by":null,"tools":[],"dataset_id":"cms_snf_pdpm_rates","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["pdpm_group"],"backing_store":"glue"},{"source_id":"cms_ltch_pps_drg_weight","source_fqn":"medicare_silver.fact_ltch_pps_drg_weight","title":"CMS LTCH PPS MS-LTC-DRG Relative Weights (Table 11)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (fiscal_year, MS-LTC-DRG) — relative weight + geometric LOS + short-stay-outlier threshold.","description":"CMS Long-Term Care Hospital PPS MS-LTC-DRG case-mix table (Table 11) — per MS-LTC-DRG: the relative weight, geometric average length of stay, and the short-stay-outlier threshold. The LTCH repricing case-mix table for the 655 LTCHs we roster (dim_ltch): payment = relative_weight x LTCH standard federal rate x wage index. Sourced from the CMS-1833-F MS-LTC-DRG File zip (clean XLSX) and anchor-VALIDATED (DRG 003 = 3.644). FY2026 live (772 DRGs). Seventh non-acute repricer — COMPLETES the non-acute PPS rate family (SNF/HH/IRF/LTCH/hospice/ ESRD-base/FQHC + ambulance).","identity_key":"ms_ltc_drg","row_count":772,"last_updated":null,"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ltch_pps_drg_weight","notes":"Iceberg medicare_silver.fact_ltch_pps_drg_weight, partition by fiscal_year, replace. Source = CMS MS-LTC-DRG File (Table 11) zip.","superseded_by":null,"tools":[],"dataset_id":"cms_ltch_pps_drg_weights","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["ms_ltc_drg"],"backing_store":"glue"},{"source_id":"nj_hospital_financials","source_fqn":"vlada_curated.fact_nj_hospital_financials","title":"NJ DOH Hospital Financial Transparency","domain":"state","stage":"silver","status":"live","grain":"One row per (hospital, fiscal year) — NJ DOH operating income / revenue / margin (CY2021-23, 73 hospitals).","description":"NJ per-hospital operating income/revenue/margin (CY2021-23, 73 hospitals). Found by the verification fleet. NJ's state financial leg (no rate-setting/APCD). Tool ingest_nj_financials.py.","identity_key":null,"row_count":null,"last_updated":null,"freshness_sla":null,"raw_queryable_via":null,"commercial_terms":null,"provenance_chain_ref":null,"known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"nj_doh_hospital_financials","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_insurer_mlr","source_fqn":"insurer_silver.fact_insurer_mlr","title":"Commercial Insurer MLR — financial facts (CMS MLR PUF)","domain":"commercial","stage":"silver","status":"live","grain":"One row per (business_year, mr_submission_template_id, market). Wide pivot of 19 MLR lines (premium earned, incurred claims, member months, QI, taxes, fees ...) per issuer submission x market. 27,254 rows across RY2017-2024 (Athena 51461b5b, 2026-10-13).","description":"The commercial insurer P&L: filed premium earned, incurred claims, and member-months per issuer submission x market (individual/small_group/large_group/...), from the CMS Medical Loss Ratio PUF. Join dim_insurer_mlr_identity on mr_submission_template_id for the NAIC crosswalk + brand. loss_ratio = incurred_claims/premium_earned. The insurer-economics side of the Payers/Investors wedge.","identity_key":"business_year,mr_submission_template_id,market","row_count":27254,"last_updated":"2026-10-13","freshness_sla":"Annual (CMS MLR PUF release).","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the MLR reporting year of the filing, one CMS PUF ZIP per year (2019-2024 held; 2011-2018 have irregular publisher URLs and are not loaded).","is_current is false on every physical history row by writer contract; currentness is answered by insurer_silver.vw_insurer_mlr_current (highest cms_vintage_sequence per key), never by WHERE is_current.","A re-ingest of a business_year is a supersession-replace of that year.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): insurer_silver.fact_insurer_mlr","known_gaps":["is_current is FALSE on every row by writer contract (history_only); never filter is_current = true. The read surface is insurer_silver.vw_insurer_mlr_current (identity joined, Grand Total rows dropped, derived loss ratio and retention).","Held RY2017-2024 (RY2017 3,998 and RY2018 3,641 rows added 2026-10-12, #3566). RY2011-2016 are recoverable at CMS but gated: their templates do not fit the certified columns (no Part 1 line 4.6 total QI in 2014-2016).","business_state = 'Grand Total' rows in dim_insurer_mlr_identity are publisher rollups; a join that keeps them double counts."],"notes":"Registered 2026-10-13 under register w4 cms_insurer_mlr_puf with a World (W4) by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13); until then the table sat in the provenance index as internal (NO_COVERAGE at the customer door). RY2024 cell reconciliation PASS, 1,736 cells, 0 mismatches (reconcile_mlr_cells.py).","superseded_by":null,"tools":[],"dataset_id":"cms_insurer_mlr_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year"],"unmapped_key_tokens":["market","mr_submission_template_id"],"backing_store":"glue"},{"source_id":"cms_insurer_mlr_identity","source_fqn":"insurer_silver.dim_insurer_mlr_identity","title":"Commercial Insurer MLR — issuer identity / NAIC crosswalk (CMS MLR PUF)","domain":"commercial","stage":"silver","status":"live","grain":"One row per (business_year, mr_submission_template_id). Issuer identity + the free NAIC crosswalk. 20,336 rows across RY2017-2024 (Athena 51461b5b, 2026-10-13).","description":"The free entity crosswalk the CMS MLR PUF carries: hios_issuer_id, naic_group_code, naic_company_code, federal_ein, company_name, group_affiliation, dba_marketing_name per submission. Resolves an MLR financial filing to a payer BRAND + NAIC — the join key connecting insurer financials to negotiated rates (dim_payer).","identity_key":"business_year,mr_submission_template_id","row_count":20336,"last_updated":"2026-10-13","freshness_sla":"Annual (CMS MLR PUF release).","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the MLR reporting year of the submission the identity row was filed with; identity can change year to year (rebrands, group moves), so join the facts on (business_year, mr_submission_template_id).","business_state = 'Grand Total' is a publisher rollup row that double-counts if kept; vw_insurer_mlr_current excludes it.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): insurer_silver.dim_insurer_mlr_identity","known_gaps":["is_current is FALSE on every row by writer contract (history_only); never filter is_current = true.","Held RY2017-2024 (RY2017 2,938 and RY2018 2,798 rows added 2026-10-12, #3566); RY2011-2016 gated (template change)."],"notes":"Registered 2026-10-13 under register w4 cms_insurer_mlr_puf with a World (W4) by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13); until then internal only.","superseded_by":null,"tools":[],"dataset_id":"cms_insurer_mlr_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year"],"unmapped_key_tokens":["mr_submission_template_id"],"backing_store":"glue"},{"source_id":"cms_transparency_in_coverage_puf","source_fqn":"medicare_silver.fact_transparency_in_coverage_puf_history","title":"CMS CCIIO Transparency in Coverage PUF — QHP claims transparency (multi-sheet XLSX)","domain":"commercial","stage":"silver","status":"live","grain":"One publisher row per (business_year, market_segment, sheet source_row_number). 3 market segments (Ind QHP / Ind SADP / SHOP), lossless multi-sheet XLSX stored as ordered_header_json + raw_values_json. 40,222 rows across PY2017-2026.","description":"Per issuer x plan claims transparency (received / denied / resubmitted, in- and out-of-network) from the CMS Transparency in Coverage PUF, across all 3 market-segment sheets (Ind QHP / Ind SADP / SHOP) plus the legacy 2017-2020 combined sheet. Lossless: raw cells preserved in ordered_header_json + raw_values_json with a market_segment dimension. Payer-behavior signal.","identity_key":"business_year,market_segment,source_row_number","row_count":40222,"last_updated":"2026-07-17","freshness_sla":"Annual plan-year publication.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the publication plan-year label of the annual workbook; the claims and enrollment it reports were measured two years earlier (data_year = business_year - 2, verified 2026-09-04: PY2026 reports PY2024 data).","A new plan-year workbook is appended as a new immutable artifact (source_zip_sha256); changed bytes at the same URL coexist as another artifact, never an overwrite.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_transparency_in_coverage_puf_history","commercial_terms":"Public CMS/CCIIO data.","provenance_chain_ref":null,"context_doc_path":"docs/context_library/commercial/transparency_in_coverage_puf.md","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cciio_transparency_in_coverage_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["market_segment"],"backing_store":"glue"},{"source_id":"cms_quality_puf","source_fqn":"medicare_silver.fact_quality_puf_history","title":"CMS CCIIO Quality PUF — Marketplace QHP quality star ratings","domain":"commercial","stage":"silver","status":"live","grain":"One publisher row per (business_year, source_row_number); lossless CSV/XLSX stored as ordered_header_json + raw_values_json. 35,752 rows PY2017-2026, one CMS artifact per business_year (Athena 99901202, 2026-10-13).","description":"The CMS Marketplace Quality PUF — QHP quality star ratings assigned to plans on HealthCare.gov, per issuer x plan. Lossless hybrid CSV/XLSX. The quality dimension of the exchange plan graph.","identity_key":"business_year,source_row_number","row_count":35752,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year publication (CMS MQI downloads).","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the publication plan year of the file; the ratings it carries were measured earlier and the measurement period is not on the row.","Holdings are PY2023, PY2024 and PY2026 only; PY2025 and PY2017-2022 are holding gaps, not publisher gaps. The publisher does not state a cadence on the CMS downloads page (verified 2026-09-04); annual is the observed pattern.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_quality_puf_history","commercial_terms":"Public CMS/CCIIO data.","provenance_chain_ref":null,"known_gaps":["Held PY2017-2026 since 2026-10-12 (#3559): 830, 553, 768, 3,511, 3,885, 5,407, 6,378, 5,395, 4,723, 4,302 rows; one artifact per business_year. is_current is FALSE on every row (history_only); read by business_year, never filter is_current.","Current read surface since 2026-10-13: medicare_semantic.vw_quality_puf_current (card cms_quality_puf_current, #3583) keeps one CMS artifact per business_year, so a later repost never double-counts; it is history_only at the door like this table (is_current false on every row, no filter injected)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cciio_quality_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_exchange_plan_profile","source_fqn":"medicare_silver.fact_exchange_plan_profile","title":"Exchange Plan Profile — composed ACA marketplace plan brain","domain":"commercial","stage":"silver","status":"live","grain":"One row per (business_year, plan_id). 60,591 plan-years PY2014-2026. Materialized composition of six verified exchange PUF sources at plan grain (zero fanout).","description":"The composed \"plan brain\" for the ACA marketplace: one row per plan-year carrying its full vector — attributes (metal/type/on-off-exchange/issuer/TIN) from Plan Attributes, premium benchmarks (age 21/40/60 x rating area) from Rate, network name from Network, county footprint from Service Area, covered-benefit counts + headline cost-shares (PCP/specialist/ER/urgent/generic/inpatient) from Benefits & Cost Sharing, CMS star ratings from Marketplace Quality, and the issuer's individual-market financials (premium earned + MLR ratio) from the CMS MLR PUF. Joins measured/verified (Plan Attributes->Rate 100%; per-plan end-to-end proven); materialized so plan lookups serve fast (no parse-in-view cliff).","identity_key":"business_year,plan_id","row_count":60591,"last_updated":"2026-07-17","freshness_sla":"Rebuilt when any constituent exchange PUF refreshes (annual plan-year cadence).","recollection":{"cadence":"derived","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the plan year a row describes, not the build date: the table is a materialized CTAS built 2026-07-17 over the PUF revisions current then, with no is_current column.","Rebuilt only when a constituent PUF (Plan Attributes, Rate, Network, Service Area, Benefits & Cost Sharing, Marketplace Quality) or the CMS MLR PUF refreshes; freshness is bounded by those inputs.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs, and a fresh-vs-stale verdict needs a live watermark read this catalog never performs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_exchange_plan_profile","provenance_chain_ref":null,"known_gaps":["SUPERSEDED FOR READING (2026-10-13): get_exchange_plan_profile reads medicare_silver.fact_exchange_plan_profile_v2 after #3588 (card cms_exchange_plan_profile_v2). This table's PY2015 age-40 premium is null for 5,537 of 6,789 plans (built from the truncated data.healthcare.gov Rate mirror; Athena 8423a3f8), its PY2017 (329 plans) and PY2018 (16 plans) rate columns follow the mirror, not CMS, and PY2026 predates CMS's 2026-08-10 revision. Rollback only."],"notes":null,"superseded_by":"medicare_silver.fact_exchange_plan_profile_v2 (card cms_exchange_plan_profile_v2, built 2026-10-13 by tools/data_tracker/build_exchange_plan_profile.py, #3579): the same 35 columns and 60,591 rows, with the Rate input taken from the CMS ZIP history (vw_rate_puf_current). This table stays as the rollback.","tools":[],"dataset_id":"vlada_w4_exchange_plan_profile","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:plan_id"],"entity_key_columns":{"cms:plan_id":["plan_id"]},"technical_keys":["business_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_idr_air_ambulance","source_fqn":"medicare_silver.fact_idr_air_ambulance_determination","title":"CMS Federal IDR Air Ambulance determinations","domain":"commercial","stage":"silver","status":"live","grain":"One row per air-ambulance dispute line item (year, quarter, row_seq).","description":"The official Air Ambulance tab of each Federal IDR PUF, preserved as its own line-item grain with air vehicle, service, party, offer, QPA, raw-value/status, quality, and M-2 lineage fields.","identity_key":"dli_number","row_count":104383,"last_updated":"2026-07-22","freshness_sla":"Quarterly (CMS No Surprises reports page).","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' is paired with quarter for the publisher's quarterly vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_air_ambulance_determination","commercial_terms":"Public CMS data; freely redistributable per the PUF user agreement.","provenance_chain_ref":"Content-addressed CMS Bronze object plus M-2 row lineage.","known_gaps":["Raw publisher percentage values above 100,000 percentage points are retained but explicitly flagged and excluded from analytics eligibility."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["dli_number"],"backing_store":"glue"},{"source_id":"cms_idr_qpa_offers","source_fqn":"medicare_silver.fact_idr_qpa_offer","title":"CMS Federal IDR QPA and offers","domain":"commercial","stage":"silver","status":"live","grain":"One row per published QPA/offer observation (year, quarter, row_seq); early workbooks do not expose dispute/DLI identifiers on this tab.","description":"The official QPA and Offers tab, separated from determination line items because its publisher grain and historical identifiers differ. Carries service, geography/POS, QPA, provider/plan/prevailing offers, selected/default indicators, raw-value/status, and M-2 lineage.","identity_key":"service_code","row_count":11346219,"last_updated":"2026-07-22","freshness_sla":"Quarterly (CMS No Surprises reports page).","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' is paired with quarter for the publisher's quarterly vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_qpa_offer","commercial_terms":"Public CMS data; freely redistributable per the PUF user agreement.","provenance_chain_ref":"Content-addressed CMS Bronze object plus M-2 row lineage.","known_gaps":["Do not manufacture joins to dispute IDs where CMS did not publish them; early QPA/Offers tabs are independently grained observations.","2025 Q3 and Q4 are loaded twice (CMS's ZIP carries an identical Archive/ copy of the QPA-and-offers CSV; Athena b3731d48). Filter source_member NOT LIKE '%/Archive/%' or counts and sums double; medians are unaffected. Loader fixed in #4157; the stored rows are replayed at the next fleet publish."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["service_code"],"backing_store":"glue"},{"source_id":"cms_idr_supplemental_summary","source_fqn":"medicare_silver.fact_idr_supplemental_summary","title":"CMS Federal IDR Supplemental summary and outcome tables","domain":"commercial","stage":"silver","status":"live","grain":"One row per quarterly published metric in Supplemental Tables 1-6 and 12.","description":"Quarterly Federal IDR aggregate initiations, eligibility challenges, closure reasons, program expenditures/fees/compensation, and determination outcomes, with emergency/non-emergency, air-ambulance, and total values kept distinct.","identity_key":"metric_name","row_count":409,"last_updated":"2026-07-22","freshness_sla":"Quarterly.","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' is paired with quarter for the publisher's quarterly vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_supplemental_summary","commercial_terms":"Public CMS data.","provenance_chain_ref":"Content-addressed CMS Bronze workbook plus M-2 row lineage.","known_gaps":["Tables begin 2023Q1; the 2022 status/interim PDFs are separate narrative publications, not this 14-table source family."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["metric_name"],"backing_store":"glue"},{"source_id":"cms_idr_supplemental_state","source_fqn":"medicare_silver.fact_idr_supplemental_state","title":"CMS Federal IDR Supplemental initiations by state","domain":"commercial","stage":"silver","status":"live","grain":"One row per (year, quarter, state or territory) from Supplemental Table 7.","description":"Federal IDR dispute initiations by service category and state/territory. The CMS plus-sign state-law/all-payer-model footnote is retained as an explicit indicator, not part of the state name.","identity_key":"state_or_territory","row_count":672,"last_updated":"2026-07-22","freshness_sla":"Quarterly.","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' is paired with quarter for the publisher's quarterly vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_supplemental_state","commercial_terms":"Public CMS data.","provenance_chain_ref":"Content-addressed CMS Bronze workbook plus M-2 row lineage.","known_gaps":["State counts can sum above Table 1 because a batched dispute can contain services furnished in multiple states."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["state_or_territory"],"backing_store":"glue"},{"source_id":"cms_idr_supplemental_party","source_fqn":"medicare_silver.fact_idr_supplemental_party","title":"CMS Federal IDR Supplemental top disputing parties","domain":"commercial","stage":"silver","status":"live","grain":"One row per quarterly top-10 party/rank/service-category/party-role in Supplemental Tables 8-11.","description":"Top initiating and non-initiating parties or representatives for emergency/non-emergency and air ambulance disputes, including dispute share and health-plan-type subtotals where published.","identity_key":"party_or_representative","row_count":480,"last_updated":"2026-07-22","freshness_sla":"Quarterly.","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' is paired with quarter for the publisher's quarterly vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_supplemental_party","commercial_terms":"Public CMS data.","provenance_chain_ref":"Content-addressed CMS Bronze workbook plus M-2 row lineage.","known_gaps":["CMS says email-domain aggregation may undercount or split parties; names are publisher groupings, not a canonical payer/provider identity bridge.","Two publisher subtotal inconsistencies are retained and flagged: 2023Q4 Table 9 Anthem (49,048 component sum vs 49,052 total) and 2024Q2 Table 9 BCBS Texas (28,229 vs 28,254)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["party_or_representative"],"backing_store":"glue"},{"source_id":"cms_idr_supplemental_qpa_band","source_fqn":"medicare_silver.fact_idr_supplemental_qpa_band","title":"CMS Federal IDR prevailing offers by QPA cost band","domain":"commercial","stage":"silver","status":"live","grain":"One row per (year, quarter, QPA range) from Supplemental Table 13.","description":"Median prevailing offer as percentage of QPA plus determination and item/service counts by QPA cost band.","identity_key":"qpa_range","row_count":72,"last_updated":"2026-07-22","freshness_sla":"Quarterly.","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' is paired with quarter for the publisher's quarterly vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_supplemental_qpa_band","commercial_terms":"Public CMS data.","provenance_chain_ref":"Content-addressed CMS Bronze workbook plus M-2 row lineage.","known_gaps":["Median offer percentages are already percentage points; do not rescale values such as 532 to 5.32."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["qpa_range"],"backing_store":"glue"},{"source_id":"cms_idr_supplemental_specialty","source_fqn":"medicare_silver.fact_idr_supplemental_specialty","title":"CMS Federal IDR prevailing offers by specialty","domain":"commercial","stage":"silver","status":"live","grain":"One row per (year, quarter, CPT range, specialty) from Supplemental Table 14.","description":"Median prevailing offer as percentage of QPA and determination/item counts by CMS-published specialty/CPT band.","identity_key":"specialty","row_count":321,"last_updated":"2026-07-22","freshness_sla":"Quarterly.","recollection":{"cadence":"quarterly","watermark_field":"year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'year' is paired with quarter for the publisher's quarterly vintage."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_supplemental_specialty","commercial_terms":"Public CMS data.","provenance_chain_ref":"Content-addressed CMS Bronze workbook plus M-2 row lineage.","known_gaps":["CPT ranges overlap in publisher categories; use the published specialty row as the grain and do not explode a range into codes without a dated code-set policy."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["specialty"],"backing_store":"glue"},{"source_id":"cms_hcris_hospital_utilization","source_fqn":"medicare_silver.hospital_cost_report_utilization","title":"CMS HCRIS Hospital utilization (Worksheet S-3 Part I)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (source fiscal-year archive, report record, exact S-3 worksheet line).","description":"Lossless hospital and hospital-complex beds, bed days available, Title V/Medicare/Medicaid/all-patient days, FTEs, and discharges from Form 2552-10 Worksheet S-3 Part I.","identity_key":"ccn","row_count":2462442,"last_updated":"2026-07-22","freshness_sla":"Annual CMS HCRIS refresh.","recollection":{"cadence":"annual","watermark_field":"source_fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'source_fiscal_year' identifies the CMS HOSP10 annual source archive."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_utilization","commercial_terms":"Public CMS data.","provenance_chain_ref":"HOSP10FY archive in content-addressed Bronze plus exact worksheet/line and M-2 lineage.","known_gaps":["Form 2552-10 begins FY2010. Pre-2010/overlap 2552-96 history is a separate schema-era acceptance gate.","Program columns are utilization, not payer revenue."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hcris_hospital_financial","source_fqn":"medicare_silver.hospital_cost_report_financial","title":"CMS HCRIS Hospital financial statements (Worksheets G-2/G-3)","domain":"medicare","stage":"silver","status":"live","grain":"One row per (source fiscal-year archive, report record, worksheet, exact worksheet line).","description":"Form 2552-10 G-2 patient revenue/operating expense and G-3 revenue/expense/income statement lines with exact source column amounts and formula-quality flags.","identity_key":"ccn","row_count":2486705,"last_updated":"2026-07-22","freshness_sla":"Annual CMS HCRIS refresh.","recollection":{"cadence":"annual","watermark_field":"source_fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'source_fiscal_year' identifies the CMS HOSP10 annual source archive."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_financial","commercial_terms":"Public CMS data.","provenance_chain_ref":"HOSP10FY archive in content-addressed Bronze plus exact worksheet/line and M-2 lineage.","known_gaps":["G-2 is revenue by facility/service category, not Medicare/Medicaid/Other payer revenue. Never infer a payer split from it."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hcris_hospital_profile","source_fqn":"medicare_silver.hospital_cost_report_profile","title":"CMS HCRIS CCN-level hospital operating profile","domain":"medicare","stage":"silver","status":"live","grain":"One row per CMS report record, with an explicit latest-record flag per exact (CCN, fiscal-year-end).","description":"A usable CCN report profile built only from documented S-3 line 14 and G-2/G-3 total cells. Includes beds, patient days, discharges, ALOS, ADC, occupancy, gross/net patient revenue, operating expense, and income fields.","identity_key":"ccn","row_count":90680,"last_updated":"2026-07-22","freshness_sla":"Annual CMS HCRIS refresh.","recollection":{"cadence":"annual","watermark_field":"source_fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'source_fiscal_year' identifies the CMS HOSP10 annual source archive."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_profile","commercial_terms":"Public CMS data.","provenance_chain_ref":"HOSP10FY archive in content-addressed Bronze plus exact source formulas and M-2 lineage.","known_gaps":["revenue_by_payer_available is always false because S-3/G do not directly publish the American Hospital Directory-style Medicare/Medicaid/Other revenue split.","Use the separate hospital_cost_report_payer_revenue table for the public gross-revenue formula; it is not AHA Annual Survey net payer revenue.","ALOS equals total patient days divided by total discharges; ADC equals total patient days divided by inclusive report-period days. Keep report-period length constant when comparing."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hcris_hospital_report","source_fqn":"medicare_silver.hospital_cost_report_report","title":"CMS HCRIS Hospital report ledger (RPT)","domain":"medicare","stage":"silver","status":"live","grain":"One physical RPT source row per (source fiscal-year archive, source row number), retaining all 18 CMS-published fields.","description":"Lossless Form 2552-10 report metadata and revision ledger, including CCN, NPI, report/fiscal dates, status, control type, provider type, CHOW and amended-report relationships, and the selected-profile flag.","identity_key":"rpt_rec_num","row_count":91827,"last_updated":"2026-07-23","freshness_sla":"Annual CMS HCRIS refresh.","recollection":{"cadence":"annual","watermark_field":"source_fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'source_fiscal_year' identifies the CMS HOSP10 annual source archive."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_report","commercial_terms":"Public CMS data.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_hcris_complete_cell_ledger_2026_07_22.json","known_gaps":["Form 2552-10 covers FY2010 forward; CMS-2552-96 is a separately gated schema era."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rpt_rec_num"],"backing_store":"glue"},{"source_id":"cms_hcris_hospital_numeric_cell","source_fqn":"medicare_silver.hospital_cost_report_numeric_cell","title":"CMS HCRIS Hospital complete numeric cell ledger (NMRC)","domain":"medicare","stage":"silver","status":"live","grain":"One physical NMRC source row per (source fiscal-year archive, source row number).","description":"Complete lossless Form 2552-10 numeric worksheet cells with exact report key, worksheet, line, column, raw value, nullable typed value, parse status, and M-2 lineage.","identity_key":"source_row_number","row_count":296823696,"last_updated":"2026-07-23","freshness_sla":"Annual CMS HCRIS refresh.","recollection":{"cadence":"annual","watermark_field":"source_fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'source_fiscal_year' identifies the CMS HOSP10 annual source archive."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_numeric_cell","commercial_terms":"Public CMS data.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_hcris_complete_cell_ledger_2026_07_22.json","known_gaps":["Alphanumeric or punctuation-bearing coordinates are valid source values; numeric convenience fields are null when a code is not purely numeric.","Blank or invalid numeric source values remain retained and flagged; they are never coerced to zero."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hcris_hospital_alpha_cell","source_fqn":"medicare_silver.hospital_cost_report_alpha_cell","title":"CMS HCRIS Hospital complete alpha cell ledger (ALPHA)","domain":"medicare","stage":"silver","status":"live","grain":"One physical ALPHA source row per (source fiscal-year archive, source row number).","description":"Complete lossless Form 2552-10 text worksheet cells with exact report key, worksheet, line, column, raw text value, and M-2 lineage.","identity_key":"source_row_number","row_count":55578535,"last_updated":"2026-07-23","freshness_sla":"Annual CMS HCRIS refresh.","recollection":{"cadence":"annual","watermark_field":"source_fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'source_fiscal_year' identifies the CMS HOSP10 annual source archive."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_alpha_cell","commercial_terms":"Public CMS data.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_hcris_complete_cell_ledger_2026_07_22.json","known_gaps":["Raw text is retained exactly after CSV decoding; consumers must interpret worksheet-specific semantics rather than applying a global blank-value policy."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_hcris_hospital_payer_revenue","source_fqn":"medicare_silver.hospital_cost_report_payer_revenue","title":"CMS HCRIS Hospital gross patient revenue by payer","domain":"medicare","stage":"silver","status":"live","grain":"One row per CMS report record, with an explicit latest-record flag per exact (CCN, fiscal-year-end).","description":"Revision-bound public gross Medicare, Medicaid, Other, and total patient revenue derived from documented Form 2552-10 D-3, D Part V, S-10, and G-2 cells using a pinned American Hospital Directory formula version.","identity_key":"ccn","row_count":91827,"last_updated":"2026-07-23","freshness_sla":"Annual CMS HCRIS refresh.","recollection":{"cadence":"annual","watermark_field":"source_fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'source_fiscal_year' identifies the CMS HOSP10 annual source archive."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hospital_cost_report_payer_revenue","commercial_terms":"Public CMS data; the formula reference is publicly documented.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_hcris_complete_cell_ledger_2026_07_22.json","known_gaps":["These are gross reported patient-revenue amounts, not AHA Annual Survey net payer revenue and not commercial contract terms.","Other is a residual and is published only when total, Medicare, and Medicaid inputs are all present; missing source cells remain null, never zero.","Formula version ahd_operational_2552_10_2023_05_07_v1 must be retained when comparing or refreshing rows."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_hcris_hospital_2552_10","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_mcd_document","source_fqn":"medicare_silver.mcd_document","title":"CMS Medicare Coverage Database public documents","domain":"medicare","stage":"silver","status":"live","grain":"One row per (Coverage API snapshot, public endpoint, publisher row ordinal) document or public local-document index record.","description":"Public no-license CMS Medicare coverage documents and report indexes, including national NCD/NCA/CAL history, MEDCAC and technology-assessment material, and current/future/retired local LCD and Article index metadata.","identity_key":"document_id","row_count":5365,"last_updated":"2026-07-23","freshness_sla":"Weekly CMS local-data refresh; national updates may occur more frequently.","recollection":{"cadence":"weekly","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Current corpus is a versioned API snapshot; preserve document-level effective, implementation, retirement, and raw date fields.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.mcd_document","commercial_terms":"Public CMS Coverage API slice; no license token or licensed local document content is acquired.","known_gaps":["Local LCD and Article bodies and local code mappings are excluded because those Coverage API endpoints require acceptance of AMA, ADA, and AHA/NUBC license terms.","Public local rows are document indexes, not complete local coverage-policy text.","One optional related-comments endpoint returned HTTP 502 after bounded retries in the accepted snapshot and is recorded as a source limit."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicare_coverage_database","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["document_id"],"backing_store":"glue"},{"source_id":"cms_mcd_document_relationship","source_fqn":"medicare_silver.mcd_document_relationship","title":"CMS Medicare Coverage Database document relationships","domain":"medicare","stage":"silver","status":"live","grain":"One row per (Coverage API snapshot, parent document, public relationship endpoint, publisher row ordinal).","description":"Public relationship records linking national coverage documents to version history, tracking sheets, transmittals, related documents, meetings, assessments, and other publicly exposed coverage artifacts.","identity_key":"parent_document_id","row_count":2965,"last_updated":"2026-07-23","freshness_sla":"Weekly CMS local-data refresh; national updates may occur more frequently.","recollection":{"cadence":"weekly","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Join through the explicit parent document type, ID, and version; endpoint plus row ordinal is the physical natural key.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.mcd_document_relationship","commercial_terms":"Public CMS Coverage API slice; no license token or licensed local relationship data is acquired.","known_gaps":["Relationships are limited to endpoints explicitly public in the pinned Coverage API v1.6 contract.","Parent and child identities remain source-native strings; do not infer a local policy-to-code relationship from index metadata."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicare_coverage_database","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["parent_document_id"],"backing_store":"glue"},{"source_id":"cms_mcd_document_component","source_fqn":"medicare_silver.mcd_document_component","title":"CMS Medicare Coverage Database public document components","domain":"medicare","stage":"silver","status":"live","grain":"One row per (Coverage API snapshot, parent document, public component endpoint, publisher row ordinal).","description":"Public child components of national coverage artifacts, retaining exact parent identity, endpoint, raw payload, publisher row ordinal, and response-member hash.","identity_key":"parent_document_id","row_count":899,"last_updated":"2026-07-23","freshness_sla":"Weekly CMS local-data refresh; national updates may occur more frequently.","recollection":{"cadence":"weekly","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Component rows preserve source-native payloads and must be interpreted in the context of their parent document and endpoint.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.mcd_document_component","commercial_terms":"Public CMS Coverage API slice; licensed local LCD and Article component endpoints are excluded.","known_gaps":["No CPT/HCPCS, modifier, ICD-10, bill-type, revenue-code, or SAD component is acquired from a license-token endpoint.","One optional related-comments response is absent under the accepted HTTP 502 source limit."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicare_coverage_database","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["parent_document_id"],"backing_store":"glue"},{"source_id":"cms_mcd_reference","source_fqn":"medicare_silver.mcd_reference","title":"CMS Medicare Coverage Database reference metadata","domain":"medicare","stage":"silver","status":"live","grain":"One row per (Coverage API snapshot, public reference endpoint, publisher row ordinal).","description":"Public Coverage API reference metadata, including states, update periods, local-data schedule, contractor types and subtypes, and contractor records.","identity_key":"record_type","row_count":270,"last_updated":"2026-07-23","freshness_sla":"Weekly CMS local-data refresh.","recollection":{"cadence":"weekly","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Endpoint plus publisher row ordinal is the physical natural key; retain raw payload_json when a reference schema changes.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.mcd_reference","commercial_terms":"Public CMS Coverage API reference metadata.","known_gaps":["Reference rows are publisher metadata and do not themselves establish a complete MAC jurisdiction or policy-to-provider join."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicare_coverage_database","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["record_type"],"backing_store":"glue"},{"source_id":"resdac_claim_reference_source_asset","source_fqn":"medicare_silver.resdac_claim_reference_source_asset","title":"ResDAC / CMS claim-reference governed source-asset ledger","domain":"medicare","stage":"silver","status":"live","grain":"One row per governed corpus snapshot and acquired, source-limited, or existing-overlap asset.","description":"Content and rights ledger for four public CMS claim CodeSystems, all 25 recovered CMS Medicare Provider and Supplier Taxonomy Crosswalk revisions, 11 exact NUBC/AMA/ADA source limits, and three pointers to independently mastered Vlada sources.","identity_key":"observed_period,asset_id","row_count":43,"last_updated":"2026-07-24","freshness_sla":"Re-inventory CMS and ResDAC publisher surfaces on each refresh; the taxonomy crosswalk changes only when CMS publishes a revision.","recollection":{"cadence":"snapshot_adhoc","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Recollection must preserve publisher authority per asset and fail closed if a governed NUBC/AMA/ADA asset has a payload member.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.resdac_claim_reference_source_asset","commercial_terms":"Public CMS payload only. Externally maintained NUBC code content, AMA CPT descriptions, and ADA CDT descriptions are not acquired or served.","known_gaps":["Eleven NUBC/AMA/ADA families are metadata-only source limits with no payload member and are not claim-code decoders.","Carrier/MAC locality, PSPS, physician provider-service utilization, NUCC taxonomy, and the empirical CPT/revenue modal bridge remain independently mastered sources and are only referenced.","The empirical CPT/revenue modal bridge is not an authoritative NUBC revenue-code decoder.","This source does not supply an AHD-style Medicare/Medicaid/Other net-patient-revenue split."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_claim_reference_code_systems","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"resdac_claim_code","source_fqn":"medicare_silver.resdac_claim_code","title":"CMS public Medicare claim reference codes","domain":"medicare","stage":"silver","status":"live","grain":"One row per immutable CMS FHIR CodeSystem release and source concept ordinal.","description":"Public CMS claim type, near-line record identification, place-of-service, and provider-specialty concepts from four immutable CMS Blue Button CodeSystem assets, with source-native display and definition plus exact release and Bronze lineage.","identity_key":"observed_period,source_asset_id,source_row_number","row_count":382,"last_updated":"2026-07-24","freshness_sla":"Re-inventory the CMS CodeSystem repository on each claim-reference refresh.","recollection":{"cadence":"snapshot_adhoc","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Refresh from immutable CMS content and retain source concept ordinals; do not merge externally maintained code sets into this table.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.resdac_claim_code","commercial_terms":"Public CMS CodeSystem content.","known_gaps":["This table covers exactly four CMS-owned code systems and is not a Type of Bill, revenue, discharge, condition, occurrence, value, CPT-description, or CDT-description decoder.","ResDAC documents the variables; the acquired code content is owned and published by CMS.","Preserve code_system and release_date when interpreting a value."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_claim_reference_code_systems","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"resdac_specialty_taxonomy_crosswalk","source_fqn":"medicare_silver.resdac_specialty_taxonomy_crosswalk","title":"CMS Medicare specialty to provider taxonomy crosswalk history","domain":"medicare","stage":"silver","status":"live","grain":"One row per CMS crosswalk release asset and physical source row.","description":"Complete recoverable CMS Medicare Provider and Supplier Taxonomy Crosswalk history across PDF, legacy Socrata CSV, and Data.CMS.gov CSV eras, retaining many-to-many relationships, physical row lineage, raw rows, quality flags, and analytics eligibility.","identity_key":"observed_period,source_asset_id,source_row_number","row_count":12900,"last_updated":"2026-07-24","freshness_sla":"Re-inventory the CMS taxonomy-crosswalk publisher history on each refresh; no annual release is inferred when CMS publishes no revision.","recollection":{"cadence":"event_driven","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve PDF/CSV schema eras, raw rows, source ordinals, and exact revision identity; do not forward-fill sparse legacy rows.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.resdac_specialty_taxonomy_crosswalk","commercial_terms":"Public CMS crosswalk content; NUCC taxonomy content remains an independently mastered source.","known_gaps":["The recoverable publisher history has 25 distinct revisions from 2011-01-20 through 2025-11-01; absent years are not invented releases.","The table is a versioned many-to-many physical crosswalk and must not be collapsed to one taxonomy per Medicare specialty.","Some publisher rows intentionally contain no taxonomy, and malformed legacy values remain noneligible with explicit quality flags.","Join current eligible provider taxonomy codes to the independently mastered NUCC dimension rather than treating this crosswalk as the taxonomy dictionary."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_claim_reference_code_systems","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"x12_claim_reference_source_asset","source_fqn":"medicare_silver.x12_code_list_asset","title":"X12 healthcare code-list source-limit ledger","domain":"medicare","stage":"silver","status":"live","grain":"One row per governed corpus snapshot and X12 healthcare code-list family.","description":"Metadata-only inventory of the 16 X12 healthcare code-list families relevant to claim, remittance, status, payment, adjustment, service, and related transaction semantics, preserving publisher list identity, maintainer, observed release date, source URL, licensing disposition, and the exact no-payload boundary.","identity_key":"observed_period,asset_id","row_count":16,"last_updated":"2026-07-24","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.x12_code_list_asset","notes":null,"superseded_by":null,"tools":[],"dataset_id":"x12_healthcare_code_list_ledger","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ahrq_clinical_reference_source_asset","source_fqn":"medicare_silver.ahrq_source_asset","title":"AHRQ clinical-reference governed source-asset ledger","domain":"medicare","stage":"silver","status":"live","grain":"One row per governed corpus snapshot and publisher asset.","description":"Content and license ledger for the accepted AHRQ CCSR, Quality Indicator SAS, benchmark PDF, and immutable qi-sas repository corpus, preserving exact URLs, files, bytes, hashes, release identity, and current-release status.","identity_key":"observed_period,asset_id","row_count":176,"last_updated":"2026-07-23","freshness_sla":"Annual clinical-code and Quality Indicator releases, with source-surface discovery on refresh.","recollection":{"cadence":"annual","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Recollection must rediscover publisher history, preserve exact content identity, and fail closed at the AMA license gate.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ahrq_source_asset","commercial_terms":"Public AHRQ assets only; the AMA-clickthrough CCS CPT/HCPCS payload is excluded and represented by one metadata-only gated row.","known_gaps":["The AHRQ CCS Services and Procedures CPT/HCPCS payload is not acquired because its publisher gate requires acceptance of third-party AMA terms.","The gated row has no payload URL, file name, byte count, or payload SHA; those nulls are intentional and must not be filled by inference."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ahrq_quality_indicators","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ahrq_clinical_reference_ccsr_mapping","source_fqn":"medicare_silver.ahrq_ccsr_mapping","title":"AHRQ CCSR diagnosis and procedure mappings","domain":"medicare","stage":"silver","status":"live","grain":"One row per observed release, source code, CCSR category relationship, and category rank.","description":"Public AHRQ diagnosis and procedure CCS/CCSR history at native multi-category relationship grain, including inpatient/outpatient defaults, source descriptions, category ranks, clinical domains, and row-level lineage.","identity_key":"observed_period,source_asset_id,source_member,source_row_number,relationship_type,category_rank","row_count":5851110,"last_updated":"2026-07-23","freshness_sla":"Annual AHRQ CCSR release, with historical publisher inventory recertified on refresh.","recollection":{"cadence":"annual","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Release version and code system are required for temporal interpretation; observed_period alone is not a clinical-code effective date."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ahrq_ccsr_mapping","known_gaps":["Use release-compatible ICD-10-CM and ICD-10-PCS joins; historical AHRQ releases legitimately retain codes that are retired from a current code dimension.","Multi-category relationships and inpatient/outpatient defaults are distinct rows and must not be collapsed to one category per code."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ahrq_ccsr","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id","source_row_number"],"unmapped_key_tokens":["category_rank","relationship_type","source_member"],"backing_store":"glue"},{"source_id":"ahrq_clinical_reference_ccsr_category","source_fqn":"medicare_silver.ahrq_ccsr_category","title":"AHRQ CCSR category hierarchy","domain":"medicare","stage":"silver","status":"live","grain":"One row per observed release asset, CCSR category, hierarchy level, and clinical domain.","description":"Public AHRQ diagnosis and procedure CCSR category labels and hierarchy relationships, retained by source release and clinical domain with row-level content lineage.","identity_key":"observed_period,source_asset_id,category_code,hierarchy_level,clinical_domain","row_count":13886,"last_updated":"2026-07-23","freshness_sla":"Annual AHRQ CCSR release.","recollection":{"cadence":"annual","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Interpret categories within their code system, release version, schema era, and source asset.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ahrq_ccsr_category","known_gaps":["A category describes a clinical classification and is not a Medicare coverage, payment, or hospital-quality determination.","Parent relationships and hierarchy depth vary by CCSR schema era; retain release version when traversing."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ahrq_ccsr","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id"],"unmapped_key_tokens":["category_code","clinical_domain","hierarchy_level"],"backing_store":"glue"},{"source_id":"ahrq_clinical_reference_qi_value_set","source_fqn":"medicare_silver.ahrq_qi_value_set","title":"AHRQ Quality Indicator public SAS value-set rules","domain":"medicare","stage":"silver","status":"live","grain":"One row per observed release, SAS source member, format definition line, and rule ordinal.","description":"Normalized public IQI, PDI, PQI, and PSI SAS VALUE rules across the recoverable publisher history, preserving clinical system, code or range, output, comments, OTHER branches, compact row assignment, and exact Bronze/member/line lineage.","identity_key":"observed_period,source_asset_id,source_member,format_name,source_line_number,rule_ordinal","row_count":10020218,"last_updated":"2026-07-23","freshness_sla":"Annual AHRQ Quality Indicator software release, with historical module inventory recertified on refresh.","recollection":{"cadence":"annual","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Join only analytics-eligible rules to a matching ICD-10-CM, ICD-10-PCS, or MS-DRG dimension and a compatible release period.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ahrq_qi_value_set","commercial_terms":"Public AHRQ Quality Indicator SAS software and Apache-licensed public repository content.","known_gaps":["SAS OTHER branches and administrative/nonclinical formats are retained but are not analytic clinical-code members.","raw_rule_text is the compact assignment fragment at normalized row grain; use source asset, member, and line to recover the complete publisher statement from Bronze.","A value-set membership is methodology logic, not a claim that a hospital has a condition, score, payment, or coverage outcome."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ahrq_quality_indicators","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id"],"unmapped_key_tokens":["format_name","rule_ordinal","source_line_number","source_member"],"backing_store":"glue"},{"source_id":"ahrq_clinical_reference_qi_benchmark","source_fqn":"medicare_silver.ahrq_qi_benchmark","title":"AHRQ Quality Indicator national benchmark tables","domain":"medicare","stage":"silver","status":"live","grain":"One row per observed release, source PDF page/table, indicator, group, and row ordinal.","description":"Public IQI, PDI, PQI, and PSI national benchmark and stratified reference tables across modern and legacy layouts, retaining raw metrics, nullable numeric values, suppression/range state, page/table identity, and content lineage.","identity_key":"observed_period,source_asset_id,source_page,table_number,row_ordinal","row_count":7031,"last_updated":"2026-07-23","freshness_sla":"Annual AHRQ Quality Indicator benchmark publication.","recollection":{"cadence":"annual","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve module, release, source page/table, benchmark scope, group, raw values, and suppression state when comparing rows.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ahrq_qi_benchmark","commercial_terms":"Public AHRQ Quality Indicator benchmark publications.","known_gaps":["These are national methodology/reference benchmarks, not CCN-level hospital performance scores.","Suppressed, ranged, and not-applicable publisher values remain nullable and must never be coerced to zero or guessed point values."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ahrq_quality_indicators","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id"],"unmapped_key_tokens":["row_ordinal","source_page","table_number"],"backing_store":"glue"},{"source_id":"medpac_databook_source_asset","source_fqn":"medicare_silver.medpac_databook_source_asset","title":"MedPAC annual Data Book source asset inventory","domain":"medicare","stage":"silver","status":"live","grain":"One row per accepted annual full-report PDF or publisher-supplied section workbook.","description":"Complete recoverable public inventory for MedPAC's annual Health Care Spending and the Medicare Program Data Book, covering 24 annual PDFs from 2003 through 2026 and 19 selectively published supporting workbooks from 2024 through 2026, with edition, section, archive/live provenance, document hash, parse disposition, and exact Bronze lineage.","identity_key":"observed_period,asset_id","row_count":43,"last_updated":"2026-07-26","freshness_sla":"Re-inventory the official MedPAC Data Book publication family and supporting workbook surface after each annual release or publisher correction.","recollection":{"cadence":"annual","watermark_field":"edition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate the official annual family, preserve archive/live provenance and exact bytes, and never infer unpublished workbook assets.","watermark_field 'edition_year' is the MedPAC Data Book edition year the asset belongs to; a publication vintage, not a metric measurement period."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medpac_databook_source_asset","commercial_terms":"Public MedPAC policy benchmark publications.","known_gaps":["MedPAC selectively publishes supporting workbooks; absent section workbooks are not fabricated and chart values are not inferred from geometry.","Editions from 2003 through 2019 use immutable Internet Archive captures of original MedPAC files because the current publisher surface does not retain those live downloads.","Topic-specific MedPAC data books are separate publication families and are not silently unioned into this annual core."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"medpac_data_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medpac_databook_page","source_fqn":"medicare_silver.medpac_databook_page","title":"MedPAC annual Data Book page evidence","domain":"medicare","stage":"silver","status":"live","grain":"One physical PDF page per accepted annual edition and source asset.","description":"Layout-preserving page evidence for all 5,091 pages in the 24 accepted annual MedPAC Data Books from 2003 through 2026, retaining page text, section and exhibit detection, page hash, extraction eligibility, source URL, and content-addressed Bronze lineage.","identity_key":"observed_period,asset_id,page_number","row_count":5091,"last_updated":"2026-07-26","freshness_sla":"Parse and certify every page after each accepted annual Data Book release or publisher correction.","recollection":{"cadence":"annual","watermark_field":"edition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Choose edition, section, exhibit, page, population, unit, and measurement period before analysis; retain page-level hashes and eligibility.","watermark_field 'edition_year' is the MedPAC Data Book edition year the page was extracted from; a publication vintage, not the measurement period of any exhibit on the page."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medpac_databook_page","commercial_terms":"Public MedPAC policy benchmark publications.","known_gaps":["The 472 pages without extractable text are retained and explicitly ineligible; text is not invented from chart geometry or image-only content.","Section and exhibit identity support discovery and citation, but edition year is not necessarily the measurement year of every metric shown.","These are national and sector policy benchmarks, not CCN-level hospital facts, claims, cost reports, or rate-setting inputs."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"medpac_data_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","page_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medpac_databook_workbook_cell","source_fqn":"medicare_silver.medpac_databook_workbook_cell","title":"MedPAC Data Book supporting workbook cells","domain":"medicare","stage":"silver","status":"live","grain":"One nonempty physical cell per accepted workbook, sheet, and coordinate.","description":"Lossless cell-level evidence from all 19 publisher-supplied MedPAC Data Book supporting workbooks for 2024 through 2026, preserving raw and displayed values, formulas, number formats, merged ranges, hyperlinks, sheet identity, section identity, semantic hashes, and exact Bronze lineage.","identity_key":"observed_period,asset_id,sheet_name,cell_coordinate","row_count":7862,"last_updated":"2026-07-26","freshness_sla":"Acquire and parse every supporting workbook published with each annual Data Book release or correction.","recollection":{"cadence":"annual","watermark_field":"edition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Select edition, section, workbook, sheet, and exact cell; preserve formula and format semantics and never coerce an unpublished or blank value to zero.","watermark_field 'edition_year' is the MedPAC Data Book edition year the workbook was published with; a publication vintage, not the measurement period of the cell's value."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medpac_databook_workbook_cell","commercial_terms":"Public MedPAC supporting chart-data workbooks.","known_gaps":["Workbook coverage is publisher-selective: six sections in 2024, seven in 2025, and six in 2026; missing section-year workbooks are not inferred.","Blank cells are not rows and must never be interpreted as numeric zero; formulas, formats, merges, and hyperlinks remain source evidence.","Workbook metrics remain exhibit-level national or sector context and must not be assigned to an individual hospital or summed across editions."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"medpac_data_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name"],"unmapped_key_tokens":["cell_coordinate"],"backing_store":"glue"},{"source_id":"medpac_databook_exhibit","source_fqn":"medicare_silver.medpac_databook_exhibit","title":"MedPAC Data Book workbook exhibit index","domain":"medicare","stage":"silver","status":"live","grain":"One publisher-supplied workbook sheet and exhibit per accepted edition and source asset.","description":"Governed semantic index for all 56 numeric exhibits in the 19 publisher-supplied MedPAC Data Book workbooks for 2024 through 2026, retaining chart or figure identity, exact publisher title and unit, numeric data extent, measurement-year bounds, observation count, source cells, document hash, and Bronze lineage.","identity_key":"observed_period,asset_id,sheet_name","row_count":56,"last_updated":"2026-07-26","freshness_sla":"Rebuild from the accepted content-addressed workbook corpus after each annual Data Book release or publisher correction.","recollection":{"cadence":"annual","watermark_field":"edition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Retain edition year separately from metric measurement period and never widen a national or sector exhibit into a CCN-level fact.","watermark_field 'edition_year' is the MedPAC Data Book edition year the exhibit was published in; a publication vintage carried separately from the exhibit's metric measurement period."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medpac_databook_exhibit","commercial_terms":"Public MedPAC supporting chart-data workbooks.","known_gaps":["This table covers only the publisher-supplied 2024-2026 workbooks; it does not infer exhibits or values from PDF chart geometry.","Workbook files do not carry the annual PDF's full notes and methodology text, so those nullable fields remain unfilled and the page-evidence table remains the citation authority.","Population and geography labels are not guessed from prose; use the exact title, unit, dimensions, and annual PDF page evidence when those scopes matter."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"medpac_data_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medpac_databook_metric_observation","source_fqn":"medicare_silver.medpac_databook_metric_observation","title":"MedPAC Data Book numeric metric observations","domain":"medicare","stage":"silver","status":"live","grain":"One exact publisher numeric value cell per accepted workbook exhibit, excluding detected period and dimension cells.","description":"Source-faithful numeric observations from every accepted MedPAC supporting workbook, with metric header path, measurement period and year, quarter, unit, category, projection status, exact value/header/dimension cell coordinates, formula, number format, document hash, and content-addressed Bronze lineage.","identity_key":"observed_period,asset_id,sheet_name,value_cell_coordinate","row_count":5567,"last_updated":"2026-07-26","freshness_sla":"Rebuild deterministically from the accepted workbook corpus after each annual Data Book release or publisher correction.","recollection":{"cadence":"annual","watermark_field":"edition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Trace every value through value_cell_coordinate, measure_header_cells_json, dimension_cells_json, document_sha256, and Bronze lineage; do not coerce nulls or infer PDF-only values.","watermark_field 'edition_year' is the MedPAC Data Book edition year the value was published in; a publication vintage, not the measurement period, which is exhibit-specific and carried separately."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medpac_databook_metric_observation","commercial_terms":"Public MedPAC supporting chart-data workbooks.","known_gaps":["The semantic layer is limited to exact publisher workbook values for 2024-2026; it does not reverse-engineer historical PDF charts or create values for absent workbooks.","Edition year is publication vintage, not measurement year. Always select measurement_period, period_type, unit, metric, and category before comparing editions.","Blank cells are absent, not zero. Publisher numeric zeros, negatives, projections, formulas, formats, and source coordinates are preserved explicitly.","These are national or sector policy observations, not CCN-level hospital facts and not an AHD/AHA payer-revenue split."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"medpac_data_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name"],"unmapped_key_tokens":["value_cell_coordinate"],"backing_store":"glue"},{"source_id":"macpac_macstats_source_asset","source_fqn":"medicare_silver.macpac_macstats_source_asset","title":"MACPAC MACStats source asset inventory","domain":"state","stage":"silver","status":"live","grain":"One row per accepted full-edition PDF, historical Excel container, or exact workbook asset.","description":"Complete public MACStats inventory across 19 official editions from March 2011 through February 2026, retaining 19 full PDFs, 18 historical Excel containers, 456 exact archived workbook members, 43 current workbooks, document hashes, parse disposition, publication vintage, and content-addressed Bronze lineage.","identity_key":"observed_period,asset_id","row_count":536,"last_updated":"2026-07-26","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.macpac_macstats_source_asset","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_macpac_macstats","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"macpac_macstats_page","source_fqn":"medicare_silver.macpac_macstats_page","title":"MACPAC MACStats full-edition page evidence","domain":"state","stage":"silver","status":"live","grain":"One physical PDF page per accepted MACStats edition and full-edition source asset.","description":"Layout-preserving page evidence for all 2,375 pages in the 19 accepted MACStats editions, retaining page text, publisher exhibit detection, page hashes, extraction eligibility, source URL, publication vintage, and exact Bronze lineage.","identity_key":"observed_period,asset_id,page_number","row_count":2375,"last_updated":"2026-07-26","freshness_sla":"Parse and certify every page after each accepted MACStats edition or publisher correction.","recollection":{"cadence":"annual","watermark_field":"edition_id","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Select edition, exhibit, page, population, unit, and measurement period; retain page-level hashes and extraction eligibility.","watermark_field 'edition_id' is the MACStats edition identifier the page was extracted from; a publication vintage, not the measurement period of any exhibit on the page."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.macpac_macstats_page","commercial_terms":"Public MACPAC Medicaid and CHIP policy benchmark publications.","known_gaps":["The 133 pages without extractable text remain explicit ineligible evidence; text or chart values are not invented from image geometry.","Publisher exhibit detection supports discovery and citation, but publication edition is not necessarily the measurement period of every value shown.","These are state and national Medicaid/CHIP policy pages, not provider-, CCN-, claim-, cost-report-, or hospital-rate-setting facts."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"macpac_macstats","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","page_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"macpac_macstats_workbook_cell","source_fqn":"medicare_silver.macpac_macstats_workbook_cell","title":"MACPAC MACStats lossless workbook cells","domain":"state","stage":"silver","status":"live","grain":"One nonempty physical cell per accepted workbook, sheet, and exact coordinate.","description":"Lossless cell-level evidence from all 499 accepted MACStats workbooks across the 19-edition history, preserving raw and displayed values, formulas, formats, merged ranges, hyperlinks, sheet and exhibit identity, document hash, and exact Bronze lineage.","identity_key":"observed_period,asset_id,sheet_name,cell_coordinate","row_count":383797,"last_updated":"2026-07-26","freshness_sla":"Acquire and parse every workbook MACPAC publishes with each edition or correction.","recollection":{"cadence":"annual","watermark_field":"edition_id","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Select edition, workbook, sheet, and exact cell; preserve formula and display semantics and never coerce an absent value to zero.","watermark_field 'edition_id' is the MACStats edition identifier the workbook was published with; a publication vintage, not the measurement period of the cell's value."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.macpac_macstats_workbook_cell","commercial_terms":"Public MACPAC MACStats workbook data.","known_gaps":["Blank cells are absent rather than zero; formulas, formats, merges, hyperlinks, and exact publisher text remain source evidence.","Historical ZIP members retain their container and member lineage; the ZIP container itself is not an additional analytic observation.","Workbook values remain state or national policy evidence and must not be assigned to an individual hospital or summed across editions."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"macpac_macstats","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name"],"unmapped_key_tokens":["cell_coordinate"],"backing_store":"glue"},{"source_id":"macpac_macstats_exhibit","source_fqn":"medicare_silver.macpac_macstats_exhibit","title":"MACPAC MACStats workbook exhibit index","domain":"state","stage":"silver","status":"live","grain":"One physical workbook sheet per accepted MACStats workbook and edition.","description":"Governed semantic index for 864 physical workbook sheets, retaining canonical versus alternate display role, title, unit, data extent, observation counts, measurement-year bounds, source cells, document hash, publication vintage, and Bronze lineage.","identity_key":"observed_period,asset_id,sheet_name","row_count":864,"last_updated":"2026-07-26","freshness_sla":"Rebuild from the accepted content-addressed workbook corpus after each MACStats edition or correction.","recollection":{"cadence":"annual","watermark_field":"edition_id","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Retain publication edition separately from measurement period and never widen a state or national exhibit into a provider-level fact.","watermark_field 'edition_id' is the MACStats edition identifier the exhibit was published in; a publication vintage carried separately from the exhibit's measurement period."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.macpac_macstats_exhibit","commercial_terms":"Public MACPAC MACStats workbook data.","known_gaps":["All 864 physical sheets remain queryable, but only 676 pass the guarded analytics-eligibility rules; alternate display sheets do not create duplicate analytic authority.","PDF-only exhibits remain page evidence and do not generate inferred workbook exhibits or numeric observations.","Similar exhibit labels across editions are not a universal harmonized metric identity without a separate governed crosswalk."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"macpac_macstats","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"macpac_macstats_metric_observation","source_fqn":"medicare_silver.macpac_macstats_metric_observation","title":"MACPAC MACStats exact metric observations","domain":"state","stage":"silver","status":"live","grain":"One exact canonical workbook value cell when MACPAC publishes a numeric value or an explicit textual value state.","description":"Source-faithful long-form MACStats value states across all accepted canonical workbook sheets, retaining row label and group, merged header path, measurement period, geography when explicit, numeric or textual publisher status, exact value/header/dimension cells, formula, format, document hash, and Bronze lineage.","identity_key":"observed_period,asset_id,sheet_name,value_cell_coordinate","row_count":240074,"last_updated":"2026-07-26","freshness_sla":"Rebuild deterministically from the accepted workbook corpus after each MACStats edition or publisher correction.","recollection":{"cadence":"annual","watermark_field":"edition_id","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Trace every value through value_cell_coordinate, header_cells_json, dimension_cells_json, document_sha256, and Bronze lineage; do not coerce null states or infer PDF-only values.","watermark_field 'edition_id' is the MACStats edition identifier the value was published in; a publication vintage, not the measurement period, which is exhibit-specific and carried separately."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.macpac_macstats_metric_observation","commercial_terms":"Public MACPAC MACStats workbook data.","known_gaps":["Publication edition is not measurement period; compare rows only after binding measurement_period, period_type, unit, metric header, geography, and population.","Blank cells are absent, not zero. Unresolved dashes, not-available values, and dagger states retain null numeric values; only explicit numeric zero or a worksheet-defined quantity-zero symbol is zero.","Only 203,424 of the 240,074 lossless value states have an unambiguous numeric value, header, and measurement period and are analytics-eligible.","Current Exhibit 29 remains measured as of July 1, 2022; it must not be relabeled as 2026 managed-care data.","These are state and national Medicaid/CHIP policy observations, not CCN-level hospital facts and not an AHD/AHA Medicare, Medicaid, and Other net-patient-revenue split."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"macpac_macstats","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name"],"unmapped_key_tokens":["value_cell_coordinate"],"backing_store":"glue"},{"source_id":"cdc_nhsn_state_hai_progress","source_fqn":"medicare_silver.fact_cdc_nhsn_state_hai","title":"CDC NHSN National and State HAI Progress Data","domain":"state","stage":"silver","status":"live","grain":"One lossless publisher state-data row per reporting year, artifact, source sheet, and source row number; normalized measure and jurisdiction analytics are separately eligibility-gated.","description":"State and territory standardized infection ratios and standardized utilization ratios from CDC NHSN across acute care, critical access, inpatient rehabilitation, and long-term acute-care settings.","identity_key":"reporting_year,publisher_artifact_id,source_sheet,source_row_number","row_count":40792,"last_updated":"2026-08-09","raw_queryable_via":"Athena via medicare_silver.fact_cdc_nhsn_state_hai","notes":null,"superseded_by":null,"tools":[],"dataset_id":"cdc_nhsn_hai_progress","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_row_number"],"unmapped_key_tokens":["publisher_artifact_id","reporting_year","source_sheet"],"backing_store":"glue"},{"source_id":"cms_medicaid_core_set_quality","source_fqn":"medicare_silver.fact_medicaid_core_set_quality","title":"CMS Medicaid/CHIP Child and Adult Core Set State Quality","domain":"medicare","stage":"silver","status":"live","grain":"One publisher row per reporting year, state, reporting program, measure/rate definition, population, and methodology.","description":"State-level performance rates and comparison benchmarks for CMS Medicaid and CHIP Child and Adult Core Set measures, preserving populations, methodologies, suppression statuses, notes, state comments, and source lineage.","identity_key":"reporting_year,state_code,reporting_program,measure_abbreviation,rate_definition,population,methodology","row_count":31344,"last_updated":"2026-08-08","raw_queryable_via":"Athena (read-only): medicare_silver.fact_medicaid_core_set_quality","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_cms_medicaid","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["measure_abbreviation","methodology","population","rate_definition","reporting_program","reporting_year"],"backing_store":"glue"},{"source_id":"cms_medicaid_health_home_quality","source_fqn":"medicare_silver.fact_medicaid_health_home_quality","title":"CMS Medicaid Health Home Program Quality","domain":"state","stage":"silver","status":"live","grain":"One physical publisher observation cell per reporting year, measure, state, approved Health Home program, population, methodology, and denominator/rate stratum.","description":"Lossless CMS Medicaid Health Home measure-performance tables for 2019-2024, preserving program identity, measure-specific column headers, raw table context, suppression statuses, and exact ZIP/PDF lineage.","identity_key":"reporting_year,source_member,source_page,source_table_ordinal,source_row_ordinal,source_column_ordinal","row_count":12979,"last_updated":"2026-08-09","raw_queryable_via":"Athena (read-only): medicare_silver.fact_medicaid_health_home_quality","notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicaid_health_home_quality","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["reporting_year","source_column_ordinal","source_member","source_page","source_row_ordinal","source_table_ordinal"],"backing_store":"glue"},{"source_id":"cms_medicaid_chip_enrollment_source_asset","source_fqn":"medicare_silver.cms_medicaid_chip_enrollment_source_asset","title":"CMS Medicaid and CHIP monthly-enrollment source asset inventory","domain":"state","stage":"silver","status":"live","grain":"One row per governed current portal asset, official historical report PDF or ZIP container, or exact expanded archive member.","description":"Complete physical source inventory for the accepted monthly state Medicaid and CHIP applications, eligibility, and enrollment family, retaining the current CSV and metadata, the official report-history page, 80 historical PDFs, 48 ZIP containers, 48 workbook members, 24 retained PDF members, document hashes, parse disposition, and content-addressed Bronze lineage.","identity_key":"observed_period,asset_id","row_count":204,"last_updated":"2026-07-26","freshness_sla":"Re-inventory the Data.Medicaid.gov dataset and official CMS report-history surface after every monthly release or publisher correction.","recollection":{"cadence":"monthly","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate both official publisher surfaces, preserve container/member lineage, and do not treat the July-September 2013 baseline as ordinary September activity.","watermark_field corrected 2026-09-04 to 'observed_period', the M-2 period column on this asset-inventory table (the previously declared 'reporting_period' is not one of its columns, per the 2026-09-01 columns snapshot); reporting_period lives on the monthly state fact, not on the asset rows."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_medicaid_chip_enrollment_source_asset","commercial_terms":"Public CMS Medicaid and CHIP enrollment publications.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_medicaid_enrollment_2026_07_26.json","known_gaps":["The standardized portal rows cover the July-September 2013 baseline and June 2017 through March 2026; older report-era workbooks are retained losslessly but not silently conformed.","ZIP containers and their exact members are separate physical lineage assets, not additional enrollment observations.","Historical PDF chart values are not inferred from page geometry."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicaid_chip_enrollment_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_medicaid_chip_enrollment_workbook_cell","source_fqn":"medicare_silver.cms_medicaid_chip_enrollment_workbook_cell","title":"CMS Medicaid and CHIP historical report workbook cells","domain":"state","stage":"silver","status":"live","grain":"One nonempty physical cell per accepted historical report workbook, sheet, and exact coordinate.","description":"Lossless cell-level evidence from all 48 official historical report workbooks, preserving raw and displayed values, formulas, formats, merged ranges, hyperlinks, exact ZIP container/member lineage, document hash, and content-addressed Bronze provenance.","identity_key":"observed_period,asset_id,sheet_name,cell_coordinate","row_count":158175,"last_updated":"2026-07-26","freshness_sla":"Rebuild from the exact accepted report-history bundle whenever CMS changes a historical archive or publishes another workbook.","recollection":{"cadence":"snapshot_adhoc","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Select the exact asset, sheet, and coordinate; preserve formula/display semantics and never coerce absent cells to zero.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_medicaid_chip_enrollment_workbook_cell","commercial_terms":"Public CMS Medicaid and CHIP historical report workbooks.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_medicaid_enrollment_2026_07_26.json","known_gaps":["This is source-era evidence, not a harmonized pre-2017 monthly fact table; workbook layouts and labels remain as published.","Blank cells are absent rather than zero, and PDF-only values are not synthesized.","Cell rows must not be summed across reports, sheets, or source eras without an independently governed mapping."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicaid_chip_enrollment_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name"],"unmapped_key_tokens":["cell_coordinate"],"backing_store":"glue"},{"source_id":"cms_medicaid_chip_enrollment_monthly_state","source_fqn":"medicare_silver.cms_medicaid_chip_enrollment_monthly_state","title":"CMS monthly state Medicaid and CHIP enrollment operations","domain":"state","stage":"silver","status":"live","grain":"One state or District of Columbia row per reporting period and publisher preliminary or updated/final revision.","description":"Source-faithful monthly state applications, eligibility determinations, enrollment, application-processing, and call-center measures from the current CMS portal distribution, retaining preliminary and updated revisions, final-report status, exact metric footnotes, latest-revision flags, semantic row hashes, and Bronze lineage.","identity_key":"observed_period,state_abbreviation,report_revision,final_report","row_count":11118,"last_updated":"2026-10-24","freshness_sla":"Refresh after each monthly Data.Medicaid.gov release and preserve both preliminary and updated publisher revisions.","recollection":{"cadence":"monthly","watermark_field":"reporting_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Bind revision and final-report status, select latest revision intentionally, retain footnotes, and never relabel the 201309 baseline as a normal month.","watermark_field 'reporting_period' is the publisher's monthly reporting period the row's counts describe (the 201309 baseline is such a period); a later publisher revision of the same period is a separate row distinguished by report_revision and final_report, so select the revision intentionally."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_medicaid_chip_enrollment_monthly_state","commercial_terms":"Public CMS Medicaid and CHIP applications, eligibility, and enrollment data.","provenance_chain_ref":"docs/research/justin/CMS-MEDICAID-MONTHLY-GUARDED-REFRESH-20261024.ACTUAL.json","known_gaps":["October 24 monthly_state refresh serves May 2026 updated/final and June 2026 preliminary; same-SHA replay is verified unchanged, and source_asset/workbook_cell retain their earlier snapshots.","For current analysis select is_latest_revision=true; preliminary rows coexist with updated/final rows and must not be summed.","Reporting period 201309 is the publisher's July-September 2013 average baseline, not ordinary September-only activity.","Blank numeric values are null, not zero, and each metric's exact footnote must remain in scope.","The standardized series has no portal rows for October 2013 through May 2017; historical workbooks remain separate lossless evidence rather than fabricated conformed facts."],"notes":null,"superseded_by":null,"tools":["get_medicaid_mco_enrollment"],"dataset_id":"cms_medicaid_chip_enrollment_reports","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period"],"unmapped_key_tokens":["final_report","report_revision","state_abbreviation"],"backing_store":"glue"},{"source_id":"cms_medicaid_managed_care_plan_source_asset","source_fqn":"medicare_silver.cms_medicaid_managed_care_plan_source_asset","title":"CMS Medicaid managed-care plan-enrollment source inventory","domain":"state","stage":"silver","status":"live","grain":"One row per accepted publisher history page, dataset metadata asset, or exact consolidated CSV.","description":"Governed source ledger for CMS Medicaid managed-care enrollment by program and plan, retaining the official history page, Data.Medicaid.gov metadata, exact 2016-2024 consolidated CSV, publisher bytes and document hashes, parse disposition, and content-addressed Bronze lineage.","identity_key":"observed_period,asset_id","row_count":3,"last_updated":"2026-07-26","freshness_sla":"Re-inventory the official enrollment-report and Data.Medicaid.gov surfaces after every annual release or publisher correction.","recollection":{"cadence":"annual","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate both publisher surfaces, retain the exact consolidated CSV, and do not treat labels as stable plan IDs.","watermark_field corrected 2026-09-04 to 'observed_period', the M-2 period column on this asset-inventory table (the previously declared 'calendar_year' is not one of its columns, per the 2026-09-01 columns snapshot); calendar_year lives on the plan-enrollment fact, not on the asset rows."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_medicaid_managed_care_plan_source_asset","commercial_terms":"Public CMS Medicaid managed-care enrollment publications.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_medicaid_enrollment_2026_07_26.json","known_gaps":["The accepted consolidated source spans calendar years 2016-2024; no earlier plan-level rows are published in this dataset.","This inventory is separate from the four-state T-MSIS county/MCO/service-category utilization product.","Plan labels and parent organizations are publisher text, not stable payer identities."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_medicaid_managed_care_enrollment_report","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_medicaid_managed_care_plan_enrollment","source_fqn":"medicare_silver.cms_medicaid_managed_care_plan_enrollment","title":"CMS Medicaid managed-care enrollment by program and plan","domain":"state","stage":"silver","status":"live","grain":"One physical publisher row per calendar year, state, program, plan label, and reported geographic region.","description":"Annual Medicaid managed-care enrollment for 2016-2024 with raw and normalized state labels, program and plan names, geographic region, separate Medicaid-only, dual, and total counts, exact raw values and value-status semantics, parent organization, stable physical source-row identity, semantic row hash, and Bronze lineage.","identity_key":"calendar_year,source_row_number","row_count":7804,"last_updated":"2026-07-26","freshness_sla":"Replace complete publisher calendar-year partitions after each accepted annual release or correction.","recollection":{"cadence":"annual","watermark_field":"calendar_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve raw values and value_status, do not recompute totals, retain publisher duplicate rows, and join plan labels only through a separately governed measured crosswalk.","watermark_field 'calendar_year' is the publisher calendar year the row was published for; a complete publisher calendar-year partition is replaced on each accepted annual release or correction."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_medicaid_managed_care_plan_enrollment","commercial_terms":"Public CMS Medicaid managed-care enrollment data.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_medicaid_enrollment_2026_07_26.json","known_gaps":["CMS states that published 0 may mean an exact zero or confidentiality suppression below ten; reported_zero_or_suppressed must never be asserted as exact zero.","Medicaid-only, dual, and total fields remain separate. Seven publisher rows do not arithmetically reconcile and totals must not be recomputed.","Four duplicated label combinations are retained as eight distinct source rows; source_row_number, not the label tuple, is the certified identity.","Plan names and parent organizations are not stable identifiers and no fuzzy payer crosswalk is implied.","parent_organization is the column as the state filed it, NOT a parent: in Florida it is the plan's own label (47 distinct values in CY2024 where the identity decisions resolve 10 parents; Athena 8dd8ff28, MCP walk 2026-10-12 #9). Group by parent through medicare_semantic.vw_medicaid_managed_care_plan_enrollment_parent_v1 (parent_id / parent_name from the effective-dated plan identity decisions; the filed column kept there as parent_label_as_filed).","This annual point-in-time plan roster is not claims, county service utilization, HCRIS, or an AHD/AHA payer-revenue split."],"notes":null,"superseded_by":null,"tools":["get_medicaid_mco_enrollment"],"dataset_id":"cms_medicaid_managed_care_enrollment_report","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_row_number"],"unmapped_key_tokens":["calendar_year"],"backing_store":"glue"},{"source_id":"cms_medicaid_managed_care_plan_enrollment_parent_v1","source_fqn":"medicare_semantic.vw_medicaid_managed_care_plan_enrollment_parent_v1","title":"CMS Medicaid managed-care enrollment by program and plan, with the parent in force","domain":"state","stage":"semantic_view","status":"planned","grain":"One row per calendar_year x source_row_number of the CMS annual roster (is_current), unchanged; 7,804 rows = 7,804 keys measured on the view body (Athena 9d79e685).","description":"The CMS annual Medicaid managed-care roster with every count and value_status as published, plus parent_id / parent_name / medicaid_plan_id resolved through Vlada's effective-dated plan identity decisions (exact filed plan name -> medicaid_plan_alias_v2 cms_annual_plan_enrollment -> medicaid_plan_v2 parent in force at July 1 of the year, via vw_medicaid_plan_alias_resolver_v1), the same decisions behind the parent-share crosswalk. The filed parent column is kept as parent_label_as_filed, with parent_label_as_filed_is_plan_label where the state filed the plan's own name.","identity_key":"calendar_year,source_row_number","row_count":7804,"last_updated":"2026-10-13","freshness_sla":"A view; follows the roster and the identity tables. A new identity version is a new _vN view, never an overwrite.","recollection":{"cadence":"derived","watermark_field":"calendar_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Follows medicare_silver.cms_medicaid_managed_care_plan_enrollment and the identity tables medicaid_plan_alias_v2 / medicaid_plan_v2.","watermark_field 'calendar_year' is the roster's publisher calendar year; the parent is the one in force on July 1 of it."]},"raw_queryable_via":"Not queryable until created: DDL ops/sql/medicaid/vw_medicaid_managed_care_plan_enrollment_parent_v1.sql is a deploy step of the Medicaid MCP walk-fixes PR (written, not run). After CREATE, set status live and add it to catalog_provenance_index.json.","commercial_terms":"Public CMS Medicaid managed-care enrollment data; parents are Vlada's reviewed identity decisions from public ownership evidence.","provenance_chain_ref":"ops/sql/medicaid/vw_medicaid_managed_care_plan_enrollment_parent_v1.sql","known_gaps":["parent_id is NULL where no identity decision covers the filed name: dental, NEMT and PACE vendors and most D-SNP sponsors by design, plus a few comprehensive plans (TX Driscoll). 3,044 of 7,804 rows resolve; 0 identity conflicts (Athena 9d79e685).","FL CY2024: 47 filed parent labels, 10 resolved parents; Centene 1,244,084 across its rows including its D-SNP row (Athena 8dd8ff28). Filter program_name to the comprehensive programs before reading a medical-MCO share.","Every roster trap applies (a published 0 may be suppression; Medicaid-only, dual and total are never recomputed)."],"notes":"Written 2026-10-13 for MCP customer walk item #9; the typed tool get_medicaid_mco_enrollment 0.3.0 applies the same rule in-process. Validation queries in ops/sql/medicaid/vw_medicaid_managed_care_plan_enrollment_parent_v1.validation.sql.","superseded_by":null,"tools":[],"dataset_id":"cms_medicaid_managed_care_enrollment_report","dataset_assignment_basis":"manual","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_row_number"],"unmapped_key_tokens":["calendar_year"],"backing_store":"glue"},{"source_id":"ca_medi_cal_managed_care_enrollment","source_fqn":"medicare_silver.fact_ca_medi_cal_managed_care_enrollment","title":"California DHCS Medi-Cal managed-care enrollment","domain":"state","stage":"silver","status":"live","grain":"One physical publisher row per enrollment month and source row number.","description":"Lossless cumulative monthly California Medi-Cal managed-care enrollment by publisher plan-type label, county, and plan label from January 2007 through June 2026, preserving raw and normalized labels, reported or suppressed count state, annotations, unexplained publisher-key duplicates, semantic row hash, and content-addressed Bronze lineage.","identity_key":"enrollment_month,source_row_number","row_count":31178,"last_updated":"2026-07-31","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ca_medi_cal_managed_care_enrollment","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_row_number"],"unmapped_key_tokens":["enrollment_month"],"backing_store":"glue"},{"source_id":"ny_medicaid_mco_enrollment_tracker_reported_observation_v7_projection_20261023","source_fqn":"medicare_semantic.vw_ny_medicaid_mco_enrollment_tracker_reported_observation_v7_candidate_20261023t221902z_c5e4c8dc","title":"New York Medicaid managed-care enrollment source-native observation projection","domain":"state","stage":"semantic_view","status":"partial","grain":"One New York publisher observation keyed by source_table_fqn and source_observation_key; the 32 columns and 66,702 distinct source keys were checked against the accepted national v7 New York branch.","description":"Accepted read-only New York projection of the national v7 observation ledger for bounded plan-history queries. It preserves publisher control rows and native program, plan, geography, measure and period labels; it does not authorize comparisons or a state, parent or national total.","identity_key":"source_table_fqn,source_observation_key","row_count":66702,"last_updated":"2026-10-23","freshness_sla":null,"recollection":{"cadence":"monthly","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["New York source releases are governed separately from the weekly state refresh; a newer observation period alone is not an accepted publisher edition."]},"raw_queryable_via":"Athena (read-only via governed query_substrate, W8): medicare_semantic.vw_ny_medicaid_mco_enrollment_tracker_reported_observation_v7_candidate_20261023t221902z_c5e4c8dc","provenance_chain_ref":"s3://vlada-platform-raw/tracker-runs/20261023T221902Z-c5e4c8dc/out/NY-V7-PROJECTION-CANDIDATE.ACTUAL.json (SHA-256 c52c69d84dec3c81745c83e06d54b235d7e414bfc7288625350d4df800145a74)","known_gaps":["Observed New York source periods span January 2021 through September 2026; the October 23 validation date is not a publisher-edition freshness claim.","The 529 native publisher total rows are controls, not additive detail; 340 exact program-control matches and 7 ambiguous controls do not authorize plan MoM or YoY comparison.","Source-native rows are not certified state, parent or national totals; never sum across programs, plans, measures or geography levels.","This run-named projection is accepted only while its Glue definition and underlying source snapshots match the pinned ACTUAL receipt."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w8_national_medicaid_mco_enrollment_ledger","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_observation_key","source_table_fqn"],"backing_store":"glue"},{"source_id":"national_medicaid_mco_enrollment_tracker_reported_observation_v7","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v7","title":"National Medicaid MCO enrollment ledger - every state's reported plan enrollment observations, one view","domain":"state","stage":"semantic_view","status":"partial","grain":"One source-native reported observation keyed by source_table_fqn and source_observation_key; v7 acceptance is pending.","description":"Candidate successor to the v6 source-native Medicaid MCO enrollment ledger. The proposed v7 definition preserves the existing source branches and reclassifies New York publisher_state_total as publisher_control; it is not an accepted enrollment total or national sum.","identity_key":"source_table_fqn,source_observation_key","row_count":null,"last_updated":null,"freshness_sla":null,"recollection":{"cadence":"monthly","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Each state adapter refreshes separately; the latest observation period is not a global successful-refresh timestamp."]},"raw_queryable_via":"Pending governed v7 acceptance: medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v7","provenance_chain_ref":null,"known_gaps":["New York source replay, v7 full-view and parent refresh ACTUAL receipts are required before a typed tool can point here; the v6 view and New York hold remain in force.","Source-native rows are not certified state, parent or national totals; do not sum across programs, measures, geography or publishers."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w8_national_medicaid_mco_enrollment_ledger","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_observation_key","source_table_fqn"],"backing_store":"glue"},{"source_id":"national_medicaid_mco_enrollment_tracker_reported_observation_v6","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v6","title":"National Medicaid MCO enrollment ledger - every state's reported plan enrollment observations, one view","domain":"state","stage":"semantic_view","status":"partial","grain":"One source-native reported observation; (source_table_fqn, source_observation_key) is unique. Full candidate measured 2,900,494 rows and zero duplicate/null keys on 2026-10-15.","description":"A ledger, not a total. The union of every structured state Medicaid managed-care enrollment observation Vlada holds: 45 jurisdictions, 87 medicare_silver state tables, observation periods January 1996 to September 2026. Each row keeps the publisher's own cadence, measure name, unit, time basis, program, geography and plan label, its value status (reported, zero, suppressed, missing), its row role (detail component, publisher control, overlapping summary) and its file lineage. Plan and parent identities are the publisher's text; no canonical crosswalk is applied. v5 = v4 plus NC, OH, NH, NE, CO and PR monthly, AR and KS quarterly, and the new KY monthly table. v6 preserves every v5 field and source branch, correcting only Michigan native publisher_county_total and publisher_overall_total to publisher_control.","identity_key":"source_table_fqn,source_observation_key","row_count":2900494,"last_updated":"2026-10-15","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v6","notes":"v6 corrects Michigan control roles while preserving values, keys, cadence, suppression, lineage and all other source branches. The inherited per-state counts and coverage caveats below were measured 2026-09-27 and are historical, not a new full-source acceptance. GA March source correction was independently applied and verified; MI missing files, OH restatements and derived parent-share materializations remain separate gates.","superseded_by":null,"tools":[],"dataset_id":"ds_national_medicaid","dataset_assignment_basis":"version_successor_of_v5_same_source_branches_and_keys","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_observation_key","source_table_fqn"],"backing_store":"glue"},{"source_id":"national_medicaid_mco_enrollment_tracker_reported_observation_v5","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5","title":"National Medicaid MCO enrollment ledger - every state's reported plan enrollment observations, one view","domain":"state","stage":"semantic_view","status":"partial","grain":"One source-native reported enrollment observation from one of 87 state adapter branches; (source_table_fqn, source_observation_key) is unique (measured 2026-09-27, 2,895,719 rows = 2,895,719 distinct keys, Athena 44526aa8).","description":"A ledger, not a total. The union of every structured state Medicaid managed-care enrollment observation Vlada holds: 45 jurisdictions, 87 medicare_silver state tables, observation periods January 1996 to September 2026. Each row keeps the publisher's own cadence, measure name, unit, time basis, program, geography and plan label, its value status (reported, zero, suppressed, missing), its row role (detail component, publisher control, overlapping summary) and its file lineage. Plan and parent identities are the publisher's text; no canonical crosswalk is applied. v5 = v4 plus NC, OH, NH, NE, CO and PR monthly, AR and KS quarterly, and the new KY monthly table.","identity_key":"source_table_fqn,source_observation_key","row_count":2895719,"last_updated":"2026-09-26","freshness_sla":"State-adapter specific (monthly, quarterly, annual or one-off snapshot per state). The view reads the state tables live, so it is as fresh as each state's last accepted load; quote each state's newest observation_period with every result.","recollection":{"cadence":"monthly","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The view is a live union; it refreshes when any state adapter table reloads. cadence varies by state row (monthly, quarterly, annual, snapshot, quarterly_snapshot), so observation_period is the per-row watermark, not a national edition.","Adding or retiring a state adapter means a new view version (never overwrite a view); v5 was created 2026-09-26."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5 (created 2026-09-26 from #2806) over 87 medicare_silver state adapter tables; definition committed at pipelines/medicare/semantic/medicaid_mco_enrollment_tracker_reported_observation_v5.sql, built by ops/scripts/build_medicaid_mco_enrollment_tracker_reported_observation_v5.py. Validation: docs/data-tracker/states/LEDGER-V5.md (v4 EXCEPT v5 = 456 KY roster rows re-labelled monthly to snapshot, 0 with cadence masked). Every row carries source_url, sha256_content_hash, bronze_object_key and s3_version_id of the publisher file it came from. Contract: docs/architecture/2026-08-24-medicaid-mco-enrollment-tracker-contract.md on branch snapshot/main-checkout-uncommitted-2026-09-24.","known_gaps":["NOT A NATIONAL TOTAL. national_aggregation_authorized is false and aggregation_status is not_yet_reconciled on every row (measured 2026-09-27). Never sum across states, programs, geography levels, measures or benefit scopes; the contract's aggregation gate (additivity, suppression intervals, control match, printed coverage and lag, no annual-into-month interpolation) has not been passed for any state-period.","Units and cadences differ by state. value_unit is members on most rows but average_monthly_members (5,727 annual rows, 11 states), projected_average_monthly_members (26), members_factor_weighted (OH, 201 rows: ODM weights part months) or ytd_average_monthly_members (KS, 21 quarterly rows); 7,322 reported values are fractional. cadence is monthly (2,888,470 rows), annual (6,088), snapshot (796), quarterly_snapshot (324, OR) or quarterly (41: AR PASSE and KS). Pin one state, one cadence, one value_unit and one source_measure_name_raw before comparing numbers.","CO is Regional Accountable Entity ATTRIBUTION, not MCO enrollment: its monthly plan rows carry program_class pccm_entity_regional_accountable_entity (7,482 rows); a RAE is a regional PCCM organization. Never compare CO with other states' MCO enrollment.","Row roles overlap. row_role publisher_control (482,838 rows) is the publisher's own total and overlapping_summary (39,350 rows) re-counts detail rows; add only detail_component rows, and only within one state, measure and geography level. A plan appears at several geography levels in some states (FL region and state, TX service delivery area and state, WA service area and statewide, NY publisher geography and statewide).","row_role does not catch every publisher total: WA 'Total' (24,936 rows), FL *_TOTAL and 'Grand Total' labels (3,113), AZ 'HPs' Totals Per County' (483) and NJ 'Total' are detail_component rows with a total in plan_name_raw. Real plans also carry the word (Iowa Total Care, Absolute Total Care). Read a state's plan labels before summing it.","value_status matters. 933,838 rows are missing (932,039 of them MN cells the publisher left empty in the grown MN table), 33,128 suppressed and 5,679 not_reported_or_not_applicable (UT 5,536), all with a NULL reported_value; 471,270 are reported_zero. Never read a NULL as zero. 8 rows are publisher_row_sum_conflict_not_assessed and 3 publisher_overflow_unreadable. One reported_numeric row is negative (-0.046) as published.","Plan rows are plan_name_raw IS NOT NULL (2,363,820 of 2,895,719 rows). canonical_plan_id and canonical_parent_id are NULL on every row; parent rollups live in medicare_semantic.vw_medicaid_mco_parent_share_monthly, not here.","Coverage (measured 2026-09-27, Athena 902007c3): 40 of 45 jurisdictions have monthly plan-level rows; the newest such month runs from 2026-01 (DC) to 2026-09 (AZ, KY, MN, PR, VA, WV). Stale: AR 2020-12 (its newer plan rows are quarterly PASSE), GA 2022-05, NE 2024-02, IA 2026-03, TX 2026-05. DE, ID, KS, ND and VT have no monthly plan rows (KS publishes quarterly). AK, AL, CT, ME, MT, SD and WY are absent. Per-state table in the context doc.","KY: the new KY monthly table is preferred from 2021-02; 456 roster first-run rows for months the table covers are cadence snapshot, not monthly (nothing deleted).","Served inside get_medicaid_mco_enrollment's monthly_plans block (the state's latest monthly period, rows as published, never summed; a Regional Accountable Entity caveat for CO); every other read goes through query_substrate."],"notes":"Registered 2026-09-27 (Data Tracker states program, lane B) under register source w8 vlada_w8_national_medicaid_mco_enrollment_ledger as the served ledger; supersedes v3 and v4, which are retired and kept. status is partial because coverage is incomplete (5 jurisdictions without monthly plan rows, 7 absent, 5 stale) and no row is authorized for aggregation, so every raw read carries the status caveat. The underlying state tables stay uncatalogued: the view is the only door, and the guard parses only the table the SQL names.","superseded_by":null,"tools":[],"dataset_id":"vlada_w8_national_medicaid_mco_enrollment_ledger","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_observation_key","source_table_fqn"],"backing_store":"glue"},{"source_id":"national_medicaid_mco_enrollment_tracker_reported_observation_v4","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v4","title":"National Medicaid MCO enrollment ledger v4 (retired; superseded by v5)","domain":"state","stage":"semantic_view","status":"retired","grain":"One source-native reported enrollment observation; (source_table_fqn, source_observation_key) is unique.","description":"Ledger v4 (#2797): v3 with the KY and IN branches corrected (KY 2021-2026 roster read as monthly; IN keeps the workbook sheet so its county cells are not tripled) plus ten held tables v3 never read (OK SoonerSelect monthly, MN county, SC, UT, OR, TN, WI, DC, MS, RI breakdowns); 2,884,290 rows with 0 duplicate keys (query 28b82782). Retired 2026-09-27 in favour of v5; kept, never overwritten.","identity_key":"source_table_fqn,source_observation_key","row_count":2884290,"last_updated":"2026-09-26","freshness_sla":"Frozen as a definition; read v5.","recollection":{"cadence":"monthly","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Retired: read v5. observation_period is the per-row watermark."]},"raw_queryable_via":"Retired 2026-09-27 and kept: the Glue view medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v4 stays queryable in Athena until it is dropped, but query_substrate treats it as retired and points to medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5.","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v4 (created 2026-09-26 from #2797); definition pipelines/medicare/semantic/medicaid_mco_enrollment_tracker_reported_observation_v4.sql.","known_gaps":["Retired; every trap of the v5 card applies, and v5 is the served ledger."],"notes":"RETIRED 2026-09-27, superseded by v5 (never overwrite a view: a fix is a new version). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5 (created 2026-09-26: v4 plus NC, OH, NH, NE, CO, PR monthly, AR and KS quarterly and the new KY table; v4 EXCEPT v5 = 456 KY roster rows whose cadence moved from monthly to snapshot, 0 with cadence masked)","tools":[],"dataset_id":"vlada_w8_national_medicaid_mco_enrollment_ledger","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_observation_key","source_table_fqn"],"backing_store":"glue"},{"source_id":"national_medicaid_mco_enrollment_tracker_reported_observation_v3","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v3","title":"National Medicaid MCO enrollment ledger - every state's reported plan enrollment observations, one view","domain":"state","stage":"semantic_view","status":"retired","grain":"One source-native reported enrollment observation from one of 68 state adapter tables; (source_table_fqn, source_observation_key) is unique (measured 2026-09-25, 1,519,809 rows = 1,519,809 distinct keys, Athena 8bc14342).","description":"A ledger, not a total. The union of every structured state Medicaid managed-care enrollment observation Vlada holds: 45 jurisdictions, 68 medicare_silver state tables, observation periods January 2000 to September 2026. Each row keeps the publisher's own cadence, measure name, unit, time basis, program, geography and plan label, its value status (reported, zero, suppressed, missing), its row role (detail component, publisher control, overlapping summary) and its file lineage. Plan and parent identities are the publisher's text; no canonical crosswalk is applied. v3 = v2 plus the VA, GA, MD and NJ monthly plan blocks.","identity_key":"source_table_fqn,source_observation_key","row_count":1519809,"last_updated":"2026-09-24","freshness_sla":"State-adapter specific (monthly, annual, quarterly or one-off snapshot per state). The view reads the state tables live, so it is as fresh as each state's last accepted load; quote each state's newest observation_period with every result.","recollection":{"cadence":"monthly","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The view is a live union; it refreshes when any state adapter table reloads. cadence varies by state row (monthly, annual, snapshot, quarterly_snapshot), so observation_period is the per-row watermark, not a national edition.","Adding or retiring a state adapter means a new view version (never overwrite a view); v3 was created 2026-09-24."]},"raw_queryable_via":"Retired 2026-09-27 and kept: the Glue view medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v3 stays queryable in Athena until it is dropped, but query_substrate treats it as retired and points to medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5.","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v3 (created 2026-09-24) over 68 medicare_silver state adapter tables; definition committed at pipelines/medicare/semantic/medicaid_mco_enrollment_tracker_reported_observation_v3.sql (the live v2 definition plus four blocks from docs/data-tracker/states/REFRESH-2026-09-24-tracker-view-blocks.sql). Every row carries source_url, sha256_content_hash, bronze_object_key and s3_version_id of the publisher file it came from. Contract: docs/architecture/2026-08-24-medicaid-mco-enrollment-tracker-contract.md on branch snapshot/main-checkout-uncommitted-2026-09-24.","known_gaps":["NOT A NATIONAL TOTAL. national_aggregation_authorized is false and aggregation_status is not_yet_reconciled on every row (measured 2026-09-25). Never sum across states, programs, geography levels, measures or benefit scopes; the contract's aggregation gate (additivity, suppression intervals, control match, printed coverage and lag, no annual-into-month interpolation) has not been passed for any state-period.","Units and cadences differ by state. value_unit is members on most rows but average_monthly_members (5,727 annual rows, 11 states) or projected_average_monthly_members (26 rows) elsewhere, and 7,321 reported values are fractional; cadence is monthly, annual, snapshot or quarterly_snapshot. Pin one state, one cadence, one value_unit and one source_measure_name_raw before comparing numbers.","Row roles overlap. row_role publisher_control (105,377 rows) is the publisher's own total and overlapping_summary (14,859 rows) re-counts detail rows; add only detail_component rows, and only within one state, measure and geography level. A plan appears at several geography levels in some states (FL region and state, TX service delivery area and state, WA service area and statewide, NY publisher geography and statewide).","row_role does not catch every publisher total: WA 'Total' (24,936 rows), FL *_TOTAL and 'Grand Total' labels (3,068), AZ 'HPs' Totals Per County' (481) and NJ 'Total' (10) are detail_component rows with a total in plan_name_raw. Real plans also carry the word (Iowa Total Care, Absolute Total Care). Read a state's plan labels before summing it.","value_status matters. 33,119 suppressed and 9,719 missing rows carry a NULL reported_value, and 456,744 rows are reported_zero; never read a NULL as zero. 8 rows are publisher_row_sum_conflict_not_assessed (the publisher's row does not add up and was not assessed). One reported_numeric row is negative (-0.046) as published.","Plan rows are plan_name_raw IS NOT NULL (1,213,214 of 1,519,809 rows). canonical_plan_id and canonical_parent_id are NULL on every row, so plan and parent-organization rollups across states need a separate, reviewed crosswalk.","Coverage (measured 2026-09-25, Athena 74a7bebf): 33 of 45 jurisdictions have monthly plan-level rows; the newest such month runs from 2026-01 (DC) to 2026-09 (VA), except AR and KY (stop 2020-12) and GA (CMO flash report, 2009-01 to 2022-05). MD (DataPort, 2010-07 to 2026-08) and NJ (DMAHS HMO, to 2026-07) joined in v3. CO, DE, ID, KS, NC, ND, NE, NH, OH, OK, PR and VT have no monthly plan rows. AK, AL, CT, ME, MT, SD and WY are absent. Per-state table in the context doc.","Served inside get_medicaid_mco_enrollment's monthly_plans block (the state's latest month, rows as published, never summed); every other read goes through query_substrate."],"notes":"RETIRED 2026-09-27, superseded by v5 (never overwrite a view: a fix is a new version). Registered 2026-09-25 (Data Tracker states program, lane B) under register source w8 vlada_w8_national_medicaid_mco_enrollment_ledger; supersedes the v2 view, which is retired and kept. status is partial because coverage is incomplete (12 jurisdictions without monthly plan rows, 7 absent) and no row is authorized for aggregation, so every raw read carries the status caveat. The 68 underlying state tables stay uncatalogued: the view is the only door, and the guard parses only the table the SQL names.","superseded_by":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5 (the served ledger since 2026-09-27; v3 -> v4 -> v5, v4 corrected the KY and IN branches of v3 and added ten held tables; v5 adds nine states and re-labels 456 KY roster rows monthly to snapshot)","tools":[],"dataset_id":"vlada_w8_national_medicaid_mco_enrollment_ledger","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_observation_key","source_table_fqn"],"backing_store":"glue"},{"source_id":"national_medicaid_mco_enrollment_tracker_reported_observation_v2","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v2","title":"National Medicaid MCO enrollment ledger - every state's reported plan enrollment observations, one view","domain":"state","stage":"semantic_view","status":"retired","grain":"One source-native reported enrollment observation from one of 64 state adapter tables; (source_table_fqn, source_observation_key) is unique (measured 2026-09-24, 1,517,497 rows = 1,517,497 distinct keys, Athena eb762e94).","description":"A ledger, not a total. The union of every structured state Medicaid managed-care enrollment observation Vlada holds: 45 jurisdictions, 64 medicare_silver state tables, observation periods January 2000 to August 2026. Each row keeps the publisher's own cadence, measure name, unit, time basis, program, geography and plan label, its value status (reported, zero, suppressed, missing), its row role (detail component, publisher control, overlapping summary) and its file lineage. Plan and parent identities are the publisher's text; no canonical crosswalk is applied.","identity_key":"source_table_fqn,source_observation_key","row_count":1517497,"last_updated":"2026-08-31","freshness_sla":"State-adapter specific (monthly, annual, quarterly or one-off snapshot per state). The view reads the state tables live, so it is as fresh as each state's last accepted load; quote each state's newest observation_period with every result.","recollection":{"cadence":"monthly","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The view is a live union; it refreshes when any state adapter table reloads. cadence varies by state row (monthly, annual, snapshot, quarterly_snapshot), so observation_period is the per-row watermark, not a national edition.","Adding or retiring a state adapter means replacing the view definition; the Glue view was last replaced 2026-08-31."]},"raw_queryable_via":"Retired 2026-09-25 and kept: the Glue view medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v2 stays queryable in Athena until it is dropped, but query_substrate treats it as retired and points to medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v3. Every v2 row is also a v3 row.","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v2 (created 2026-08-24, last replaced 2026-08-31) over 64 medicare_silver state adapter tables; every row carries source_url, sha256_content_hash, bronze_object_key and s3_version_id of the publisher file it came from. Contract: docs/architecture/2026-08-24-medicaid-mco-enrollment-tracker-contract.md on branch snapshot/main-checkout-uncommitted-2026-09-24.","known_gaps":["NOT A NATIONAL TOTAL. national_aggregation_authorized is false and aggregation_status is not_yet_reconciled on every row (measured 2026-09-24). Never sum across states, programs, geography levels, measures or benefit scopes; the contract's aggregation gate (additivity, suppression intervals, control match, printed coverage and lag, no annual-into-month interpolation) has not been passed for any state-period.","Units and cadences differ by state. value_unit is members on most rows but average_monthly_members (5,727 annual rows, 11 states) or projected_average_monthly_members (26 rows) elsewhere, and 7,321 reported values are fractional; cadence is monthly, annual, snapshot or quarterly_snapshot. Pin one state, one cadence, one value_unit and one source_measure_name_raw before comparing numbers.","Row roles overlap. row_role publisher_control (105,377 rows) is the publisher's own total and overlapping_summary (14,859 rows) re-counts detail rows; add only detail_component rows, and only within one state, measure and geography level. A plan appears at several geography levels in some states (FL region and state, TX service delivery area and state, WA service area and statewide, NY publisher geography and statewide).","row_role does not catch every publisher total: WA 'Total' (24,936 rows), FL *_TOTAL and 'Grand Total' labels (3,068), AZ 'HPs' Totals Per County' (481) and NJ 'Total' (10) are detail_component rows with a total in plan_name_raw. Real plans also carry the word (Iowa Total Care, Absolute Total Care). Read a state's plan labels before summing it.","value_status matters. 33,119 suppressed and 9,719 missing rows carry a NULL reported_value, and 456,744 rows are reported_zero; never read a NULL as zero. One reported_numeric row is negative (-0.046) as published.","Plan rows are plan_name_raw IS NOT NULL (1,210,902 of 1,517,497 rows). canonical_plan_id and canonical_parent_id are NULL on every row, so plan and parent-organization rollups across states need a separate, reviewed crosswalk.","Coverage (measured 2026-09-24, Athena 2f351815): 29 of 45 jurisdictions have monthly plan-level rows; the newest such month runs from 2026-01 (DC) to 2026-08 (AZ, MN), except AR and KY, whose monthly plan rows stop at 2020-12. CO, DE, GA, ID, KS, MD, NC, ND, NE, NH, NJ, OH, OK, PR, VA and VT have no monthly plan rows (GA's plan rows are annual 2023-2025 and snapshots 2020-2023). AK, AL, CT, ME, MT, SD and WY are absent. Per-state table in the context doc.","Not yet admitted through a typed tool; get_medicaid_mco_enrollment serves the separate CMS annual report, not this ledger."],"notes":"RETIRED 2026-09-25, superseded by the v3 view (never overwrite a view: a fix is a new version). Registered 2026-09-24 (Data Tracker states program, lane B) as register source w8 vlada_w8_national_medicaid_mco_enrollment_ledger. status is partial because coverage is incomplete (16 jurisdictions without monthly plan rows, 7 absent) and no row is authorized for aggregation, so every raw read carries the status caveat. The 64 underlying state tables stay uncatalogued: the view is the only door, and the guard parses only the table the SQL names.","superseded_by":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v3 (created 2026-09-24: the v2 definition unchanged plus four state blocks, VA monthly control, GA CMO flash 2009-2022, MD DataPort 2010-07 to 2026-08, NJ DMAHS HMO 2022-01 to 2026-07; v2 EXCEPT v3 = 0 rows)","tools":[],"dataset_id":"vlada_w8_national_medicaid_mco_enrollment_ledger","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_observation_key","source_table_fqn"],"backing_store":"glue"},{"source_id":"vlada_medicaid_mco_parent_share_monthly","source_fqn":"medicare_semantic.vw_medicaid_mco_parent_share_monthly","title":"Medicaid managed care market share by parent company, monthly, per state (component sums, not totals)","domain":"state","stage":"semantic_view","status":"partial","grain":"One parent company (or the one unmapped bucket) x one state x one month x one measure segment; (state_code, observation_period, segment_id, parent) is unique (measured 2026-09-27 on the pointer, 28,970 rows = 28,970 keys over 38 states and 4,315 state-months, Athena 51578552). Every segment has exactly one measure and one geography level.","description":"One parent company's share of ONE state's reported comprehensive-medical managed-care plan enrollment in ONE month. parent_reported_value_sum adds the state's detail_component plan rows for one measure at one geography level from the Medicaid MCO enrollment ledger v5, comprehensive-medical programs only, publisher totals printed as plan rows removed, with plans resolved to parents through the effective-dated crosswalk medicare_silver.medicaid_plan_parent_crosswalk_v2. parent_share = parent_reported_value_sum / state_plan_row_sum within the state-month; unmapped_share is the share of plans with no ownership edge. CO rows are Regional Accountable Entity attribution, labelled by value_basis.","identity_key":"state_code,observation_period,segment_id,parent_id,is_unmapped_bucket","row_count":28970,"last_updated":"2026-09-27","freshness_sla":"A materialized snapshot. The pointer reads the current dated materialization (today medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z, built 2026-09-27 from the build view medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3); a newer ledger or crosswalk means a new dated table and the pointer re-aimed, never an overwrite. A state's newest month is the ledger's newest monthly plan month for that state (stale for GA, NE, TX).","recollection":{"cadence":"derived","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A pointer over dated materializations; a new ledger or crosswalk version means a new dated table and the pointer re-aimed, never an overwrite.","observation_period is the state's own reporting month; measurement dates differ by state (1st, 15th, month end, member-months)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_parent_share_monthly","commercial_terms":"Vlada-derived from public state Medicaid agency enrollment publications and public ownership evidence (SEC filings, state rosters).","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_parent_share_monthly = SELECT * FROM medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z (re-aimed 2026-09-26 22:20 ET), a CTAS parquet materialization of the build definition medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3, which reads medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v5 and medicare_silver.medicaid_plan_parent_crosswalk_v2 with the scope pipelines/medicare/data/medicaid_parent_share_state_scope_v3.yaml. Built and validated by ops/scripts/rebuild_parent_share_monthly.py (0 calendar months lost against the prior served table). Validation: docs/data-tracker/states/PARENT-SHARE-V3-VALIDATION.md.","known_gaps":["ONE STATE, ONE MONTH. A row is one parent's share of ONE state's reported comprehensive-medical plan enrollment in one month. NEVER sum across states into a national or multi-state total: states count on different days (1st, 15th, month end, member-months), use different measures and scopes, and some are years out of date. A parent's national Medicaid membership comes from its SEC filing, never from adding rows of this view.","value_basis is reported_component_value_sum on 28,434 rows (37 states) and regional_entity_attributed_caseload_sum on 536 CO rows; enrollment_total_authorized is false on every row (measured 2026-09-27, Athena 7b3dcc08). The sum is of the state's printed plan rows, not unduplicated people, until the state's component set passes the tracker contract's reconciliation and additivity controls.","CO is Regional Accountable Entity ATTRIBUTION, not MCO enrollment (value_basis regional_entity_attributed_caseload_sum, geography_level statewide (RAE)): its owners are Colorado Access, the CCHA joint venture (its own parent, not Elevance), UnitedHealth (Rocky Mountain Health Plans) and Northeast Health Partners. It never enters an MCO or SEC comparison.","AR and KS are NOT in this monthly view: their plan rows are quarterly (AR PASSE, KS year-to-date averages). Also absent: MA (plan labels are delivery models), DE, ID, ND, VT (no monthly plan rows) and AK, AL, CT, ME, MT, SD, WY (not in the ledger). 38 states are present.","Stale states: GA ends 2022-05, NE 2024-02 and TX has one month (2026-05); their latest share describes history. IA ends 2026-03 and DC 2026-01.","Wisconsin is 85.1% mapped in 2026-08 (unmapped_share 0.149): Network Health, GHC Eau Claire and Dean have no resolved 2026 owner. The other 37 states are 100% mapped at their latest month. Earlier months below 100% are in the unmapped bucket and never backcast (NE 2017-01..2020-12 WHP; PR before 2022-12).","SEC capture (Q2 2026 filings, states whose latest month on or before 2026-06-30 is in 2026): CNC 79%, ELV 73%, UNH 66%, MOH 81%, CVS 77%, HUM 91%. The gap is coverage and scope, not member loss: stale GA and NE, excluded duals, MLTSS and integrated products, CHIP only where a state reports it inside managed care, NC joint ventures not attributed to CNC or ELV, CO RAE attribution not counted, OH factor-weighted counts, and timing.","Ownership is effective-dated and never backcast: an acquired plan counts to its old owner until closing; the prime contractor gets the credit, not the administrator; joint ventures are their own parent. Excluded throughout: dental, pharmacy, NEMT, BH-only, PACE, PCCM, FFS, MLTSS-only and integrated dual programs (MyCare Ohio, PR Platino, NC EBCI Tribal Option and Medicaid Direct).","parent_share is NULL in 2 segments whose state_plan_row_sum is 0; everywhere else the shares of a state-month segment (unmapped bucket included) add to 1 (max deviation 3e-16, Athena 51440cc7)."],"notes":"THE SERVED ENTRY for Data Tracker KPI MCD-08 (lane B, register w8 vlada_w8_medicaid_mco_parent_share). A stable serving pointer over the current dated materialization; reads take about 1 s (Athena 51578552 1.1 s). Door RAW. status partial: 38 states, three stale, CO attribution, no state-period authorized as a total. Re-pointed 2026-09-26 from medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926 to medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926t2334z (build view v2) and then to medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z (build view v3).","superseded_by":null,"tools":[],"dataset_id":"vlada_w8_medicaid_mco_parent_share","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:segment_id","usps:state"],"entity_key_columns":{"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["is_unmapped_bucket","observation_period","parent_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_mco_parent_share_monthly_v20260927t0218z","source_fqn":"medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z","title":"Medicaid MCO parent share, monthly - materialization of 2026-09-27T02:18Z (current, read through the serving pointer)","domain":"state","stage":"mart","status":"partial","grain":"Same grain and columns as the build view it materializes; 28,970 rows, 38 states, 4,315 state-months.","description":"The CTAS parquet materialization of medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3 taken 2026-09-27T02:18Z. The current materialization: the pointer reads it. Adds NC, OH, NH, NE, PR and CO (RAE attribution) to v2 and reads the new KY table; the other 30 states equal the prior served table row for row (queries 057ff9bd, d873a213).","identity_key":"state_code,observation_period,segment_id,parent_id,is_unmapped_bucket","row_count":28970,"last_updated":"2026-09-27","freshness_sla":"Frozen at 2026-09-27T02:18Z; superseded by the next dated table, never rewritten.","recollection":{"cadence":"derived","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A dated, immutable materialization; the next build is a new _vYYYYMMDD table.","observation_period is the state's own reporting month, frozen as of this build."]},"raw_queryable_via":"Internal: attributed internal, so the customer door reads it only through the pointer medicare_semantic.vw_medicaid_mco_parent_share_monthly.","commercial_terms":"Vlada-derived from public state Medicaid agency enrollment publications and public ownership evidence (SEC filings, state rosters).","provenance_chain_ref":"CTAS of medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3 by ops/scripts/rebuild_parent_share_monthly.py; validated against the table it replaced (columns unchanged, 0 calendar months lost).","known_gaps":["Every trap of the pointer card applies; read the pointer, not this table."],"notes":"Registered 2026-09-27 (lane B) under register w8 vlada_w8_medicaid_mco_parent_share. Attributed internal so the pointer is the one door.","superseded_by":null,"tools":[],"dataset_id":"vlada_w8_medicaid_mco_parent_share","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:segment_id","usps:state"],"entity_key_columns":{"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["is_unmapped_bucket","observation_period","parent_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_mco_parent_share_monthly_v20260926t2334z","source_fqn":"medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926t2334z","title":"Medicaid MCO parent share, monthly - materialization of 2026-09-26T23:34Z (retired)","domain":"state","stage":"mart","status":"retired","grain":"Same grain and columns as the build view it materializes; 27,130 rows, 32 states, 3,863 state-months.","description":"The CTAS parquet materialization of medicare_semantic.vw_medicaid_mco_parent_share_monthly_v2 taken 2026-09-26T23:34Z. Served from 2026-09-26 23:34 until the pointer moved to the v3 build; adds IN 2021-2026, KY monthly and OK to v1.","identity_key":"state_code,observation_period,segment_id,parent_id,is_unmapped_bucket","row_count":27130,"last_updated":"2026-09-26","freshness_sla":"Frozen at 2026-09-26T23:34Z; superseded by the next dated table, never rewritten.","recollection":{"cadence":"derived","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A dated, immutable materialization; the next build is a new _vYYYYMMDD table.","observation_period is the state's own reporting month, frozen as of this build."]},"raw_queryable_via":"Retired and kept: queryable in Athena until dropped; the door answers it as retired and names medicare_semantic.vw_medicaid_mco_parent_share_monthly.","commercial_terms":"Vlada-derived from public state Medicaid agency enrollment publications and public ownership evidence (SEC filings, state rosters).","provenance_chain_ref":"CTAS of medicare_semantic.vw_medicaid_mco_parent_share_monthly_v2 by ops/scripts/rebuild_parent_share_monthly.py; validated against the table it replaced (columns unchanged, 0 calendar months lost).","known_gaps":["Every trap of the pointer card applies; read the pointer, not this table."],"notes":"Registered 2026-09-27 (lane B) under register w8 vlada_w8_medicaid_mco_parent_share. Attributed internal so the pointer is the one door.","superseded_by":"medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z (the current materialization, from build view medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3)","tools":[],"dataset_id":"vlada_w8_medicaid_mco_parent_share","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:segment_id","usps:state"],"entity_key_columns":{"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["is_unmapped_bucket","observation_period","parent_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_mco_parent_share_monthly_v20260926","source_fqn":"medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926","title":"Medicaid MCO parent share, monthly - materialization of 2026-09-26 (read through the serving pointer)","domain":"state","stage":"mart","status":"retired","grain":"Same grain and columns as the v1 view it materializes; 26,400 rows, 31 states, 3,717 state-months (2026-09-26).","description":"The CTAS parquet materialization of medicare_semantic.vw_medicaid_mco_parent_share_monthly_v1 taken 2026-09-26, the table behind the serving pointer medicare_semantic.vw_medicaid_mco_parent_share_monthly. It is the current materialization: callers read the pointer, which is re-aimed at the next dated table when the ledger or the crosswalk changes. Every trap of the pointer applies.","identity_key":"state_code,observation_period,segment_id,parent_id,is_unmapped_bucket","row_count":26400,"last_updated":"2026-09-26","freshness_sla":"Frozen at 2026-09-26; superseded by the next dated table, never rewritten.","recollection":{"cadence":"derived","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A dated, immutable materialization; the next build is a new _vYYYYMMDD table.","observation_period is the state's own reporting month, frozen as of the 2026-09-26 build."]},"raw_queryable_via":"Retired 2026-09-27 and kept: queryable in Athena until dropped; the door answers it as retired and names medicare_semantic.vw_medicaid_mco_parent_share_monthly.","commercial_terms":"Vlada-derived from public state Medicaid enrollment publications and public ownership evidence.","provenance_chain_ref":"CTAS of medicare_semantic.vw_medicaid_mco_parent_share_monthly_v1 to s3://vlada-platform-raw/medicare/silver/medicaid_mco_parent_share_monthly/v20260926/ (parquet); read-only test checksums identical to the view: g1 5C43F178769E021A, g2 C957A71C0807C9C4.","known_gaps":["A frozen snapshot of the view on 2026-09-26; a later ledger load or crosswalk change reaches callers only through a new dated table and the pointer re-aimed."],"notes":"RETIRED 2026-09-27: the pointer moved to later materializations. Registered 2026-09-26 (lane B) as the current materialization under register w8 vlada_w8_medicaid_mco_parent_share. Attributed internal so the pointer is the one door.","superseded_by":"medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z (the current materialization; via medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926t2334z)","tools":[],"dataset_id":"vlada_w8_medicaid_mco_parent_share","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:segment_id","usps:state"],"entity_key_columns":{"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["is_unmapped_bucket","observation_period","parent_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_mco_parent_share_monthly_v3","source_fqn":"medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3","title":"Medicaid MCO parent share, monthly - build definition v3 (current; not door-served)","domain":"state","stage":"semantic_view","status":"partial","grain":"One parent (or the unmapped bucket) x state x month x measure segment; 28,970 rows, 38 states, 4,315 state-months (the current materialization).","description":"The current build definition: v2's logic over ledger v5 with scope medicaid_parent_share_state_scope_v3.yaml and crosswalk medicare_silver.medicaid_plan_parent_crosswalk_v2. The dated materialization medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260927t0218z is built from it and the pointer medicare_semantic.vw_medicaid_mco_parent_share_monthly serves it.","identity_key":"state_code,observation_period,segment_id,parent_id,is_unmapped_bucket","row_count":28970,"last_updated":"2026-09-26","freshness_sla":"Live view; materialized on demand by ops/scripts/rebuild_parent_share_monthly.py (SOURCE_VIEW).","recollection":{"cadence":"derived","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A new ledger, scope or crosswalk version means a new build view version, never an overwrite.","observation_period is the state's own reporting month."]},"raw_queryable_via":"Internal: the build definition. Attributed internal, so the customer door does not read it (a view of this shape plans for tens of seconds); read medicare_semantic.vw_medicaid_mco_parent_share_monthly.","commercial_terms":"Vlada-derived from public state Medicaid agency enrollment publications and public ownership evidence (SEC filings, state rosters).","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3 (created 2026-09-26 from #2806); definition pipelines/medicare/semantic/medicaid_mco_parent_share_monthly_v3.sql. Validation: docs/data-tracker/states/PARENT-SHARE-V3-VALIDATION.md.","known_gaps":["Every trap of the pointer card applies."],"notes":"THE CURRENT BUILD DEFINITION (registered 2026-09-27, lane B), not the served entry. Kept registered because the materialization is built from it; queryable in Athena for rebuilds.","superseded_by":null,"tools":[],"dataset_id":"vlada_w8_medicaid_mco_parent_share","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:segment_id","usps:state"],"entity_key_columns":{"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["is_unmapped_bucket","observation_period","parent_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_mco_parent_share_monthly_v2","source_fqn":"medicare_semantic.vw_medicaid_mco_parent_share_monthly_v2","title":"Medicaid MCO parent share, monthly - build definition v2 (retired; superseded by v3)","domain":"state","stage":"semantic_view","status":"retired","grain":"One parent (or the unmapped bucket) x state x month x measure segment.","description":"Build definition v2 (#2797): v1's logic over ledger v4, adding IN 2021-2026, KY monthly and OK; 32 states. It reads live tables, so it returned 27,138 rows on 2026-09-27 (Athena 9ba42dd5) where its materialization of 2026-09-26 holds 27,130. Retired 2026-09-27; kept, never overwritten.","identity_key":"state_code,observation_period,segment_id,parent_id,is_unmapped_bucket","row_count":27138,"last_updated":"2026-09-26","freshness_sla":"Frozen as a definition; the current build definition is v3.","recollection":{"cadence":"derived","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Retired: observation_period is the per-row watermark; read the pointer."]},"raw_queryable_via":"Retired and kept (internal): queryable in Athena until dropped; read medicare_semantic.vw_medicaid_mco_parent_share_monthly.","commercial_terms":"Vlada-derived from public state Medicaid agency enrollment publications and public ownership evidence (SEC filings, state rosters).","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_parent_share_monthly_v2 (created 2026-09-26 from #2797); validation docs/data-tracker/states/PARENT-SHARE-V2-VALIDATION.md.","known_gaps":["Retired; read the pointer."],"notes":"RETIRED 2026-09-27 (never overwrite a view: a fix is a new version).","superseded_by":"medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3 (reads ledger v5 and crosswalk v2; adds NC, OH, NH, NE, PR, CO)","tools":[],"dataset_id":"vlada_w8_medicaid_mco_parent_share","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:segment_id","usps:state"],"entity_key_columns":{"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["is_unmapped_bucket","observation_period","parent_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_mco_parent_share_monthly_v1","source_fqn":"medicare_semantic.vw_medicaid_mco_parent_share_monthly_v1","title":"Medicaid managed care market share by parent company, monthly, per state (component sums, not totals)","domain":"state","stage":"semantic_view","status":"retired","grain":"One parent company (or the one unmapped bucket) x one state x one month x one measure segment; (state_code, observation_period, segment_id, parent) is unique (measured 2026-09-26, 26,400 rows = 26,400 keys over 31 states and 3,717 state-months, Athena 09b7cf3d). Every segment has exactly one measure and one geography level.","description":"One parent company's share of ONE state's reported comprehensive-medical managed-care plan enrollment in ONE month. parent_reported_value_sum adds the state's detail_component plan rows for one measure at one geography level from the Medicaid MCO enrollment ledger v3, comprehensive-medical programs only, publisher totals printed as plan rows removed, with plans resolved to parents through the effective-dated crosswalk medicare_silver.medicaid_plan_parent_crosswalk_v1. parent_share = parent_reported_value_sum / state_plan_row_sum within the state-month; unmapped_share is the share of plans with no ownership edge.","identity_key":"state_code,observation_period,segment_id,parent_id,is_unmapped_bucket","row_count":26400,"last_updated":"2026-09-26","freshness_sla":"Follows the ledger v3 and the crosswalk version; a state's newest month is the ledger's newest monthly plan month for that state (stale for GA, IN, KY). A crosswalk change is a new table version and a new view version, never an overwrite.","recollection":{"cadence":"derived","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A live view over the ledger v3 and a versioned crosswalk table; a new ledger version or crosswalk version means a new view version (_v2), never an overwrite.","observation_period is the state's own reporting month; measurement dates differ by state (1st, 15th, month end, member-months)."]},"raw_queryable_via":"Retired and kept (internal): the first build definition, queryable in Athena until dropped; read medicare_semantic.vw_medicaid_mco_parent_share_monthly.","commercial_terms":"Vlada-derived from public state Medicaid agency enrollment publications and public ownership evidence (SEC filings, state rosters).","provenance_chain_ref":"Glue VIRTUAL_VIEW medicare_semantic.vw_medicaid_mco_parent_share_monthly_v1 (created 2026-09-26 from #2789, ops/scripts/build_medicaid_parent_share_view_sql_v1.py) over medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v3 and medicare_silver.medicaid_plan_parent_crosswalk_v1 (CSV sha256 e22ba6da16d6..., content-addressed S3 prefix). Per-state scope choices: pipelines/medicare/data/medicaid_parent_share_state_scope_v1.yaml. Validation: docs/data-tracker/states/PARENT-SHARE-VALIDATION.md; read-only test checksums g1 5C43F178769E021A (15,949 rows) and g2 C957A71C0807C9C4 (10,451 rows).","known_gaps":["ONE STATE, ONE MONTH. A row is one parent's share of ONE state's reported comprehensive-medical plan enrollment in one month. NEVER sum across states into a national or multi-state total: states count on different days (1st, 15th, month end, member-months), use different measures and scopes, and three are years out of date. A parent's national Medicaid membership comes from its SEC filing, never from adding rows of this view.","value_basis is reported_component_value_sum on every row and enrollment_total_authorized is false on every row (measured 2026-09-26): the parent sum is a sum of the state's printed plan rows, not unduplicated people, until the state's component set passes the tracker contract's reconciliation and additivity controls. Five states (FL, AZ, TN, WA, PA) matched the publisher's printed total by hand; the other 26 have no recorded control match.","Stale states: the ledger's newest monthly plan month is 2022-05 for GA and 2020-12 for IN and KY, so their latest share describes history. IN from 2021 onward is excluded (the roster repeats Hoosier Healthwise county cells three times with identical keys). TX has one month (2026-05).","Wisconsin is 85.1% mapped in 2026-08 (unmapped_share 0.149): Network Health (43,831), GHC Eau Claire (41,934) and Dean (33,172) have no resolved 2026 owner and sit in the unmapped bucket. Every other state with a 2026 month is 100% mapped at its latest month.","SEC capture is 53-71% per public parent (Q2 2026: CNC 68%, ELV 60%, UNH 53%, MOH 71%, CVS 60%, HUM 58%). The gap is coverage and scope, not member loss: states missing or stale (GA, IN, KY, OH, KS, NE, OK, NH and others), duals, MLTSS and integrated products excluded by the comprehensive scope, CHIP counted only where the state reports it inside managed care, and timing and basis (CVS includes ASC lives; UNH counts people served).","Not in the view: MA (plan labels are delivery models); AR, CO, DE, ID, KS, NC, ND, NE, NH, OH, OK, PR, VT (no monthly plan rows); AK, AL, CT, ME, MT, SD, WY (not in the ledger). 31 states are present.","Ownership is effective-dated and never backcast: an acquired plan counts to its old owner until closing (WellCare before 2020-01-23, Aetna before 2018-11-28, AMERIGROUP before 2012-12-24); the prime contractor gets the credit, not the administrator; joint ventures are their own parent. Excluded throughout: dental, pharmacy, NEMT, BH-only, PACE, PCCM, FFS, MLTSS-only and integrated dual programs.","parent_share is NULL in 2 segments whose state_plan_row_sum is 0; everywhere else the shares of a state-month segment (unmapped bucket included) add to 1 (max deviation 3e-16, Athena 0fe528cc)."],"notes":"RETIRED 2026-09-27 as build definition, superseded by v3. THE BUILD DEFINITION, not the served entry (2026-09-26): medicare_semantic.vw_medicaid_mco_parent_share_monthly over the dated materialization medicare_silver.fact_medicaid_mco_parent_share_monthly_v20260926 serves KPI MCD-08. This view is kept registered because the materialization is built from it, and it stays queryable in Athena for rebuilds. Registered 2026-09-26 (Data Tracker states program, lane B) under register w8 vlada_w8_medicaid_mco_parent_share. Door RAW, Data Tracker KPI MCD-08. status partial: 31 states, three stale, no state-period authorized as a total. Versioned, never overwritten.","superseded_by":"medicare_semantic.vw_medicaid_mco_parent_share_monthly_v3 (the current build definition; v1 -> v2 -> v3)","tools":[],"dataset_id":"vlada_w8_medicaid_mco_parent_share","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:segment_id","usps:state"],"entity_key_columns":{"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["is_unmapped_bucket","observation_period","parent_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_plan_parent_crosswalk_v2","source_fqn":"medicare_silver.medicaid_plan_parent_crosswalk_v2","title":"Medicaid plan-to-parent ownership crosswalk v2 - effective-dated edges from state plan keys to parent companies (current)","domain":"state","stage":"reference","status":"partial","grain":"One effective-dated ownership edge; crosswalk_row_id is unique (measured 2026-09-27, 1,087 rows = 1,087 ids, 271 parents, 44 states, 761 open edges, Athena 9af791cf).","description":"The current crosswalk: v1's 1,066 edges byte for byte (the build refuses otherwise) plus 21 reviewed edges with evidence (pipelines/medicare/data/medicaid_plan_parent_crosswalk_extension_v2.yaml): the four NC LME/MCO Tailored Plans (each its own public parent), NC CFSP (Blue Cross NC), CO RAEs (Colorado Access, the CCHA joint venture as its own parent, Rocky Mountain Health Plans to UnitedHealth, Northeast Health Partners, Health Colorado, Denver Health), and NH 2019-09..2022-05 and NE 2017-01..2022-11 continuity of existing decisions.","identity_key":"crosswalk_row_id","row_count":1087,"last_updated":"2026-09-26","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_plan_parent_crosswalk_v2","provenance_chain_ref":"External CSV table medicare_silver.medicaid_plan_parent_crosswalk_v2 (created 2026-09-26 from #2806; DDL pipelines/medicare/silver/medicaid_plan_parent_crosswalk_v2.sql) at s3://vlada-platform-raw/medicare/silver/medicaid_plan_parent_crosswalk_v2/c3100b067f56/ (sha256 c3100b067f56543c6f64de430fe1be55e7a6c362fda715ef71beefb6c1a74cb4).","known_gaps":["EVERY COLUMN IS A STRING. effective_start and effective_end are text dates; an open edge has effective_end = '' (761 edges), not NULL. Cast dates and compare to '' explicitly; the parent-share views do the casting.","Join on key_type: an edge keys either source_plan_identity_id or plan_name_raw of the ledger, never both; match exactly and inside [effective_start, effective_end). No fuzzy edge exists and none may be inferred.","Left unmapped on purpose: NE 'WHP' (no plan identity, changed owner in 2020) and PR before 2022-12 (MMM and Triple-S changed owners and each needs a reviewed decision). The unmapped list is pipelines/medicare/data/medicaid_plan_parent_crosswalk_unmapped_v3.csv (24 keys, 4 live: WI's 3 HMOs and OR PacificSource Lane).","Ownership is never backcast: an acquired plan belongs to its old owner until the closing date; the prime contractor gets the credit, not the administrator; joint ventures are their own parent (NC Carolina Complete Health, CO CCHA); Anthem, Inc. and Elevance Health share one parent_id."],"notes":"Registered 2026-09-27 (Data Tracker states program, lane B) under register w8 vlada_w8_medicaid_plan_parent_crosswalk as the current crosswalk; v1 is retired and kept.","superseded_by":null,"tools":[],"dataset_id":"vlada_w8_medicaid_plan_parent_crosswalk","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["crosswalk_row_id"],"backing_store":"glue"},{"source_id":"vlada_medicaid_plan_parent_crosswalk_v1","source_fqn":"medicare_silver.medicaid_plan_parent_crosswalk_v1","title":"Medicaid plan-to-parent ownership crosswalk v1 - effective-dated edges from state plan keys to parent companies","domain":"state","stage":"reference","status":"retired","grain":"One effective-dated ownership edge; crosswalk_row_id is unique (measured 2026-09-26, 1,066 rows = 1,066 ids, 262 parents, 43 states, Athena aac8650a).","description":"The reviewed ownership edges that map a state Medicaid ledger plan key (key_type source_plan_identity_id or plan_name_raw) to its parent company over an effective date range. Measured 2026-09-26 (Athena 5d93fea0): 665 edges key source_plan_identity_id (621 exact reviewed aliases of the August identity decisions, 5 more also carrying the Anthem to Elevance registrant rename, and 39 Wisconsin HMO ownership intervals) and 401 key plan_name_raw (exact reviewed aliases onto ledger labels in CA, FL, NY, TX, PA, MN, NJ, MD); all 577 decisions are used. Every edge names its evidence method and source.","identity_key":"crosswalk_row_id","row_count":1066,"last_updated":"2026-09-26","raw_queryable_via":"Retired 2026-09-27 and kept: queryable in Athena until dropped; the door answers it as retired and names medicare_silver.medicaid_plan_parent_crosswalk_v2.","provenance_chain_ref":"External CSV table medicare_silver.medicaid_plan_parent_crosswalk_v1 (created 2026-09-26 from #2789; DDL pipelines/medicare/silver/medicaid_plan_parent_crosswalk_v1.sql) at s3://vlada-platform-raw/medicare/silver/medicaid_plan_parent_crosswalk_v1/e22ba6da16d6/ (CSV sha256 e22ba6da16d6...); repo copy pipelines/medicare/data/medicaid_plan_parent_crosswalk_v1.csv built by ops/scripts/build_medicaid_plan_parent_crosswalk_v1.py from the August identity decisions and pipelines/medicare/data/medicaid_plan_parent_crosswalk_aliases_v1.yaml.","known_gaps":["EVERY COLUMN IS A STRING. effective_start and effective_end are text dates; an open edge has effective_end = '' (752 edges), not NULL, and plan_name_raw is '' on edges keyed by source_plan_identity_id. Cast dates and compare to '' explicitly; the parent-share view does the casting.","Join on key_type: an edge keys either source_plan_identity_id or plan_name_raw of the ledger, never both; match exactly and inside [effective_start, effective_end). No fuzzy edge exists and none may be inferred.","Ownership is never backcast: an acquired plan belongs to its old owner until the closing date; the prime contractor gets the credit, not the administrator; joint ventures are their own parent; Anthem, Inc. and Elevance Health share one parent_id.","21 ledger plan keys have no edge (pipelines/medicare/data/medicaid_plan_parent_crosswalk_unmapped_v1.csv); 4 are live in their state's latest month (WI Network Health, GHC Eau Claire, Dean; OR PacificSource Lane)."],"notes":"RETIRED 2026-09-27, superseded by crosswalk v2. Registered 2026-09-26 (Data Tracker states program, lane B) under register w8 vlada_w8_medicaid_plan_parent_crosswalk as a derived reference source. The customer-facing surface is the parent-share view; this table is the evidence behind it.","superseded_by":"medicare_silver.medicaid_plan_parent_crosswalk_v2 (all 1,066 v1 edges byte for byte plus 21 reviewed edges)","tools":[],"dataset_id":"vlada_w8_medicaid_plan_parent_crosswalk","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["crosswalk_row_id"],"backing_store":"glue"},{"source_id":"medicaid_plan_quality_measure_v1","source_fqn":"medicare_semantic.vw_medicaid_plan_quality_measure_v1","title":"Medicaid managed-care plan quality (HEDIS) by plan, 15 states, the newest three measurement years each publishes","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per state x program x publisher plan name x measure x sub-measure x measurement year; (medicaid_plan_id, plan_product, indicator_code, measurement_year) is unique: 5,696 rows = 5,696 keys (Athena 0e9266f8, 3f142481).","description":"Ten fixed HEDIS measures (W30, WCV, CIS10, PPC_PRE, PPC_POST, CBP, HBA1C_LT8, BCS, FUH7, FUM7) by Medicaid managed-care plan for 15 states (TX NY CA FL PA OH IL MI NC GA WA NJ AZ VA KY), as each state and its EQRO publish them: the fact (medicare_silver.medicaid_plan_quality_measure_v1) LEFT JOIN the plan crosswalk, so every row carries the canonical medicaid_plan_id, plan_product, plan_display_name, program_class and parent_name. Plan names stay as printed. rate is 0-1; a cell the publisher prints without a rate (NA, N/A, NR, a dash, See footnote, blank) is a row with NULL rate and the marker in rate_raw, never a zero.","identity_key":"medicaid_plan_id,plan_product,indicator_code,measurement_year","row_count":5696,"last_updated":"2026-10-05","freshness_sla":"Annual per state (each state's EQRO technical report or quality workbook); a new state-year is a new load and a new table version, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"measurement_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'measurement_year' is the HEDIS measurement year of the row; each state publishes on its own clock, so the edition axes are state_code and measurement_year.","A new state-year or a re-parse is a new table version (_v2) and a new view version, never an overwrite."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_plan_quality_measure_v1 (pin state_code and measurement_year)","commercial_terms":"Public state Medicaid agency and EQRO publications.","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-05 from pipelines/medicare/semantic/vw_medicaid_plan_quality_measure_v1.sql over medicare_silver.medicaid_plan_quality_measure_v1 (parquet sha256 ceac3fb6..., loaded by ops/scripts/load_medicaid_plan_quality_v1.py from bronze medicare/bronze/medicaid_plan_quality_v1/4aa91481...zip) and medicare_silver.medicaid_plan_quality_plan_xwalk_v1. Every row carries document_url, sha256_content_hash and evidence_locator (the page or cell it was read from). Record docs/reference/source-audit/source-mastery/records/medicaid_plan_quality_measure.json (41 of 41 editions reconciled cell for cell against independent readers, 0 mismatches).","known_gaps":["KEY: medicaid_plan_id alone is NOT unique per indicator and year (693 (medicaid_plan_id, indicator_code, measurement_year) groups repeat: TX programs, GA GF 360, FL specialty plans, IL YouthCare). Key on (medicaid_plan_id, plan_product, indicator_code, measurement_year), unique on all 5,696 rows (Athena 3f142481, 42e28536), and never sum or average rates across products.","PIN STATE AND YEAR: each state publishes different years (AZ FL GA KY MI NC NJ NY PA TX VA WA MY2022-2024; IL MY2021-2023; CA MY2024; OH MY2023). 15 states only; there is no national total and rates are never comparable across states without reading data_source_raw (hybrid vs administrative vs ECDS).","Compare and trend on indicator_code; sub_measure_raw is the print and changes spelling between years. Some plan-years carry two rates of one measure (CIS10 + CIS10_ECDS, BCS + BCS_E, CBP + CBP_ADMIN, HBA1C_LT8 + HBA1C_LT8_ADMIN): choose one indicator_code.","HBA1C_LT8 era: NCQA renamed HBD to GSD for MY2024 and some reports relabel earlier years GSD; read measure_label_raw (HBD vs GSD) per state and year before trending.","rate NULL means the publisher printed no rate (532 rows; rate_raw says why); never treat it as 0. denominator is printed on 2,470 rows only.","Not the medicaid_quality_access document-page tables (those hold the report pages); this source holds the parsed rates."],"notes":"Registered 2026-10-05 (MCP product lane) from the coordinator register card in the record (Data Tracker program, PR 3111). Door RAW. status partial: 15 states, three measurement years each at most. Versioned, never overwritten.","superseded_by":null,"tools":[],"dataset_id":"medicaid_plan_quality_measure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["indicator_code","measurement_year","medicaid_plan_id","plan_product"],"backing_store":"glue"},{"source_id":"medicaid_plan_quality_measure_fact_v1","source_fqn":"medicare_silver.medicaid_plan_quality_measure_v1","title":"Medicaid managed-care plan quality (HEDIS) by plan, the parsed fact without the plan crosswalk","domain":"state","stage":"silver","status":"partial","grain":"One row per state x program x publisher plan name x measure x sub-measure x measurement year (5,696 rows, Athena a749fcd4).","description":"The parsed rates exactly as each state's report prints them (plan_name_raw, program_name_raw, measure_label_raw, sub_measure_raw, rate, rate_raw, rate_flags, denominator, data_source_raw, audited_flag) with lineage on every row. It carries no canonical plan id: read medicare_semantic.vw_medicaid_plan_quality_measure_v1, which joins the crosswalk.","identity_key":"state_code,program_name_raw,plan_name_raw,indicator_code,measurement_year","row_count":5696,"last_updated":"2026-10-05","freshness_sla":"Annual per state; a new load is a new table version, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"measurement_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'measurement_year' is the HEDIS measurement year of the row; edition axes state_code and measurement_year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_plan_quality_measure_v1 (pin state_code and measurement_year)","commercial_terms":"Public state Medicaid agency and EQRO publications.","provenance_chain_ref":"External parquet table at s3://vlada-platform-raw/medicare/silver/medicaid_plan_quality_measure_v1/a9899152.../ (created 2026-10-05 by ops/scripts/load_medicaid_plan_quality_v1.py --execute); row contract pipelines/medicare/medicaid_quality/common.py.","known_gaps":["No canonical plan id on this table; plan names are as printed and change between years. Join through medicare_silver.medicaid_plan_quality_plan_xwalk_v1, or read the view.","KEY: medicaid_plan_id alone is NOT unique per indicator and year (693 (medicaid_plan_id, indicator_code, measurement_year) groups repeat: TX programs, GA GF 360, FL specialty plans, IL YouthCare). Key on (medicaid_plan_id, plan_product, indicator_code, measurement_year), unique on all 5,696 rows (Athena 3f142481, 42e28536), and never sum or average rates across products."],"notes":"Registered 2026-10-05 with the view; the view is the customer surface, this table is its evidence.","superseded_by":null,"tools":[],"dataset_id":"medicaid_plan_quality_measure","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["indicator_code","measurement_year","plan_name_raw","program_name_raw"],"backing_store":"glue"},{"source_id":"medicaid_plan_quality_plan_xwalk_v1","source_fqn":"medicare_silver.medicaid_plan_quality_plan_xwalk_v1","title":"Medicaid plan quality plan-ID crosswalk v1 (publisher plan name to canonical Medicaid plan id)","domain":"state","stage":"reference","status":"partial","grain":"One row per (state_code, program_name_raw, plan_name_raw, measurement_year); 372 rows = 372 keys (Athena 6be006f0).","description":"Maps each plan name as a state printed it, per program and measurement year, to the canonical medicaid_plan_id + plan_product, with plan_display_name, program_class, parent_name, match_method (Q1_exact 212, Q2_reviewed 160) and basis (the publisher evidence for a reviewed decision). 157 printed plans resolve to 127 canonical plans; 372 of 372 plan-years resolved.","identity_key":"state_code,program_name_raw,plan_name_raw,measurement_year","row_count":372,"last_updated":"2026-10-05","freshness_sla":"Event-driven (a new state-year of plan names); a change is a new table version, never an overwrite.","recollection":{"cadence":"event_driven","watermark_field":"measurement_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'measurement_year' is the measurement year whose printed plan names the row maps.","Versioned by content hash: a changed crosswalk is a new parquet, a new S3 prefix and a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_plan_quality_plan_xwalk_v1","commercial_terms":"Vlada-derived from public state publications.","provenance_chain_ref":"External parquet table at s3://vlada-platform-raw/medicare/silver/medicaid_plan_quality_plan_xwalk_v1/c7cfff75.../ (parquet sha256 c7cfff75d5ea...), built by ops/scripts/build_medicaid_plan_quality_plan_xwalk_v1.py, repo copy pipelines/medicare/data/medicaid_plan_quality_plan_xwalk_v1.csv; decisions pipelines/medicare/data/medicaid_plan_quality_plan_decisions_v1.yaml.","known_gaps":["medicaid_plan_id is not unique per plan-year here either: one id can carry several plan_product values (TX programs, GA GF 360, FL specialty plans, IL YouthCare). Join on (state_code, program_name_raw, plan_name_raw, measurement_year)."],"notes":"Registered 2026-10-05 with the view as a derived reference source; the view is the customer surface.","superseded_by":null,"tools":[],"dataset_id":"medicaid_plan_quality_measure","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["measurement_year","plan_name_raw","program_name_raw"],"backing_store":"glue"},{"source_id":"medicaid_mcpar_plan_appeals_v1","source_fqn":"medicare_semantic.vw_medicaid_mcpar_plan_appeals_v1","title":"Medicaid plan appeals, State Fair Hearings, grievances and prior authorization by plan (CMS MCPAR, PY2023-2024)","domain":"state","stage":"semantic_view","status":"live","grain":"One row per performance_year x state x program x reporting period x plan name as the state printed it (plan_name_raw); 704 PY2023 + 676 PY2024 = 1,380 rows, grain unique (verifier view_grain_unique, Athena 2273b054; rows Athena 21a8eb55).","description":"Plan-level appeals (resolved, active, by outcome, reason and service, timeliness), State Fair Hearings, external medical review, grievances (resolved, active, by service and reason, timeliness) and prior-authorization metrics from the CMS Medicaid Managed Care Program Annual Report public use file, sections D1.IV and D1.XIII, pivoted from medicare_silver.medicaid_mcpar_puf_v1, with medicaid_plan_id, plan_display_name, program_class and parent_name from the plan crosswalk where it resolves (391 of 704 PY2023 rows, 374 of 676 PY2024). Values are the publisher's numbers; NULL means the response was not a number (N/A, NR) or the question was not on the form version the state filed, and indicators_* count which.","identity_key":"performance_year,state_code,program_name_raw,reporting_period_start,reporting_period_end,plan_name_raw","row_count":1380,"last_updated":"2026-10-06","freshness_sla":"Annual (one PUF per performance year; PY2025 expected around February to May 2027); a new edition or a publisher revision is a new table version and a new view version, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"performance_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'performance_year' is the MCPAR performance year (CMS README rule: the most recent calendar year overlapping the reporting period by at least six months).","A new edition or a publisher revision is a new table version (_v2) and a new view version, never an overwrite."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mcpar_plan_appeals_v1 (pin performance_year and state_code)","commercial_terms":"Public CMS data.","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-06 (Athena 8b4745de) from pipelines/medicare/semantic/vw_medicaid_mcpar_plan_appeals_v1.sql over medicare_silver.medicaid_mcpar_puf_v1 and medicare_silver.medicaid_mcpar_puf_plan_xwalk_v1 (cloud run 20261006T164926Z-a11b3da5, ops/scripts/load_medicaid_mcpar_puf_v1.py). Every row carries source_url and sha256_content_hash. Record docs/reference/source-audit/source-mastery/records/medicaid_mcpar_puf.json.","known_gaps":["FAIR HEARINGS FILED: fair_hearing_requests (D1.IV.8a) counts State Fair Hearing requests FILED during the year, not resolved, on the 2024-05 and 2025-01 forms (most reports); reports on the July 2025 form count them resolved. Appeals are counted RESOLVED (appeals_resolved) or ACTIVE at year end (appeals_active); there is no appeals-filed count except LTSS users.","N/A IS NOT ALWAYS \"NOT APPLICABLE\": on the PY2024 form N/A in the outcomes D1.IV.1a-c can mean the plan chose not to respond (the 2025-01 form said to enter N/A to skip them before June 2025; 758 PY2024 lines). Never read a NULL as 0.","OUTCOMES DO NOT ALWAYS SUM: appeals_denied_adverse + appeals_resolved_partially_favorable + appeals_resolved_favorable equals appeals_resolved on only 231 of the 400 PY2024 plan rows that report all four (Athena dadb5bdc); in PY2023 only 85 of 704 plan lines carry outcomes. Reason, service and grievance splits need not sum to totals either.","PRIOR AUTH IS NEARLY EMPTY: the pa_ columns (D1.XIII) are filled for only 2 PY2024 plan rows, both Arkansas dental plans, and none in PY2023 (Athena d7db8f3b). PY2025, the first year with real plan-level prior-authorization metrics, is expected around February to May 2027.","PENNSYLVANIA: a plan's total is the sum of its regional rows (plan_region LC/NE/NW/SE/SW); the statewide placeholder row never carries a plan id (plan_id_match_method refused_statewide_placeholder, 6 rows in PY2024) and never stands for the plan.","PLAN ID COVERAGE: about 46% of plan names have no canonical medicaid_plan_id (county mental and behavioral health entities, dental plans, PCCM programs); 392 of 718 PY2023 and 375 of 694 PY2024 plan names resolve. Group on plan_name_raw to keep every plan in a state total.","PROGRAM IS THE UNIT: a plan in several programs has one row per program (TX Superior HealthPlan: STAR, STAR+PLUS, STAR Kids); program names change between editions and carry dates."],"notes":"Registered 2026-10-06 (MCP product lane) under register w8 medicaid_mcpar_puf from the record's coordinator register card (Data Tracker, PR 3200). Door RAW; the view is the customer surface. Versioned, never overwritten.","superseded_by":null,"tools":[],"dataset_id":"medicaid_mcpar_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["performance_year","plan_name_raw","program_name_raw","reporting_period_end","reporting_period_start"],"backing_store":"glue"},{"source_id":"medicaid_mcpar_puf_v1","source_fqn":"medicare_silver.medicaid_mcpar_puf_v1","title":"Medicaid MCPAR public use file, every line of every state's Managed Care Program Annual Report (PY2023-2024)","domain":"state","stage":"silver","status":"live","grain":"One row per publisher data line (lossless): PY2023 170,365 + PY2024 177,973 = 348,338 rows, equal to CMS's DKAN counts (Athena 572443a9; verifier row_count f142d8f1). (performance_year, source_row_number) is unique (dup_key 051f3962).","description":"The MCPAR answers exactly as CMS publishes them: one line per state x program x reporting period x question x (measure number) x (plan or BSS entity) x response, across sections A (program), B (state), C1/C2 (program level), D1-D4 (plan level: enrollment, MLR, encounter data, appeals and grievances D1.IV, program integrity, prior authorization D1.XIII, quality measures, sanctions, ILOS) and E (BSS entities). response_raw is the print; response_status is number | not_applicable | optional_not_reported | not_reported | text; response_numeric only where the question is a number. Lineage on every row (source_url, sha256_content_hash, bronze_object_key, dataset_modified, parse_revision).","identity_key":"performance_year,source_row_number","row_count":348338,"last_updated":"2026-10-06","freshness_sla":"Annual (one PUF per performance year; PY2025 expected around February to May 2027); a new edition or a publisher revision is a new table version, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"performance_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'performance_year' is the MCPAR performance year; each edition is one pinned file (sha256 on every row).","PY2022 and earlier were never published as a PUF."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mcpar_puf_v1 (pin performance_year, state_code and question_id)","commercial_terms":"Public CMS data.","provenance_chain_ref":"External parquet table at s3://vlada-platform-raw/medicare/silver/medicaid_mcpar_puf_v1/7ccc99d4a56e.../ (created 2026-10-06, Athena d1d80514, cloud run 20261006T164926Z-a11b3da5 by ops/scripts/load_medicaid_mcpar_puf_v1.py) from bronze medicare/bronze/medicaid_mcpar_puf_v1/1b0aa22d.../mmcc-mcpar-puf-2023.csv and 74834826.../mmcc-mcpar-puf-2024.csv; row contract pipelines/medicare/medicaid_mcpar/puf.py. Every line of both editions reconciled from the bronze bytes by an independent reader (tools/data_tracker/reconcile_mcpar_puf.py; Athena 3c9fbed8, a3aa25b9, 5f21ded9, 279828d4).","known_gaps":["Compare years on question_id, never question_number_raw: CMS renumbered the form (D1.IV.7j in PY2023 = D1.IV.7o in PY2024 for other-service appeals) and the July 2025 form narrowed \"other\". Read medicare_silver.medicaid_mcpar_puf_question_v1 for what a question asked.","NULL response_numeric is not zero: N/A, NR, text, or (optional_not_reported) an N/A that on the 2025-01 form meant the plan chose not to respond to D1.IV.1a-c.","Multi-select answers are several lines under one key (response_seq 1..n); the PUF also repeats 36 (PY2023) and 28 (PY2024) lines verbatim, all kept. Never count lines as plans.","Pennsylvania prints each HealthChoices plan as a statewide placeholder line plus regional lines; the placeholder is 0 or N/A and never stands for the plan. Use the view, where it carries no plan id.","Contact names and emails of state staff (A.2-A.3) are in the public file; the view does not carry them."],"notes":"Registered 2026-10-06 with the view; the view is the customer surface for appeals, grievances and prior authorization, this table is the evidence and the door to every other MCPAR question.","superseded_by":null,"tools":[],"dataset_id":"medicaid_mcpar_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_row_number"],"unmapped_key_tokens":["performance_year"],"backing_store":"glue"},{"source_id":"medicaid_mcpar_puf_question_v1","source_fqn":"medicare_silver.medicaid_mcpar_puf_question_v1","title":"Medicaid MCPAR question dictionary (CMS MCPAR form template label, hint and type per question and edition)","domain":"state","stage":"reference","status":"live","grain":"One row per (performance_year, question_id, question_number_raw); PY2023 215 + PY2024 239 = 454 rows (Athena 4d11ad5e, f9118535).","description":"What each MCPAR question asked: template_label, template_hint and template_type from CMS's MCPAR form template (github.com/Enterprise-CMCS/macpro-mdct-mcr, pinned commits per form era, template_commit and template_url), with puf_rows and puf_plan_rows counting the lines in the PUF and definition_basis saying how the definition was matched (template label at the PUF number, number differs, derived, undocumented).","identity_key":"performance_year,question_id,question_number_raw","row_count":454,"last_updated":"2026-10-06","freshness_sla":"With each PUF edition; a change is a new table version, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"performance_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'performance_year' is the PUF edition whose questions the row documents."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mcpar_puf_question_v1","commercial_terms":"Public CMS form template.","provenance_chain_ref":"External parquet table at s3://vlada-platform-raw/medicare/silver/medicaid_mcpar_puf_question_v1/ba0afb09b78e.../ (created 2026-10-06, Athena 7541bcc7) built by ops/scripts/build_medicaid_mcpar_puf_dictionary_v1.py; repo copy pipelines/medicare/data/medicaid_mcpar_puf_question_v1.csv; templates held in bronze (mdct_mcpar_771f5129dab1.json, mdct_mcpar_ccae9e5f7827.json, mdct_mcpar_332ad0baaf8d.json).","known_gaps":["12 question ids are undocumented in the templates and 22 carry a template label whose number differs from the PUF number (definition_basis says which); read the basis before quoting a definition.","Question ids carry CMS typos, kept exact: plan_ltssUserFieldGrievances, plan_timyleResolvedGrievances."],"notes":"Registered 2026-10-06 with the view as a reference source; it explains the line table.","superseded_by":null,"tools":[],"dataset_id":"medicaid_mcpar_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["performance_year","question_id","question_number_raw"],"backing_store":"glue"},{"source_id":"medicaid_mcpar_puf_plan_xwalk_v1","source_fqn":"medicare_silver.medicaid_mcpar_puf_plan_xwalk_v1","title":"Medicaid MCPAR plan-ID crosswalk v1 (PUF plan name to canonical Medicaid plan id)","domain":"state","stage":"reference","status":"live","grain":"One row per (performance_year, state_code, program_name_raw, plan_or_bss_raw); PY2023 404 + PY2024 382 = 786 rows, one row per plan-year (verifier xwalk_one_row_per_plan_year, Athena 4cb24947; counts Athena d68fa1cb).","description":"Maps each plan name as the PUF prints it, per program and performance year, to the canonical medicaid_plan_id (mcd:<ST>:<slug>) with plan_region (Pennsylvania zones), plan_display_name, program_class, parent_name, match_method (Q1_exact 710, Q2_reviewed_region 56, Q2_reviewed 1, refused_statewide_placeholder 15, refused_reviewed 4; Athena 176d99d7) and basis. Names with no canonical plan are not in this table (they stay NULL in the view); refused rows carry no plan id.","identity_key":"performance_year,state_code,program_name_raw,plan_or_bss_raw","row_count":786,"last_updated":"2026-10-06","freshness_sla":"With each PUF edition; a change is a new table version, never an overwrite.","recollection":{"cadence":"annual","watermark_field":"performance_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'performance_year' is the PUF edition whose printed plan names the row maps.","Versioned by content hash: a changed crosswalk is a new parquet, a new S3 prefix and a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mcpar_puf_plan_xwalk_v1","commercial_terms":"Vlada-derived from public CMS data.","provenance_chain_ref":"External parquet table at s3://vlada-platform-raw/medicare/silver/medicaid_mcpar_puf_plan_xwalk_v1/7e83f70cd3c9.../ (created 2026-10-06, Athena 25672117) built by ops/scripts/build_medicaid_mcpar_puf_plan_xwalk_v1.py; repo copy pipelines/medicare/data/medicaid_mcpar_puf_plan_xwalk_v1.csv, decisions pipelines/medicare/data/medicaid_mcpar_puf_plan_decisions_v1.yaml, unresolved names pipelines/medicare/data/medicaid_mcpar_puf_plan_xwalk_unresolved_v1.csv.","known_gaps":["About 46% of PUF plan names have no canonical plan id (county mental and behavioral health entities, dental plans, PCCM programs) and are absent here: 392 of 718 PY2023 and 375 of 694 PY2024 plan names resolve.","Pennsylvania statewide placeholder names are refused (refused_statewide_placeholder, no plan id); their regional rows map with plan_region, and a plan's total is the sum of those rows.","One medicaid_plan_id can map from several printed names and programs; join on (performance_year, state_code, program_name_raw, plan_or_bss_raw)."],"notes":"Registered 2026-10-06 with the view as a derived reference source; the view is the customer surface.","superseded_by":null,"tools":[],"dataset_id":"medicaid_mcpar_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["performance_year","plan_or_bss_raw","program_name_raw"],"backing_store":"glue"},{"source_id":"medicaid_capitation_rate_cycle_v2","source_fqn":"medicare_silver.medicaid_capitation_rate_cycle_v2","title":"Medicaid managed care capitation rate cycle, every state (cross-state layer), rating periods 2018-2027","domain":"state","stage":"silver","status":"partial","grain":"One row per state_code x program_name_raw x rating_period_start x rating_period_end x amendment_seq; 347 rows in 44 jurisdictions (42 states, DC and PR), rating periods 2018-01-01 to 2027-09-30 (Athena 36a441e4); 0 duplicate keys (verify_tracker_loads --lane CAP, gates run 20261007T092022Z-92425b52).","description":"Capitation is the fixed per-member-per-month (PMPM) payment a state Medicaid agency pays each managed care organization (MCO) for every enrollee, priced by rate cell (population, eligibility category, age/sex band, region), set for a rating period and certified as actuarially sound by an actuary. This table holds the rate CYCLE: one row per state x program x rating period x amendment, with the cycle basis (calendar_year, state_fiscal_year, other), certification_date, actuary_firm, the overall rate change the document itself states (percent points, with its basis in rate_change_basis_raw, never computed by us) and the document_url, SHA-256 and page/line evidence_locator behind the row. The published rates themselves are medicare_silver.medicaid_capitation_rate_cell_v2. A Vlada cross-state layer read from 44 jurisdictions' own rate certifications, contract rate exhibits, rate schedules and CMS approval letters; for FL, NC, OH and CA it re-reads the same documents as the state's own table. v2 restates v1 whole with the served defects CAP-1..21 fixed (#3243).","identity_key":"state_code,program_name_raw,rating_period_start,rating_period_end,amendment_seq","row_count":347,"last_updated":"2026-10-07","freshness_sla":"Event-driven per state (each state certifies on its own clock, calendar year, state fiscal year or an October contract year, with mid-year amendments). A correction is restated into a new table version, never an overwrite.","recollection":{"cadence":"event_driven","watermark_field":"rating_period_start","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_period_start' is each state's own rating period; there is no edition coordinate across states.","A new rating period or amendment arrives as a new key (amendment_seq); a correction is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_capitation_rate_cycle_v2 (pin state_code and the rating period; take the highest amendment_seq)","commercial_terms":"Public state Medicaid agency publications.","provenance_chain_ref":"Restated 2026-10-07 by ops/scripts/load_medicaid_capitation_v1.py --all --execute --rebuild-unserved (cloud run 20261007T074248Z-32e04cea, code 32e04cea82; parquet sha256 20bc12f1...) from 439 bronze documents at s3://vlada-platform-raw/medicare/bronze/medicaid_capitation_v1/<sha256>/. Record docs/reference/source-audit/source-mastery/records/medicaid_capitation_v1.json (terminal_state complete_with_source_limit, acceptance_decision_2026_10_07): every cycle row re-read by independent readers (tools/data_tracker/reconcile_capitation.py), 42 of 44 jurisdictions PASS, period verdicts PASS 296 / UNCHECKED 49 / FAIL 2 (the two source limits below); cycle perturbation 0 passed; adversarial review PASS-WITH-FIXES, all six fixes applied (#3243 comments 6033122673, 6036229750); gates run 20261007T092022Z-92425b52, manifest docs/reference/source-audit/source-mastery/manifests/medicaid_capitation_v2_reconciliation_2026_10_07.json.","context_doc_path":"docs/context_library/medicaid/medicaid_capitation_v1.md","known_gaps":["NEVER COMPARE ACROSS STATES WITHOUT MATCHING THE BASIS: rating periods differ (calendar year in CA, IL, KS, MA ...; July state fiscal year in GA, IA, LA, MS ...; October-September in AZ, FL, MI, DC; OH and PA amendment windows), and a rating year is not a calendar year. overall_rate_change_pct_reported is measured on a different basis in each state (projected expenditure, weighted lower bound, composite PMPM): read rate_change_basis_raw before comparing. SC uses the INCLUDING ADD-ONS composite on every row.","CERTIFIED IS NOT EFFECTIVE: certification_date is when the actuary signed or dated the certification or rate letter; rates often apply retroactively (CA amendments a year or more later). A rating period is a sequence of versions (amendment_seq 0..n): take the highest per period, never sum across amendments. amendment_seq was renumbered in document order where versions overlapped (NC Standard Plan 2021-2022, NJ FamilyCare 2024 and 2025 H1, OH 2023 H2), so v2 seq can differ from v1. cms_approval_date is never populated.","SOURCE LIMIT, MA SCO 2026: Amendment 1A prints 'Base Capitation Rates effective January 1, 2026' and no posted document prints the end; the cycle row (and its 96 cells) carry a calendar-year end that is not printed.","SOURCE LIMIT, ND Medicaid Expansion CY2025: no posted document prints the rating period (the HHS notice prints only 'effective January 1, 2025'); the row says 'rating period end NOT PRINTED'.","UNCHECKED PERIODS: 49 of 347 rows carry an UNCHECKED period verdict (values reconciled; the reader cannot confirm the printed period because the document prints it only as a comparison or base period, or prints another period as often), including NC Standard Plan 2021-10-01..2022-06-30 seq 0, OH 2023-01-01..2023-12-31 seq 1 and PA Physical HealthChoices 2022-09-01..2022-12-31. overall_rate_change_pct_reported is UNCHECKED on 5 rows. Treat those fields as unverified on those rows.","MA ACPP and MCO 2023 are two cycle rows each, 2023-01-01..03-31 and 2023-04-01..12-31, as the documents print the rate years (Contract Year 6 = Rate Year Q1 2023; Rate Year 2023); never read them as one calendar year.","certification_date and actuary_firm are NULL where no posted document dates or names them (NH RY2025+, NJ, UT, VT, PR, NY, WA certifications not posted); firm spellings differ ('Mercer' vs 'Mercer Government Human Services Consulting'). NM, NY and WA are cycle-only because their rates are not public; 13 more jurisdictions have cycle rows and no cells.","NEVER COMBINE: for FL, NC, OH and CA this layer re-reads the same documents as the state's own table; never UNION it with them (see the cell card)."],"notes":"Register source medicaid_capitation_v1 (w8, serve raw), repointed to v2 on 2026-10-07 after Data Tracker accepted it (#3243, 0ee0a68568: \"ship it as partial\"). status partial: the two source limits above. Supersedes medicare_silver.medicaid_capitation_rate_cycle_v1, kept as the rollback.","superseded_by":null,"tools":[],"dataset_id":"medicaid_capitation_v1","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["amendment_seq","program_name_raw","rating_period_end","rating_period_start"],"backing_store":"glue"},{"source_id":"medicaid_capitation_rate_cell_v2","source_fqn":"medicare_silver.medicaid_capitation_rate_cell_v2","title":"Medicaid managed care capitation rates by rate cell, 28 jurisdictions (cross-state layer), PMPM, rating periods 2018-2027","domain":"state","stage":"silver","status":"partial","grain":"One row per published rate: the cycle key x plan_name_raw x rate_cell_raw x population_raw x region_raw x age_sex_raw x rate_kind x unit_raw; 53,651 rows in 28 jurisdictions, rating periods 2018-01-01 to 2027-09-30 (Athena d6771896); 0 duplicate keys (verify_tracker_loads --lane CAP, gates run 20261007T092022Z-92425b52).","description":"The capitation rates themselves: the per-member-per-month (PMPM) amount a state Medicaid agency pays its managed care organizations for an enrollee in each rate cell, as each state publishes it (rate certification exhibits, contract rate exhibits, rate schedules, the DHCS rate CSVs). rate_pmpm is dollars per member per month at the publisher's printed precision unless unit_raw says otherwise (kick payments are per event, e.g. per delivery). rate_kind separates final (contracted) rates from CA's actuarially sound ranges (lower_bound, midpoint, upper_bound), base rates before a named add-on or risk adjustment, and kick payments. plan, rate cell, population, region and age/sex are the publisher's own labels. Jurisdictions with cells: AZ CA DC FL GA IA ID IN LA MA MS NC NE NH NJ NV OH OK OR PA PR SC TX UT VA VT WI WV; CA is 29,409 of the rows. Every row cites document_url, SHA-256 and a page/line evidence_locator; join its cycle on (state_code, program_name_raw, rating_period_start, rating_period_end, amendment_seq), where a cell may carry a sub-period of its cycle. v2 restates v1 whole with the served defects CAP-1..21 fixed (#3243): FL budgetary rates dropped, TX, SC, WV, MA, PA, LA, MS, NJ, NH labels and values as printed.","identity_key":"state_code,program_name_raw,rating_period_start,rating_period_end,amendment_seq,plan_name_raw,rate_cell_raw,population_raw,region_raw,age_sex_raw,rate_kind,unit_raw","row_count":53651,"last_updated":"2026-10-07","freshness_sla":"Event-driven per state (each state certifies on its own clock); a correction is restated into a new table version, never an overwrite.","recollection":{"cadence":"event_driven","watermark_field":"rating_period_start","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_period_start' is each state's own rating period; there is no edition coordinate across states.","A new rating period or amendment arrives as a new key (amendment_seq); a correction is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_capitation_rate_cell_v2 (pin state_code, the rating period and rate_kind; take the highest amendment_seq per cell)","commercial_terms":"Public state Medicaid agency publications.","provenance_chain_ref":"Restated 2026-10-07 by ops/scripts/load_medicaid_capitation_v1.py --all --execute --rebuild-unserved (cloud run 20261007T074248Z-32e04cea; parquet sha256 c230bcdd...) from bronze s3://vlada-platform-raw/medicare/bronze/medicaid_capitation_v1/<sha256>/. Record docs/reference/source-audit/source-mastery/records/medicaid_capitation_v1.json (acceptance_decision_2026_10_07): every served cell re-read from the bronze bytes by independent readers that import nothing from pipelines (tools/data_tracker/reconcile_capitation.py): 53,651 of 53,651 placed by their labels and value-equal to the publisher, 53,555 period-equal (the 96 MA SCO 2026 cells are the source limit); cell perturbation 701,062 of 701,062 caught, 100% in all 28 jurisdictions; adversarial review PASS-WITH-FIXES, all six fixes applied (#3243 comments 6033122673, 6036229750); gates run 20261007T092022Z-92425b52, manifest docs/reference/source-audit/source-mastery/manifests/medicaid_capitation_v2_reconciliation_2026_10_07.json.","context_doc_path":"docs/context_library/medicaid/medicaid_capitation_v1.md","known_gaps":["NEVER COMPARE ACROSS STATES WITHOUT MATCHING RATE CELLS: rate_cell_raw, population_raw, region_raw and age_sex_raw are each state's own labels and compositions (FL regions 1-11 until January 31, 2025 and A-I from February 1, 2025 are different geographies; WI region_raw repeats the plan; VA population_raw is a rate-sheet block title; ID cells are MCO composites). No label is a cross-state key, populations and benefit packages differ by state, and the table has no plan id (plan_name_raw is the document's wording; MA SCO names one carrier both 'uhc' and 'unitedhealthcare').","ONE RATE KIND, ONE UNIT: final, lower_bound, upper_bound, midpoint, base and kick_payment are different numbers for the same cell; filter rate_kind and never average across it. 'final' is not one thing across states: gross or net of withholds (told apart by unit_raw), before or after risk adjustment, including or excluding add-ons and directed payments (SC 'final' includes add-ons, its 'base' excludes them; OK), excluding MCO tax (OR). CA serves rate ranges, never a paid rate. Utah SFY 2025 ACO cells carry two rows per cell (unit_raw '... less 2% withhold' and '... inclusion of 2% withhold'): pick one.","RATE YEARS ARE NOT CALENDAR YEARS, CERTIFIED IS NOT EFFECTIVE: each state's rating period is its own (calendar year, July or October fiscal year, amendment windows); a cell may carry a sub-period of its cycle (mid-year re-rates; MA SCO CY2023 cells carry their own Jan-Jun, Jul-Sep and Oct-Dec columns). MA ACPP and MCO 2023 are split 2023-01-01..03-31 and 2023-04-01..12-31. A rating period is a sequence of versions: take the highest amendment_seq per cell (an amendment restates only some cells; seq was renumbered in document order in NC, NJ and OH) and never sum across amendments.","SOURCE LIMIT, MA SCO 2026: 96 cells; 'effective January 1, 2026' is printed, the end date is printed in no posted document, so the served 2026-12-31 end is not the publisher's.","NEVER COMBINE WITH THE STATE TABLES: for FL, NC, OH and CA the values here come from the same documents as the state's own table (fact_fl_medicaid_managed_care_capitation_rate, nc_medicaid_standard_plan_base_rate_cell, oh_medicaid_capitation_rate_cell, fact_ca_medi_cal_managed_care_capitation_rate; re-verified by key and value on v1, Athena d8578211); TX, PA and TN share documents in part, and the evidence corpora (<st>_medicaid_procurement_contract_rate(s)_workbook_cell and _rate_cycle_evidence) hold the same documents. Never UNION or add this table with any of them: use this layer across states, the state table within one state.","COVERAGE: 28 of 44 jurisdictions with cycle rows have cells. Cycle-only: AR, DE, HI, IL, KS, KY, MD, MI, MN, MO, ND, RI, TN (no cells emitted; some publish no rate table) and NM, NY, WA (rates not public: NM confidential by contract, WA rate exhibits omitted from the posted contract, NY certifications not posted). AL, CO, CT, ME and MT have no comprehensive MCO program. A missing state or cell is not a zero rate."],"notes":"Register source medicaid_capitation_v1 (w8, serve raw), repointed to v2 on 2026-10-07 after Data Tracker accepted it (#3243, 0ee0a68568: \"ship it as partial\"). status partial: 28 jurisdictions with cells and the MA SCO 2026 source limit. Supersedes medicare_silver.medicaid_capitation_rate_cell_v1, kept as the rollback.","superseded_by":null,"tools":[],"dataset_id":"medicaid_capitation_v1","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["age_sex_raw","amendment_seq","plan_name_raw","population_raw","program_name_raw","rate_cell_raw","rate_kind","rating_period_end","rating_period_start","region_raw","unit_raw"],"backing_store":"glue"},{"source_id":"medicaid_capitation_rate_cycle_v1","source_fqn":"medicare_silver.medicaid_capitation_rate_cycle_v1","title":"Medicaid managed care capitation rate cycle, every state (cross-state layer v1), rating periods 2018-2027","domain":"state","stage":"silver","status":"partial","grain":"One row per state_code x program_name_raw x rating_period_start x rating_period_end x amendment_seq; 344 rows in 44 jurisdictions (42 states, DC and PR), rating periods 2018-01-01 to 2027-09-30, 0 duplicate keys (Athena c54592ae; key and lineage checks verify_tracker_loads --lane CAP, cloud run 20261007T004245Z-dedf4193).","description":"Capitation is the fixed per-member-per-month (PMPM) payment a state Medicaid agency pays each managed care organization (MCO) for every enrollee, priced by rate cell (population, eligibility category, age/sex band, region), set for a rating period and certified as actuarially sound by an actuary. This table holds the rate CYCLE: one row per state x program x rating period x amendment, with the cycle basis (calendar_year, state_fiscal_year, other), certification_date, actuary_firm, the overall rate change the document itself states (percent points, with its basis in rate_change_basis_raw, never computed by us) and the document_url, SHA-256 and page/line evidence_locator behind the row. The published rates themselves are medicare_silver.medicaid_capitation_rate_cell_v1. A Vlada cross-state layer read from 44 jurisdictions' own rate certifications, contract rate exhibits and rate schedules; for FL, NC, OH and CA it re-reads the same documents as the state's own table.","identity_key":"state_code,program_name_raw,rating_period_start,rating_period_end,amendment_seq","row_count":344,"last_updated":"2026-10-06","freshness_sla":"Event-driven per state (each state certifies on its own clock, calendar year, state fiscal year or an October contract year, with mid-year amendments). Append-only; a revised value arrives as a new amendment_seq, never an overwrite.","recollection":{"cadence":"event_driven","watermark_field":"rating_period_start","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_period_start' is each state's own rating period; there is no edition coordinate across states.","A new rating period or amendment is appended as a new key (amendment_seq); a held key is never rewritten."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_capitation_rate_cycle_v1 (pin state_code and the rating period; take the highest amendment_seq)","commercial_terms":"Public state Medicaid agency publications.","provenance_chain_ref":"Loaded by ops/scripts/load_medicaid_capitation_v1.py (state modules pipelines/medicare/medicaid_capitation/states/<st>.py, schema pipelines/medicare/medicaid_capitation/schema.py) from bronze s3://vlada-platform-raw/medicare/bronze/medicaid_capitation_v1/<sha256>/; 2026-09-29/30 (284 cycles, 36 states) plus the gap states NY NJ WA NM UT NH PR VT (#3092). Record docs/reference/source-audit/source-mastery/records/medicaid_capitation_v1.json (#3108): field dictionary; every cycle row re-read by independent readers (tools/data_tracker/reconcile_capitation.py, cloud run 20261007T002425Z-7b22e8ce, manifest docs/reference/source-audit/source-mastery/manifests/medicaid_capitation_v1_reconciliation_2026_10_06.json); cycle perturbation suite 3,872 mutations, 3,663 caught and 209 flagged UNCHECKED, 0 passed. Per-state landing pages docs/data-tracker/states/CAPITATION-A-M.md and CAPITATION-N-W.md.","context_doc_path":"docs/context_library/medicaid/medicaid_capitation_v1.md","known_gaps":["NEVER COMPARE ACROSS STATES WITHOUT MATCHING THE BASIS: rating periods differ (calendar year in CA, IL, KS, MA ...; July state fiscal year in GA, IA, LA, MS ...; October-September in AZ, FL, MI, DC; OH and PA amendment windows), and a rating year is not a calendar year. overall_rate_change_pct_reported is measured on a different basis in each state (projected expenditure, weighted lower bound, composite PMPM): read rate_change_basis_raw before comparing.","CERTIFIED IS NOT EFFECTIVE: certification_date is when the actuary signed or dated the certification or rate letter; rates often apply retroactively (CA amendments a year or more later). A rating period is a sequence of versions (amendment_seq 0..n): take the highest per period, never sum across amendments. cms_approval_date is never populated (0 of 344).","UNCHECKED FIELDS (perturbation suite: 209 of 3,872 mutations flagged UNCHECKED, never counted as equal): 53 rows that fail nothing carry a field the cited document prints but does not single out: rating_period_start / rating_period_end on 46 rows (printed only as a comparison or base period, or another period printed as often), certification_date on 15 and overall_rate_change_pct_reported on 3. Treat those fields as unverified on those rows.","DEFECTS IN THIS v1 TABLE (record served_defects; fixed in v2 by #3243): 17 rows fail a field: 12 periods the cited document does not print (CAP-11 TX STAR+PLUS 2023-09 amendment 2 is an FY2022 letter; CAP-12 FL, KY, MA, MO, NC, ND, OH, PA), 3 actuary firms the document does not name as certifying (CAP-20 MS, WA) and 2 overall changes read from a companion workbook the row does not cite (CAP-21 GA, IA).","certification_date is NULL on 152 of 344 rows and actuary_firm on 138 (no posted document dates or names it); firm spellings differ ('Mercer' vs 'Mercer Government Human Services Consulting'). NM, NY and WA are cycle-only because their rates are not public; 13 more jurisdictions have cycle rows and no cells.","NEVER COMBINE: for FL, NC, OH and CA this layer re-reads the same documents as the state's own table; never UNION it with them (see the cell card)."],"notes":"ROLLBACK ONLY. Superseded 2026-10-07 by medicare_silver.medicaid_capitation_rate_cycle_v2 when register source medicaid_capitation_v1 (w8) was repointed to v2 (#3243 accepted by Data Tracker); listed in that register source only as the rollback. The v1 cycle reconciliation passed 31 of 44 jurisdictions (#3108). Versioned (_v1), append-only, frozen.","superseded_by":"medicare_silver.medicaid_capitation_rate_cycle_v2 (restated whole 2026-10-07, #3243, with the served defects CAP-1..21 fixed; 347 rows). This v1 table carries those defects (periods the cited document does not print, actuary firms not named as certifying, changes from an uncited workbook). Kept frozen as the rollback; never read it beside v2.","tools":[],"dataset_id":"medicaid_capitation_v1","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["amendment_seq","program_name_raw","rating_period_end","rating_period_start"],"backing_store":"glue"},{"source_id":"medicaid_capitation_rate_cell_v1","source_fqn":"medicare_silver.medicaid_capitation_rate_cell_v1","title":"Medicaid managed care capitation rates by rate cell, 28 jurisdictions (cross-state layer v1), PMPM, rating periods 2018-2027","domain":"state","stage":"silver","status":"partial","grain":"One row per published rate: the cycle key x plan_name_raw x rate_cell_raw x population_raw x region_raw x age_sex_raw x rate_kind x unit_raw; 54,981 rows in 28 jurisdictions, rating periods 2018-01-01 to 2027-09-30, 0 duplicate keys, 0 NULL rate_pmpm (Athena c54592ae; key and lineage checks verify_tracker_loads --lane CAP, cloud run 20261007T004245Z-dedf4193).","description":"The capitation rates themselves: the per-member-per-month (PMPM) amount a state Medicaid agency pays its managed care organizations for an enrollee in each rate cell, as each state publishes it (rate certification exhibits, contract rate exhibits, rate schedules, the DHCS rate CSVs). rate_pmpm is dollars per member per month at the publisher's printed precision unless unit_raw says otherwise (kick payments are per event, e.g. per delivery). rate_kind separates final (contracted) rates from CA's actuarially sound ranges (lower_bound, midpoint, upper_bound), base rates before a named add-on or risk adjustment, and kick payments. plan, rate cell, population, region and age/sex are the publisher's own labels. Jurisdictions with cells: AZ CA DC FL GA IA ID IN LA MA MS NC NE NH NJ NV OH OK OR PA PR SC TX UT VA VT WI WV; CA is 29,409 of the rows. Every row cites document_url, SHA-256 and a page/line evidence_locator; join its cycle on (state_code, program_name_raw, rating_period_start, rating_period_end, amendment_seq), where a cell may carry a sub-period of its cycle.","identity_key":"state_code,program_name_raw,rating_period_start,rating_period_end,amendment_seq,plan_name_raw,rate_cell_raw,population_raw,region_raw,age_sex_raw,rate_kind,unit_raw","row_count":54981,"last_updated":"2026-10-06","freshness_sla":"Event-driven per state (each state certifies on its own clock); append-only, a revised value arrives as a new amendment_seq, never an overwrite.","recollection":{"cadence":"event_driven","watermark_field":"rating_period_start","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'rating_period_start' is each state's own rating period; there is no edition coordinate across states.","A new rating period or amendment is appended as a new key (amendment_seq); a held key is never rewritten."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_capitation_rate_cell_v1 (pin state_code, the rating period and rate_kind; take the highest amendment_seq per cell)","commercial_terms":"Public state Medicaid agency publications.","provenance_chain_ref":"Loaded by ops/scripts/load_medicaid_capitation_v1.py (state modules pipelines/medicare/medicaid_capitation/states/<st>.py) from bronze s3://vlada-platform-raw/medicare/bronze/medicaid_capitation_v1/<sha256>/. Record docs/reference/source-audit/source-mastery/records/medicaid_capitation_v1.json (#3108): field dictionary with each state's own wording per column; every served cell re-read from the bronze bytes by independent readers that import nothing from pipelines (tools/data_tracker/reconcile_capitation.py, cloud run 20261007T002425Z-7b22e8ce): 52,802 of 54,981 placed by their labels, 52,776 value-equal; cell perturbation suite 689,266 of 689,266 mutations caught in all 28 jurisdictions (cloud run 20261006T232027Z-02a88649). Duplicates re-verified by key and value: FL 5,833, NC 492, OH 2,352, CA 29,409 (Athena d8578211).","context_doc_path":"docs/context_library/medicaid/medicaid_capitation_v1.md","known_gaps":["NEVER COMPARE ACROSS STATES WITHOUT MATCHING RATE CELLS: rate_cell_raw, population_raw, region_raw and age_sex_raw are each state's own labels and compositions (FL regions 1-11 until January 31, 2025 and A-I from February 1, 2025 are different geographies; WI region_raw repeats the plan; VA population_raw is a rate-sheet block title; ID cells are MCO composites). No label is a cross-state key, populations and benefit packages differ by state, and the table has no plan id (plan_name_raw is the document's wording).","ONE RATE KIND, ONE UNIT: final, lower_bound, upper_bound, midpoint, base and kick_payment are different numbers for the same cell; filter rate_kind and never average across it. 'final' is not one thing across states: gross or net of withholds (FL and IA serve both, told apart by unit_raw), before or after risk adjustment, including or excluding add-ons and directed payments (SC, OK), excluding MCO tax (OR). CA serves rate ranges, never a paid rate. Utah SFY 2025 ACO cells carry two rows per cell (unit_raw '... less 2% withhold' and '... inclusion of 2% withhold'): pick one.","RATE YEARS ARE NOT CALENDAR YEARS, CERTIFIED IS NOT EFFECTIVE: each state's rating period is its own (calendar year, July or October fiscal year, amendment windows); a cell may carry a sub-period of its cycle (mid-year re-rates). A rating period is a sequence of versions: take the highest amendment_seq per cell (an amendment restates only some cells) and never sum across amendments. Derived periods: 1,470 OH cells end at the last half-year label and 60 NC windows are cut by later amendments, derived from the publisher's own series.","DEFECTS IN THIS v1 TABLE (record served_defects; fixed in v2 by #3243; the v1 reconciliation passes 18 of 28 jurisdictions): 1,707 FL MMA cells (1,694 rate_kind final) are page-1 budgetary rates 'not used for payments' (CAP-13); TX STAR FY2023 Molina Harris Under Age 1 serves 42.65 for 1,042.65 (CAP-1); 25 SC 'final' cells hold the excluding-add-ons values (CAP-9); 15 WV composite rows served as rate cells (CAP-2); MA: 10 garbled ACPP labels, 78 truncated SCO labels, 102 SCO CY2023 cells serving the Jan-Jun column for the whole year, 120 plan names that are link text, 96 inferred 2026 end dates, 150 partner ACO names collapsed (CAP-3..6, -16, -17); 28 PA cells are allowances or lost their zone (CAP-7/8); 60 LA kick rows served as pmpm (CAP-15); 464 FL 'Child W elfare' label splits (CAP-14); 1 MS, 5 NJ and 5 NH labels not as the cited copy prints them (CAP-10, -18, -19). Read v2.","NEVER COMBINE WITH THE STATE TABLES: for FL, NC, OH and CA every value here is already in the state's own table (fact_fl_medicaid_managed_care_capitation_rate, nc_medicaid_standard_plan_base_rate_cell, oh_medicaid_capitation_rate_cell, fact_ca_medi_cal_managed_care_capitation_rate); TX, PA and TN share documents in part, and the evidence corpora (<st>_medicaid_procurement_contract_rate(s)_workbook_cell and _rate_cycle_evidence) hold the same documents. Never UNION or add this table with any of them: use v1 across states, the state table within one state.","COVERAGE: 28 of 44 jurisdictions with cycle rows have cells. Cycle-only: AR, DE, HI, IL, KS, KY, MD, MI, MN, MO, ND, RI, TN (no cells emitted; some publish no rate table) and NM, NY, WA (rates not public: NM confidential by contract, WA rate exhibits omitted from the posted contract, NY certifications not posted). AL, CO, CT, ME and MT have no comprehensive MCO program. A missing state or cell is not a zero rate."],"notes":"ROLLBACK ONLY. Superseded 2026-10-07 by medicare_silver.medicaid_capitation_rate_cell_v2 when register source medicaid_capitation_v1 (w8) was repointed to v2 (#3243 accepted by Data Tracker); listed in that register source only as the rollback. Versioned (_v1), append-only, frozen.","superseded_by":"medicare_silver.medicaid_capitation_rate_cell_v2 (restated whole 2026-10-07, #3243, with the served defects CAP-1..21 fixed; 53,651 cells, every one placed and value-equal to the publisher). This v1 table carries those defects (FL budgetary rates served as final, a wrong TX value, SC add-on groups swapped, MA/PA/WV/LA labels). Kept frozen as the rollback; never read it beside v2.","tools":[],"dataset_id":"medicaid_capitation_v1","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["age_sex_raw","amendment_seq","plan_name_raw","population_raw","program_name_raw","rate_cell_raw","rate_kind","rating_period_end","rating_period_start","region_raw","unit_raw"],"backing_store":"glue"},{"source_id":"ca_calaim_1915b_source_occurrence","source_fqn":"medicare_silver.ca_calaim_1915b_source_occurrence","title":"California CalAIM 1915(b) official source occurrences","domain":"state","stage":"silver","status":"live","grain":"One row per frozen corpus snapshot and official DHCS source occurrence, including acquired aliases, proposed non-operative material, and exact source-limit occurrences.","description":"Production-reconciled and exact-replay-idempotent lossless occurrence ledger for the CalAIM CA-0017.R10 authority chain. It preserves source-native role and authority status; distinct publisher, submission, approval, waiver-effective, implementation, table-as-of, and acquisition dates; official and acquisition URLs; exact content identity; alias ordinals; proposal and acquisition flags; raw manifest JSON; and Bronze lineage without inferring an operative program roster.","identity_key":"corpus_snapshot_date,occurrence_id","row_count":27,"last_updated":"2026-08-01","freshness_sla":"Event-driven when DHCS or CMS publishes a new submission, approval, technical correction, renewal item, or correction to the official index.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate the official DHCS indexes, pin exact bytes and source limits, retain proposal status and every independent date axis, and never select current authority from artifact date alone.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_calaim_1915b_source_occurrence","commercial_terms":"Public California DHCS and CMS waiver-authority documents.","known_gaps":["Production contains 27 reconciled occurrence rows at Iceberg snapshot 5933192372329332196; exact-bundle replay returned IDEMPOTENT_SKIP and preserved this snapshot. Hosted MCP data proof remains a separate post-merge rung.","The R10.02 MCMC/Dental MC cost-effectiveness workbook occurrence `appr2024_ce_mcmc` is an exact source-limit sentinel: `is_acquired=false`, payload/hash fields remain null, and `source_limit_reason` remains populated; it must not disappear or acquire invented bytes.","The 2026 renewal summary and tribal notice occurrences are `proposed_nonoperative`; proposal appearance is not operative federal authority and these rows must never enter an operative-current selection.","`authority_status`, source role, and the separate date axes must be filtered explicitly. A newer artifact date does not supersede section-level inherited language or an embedded older table-as-of date.","This source establishes document evidence for one CalAIM 1915(b) chain, not observed enrollment, executed contracts, provider networks, capitation rates, paid claims, or a complete California authority roster.","The R09-and-earlier SMHS 1915(b) chain is a separate required source; completing this table does not close `program_delivery_roster` or `spa_waiver_authority`."],"notes":"Production schema columns are corpus_snapshot_date, occurrence_id, action_id, role, authority_status, artifact_date, publisher_occurrence_date, state_submission_date, cms_approval_date, waiver_effective_start/end, provision_implementation_start/end, table_as_of_date, effective_text, file_type, publisher_filename, official_url, acquisition_url, byte_count, document_sha256, expected_page_count, parse_disposition, source_limit_reason, content_occurrence_count/ordinal, is_content_alias, is_proposed_nonoperative, is_acquired, manifest_sha256, raw_occurrence_json, semantic_row_sha256, plus the M-2 lineage envelope. Production reconciliation, unchanged-snapshot replay, query promotion, and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_calaim_1915b_waiver_authority","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["corpus_snapshot_date","occurrence_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_calaim_1915b_pdf_page","source_fqn":"medicare_silver.ca_calaim_1915b_pdf_page","title":"California CalAIM 1915(b) physical PDF-page evidence","domain":"state","stage":"silver","status":"live","grain":"One physical PDF page per exact document SHA-256 and one-based page number, with content-identical publisher occurrences represented once and linked through a canonical occurrence.","description":"Production-reconciled and exact-replay-idempotent lossless page layer for acquired CalAIM 1915(b) PDFs, preserving layout-aware extracted text, page-text hash, word count, extraction method, quality flags, exact document identity, content-alias count, semantic-row hash, and Bronze lineage. It is citation evidence, not an operative-rule or structured program fact table.","identity_key":"document_sha256,page_number","row_count":2839,"last_updated":"2026-08-01","freshness_sla":"Event-driven with each accepted CalAIM 1915(b) corpus update or exact-byte publisher correction.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Reparse only exact accepted PDF bytes, retain page and text hashes, treat analytics eligibility as extraction fitness rather than authority, and resolve proposed status through the occurrence ledger.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_calaim_1915b_pdf_page","commercial_terms":"Public California DHCS and CMS waiver-authority documents.","known_gaps":["Production contains 2,839 reconciled physical-page rows at Iceberg snapshot 8750292831544832998; exact-bundle replay returned IDEMPOTENT_SKIP and preserved this snapshot. Hosted MCP data proof remains a separate post-merge rung.","Extraction retained 2,783 `pypdf_layout` pages and 56 `pypdf_plain_rotated_fallback` pages; 10 pages retain the `empty_extracted_text` quality flag rather than invented text.","`is_analytics_eligible` describes extraction fitness only; it is not legal operativity. Join `canonical_occurrence_id` to the occurrence ledger and exclude `is_proposed_nonoperative=true` before any operative-authority use.","Content-identical aliases are deduplicated by exact SHA-256 at the page layer. The canonical occurrence is lineage, not permission to discard the other official roles or URLs from the occurrence ledger.","Empty extracted text remains a quality flag and must not be filled, OCR-invented, or interpreted as an absent legal provision without separately accepted OCR evidence.","Page text preserves source evidence but does not resolve inherited provisions, redline semantics, table-as-of dates, or provision-level implementation periods."],"notes":"Production schema columns are corpus_snapshot_date, document_sha256, canonical_occurrence_id, content_occurrence_count, page_number, page_text, page_text_sha256, word_count, extraction_method, semantic_row_sha256, quality_flags, is_analytics_eligible, plus the M-2 lineage envelope. Production reconciliation, unchanged-snapshot replay, query promotion, and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_calaim_1915b_waiver_authority","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["document_sha256","page_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_calaim_1915b_workbook_cell","source_fqn":"medicare_silver.ca_calaim_1915b_workbook_cell","title":"California CalAIM 1915(b) physical workbook-cell evidence","domain":"state","stage":"silver","status":"live","grain":"One nonempty physical cell per exact workbook SHA-256, physical sheet name, and cell coordinate.","description":"Production-reconciled and exact-replay-idempotent lossless cell layer for acquired CalAIM 1915(b) cost-effectiveness workbooks, preserving raw and displayed values, formulas, data type, number format, style array, merged range, hyperlink, comment, semantic text, quality flags, exact workbook identity, content-alias count, semantic-row hash, and Bronze lineage without converting projections into actual claims or revenue.","identity_key":"document_sha256,sheet_name,cell_coordinate","row_count":19941,"last_updated":"2026-08-01","freshness_sla":"Event-driven with each accepted CalAIM 1915(b) workbook publication, approval package, or exact-byte correction.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Reparse only exact accepted XLSX bytes, preserve formula/display/style/merge semantics, keep blanks absent rather than zero, and reconcile missing workbooks to occurrence-level source limits.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_calaim_1915b_workbook_cell","commercial_terms":"Public California DHCS and CMS waiver cost-effectiveness workbooks.","known_gaps":["Production contains 19,941 reconciled nonempty-cell rows at Iceberg snapshot 4466256569331871445; exact-bundle replay returned IDEMPOTENT_SKIP and preserved this snapshot. Hosted MCP data proof remains a separate post-merge rung.","Three acquired workbooks contain 28 physical sheets; 27 sheets emit nonempty cell rows. A physical sheet with no emitted rows is absence of nonempty cells, not a zero-valued observation.","Blank cells are absent, not zero, false, excluded, or not applicable. Formula, displayed value, raw value, style, merge, hyperlink, and comment state must remain distinct.","Cost-effectiveness workbook values are projections and federal tests unless the source explicitly says otherwise; they are not paid claims, plan revenue, capitation rates, or observed enrollment.","`is_analytics_eligible` is extraction fitness, not legal operativity. Authority status and source role come from the occurrence ledger and must remain in scope.","The unresolved `appr2024_ce_mcmc` source-limit occurrence must produce no cell rows unless exact official bytes are later acquired and separately accepted; absence here must reconcile to the occurrence-ledger sentinel rather than being hidden."],"notes":"Production schema columns are corpus_snapshot_date, document_sha256, canonical_occurrence_id, content_occurrence_count, sheet_name/index, cell_coordinate, row_number, column_number, raw_value_json, displayed_value_json, formula, data_type, number_format, style_id, style_array_json, merged_range, hyperlink_json, comment_json, semantic_value_text, semantic_row_sha256, quality_flags, is_analytics_eligible, plus the M-2 lineage envelope. Production reconciliation, unchanged-snapshot replay, query promotion, and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_calaim_1915b_waiver_authority","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["document_sha256","sheet_name"],"unmapped_key_tokens":["cell_coordinate"],"backing_store":"glue"},{"source_id":"ca_medi_cal_mcp_contract_source_occurrence","source_fqn":"medicare_silver.ca_medi_cal_managed_care_contract_source_occurrence","title":"California Medi-Cal managed-care contract source occurrences","domain":"state","stage":"silver","status":"live","grain":"One frozen corpus snapshot and official DHCS contract-publication occurrence, including acquired payloads and exact retrieval limits.","description":"Production-reconciled and exact-replay-idempotent occurrence ledger for California physical-health Medi-Cal managed-care boilerplates, publisher-labeled amendment/full-restatement packages, Exhibit L variants, and explicitly nonoperative drafts. It preserves artifact class, source-native dates, exact payload identity, acquisition/source-limit state, content aliases, operativity and fact-eligibility flags, semantic hashes, and M-2 lineage without manufacturing executed contract, amendment, CMS-review, or rate facts.","identity_key":"corpus_snapshot_date,occurrence_id","row_count":31,"last_updated":"2026-08-01","freshness_sla":"Event-driven when DHCS publishes, replaces, or recovers a managed-care boilerplate, amendment/restatement package, Exhibit L artifact, or contract-related draft.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate exact DHCS publication surfaces and recover raw bytes before adding rows; preserve source limits and independent date axes; never infer execution, CMS approval, chronology, or rates from labels, metadata, variants, blanks, or publisher assertions.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_medi_cal_managed_care_contract_source_occurrence","commercial_terms":"Public California Department of Health Care Services managed-care contract publications.","known_gaps":["Production contains 31 reconciled occurrences at Iceberg snapshot 9087821636864459865: 14 acquired PDFs and 17 exact source-limit occurrences. Query `6dec6f84-0d08-4988-bcf4-8bf9651acb84` proves zero duplicate certified keys, zero required-lineage nulls, zero source-limit payload-field violations, and zero signed base/amendment or rate facts; exact replay returned four `IDEMPOTENT_SKIP` results and preserved all four snapshots.","Fourteen current boilerplate, Two-Plan, crosswalk, and Exhibit L occurrences plus three draft/APL occurrences remain blocked or unrecovered; null bytes, hashes, and pages are source limits, not zero.","Exhibit L variants 1-10 are content variants, not chronology. Drafts are explicitly nonoperative, and publisher-labeled restatements are not executed plan amendments.","The source does not prove signed plan-specific contracts, executed amendments, contract terms, CMS review, contractor identity, clause facts, rates, networks, enrollment, claims, or waiver authority."],"notes":"Production schema preserves artifact class, managed-care models, raw publisher labels and dates, acquisition/source-limit evidence, content aliases, explicit operativity, Exhibit L non-temporal semantics, fact-eligibility sentinels, raw JSON, semantic hash, and M-2 lineage. Query promotion and certification are proven; hosted MCP data proof, customer-live status, terminal completion, and family completion remain gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_contracts","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["corpus_snapshot_date","occurrence_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_medi_cal_mcp_contract_index_snapshot","source_fqn":"medicare_silver.ca_medi_cal_managed_care_contract_index_snapshot","title":"California Medi-Cal managed-care contract index snapshots","domain":"state","stage":"silver","status":"live","grain":"One frozen corpus snapshot and exact archived official DHCS index occurrence.","description":"Lossless archived-index ledger for four exact DHCS managed-care boilerplate publication states. It preserves official and acquisition URLs, archive capture, exact bytes and hashes, linked and unresolved corpus identities, publisher notes, content aliases, semantic hashes, and M-2 lineage. Index rows prove publisher occurrence and link history, not contracts or amendments.","identity_key":"corpus_snapshot_date,snapshot_id","row_count":4,"last_updated":"2026-08-01","freshness_sla":"Event-driven when a distinct official index state is recovered and separately accepted.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Recover and hash exact index bytes, preserve capture and publisher dates separately, retain unresolved links, and never treat index text as executed contract evidence.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_medi_cal_managed_care_contract_index_snapshot","commercial_terms":"Public California Department of Health Care Services managed-care contract publication indexes.","known_gaps":["Production contains four reconciled archived-index occurrences totaling 264,414 bytes at Iceberg snapshot 3889930429454777084, with zero duplicate certified keys, zero required-lineage nulls, and zero contract-fact-eligible rows under query `6dec6f84-0d08-4988-bcf4-8bf9651acb84`.","The 2024 index displayed an approved/pending disclaimer but no additional amendment link inventory; absence from an index snapshot is not proof that no contract or amendment existed."],"notes":"Index snapshots are publisher-occurrence evidence only. Exact replay returned `IDEMPOTENT_SKIP` and preserved the snapshot; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_contracts","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["corpus_snapshot_date"],"unmapped_key_tokens":["snapshot_id"],"backing_store":"glue"},{"source_id":"ca_medi_cal_mcp_contract_index_snapshot_text","source_fqn":"medicare_silver.ca_medi_cal_managed_care_contract_index_snapshot_text","title":"California Medi-Cal managed-care contract index text","domain":"state","stage":"silver","status":"live","grain":"One exact archived-index document SHA-256 and decoded lossless text document.","description":"Decoded text layer for four exact DHCS archived contract-publication indexes, preserving canonical snapshot identity, content aliases, text hash, byte and character counts, decoding/extraction method, quality flags, semantic hash, and M-2 lineage. It supports publisher-link research but emits no contract facts.","identity_key":"document_sha256","row_count":4,"last_updated":"2026-08-01","freshness_sla":"Event-driven with each separately accepted exact index payload or decoding correction.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Decode only accepted exact index bytes, retain text hashes and quality state, and resolve legal meaning through acquired document evidence rather than labels alone.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_medi_cal_managed_care_contract_index_snapshot_text","commercial_terms":"Public California Department of Health Care Services managed-care contract publication indexes.","known_gaps":["Production contains four reconciled decoded-index documents at Iceberg snapshot 2348662581506271121, with zero duplicate certified keys, zero required-lineage or text-hash nulls, and zero contract-fact-eligible rows under query `6dec6f84-0d08-4988-bcf4-8bf9651acb84`.","Decoded index language and link labels are discovery evidence; they are not signatures, execution dates, contract terms, or CMS approval."],"notes":"Exact replay returned `IDEMPOTENT_SKIP` and preserved the snapshot. Query promotion and certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_contracts","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["document_sha256"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_medi_cal_mcp_contract_pdf_page","source_fqn":"medicare_silver.ca_medi_cal_managed_care_contract_pdf_page","title":"California Medi-Cal managed-care contract PDF-page evidence","domain":"state","stage":"silver","status":"live","grain":"One exact acquired PDF document SHA-256 and one-based physical page number.","description":"Lossless physical-page layer for 14 acquired DHCS managed-care boilerplate and publisher-labeled restatement PDFs. It preserves document/page hashes, canonical occurrence identity, layout-aware text, extraction quality, fact-eligibility sentinels, semantic hashes, and M-2 lineage. It is citation evidence and contains no executed contract, plan-specific amendment, or rate facts.","identity_key":"document_sha256,page_number","row_count":3822,"last_updated":"2026-08-01","freshness_sla":"Event-driven with each separately accepted exact contract-publication PDF recovery or extraction correction.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Reparse only accepted exact PDF bytes, preserve page/text hashes and quality flags, emit no pages for source limits, and never infer execution, CMS approval, rates, or contract terms from page text alone.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_medi_cal_managed_care_contract_pdf_page","commercial_terms":"Public California Department of Health Care Services managed-care contract publications.","known_gaps":["Production contains 3,822 reconciled physical pages at Iceberg snapshot 1127959268214226546. Query `6dec6f84-0d08-4988-bcf4-8bf9651acb84` proves zero duplicate certified keys, zero required-lineage/page-hash nulls, and zero executed-contract, plan-specific-amendment, or rate-fact rows.","The 17 source-limit occurrences correctly emit no physical pages. Their absence is not evidence of a zero-page document or absent contract.","Page text from a boilerplate or publisher-labeled full restatement is not signed plan-specific execution evidence; legal classification must retain the occurrence-ledger artifact class and eligibility flags."],"notes":"Exact replay returned `IDEMPOTENT_SKIP` and preserved the snapshot. Query promotion and certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_contracts","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["document_sha256","page_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_medi_cal_mcp_roster_source_occurrence","source_fqn":"medicare_silver.ca_medi_cal_mcp_roster_source_occurrence","title":"California Medi-Cal managed-care roster source occurrences","domain":"state","stage":"silver","status":"live","grain":"One frozen corpus snapshot and official DHCS managed-care roster source occurrence, including acquired artifacts and explicit retrieval limits.","description":"Production-reconciled and exact-replay-idempotent occurrence ledger for California physical-health Medi-Cal managed-care program-delivery roster evidence. It preserves source roles, dates, exact payload identity, content aliases, acquisition state, directory evidence flags, proposal/operativity eligibility, source limits, raw occurrence JSON, semantic hashes, and M-2 lineage without treating directory listings as contract, enrollment, network, rate, or federal-authority proof.","identity_key":"corpus_snapshot_date,occurrence_id","row_count":15,"last_updated":"2026-08-01","freshness_sla":"Event-driven when DHCS publishes or changes a managed-care map, county-plan matrix, transition guide, or beneficiary directory.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate official DHCS surfaces, pin exact bytes, retain source limits and all independent date/status axes, and never infer operativity from publication or archive dates.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_medi_cal_mcp_roster_source_occurrence","known_gaps":["Production contains 15 reconciled occurrences at Iceberg snapshot 3757758753004643270: nine acquired PDFs and six explicit source-limit occurrences. Validation query `bc7588bd-b2cc-4183-97ec-ca1c61c53fa6` proves zero duplicate certified-key groups and zero required-lineage null rows; exact replay returned three `IDEMPOTENT_SKIP` results and preserved all three snapshots. Hosted MCP data proof remains a separate post-merge rung.","Current map and 59-page beneficiary directory raw acquisition remain blocked by Incapsula; bytes, hashes, and derived physical rows are absent rather than invented.","Transition-guide versions 1, 3, 4, and 6 remain unrecovered; one archive response is truncated and rejected as a valid PDF.","This occurrence ledger does not prove observed enrollment, executed contracts, provider networks, rates, paid claims, or federal waiver authority."],"notes":"Production schema preserves all source-native date strings, official/acquisition URLs, exact byte and document hashes, parse/source-limit evidence, proposed/directory/operativity eligibility flags, content-alias fields, raw JSON and M-2 lineage. The accepted bundle has exactly one Bronze object version. Query promotion and source certification are proven; hosted MCP data proof, customer-live status, terminal completion, and family completion remain gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_program_delivery_roster","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["corpus_snapshot_date","occurrence_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_medi_cal_mcp_roster_pdf_page","source_fqn":"medicare_silver.ca_medi_cal_mcp_roster_pdf_page","title":"California Medi-Cal managed-care roster PDF-page evidence","domain":"state","stage":"silver","status":"live","grain":"One exact acquired PDF document SHA-256 and one-based physical page number.","description":"Production-reconciled and exact-replay-idempotent lossless page layer for acquired California Medi-Cal managed-care roster PDFs, preserving exact document and page-text hashes, layout-aware text, extraction method and quality flags, canonical occurrence linkage, proposal status, extraction fitness, semantic hashes, and M-2 lineage. It is citation evidence, not a plan-operativity or contract table.","identity_key":"document_sha256,page_number","row_count":515,"last_updated":"2026-08-01","freshness_sla":"Event-driven with each separately accepted exact-byte roster-document recovery or correction.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Reparse only accepted exact PDF bytes; retain page/text hashes and quality flags; never create pages for unresolved occurrences or infer program facts from page eligibility.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_medi_cal_mcp_roster_pdf_page","known_gaps":["Production contains 515 reconciled physical-page rows at Iceberg snapshot 5935795655934060980. Validation query `bc7588bd-b2cc-4183-97ec-ca1c61c53fa6` proves zero duplicate certified-key groups and zero required-lineage null rows; exact replay returned `IDEMPOTENT_SKIP` and preserved the snapshot. Hosted MCP data proof remains a separate post-merge rung.","Source-limit occurrences emit no physical page rows; their absence must reconcile to the occurrence ledger and is not evidence of a zero-page document.","Page extraction eligibility is extraction fitness only. Legal or program operativity must be resolved through the occurrence and structured roster layers."],"notes":"Production schema preserves canonical occurrence identity, content-occurrence count, physical page text and hashes, word counts, extraction methods, quality flags, roster/proposal status, analytics eligibility, semantic hashes and M-2 lineage. Query promotion and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_program_delivery_roster","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["document_sha256","page_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_medi_cal_mcp_county_plan_roster","source_fqn":"medicare_silver.ca_medi_cal_mcp_county_plan_roster","title":"California Medi-Cal county-plan program-delivery roster","domain":"state","stage":"silver","status":"live","grain":"One source roster occurrence, roster year, county name, and source-native plan ordinal.","description":"Production-reconciled and exact-replay-idempotent structured transcription of the final DHCS 2023-to-2024 county-plan/model matrix. It retains raw display and legal names, source-native model and plan ordering, plan class, prime/subcontracted status, eligibility qualifier, notes and footnotes, exact citation, and separate operative/current/analytics flags. It includes the source-native Medi-Cal Fee For Service delivery row and does not coerce it into a managed-care plan.","identity_key":"occurrence_id,roster_year,county_name,plan_ordinal","row_count":218,"last_updated":"2026-08-01","freshness_sla":"Event-driven when DHCS publishes a newly accepted county-plan matrix or explicit approval evidence changes row eligibility.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve source-native plan rows and names, select operativity and analytics flags explicitly, retain the FFS row as non-plan evidence, and never infer approval, enrollment, contract, network, rate, or authority status.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_medi_cal_mcp_county_plan_roster","known_gaps":["Production contains 218 reconciled rows at Iceberg snapshot 8963835898133945471: 104 for 2023 and 114 for 2024. Query `bc7588bd-b2cc-4183-97ec-ca1c61c53fa6` proves zero duplicate certified-key groups, zero required-lineage null rows, 186 operative rows, 185 analytics-eligible rows, and 32 Kaiser 2024 rows; corrected query `662a9cc1-2433-4114-b923-3caea6d6089d` proves exactly one retained Fee For Service row.","All 32 Kaiser 2024 rows were marked pending federal approval in this artifact and remain non-operative and analytics-ineligible absent separately accepted approval evidence.","The one Medi-Cal Fee For Service row is source-native delivery evidence, not a managed-care plan; operative count and analytics-eligible count therefore differ by one.","Raw plan names remain source faithful, including distinct `Health Plan San Joaquin` and `Health Plan of San Joaquin` variants and ten capitalization/punctuation cases. No fuzzy identity merge has been applied.","This matrix is not observed enrollment, an executed contract, a provider network, a rate, a paid claim, or federal waiver authority, and it does not complete California's program-delivery-roster family."],"notes":"Production schema preserves roster year/status and dates; county and raw/normalized program model; source-native ordinal; raw display/legal names, notes and footnotes; plan class, prime/subcontracted status and qualifier; physical citation; separate operative/current/analytics flags; semantic hash and M-2 lineage. Query promotion and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_medi_cal_managed_care_program_delivery_roster","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["occurrence_id"],"unmapped_key_tokens":["county_name","plan_ordinal","roster_year"],"backing_store":"glue"},{"source_id":"ca_smhs_1915b_legacy_history_period","source_fqn":"medicare_silver.ca_smhs_1915b_legacy_history_period","title":"California legacy SMHS 1915(b) authority-period history","domain":"state","stage":"silver","status":"live","grain":"One frozen corpus snapshot and source-stated legacy SMHS authority period.","description":"Production-reconciled and exact-replay-idempotent lossless chronology layer for the CA-17 initial authority through CA17.R09 temporary extensions. It preserves source-stated period text, independently parsed start/end dates, evidence basis, original-package recovery status, warnings, exact raw manifest JSON, semantic hashes, and M-2 lineage without manufacturing continuity or turning reconstructed dates into original authority documents.","identity_key":"corpus_snapshot_date,authority_id","row_count":13,"last_updated":"2026-08-01","freshness_sla":"Event-driven when DHCS or CMS publishes a newly recovered legacy artifact, corrects an index, or resolves a documented source limit.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate the official legacy and attachment indexes and bounded Wayback evidence; preserve each evidence class and never repair source-stated chronology by inference.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_smhs_1915b_legacy_history_period","known_gaps":["Production contains 13 reconciled history-period rows at Iceberg snapshot 1564840228996190499. Validation query `ac9f86e1-5280-4985-b521-e766f78a1740` proves zero duplicate certified-key groups and zero required-lineage null rows; exact replay returned `IDEMPOTENT_SKIP`, and snapshot proof query `084d6cb3-9668-4626-ba9c-3e4e08a5006f` preserved the snapshot. Hosted MCP data proof remains a separate post-merge rung.","R00-R03 and R05-R07 dates are reconstructed from the later R09 narrative; R04 is partially corroborated by its recovered approval letter, and R08 lacks a recovered standalone CMS approval/STCs package.","Source-stated chronology includes an R03/R04 overlap and other gaps. These are evidence, not errors to normalize into a continuous interval.","Archive capture timestamps are acquisition evidence only and must never become document, submission, approval, or effective dates.","This bounded history atom does not establish current authority, enrollment, claims, contracts, networks, capitation rates, or either California source family's completion."],"notes":"Production schema columns are corpus_snapshot_date, authority_id, period_text, period_start/end, date_basis, original_package_status, partial_original_evidence, warning, reconstruction/original-basis flags, manifest_sha256, raw_history_period_json, semantic_row_sha256, plus the M-2 lineage envelope. Production reconciliation, unchanged-snapshot replay, query promotion, and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_smhs_1915b_legacy_authority","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["corpus_snapshot_date"],"unmapped_key_tokens":["authority_id"],"backing_store":"glue"},{"source_id":"ca_smhs_1915b_legacy_source_occurrence","source_fqn":"medicare_silver.ca_smhs_1915b_legacy_source_occurrence","title":"California legacy SMHS 1915(b) official source occurrences","domain":"state","stage":"silver","status":"live","grain":"One frozen corpus snapshot and official legacy DHCS/CMS source occurrence, including recovered, retrieval-limited, and expected-unrecovered artifacts.","description":"Production-reconciled and exact-replay-idempotent lossless occurrence ledger for the legacy CA-17 through CA17.R09 authority chain. It preserves authority and artifact roles; source-native date evidence; official, original, archive, and acquisition URLs; exact payload identity; content-alias ordinals; retrieval and expected-unrecovered source limits; eligibility and quality flags; raw occurrence JSON; semantic hashes; and M-2 lineage without inferring an operative-current roster.","identity_key":"corpus_snapshot_date,occurrence_id","row_count":38,"last_updated":"2026-08-01","freshness_sla":"Event-driven when DHCS or CMS publishes a newly recovered legacy artifact, corrects an index, or resolves a documented source limit.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate official indexes and bounded Wayback captures, pin exact payload bytes, and retain source limits and role/date evidence without relabeling or inference.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_smhs_1915b_legacy_source_occurrence","known_gaps":["Production contains 38 reconciled occurrence rows at Iceberg snapshot 4797273123761534803, including 33 recovered PDFs, four Incapsula retrieval limits, and one expected-unrecovered attachment. Validation query `ac9f86e1-5280-4985-b521-e766f78a1740` proves zero duplicate certified-key groups and zero required-lineage null rows; exact replay returned `IDEMPOTENT_SKIP`, and snapshot proof query `20fa1228-87a2-4159-9f4d-dea6b2dad383` preserved the snapshot. Hosted MCP data proof remains a separate post-merge rung.","R09 attachment 17 remains named but unrecovered. Its bytes, document SHA-256, pages, acquisition URL, and physical page rows remain absent rather than invented.","Four officially indexed 2020 extension-chain occurrences remain retrieval-limited by Incapsula. HTML challenge bytes are not accepted or hashed as PDFs.","A public notice, request, approval, amendment, technical correction, protocol, and package attachment are different roles and cannot be selected or summed as interchangeable authority actions.","Repeated physical content may deduplicate only by exact document SHA-256; every official occurrence, role, URL, and source limit remains addressable.","This source ends before CalAIM R10 and cannot establish current operative authority, observed program activity, or family completion."],"notes":"Production schema columns are corpus_snapshot_date, occurrence_id, authority_id, role, document-date fields and precision, date_basis, original/official/archive/acquisition URLs, byte_count, document_sha256, page expectations, payload status, source-limit reason, warning/request/effective fields, content alias ordinals, recovery/source-limit/eligibility flags, quality_flags, manifest/raw occurrence JSON/semantic hashes, plus the M-2 lineage envelope. Production reconciliation, unchanged-snapshot replay, query promotion, and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_smhs_1915b_legacy_authority","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["corpus_snapshot_date","occurrence_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ca_smhs_1915b_legacy_pdf_page","source_fqn":"medicare_silver.ca_smhs_1915b_legacy_pdf_page","title":"California legacy SMHS 1915(b) physical PDF-page evidence","domain":"state","stage":"silver","status":"live","grain":"One exact recovered PDF document SHA-256 and one-based physical page number.","description":"Production-reconciled and exact-replay-idempotent lossless page layer for the 33 recovered legacy SMHS 1915(b) PDFs, preserving layout-aware extracted text, exact document and page-text hashes, word count, extraction method, quality flags, semantic hashes, canonical occurrence linkage, and M-2 lineage. It is physical citation evidence, not a structured operative-rule table.","identity_key":"document_sha256,page_number","row_count":1356,"last_updated":"2026-08-01","freshness_sla":"Event-driven with each separately accepted exact-byte recovery or correction to the frozen legacy corpus.","recollection":{"cadence":"event_driven","watermark_field":"corpus_snapshot_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Reparse only exact accepted PDF bytes, retain page and text hashes and extraction quality flags, and resolve authority semantics through the occurrence and history ledgers.","watermark_field 'corpus_snapshot_date' is the date of the frozen corpus snapshot the row belongs to (a Vlada acquisition vintage), not a DHCS or CMS publication, effective or approval date; those are independent date axes carried on the row."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ca_smhs_1915b_legacy_pdf_page","known_gaps":["Production contains 1,356 reconciled physical-page rows at Iceberg snapshot 7989364117211900127, including 14 `pypdf_plain_rotated_fallback` rows. Validation query `ac9f86e1-5280-4985-b521-e766f78a1740` proves zero duplicate certified-key groups and zero required-lineage null rows; exact replay returned `IDEMPOTENT_SKIP`, and snapshot proof query `f4d9a5f7-59b4-41cf-96f1-4635db7b4577` preserved the snapshot. Hosted MCP data proof remains a separate post-merge rung.","Retrieval-limited and expected-unrecovered occurrences emit no physical pages; absence must reconcile to the occurrence ledger and is not evidence of zero-page authority.","Layout extraction can preserve empty-text or rotated-text quality flags. Missing text must not be filled or treated as an absent legal provision without separately accepted OCR evidence.","Physical-page analytics eligibility is extraction fitness only, not legal operativity or evidence that a reconstructed period is an original authority artifact.","Content-identical occurrence aliases may share one page set, but physical deduplication must not erase their distinct roles and URLs in the occurrence ledger."],"notes":"Production schema columns are corpus_snapshot_date, document_sha256, canonical_occurrence_id, content_occurrence_count, page_number, page_text/page_text_sha256, word_count, extraction_method, semantic_row_sha256, quality_flags, is_analytics_eligible, plus the M-2 lineage envelope. Production reconciliation, unchanged-snapshot replay, query promotion, and source certification are proven; hosted MCP data proof remains gated.","superseded_by":null,"tools":[],"dataset_id":"ca_dhcs_smhs_1915b_legacy_authority","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["document_sha256","page_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ipps_payment_source_asset","source_fqn":"medicare_silver.ipps_payment_source_asset","title":"CMS IPPS Impact and inpatient PSF source/document inventory","domain":"medicare","stage":"silver","status":"live","grain":"One row per acquired top-level CMS asset or recursively indexed archive document.","description":"Complete physical source inventory for the accepted 79-asset CMS IPPS Impact and inpatient Provider Specific File corpus, expanding to 421 top-level and nested documents with publisher release, fiscal year, rule stage, snapshot date, format, bytes, SHA-256, parse disposition, source limits, current-release state, and exact Bronze lineage.","identity_key":"observed_period,asset_id,document_path","row_count":421,"last_updated":"2026-07-26","freshness_sla":"Re-inventory every accepted CMS Impact, PSF/PDS, and Claims Manual Addendum A publisher surface on each governed refresh.","recollection":{"cadence":"quarterly","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Re-enumerate official CMS surfaces, retain every release and archive member, deduplicate only identical source URLs, and require exact content hash, Bronze key, and S3 version lineage.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ipps_payment_source_asset","commercial_terms":"Public CMS hospital-payment rulemaking and provider-specific assets.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_ipps_impact_psf_2026_07_26.json","context_doc_path":"docs/context_library/medicare/ipps_impact_psf.md","known_gaps":["FY2003 and FY2004 official record-layout item pages currently expose no downloadable layout; their self-describing Excel provider data remain recoverable and no unofficial layout is substituted.","The 421 rows expand 79 top-level assets into physical documents, so top-level and recursive document counts are not interchangeable.","This is source lineage, not a hospital observation, claim, utilization fact, cost report, or AHD/AHA payer-revenue split."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ipps_final_rule","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":["document_path"],"backing_store":"glue"},{"source_id":"ipps_impact_provider_row","source_fqn":"medicare_silver.ipps_impact_provider_row","title":"CMS IPPS Impact physical provider rows","domain":"medicare","stage":"silver","status":"live","grain":"One physical provider row per observed period, Impact asset, document, sheet, and source row.","description":"Full FY1994 through FY2027 proposed physical Impact history with 428,432 rows, retaining proposed/final/correction releases and alternate encodings plus promoted CCN, hospital name, wage area/index, teaching ratio, beds, DSH, uncompensated-care, CCR, case-mix, outlier, provider-type, hospital-specific-rate, and modeled-case fields alongside lossless raw headers and cells.","identity_key":"observed_period,asset_id,document_path,sheet_name,source_row_number","row_count":428432,"last_updated":"2026-07-26","freshness_sla":"Annual proposed/final IPPS rule refresh plus any CMS correction, supplemental, or interim release.","recollection":{"cadence":"event_driven","watermark_field":"fiscal_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Choose fiscal year, rule stage, release, document, and encoding before aggregation; preserve physical lineage and use is_analytics_eligible for provider rows.","watermark_field 'fiscal_year' is the IPPS rule fiscal year of the Impact file the row came from; proposed and final rule stages for the same fiscal_year coexist, so pin rule stage, release and document as well."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ipps_impact_provider_row","commercial_terms":"Public CMS IPPS Impact files.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_ipps_impact_psf_2026_07_26.json","context_doc_path":"docs/context_library/medicare/ipps_impact_psf.md","known_gaps":["Impact values are rule-time payment models and may differ from factors ultimately used to pay claims.","Proposed, final, correction, and alternate TXT/XLS/XLSX encodings are separate physical evidence and must not be summed as distinct hospitals.","Modeled Medicare cases are not observed claims; Impact does not provide all-payer utilization, HCRIS revenue, or an AHD/AHA payer-revenue split."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ipps_final_rule","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period","sheet_name","source_row_number"],"unmapped_key_tokens":["document_path"],"backing_store":"glue"},{"source_id":"inpatient_psf_provider_record","source_fqn":"medicare_silver.inpatient_psf_provider_record","title":"CMS inpatient Provider Specific File effective records","domain":"medicare","stage":"silver","status":"live","grain":"One full-history inpatient PSF record per accepted snapshot, source-native publisher provider identifier, and effective date.","description":"Effective-dated inpatient Provider Specific File history across the accepted current PDS export and quarterly full-history snapshots, retaining the publisher providerCcn identifier, effective/export/termination dates, provider type, geographic and wage assignments, teaching ratios, operating/capital CCRs, case mix, DSH, VBP/HRRP/HAC/EHR factors, uncompensated care, low-volume adjustment, county, NPI, exact raw fields, and Bronze lineage.","identity_key":"observed_period,snapshot_date,ccn,effective_date","row_count":3161162,"last_updated":"2026-07-26","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.inpatient_psf_provider_record","notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_inpatient_provider_specific_file","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":["effective_date","observed_period","snapshot_date"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"qualitynet_measure_methodology_source_asset","source_fqn":"medicare_silver.qualitynet_methodology_source_asset","title":"CMS QualityNet readmission-methodology source assets","domain":"medicare","stage":"silver","status":"live","grain":"One row per QualityNet content ID in the accepted methodology and reporting-resource corpus.","description":"Complete 69-content-ID inventory behind the 70 official QualityNet readmission methodology and resource page references posted from 2008 through 2026, retaining aliases, publisher dates and file types, exact source bytes and SHA-256, stable content endpoints, deterministic bundle lineage, and current-release state.","identity_key":"observed_period,content_id","row_count":69,"last_updated":"2026-06-03","freshness_sla":"Re-inventory both QualityNet public gateway pages and every stable content endpoint on each governed refresh.","recollection":{"cadence":"event_driven","watermark_field":"posted_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Enumerate both official page APIs, deduplicate only by content ID, retain every page alias, and require exact source bytes, content hash, and Bronze lineage.","watermark_field 'posted_date' is the posted date QualityNet publishes with the content item, as carried in the publisher reference; it is publisher metadata, not the date Vlada acquired the bytes (asserted_at)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.qualitynet_methodology_source_asset","commercial_terms":"Public CMS QualityNet methodology and reporting-resource assets.","known_gaps":["This is methodology/reference logic, not hospital scores, patient claims, payment amounts, CCN-level utilization, HCRIS revenue, or an AHD-style payer revenue split.","One publisher content ID is referenced by two QualityNet page labels and is acquired once while both aliases remain in page_references_json.","The stable content endpoint is durable source identity; short-lived publisher download URLs must never be stored as that identity."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_qualitynet_readmission_methodology","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period"],"unmapped_key_tokens":["content_id"],"backing_store":"glue"},{"source_id":"qualitynet_measure_methodology_document","source_fqn":"medicare_silver.qualitynet_methodology_document","title":"CMS QualityNet methodology document and archive-member inventory","domain":"medicare","stage":"silver","status":"live","grain":"One row per QualityNet content ID and deterministic top-level or recursive document ordinal.","description":"Lossless inventory of 427 top-level QualityNet files and safely traversed archive members, retaining parent/member identity, archive depth, exact path, actual format, bytes, hash, page and worksheet counts, parse disposition, measure family, quality flags, and source lineage.","identity_key":"observed_period,content_id,document_ordinal","row_count":427,"last_updated":"2026-06-03","freshness_sla":"Rebuild from the complete deterministic source bundle on each governed QualityNet refresh.","recollection":{"cadence":"event_driven","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Traverse archives with path, depth, expansion, and member-size guards; sniff OOXML by package content rather than suffix and retain zero-byte publisher members as explicit quality rows.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.qualitynet_methodology_document","commercial_terms":"Public CMS QualityNet files and archive members.","known_gaps":["The official 2019 archive contains a zero-byte XLSX name plus a valid OOXML workbook carrying a .partial suffix; both physical members are preserved and the valid package is parsed by content.","A deterministic document ordinal is part of the physical key because ZIP archives can legally contain duplicate member paths.","A document row proves publisher content and parse disposition, not adoption of a proposed measure or hospital performance."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_qualitynet_readmission_methodology","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period"],"unmapped_key_tokens":["content_id","document_ordinal"],"backing_store":"glue"},{"source_id":"qualitynet_measure_methodology_document_text","source_fqn":"medicare_silver.qualitynet_methodology_document_text","title":"CMS QualityNet searchable methodology document text","domain":"medicare","stage":"silver","status":"live","grain":"One row per QualityNet document and extractable PDF page or Office/text segment.","description":"Searchable 7,320-segment history of QualityNet methodology reports, factsheets, user guides, reporting resources, and supporting Office/text documents, retaining page or segment identity, exact text fingerprint, measure family, current-release state, analytics eligibility, and source lineage.","identity_key":"observed_period,content_id,document_ordinal,segment_number","row_count":7320,"last_updated":"2026-06-03","freshness_sla":"Re-extract from every accepted document on each governed QualityNet refresh.","recollection":{"cadence":"event_driven","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve page/segment order, content ID, document ordinal, measure family, release state, and exact text hash; never infer adoption or hospital applicability from text presence.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.qualitynet_methodology_document_text","commercial_terms":"Public CMS QualityNet document text.","known_gaps":["Text is publisher methodology and reporting guidance, not a hospital score, patient event, coverage decision, or payment determination.","Proposed sepsis methodology text remains distinguishable from adopted production specifications.","Empty or non-extractable publisher members remain documented in the document inventory and are not replaced with inferred text."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_qualitynet_readmission_methodology","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period"],"unmapped_key_tokens":["content_id","document_ordinal","segment_number"],"backing_store":"glue"},{"source_id":"qualitynet_measure_methodology_table_row","source_fqn":"medicare_silver.qualitynet_methodology_table_row","title":"CMS QualityNet readmission-methodology spreadsheet rows","domain":"medicare","stage":"silver","status":"live","grain":"One row per QualityNet document, worksheet, and physical nonblank source row.","description":"Lossless 2,498,682-row history of QualityNet cohort, exclusion, risk-variable, planned-readmission, POA, frailty, CC, CCS-to-ICD, and related spreadsheet logic, retaining titles, notes, headers, raw cells, conservative measure/rule/code normalization, semantic fingerprints, quality flags, and exact physical lineage.","identity_key":"observed_period,content_id,document_ordinal,sheet_ordinal,source_row_number","row_count":2498682,"last_updated":"2026-06-03","freshness_sla":"Rebuild from all accepted QualityNet workbooks and archive members on each governed refresh.","recollection":{"cadence":"event_driven","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve every nonblank physical row, raw cells, document/sheet/row lineage, reporting year, measure family, rule role, and code system; use is_analytics_eligible for analytic rows and semantic_row_sha256 only for explicit consumer deduplication.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.qualitynet_methodology_table_row","commercial_terms":"Public CMS QualityNet spreadsheet methodology and reference logic.","known_gaps":["A code row is reporting-year methodology logic, not evidence that a hospital treated a patient, received payment, met a coverage rule, or has a CCN-level result.","Reporting year is not automatically an ICD effective date; governed joins require code system, normalized code, and compatible reporting/effective periods.","Repeated rows across separate measure workbooks are legitimate source-native methodology rows and must not be deduplicated on code alone.","Source workbooks contain formatting-only terminal rows and inflated dimensions; bounded content-aware parsing retains semantic rows and records exact quality flags without materializing formatting-only cells."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_qualitynet_readmission_methodology","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_row_number"],"unmapped_key_tokens":["content_id","document_ordinal","sheet_ordinal"],"backing_store":"glue"},{"source_id":"cssc_operations_reference_source_asset","source_fqn":"medicare_silver.cssc_operations_source_asset","title":"CMS CSSC Part C operations governed source-asset ledger","domain":"medicare","stage":"silver","status":"live","grain":"One row per accepted release asset, governed source limit, deferred atomic lane, or existing Vlada overlap.","description":"Content, rights, and overlap ledger for the accepted public CSSC Part C operations corpus: 28 acquired public CSSC assets, five metadata-only external-code or implementation-guide limits, three existing-source pointers, and two separately deferred operational worlds.","identity_key":"observed_period,asset_id","row_count":38,"last_updated":"2026-07-24","freshness_sla":"Re-inventory all current/archive CSSC Part C, EDI, listserv, job-aid, video, and lookup surfaces on each governed refresh.","recollection":{"cadence":"snapshot_adhoc","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Refresh must preserve each asset's maintainer and license class and fail closed if any governed source-limit asset claims acquired payload or a bundle member.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cssc_operations_source_asset","commercial_terms":"Public CMS/CSSC payload only. X12 implementation-guide and code-list content, AMA CPT, ADA CDT, and AHA/NUBC descriptions are not acquired or served.","known_gaps":["Five X12/AMA/ADA/NUBC-related families are metadata-only source limits with no payload member; the table is a rights ledger, not a licensed decoder.","Part D/DDPS/NCPDP/PDFS and FAI operations are separate deferred atomic sources and are not silently mixed into Part C.","Existing diagnosis, CARC-boundary, and institutional-code sources remain independently mastered and are referenced rather than duplicated."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cssc_operations_reference","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["asset_id","observed_period"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cssc_operations_reference_resource","source_fqn":"medicare_silver.cssc_operations_resource","title":"CMS CSSC Part C article, listserv, job-aid, and video history","domain":"medicare","stage":"silver","status":"live","grain":"One row per publisher context and CSSC document identifier (DID).","description":"Lossless metadata and body-fingerprint index for 911 distinct CSSC resources across eight bounded current/archive collections from 2003 through 2026, retaining listing dates, article dates, body presence, attachment counts, collection identity, and exact Bronze lineage.","identity_key":"observed_period,publisher_context,did","row_count":911,"last_updated":"2026-07-24","freshness_sla":"Re-inventory current and archived CSSC collections on each governed refresh.","recollection":{"cadence":"snapshot_adhoc","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Retain publisher_context with DID because current/archive contexts are separate publisher surfaces; do not infer missing article bodies.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cssc_operations_resource","commercial_terms":"Public CSSC publisher metadata and article-body fingerprints.","known_gaps":["Eleven publisher resources have an empty article body and remain explicit body_present=false quality rows rather than being dropped or backfilled from another release.","Resource dates are publisher listing/article metadata and are not encounter service dates, claim dates, or code effective dates.","A resource row indexes public CSSC guidance; it is not proof that a plan submitted an encounter or that an edit fired."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cssc_operations_reference","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period"],"unmapped_key_tokens":["did","publisher_context"],"backing_store":"glue"},{"source_id":"cssc_operations_reference_attachment","source_fqn":"medicare_silver.cssc_operations_attachment","title":"CMS CSSC resource attachment-link index","domain":"medicare","stage":"silver","status":"live","grain":"One row per CSSC resource and HTML anchor ordinal.","description":"Lossless 1,002-row link index extracted from the 911 accepted CSSC article bodies, retaining raw and resolved URLs, link text, host, file metadata, acquisition disposition, source-limit status, and article-member lineage.","identity_key":"observed_period,publisher_context,did,attachment_ordinal","row_count":1002,"last_updated":"2026-07-24","freshness_sla":"Rebuild with the complete resource corpus on each governed CSSC refresh.","recollection":{"cadence":"snapshot_adhoc","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Recollection must preserve raw href, resolved URL, article identity, and physical anchor ordinal; payload acquisition remains separately governed.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cssc_operations_attachment","commercial_terms":"Public link metadata only; linked external or licensed payload is not acquired merely because CSSC exposes a hyperlink.","known_gaps":["This is an attachment-link index, not a claim that every linked file was acquired, parsed, current, or licensed for redistribution.","Preserve acquisition_disposition and source_limit before following a link; public hyperlink visibility does not override X12, AMA, ADA, or NUBC rights.","Attachment ordinals are physical HTML-anchor lineage and must not be collapsed by URL."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cssc_operations_reference","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period"],"unmapped_key_tokens":["attachment_ordinal","did","publisher_context"],"backing_store":"glue"},{"source_id":"cssc_operations_reference_operational_edit","source_fqn":"medicare_silver.cssc_operational_edit","title":"CMS CSSC public EDPS, RAPS, and FERAS operational edits","domain":"medicare","stage":"silver","status":"live","grain":"One row per public lookup asset and physical JSON source row.","description":"Public CMS-authored CSSC operational edit rows for EDPS institutional, professional, DME, and dental submissions plus RAPS and FERAS, retaining system, data type, edit code, disposition, effective history, resolution text, physical source row, and raw JSON.","identity_key":"observed_period,source_asset_id,source_row_number","row_count":679,"last_updated":"2026-07-24","freshness_sla":"Snapshot the public CSSC lookup endpoints on each governed refresh and retain physical disposition/effective-history rows.","recollection":{"cadence":"snapshot_adhoc","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Join with system, data_type, source asset, and physical history; never deduplicate on edit_code alone or reconstruct excluded external code sets.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cssc_operational_edit","commercial_terms":"Public CMS/CSSC edit semantics only. X12 837/277CA/TA1, CARC, AMA CPT, ADA CDT, and AHA/NUBC payload is excluded.","known_gaps":["Edit code alone is not a unique key; EDPS legitimately repeats codes across physical disposition or effective-history rows and those rows must be retained.","The table supports submission validation and troubleshooting; it does not contain encounters, beneficiaries, plan payment, adjudication outcomes, or claim frequency.","Licensed X12 and externally maintained code descriptions remain excluded even when a CSSC page references them."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cssc_operations_reference","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cssc_operations_reference_acceptable_specialty","source_fqn":"medicare_silver.cssc_acceptable_specialty","title":"CMS CSSC acceptable physician specialty history","domain":"medicare","stage":"silver","status":"live","grain":"One row per payment-year document and physical specialty-code row.","description":"Complete accepted CSSC acceptable-physician-specialty history for payment years 2016 through 2025, retaining service year, code, description, skipped-number marker, document page, physical row, raw row, release identity, and exact Bronze lineage.","identity_key":"observed_period,source_asset_id,source_row_number","row_count":794,"last_updated":"2026-07-24","freshness_sla":"Annual payment-year release; re-inventory publisher history on each governed refresh.","recollection":{"cadence":"annual","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Interpret specialty codes within the documented payment/service year and retain physical row and page lineage.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cssc_acceptable_specialty","commercial_terms":"Public CMS/CSSC specialty-list content.","known_gaps":["Payment year and service year are distinct source fields and must both be retained for temporal interpretation.","Acceptable-for-submission status is not proof that a clinician has that specialty or that an encounter was valid, paid, or risk-adjustment eligible.","Preserve source document and row identity; do not collapse the annual physical history into one timeless specialty list."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cssc_operations_reference","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cssc_operations_reference_sbsc_code","source_fqn":"medicare_silver.cssc_sbsc_code","title":"CMS CSSC Supplemental Benefit Service Category submission codes","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract-year revision and physical SBSC code row.","description":"Public CSSC SBSC encounter/reporting submission taxonomy for the initial and August 2024 revisions plus contract years 2025 and 2026, retaining revision identity, code, description, source notes, physical row, raw content, current-release state, and a mandatory PBP semantic-safety label.","identity_key":"observed_period,source_asset_id,source_row_number","row_count":403,"last_updated":"2026-07-24","freshness_sla":"Annual contract-year publication plus in-year revisions; retain every distinct revision and explicit current-release status.","recollection":{"cadence":"event_driven","watermark_field":"observed_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Annual contract-year releases and in-year revisions are both events. Every row must retain pbp_semantic_status=operational_submission_code_not_evidence_of_benefit_offer_amount_or_moop; never project SBSC presence to a plan benefit.","watermark_field 'observed_period' is the M-2 envelope column for the period the data describes, here the accepted publisher release or corpus snapshot the row was parsed from (docs/architecture/2026-05-09-medicare-substrate-m2-temporal-triplet.md); asserted_at is the date that bytes-version was published."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cssc_sbsc_code","commercial_terms":"Public CMS/CSSC submission-code content.","known_gaps":["SBSC is an encounter/reporting submission taxonomy and is not evidence that a plan offers a benefit, a benefit amount, member cost share, utilization, PMPM value, combined limit, or MOOP treatment.","A null or absent PBP numeric amount is not $0; benefit interpretation remains in the governed PBP/MPF/SB/EOC/ANOC reconciliation layer, not this table.","Contract years 2025 and 2026 code 18c preserves the publisher note that the reporting code is not part of that contract year's PBP.","The initial and August 2024 revisions are both retained; only the August revision is current for that contract year."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_cssc_operations_reference","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["observed_period","source_asset_id","source_row_number"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ahrq_nhqdr_quality","source_fqn":"medicare_silver.fact_ahrq_nhqdr_quality","title":"AHRQ NHQDR national and state quality estimates","domain":"medicare","stage":"silver","status":"live","grain":"One row per accepted Tableau publisher extract, physical page, and physical row ordinal.","description":"Lossless 855,292-row extract of the official AHRQ National Healthcare Quality and Disparities Report logical table, preserving 666 measures, national and 59 state/territory jurisdiction labels, population subgroups, raw/formatted estimates, error values, footnotes, source links, physical row identity, and exact lineage for data years 1999-2022.","identity_key":"publisher_extract_id,source_page_number,source_row_ordinal","row_count":855292,"last_updated":"2026-08-09","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ahrq_nhqdr_quality","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ahrq_nhqdr","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["publisher_extract_id","source_page_number","source_row_ordinal"],"backing_store":"glue"},{"source_id":"state_quality_publisher_semantic","source_fqn":"medicare_semantic.vw_state_quality_publisher","title":"Publisher-native state quality measures","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per publisher, state, reporting year, program/population/methodology, and measure observation.","description":"Governed standard view over AHRQ NHQDR estimates, CMS Medicaid/CHIP Child and Adult Core Set state rates, Medicaid Health Home program quality cells, and CDC NHSN state HAI progress ratios, preserving raw values, sentinels, methodology, setting, ratio type, physical publisher-observation identity, and exact atomic lineage.","identity_key":"source_id,source_observation_key","row_count":596762,"last_updated":"2026-08-09","freshness_sla":"Refresh after either accepted atomic source publishes a new governed vintage.","recollection":{"cadence":"derived","watermark_field":"asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve publisher-native value status and raw value; null, DS, NR, #, NA, and insufficient denominator are not zero.","watermark_field 'asserted_at' is the underlying atomic source's M-2 publication date carried through the view; the view is derived, so it is exactly as fresh as its accepted inputs."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_quality_publisher","commercial_terms":"Public CMS and CDC quality data; freely downloadable.","known_gaps":["The view standardizes AHRQ NHQDR 1999-2022, NHSN 2009-2024, Medicaid/CHIP Core Set 2019-2024, and Medicaid Health Home 2019-2024.","Publisher-native state observations are never pooled into a composite rank.","Four publisher-ambiguous NHSN rows remain in the atomic table and are excluded from this analytics view."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_state_quality","dataset_assignment_basis":"source_id_prefix","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["source_observation_key"],"backing_store":"glue"},{"source_id":"state_quality_rollup_semantic","source_fqn":"medicare_semantic.vw_state_quality_rollup","title":"CMS provider and clinician state quality distributions","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per source, provider-location state, reporting-period type, reporting period, and measure.","description":"Explicitly Vlada-derived unweighted state distributions across 12 certified CMS quality families covering hospitals, QPP/MIPS clinicians or groups, nursing homes, home health, hospice, dialysis facilities, and ESRD QIP.","identity_key":"source_id,state_code,reporting_period_type,reporting_period,measure_id","row_count":259838,"last_updated":"2026-08-09","freshness_sla":"Refresh after any underlying certified CMS quality family changes schema or publishes a new accepted vintage.","recollection":{"cadence":"derived","watermark_field":"source_asserted_at","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["No cross-measure pooling; no hidden beneficiary weighting; observed and missing counts must remain visible.","watermark_field 'source_asserted_at' is the M-2 asserted_at of the underlying certified CMS quality family row, carried through the rollup; the view is derived and only as fresh as that input."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_quality_rollup","commercial_terms":"Derived from public CMS quality data; freely downloadable source substrate.","known_gaps":["Provider or practice location is not beneficiary residence and must not be labeled as a resident outcome rate.","Distributions are unweighted source-record summaries; they do not reproduce claims-attributed longitudinal physician outcomes.","Source-native units remain measure-specific and are never pooled into a universal state score.","Records with unknown geography remain in atomic tables and are excluded from state distributions."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_state_quality","dataset_assignment_basis":"source_id_prefix","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":["source_id"],"unmapped_key_tokens":["measure_id","reporting_period","reporting_period_type"],"backing_store":"glue"},{"source_id":"curated_dim_contract","source_fqn":"vlada_curated.dim_contract","title":"Medicare contract dimension","domain":"medicare","stage":"dim","status":"live","grain":"One row per Medicare contract_id — the authority for cms:contract_id.","description":"The resolving dimension for Medicare contract_id, built because 89 catalogued assets carried the identifier and nothing defined it. Population is the UNION of contract_id observed across seven sources (monthly contract enrollment, stars contracts, MA contract service area, plan- and county-level enrollment, landscape, SNP), because per-source counts disagree by up to 300 and no single source is authoritative. Attributes are LAST OBSERVED with the observation month carried alongside, so staleness is visible rather than assumed; they are not modelled per year, which would make this a slowly-changing fact and fan out every join through it.","identity_key":"contract_id","row_count":2166,"last_updated":"2026-08-15","raw_queryable_via":"Athena (read-only): vlada_curated.dim_contract","notes":"Measured 2026-08-15 at 100.0% coverage against six contract-carrying fact assets. Built by ops/scripts/build_dim_contract.py using the versioned pattern; the view repoints and nothing is dropped.","superseded_by":null,"tools":[],"dataset_id":"vlada_spine_medicare_contract_authority","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"curated_dim_hcpcs","source_fqn":"vlada_curated.dim_hcpcs","title":"HCPCS code dimension","domain":"curated","stage":"dim","status":"live","grain":"One row per HCPCS code — the authority for cms:hcpcs.","description":"The resolving dimension for HCPCS, built because 19 catalogued assets carried the identifier and the only candidate authority was dim_provider_service, a provider-by-service fact holding roughly 1,988 rows per code. Population is the union of codes across the PFS RVU, OPPS Addendum B, ASC Addendum, CLFS and ASP fee schedules plus the provider-service fact. Descriptions are taken in source precedence, a CMS fee-schedule descriptor before a claims-aggregate label, and description_source records which supplied it.","identity_key":"hcpcs_code","row_count":24855,"last_updated":"2026-08-15","freshness_sla":"Rebuilt when any contributing fee schedule refreshes.","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt from the annual fee-schedule refreshes; the code set only grows."]},"raw_queryable_via":"Athena (read-only): vlada_curated.dim_hcpcs","commercial_terms":"Public CMS data. Level I (CPT) descriptors are AMA-copyrighted; only short descriptors published by CMS in its fee schedules are carried.","provenance_chain_ref":"Derived; each contributing fee schedule carries its own M-2 chain.","context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["2,376 codes match neither the Level I nor Level II pattern and are typed 'unknown' rather than dropped.","5 codes carry no description because no contributing source published one.","Descriptions are short descriptors, not the full CPT long descriptors, which are AMA-licensed."],"notes":"Measured 2026-08-15 at 100.0% coverage over five HCPCS-carrying assets, uniqueness 1.0. Built by ops/scripts/build_dim_hcpcs.py; every source read is pinned to is_current where the column exists.","superseded_by":null,"tools":[],"dataset_id":"vlada_spine_billing_code_vocabulary","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:hcpcs"],"entity_key_columns":{"cms:hcpcs":["hcpcs_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"curated_dim_provider_ccn","source_fqn":"vlada_curated.dim_provider_ccn","title":"Medicare provider CCN dimension (all provider types)","domain":"provider_identity","stage":"dim","status":"live","grain":"One row per Medicare CCN across ALL provider types — the authority for cms:ccn.","description":"The resolving dimension for Medicare CCNs of every provider type, built because cms:ccn is a family rather than one identifier. A CCN identifies a Medicare-certified provider and the type is encoded in the number, so the hospital identity dimension resolved hospitals at 99.9% and SNF, home-health, hospice, FQHC, RHC, ASC and dialysis rosters at roughly 0%. Built as the union of the ten rosters we already hold, each authoritative for its own type, rather than from CMS positional range conventions.","identity_key":"ccn","row_count":101528,"last_updated":"2026-08-15","freshness_sla":"Rebuilt when any contributing POS roster refreshes (quarterly).","recollection":{"cadence":"quarterly","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Rebuilt from the quarterly CMS Provider of Services rosters."]},"raw_queryable_via":"Athena (read-only): vlada_curated.dim_provider_ccn","commercial_terms":"Public CMS data.","provenance_chain_ref":"Derived; each contributing roster carries its own M-2 chain.","context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["513 CCNs (0.5%) appear in more than one roster, overwhelmingly LTCH and IRF facilities that are also hospitals. The most specific roster wins; all_provider_types retains every roster that claimed the CCN.","provider_type is evidenced by which roster carried the CCN, not decoded from the CCN positional ranges.","Coverage follows the rosters. A provider type we hold no roster for is absent."],"notes":"Measured 2026-08-15 - every roster that scored roughly 0% against the hospital dimension scores 100.0% here, and the hospital mart holds at 99.9%. Built by ops/scripts/build_dim_provider_ccn.py; every source read is pinned to is_current where the column exists.","superseded_by":null,"tools":["resolve_provider"],"dataset_id":"vlada_w5_identity_graph","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"curated_dim_state","source_fqn":"vlada_curated.dim_state","title":"US state and territory dimension","domain":"curated","stage":"dim","status":"live","grain":"One row per USPS state or territory code — the authority for usps:state.","description":"The resolving dimension for USPS state codes, built because the only candidate authority was dim_state_metric, a metrics fact grained (state_code, domain, metric) holding roughly 37 rows per state. Population is dim_geography's state set unioned with every state code actually observed in the assets that use the identifier, so a state referenced by a metrics table but absent from the ZIP-derived geography is still resolvable.","identity_key":"state_code","row_count":56,"last_updated":"2026-08-15","freshness_sla":"Static; rebuilt when dim_geography refreshes.","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Static reference; changes only when dim_geography is rebuilt."]},"raw_queryable_via":"Athena (read-only): vlada_curated.dim_state","commercial_terms":"Public Census and USPS reference data.","provenance_chain_ref":"Derived from vlada_curated.dim_geography.","context_doc_path":"docs/context_library/curated/core_curated_dims.md","known_gaps":["56 codes = 50 states, DC and 5 territories. Coverage follows what our data references, not the full USPS code list.","attribute_source records whether a code came from dim_geography or was observed only in a metrics table; the latter carries null attributes rather than invented ones."],"notes":"Built by ops/scripts/build_dim_state.py. Population derived from data rather than written from memory, for the same reason dim_provider_ccn was built from rosters instead of CMS range conventions.","superseded_by":null,"tools":[],"dataset_id":"vlada_spine_geography_hierarchy","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_marketplace_issuer_plan_enrollment_history","source_fqn":"medicare_silver.fact_marketplace_plan_enrollment_measure_history","title":"CMS Marketplace issuer and plan enrollment measure history","domain":"commercial","stage":"silver","status":"live","grain":"One source-native plan measure observation per business year, platform, issuer, plan, workbook sheet row, and immutable workbook artifact.","description":"CMS annual Marketplace plan-level enrollment measures across federal-platform and independent state-based Marketplace workbooks through business year 2025, preserving measure eras, suppression, exact plan identifiers, and workbook/Bronze lineage.","identity_key":"source_id,source_workbook_sha256,workbook_sheet,source_row_number,source_measure_name","row_count":233906,"last_updated":"2026-08-31","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Changed workbook bytes coexist as a new immutable artifact; repeated identical cumulative SBM data units do not create duplicate facts.","Never substitute the state-level monthly file for issuer or plan data.","watermark_field 'business_year' is the Marketplace plan (business) year the enrollment measure was published for; it is not the workbook release date, which is carried by the immutable artifact identity."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_marketplace_plan_enrollment_measure_history","known_gaps":["The physical history has is_current=false on every accepted row; do not filter is_current=true. No semantic current view is published.","Suppressed asterisk values are unknown counts of ten or fewer with numeric_value=null, not zero; numeric sums are lower bounds.","The 2021 parallel federal methodologies must remain separate and qualified.","Plan rows and issuer-geography rows are separate, non-additive facts.","The accepted parent bridge and Plan Attributes analytical joins are not published by this source release.","PY2026 issuer-level data was not yet published as of August 31, 2026."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_marketplace_issuer_level_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id","source_row_number"],"unmapped_key_tokens":["source_measure_name","source_workbook_sha256","workbook_sheet"],"backing_store":"glue"},{"source_id":"cms_marketplace_issuer_geography_enrollment_history","source_fqn":"medicare_silver.fact_marketplace_issuer_geography_enrollment_measure_history","title":"CMS Marketplace issuer geography enrollment measure history","domain":"commercial","stage":"silver","status":"live","grain":"One source-native issuer geography measure observation per business year, federal platform, issuer, county or state-total, workbook sheet row, and immutable workbook artifact.","description":"CMS annual federal-platform issuer-by-county and issuer-state-total Marketplace enrollment and demographic measures through business year 2025, preserving suppression, geography grain, measure eras, and workbook/Bronze lineage.","identity_key":"source_id,source_workbook_sha256,workbook_sheet,source_row_number,source_measure_name","row_count":3296584,"last_updated":"2026-08-31","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Preserve county, state-total, and unknown-county grains separately.","Never project issuer geography to individual plans.","watermark_field 'business_year' is the Marketplace plan (business) year the issuer geography measure was published for; it is not the workbook release date, which is carried by the immutable artifact identity."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_marketplace_issuer_geography_enrollment_measure_history","known_gaps":["The physical history has is_current=false on every accepted row; do not filter is_current=true. No semantic current view is published.","Federal issuer-county rows do not identify a plan, and independent-SBM plan rows do not publish county geography.","County rows and issuer-state-total rows must not be added together.","Suppressed asterisk values are unknown counts of ten or fewer; numeric geographic sums are lower bounds.","This release publishes no issuer-to-parent edge and no plan-county edge."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_marketplace_issuer_level_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id","source_row_number"],"unmapped_key_tokens":["source_measure_name","source_workbook_sha256","workbook_sheet"],"backing_store":"glue"},{"source_id":"vlada_hix_state_enrollment_observation_v1","source_fqn":"medicare_semantic.vw_hix_state_enrollment_observation_v1","title":"State-based exchange enrollment observations - seven state marketplaces' own published figures, one view","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One reviewed-current source observation; (source_id, release_key, artifact_id, semantic_release_id, content_unit, row_ordinal) is unique (measured 2026-09-25, 232,589 rows = 232,589 distinct keys, Athena e0877aa7).","description":"The enrollment figures seven state-based marketplaces publish themselves (CA Covered California, KY kynect/KHBE, NJ DOBI and GetCoveredNJ, NY State of Health, VA Insurance Marketplace, WA Healthplanfinder), projected from the reviewed-current observation_json into typed columns: state, source, release, observation period and its kind, measure name, unit, market scope, geography, issuer, plan, breakdown axis and value, value and suppression status, with full file lineage. It is the observation layer under the enrollment_mix mart, NOT the mart: measure basis (selection, paid, effectuated, current) and population are not classified.","identity_key":"source_id,release_key,artifact_id,semantic_release_id,content_unit,row_ordinal","row_count":232589,"last_updated":"2026-09-25","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1","notes":"Registered 2026-09-25 (Data Tracker states program, lane B) under register w4 vlada_w4_hix_state_enrollment_observation, door RAW. status partial: 7 of about 21 state-based exchanges, measure basis unclassified, NY unverified. Versioned, never overwritten: a changed projection is _v2 beside this one. The two underlying medicare_silver tables stay uncatalogued (baselined drift); the view is the door.","superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_state_enrollment_observation","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["artifact_id","content_unit","release_key","row_ordinal","semantic_release_id"],"backing_store":"glue"},{"source_id":"cms_cciio_rate_review_puf_history","source_fqn":"medicare_silver.fact_rate_review_puf_history","title":"CCIIO Unified Rate Review PUF (URRT Part I) - filings, plans and rating-area factors, PY2024-PY2026","domain":"commercial","stage":"silver","status":"partial","grain":"One publisher CSV row per (plan_year, sha256_content_hash, worksheet, source_row_number); WKSH1 is one row per filing, WKSH2 one row per plan, WKSH3 one row per issuer x market x rating area. Measured 2026-09-25, 285,554 rows = 285,554 keys (Athena 942ed2c8).","description":"The Part I Unified Rate Review Template data CMS publishes for every single-risk-pool rate filing, individual and small group, on and off exchange, 50 states and DC. Worksheet I per filing (issuer, market, effective date, filing cycle and status), Worksheet II per plan (cumulative proposed rate change as last filed and as first filed, current enrollment, projected member months, review determination), Worksheet III per rating-area factor. Lossless: the ordered header and raw values of every row are kept beside the typed columns.","identity_key":"plan_year,sha256_content_hash,worksheet,source_row_number","row_count":285554,"last_updated":"2026-09-25","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_rate_review_puf_history","notes":"Registered 2026-09-25 (Data Tracker states program, lane B) under register w4 cms_cciio_rate_review_puf (the Lane G draft from #2746, uncommented after the medicare-fleet load). Door RAW, Data Tracker KPI MKT-14. Rates are fractions. History-only: listed in vlada/query/versioned_tables.json history_only so the door never injects is_current.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_rate_review_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year","source_row_number"],"unmapped_key_tokens":["sha256_content_hash","worksheet"],"backing_store":"glue"},{"source_id":"cms_hhs_risk_adjustment_transfers_history","source_fqn":"medicare_silver.fact_aca_risk_adjustment_transfer_history","title":"HHS risk adjustment transfers by issuer (summary report appendices C and D), BY2021-BY2025","domain":"commercial","stage":"silver","status":"partial","grain":"One amount cell per (benefit_year, sha256_content_hash, source_appendix, sheet_name, source_row_number, source_column_number), i.e. one issuer x state x amount column of one appendix file. Measured 2026-09-25, 17,322 rows = 17,322 keys (Athena 24f71ef5).","description":"The issuer tables of CMS's Summary Report on Individual and Small Group Market Risk Adjustment Transfers, published each June 30 for the prior benefit year: Appendix C (non-merged markets) and Appendix D (merged markets, MA and ME), long form, one row per issuer and amount column. program_component is state_transfer (per state market risk pool: individual non-catastrophic, individual catastrophic, small group, merged) or high_cost_risk_pool; amount_usd is signed; amount_status keeps the publisher dash as no_enrollment_in_pool.","identity_key":"benefit_year,sha256_content_hash,source_appendix,sheet_name,source_row_number,source_column_number","row_count":17322,"last_updated":"2026-09-25","freshness_sla":"Annual, each June 30 for the prior benefit year; CMS can revise appendices afterwards (BY2024 revised 2025-07-23), and each byte version is kept.","recollection":{"cadence":"annual","watermark_field":"benefit_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["CMS revises appendices after June 30; keep every byte version (identity partition benefit_year x sha256_content_hash) and read the latest asserted_at per benefit_year and source_appendix.","watermark_field 'benefit_year' is the benefit year the transfers settle; the report is published the following June 30."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_aca_risk_adjustment_transfer_history","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_hhs_risk_adjustment_transfers_current_manifest.json","known_gaps":["REVISED AND ORIGINAL APPENDICES ARE BOTH HELD. BY2024 carries the original (2025-06-30) and the revised (2025-07-23) appendices as full copies (2,850 C + 57 D rows each), so an unpinned BY2024 sum counts every issuer twice. Read the latest asserted_at per benefit_year and source_appendix (BY2021's C and D carry different dates). The BY2024 revised report still prints the original summary totals.","Transfers are signed: positive is a payment to the issuer, negative a charge, and a state market risk pool nets to about zero (largest net $0.80). Use the positive side (payments) or abs() for the size of transfers, never the net sum.","A publisher dash is no enrollment in that pool: amount_status no_enrollment_in_pool, amount_usd NULL (6,971 rows), never zero.","is_current is FALSE on every row by design (immutable physical history); a filter is_current = true returns nothing.","June 30 amounts are before HHS-RADV adjustments (a separate report about a year later); default risk adjustment charges (Appendix E/F) are not in this table, so issuer counts differ from the report by the default-charge issuers.","Only BY2021-BY2025 are loaded; BY2014-BY2020 issuer tables are not header-reviewed."],"notes":"Registered 2026-09-25 (Data Tracker states program, lane B) under register w4 cms_hhs_risk_adjustment_transfers (the Lane G draft from #2746, uncommented after the medicare-fleet load). Door RAW, Data Tracker KPI MKT-15. BY2025 reconciles to the CMS report: payments $11.17B, high-cost risk pool $851.3M individual incl. merged and $420.3M small group (Athena 1ea2adbb). History-only: listed in vlada/query/versioned_tables.json history_only so the door never injects is_current.","superseded_by":null,"tools":[],"dataset_id":"cms_hhs_risk_adjustment_transfers","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["sheet_name","source_row_number"],"unmapped_key_tokens":["benefit_year","sha256_content_hash","source_appendix","source_column_number"],"backing_store":"glue"},{"source_id":"cms_marketplace_monthly_effectuated_enrollment_history","source_fqn":"medicare_silver.fact_marketplace_monthly_effectuated_enrollment_history","title":"CMS Marketplace monthly effectuated enrollment release history","domain":"commercial","stage":"silver","status":"live","grain":"One state-or-publisher-total by platform, coverage year, and coverage month observation inside one immutable CMS release artifact.","description":"CMS rolling monthly Marketplace effectuated enrollment by state and exchange platform from January 2016 through February 2026 in the accepted release, retaining release identity, publisher totals, and Bronze lineage.","identity_key":"source_id,source_artifact_sha256,state_code,platform,coverage_year,coverage_month","row_count":6588,"last_updated":"2026-08-31","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_marketplace_monthly_effectuated_enrollment_history","notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_marketplace_monthly_effectuated_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":["source_id"],"unmapped_key_tokens":["coverage_month","coverage_year","platform","source_artifact_sha256"],"backing_store":"glue"},{"source_id":"ga_georgia_access_puf","source_fqn":"ga_georgia_access_puf","title":"Georgia Access Marketplace PUF — direct state publisher history","domain":"commercial","stage":"silver","status":"planned","grain":"One logical source-native CSV row within one immutable Georgia Access artifact, family, and plan year.","description":"Georgia Access direct PY2025-PY2026 Marketplace plan-management exports across Benefits and Cost Sharing, Rate, Plan Attributes, Business Rules, Service Area, Network, Plan ID Crosswalk, Machine-Readable URL and Quality families. This source remains distinct from CMS independent-SBE Georgia packages.","identity_key":"source_id,plan_year,family,source_artifact_sha256,source_row_number","row_count":null,"last_updated":"2026-10-12","raw_queryable_via":"Not queryable. Bronze held since 2026-10-12: all 18 direct PY2025-PY2026 files (byte-identical to the 2026-09-02 pins) are at s3://vlada-platform-raw/medicare/bronze/ga_georgia_access_puf/PY<year>/<family>/ (cloud run 20261013T003738Z-271ad7a1). No silver table, view or tool yet.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ga_georgia","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year","source_id","source_row_number"],"unmapped_key_tokens":["family","source_artifact_sha256"],"backing_store":"logical_not_ingested"},{"source_id":"cms_independent_sbe_packages","source_fqn":"cms_independent_sbe_packages","title":"CMS independent State-based Exchange QHP PUF packages - plan, benefit and premium detail for the states not on HealthCare.gov (PY2016-PY2026)","domain":"commercial","stage":"raw","status":"live","grain":"One publisher CSV row per (plan_year, state, family, archive member, source_row_number) inside one immutable CMS state/year ZIP.","description":"The six Exchange PUF families (Benefits & Cost Sharing, Rate, Plan Attributes, Business Rules, Service Area, Network) that CMS republishes for each independent State-based Exchange in its SBE template: 195 state/year packages (17 states in PY2016 to 22 in PY2026) plus 11 annual dictionary ZIPs. With the federal-platform PUFs they cover all 51 jurisdictions for PY2016-PY2026.","identity_key":"plan_year,state,family,archive_member_sha256,source_row_number","row_count":20911204,"last_updated":"2026-10-13","freshness_sla":"Re-parse the CMS state-based PUF page monthly and on any change capture the new or changed ZIP byte-exact to bronze (tools/data_tracker/sbe_puf_capture.py --capture-bronze); PY2027 packages are expected spring-summer 2027.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["plan_year is the package year on the CMS page, not a publisher revision timestamp.","Changed bytes coexist as a new immutable object and never overwrite."]},"raw_queryable_via":"Athena (read-only via query_substrate) through the six sibling tables, one per family: medicare_silver.fact_sbe_plan_attributes_puf_history, fact_sbe_benefits_cost_sharing_puf_history, fact_sbe_business_rules_puf_history, fact_sbe_service_area_puf_history, fact_sbe_network_puf_history and fact_sbe_rate_puf_history (20,911,204 rows, PY2016-2026, loaded 2026-10-13). All 206 publisher ZIPs (153,871,791 B) stay byte-exact in s3://vlada-platform-raw/medicare/bronze/cms_independent_sbe_packages/.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_independent_sbe_puf_member_manifest_2026_10_12.json","known_gaps":["The SBE template differs from the federal layout (0 of 1,145 CSV members share the federal header). Dry run with the federal parsers plus a spelling-only alias table: 880 state-year-family cells ready (15,580,950 rows); 248 gated on four reviewed decisions (Service Area true/false values 168, Rate CoupleAndTwoOrMoreDependents tier label and blank header cells 64, PY2017 Business Rules 14, WA PY2018 two Plan files 2).","No copay or coinsurance columns in the SBE Benefits & Cost Sharing template (all 195 packages): benefit-level cost sharing for SBE plans is not in any CMS PUF.","No packages before PY2016: 29 SBE state-years in PY2014-PY2015 have no plan-level CMS file.","Publisher absences and empty members are first-class: e.g. CA Business Rules absent PY2016-2021 and empty PY2022-2026; VT Service Area and Network absent PY2016-2021 and empty PY2022-2025; DC Service Area absent PY2016-2020.","Oregon (every year) and AR, MS, UT, NM in some years appear in both the federal PUF and an SBE package (22 state-years); overlap is unmeasured, so no union.","LOADED 2026-10-13 (supersedes the dry-run and 'overlap is unmeasured, so no union' lines above): 1,126 state-year-family cells, 20,911,204 rows in six sibling tables (Plan Attributes 113,005; Benefits 8,401,524; Business Rules 219,047; Service Area 115,672; Network 5,292; Rate 12,056,664), PY2016-2026, 0 is_current (Athena 9f6177ba, 4d0b683d, 541de06f, c319e6ba, 76eaed22, 4f9d969a). 2 cells stay gated (MA PY2017 Service Area; WA PY2018 original Plan file, its round3 revision loaded). Loaded 2026-10-13 by the coordinator through pipelines/medicare/ingest/independent_sbe_puf_runner.py --write (proof cell tracker-runs/20261013T051002Z-b7981e0c; full load 20261013T051148Z-b7981e0c committed 1,125 cells; re-run 20261013T074520Z-b7981e0c committed 0 and skipped 1,126 held cells).","Overlap measured 2026-10-13: 22 state-years are in both the federal PUF and an SBE package; there the SBE package is the state's SHOP exchange and the federal PUF the individual market (0 shared plans in Plan Attributes, Athena 4bfd6e2c), except the PY2019 AR, NM and OR SBE Rate files, which repeat 172 federal individual plans (Athena 617f479b). Union by family with DISTINCT state-years and plan ids; see the table cards."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_independent_sbe_packages","dataset_assignment_basis":"manual","layer":"raw","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":["plan_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256","family"],"backing_store":"logical_not_ingested"},{"source_id":"va_vim_enrollment_metrics","source_fqn":"va_vim_enrollment_metrics","title":"Virginia Insurance Marketplace enrollment metrics — state publisher history","domain":"commercial","stage":"silver","status":"partial","grain":"One source-native metric observation within one immutable Virginia artifact, publisher snapshot/as-of date, page and source row or metric ID.","description":"Virginia Insurance Marketplace PY2024 quarterly/OE and two byte-distinct but semantically equal PY2025 metric-ID static revisions, plus a separately resolved public Power BI model containing Open Enrollment PY2024-PY2026, quarterly 2025-Q1 through 2026-Q2 and source dictionaries. Pre-PY2024 federal-platform history retains CMS lineage.","identity_key":"source_id,source_artifact_sha256,plan_year,snapshot_label,metric_id_or_source_page_row","row_count":286,"last_updated":"2026-10-12","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1 WHERE source_id = 'va_vim_enrollment_metrics' (registered 2026-09-25 under w4 vlada_w4_hix_state_enrollment_observation, door RAW). The physical history (medicare_silver.fact_hix_state_artifact_revision_history, source_observation_history, reviewed_current_pointer_history) stays uncatalogued by design; the view is the door.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_va_vim","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year","source_id"],"unmapped_key_tokens":["metric_id_or_source_page_row","snapshot_label","source_artifact_sha256"],"backing_store":"logical_not_ingested"},{"source_id":"ky_khbe_governors_metrics","source_fqn":"ky_khbe_governors_metrics","title":"Kentucky KHBE Governor's Metrics — monthly state publisher history","domain":"commercial","stage":"silver","status":"partial","grain":"One source-native metric observation within one immutable Kentucky workbook, report period, sheet, source row and metric-header column.","description":"Forty-seven exact Kentucky Health Benefit Exchange workbooks covering 46 monthly semantic units and 232,590 non-duplicated QHP/Medicaid metric observations by program, plan, issuer/metal, county, age, gender and FPL, with Logic/Glossary revision context.","identity_key":"source_id,source_artifact_sha256,report_period,sheet_name,source_row_number,metric_column_index","row_count":159920,"last_updated":"2026-10-12","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1 WHERE source_id = 'ky_khbe_governors_metrics' (registered 2026-09-25 under w4 vlada_w4_hix_state_enrollment_observation, door RAW). The physical history (medicare_silver.fact_hix_state_artifact_revision_history, source_observation_history, reviewed_current_pointer_history) stays uncatalogued by design; the view is the door.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ky_khbe","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["sheet_name","source_id","source_row_number"],"unmapped_key_tokens":["metric_column_index","report_period","source_artifact_sha256"],"backing_store":"logical_not_ingested"},{"source_id":"ca_covered_california_enrollment_profiles","source_fqn":"ca_covered_california_enrollment_profiles","title":"Covered California enrollment profiles — state publisher history","domain":"commercial","stage":"silver","status":"partial","grain":"One source-native observation within one immutable Covered California workbook, profile family, publisher period, sheet and source cell or row.","description":"Covered California Open Enrollment, active paid/effective member, Medi-Cal transitioner and special-enrollment profile history with issuer, plan, geography, subsidy and demographic detail.","identity_key":"source_id,source_artifact_sha256,profile_family,publisher_period,sheet_name,source_cell_or_row","row_count":13941,"last_updated":"2026-10-12","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1 WHERE source_id = 'ca_covered_california_enrollment_profiles' (registered 2026-09-25 under w4 vlada_w4_hix_state_enrollment_observation, door RAW). The physical history (medicare_silver.fact_hix_state_artifact_revision_history, source_observation_history, reviewed_current_pointer_history) stays uncatalogued by design; the view is the door.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ca_covered","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["sheet_name","source_id"],"unmapped_key_tokens":["profile_family","publisher_period","source_artifact_sha256","source_cell_or_row"],"backing_store":"logical_not_ingested"},{"source_id":"nj_getcoverednj_enrollment","source_fqn":"nj_getcoverednj_enrollment","title":"Get Covered New Jersey enrollment — state exchange history","domain":"commercial","stage":"silver","status":"partial","grain":"One source-native observation within one immutable New Jersey exchange PDF, carrier quarter or OE checkpoint, measure, unit and optional HIOS/metal/assistance dimension.","description":"Quarterly HIOS carrier policies and members plus Open Enrollment renewal, new-selection, financial-assistance, metal and Medicaid/CHIP transfer checkpoints for PY2021-PY2026.","identity_key":"source_id,source_artifact_sha256,publication_family,publisher_period,measure,unit,hios_or_dimension","row_count":863,"last_updated":"2026-10-12","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1 WHERE source_id = 'nj_getcoverednj_enrollment' (registered 2026-09-25 under w4 vlada_w4_hix_state_enrollment_observation, door RAW). The physical history (medicare_silver.fact_hix_state_artifact_revision_history, source_observation_history, reviewed_current_pointer_history) stays uncatalogued by design; the view is the door.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_nj_getcoverednj","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["hios_or_dimension","measure","publication_family","publisher_period","source_artifact_sha256","unit"],"backing_store":"logical_not_ingested"},{"source_id":"nj_dobi_ihc_enrollment","source_fqn":"nj_dobi_ihc_enrollment","title":"New Jersey DOBI IHC enrollment — on/off-exchange history","domain":"commercial","stage":"silver","status":"partial","grain":"One source-native individual-market observation within one immutable NJDOBI IHC artifact, quarter, market scope, measure and optional carrier/plan dimension.","description":"New Jersey individual-market covered lives, source-native Plans and policy/contract operating measures from 1993 Q4 forward; ten exact parser families yield 30,198 physical observations from all 173 retrievable unique artifacts including cumulative revisions and two off-index 2021 Q2 recoveries.","identity_key":"source_id,source_artifact_sha256,publisher_period,market_scope,measure,hios_or_dimension","row_count":30198,"last_updated":"2026-10-12","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1 WHERE source_id = 'nj_dobi_ihc_enrollment' (registered 2026-09-25 under w4 vlada_w4_hix_state_enrollment_observation, door RAW). The physical history (medicare_silver.fact_hix_state_artifact_revision_history, source_observation_history, reviewed_current_pointer_history) stays uncatalogued by design; the view is the door.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_nj_dobi","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["hios_or_dimension","market_scope","measure","publisher_period","source_artifact_sha256"],"backing_store":"logical_not_ingested"},{"source_id":"wa_hbe_enrollment_reports","source_fqn":"wa_hbe_enrollment_reports","title":"Washington Health Benefit Exchange enrollment reports — state publisher history","domain":"commercial","stage":"silver","status":"partial","grain":"One source-native observation within one immutable Washington HBE workbook or report, release, sheet/cell, period, population, measure and optional geography/carrier/dimension.","description":"Washington Healthplanfinder QHP, Apple Health, dental, carrier, county, subsidy, premium, demographic, movement and Cascade Care reporting; all 51,568 populated cells in eight exact spring/fall workbooks are losslessly profiled, with 935 spring-core observations normalized separately and five unique legacy PDFs Wayback-recovered.","identity_key":"source_id,source_artifact_sha256,release_label,worksheet,source_cell,period,population,measure,dimension","row_count":2190,"last_updated":"2026-10-12","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1 WHERE source_id = 'wa_hbe_enrollment_reports' (registered 2026-09-25 under w4 vlada_w4_hix_state_enrollment_observation, door RAW). The physical history (medicare_silver.fact_hix_state_artifact_revision_history, source_observation_history, reviewed_current_pointer_history) stays uncatalogued by design; the view is the door.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_wa_hbe","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["period","source_id"],"unmapped_key_tokens":["dimension","measure","population","release_label","source_artifact_sha256","source_cell","worksheet"],"backing_store":"logical_not_ingested"},{"source_id":"ny_nysoh_enrollment_data","source_fqn":"ny_nysoh_enrollment_data","title":"NY State of Health enrollment reports — direct publisher history","domain":"commercial","stage":"silver","status":"partial","grain":"One source-native EP, QHP or dental enrollment observation within one immutable official PDF, report period, geography, issuer and measure.","description":"One hundred three official NY State of Health enrollment PDFs, including a parsed 37-report statewide Essential Plan and QHP current-enrollment series from March 2023 through August 2026.","identity_key":"source_id,source_artifact_sha256,coverage_month,geography_type,geography_value,hios_or_all,measure,unit","row_count":25191,"last_updated":"2026-10-12","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_state_enrollment_observation_v1 WHERE source_id = 'ny_nysoh_enrollment_data' (registered 2026-09-25 under w4 vlada_w4_hix_state_enrollment_observation, door RAW). The physical history (medicare_silver.fact_hix_state_artifact_revision_history, source_observation_history, reviewed_current_pointer_history) stays uncatalogued by design; the view is the door.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ny_nysoh","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["coverage_month","geography_type","geography_value","hios_or_all","measure","source_artifact_sha256","unit"],"backing_store":"logical_not_ingested"},{"source_id":"vt_vhc_data_surfaces","source_fqn":"vt_vhc_data_surfaces","title":"Vermont Health Connect plan, rate, quality and OE overview surfaces","domain":"commercial","stage":"silver","status":"planned","grain":"One immutable source-native PDF within a Vermont plan-design/rate, QHP satisfaction or Open Enrollment overview family.","description":"Eight distributed official pages resolve to 18 exact PDFs for PY2022-PY2026; the current direct site does not expose a granular enrollment-result history.","identity_key":"source_id,source_artifact_sha256,source_family,publisher_period","row_count":null,"last_updated":"2026-09-02","raw_queryable_via":"Not queryable: exact PDF bytes are profiled, but no Vermont-direct physical history or semantic table is accepted.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_vt_vhc","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["publisher_period","source_artifact_sha256","source_family"],"backing_store":"logical_not_ingested"},{"source_id":"ar_aid_marketplace_surfaces","source_fqn":"ar_aid_marketplace_surfaces","title":"Arkansas Insurance Department Marketplace application surfaces","domain":"commercial","stage":"silver","status":"blocked","grain":"One candidate enrollment, rate, benefit or template artifact/application result under a publisher-native release identity.","description":"Five exact application surfaces identify 13 public candidates, but current artifact requests reset and the identified archive body is unreachable from this environment.","identity_key":"source_id,canonical_source_url,source_artifact_sha256","row_count":null,"last_updated":"2026-09-02","raw_queryable_via":"Blocked: landing evidence exists, but no artifact body or source-native observation is accepted.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ar_aid","dataset_assignment_basis":"source_id_prefix","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["canonical_source_url","source_artifact_sha256"],"backing_store":"logical_not_ingested"},{"source_id":"hix_state_artifact_history","source_fqn":"medicare_silver.fact_hix_state_artifact_revision_history","title":"State Marketplace content-addressed artifact history","domain":"provenance","stage":"registry","status":"partial","grain":"One source and logical-release revision at an exact content SHA, with separate source-native observation and reviewed-pointer histories.","description":"Common Bronze-first physical-history contract for heterogeneous state Marketplace PDFs, workbooks, JSON feeds and dashboard exports; the exact first candidate plan contains 367 occurrences and 366 unique source bodies.","identity_key":"source_id,release_key,content_sha256","row_count":524,"last_updated":"2026-10-12","raw_queryable_via":"Loaded and catalogued here (provenance row, not a customer door): medicare_silver.fact_hix_state_artifact_revision_history holds 524 artifacts across 8 sources (CA 117, KY 47, NJ DOBI 173, GetCoveredNJ 39, NY 103, VA 3, VT 18, WA 24; Athena 81f41e3b, 2026-10-12). Customers read the reviewed-current observations of 7 of them through medicare_semantic.vw_hix_state_enrollment_observation_v1 (VT has artifacts, no observations).","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_hix_state","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"registry","purpose":"provenance","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["content_sha256","release_key"],"backing_store":"glue"},{"source_id":"hix_identity_bridge","source_fqn":"medicare_silver.dim_hix_temporal_identity_bridge","title":"Marketplace temporal issuer, plan, parent and geography bridge","domain":"commercial","stage":"dim","status":"planned","grain":"One reviewed dated mapping from a source-native issuer, plan or geography key to one canonical key.","description":"Separates HIOS issuer, product, 14-character base-plan, 17-character variant, dated parent ownership and geography identities; overlapping winners fail closed.","identity_key":"mapping_type,source_id,source_key,valid_from,valid_to,canonical_key","row_count":null,"last_updated":"2026-09-02","raw_queryable_via":"Not queryable: parser and candidate profile exist, but zero production bridge rows or parent mappings are accepted.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_hix_identity","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":["canonical_key","mapping_type","source_key","valid_from","valid_to"],"backing_store":"glue"},{"source_id":"marketplace_issuer_parent_bridge","source_fqn":"medicare_silver.marketplace_issuer_parent_bridge_v1","title":"Marketplace issuer-to-parent bridge (effective-dated, as-was and as-now)","domain":"commercial","stage":"dim","status":"live","grain":"One row per (business_year, state_code, hios_issuer_id) seen in the Marketplace enrollment, Plan Attributes, risk-adjustment or rate-review sources; BY2014-2026, 8,676 rows when built.","description":"HIOS issuer -> legal entity (NAIC company code, EIN) -> NAIC group -> canonical parent id, from exact MLR/PA identity joins plus a reviewed year-ranged seed (never fuzzy); dated M&A (Aetna/CVS, Health Net, WellCare, Meridian, Fidelis -> Centene, Point32Health, AvMed -> Sentara) in two views, as it was and restated to today.","identity_key":"business_year,state_code,hios_issuer_id","row_count":8676,"last_updated":"2026-10-13","freshness_sla":"Derived. Rebuild whenever an input changes (MLR identity RY2025, enrollment PY2026, PA/RA/URR years) or the seed changes; rerun the ops/sql validations.","recollection":{"cadence":"derived","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' dates each bridge row (the plan year it was resolved for); pin it with seed_sha256 when comparing builds.","Keep hios_issuer_id beside every parent rollup.","parent_id slugs align to medicare_semantic.dim_parent_alias_v1 where the company is in MA (parent_id_in_ma_alias)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_issuer_parent_bridge_v1","commercial_terms":"Derived identity metadata from public CMS MLR and Marketplace PUFs plus cited public ownership events.","known_gaps":["MLR identity is held RY2019-2024 only; BY2014-2018 and BY2025 identities are carried from the nearest MLR year (confidence medium/low).","Small NAIC groups and a few entities remain unreviewed (listed in the context doc); reviewed parents cover 99.4-99.8% of BY2021-2025 average monthly enrollment and 97.3-99.7% of BY2014-2020 federal ever-enrolled.","TWO PARENT BASES: parent_id_as_was is the parent that year (dated M&A: Aetna -> CVS BY2019, Health Net -> Centene BY2016, WellCare and Meridian -> Centene BY2020, AvMed -> Sentara BY2023 ...); parent_id_as_now restates every year to today's company. Pick one basis per question and say which.","CONFIDENCE BY YEAR: BY2025 and BY2014-2018 identities are carried from the nearest MLR identity year (identity_year_distance > 0), so their parents are medium or low confidence (high on under 5% of those years' rows, Athena d2df6820), never exact; filter confidence = 'high' for the strict reading.","Keep hios_issuer_id beside every parent: a parent is a reviewed seed or an unreviewed NAIC group (naic_group_unreviewed, entity_only_unreviewed, unresolved), read resolution_status before ranking parents."],"notes":"Built 2026-10-13 by the coordinator from pipelines/medicare/silver/marketplace_issuer_parent_bridge_v1.sql: 8,676 rows, BY2014-2026 (Athena c7481313). Registered 2026-10-13 by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"vlada_w4_marketplace_issuer_parent_bridge","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":["business_year"],"unmapped_key_tokens":["hios_issuer_id"],"backing_store":"glue"},{"source_id":"marketplace_enrollment_by_parent","source_fqn":"medicare_semantic.vw_marketplace_enrollment_by_parent_v1","title":"Marketplace enrollment by parent company (state, national, federal vs SBM)","domain":"commercial","stage":"semantic_view","status":"live","grain":"parent_basis x parent x geography (state or US) x business_year x exchange platform x measure.","description":"Sums issuer-level enrollment PUF plan rows through the parent bridge; average monthly enrollment BY2018-2025 (federal from BY2021) and federal ever-enrolled BY2014-2021, never mixed; geography-table rows never summed; suppressed cells kept as a lower bound.","identity_key":"parent_basis,business_year,measure_name,exchange_platform,state_code,parent_id","row_count":10353,"last_updated":"2026-10-13","freshness_sla":"Derived from medicare_silver.marketplace_issuer_parent_bridge_v1 and the issuer-level enrollment PUF; refresh follows the bridge rebuild.","recollection":{"cadence":"derived","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the plan year of the summed enrollment rows; pin it when comparing releases.","Filter one measure_name and one parent_basis before summing.","exchange_platform 'all' rows exist only for average_monthly_enrollment."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_marketplace_enrollment_by_parent_v1","commercial_terms":"Derived from public CMS Marketplace PUFs.","known_gaps":["CMS average monthly (effectuated) enrollment is not 10-K period-end membership; tie-outs are recorded, not forced.","SBM history before BY2018 is not in the CMS issuer-level PUF.","NON-ADDITIVE: every row exists twice (parent_basis 'as_was' and 'as_now'), state rows and national rows sit side by side, exchange_platform 'all' repeats the federal + SBM rows, and BY2021 federal appears under both measures. Filter one parent_basis, one measure_name, one geo_level and one exchange_platform before any sum.","Medium (or low) confidence for BY2025 and BY2014-2018: parents carried from the nearest MLR identity year (Athena d2df6820); members_high_confidence is the high-confidence part of members.","members is a lower bound where n_suppressed_plan_rows > 0 (CMS suppresses 1-10)."],"notes":"Created 2026-10-13 by the coordinator from pipelines/medicare/semantic/vw_marketplace_enrollment_by_parent_v1.sql: 10,353 rows (Athena 46b5288a). Registered 2026-10-13 by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"vlada_w4_marketplace_issuer_parent_bridge","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":["business_year"],"unmapped_key_tokens":["exchange_platform","measure_name","parent_basis","parent_id"],"backing_store":"glue"},{"source_id":"hix_analytical_marts","source_fqn":"medicare_gold.mart_hix_*","title":"Marketplace analytical mart family","domain":"commercial","stage":"mart","status":"planned","grain":"One source-qualified row at the declared grain of one of seven landscape, affordability, benefit, enrollment, quality, economics or continuity marts.","description":"Seven governed mart contracts with mandatory artifact/snapshot provenance and four independent coverage scores; the first no-write enrollment candidate has 1,581 CA/NJ/NY/WA rows.","identity_key":"mart_id plus the mart-specific declared grain","row_count":null,"last_updated":"2026-09-02","raw_queryable_via":"Not queryable: no production mart or coverage sidecar exists and every API/MCP surface is disabled.","notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_hix_analytical","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["declared","grain","mart-specific","mart_id","plus","the"],"backing_store":"glue"},{"source_id":"cms_fact_pfs_gpci_locality","source_fqn":"medicare_silver.fact_pfs_gpci_locality","title":"CMS PFS Geographic Practice Cost Indices by locality, every RVU release CY2017-2026, stamped","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of one RVU release's GPCI file (calendar_year x MAC/carrier x locality); natural key (release_label, row_seq); partitioned by release_label.","description":"The GPCI member of each CMS PFS RVU release ZIP (RVU17D..RVU26C) re-collected through the provenance envelope on 2026-09-07: work_gpci, pe_gpci, mp_gpci as published, with state, carrier_number, locality_number, locality_name. CY2003-2016 (the dual-carrier era, where (calendar_year, state, locality_number) is not unique) is loadable at source grain with --include-gated-gpci and is not loaded by default. Succeeds medicare_gpci_locality (one CY2025 RDS snapshot).","identity_key":"locality_number","row_count":1111,"last_updated":"2026-09-07","freshness_sla":"Annual (PFS final rule, calendar year); refresh after each RVU release.","recollection":{"cadence":"annual","watermark_field":"calendar_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'calendar_year' is the release's calendar year; pin it (and release_label) when comparing releases (named 2026-09-07).","One release ZIP is one release_label partition; a reload of one release never touches another."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_pfs_gpci_locality","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":"pipelines/medicare/ingest/pfs_locality_runner.py (job build_medicare_pfs_locality) from the RVU release ZIPs; bronze medicare/bronze/cms_pfs_relative_value_files/; RDS registry medicare_source_registry_cache (cms_pfs_relative_value_files#locality_gpci)","context_doc_path":"docs/context_library/medicare/medicare_pfs_ipps_localization.md","known_gaps":["Localities are CMS payment localities, not counties; join via fact_pfs_locality_config (Counties text) or cms_zip5_locality (ZIP).","CY2003-CY2016 GPCI is not loaded by default (dual-carrier era; source-native key includes carrier_number); CY2000-CY2002 have no live publisher file.","Join on (calendar_year, state, locality_number) WHERE is_current; the 1.0 work-GPCI floor is applied by the publisher in the file."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_pfs_relative_value_files","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["locality_number"],"backing_store":"glue"},{"source_id":"cms_fact_pfs_locality_config","source_fqn":"medicare_silver.fact_pfs_locality_config","title":"CMS PFS locality configuration (LOCCO), every RVU release CY2003-2026, stamped","domain":"medicare","stage":"silver","status":"live","grain":"One row per source row of one RVU release's LOCCO file (calendar_year x MAC/carrier x locality x official Counties text) after exact duplicate source rows are dropped; natural key (release_label, row_seq).","description":"The LOCCO member of each CMS PFS RVU release ZIP (RVU03D..RVU26C) re-collected through the provenance envelope on 2026-09-07: state, state_name, carrier_number, locality_number, locality_name (fee schedule area) and the publisher's Counties text. It maps county groups to Medicare payment localities and MACs per year; it is NOT a county-FIPS crosswalk (LOCCO publishes text, not FIPS). Succeeds medicare_county_to_locality (one CY2025 RDS snapshot).","identity_key":"state_locality_counties_year","row_count":2381,"last_updated":"2026-09-07","freshness_sla":"Annual; refresh after each RVU release.","recollection":{"cadence":"annual","watermark_field":"calendar_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'calendar_year' is the release's calendar year; pin it (and release_label) when comparing releases (named 2026-09-07).","One release ZIP is one release_label partition; a reload of one release never touches another."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_pfs_locality_config","commercial_terms":"Public CMS data; freely redistributable.","provenance_chain_ref":"pipelines/medicare/ingest/pfs_locality_runner.py (job build_medicare_pfs_locality) from the RVU release ZIPs; bronze medicare/bronze/cms_pfs_relative_value_files/; RDS registry medicare_source_registry_cache (cms_pfs_relative_value_files#locality_gpci)","context_doc_path":"docs/context_library/medicare/medicare_pfs_ipps_localization.md","known_gaps":["county_name is the publisher's Counties text (e.g. ALL COUNTIES, or a slash-separated list); no FIPS codes. Use cms_zip5_locality for ZIP-level locality resolution.","Pre-2003 files are not served by CMS (current index starts at RVU03)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_pfs_relative_value_files","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["state_locality_counties_year"],"backing_store":"glue"},{"source_id":"vlada_landscape_disposition","source_fqn":"medicare_semantic.fact_landscape_disposition_v1","title":"Vlada Landscape disposition, every September member placed against next year's Landscape file, 2023 to 2027","domain":"medicare","stage":"mart","status":"live","grain":"One row per transition_year (2023 to 2026, partition) x parent x state x county x product_type_y x product_type_y1 x dayone_bucket x truth_class, with cells (plan-county cells) and members (September-Y enrollment). 419,954 rows over four transitions (measured 2026-09-29).","description":"The served grain of the defined Landscape analysis (Ben 2026-09-25, tools/ma_brain/landscape_analysis.py): every September-Y member (H/R contracts, plans 001-799) matched to the Y Landscape by plan and county, then placed against the Y+1 file: continues, or departing in five Day-One buckets (D1 same-named plan in the county, D2 plan sold elsewhere, D3 contract in the county, D4 parent in the county, D5 parent gone). Where the Y+1 crosswalk is held (2024 to 2026) truth_class says what really happened (moved, split, stranded_sar, terminated). Every cell of 2026 to 2027 was recomputed from the raw CMS zips with 0 differences (landscape_table_audit.py, 2026-09-28) and every partition checked 0-diff against the lane's CSVs. Tool: get_landscape_exits, which since 2026-09-30 also groups by county (state required) and filters to one county; the industry scope is product_type_y NOT IN ('non-SNP Cost', 'non-SNP MMP'), with which the four bases tie to 25,970,589 / 27,665,108 / 28,931,650 / 29,855,373 members (measured 2026-09-30).","identity_key":"transition_year,parent,state,county,product_type_y,product_type_y1,dayone_bucket,truth_class","row_count":419954,"last_updated":"2026-09-29","freshness_sla":"Rebuilt per transition when the Landscape lands (September) and when the crosswalk lands (October).","recollection":{"cadence":"annual","watermark_field":"transition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin transition_year; group and SUM members; never count rows as members."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.fact_landscape_disposition_v1","provenance_chain_ref":"tools/ma_brain/landscape_disposition_publish.py over medicare_silver.fact_ma_landscape(_edition), enrollment_monthly_county, enrollment_monthly_plan and plan_crosswalks_annual; editions per transition in the table (l0_edition, l1_edition); s3://vlada-platform-raw/medicare_semantic/fact_landscape_disposition_v1","known_gaps":["THE MEMBER BASE excludes dayone_bucket not_in_y_county_list and outside_landscape (kept and labelled so the base is reproducible: 29,855,373 of 29,956,641 for 2026). Industry = product_type_y NOT LIKE '%Cost' AND NOT LIKE '%MMP'. Stand-alone Part D and employer group plans (800-899) are never in the table: the Landscape file does not list them.","Suppressed enrollment cells (under 11) count as zero; every figure is a floor.","truth_class is real only where crosswalk_held; for transition_year 2026 it reads '(crosswalk not held)' until the 2027 crosswalk lands. parent is CMS's reported parent at September Y, not a canonical chain across renames."],"notes":null,"superseded_by":null,"tools":["get_county_view","get_landscape_exits"],"dataset_id":"vlada_w3_landscape_disposition","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["county","dayone_bucket","parent","product_type_y","product_type_y1","transition_year","truth_class"],"backing_store":"glue"},{"source_id":"vlada_landscape_benefits","source_fqn":"medicare_semantic.fact_landscape_benefits_v1","title":"Vlada Landscape benefit change, the same members' plan design in year Y and year Y+1, 2023 to 2027","domain":"medicare","stage":"mart","status":"live","grain":"One row per transition_year (partition) x parent x state x product_type_y x product_type_y1 x dayone_bucket x truth_class, with cells, members and 144 sum columns (24 metrics x 3 weight sets x numerator / denominator).","description":"The benefit half of the defined Landscape analysis (spec section 4): for the cells of fact_landscape_disposition_v1 without county, the member-weighted numerator and denominator of every metric (premiums and $0 shares, MOOP, Part D deductible shares, MA-PD and enhanced shares, D-SNP $0 cost sharing, FIDE, HIDE, stars) on three weight sets: a = the Y design on every September-Y member, b = the Y+1 design on members whose plan continues in their county, r = the Y+1 design routed through the crosswalk where held. Tool: get_landscape_benefit_change for every grain but county; the county grain is fact_landscape_benefits_county_v1 (2026-09-30, the same cells with the county kept; this table is as built).","identity_key":"transition_year,parent,state,product_type_y,product_type_y1,dayone_bucket,truth_class","row_count":null,"last_updated":"2026-09-29","freshness_sla":"Rebuilt with fact_landscape_disposition_v1 (September and October each year).","recollection":{"cadence":"annual","watermark_field":"transition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin transition_year; divide sums, never average columns."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.fact_landscape_benefits_v1","provenance_chain_ref":"tools/ma_brain/landscape_disposition_publish.py --benefits over the same sources as fact_landscape_disposition_v1; s3://vlada-platform-raw/medicare_semantic/fact_landscape_benefits_v1","known_gaps":["SUPERSEDED for MOOP by medicare_semantic.fact_landscape_benefits_v2 (2026-10-13): this table reads a filed $0 in-network MOOP as missing, so its moop, moop5k and moopmax figures leave out the plans that file $0 (VNS Health Total H5549-003 and a few a year). Every other column is identical in v2. Kept as built; the tools read v2.","A value is SUM(n) / SUM(d) over the rollup, never AVG of a column; a pct metric is a share of members in its own domain (Part D metrics over MA-PD members, D-SNP metrics over D-SNP members). Y+1 stars are empty until CMS assigns them (October).","The r (routed) sums are zero where the crosswalk is not held (transition_year 2026 until the 2027 crosswalk lands).","Suppressed enrollment cells count as zero; every weight is a floor."],"notes":null,"superseded_by":"medicare_semantic.fact_landscape_benefits_v2 (2026-10-13, the one MOOP rule: a filed $0 in-network MOOP is $0). This table reads a filed $0 as missing in the moop, moop5k and moopmax sums; every other column is identical in v2 (railed). Kept as built, as the rollback.","tools":[],"dataset_id":"vlada_w3_landscape_disposition","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["dayone_bucket","parent","product_type_y","product_type_y1","transition_year","truth_class"],"backing_store":"glue"},{"source_id":"vlada_landscape_benefits_county","source_fqn":"medicare_semantic.fact_landscape_benefits_county_v1","title":"Vlada Landscape benefit change at county grain, the same members' plan design in year Y and year Y+1, 2023 to 2027","domain":"medicare","stage":"mart","status":"live","grain":"One row per transition_year (2023 to 2026, partition) x parent x state x county x product_type_y x product_type_y1 x dayone_bucket x truth_class, with cells, members and the same 144 sum columns as fact_landscape_benefits_v1 (24 metrics x 3 weight sets x numerator / denominator). 419,954 rows over four transitions, the row count of fact_landscape_disposition_v1 partition for partition (measured 2026-09-30).","description":"fact_landscape_benefits_v1 with the county in the key (the launch lane's \"your county, 2027\"): the same cells and the same member-weighted numerator and denominator per metric and weight set (a = the Y design on every September-Y member, b = the Y+1 design on members whose plan continues in their county, r = routed through the crosswalk where held), built by the same SQL with the county kept. A NEW table, never a rewrite of v1. Checked 0-diff on 2026-09-30 three ways per transition: every county x product type x parent row of the Landscape lane's county CSV (members, continue, departing, D1 to D5; 43,211 rows for 2026), every metric of the product-type and national CSVs to the 4th decimal, and every one of the 144 sums against fact_landscape_benefits_v1 at product type x Day-One bucket. Tool: get_landscape_benefit_change with group_by county or a county filter (state required).","identity_key":"transition_year,parent,state,county,product_type_y,product_type_y1,dayone_bucket,truth_class","row_count":419954,"last_updated":"2026-09-30","freshness_sla":"Rebuilt with fact_landscape_disposition_v1 (September and October each year).","recollection":{"cadence":"annual","watermark_field":"transition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin transition_year and state; divide sums, never average columns; a county is its own base."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.fact_landscape_benefits_county_v1","provenance_chain_ref":"tools/ma_brain/landscape_disposition_publish.py --benefits-county over the same sources as fact_landscape_disposition_v1 (tools/ma_brain/landscape_analysis.py disposition_sql county_benefits=True); s3://vlada-platform-raw/medicare_semantic/fact_landscape_benefits_county_v1; --check --benefits-county is the tie-out","known_gaps":["SUPERSEDED for MOOP by medicare_semantic.fact_landscape_benefits_county_v2 (2026-10-13): this table reads a filed $0 in-network MOOP as missing, so its moop, moop5k and moopmax figures leave out the plans that file $0 (VNS Health Total H5549-003 and a few a year). Every other column is identical in v2. Kept as built; the tools read v2.","A value is SUM(n) / SUM(d) over the rollup, never AVG of a column; a pct metric is a share of members in its own domain (Part D metrics over MA-PD members, D-SNP metrics over D-SNP members). Each county is its own arena: divide within the county, never pool counties into a mechanism claim.","county is the member''s enrollment county as CMS spells it in the enrollment file (upper case, no \"County\"); it is not a FIPS code. Industry = product_type_y NOT IN (''non-SNP Cost'', ''non-SNP MMP'').","The r (routed) sums are zero where the crosswalk is not held (transition_year 2026 until the 2027 crosswalk lands); Y+1 stars are empty until CMS assigns them (October). Suppressed enrollment cells count as zero; every weight is a floor."],"notes":null,"superseded_by":"medicare_semantic.fact_landscape_benefits_county_v2 (2026-10-13, the one MOOP rule: a filed $0 in-network MOOP is $0). This table reads a filed $0 as missing in the moop, moop5k and moopmax sums; every other column is identical in v2 (railed). Kept as built, as the rollback.","tools":[],"dataset_id":"vlada_w3_landscape_disposition","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["county","dayone_bucket","parent","product_type_y","product_type_y1","transition_year","truth_class"],"backing_store":"glue"},{"source_id":"vlada_landscape_benefits_v2","source_fqn":"medicare_semantic.fact_landscape_benefits_v2","title":"Vlada Landscape benefit change, the same members' plan design in year Y and year Y+1, 2023 to 2027","domain":"medicare","stage":"mart","status":"live","grain":"One row per transition_year (partition) x parent x state x product_type_y x product_type_y1 x dayone_bucket x truth_class, with cells, members and 144 sum columns (24 metrics x 3 weight sets x numerator / denominator).","description":"The benefit half of the defined Landscape analysis (spec section 4): for the cells of fact_landscape_disposition_v1 without county, the member-weighted numerator and denominator of every metric (premiums and $0 shares, MOOP, Part D deductible shares, MA-PD and enhanced shares, D-SNP $0 cost sharing, FIDE, HIDE, stars) on three weight sets: a = the Y design on every September-Y member, b = the Y+1 design on members whose plan continues in their county, r = the Y+1 design routed through the crosswalk where held. Tool: get_landscape_benefit_change for every grain but county; the county grain is fact_landscape_benefits_county_v2 (the same cells with the county kept). Built 2026-10-13 by the same SQL as v1 with the one MOOP rule; v1 is as built and superseded for MOOP.","identity_key":"transition_year,parent,state,product_type_y,product_type_y1,dayone_bucket,truth_class","row_count":null,"last_updated":"2026-10-13","freshness_sla":"Rebuilt with fact_landscape_disposition_v1 (September and October each year).","recollection":{"cadence":"annual","watermark_field":"transition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin transition_year; divide sums, never average columns."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.fact_landscape_benefits_v2","provenance_chain_ref":"tools/ma_brain/landscape_disposition_publish.py --emit-v2-sql (applied with ops/scripts/apply_athena_sql.py) over the same sources as fact_landscape_disposition_v1; s3://vlada-platform-raw/medicare_semantic/fact_landscape_benefits_v2","known_gaps":["THE MOOP RULE (v2, 2026-10-13): a filed $0 in-network MOOP is $0 and is in the MOOP denominator (VNS Health Total H5549-003, HealthPartners MSHO H2422-002 and a few HMO / PPO plans a year file one: PBP pbp_d_out_pocket_amt_yn = 1 with amount 0, and the Summary of Benefits prints $0); the zero token is not applicable (NULL) only on Cost, MSA and PFFS plans, which file no in-network MOOP. v1 read every $0 as missing. v2 differs from v1 only in the moop, moop5k and moopmax sums of the cells that hold a filed-$0 plan (rails: ops/scripts/landscape_benefits_v2_rails.py, docs/operations/artifacts/landscape_benefits_v2/rails.json).","A value is SUM(n) / SUM(d) over the rollup, never AVG of a column; a pct metric is a share of members in its own domain (Part D metrics over MA-PD members, D-SNP metrics over D-SNP members). Y+1 stars are empty until CMS assigns them (October).","The r (routed) sums are zero where the crosswalk is not held (transition_year 2026 until the 2027 crosswalk lands).","Suppressed enrollment cells count as zero; every weight is a floor."],"notes":null,"superseded_by":null,"tools":["get_county_view","get_landscape_benefit_change"],"dataset_id":"vlada_w3_landscape_disposition","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["dayone_bucket","parent","product_type_y","product_type_y1","transition_year","truth_class"],"backing_store":"glue"},{"source_id":"vlada_landscape_benefits_county_v2","source_fqn":"medicare_semantic.fact_landscape_benefits_county_v2","title":"Vlada Landscape benefit change at county grain, the same members' plan design in year Y and year Y+1, 2023 to 2027","domain":"medicare","stage":"mart","status":"live","grain":"One row per transition_year (2023 to 2026, partition) x parent x state x county x product_type_y x product_type_y1 x dayone_bucket x truth_class, with cells, members and the same 144 sum columns as fact_landscape_benefits_v2 (24 metrics x 3 weight sets x numerator / denominator). The same rows as fact_landscape_benefits_county_v1, key for key (railed 2026-10-13).","description":"fact_landscape_benefits_v2 with the county in the key (the launch lane's \"your county, 2027\"): the same cells and the same member-weighted numerator and denominator per metric and weight set (a = the Y design on every September-Y member, b = the Y+1 design on members whose plan continues in their county, r = routed through the crosswalk where held), built by the same SQL with the county kept. A NEW table, never a rewrite of v1 (2026-10-13, the one MOOP rule). v1 was checked 0-diff on 2026-09-30 against the Landscape lane's county, product-type and national CSVs; v2 equals v1 on every key, members, cells and every sum column but the three MOOP metrics, which move only in the cells holding a filed-$0 plan (railed). Tool: get_landscape_benefit_change with group_by county or a county filter (state required).","identity_key":"transition_year,parent,state,county,product_type_y,product_type_y1,dayone_bucket,truth_class","row_count":null,"last_updated":"2026-10-13","freshness_sla":"Rebuilt with fact_landscape_disposition_v1 (September and October each year).","recollection":{"cadence":"annual","watermark_field":"transition_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin transition_year and state; divide sums, never average columns; a county is its own base."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.fact_landscape_benefits_county_v2","provenance_chain_ref":"tools/ma_brain/landscape_disposition_publish.py --emit-v2-sql (applied with ops/scripts/apply_athena_sql.py) over the same sources as fact_landscape_disposition_v1 (tools/ma_brain/landscape_analysis.py disposition_sql county_benefits=True); s3://vlada-platform-raw/medicare_semantic/fact_landscape_benefits_county_v2; --check --benefits-county is the tie-out","known_gaps":["THE MOOP RULE (v2, 2026-10-13): a filed $0 in-network MOOP is $0 and is in the MOOP denominator (VNS Health Total H5549-003, HealthPartners MSHO H2422-002 and a few HMO / PPO plans a year file one: PBP pbp_d_out_pocket_amt_yn = 1 with amount 0, and the Summary of Benefits prints $0); the zero token is not applicable (NULL) only on Cost, MSA and PFFS plans, which file no in-network MOOP. v1 read every $0 as missing. v2 differs from v1 only in the moop, moop5k and moopmax sums of the cells that hold a filed-$0 plan (rails: ops/scripts/landscape_benefits_v2_rails.py, docs/operations/artifacts/landscape_benefits_v2/rails.json).","A value is SUM(n) / SUM(d) over the rollup, never AVG of a column; a pct metric is a share of members in its own domain (Part D metrics over MA-PD members, D-SNP metrics over D-SNP members). Each county is its own arena: divide within the county, never pool counties into a mechanism claim.","county is the member''s enrollment county as CMS spells it in the enrollment file (upper case, no \"County\"); it is not a FIPS code. Industry = product_type_y NOT IN (''non-SNP Cost'', ''non-SNP MMP'').","The r (routed) sums are zero where the crosswalk is not held (transition_year 2026 until the 2027 crosswalk lands); Y+1 stars are empty until CMS assigns them (October). Suppressed enrollment cells count as zero; every weight is a floor."],"notes":null,"superseded_by":null,"tools":["get_landscape_benefit_change"],"dataset_id":"vlada_w3_landscape_disposition","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["county","dayone_bucket","parent","product_type_y","product_type_y1","transition_year","truth_class"],"backing_store":"glue"},{"source_id":"vlada_benefit_engine_atoms","source_fqn":"medicare_semantic.vw_benefit_engine_atoms","title":"Vlada locked benefit engine atoms (pointer view), every county x plan segment's benefits 2022 to 2027, its members followed to next year's plan","domain":"medicare","stage":"mart","status":"live","grain":"One row per kind ('book' | 'next') x base_year (2022 to 2026) x county_ssa x plan segment (base_key; the followed successor's plan_segment_key on next rows), with weight (September county members), the engine's 155 OUT_METRICS columns and 98 like-for-like cost-share pair columns on next rows. 802,687 rows, 432,333 of them book (measured 2026-10-05).","description":"The served atom table of the locked national benefit engine (ops/sb_llm/tools/benefit_engine.py, docs/research/benefits-2027/CALC-LOCK.md and METHODS.md), version v20261008a: the pointer view over medicare_semantic.benefit_engine_atoms_v20261008a (rebuilt 2026-10-08 on benefit vector v20261007a; regional PPOs followed for base years 2022-2024). Book rows are each year's members in that year's plan; next rows are the same members followed to the plan serving them in the next year (same plan or CMS's crosswalk), so base 2026 next rows are the 2027 benefits of the 2026 members. Columns: kind, base_year, value_year, county_ssa, state, county_fips, county_name, bucket (non-SNP HMO, non-SNP PPO, D-SNP HMO, D-SNP PPO, C-SNP HMO, C-SNP PPO, plus I-SNP and non-SNP other), parent (canonical_parent_name, vw_ma_parent_resolved_v1), base_key, plan_segment_key, followed, weight, plan_type, product_type, successor, then the metric and pair columns. Every engine metric = SUM(weight x column) / SUM(weight where the column is not null) over a slice; verified 46 of 46 against the engine on 2026-10-05, and the MA data platform's snapshot rails tie its sums to the engine TSV for every bucket and the largest parents on every build. Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":802687,"last_updated":"2026-10-05","freshness_sla":"A new engine lock writes a new versioned table and repoints this view (never rewrites a version).","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_engine_atoms","provenance_chain_ref":"ops/sb_llm/tools/benefit_engine.py --atoms-out over the benefit vector (medicare_semantic.vw_benefit_vector), CPSC September county enrollment, the service-area file and plan_crosswalks_annual; s3://vlada-platform-raw/medicare_semantic/benefit_engine_atoms_v20261008a; served to /ma by ops/scripts/ma_platform_snapshots.py build_benefit_engine (benefits_engine_national.json, shard[\"benefit_engine\"])","known_gaps":["A value is a ratio of weighted sums over the members with a filed value, never AVG of a column; a null is never $0 and lowers the coverage. Read inside one bucket: never pool D-SNP with non-SNP. D-SNP cost shares are the filed design (full duals generally pay $0).","The 2027 level (base 2026 next rows) is the 2026 members followed, not 2027 enrollment. Regional PPO book rows carry no next rows (no followed successor) in any base year, so their members never enter a same-member change.","208 book atoms in 2025 (23,333 members) carry no plan type and no benefit filing; they count in members and lower coverage. Employer group plans and stand-alone Part D are not in the table."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_engine_atoms","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_benefit_engine_atoms_v20261005","source_fqn":"medicare_semantic.benefit_engine_atoms_v20261005","title":"Vlada locked benefit engine atoms, version v20261005 (the table behind vw_benefit_engine_atoms)","domain":"medicare","stage":"mart","status":"live","grain":"Identical to medicare_semantic.vw_benefit_engine_atoms (the pointer view selects this version whole). 802,687 rows (measured 2026-10-05).","description":"The versioned, immutable atom table of the locked benefit engine as locked on 2026-10-05 (Parquet, one file per base year). Read the pointer view vw_benefit_engine_atoms unless a question must pin this exact version; the same rules apply (ratio of weighted sums, one bucket at a time, the 2027 level is the 2026 members followed). Superseded 2026-10-06 by benefit_engine_atoms_v20261006 (the pointer now reads that version); kept queryable by name, never rewritten. Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":802687,"last_updated":"2026-10-05","freshness_sla":"Never rewritten; a new engine lock is a new versioned table.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_engine_atoms_v20261005","provenance_chain_ref":"ops/sb_llm/tools/benefit_engine.py --atoms-out; s3://vlada-platform-raw/medicare_semantic/benefit_engine_atoms_v20261005","known_gaps":["Same as medicare_semantic.vw_benefit_engine_atoms."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_engine_atoms","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_benefit_engine_atoms_v20261006","source_fqn":"medicare_semantic.benefit_engine_atoms_v20261006","title":"Vlada locked benefit engine atoms, version v20261006 (the table behind vw_benefit_engine_atoms)","domain":"medicare","stage":"mart","status":"live","grain":"Identical to medicare_semantic.vw_benefit_engine_atoms (the pointer view selects this version whole). 802,687 rows (measured 2026-10-05).","description":"The versioned, immutable atom table of the locked benefit engine as locked on 2026-10-06 (rebuilt on benefit vector v20261006b: the CY2025 in-network medical deductible read from the filing per plan segment; only the deductible columns of base 2025 book rows and base 2024 next rows differ from v20261005) (Parquet, one file per base year). Read the pointer view vw_benefit_engine_atoms unless a question must pin this exact version; the same rules apply (ratio of weighted sums, one bucket at a time, the 2027 level is the 2026 members followed). Superseded by benefit_engine_atoms_v20261006b; kept queryable by name. Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":802687,"last_updated":"2026-10-06","freshness_sla":"Never rewritten; a new engine lock is a new versioned table.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_engine_atoms_v20261006","provenance_chain_ref":"ops/sb_llm/tools/benefit_engine.py --atoms-out; s3://vlada-platform-raw/medicare_semantic/benefit_engine_atoms_v20261006","known_gaps":["Same as medicare_semantic.vw_benefit_engine_atoms."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_engine_atoms","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_benefit_engine_atoms_v20261006b","source_fqn":"medicare_semantic.benefit_engine_atoms_v20261006b","title":"Vlada locked benefit engine atoms, version v20261006b (the table behind vw_benefit_engine_atoms)","domain":"medicare","stage":"mart","status":"live","grain":"Identical to medicare_semantic.vw_benefit_engine_atoms (the pointer view selects this version whole). 802,687 rows (measured 2026-10-05).","description":"The versioned, immutable atom table of the locked benefit engine as locked on 2026-10-06 (rebuilt on benefit vector v20261006bb: the CY2025 in-network medical deductible read from the filing per plan segment; only the deductible columns of base 2025 book rows and base 2024 next rows differ from v20261005) (Parquet, one file per base year). Read the pointer view vw_benefit_engine_atoms unless a question must pin this exact version; the same rules apply (ratio of weighted sums, one bucket at a time, the 2027 level is the 2026 members followed). Superseded by benefit_engine_atoms_v20261006c; kept queryable by name. Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":802687,"last_updated":"2026-10-06","freshness_sla":"Never rewritten; a new engine lock is a new versioned table.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_engine_atoms_v20261006b","provenance_chain_ref":"ops/sb_llm/tools/benefit_engine.py --atoms-out; s3://vlada-platform-raw/medicare_semantic/benefit_engine_atoms_v20261006b","known_gaps":["Same as medicare_semantic.vw_benefit_engine_atoms."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_engine_atoms","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_benefit_engine_atoms_v20261006c","source_fqn":"medicare_semantic.benefit_engine_atoms_v20261006c","title":"Vlada locked benefit engine atoms, version v20261006c (the table behind vw_benefit_engine_atoms)","domain":"medicare","stage":"mart","status":"live","grain":"Identical to medicare_semantic.vw_benefit_engine_atoms (the pointer view selects this version whole). 802,687 rows (measured 2026-10-05).","description":"The versioned, immutable atom table of the locked benefit engine as locked on 2026-10-06 (rebuilt on benefit vector v20261006c: regional PPO members are assigned and followed through their CMS region, so their 2027 benefits are now followed; D-SNP deductibles are the filed design, with what a full dual pays ($0) is kept separate in the benefit vector's dual-effective columns, never mixed in) (Parquet, one file per base year). Read the pointer view vw_benefit_engine_atoms unless a question must pin this exact version; the same rules apply (ratio of weighted sums, one bucket at a time, the 2027 level is the 2026 members followed). Superseded by benefit_engine_atoms_v20261007a; kept queryable by name. Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":802687,"last_updated":"2026-10-06","freshness_sla":"Never rewritten; a new engine lock is a new versioned table.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_engine_atoms_v20261006c","provenance_chain_ref":"ops/sb_llm/tools/benefit_engine.py --atoms-out; s3://vlada-platform-raw/medicare_semantic/benefit_engine_atoms_v20261006c","known_gaps":["Same as medicare_semantic.vw_benefit_engine_atoms."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_engine_atoms","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_benefit_engine_atoms_v20261007a","source_fqn":"medicare_semantic.benefit_engine_atoms_v20261007a","title":"Vlada locked benefit engine atoms, version v20261007a (the table behind vw_benefit_engine_atoms)","domain":"medicare","stage":"mart","status":"live","grain":"Identical to medicare_semantic.vw_benefit_engine_atoms (the pointer view selects this version whole). 802,687 rows (measured 2026-10-05).","description":"The versioned, immutable atom table of the locked benefit engine as locked on 2026-10-07, Edition 1.1 (rebuilt on benefit vector v20261007a: a deductible filed without a service scope is out of network only, $0 in network, footnoted; any Part B buydown above $0 counts as offered, with buydowns under $10 a month in their own column giveback_pct_token; CPSC revision 4 enrollment, identical rows) (Parquet, one file per base year). Read the pointer view vw_benefit_engine_atoms unless a question must pin this exact version; the same rules apply (ratio of weighted sums, one bucket at a time, the 2027 level is the 2026 members followed). Superseded by benefit_engine_atoms_v20261008a; kept queryable by name. Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":802687,"last_updated":"2026-10-07","freshness_sla":"Never rewritten; a new engine lock is a new versioned table.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_engine_atoms_v20261007a","provenance_chain_ref":"ops/sb_llm/tools/benefit_engine.py --atoms-out; s3://vlada-platform-raw/medicare_semantic/benefit_engine_atoms_v20261007a","known_gaps":["Same as medicare_semantic.vw_benefit_engine_atoms."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_engine_atoms","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_benefit_company_cells_v20261007a","source_fqn":"medicare_semantic.benefit_company_cells_v20261007a","title":"Vlada locked 2027 benefit tables by company (v20261007a), national / state / county x product type x plan type x parent, 2026 all members, 2026 continuing members and the same members in 2027, every benefit as weighted sums","domain":"medicare","stage":"mart","status":"live","grain":"One row per lvl ('national' | 'state' | 'county') x state ('US' on national rows) x county_ssa (county rows only) x bucket (product type; 'ALL' = the company total across product types) x plan_type ('ALL' = every plan type of the bucket) x parent ('ALL' = the market; 'Unaffiliated' when no canonical parent) x per ('b' = 2026 all members, 'f' = 2026 members who continue, 'n' = those same members in their 2027 plan). 427,355 rows (county b 145,909, f 133,094, n 133,094; state b 4,459, f 4,035, n 4,035; national b 959, f 885, n 885; CELLS-MANIFEST.md 2026-10-07).","description":"The locked 2027 company benefit cells (Benefits lane, Edition 1.1, locked 2026-10-07): every metric of the locked benefit engine (medicare_semantic.benefit_engine_atoms_v20261007a, base year 2026) rolled up by GROUPING SETS to national, state and county x product type x plan type x parent, keeping the weighted SUMS rather than the averages, so any reader can reproduce the published figure exactly. For each metric m: m__s = SUM(weight x m) and m__w = SUM(weight) over the members with m filed, so the value is m__s / m__w (a ratio of weighted sums, never an average of cell values); for metrics with a coverage column, m__c = SUM(weight x coverage) and coverage = m__c / members. members = September 2026 county enrollment on the plan segment; plans = distinct plan segments. Metrics: dental, hearing, OTC, eyewear and flex card (offered share, form shares, PMPM dollars if offered and over all members, design known), giveback (offered, token under $10, PMPM), $0 premium share, transportation / fitness / meals / podiatry, deductibles by scope, then premium, MOOP, the medical and Part D deductibles, and every medical cost share (copay and coinsurance by form, low and high ends, switches) and the Part D tier 1/2 copays and tier 4/5 coinsurance. Like-for-like allowance dollars on paired members are the sibling table benefit_company_cells_sd_v20261007a. Tie-out (company_cells_check.py): 73,986 national values against the report data and 7,250 like-for-like values, 0 mismatches; members roll county to state to national with 0 breaks (30,069,277 members, September 2026). Versioned, never replaced; a new lock is a new table. Owner: the Benefits lane.","identity_key":"lvl,state,county_ssa,bucket,plan_type,parent,per","row_count":427355,"last_updated":"2026-10-07","freshness_sla":"Never rewritten; a new engine lock writes a new versioned table (benefit_company_cells_vYYYYMMDD).","recollection":{"cadence":"annual","watermark_field":"per","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE lvl = 'national' | 'state' | 'county' AND per = 'b' | 'f' | 'n' AND bucket = '<one product type>'; parent = 'ALL' for the market, plan_type = 'ALL' for the whole product type; state = 'US' on national rows. SELECT moop__s / moop__w AS moop, moop__w / members AS moop_coverage. Join the like-for-like table and vw_plan_value_cells on lvl/geography_level + state + county_ssa + bucket/product_type + plan_type + parent/parent_organization."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_company_cells_v20261007a","provenance_chain_ref":"ops/sql/benefit_engine/benefit_company_cells_v20261007a.sql (generated by ops/sb_llm/tools/company_cells_sql.py from medicare_semantic.benefit_engine_atoms_v20261007a, checked by ops/sb_llm/tools/company_cells_check.py; docs/research/benefits-2027/locked/CELLS-MANIFEST.md, METHOD-LOCKED.md); s3://vlada-platform-raw/medicare_semantic/benefit_company_cells_v20261007a","known_gaps":["REQUIRED: pin lvl, per and one bucket. A value is <metric>__s / <metric>__w over ONE row (or SUM(__s) / SUM(__w) across rows you mean to combine); never AVG a ratio across rows and never read a __s or __w column as a value.","NEVER POOL PRODUCT TYPES: read inside one bucket (non-SNP HMO, non-SNP PPO, D-SNP HMO, D-SNP PPO, C-SNP HMO, C-SNP PPO). bucket = 'ALL' rows pool every product type (a D-SNP filed design with non-SNP plans) and are a member count, never a benefit headline.","D-SNP TWO COLUMNS: D-SNP cost shares here are the FILED design; a full dual generally pays $0 under Medicaid. This table carries the filed design only; the dual-effective column is in medicare_semantic.vw_plan_value_cells (dsnp_full_dual_plan_value_*) beside its filed_design_plan_value_*. Never quote a D-SNP filed cost share as what a full dual pays.","A NULL IS NEVER $0: a metric no member filed has __w = 0 or null, so the value is unknown, not $0; coverage (<metric>__c / members, or __w / members) says how many of the cell's members the value describes. Quote it beside any thin or county value.","per = 'n' is the 2026 members followed to their 2027 plan (same plan or CMS's crosswalk), not 2027 enrollment. The same-member 2026 to 2027 change is per = 'f' against per = 'n' on the same keys, never per = 'b' against 'n'. Allowance dollars change like for like only in benefit_company_cells_sd_v20261007a (a change of form is a design change, not a raise).","Employer group plans and stand-alone Part D are not in the table; I-SNP and non-SNP other buckets are carried but out of scope for the report family. Thin county x parent cells can rest on a handful of members; read members first."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_company_cells","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["bucket","lvl","parent","per","plan_type"],"backing_store":"glue"},{"source_id":"vlada_benefit_company_cells_sd_v20261007a","source_fqn":"medicare_semantic.benefit_company_cells_sd_v20261007a","title":"Vlada locked 2027 allowance dollars like for like by company (v20261007a), same members 2026 vs 2027, dental / hearing / OTC / eyewear / flex card","domain":"medicare","stage":"mart","status":"live","grain":"One row per lvl x state x county_ssa x bucket x plan_type x parent, the same keys and 'ALL' rollups as benefit_company_cells_v20261007a without per (every row is the paired 2026 -> 2027 members). 138,014 rows (county 133,094, state 4,035, national 885; CELLS-MANIFEST.md 2026-10-07).","description":"Allowance dollars like for like (REPORT-FAMILY-PLAN.md section 0; rule in benefits_same_design.py): each 2026 continuing member (atoms kind = book, followed) paired 1:1 with their 2027 plan (kind = next, same county_ssa + base_key, same weight). For each allowance k in dental, hearing, OTC, eyewear and card: sd_<k>_l0 / sd_<k>_l1 = SUM(w x PMPM dollars) in 2026 / 2027 over the comparable pairs (same form both years, or offered without a stated amount both years), so the 2026 and 2027 levels are sd_<k>_l0 / w and sd_<k>_l1 / w and the like-for-like change is (sd_<k>_l1 - sd_<k>_l0) / w; sd_<k>_sw = members whose design changed form (a form switch is a design change, never a raise or a cut) and sd_<k>_kn = members with the design known both years. Tie-out: 7,250 values against same_design.json, 0 mismatches. Versioned, never replaced. Owner: the Benefits lane.","identity_key":"lvl,state,county_ssa,bucket,plan_type,parent","row_count":138014,"last_updated":"2026-10-07","freshness_sla":"Never rewritten; a new engine lock writes a new versioned table (benefit_company_cells_sd_vYYYYMMDD).","recollection":{"cadence":"annual","watermark_field":"lvl","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE lvl = 'national' AND bucket = 'non-SNP HMO' AND plan_type = 'ALL' AND parent = 'ALL': SELECT sd_dental_l0 / w AS dental_2026, sd_dental_l1 / w AS dental_2027, sd_dental_sw / NULLIF(sd_dental_kn, 0) AS dental_form_switch_share."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_company_cells_sd_v20261007a","provenance_chain_ref":"ops/sql/benefit_engine/benefit_company_cells_sd_v20261007a.sql (generated by ops/sb_llm/tools/company_cells_sql.py from medicare_semantic.benefit_engine_atoms_v20261007a, checked by ops/sb_llm/tools/company_cells_check.py); s3://vlada-platform-raw/medicare_semantic/benefit_company_cells_sd_v20261007a","known_gaps":["REQUIRED: pin lvl and one bucket; bucket = 'ALL' pools product types and is never a headline. Divide by w (the paired members) for a level; never average the per-row levels.","FORM SWITCH IS NOT A RAISE: members whose allowance changed form (sd_<k>_sw) are outside the dollar comparison; quote sd_<k>_sw / sd_<k>_kn beside any like-for-like change.","D-SNP TWO COLUMNS: D-SNP allowances are the filed design; read a D-SNP bucket on its own and the dual-effective view in vw_plan_value_cells.","A null or zero w is no paired member, never a $0 allowance."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_company_cells","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["bucket","lvl","parent","plan_type"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_reading_atoms","source_fqn":"medicare_semantic.vw_benefit_reading_atoms","title":"Vlada benefit engine atoms (edition v20261018b): one plan segment in one county in one year, every benefit reading column (the drill)","domain":"medicare","stage":"mart","status":"live","grain":"One row per kind ('book' | 'next') x base_year x county_ssa x base_key (the plan segment the member started in); plan_segment_key = the segment the row describes.","description":"The benefit engine's unit (benefit_engine.py, edition v20261018b): September county members (weight) on the segment serving the county, every metric per atom. Every reading cell is SUM(weight x m) / SUM(weight) over these. /ma reads vw_benefit_engine_atoms (edition v20261015d); this pointer serves the reading edition. Pointer -> medicare_semantic.benefit_engine_atoms_v20261018b. Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":824757,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE base_year = 2026 AND kind = 'book' AND county_ssa = '<SSA>' AND bucket = '<one product type>' AND weight > 0; group by plan_segment_key for the plan drill."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_reading_atoms","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_reading_atoms__to__v20261018b.sql -> medicare_semantic.benefit_engine_atoms_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":["get_benefit_change"],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_reading_matched","source_fqn":"medicare_semantic.vw_benefit_reading_matched","title":"Vlada benefit reading, a contract against its closest contracts on their shared counties (edition v20261018b)","domain":"medicare","stage":"mart","status":"live","grain":"One row per base_year x bucket x plan_type x contract_id x match_contract_id (top 5) x per.","description":"Both sides on the counties both serve with the product and plan type, where both carry the number; side B re-weighted to side A's members in each county. value = a_<m>__s / a_<m>__w and b_<m>__s / b_<m>__w. Pointer -> medicare_semantic.benefit_reading_matched_v20261018b. Owner: the Benefits lane.","identity_key":"base_year,bucket,plan_type,contract_id,match_contract_id,per","row_count":33306,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE base_year = 2026 AND per = 'b' AND contract_id = '<H1234>'; SELECT a_dental_dollars_pmpm_if__s / a_dental_dollars_pmpm_if__w * 12, b_dental_dollars_pmpm_if__s / b_dental_dollars_pmpm_if__w * 12."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_reading_matched","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_reading_matched__to__v20261018b.sql -> medicare_semantic.benefit_reading_matched_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":["get_benefit_change"],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["base_year","bucket","match_contract_id","per","plan_type"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_contract_match","source_fqn":"medicare_semantic.vw_benefit_contract_match","title":"Vlada benefit reading, each contract's closest contracts by footprint (edition v20261018b)","domain":"medicare","stage":"mart","status":"live","grain":"One row per base_year x bucket x plan_type x contract_id x match_contract_id (top 10).","description":"For each contract, product type and plan type: the other contracts with the same product and plan type and shared counties, ranked by the member-weighted county Jaccard (SUM(min) / SUM(max)); floors: 1,000 shared-county members on side A and a Jaccard of 0.05. overlap_share_a / _b = each side's members in the shared counties. Pointer -> medicare_semantic.benefit_contract_match_v20261018b. Owner: the Benefits lane.","identity_key":"base_year,bucket,plan_type,contract_id,match_contract_id","row_count":15180,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE base_year = 2026 AND contract_id = '<H1234>' ORDER BY bucket, plan_type, match_rank."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_contract_match","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_contract_match__to__v20261018b.sql -> medicare_semantic.benefit_contract_match_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":["get_benefit_change"],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["base_year","bucket","match_contract_id","plan_type"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_contract_cells","source_fqn":"medicare_semantic.vw_benefit_contract_cells","title":"Vlada benefit reading by contract (edition v20261018b): every benefit number by national / state / county x product type x plan type x the member's base contract","domain":"medicare","stage":"mart","status":"live","grain":"One row per base_year x lvl x state x county_ssa x bucket x plan_type x contract_id x per (no market rows).","description":"The cells' sums with the member's BASE contract (from base_key) in place of the parent; parent_org beside. For contract-vs-contract comparisons. Pointer -> medicare_semantic.benefit_contract_cells_v20261018b. Owner: the Benefits lane.","identity_key":"base_year,lvl,state,county_ssa,bucket,plan_type,contract_id,per","row_count":1429127,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE base_year = 2026 AND per = 'b' AND lvl = 'county' AND bucket = '<one product type>' AND contract_id = '<H1234>'."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_contract_cells","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_contract_cells__to__v20261018b.sql -> medicare_semantic.benefit_contract_cells_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","ssa:county","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["base_year","bucket","lvl","per","plan_type"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_reading_transitions","source_fqn":"medicare_semantic.vw_benefit_reading_transitions","title":"Vlada benefit reading, design transitions (edition v20261018b): members by base-year design x next-year design per benefit, same members","domain":"medicare","stage":"mart","status":"live","grain":"One row per base_year x lvl x state x county_ssa x bucket ('ALL') x parent ('ALL') x benefit x from_design x to_design.","description":"Base-year members followed 1:1 into their next-year plan (book <-> next on county_ssa + base_key); not followed = to_design 'exit'. Designs: allowances cap | cap_plus_card | no_max (copay_per_aid for hearing) | card | none | unknown; cost shares zero | copay | coinsurance | unknown; premium zero | paid; MOOP in_network | not_in_network; deductible none | plan | partb | none_in_network; giveback none | token | giveback; services offered | optional_only | none. v0__s / v1__s over pair_w = the like-for-like value both sides (allowances dollars a year; cost shares the copay pair, q = the coinsurance pair). The successor mix (same / other segment, crosswalk consolidated / renumbered, left county, plan not filed) and to_contract_changed / to_parent_changed (next contract's parent in the base parent's name space) / to_type_changed ride beside. Pointer -> medicare_semantic.benefit_reading_transitions_v20261018b. Owner: the Benefits lane.","identity_key":"base_year,lvl,state,county_ssa,bucket,parent,benefit,from_design,to_design","row_count":17670144,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE base_year = 2026 AND lvl = 'national' AND bucket = '<one product type>' AND parent = 'ALL' AND benefit = 'dental'; members by from_design x to_design; (v1__s - v0__s) / pair_w = the like-for-like change. Never chain base years."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_reading_transitions","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_reading_transitions__to__v20261018b.sql -> medicare_semantic.benefit_reading_transitions_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":["get_benefit_change"],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["base_year","benefit","bucket","from_design","lvl","parent","to_design"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_reading_simple","source_fqn":"medicare_semantic.vw_benefit_reading_simple","title":"Vlada benefit reading, the simple average across plans (edition v20261018b): each plan segment counted once per cell","domain":"medicare","stage":"mart","status":"live","grain":"The cells' keys (base_year x lvl x state x county_ssa x bucket x plan_type x parent x per).","description":"The simple lens beside the member-weighted cells: value = m__ps / m__pn, each plan segment counted once in the cell (national once, state once per state, county once per county), 'plans with reported members'. A segment's filed value is the same in every county it serves (rail R-simple). Pointer -> medicare_semantic.benefit_reading_simple_v20261018b. Owner: the Benefits lane.","identity_key":"base_year,lvl,state,county_ssa,bucket,plan_type,parent,per","row_count":2115880,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: Join vw_benefit_reading_cells on every key; SELECT dental_dollars_pmpm_if__ps / dental_dollars_pmpm_if__pn * 12 AS dental_cap_simple, dental_dollars_pmpm_if__pn AS plans."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_reading_simple","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_reading_simple__to__v20261018b.sql -> medicare_semantic.benefit_reading_simple_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":["get_benefit_change"],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["base_year","bucket","lvl","parent","per","plan_type"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_reading_cells_sd","source_fqn":"medicare_semantic.vw_benefit_reading_cells_sd","title":"Vlada benefit reading, allowance dollars like for like (edition v20261018b), same members base -> next year","domain":"medicare","stage":"mart","status":"live","grain":"One row per base_year x lvl x state x county_ssa x bucket x plan_type x parent.","description":"Allowance dollars on paired members (book followed <-> next), like for like: level = sd_<k>_l0 / w and sd_<k>_l1 / w; sd_<k>_sw = members whose design changed form (a design change, never a raise or a cut). Pointer -> medicare_semantic.benefit_company_cells_sd_v20261018b. Owner: the Benefits lane.","identity_key":"base_year,lvl,state,county_ssa,bucket,plan_type,parent","row_count":691438,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE base_year = 2026 AND lvl = '<level>' AND bucket = '<one product type>' AND plan_type = 'ALL' AND parent = 'ALL'; SELECT sd_dental_l0 / w, sd_dental_l1 / w, sd_dental_sw / sd_dental_kn."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_reading_cells_sd","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_reading_cells_sd__to__v20261018b.sql -> medicare_semantic.benefit_company_cells_sd_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":["get_benefit_change"],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["base_year","bucket","lvl","parent","plan_type"],"backing_store":"glue"},{"source_id":"vlada_vw_benefit_reading_cells","source_fqn":"medicare_semantic.vw_benefit_reading_cells","title":"Vlada benefit reading cells (edition v20261018b): every benefit number by national / state / county x product type x plan type x parent x base year x view, as weighted sums","domain":"medicare","stage":"mart","status":"live","grain":"One row per base_year (2022-2026) x lvl x state x county_ssa x bucket ('ALL' = a parent's overall) x plan_type ('ALL') x parent ('ALL' = the market) x per ('b' = that year's members, 'f' = base members who continue, 'n' = those members in their next-year plan; base 2026 'n' = 2027).","description":"The benefit reading's member-weighted cells (Benefits lane, edition v20261018b, BENEFIT-READING.md): every metric of the benefit engine atoms (benefit_engine_atoms_v20261018b) rolled up by GROUPING SETS, kept as weighted sums so any reader reproduces the published figure: value = m__s / m__w, measurable = m__w / members, coverage = m__c / members. Edition v20261018b adds, beside every v20261015d column (identical, rail R-cells): what each card pays for (card_pays_*), the card kinds, each allowance's card role (<b>_pct_cap_plus_card = an own dollar cap AND a card that also pays it), the cost-share $0 leg (<m>_pct_zero), the D-SNP full-dual lens (<m>_dual_effective, dsnp_enrolls_full_duals). Registry of every number: ops/sb_llm/benefit_reading_registry.yaml. Pointer -> medicare_semantic.benefit_company_cells_v20261018b. Owner: the Benefits lane.","identity_key":"base_year,lvl,state,county_ssa,bucket,plan_type,parent,per","row_count":2115880,"last_updated":"2026-10-18","recollection":{"cadence":"annual","watermark_field":"base_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["HOW TO QUERY WELL: WHERE base_year = <2022-2026> AND per = 'b' | 'f' | 'n' AND lvl = 'national' | 'state' | 'county' AND bucket = '<one product type>' AND plan_type = 'ALL' AND parent = 'ALL'; SELECT dental_dollars_pmpm_if__s / dental_dollars_pmpm_if__w * 12 AS dental_cap, dental_dollars_pmpm_if__w / members AS measurable. The same-member change is per 'f' against per 'n' of one base year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_benefit_reading_cells","provenance_chain_ref":"ops/sql/benefit_reading/pointer__vw_benefit_reading_cells__to__v20261018b.sql -> medicare_semantic.benefit_company_cells_v20261018b (generated by ops/sb_llm/tools/company_cells_sql.py / reading_sql.py from benefit_engine_atoms_v20261018b; rails ops/sb_llm/tools/reading_rails.py, receipt docs/skills/benefits-lane/reading/RECEIPT-v20261018b.json)","notes":null,"superseded_by":null,"tools":["get_benefit_change"],"dataset_id":"vlada_w3_benefit_reading","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["base_year","bucket","lvl","parent","per","plan_type"],"backing_store":"glue"},{"source_id":"vlada_benefit_engine_atoms_v20261008a","source_fqn":"medicare_semantic.benefit_engine_atoms_v20261008a","title":"Vlada locked benefit engine atoms, version v20261008a (the table behind vw_benefit_engine_atoms)","domain":"medicare","stage":"mart","status":"live","grain":"Identical to medicare_semantic.vw_benefit_engine_atoms (the pointer view selects this version whole). 824,757 rows (measured 2026-10-08).","description":"The versioned, immutable atom table of the locked benefit engine as locked on 2026-10-08 (v20261007a, Edition 1.1, with regional PPOs followed for base years 2022-2024: PlanRegionArea's blank 2017-2025 segment_id reads as segment 0; base_year 2026 value-identical to v20261007a; on benefit vector v20261007a: a deductible filed without a service scope is out of network only, $0 in network, footnoted; any Part B buydown above $0 counts as offered, with buydowns under $10 a month in their own column giveback_pct_token; CPSC revision 4 enrollment, identical rows) (Parquet, one file per base year). Read the pointer view vw_benefit_engine_atoms unless a question must pin this exact version; the same rules apply (ratio of weighted sums, one bucket at a time, the 2027 level is the 2026 members followed). Owner: the Benefits lane.","identity_key":"kind,base_year,county_ssa,base_key","row_count":824757,"last_updated":"2026-10-08","freshness_sla":"Never rewritten; a new engine lock is a new versioned table.","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.benefit_engine_atoms_v20261008a","provenance_chain_ref":"ops/sb_llm/tools/benefit_engine.py --atoms-out; s3://vlada-platform-raw/medicare_semantic/benefit_engine_atoms_v20261008a","known_gaps":["Same as medicare_semantic.vw_benefit_engine_atoms."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benefit_engine_atoms","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_key","base_year","kind"],"backing_store":"glue"},{"source_id":"vlada_stars_measure_spine","source_fqn":"medicare_semantic.dim_stars_measure_identity_v7","title":"Vlada Stars measure spine, one row per Star measure identity per rating year 2015 to 2027, with that year's code and cut points","domain":"medicare","stage":"mart","status":"live","grain":"One row per measure_identity_key (part and canonical name, e.g. c:controlling_blood_pressure) x rating_year (2015 to 2027, partition). 583 rows, 40 to 48 identities a year (v7 2026-10-15 corrects 12 historical ladders where CMS printed NA for the lowest bands, op 'floor', and differs from v6 in nothing else; v6 2026-10-08 added series breaks, aliases, guardrail exemption and the final RY2027 release; v6 medicare_semantic.dim_stars_measure_identity_v6 is superseded and the untouched rollback).","description":"The one place a Star measure keeps its identity across rating years. CMS reuses measure codes (for RY2026, 27 of the 33 Part C codes moved; C14 has named five different measures since 2015). Each row carries that year's measure_id, measure_name, part_type, domain, weight, direction (that year's flag) and direction_latest (the identity's current direction), methodology_version and era, is_new_this_year and is_retired, prior_year_measure_id and next_year_measure_id, cmit_number where CMS gives one, and the cut points for stars 2 to 5 as star_k_threshold with star_k_op (RY2026 Controlling Blood Pressure: star_4_threshold 80, op >=), with ladder_direction and cutpoint_epoch. Built by tools/ma_brain/stars_measure_spine_publish.py; checked cell for cell against an independent derivation with 0 differences; seven invariants pass, including that the direction flag agrees with CMS's own cut point ladder in every year. Tools: get_stars, get_stars_cutpoints.","identity_key":"measure_identity_key,rating_year","row_count":583,"last_updated":"2026-10-15","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.dim_stars_measure_identity_v7 (pin rating_year)","notes":null,"superseded_by":null,"tools":["get_star_decomposition","get_stars","get_stars_cutpoints","get_stars_rollup"],"dataset_id":"vlada_w3_stars_measure_spine","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["measure_identity_key","rating_year"],"backing_store":"glue"},{"source_id":"vlada_plan_value_national","source_fqn":"medicare_semantic.vw_plan_value_national","title":"Vlada Plan Value, national basis (formerly BenVAT) per contract x plan x segment x county x benefit year","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per benefit_design_year x contract x plan x segment x county_ssa (measured 2026-09-17 in Athena, 9,948,020 rows = 9,948,020 distinct keys, Athena e9083b2e; CY2023-CY2026). Real types (double / int / boolean / varchar); no cast is needed or wanted.","description":"Vlada Plan Value v1, national basis (run d06cf1bf7, signed 2026-08-27; typed rebuild 2026-09-17 verified cell-for-cell against the signed CSVs): total plan value PMPM with _low/_high bounds and grade, medical value beyond Medicare, supplemental expected plan expense, Part B giveback and Part C/D premiums, the net totals, and the D-SNP split. Modeled from the PBP, Landscape, ratebook and enrollment sources; never a CMS figure and never a paid claim. Adds `snp_type` in the county view's labels (none / i_snp / d_snp / c_snp; the CMS code kept as `snp_type_cms_code`) and `is_valued`. Owner source: register w3 vlada_w3_benvat (door RAW, locked by Ben 2026-09-03). Supersedes medicare_semantic.benvat_v1_plan_county, whose 41 string columns read positionally out of CSV.","identity_key":"contract,plan,segment,county_ssa,benefit_design_year","row_count":9948020,"last_updated":"2026-09-17","freshness_sla":"Annual (rebuilt when the PBP / Landscape year lands); the valuation run is signed (d06cf1bf7, 2026-08-27).","recollection":{"cadence":"annual","watermark_field":"benefit_design_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin benefit_design_year; giveback and premiums are separate columns, net values are the v1_total_*_net_* fields.","A rerun that moves a published value needs a fresh signature from Ben before it is promoted (the August signatures cover run d06cf1bf7 only)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_plan_value_national","provenance_chain_ref":"Vlada Plan Value v1 run d06cf1bf7 over cms_ma_pbp + cms_ma_landscape + cms_ma_ratebook + cms_ma_monthly_enrollment (register w3 vlada_w3_benvat); typed rebuild ops/scripts/plan_value_tables_rebuild.py over the signed deliverables in _deliverables/benvat/v1/ (baseline rebuild-manifest.json); Glue view over s3://vlada-platform-raw/medicare_semantic/plan_value_national_v1","known_gaps":["SUPERSEDED AS THE CURRENT METHOD on 2026-10-08: Ben signed Plan Value v16 (theta range rule, card by what the money buys, D-SNP full-dual column), served as medicare_semantic.vw_plan_value_plans / vw_plan_value_cells / vw_plan_value_pairs. This August v1 view stays queryable by name as the record of the v1 signature; quote v16 for current values.","Every value is MODELED, never a filed benefit and never a paid claim; label it modeled and quote the _low/_high bounds for a single plan.","MOST ROWS CARRY NO VALUE (measured 2026-09-17, Athena aa269aee): v1_total_plan_value_pmpm is non-null on 462,513 of 9,948,020 rows (4.6%). Filter `is_valued` before any average. On the retired string table the same count returned 9,948,020 because 9,485,507 of those cells were the empty string, so an unvalued cell looked like a value.","Part C premium is BLANK for design years 2023 and 2024 (measured 2026-09-17, Athena 69493d95: part_c_premium_pmpm non-null on 123 of 2,546,162 rows in 2023 and 0 of 2,554,521 in 2024; populated 2025-2026). Source it from medicare_silver.fact_ma_landscape for those years. F5 / F6 in the post-signature audit.","The four D-SNP lens columns are EMPTY in every year: dsnp_beneficiary_value_pmpm, dsnp_plan_liability_pmpm, dsnp_state_transfer_pmpm and part_d_member_financial_value_at_lis_pmpm are 0 non-null in all four years (measured 2026-09-17, Athena 69493d95). The inputs were not supplied to the signed build (2026 receipt: dsnp_attributes: not supplied); a typed copy of an empty column is an empty column.","v1_total_grade is 'F' on every one of the 9,948,020 rows (measured 2026-09-17, Athena 69493d95) and therefore carries no information. It is F because the weakest load-bearing leg sets the total. Do not present it to a reader. F9 in the post-signature audit.","A filed copay RANGE is valued at its MINIMUM, which is CMS's own out-of-pocket-cost convention (_MC_MIN). 32% of general enrollment (1,011 plans, 6,776,572 members) files the specialist copay as a range with a mean gap of $42, so a plan filing \"$0 to $45\" is valued near a true $0 plan. Disclose the convention and bound it. F10 in the audit.","Segment premiums are not read: 100 of 3,692 valued 2026 plan-segments in 31 contracts carry one premium for all segments where CMS publishes one per segment (78 understated, mean difference -$6.90). Only the premium leg and the net-of-premium totals are affected. F6 in the audit.","Rows that are not valued carry is_valued = false; on the county-basis view the parallel flag is refusal_reason (empty string on every row today). Exclude them before aggregating.","No row-level provenance columns (no source_url / sha256); trace is upstream lineage to the four W3 sources, the signed run id d06cf1bf7 and the rebuild manifest."],"notes":"Name: Ben chose \"Vlada Plan Value\" on 2026-09-17. \"BenVAT\" survives in the source id, the code and the retired table names until a rename lane changes them.","superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["benefit_design_year","contract","plan","segment"],"backing_store":"glue"},{"source_id":"vlada_plan_value_county","source_fqn":"medicare_semantic.vw_plan_value_county","title":"Vlada Plan Value, county basis (formerly BenVAT) with per-benefit values and real county enrollment","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per benefit_design_year x contract x plan x segment x county_ssa (measured 2026-09-17 in Athena, 445,771 rows = 445,771 distinct keys, Athena efc66d87; 844 contracts, CY2023-CY2026). Real types (double / int / boolean / varchar); no cast is needed or wanted.","description":"Vlada Plan Value county basis (run d06cf1bf7, signed 2026-08-27; typed rebuild 2026-09-17 verified cell-for-cell against the signed CSVs): the plan value re-priced and re-utilized per county (v_b) against the national value (v_national), decomposed into price_effect, util_effect and interaction, with the reference and plan PMPM, MOOP relief, the rake diagnostics and the 35 per-benefit-code value columns (v_by_code_*). Adds real county enrollment from the CMS February file with its suppression flag and bounds, the count of a plan's segments in the county, and `snp_type` as labels. Modeled; never a CMS figure. Owner source: register w3 vlada_w3_benvat (door RAW, locked by Ben 2026-09-03). Supersedes medicare_semantic.benvat_county_v1, which read CSV positionally and so mis-named 26 columns for 2023 and 2024.","identity_key":"contract,plan,segment,county_ssa,benefit_design_year","row_count":445771,"last_updated":"2026-09-17","freshness_sla":"Annual (rebuilt with the plan value run); the county basis run is signed (d06cf1bf7, 2026-08-27).","recollection":{"cadence":"annual","watermark_field":"benefit_design_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin benefit_design_year; one run per year, the newest signed run replaces the prior.","A rerun that moves a published value needs a fresh signature from Ben before it is promoted."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_plan_value_county","provenance_chain_ref":"Vlada Plan Value county basis run d06cf1bf7 over the national-basis table + cms_ma_ratebook + cms_ma_monthly_enrollment (register w3 vlada_w3_benvat); typed rebuild ops/scripts/plan_value_tables_rebuild.py over the signed deliverables (baseline rebuild-manifest.json); Glue view over s3://vlada-platform-raw/medicare_semantic/plan_value_county_v1 joined to medicare_silver.enrollment_monthly_county","known_gaps":["SUPERSEDED AS THE CURRENT METHOD on 2026-10-08: Ben signed Plan Value v16 (theta range rule, card by what the money buys, D-SNP full-dual column), served as medicare_semantic.vw_plan_value_plans / vw_plan_value_cells / vw_plan_value_pairs. This August v1 view stays queryable by name as the record of the v1 signature; quote v16 for current values.","Every value is MODELED, never a filed benefit and never a paid claim; label it modeled.","WEIGHT BY county_enrollment_feb for any county-weighted figure. It is the plan's real February enrollment in that county (CMS monthly file). NULL means CMS suppressed the cell at under 11 members (151,885 of 445,771 rows) or the cell had no match in the February file (189 rows), measured 2026-09-17 (Athena fc6cedff); county_enrollment_lower_bound / _upper_bound sit beside it. Never read a null as zero.","plan_enrollment_feb_per_segment_proxy is NOT a county weight: it is the PLAN's February enrollment divided by its segment count, the same number on every county row of that plan. Summing it over counties multiplies the market (measured: the old column summed to 848M against 35.7M real members). It is kept only so a pre-swap query can be reproduced. F3 in the post-signature audit.","A NULL v_by_code_<code> means that benefit category was NOT PRICED for that plan, and its value is absent from the total: the reader refused the category and the code drops a refused category from both sides. 26% of 2026 general-enrollment plans (956 of 3,651) lack at least one category, and nothing else on the row says so. F8 in the audit.","v_by_code_16a exists only from design year 2025 (measured 2026-09-17, Athena 1e9a07df: 0 non-null in 2023 and 2024, 116,055 and 124,930 in 2025 and 2026). The category did not exist before 2025, so zero is the right answer, not a gap.","A filed copay RANGE is valued at its MINIMUM, CMS's own out-of-pocket-cost convention (_MC_MIN). 32% of general enrollment files the specialist copay as a range with a mean gap of $42. Disclose it and bound it. F10 in the audit.","refusal_reason is the EMPTY STRING on all 445,771 rows today, never null (measured 2026-09-17, Athena fc6cedff): exclude with refusal_reason = '', not IS NOT NULL. The column is the contract for future runs.","v_b minus v_national is the county adjustment; rake_converged / rake_max_rel_gap and identity_gap are diagnostics, not values.","No plan has two segments in one county (max segments_of_plan_in_county = 1, measured 2026-09-17): county enrollment is never double counted across segments.","No row-level provenance columns; trace is upstream lineage to the national-basis view, the signed run id d06cf1bf7 and the rebuild manifest."],"notes":"Name: Ben chose \"Vlada Plan Value\" on 2026-09-17. \"BenVAT\" survives in the source id, the code and the retired table names until a rename lane changes them.","superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["benefit_design_year","contract","plan","segment"],"backing_store":"glue"},{"source_id":"vlada_plan_value_plans","source_fqn":"medicare_semantic.vw_plan_value_plans","title":"Vlada Plan Value (Method Lock 1.0 + PV-55, signed 2026-10-17; served build v19e) per plan-segment, 2026 and 2027, five legs, range ends, card bounds, D-SNP two columns","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per plan-segment (plan_segment_key = '<contract>-<plan>-<segment>', unique; 8,709 rows over 8,080 contract-plans, measured 2026-10-16 in Athena on vw_plan_value_plans_v19d and 2026-10-17 on _v19e, as v18). Every CY2026 and CY2027 plan-segment is a row; 6,598 are valued in at least one year, 5,472 carry 2026 members in the locked atoms, 3,237 carry none (new in 2027 or memberless); unvalued years keep NULL values. contract_plan repeats across a plan's segments (327 plans file more than one segment, 289 of them with different values per segment).","description":"Vlada Plan Value v16, the method Ben signed on 2026-10-08 (build plan_value_*_v16 on atoms benefit_engine_atoms_v20261007a, Edition 1.1 locked benefits; recommended variant fixcard3_design_on): value to the member, PMPM, modeled, for 2026 and 2027. Served build v19e = Method Lock 1.0 (v19d, signed by Ben 2026-10-15, final 2026-10-16) + PV-55 (the ER copay charged on every visit, CMS's convention), signed by Ben 2026-10-17 on docs/ma-value-engine/lock/v19/GATE-RECEIPT-v19e.json as the Plan Value for launch (docs/ma-value-engine/V19-2025-2027.md): the v16 method plus the v18c / v18d / v18e fixes, the SSBCI eligibility rule, U3, D3 and the extras read through one reader on benefit edition v20261015d; 2027 Part D FINAL on CMS's CY2027 formulary; CY2025 built (not in this view). The headline is all-in for every product type except D-SNP: medical cost-sharing value at the expected position in each filed range (theta) + extras (supplemental, the card valued by what the money buys: 0.645 grocery / utility / rent / SSBCI-type dollars, 0.30 OTC dollars) + Part D + Part B buydown - member premium, one column per leg. Beside it: the minimum-end and maximum-end values (the range rule), the card bounds (every card dollar at 0.30 / 0.72), the headline without Part D, and the filed design. D-SNP has two columns: the full-dual headline (extras + Part D against the Extra Help comparator, medical $0) and the filed design (for partial duals and design comparison), plus Medicaid's cost-sharing protection published beside, never in a total. Pinned name medicare_semantic.vw_plan_value_plans_v19e; previous builds v19d (ER waiver on admission refused) and v18 (interim 2027 Part D) stay queryable as vw_plan_value_plans_v19d / vw_plan_value_plans_v18. The August v1 views (vw_plan_value_national / vw_plan_value_county) stay queryable by name. Owner source: register w3 vlada_w3_benvat.","identity_key":"plan_segment_key,contract_id,plan_id,segment_id","row_count":8709,"last_updated":"2026-10-17","freshness_sla":"Rebuilt per signed Plan Value build (the build column names it; part_d_2027_basis says how 2027 Part D is priced) (a rebuild that moves a value needs a fresh signature).","recollection":{"cadence":"annual","watermark_field":"build","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The build column names the signed build (plan_value_v19e); a new signed build is a new versioned view and a pointer flip, never an overwrite.","GRAIN: v18 on (v19d and v19e too), one row per plan-segment (grain = plan_segment, product_type_2027 / parent_organization_2027 for the 2027 side). A rollback to v17b serves contract-plan rows with the same columns (grain = contract_plan, segment columns NULL).","HOW TO QUERY WELL: one row per plan-segment, no period filter needed (2026 and 2027 are columns). Filter is_valued_2026 (or _2027) and product_type; weight by members_sept_2026; for a market figure read vw_plan_value_cells (the signed member-weighted cells) rather than re-averaging plans."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_plan_value_plans","provenance_chain_ref":"medicare_semantic.plan_value_plans_v19e (ops/sql/plan_value/plan_value_plans_v19e.sql, built by ops/sb_llm/tools/plan_value_v19.py) + range ends medicare_semantic.plan_value_ends_plans_v19e (the build's own fixcard3min / fixcard3max variants) + atoms benefit_engine_atoms_v20261015d; serving SQL ops/sql/plan_value/serve_v19e/ (generated from serve_v19d/ by ops/sb_llm/tools/plan_value_v19_serve_sql.py --version v19e); doc docs/ma-value-engine/V19-2025-2027.md; gate receipt docs/ma-value-engine/lock/v19/GATE-RECEIPT-v19e.json","known_gaps":["Every value is MODELED value to the member, never a filed benefit, a bid or a paid claim; label it modeled.","MEDICAL ER (v19e, PV-55): the plan's ER cost is an upper bound (the ER copay charged on every visit, waiver on admission not applied; CMS convention). Against v19d it lowers non-D-SNP levels by about $2-4 a month and barely moves a change; the D-SNP full-dual headline (medical $0) does not move.","NEVER POOL PRODUCT TYPES: compare a plan with plans of the same product_type (non-SNP HMO, non-SNP PPO, D-SNP HMO, D-SNP PPO, C-SNP HMO, C-SNP PPO, I-SNP HMO, I-SNP PPO). A D-SNP headline (full dual) and a non-SNP headline (all-in) are different definitions (headline_definition).","D-SNP TWO COLUMNS: plan_value_* on a D-SNP is the full-dual column (= dsnp_full_dual_plan_value_*): extras + Part D against the Extra Help comparator, medical $0, buydown and premium excluded. filed_design_plan_value_* is the plan as filed (partial duals, design comparison). medicaid_cost_sharing_protection_* is what Medicaid's cost-sharing protection is worth to a full dual: NOT plan value, never add it to a total.","A NULL is never $0: the plan is not valued that year (is_valued_2026 / is_valued_2027). Filter before averaging, and weight a group by members_sept_2026 (NULL for a segment with no 2026 members).","2027 PART D (builds v19d and v19e, FINAL): part_d_2027_basis per plan-segment = final_2027_formulary (the plan's 2027 Part D design priced on its own CY2027 formulary, CMS's October 2026 release) | no_part_d_filed ($0, labelled) | refused (not valued, NULL); part_d_2027_carried_from_2026 is always false. plan_value_excl_part_d_* is the like-for-like reading of the other legs.","Ranges are valued at their EXPECTED position (theta per category), not CMS's minimum convention: quote plan_value_min_end_* / plan_value_max_end_* beside the headline. On a D-SNP full-dual headline the medical leg is $0, so its ends equal the headline; the filed design carries its own ends.","The card is the largest open sensitivity (no public redemption data): quote plan_value_card_low_* / _high_* for a single plan (D-SNP HMO nationally $114.42 to $186.27 around $159.84 in 2026, v19d and v19e).","2027 is priced on the 2026 cohort, statute and dollars (a design comparison, not a 2027 forecast).","Medicaid nominal copays are not modelled in the full-dual column (slightly high)."],"notes":null,"superseded_by":null,"tools":["get_plan_value"],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["plan_segment_key"],"backing_store":"glue"},{"source_id":"vlada_plan_value_cells","source_fqn":"medicare_semantic.vw_plan_value_cells","title":"Vlada Plan Value (Method Lock 1.0 + PV-55, signed 2026-10-17; served build v19e) market cells, national / state / county x product type x plan type x parent, 2026 and 2027 levels","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per geography_level x state x county_ssa x product_type x plan_type x parent_organization (129,363 rows = 129,363 distinct keys, measured 2026-10-08 on vw_plan_value_cells_v16, _v17b, _v18 (2026-10-09), _v19d (2026-10-16) and _v19e (2026-10-17); 792 national, 3,834 state, 124,737 county; 52 states and territories, 3,116 counties, 166 parents + ALL). plan_type 'ALL' = every plan type of the product type; parent_organization 'ALL' = the whole market. product_type is never pooled ('ALL' is not served).","description":"Vlada Plan Value member-weighted: each value is the signed sum over September 2026 members divided by the members valued (plan_value_cells_v19e at base_year 2026, recommended fixcard3_design_on, read straight). Served build v19e = Method Lock 1.0 (v19d, signed by Ben 2026-10-15, final 2026-10-16) + PV-55 (the ER copay charged on every visit, CMS's convention), signed by Ben 2026-10-17 on docs/ma-value-engine/lock/v19/GATE-RECEIPT-v19e.json as the Plan Value for launch (docs/ma-value-engine/V19-2025-2027.md): the v16 method plus the v18c / v18d / v18e fixes, the SSBCI eligibility rule, U3, D3 and the extras read through one reader on benefit edition v20261015d; 2027 Part D FINAL on CMS's CY2027 formulary; CY2025 built (not in this view; the table carries base_year 2025 too).  2026 = every 2026 member in their 2026 plan; 2027 = the same members followed to their 2027 plan (same plan or CMS's crosswalk), priced on the 2026 cohort, statute and dollars. Columns: the headline and its five legs, the minimum-end and maximum-end values, the card bounds, the headline without Part D, the filed design with its legs, ends and bounds, the valued shares, and for D-SNP the full-dual column and the share of members in $0-cost-sharing segments. Pinned version: medicare_semantic.vw_plan_value_cells_v19e (served build v19e). Owner source: register w3 vlada_w3_benvat.","identity_key":"geography_level,state,county_ssa,product_type,plan_type,parent_organization","row_count":129363,"last_updated":"2026-10-17","freshness_sla":"Rebuilt per signed Plan Value build.","recollection":{"cadence":"annual","watermark_field":"build","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The build column names the signed build (plan_value_v19e); a new signed build is a new versioned view and a pointer flip, never an overwrite.","HOW TO QUERY WELL: always WHERE geography_level = 'national' | 'state' | 'county' AND product_type = '<one type>'; parent_organization = 'ALL' for the market, plan_type = 'ALL' for the whole product type; state = 'US' on national rows. Join vw_plan_value_pairs on the same six keys for the same-member change."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_plan_value_cells","provenance_chain_ref":"medicare_semantic.plan_value_cells_v19e (ops/sql/plan_value/plan_value_cells_v19e.sql; every cell and pair recomputed, 13,325,378 values, 0 mismatches) + medicare_semantic.plan_value_ends_cells_v19e (the signed min / max variants); serving SQL ops/sql/plan_value/serve_v19e/ (served view = signed table, 129,363 cells, 0 differ); doc docs/ma-value-engine/V19-2025-2027.md","known_gaps":["Every value is MODELED value to the member; label it modeled.","MEDICAL ER (v19e, PV-55): the plan's ER cost is an upper bound (the ER copay charged on every visit, waiver on admission not applied; CMS convention). Against v19d it lowers non-D-SNP levels by about $2-4 a month and barely moves a change; the D-SNP full-dual headline (medical $0) does not move.","REQUIRED: pin geography_level and filter product_type; never sum or average across product types (the D-SNP headline is the full-dual column, the others are all-in).","LEVELS ARE NOT CHANGES: plan_value_2027 describes the 2026 members followed (fewer members, members_2027_followed), so plan_value_2027 - plan_value_2026 is NOT the change. The same-member change is vw_plan_value_pairs (members valued in both years), on the same keys.","D-SNP TWO COLUMNS: plan_value_* = dsnp_full_dual_plan_value_* (extras + Part D vs Extra Help, medical $0); filed_design_plan_value_* beside it. Medicaid's cost-sharing protection is not plan value and is not in this view (plan grain only, vw_plan_value_plans).","A NULL is never $0: no valued member in the cell (valued_share_* = 0 or null; non-SNP other is never valued). Quote valued_share_* with any value.","2027 Part D (v19d and v19e, FINAL on CMS's CY2027 formulary): part_d_2027_filed_share = the members followed to 2027 whose 2027 Part D is priced, part_d_2027_refused_share = not valued, part_d_2027_carried_share = 0 (nothing is carried).","Thin county cells: a county x parent x plan type cell can rest on a handful of members; read members_2026 and valued_share_2026 before quoting a county value."],"notes":null,"superseded_by":null,"tools":["get_plan_value"],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["geography_level","parent_organization","plan_type","product_type"],"backing_store":"glue"},{"source_id":"vlada_plan_value_pairs","source_fqn":"medicare_semantic.vw_plan_value_pairs","title":"Vlada Plan Value (Method Lock 1.0 + PV-55, signed 2026-10-17; served build v19e) same-member change 2026 -> 2027, national / state / county x product type x plan type x parent","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per geography_level x state x county_ssa x product_type x plan_type x parent_organization (117,836 rows = 117,836 distinct keys, measured 2026-10-08 on vw_plan_value_pairs_v16, _v17b, _v18 (2026-10-09), _v19d (2026-10-16) and _v19e (2026-10-17)). Same keys as vw_plan_value_cells.","description":"Vlada Plan Value (served build v19e, Method Lock 1.0 + PV-55), the same-member change: each 2026 member followed to their 2027 plan, counted only when the plan is valued in both years; *_2026 and *_2027 are levels on those members, *_change = 2027 - 2026. Every leg, the minimum-end and maximum-end values, the card bounds, the headline without Part D, the filed design and the D-SNP full-dual column, each with 2026 / 2027 / change. Ratios of the signed sums in plan_value_pairs_v19e at base_year 2026 (recommended fixcard3_design_on). Pinned name: medicare_semantic.vw_plan_value_pairs_v19e (served build v19e). Owner source: register w3 vlada_w3_benvat.","identity_key":"geography_level,state,county_ssa,product_type,plan_type,parent_organization","row_count":117836,"last_updated":"2026-10-17","freshness_sla":"Rebuilt per signed Plan Value build.","recollection":{"cadence":"annual","watermark_field":"build","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The build column names the signed build (plan_value_v19e); a new signed build is a new versioned view and a pointer flip, never an overwrite.","HOW TO QUERY WELL: WHERE geography_level = ... AND product_type = ...; parent_organization = 'ALL' for the market; read *_change with members_valued_both_years beside it."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_plan_value_pairs","provenance_chain_ref":"medicare_semantic.plan_value_pairs_v19e (ops/sql/plan_value/plan_value_pairs_v19e.sql) + medicare_semantic.plan_value_ends_pairs_v19e (the signed min / max variants regrouped); serving SQL ops/sql/plan_value/serve_v19e/ (served view = signed table, 117,836 pairs, 0 differ); doc docs/ma-value-engine/V19-2025-2027.md","known_gaps":["Every value is MODELED value to the member; label it modeled.","MEDICAL ER (v19e, PV-55): the plan's ER cost is an upper bound (the ER copay charged on every visit, waiver on admission not applied; CMS convention). Against v19d it lowers non-D-SNP levels by about $2-4 a month and barely moves a change; the D-SNP full-dual headline (medical $0) does not move.","REQUIRED: pin geography_level and filter product_type; never pool product types.","The base is members valued in BOTH years (members_valued_both_years), so plan_value_2026 here differs from the cells view's 2026 level (every member). Quote the change from this view and the levels from vw_plan_value_cells, and say which.","2027 Part D (v19d and v19e, FINAL on CMS's CY2027 formulary): a member valued in both years has a priced 2027 Part D; part_d_2027_filed_share = 1 and part_d_2027_carried_share = 0 wherever any member is valued.","D-SNP: plan_value_change is the full-dual change; filed_design_plan_value_change is the filed design's.","A NULL is never $0 (no member valued in both years)."],"notes":null,"superseded_by":null,"tools":["get_plan_value"],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["geography_level","parent_organization","plan_type","product_type"],"backing_store":"glue"},{"source_id":"vlada_plan_value_shelf_v18","source_fqn":"medicare_semantic.plan_value_shelf_v18","title":"Vlada Plan Value v18 parent shelf + ranking (who cut, who added), national / state / county x product type x parent","domain":"medicare","stage":"mart","status":"live","grain":"One row per geography_level x state x county_ssa x product_type x parent_organization, parent ALL = the market (80,160 rows = 80,160 distinct keys, measured 2026-10-09 in Athena - national 408, state 1,905, county 77,847; nine product types, never pooled).","description":"Every parent in a place, for one product type, on two bases side by side. SAME MEMBERS (wtd_plan_value_2026 / _2027 / wtd_change, members_followed, members_valued_both_years): the signed same-member numbers of vw_plan_value_pairs_v18 at plan_type ALL, equal on every row. PLANS ON THE SHELF (avg_plan_value_2026 / _2027 / avg_change, avg_xpd_* without Part D): the simple average over the distinct plan-segments the parent offers in the geography each contract year (CMS service area, vw_pbp_plan_county_service_area; regional PPOs over every county of their CMS region; employer plans 800-899 excluded; valued plans only), with plans_offered / new / dropped / valued counts and ranks (1 = biggest increase among parents, ties by members_2026). State and national averages are over the DISTINCT plan-segments offered anywhere in the state / nation. Parent of a 2027 plan = parent_organization_2027, else the contract's resolved parent (vw_ma_parent_resolved_v1), else 'NEW CONTRACT: ' + the landscape parent. Built by ops/scripts/plan_value_shelf_sql.py; gates ops/scripts/plan_value_shelf_check.py. Owner source: register w3 vlada_w3_benvat.","identity_key":"geography_level,state,county_ssa,product_type,parent_organization","row_count":80160,"last_updated":"2026-10-09","freshness_sla":"Rebuilt per signed Plan Value build (a new build is a new versioned table, never an overwrite).","recollection":{"cadence":"annual","watermark_field":"build","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["build = plan_value_shelf_v18; the v19 shelf (CY2027 formulary) is a new table.","HOW TO QUERY WELL: WHERE geography_level = 'county' AND county_ssa = ... AND product_type = ... ORDER BY rank_wtd_change (same members) or rank_avg_change (shelf); parent_organization = 'ALL' is the market."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.plan_value_shelf_v18","provenance_chain_ref":"medicare_semantic.vw_plan_value_pairs_v18 + vw_plan_value_cells_v18 + vw_plan_value_plans_v18 (signed Plan Value v18) + medicare_semantic.vw_pbp_plan_county_service_area + medicare_silver.pbp_plan_region_area; DDL ops/sql/plan_value/plan_value_shelf_v18.sql; doc docs/ma-value-engine/SHELF-V18.md","known_gaps":["Every value is MODELED value to the member; label it modeled.","NEVER POOL PRODUCT TYPES. REQUIRED: WHERE product_type = ... AND geography_level = ...; there is no product_type ALL row. The D-SNP headline is the full dual.","THE SIMPLE AVERAGE IS THE SHELF, NOT THE MEMBERS: avg_* weights every offered plan once, whatever its enrollment, and compares two different plan sets (2026 shelf vs 2027 shelf). The members' experience is wtd_* (same members). Quote which basis, and never subtract one from the other.","A NULL IS NEVER $0: a plan with no value is left out of the average (plans_valued_2027 says how many counted); a parent with no members followed has NULL wtd_*; ranks are NULL where the value is NULL.","BRAND-NEW 2027 PLANS LACK 2027 PART D UNTIL v19: they have no 2027 headline until CMS posts the CY2027 formulary, so they count in plans_offered_2027 / plans_new_2027 but not in avg_plan_value_2027; they count in avg_xpd_2027 where valued. Quote plans_valued_2027 of plans_offered_2027 beside a shelf number.","plans_new_2027 / plans_dropped_2027 are relative to the geography: a plan-segment offered here in 2027 and not here in 2026 (a service-area expansion counts as new here).","Many regional PPO plan-segments carry no v18 value (e.g. Humana R0110): they count as offered, not in the averages."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["geography_level","parent_organization","product_type"],"backing_store":"glue"},{"source_id":"vlada_plan_value_shelf_v18b","source_fqn":"medicare_semantic.plan_value_shelf_v18b","title":"Vlada Plan Value v18 parent shelf + ranking, v18b (who cut, who added; new contracts rolled into their parent), national / state / county x product type x parent","domain":"medicare","stage":"mart","status":"live","grain":"One row per geography_level x state x county_ssa x product_type x parent_organization, parent ALL = the market (80,012 rows = 80,012 distinct keys, measured 2026-10-09 in Athena - national 389, state 1,895, county 77,728; nine product types, never pooled).","description":"Every parent in a place, for one product type, on two bases side by side. SAME MEMBERS (wtd_plan_value_2026 / _2027 / wtd_change, members_followed, members_valued_both_years): the signed same-member numbers of vw_plan_value_pairs_v18 at plan_type ALL, equal on every row. PLANS ON THE SHELF (avg_plan_value_2026 / _2027 / avg_change, avg_xpd_* without Part D): the simple average over the distinct plan-segments the parent offers in the geography each contract year (CMS service area, vw_pbp_plan_county_service_area; regional PPOs over every county of their CMS region; employer plans 800-899 excluded; valued plans only), with plans_offered / new / dropped / valued counts and ranks (1 = biggest increase among parents, ties by members_2026). State and national averages are over the DISTINCT plan-segments offered anywhere in the state / nation. Parent of a 2027 plan = parent_organization_2027, else the contract's resolved parent (vw_ma_parent_resolved_v1), else the landscape parent: that parent itself when it is already a resolved parent (v18b: a new contract of a known parent rolls into it), else 'NEW CONTRACT: ' + the name. /ma reads v18b. Built by ops/scripts/plan_value_shelf_sql.py; gates ops/scripts/plan_value_shelf_check.py. Owner source: register w3 vlada_w3_benvat.","identity_key":"geography_level,state,county_ssa,product_type,parent_organization","row_count":80012,"last_updated":"2026-10-09","freshness_sla":"Rebuilt per signed Plan Value build (a new build is a new versioned table, never an overwrite).","recollection":{"cadence":"annual","watermark_field":"build","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["build = plan_value_shelf_v18; the v19 shelf (CY2027 formulary) is a new table.","HOW TO QUERY WELL: WHERE geography_level = 'county' AND county_ssa = ... AND product_type = ... ORDER BY rank_wtd_change (same members) or rank_avg_change (shelf); parent_organization = 'ALL' is the market."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.plan_value_shelf_v18b","provenance_chain_ref":"medicare_semantic.vw_plan_value_pairs_v18 + vw_plan_value_cells_v18 + vw_plan_value_plans_v18 (signed Plan Value v18) + medicare_semantic.vw_pbp_plan_county_service_area + medicare_silver.pbp_plan_region_area; DDL ops/sql/plan_value/plan_value_shelf_v18b.sql; doc docs/ma-value-engine/SHELF-V18.md","known_gaps":["Every value is MODELED value to the member; label it modeled.","NEVER POOL PRODUCT TYPES. REQUIRED: WHERE product_type = ... AND geography_level = ...; there is no product_type ALL row. The D-SNP headline is the full dual.","THE SIMPLE AVERAGE IS THE SHELF, NOT THE MEMBERS: avg_* weights every offered plan once, whatever its enrollment, and compares two different plan sets (2026 shelf vs 2027 shelf). The members' experience is wtd_* (same members). Quote which basis, and never subtract one from the other.","A NULL IS NEVER $0: a plan with no value is left out of the average (plans_valued_2027 says how many counted); a parent with no members followed has NULL wtd_*; ranks are NULL where the value is NULL.","BRAND-NEW 2027 PLANS LACK 2027 PART D UNTIL v19: they have no 2027 headline until CMS posts the CY2027 formulary, so they count in plans_offered_2027 / plans_new_2027 but not in avg_plan_value_2027; they count in avg_xpd_2027 where valued. Quote plans_valued_2027 of plans_offered_2027 beside a shelf number.","plans_new_2027 / plans_dropped_2027 are relative to the geography: a plan-segment offered here in 2027 and not here in 2026 (a service-area expansion counts as new here).","Many regional PPO plan-segments carry no v18 value (e.g. Humana R0110): they count as offered, not in the averages."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["geography_level","parent_organization","product_type"],"backing_store":"glue"},{"source_id":"vlada_plan_value_shelf_v19d","source_fqn":"medicare_semantic.plan_value_shelf_v19d","title":"Vlada Plan Value v19d parent shelf + ranking (Method Lock 1.0; who cut, who added; new contracts rolled into their parent), national / state / county x product type x parent","domain":"medicare","stage":"mart","status":"live","grain":"One row per geography_level x state x county_ssa x product_type x parent_organization, parent ALL = the market (80,002 rows = 80,002 distinct keys, measured 2026-10-16 in Athena - national 390, state 1,896, county 77,716; nine product types, never pooled).","description":"Every parent in a place, for one product type, on two bases side by side. SAME MEMBERS (wtd_plan_value_2026 / _2027 / wtd_change, members_followed, members_valued_both_years): the signed same-member numbers of vw_plan_value_pairs_v19d at plan_type ALL, equal on every row. PLANS ON THE SHELF (avg_plan_value_2026 / _2027 / avg_change, avg_xpd_* without Part D): the simple average over the distinct plan-segments the parent offers in the geography each contract year (CMS service area, vw_pbp_plan_county_service_area; regional PPOs over every county of their CMS region; employer plans 800-899 excluded; valued plans only), with plans_offered / new / dropped / valued counts and ranks (1 = biggest increase among parents, ties by members_2026). State and national averages are over the DISTINCT plan-segments offered anywhere in the state / nation. Parent of a 2027 plan = parent_organization_2027, else the contract's resolved parent (vw_ma_parent_resolved_v1), else the landscape parent: that parent itself when it is already a resolved parent (a new contract of a known parent rolls into it, as v18b), else 'NEW CONTRACT: ' + the name. /ma reads v19d after the flip. Built by ops/scripts/plan_value_shelf_sql.py; gates ops/scripts/plan_value_shelf_check.py. Owner source: register w3 vlada_w3_benvat.","identity_key":"geography_level,state,county_ssa,product_type,parent_organization","row_count":80002,"last_updated":"2026-10-16","freshness_sla":"Rebuilt per signed Plan Value build (a new build is a new versioned table, never an overwrite).","recollection":{"cadence":"annual","watermark_field":"build","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["build = plan_value_shelf_v19d; a new signed Plan Value build is a new shelf table, never an overwrite.","HOW TO QUERY WELL: WHERE geography_level = 'county' AND county_ssa = ... AND product_type = ... ORDER BY rank_wtd_change (same members) or rank_avg_change (shelf); parent_organization = 'ALL' is the market."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.plan_value_shelf_v19d","provenance_chain_ref":"medicare_semantic.vw_plan_value_pairs_v19d + vw_plan_value_cells_v19d + vw_plan_value_plans_v19d (Plan Value v19d, Method Lock 1.0) + medicare_semantic.vw_pbp_plan_county_service_area + medicare_silver.pbp_plan_region_area; DDL ops/sql/plan_value/plan_value_shelf_v19d.sql (gates ops/scripts/plan_value_shelf_check.py, 10 of 10 pass); doc docs/ma-value-engine/SHELF-V18.md","known_gaps":["Every value is MODELED value to the member; label it modeled.","NEVER POOL PRODUCT TYPES. REQUIRED: WHERE product_type = ... AND geography_level = ...; there is no product_type ALL row. The D-SNP headline is the full dual.","THE SIMPLE AVERAGE IS THE SHELF, NOT THE MEMBERS: avg_* weights every offered plan once, whatever its enrollment, and compares two different plan sets (2026 shelf vs 2027 shelf). The members' experience is wtd_* (same members). Quote which basis, and never subtract one from the other.","A NULL IS NEVER $0: a plan with no value is left out of the average (plans_valued_2027 says how many counted); a parent with no members followed has NULL wtd_*; ranks are NULL where the value is NULL.","2027 PART D IS FINAL (v19d, CMS's CY2027 formulary): a brand-new 2027 plan has its 2027 headline and counts in the averages; a plan whose Part D could not be priced counts as offered, in avg_xpd where its other legs are valued.","plans_new_2027 / plans_dropped_2027 are relative to the geography: a plan-segment offered here in 2027 and not here in 2026 (a service-area expansion counts as new here).","A regional PPO plan-segment with no v19d value counts as offered, not in the averages."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["geography_level","parent_organization","product_type"],"backing_store":"glue"},{"source_id":"vlada_plan_value_shelf_v19e","source_fqn":"medicare_semantic.plan_value_shelf_v19e","title":"Vlada Plan Value v19e parent shelf + ranking (Method Lock 1.0 + PV-55; who cut, who added; new contracts rolled into their parent), national / state / county x product type x parent","domain":"medicare","stage":"mart","status":"live","grain":"One row per geography_level x state x county_ssa x product_type x parent_organization, parent ALL = the market (80,002 rows = 80,002 distinct keys, measured 2026-10-17 in Athena - national 390, state 1,896, county 77,716; nine product types, never pooled).","description":"Every parent in a place, for one product type, on two bases side by side. SAME MEMBERS (wtd_plan_value_2026 / _2027 / wtd_change, members_followed, members_valued_both_years): the signed same-member numbers of vw_plan_value_pairs_v19e at plan_type ALL, equal on every row. PLANS ON THE SHELF (avg_plan_value_2026 / _2027 / avg_change, avg_xpd_* without Part D): the simple average over the distinct plan-segments the parent offers in the geography each contract year (CMS service area, vw_pbp_plan_county_service_area; regional PPOs over every county of their CMS region; employer plans 800-899 excluded; valued plans only), with plans_offered / new / dropped / valued counts and ranks (1 = biggest increase among parents, ties by members_2026). State and national averages are over the DISTINCT plan-segments offered anywhere in the state / nation. Parent of a 2027 plan = parent_organization_2027, else the contract's resolved parent (vw_ma_parent_resolved_v1), else the landscape parent: that parent itself when it is already a resolved parent (a new contract of a known parent rolls into it, as v18b), else 'NEW CONTRACT: ' + the name. /ma reads v19e after the v19e flip. Built by ops/scripts/plan_value_shelf_sql.py; gates ops/scripts/plan_value_shelf_check.py. Owner source: register w3 vlada_w3_benvat.","identity_key":"geography_level,state,county_ssa,product_type,parent_organization","row_count":80002,"last_updated":"2026-10-17","freshness_sla":"Rebuilt per signed Plan Value build (a new build is a new versioned table, never an overwrite).","recollection":{"cadence":"annual","watermark_field":"build","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["build = plan_value_shelf_v19e; a new signed Plan Value build is a new shelf table, never an overwrite.","HOW TO QUERY WELL: WHERE geography_level = 'county' AND county_ssa = ... AND product_type = ... ORDER BY rank_wtd_change (same members) or rank_avg_change (shelf); parent_organization = 'ALL' is the market."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.plan_value_shelf_v19e","provenance_chain_ref":"medicare_semantic.vw_plan_value_pairs_v19e + vw_plan_value_cells_v19e + vw_plan_value_plans_v19e (Plan Value v19e, Method Lock 1.0 + PV-55) + medicare_semantic.vw_pbp_plan_county_service_area + medicare_silver.pbp_plan_region_area; DDL ops/sql/plan_value/plan_value_shelf_v19e.sql (gates ops/scripts/plan_value_shelf_check.py, 10 of 10 pass); doc docs/ma-value-engine/SHELF-V18.md","known_gaps":["Every value is MODELED value to the member; label it modeled.","MEDICAL ER (v19e, PV-55): the plan's ER cost is an upper bound (the ER copay charged on every visit, waiver on admission not applied; CMS convention). Against v19d it lowers non-D-SNP levels by about $2-4 a month and barely moves a change; the D-SNP full-dual headline (medical $0) does not move.","NEVER POOL PRODUCT TYPES. REQUIRED: WHERE product_type = ... AND geography_level = ...; there is no product_type ALL row. The D-SNP headline is the full dual.","THE SIMPLE AVERAGE IS THE SHELF, NOT THE MEMBERS: avg_* weights every offered plan once, whatever its enrollment, and compares two different plan sets (2026 shelf vs 2027 shelf). The members' experience is wtd_* (same members). Quote which basis, and never subtract one from the other.","A NULL IS NEVER $0: a plan with no value is left out of the average (plans_valued_2027 says how many counted); a parent with no members followed has NULL wtd_*; ranks are NULL where the value is NULL.","2027 PART D IS FINAL (v19e, CMS's CY2027 formulary): a brand-new 2027 plan has its 2027 headline and counts in the averages; a plan whose Part D could not be priced counts as offered, in avg_xpd where its other legs are valued.","plans_new_2027 / plans_dropped_2027 are relative to the geography: a plan-segment offered here in 2027 and not here in 2026 (a service-area expansion counts as new here).","A regional PPO plan-segment with no v19e value counts as offered, not in the averages."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["geography_level","parent_organization","product_type"],"backing_store":"glue"},{"source_id":"vlada_benvat_v1_plan_county","source_fqn":"medicare_semantic.benvat_v1_plan_county","title":"BenVAT v1 plan value per contract x plan x segment x county x benefit year (Vlada's modeled benefit valuation)","domain":"medicare","stage":"mart","status":"retired","grain":"One row per benefit_design_year x contract x plan x segment x county_ssa (measured 2026-09-10 in Athena, 9,948,020 rows = 9,948,020 distinct keys; 1,107 contracts, 10,890 plan-segments, CY2023-CY2026). All 41 columns are strings; cast before arithmetic.","description":"Vlada BenVAT v1 output (county basis run d06cf1bf7, signed 2026-08-27): total plan value PMPM with _low/_high bounds and grade, medical value beyond Medicare, supplemental expected plan expense, Part B giveback and Part C/D premiums, the net totals, and the D-SNP split (beneficiary value, plan liability, state transfer). Modeled from the PBP, Landscape, ratebook and enrollment sources; never a CMS figure or a paid claim. Owner source: register w3 vlada_w3_benvat (door RAW, locked by Ben 2026-09-03). Catalog card added 2026-09-10: the table was in the register and in Glue but absent from data_sources.yaml, so discovery pruned it and query_substrate refused it.","identity_key":"contract,plan,segment,county_ssa,benefit_design_year","row_count":9948020,"last_updated":"2026-08-27","freshness_sla":"Annual (rebuilt when the PBP / Landscape year lands); the county basis run is signed (d06cf1bf7, 2026-08-27).","recollection":{"cadence":"annual","watermark_field":"benefit_design_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin benefit_design_year; giveback and premiums are separate columns, net values are the v1_total_*_net_* fields."]},"raw_queryable_via":"RETIRED: refused by query_substrate. Use medicare_semantic.vw_plan_value_national.","provenance_chain_ref":"BenVAT v1 county basis run d06cf1bf7 over cms_ma_pbp + cms_ma_landscape + cms_ma_ratebook + cms_ma_monthly_enrollment (register w3 vlada_w3_benvat); Glue external table at s3://vlada-platform-raw/medicare_semantic/benvat_v1_plan_county","known_gaps":["RETIRED 2026-09-17. The DATA was the signed data (every yearly file's sha256 matched the signed receipt), but the table over it read CSV positionally and typed every column as a string. Superseded by medicare_semantic.vw_plan_value_national. The S3 prefix is kept; rollback is re-pointing the register.","Why it is retired: all 41 columns are strings, so an unvalued cell is the empty string and count() reported a value on every one of the 9,948,020 rows (measured 2026-09-17, Athena e997143d: 9,485,507 empty strings against 462,513 real values on the successor). Its snp_type is the raw CMS code ('' / 1 / 3 / 4) while the county table used labels, so a filter copied between the two returned zero rows (F4).","Modeled value, never a filed benefit or a paid claim; label it modeled and quote the _low/_high bounds for a single plan.","Rows are county cells; weight by real county enrollment (county_enrollment_feb on the successor's county-basis view) for a plan-, contract- or parent-level figure.","No row-level provenance columns (no source_url / sha256); trace is upstream lineage to the four W3 sources and the signed run id.","The register data points' keys omitted `contract` until 2026-09-10; `plan` alone (e.g. '801') is shared by hundreds of contracts."],"notes":null,"superseded_by":"medicare_semantic.vw_plan_value_national (typed rebuild 2026-09-17, verified cell-for-cell against the signed deliverables: real doubles instead of 41 string columns, one column layout for every year, one SNP coding, and real NULLs where the CSV carried the empty string)","tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["benefit_design_year","contract","plan","segment"],"backing_store":"glue"},{"source_id":"vlada_benvat_county_v1","source_fqn":"medicare_semantic.benvat_county_v1","title":"BenVAT county basis (v_B vs national) per contract x plan x segment x county x benefit year, with refusal reasons","domain":"medicare","stage":"mart","status":"retired","grain":"One row per benefit_design_year x contract x plan x segment x county_ssa (measured 2026-09-10 in Athena, 445,771 rows = 445,771 distinct keys; 844 contracts, 8,275 plan-segments, CY2023-CY2026; 0 rows carry a refusal_reason today). All 71 columns are strings; cast before arithmetic.","description":"Vlada BenVAT county basis output (run d06cf1bf7, signed 2026-08-27): the plan value re-priced and re-utilized per county (v_b) against the national value (v_national), decomposed into price_effect, util_effect and interaction, with the reference and plan PMPM, MOOP relief, the enrollment rake diagnostics and the per-benefit-code value columns (v_by_code_*). Modeled; never a CMS figure. Owner source: register w3 vlada_w3_benvat (door RAW, locked by Ben 2026-09-03). Catalog card added 2026-09-10 for the same reason as benvat_v1_plan_county.","identity_key":"contract,plan,segment,county_ssa,benefit_design_year","row_count":445771,"last_updated":"2026-08-27","freshness_sla":"Annual (rebuilt with the plan value run); the county basis run is signed (d06cf1bf7, 2026-08-27).","recollection":{"cadence":"annual","watermark_field":"benefit_design_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Pin benefit_design_year; one run per year, the newest signed run replaces the prior."]},"raw_queryable_via":"RETIRED: refused by query_substrate. Use medicare_semantic.vw_plan_value_county.","provenance_chain_ref":"BenVAT county basis run d06cf1bf7 over benvat_v1_plan_county + cms_ma_ratebook + cms_ma_monthly_enrollment (register w3 vlada_w3_benvat); Glue external table at s3://vlada-platform-raw/medicare_semantic/benvat_county_v1","known_gaps":["RETIRED 2026-09-17. The DATA was the signed data (each yearly file's sha256 matched the signed receipt), but the table over it read CSV BY POSITION and the 2023 and 2024 files have 70 columns where 2025 and 2026 have 71: v_by_code_16a sits at position 45, not at the end, so for 2023 and 2024 every per-benefit column from 16a through 9b held its right-hand neighbour's value and v_by_code_9b was empty on all 204,786 rows. 2023 mean inpatient read $0.02 where the signed value is $5.31. Superseded by medicare_semantic.vw_plan_value_county. The S3 prefix is kept; rollback is re-pointing the register. F1 in the post-signature audit.","Also why it is retired: all 71 columns are strings (F2), and the only enrollment column was the plan total repeated on every county row while the card told callers to weight by it (F3; it summed to 848M against 35.7M real members).","Exclude rows with a non-empty refusal_reason before averaging (none today; the column is the contract for future runs).","v_b minus v_national is the county adjustment; rake_converged / rake_max_rel_gap are diagnostics, not values.","No row-level provenance columns; trace is upstream lineage to the plan value table and the signed run id."],"notes":null,"superseded_by":"medicare_semantic.vw_plan_value_county (typed rebuild 2026-09-17, verified cell-for-cell against the signed deliverables: real doubles instead of 71 string columns, one column layout for every year so the 2023 and 2024 per-benefit columns are no longer shifted by one, and real county enrollment joined with its suppression bounds)","tools":[],"dataset_id":"vlada_w3_benvat","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["benefit_design_year","contract","plan","segment"],"backing_store":"glue"},{"source_id":"vlada_ma_parent_alias","source_fqn":"medicare_semantic.dim_parent_alias_v1","title":"MA parent alias dictionary, every CMS parent_org_raw string mapped to a canonical parent, effective-dated and cited","domain":"medicare","stage":"dim","status":"live","grain":"One row per parent_org_raw string x effective period. 1,076 rows over all 995 distinct strings of medicare_silver.monthly_contract_enrollment_summary 2006-08 to 2026-09 (measured 2026-09-30); a string has more than one row only where an acquisition moves it to another canonical from the close month.","description":"The alias half of ADR M-6 (docs/architecture/2026-05-09-medicare-substrate-m6-alias-lineage.md, built 2026-09-30). Every raw parent string carries canonical_parent_id / canonical_parent_name, effective_start / effective_end, event_type (self_identity, string_variant, label_change, rename, brand_of_acquirer, or the acquisition event type of a later segment), lineage_event_id, method_tier (tier0_exact 826 strings, tier0_normalized 78, tier1_corroborated 26, tier2_reasoned 66), confidence, one citation (source type, url, accessed_at, snippet), the corroboration the CMS file gives, and the string's span and size. Renames map for every month; an acquired book joins the acquirer from the close month; Aetna is the CVS Health brand for every month by decision. Seed: pipelines/medicare/data/ma_parent_lineage_v1.yaml plus lineage_event.yaml.","identity_key":"parent_org_raw,effective_start","row_count":1076,"last_updated":"2026-09-30","freshness_sla":"Rebuilt from the seed when a new parent string appears in the monthly enrollment file or an event is curated (tools/ma_brain/parent_lineage_publish.py --build --replace).","recollection":{"cadence":"monthly","watermark_field":"raw_last_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["raw_last_month is the last month the string appears in the enrollment file; a new string is unresolved in the view until the dim is rebuilt with the monthly load."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.dim_parent_alias_v1","commercial_terms":"Vlada-derived from the CMS Monthly Enrollment by Contract file and cited public corporate records.","provenance_chain_ref":"tools/ma_brain/parent_lineage_publish.py over medicare_silver.monthly_contract_enrollment_summary (distinct strings and same-contract hand-offs) and the seed YAMLs; s3://vlada-platform-raw/medicare_semantic/dim_parent_alias_v1","known_gaps":["TRAP: parent_org_raw is the name CMS gave a contract THAT MONTH; a series needs the canonical parent. Join on parent_org_raw = parent_org_raw AND report_month BETWEEN effective_start AND COALESCE(effective_end, DATE '9999-12-31'), or read medicare_semantic.vw_ma_parent_resolved_v1, which already does.","INVARIANTS (proved 2026-09-30): one canonical per raw string per month (no overlapping periods); no row without a citation_url; every lineage_event_id names a row of fact_parent_lineage_event_v1 with an effective_date.","A hand-off the CMS file shows that no cited entry explains is NOT applied: the raw string stays its own canonical (416 such hand-off groups from 389 strings, 9.9M members at the hand-off month, listed in docs/knowledge/ma/parent-lineage/residual_handoffs_v1.csv). tier2_reasoned rows carry the CMS file as their only citation and are the reviewer's red-line.","The dim maps strings, never contract-months; the Universal Health Care Inc. label CMS put on UnitedHealth's S5820 for 2006-10 (3.4M members) is left as measured and flagged by the spike detector."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_vlada_ma","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["effective_start","parent_org_raw"],"backing_store":"glue"},{"source_id":"vlada_ma_parent_lineage_event","source_fqn":"medicare_semantic.fact_parent_lineage_event_v1","title":"MA parent lineage events, acquisitions, mergers, novations, renames and divestitures with a citation and what the CMS file measured","domain":"medicare","stage":"mart","status":"live","grain":"One row per event_id. 58 events (measured 2026-09-30), 20 from the M-6 Phase 1 seed (lineage_event.yaml) and 38 from ma_parent_lineage_v1.yaml.","description":"The event half of ADR M-6. Each row carries event_name, event_type (acquisition, merger, novation, divestiture, rebrand), announced_date, effective_date (the close), cms_recognition_month (the first month the CMS file carries the successor on the moved contracts, measured), predecessor and successor parents, the contracts the seed cites and the contracts the CMS file shows moving within six months of the close (with members moved), enrollment_at_event and transaction_value_usd where cited, cascade_strategy, and one citation. Entity-level events drive the acquisition segments of dim_parent_alias_v1; contract-level divestitures (a PDP book sold while the parent continues) are recorded here only.","identity_key":"event_id","row_count":58,"last_updated":"2026-09-30","freshness_sla":"Rebuilt with dim_parent_alias_v1 when an event is curated.","recollection":{"cadence":"annual","watermark_field":"effective_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["effective_date is the cited close; events are curated, never inferred; the spike detector (parent_lineage_publish.py --spikes) lists candidates."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.fact_parent_lineage_event_v1","commercial_terms":"Vlada-curated from cited public records (SEC filings, press releases, regulators) and the CMS file.","provenance_chain_ref":"tools/ma_brain/parent_lineage_publish.py over pipelines/medicare/data/lineage_event.yaml and ma_parent_lineage_v1.yaml; s3://vlada-platform-raw/medicare_semantic/fact_parent_lineage_event_v1","known_gaps":["effective_date is the legal close where the citation gives one; five rows say \"month from the CMS file\" or \"day unmeasured\" in their snippet (cvs-healthnet-pdp-2012, uhg-kelsey-2022, regence-cambia-rename-2011, ibc-ihg-2013, aveta-innovacare-2012). The alias dim applies an acquisition from the first day of the close month, so a day-level error never moves a month.","Citation URLs were returned by web search on 2026-09-30 and not fetched in full this session; the snippet is the search result's report. The M-6 change-control CI (two-person review, URL liveness) is not built.","affected_contracts_measured is empty for a rebrand (no contract moves) and for an event whose predecessor string in the file differs from the names the event lists."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_vlada_ma","dataset_assignment_basis":"source_id_prefix","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["event_id"],"backing_store":"glue"},{"source_id":"vlada_ma_parent_resolved","source_fqn":"medicare_semantic.vw_ma_parent_resolved_v1","title":"MA contract enrollment by month with the canonical parent as of that month (the parent series spine)","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per contract_id x report_month, 203,755 rows = 203,755 keys, 2006-08 to 2026-09 (measured 2026-09-30, Athena d09a09de); every row of medicare_silver.monthly_contract_enrollment_summary with a parent string, none dropped, none unresolved.","description":"medicare_silver.monthly_contract_enrollment_summary joined to dim_parent_alias_v1 on the raw string and the month: parent_of_record (CMS's name that month), canonical_parent_id, canonical_parent_name, applied_event_id (the acquisition that opened the current segment, if any), alias_event_type, method_tier, confidence, plus the contract's organization, plan_type and the enrollment counts (enrollment_count, ma_only_count, part_d_count). Proved 2026-09-30: Aetna Inc. resolves to cvs_health_corporation for all 5,156 of its contract-months 2006-08 to 2018-12 and the CVS Health series is continuous across the 2019-01 string flip (10.21M -> 8.27M, the WellCare PDP divestiture, not a gap); The Cigna Group is its own canonical through 2025-02 and its 17 contracts are HCSC's from 2025-03 (HCSC 485,178 -> 4,211,247 members). Read by the certified measure pct_enrollment_4plus_stars_by_canonical_parent.","identity_key":"contract_id,report_month","row_count":203755,"last_updated":"2026-09-30","freshness_sla":"Live over the monthly enrollment table; a new parent string resolves once the dim is rebuilt.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["report_month is the enrollment table's monthly date; the view is live over it and has its freshness."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ma_parent_resolved_v1","commercial_terms":"Vlada-derived from public CMS data and cited public corporate records.","provenance_chain_ref":"Glue view created by tools/ma_brain/parent_lineage_publish.py over medicare_silver.monthly_contract_enrollment_summary x medicare_semantic.dim_parent_alias_v1","known_gaps":["TRAP: parent_of_record is the name CMS gave the contract that month and is right per year, wrong as a series; group a series on canonical_parent_id. For a single year's ranking on CMS's own label, group on parent_of_record.","REQUIRED PREDICATES for a total: pin report_month (never sum across months) and filter plan_type for MA versus PDP exactly as on the enrollment card (this table also carries standalone PDP, employer PDP, PACE, Cost, HCPP rows). enrollment_count NULL is a suppressed cell (under 11), never zero.","Acquisition semantics by month: an acquired book is its own canonical through the month before the close month and the acquirer's from the close month; Aetna is CVS Health for every month by decision. WellCare joins Centene from 2020-01; before that WellCare is its own carrier. An uncurated hand-off leaves the raw string as its own canonical (the residual list on the dim card).","Spike detector (parent_lineage_publish.py --spikes, 2026-09-30): 65 canonical parents fell 90% or more month over month; 1 explained by a curated event, 13 rebound next month (data-correction candidates), 36 go to zero (exits), 15 undocumented candidates led by Group 1001 2025-01 (342,146 -> 9,162) and Rite Aid 2024-01 (284,317 -> 19,687), both PDP exits with no curated event yet."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_vlada_ma","dataset_assignment_basis":"source_id_prefix","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["report_month"],"backing_store":"glue"},{"source_id":"cms_lis_enrollment_by_plan","source_fqn":"medicare_silver.lis_enrollment_plan","title":"LIS Enrollment by Plan, 2006-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (plan_year, part_d_stream, contract_id, plan_id): one annual snapshot per plan.","description":"CMS's Low-Income-Subsidy enrollment per Part D plan (contract x PBP) per plan year, with the plan's total enrollment from 2011: the plan's LIS / dual mix. 2026: 5,172 MA-PD plans with 9,424,913 LIS enrollees and 472 PDPs with 4,325,701.","identity_key":"plan_year,part_d_stream,contract_id,plan_id","row_count":102495,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.lis_enrollment_plan","notes":"Register source cms_lis_enrollment_by_plan (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 102,495 rows = the publisher files, 0 duplicate keys, 0 lineage nulls; Athena 53d7d672, 30b13c9d, d5353186). Cell reconciliation PASS on 11 editions incl. 2006 and 2026 (docs/data-tracker/CELL-RECONCILIATION-2026-09-30.md). Registered by the Data Tracker registration lane 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_lis_enrollment_by_plan","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":["plan_year"],"unmapped_key_tokens":["part_d_stream"],"backing_store":"glue"},{"source_id":"cms_lis_contract_enrollment_by_county","source_fqn":"medicare_silver.lis_contract_county","title":"LIS Contract Enrollment by County, 2009-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (plan_year, part_d_stream, contract_id, state_fips, county_fips).","description":"The Low-Income-Subsidy enrollees of every Part D contract in every county, MA-PD and PDP separately, one snapshot per plan year: where the dual / LIS members sit by carrier and county. 2026: 96,628 MA-PD and 24,833 PDP contract-county rows.","identity_key":"plan_year,part_d_stream,contract_id,state_fips,county_fips","row_count":1927349,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.lis_contract_county","notes":"Register source cms_lis_contract_enrollment_by_county (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 1,927,349 rows, 0 duplicate keys, 0 lineage nulls; Athena 02a29f40, 186c89aa, c7573024). Cell reconciliation PASS on 9 editions incl. 2009 and 2026. Registered by the Data Tracker registration lane 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_lis_contract_enrollment_by_county","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["census:county_fips","cms:contract_id"],"entity_key_columns":{"census:county_fips":["county_fips"],"cms:contract_id":["contract_id"]},"technical_keys":["plan_year"],"unmapped_key_tokens":["part_d_stream","state_fips"],"backing_store":"glue"},{"source_id":"cms_pdp_state_county_penetration","source_fqn":"medicare_silver.pdp_state_county_penetration","title":"PDP State/County Penetration, 2008-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (fipsst, fipscnty, report_month).","description":"For every county and month: Medicare eligibles, stand-alone PDP enrollment and PDP penetration, the PDP twin of MA State/County Penetration (same columns, identical eligibles). 2026-09: 3,188 rows, 69,511,516 eligibles, 25,021,800 PDP enrollees.","identity_key":"fipsst,fipscnty,report_month","row_count":712768,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pdp_state_county_penetration","notes":"Register source cms_pdp_state_county_penetration (w3, serve raw). RAW; same shape as the MA twin already served. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 712,768 rows, 221 months, 0 duplicate keys, eligibles and enrolled sums equal the publisher every month; Athena 1ce22253, 90ef644a, 879d43c0). Cell reconciliation PASS 2008-05, 2017-01, 2019-10, 2026-09. Unlike the MA twin (defect MASCP-1), codes are zero-padded in every month. Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_pdp_state_county_penetration","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["fipscnty","fipsst","report_month"],"backing_store":"glue"},{"source_id":"cms_pdp_contract_service_area","source_fqn":"medicare_silver.pdp_contract_service_area","title":"PDP Contract Service Area by State/County, 2007-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, county_fips, county_ssa, county_name_raw, state_code, report_month).","description":"Every county each stand-alone PDP (S) and employer direct PDP (E) contract is approved to serve, monthly since 2007-01, with the employer-group-only and partial-county flags. 2026-09: 151,719 rows, 48 contracts, eghp TRUE on 134,095.","identity_key":"contract_id,county_fips,county_ssa,county_name_raw,state_code,report_month","row_count":47691967,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pdp_contract_service_area","notes":"Register source cms_pdp_contract_service_area (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 47,691,967 rows, 234 months, 0 duplicate keys, 0 lineage nulls; Athena 91e03c49, 0599e4b1, 2fad6b1f). Cell reconciliation PASS 2007-01, 2025-01 (CT regions), 2026-09. Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_pdp_contract_service_area","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["census:county_fips","cms:contract_id","ssa:county","usps:state"],"entity_key_columns":{"census:county_fips":["county_fips"],"cms:contract_id":["contract_id"],"ssa:county":["county_ssa"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["county_name_raw","report_month"],"backing_store":"glue"},{"source_id":"cms_state_service_area","source_fqn":"medicare_silver.state_service_area","title":"State Service Area (every contract by state), 2006-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, state_code, report_month).","description":"Every MA, PDP, cost, PACE and demonstration contract with each state it is approved in, its effective date and the entire-state flag, monthly since 2006-08. 2026-09: 9,856 rows, 976 contracts.","identity_key":"contract_id,state_code,report_month","row_count":2311995,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_service_area","notes":"Register source cms_state_service_area (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 2,311,995 rows, 241 months, 0 duplicate keys, 0 lineage nulls; Athena e84c7826, 13371e3f, 6ab2a61f). Cell reconciliation PASS 2006-08, 2009-07, 2019-02, 2026-09. Card written from the record by the registration lane 2026-09-30 (the record had no draft).","superseded_by":null,"tools":[],"dataset_id":"cms_state_service_area","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["report_month"],"backing_store":"glue"},{"source_id":"cms_ma_plan_directory","source_fqn":"medicare_silver.fact_plan_directory_contract","title":"MA and PDP Plan Directories (contract roster), 2007-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract per edition (an edition = one distinct data member, by SHA-256, of one directory for one report month).","description":"CMS's monthly contract roster: every MA, cost, PACE, MSA, PFFS, demo and LI NET contract (directory 'ma') and every PDP contract ('pdp'), with legal entity, parent organization, org and plan type, tax status, region, enrollment, address and directory contact. 2026-09: 923 MA and 48 PDP contracts.","identity_key":"edition,row_seq","row_count":59963,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_plan_directory_contract","notes":"Register source cms_ma_plan_directory (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 59,963 rows = 148 editions, 0 duplicate (edition, row_seq), one current edition per (directory, report_month); Athena b8dae91c, 5b483a4c, ef7be724). Cell reconciliation PASS on the oldest and newest MA and PDP editions and the 2008-09 era. The PDP directory is registered here (one table cannot have two register owners); its record cms_pdp_plan_directory points to this source. Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_plan_directory","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["edition","row_seq"],"backing_store":"glue"},{"source_id":"cms_oec_monthly_report","source_fqn":"medicare_silver.fact_oec_monthly_enrollment","title":"Medicare Plan Finder Online Enrollment Center requests, monthly, 2014-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (edition, data_month); is_current marks each data month's newest edition.","description":"National monthly count of enrollment requests completed through the Medicare Plan Finder Online Enrollment Center: total, PDP and MA, since 2014-12. 2026-08: 120,591 requests (24,424 MA, 96,167 PDP); 2025 total 3,298,042 (789,036 MA).","identity_key":"edition,data_month","row_count":205,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_oec_monthly_enrollment","notes":"Register source cms_oec_monthly_report (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 205 rows, 141 current data months, total = PDP + MA on every row, 2026 total = the file's YTD; Athena 256dd552, 710ec76a, 1d0d544e). Cell reconciliation PASS on both eras (every row compared). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_oec_monthly_report","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["data_month","edition"],"backing_store":"glue"},{"source_id":"cms_ma_part_d_corrective_action_plans","source_fqn":"medicare_silver.fact_ma_part_d_corrective_action_plan","title":"MA and Part D Ad-Hoc Corrective Action Plans, 2014-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract per compliance issue per edition; is_current marks each issue's newest edition.","description":"Every Ad-Hoc CAP CMS issued to an MA or Part D sponsor, one row per contract named, per monthly edition: compliance issue id, letter date, issue type, topic, summary, parent and contact. 1,408 CAPs; since 2025, 94 Drug Benefit, 84 Health Benefit, 9 both.","identity_key":"edition,row_seq","row_count":67206,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ma_part_d_corrective_action_plan","notes":"Register source cms_ma_part_d_corrective_action_plans (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 67,206 rows, 69 editions, 1,408 distinct issues, each issue exactly one current edition; Athena 0f513c71, c64ccb61, b8b5c2ba). Cell reconciliation PASS on the oldest, newest and both HTML eras. Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_part_d_corrective_action_plans","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["edition","row_seq"],"backing_store":"glue"},{"source_id":"cms_ma_claims_processing_contacts","source_fqn":"medicare_silver.fact_ma_claims_processing_contact","title":"MA Claims Processing Contacts, 2011-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract per edition.","description":"For every MA, cost, PACE and demo contract, the claims-processing contact CMS publishes (title, name, phone, fax, email, address, last update) with the contract's names, parent and types. 2026-09: 923 contracts.","identity_key":"edition,row_seq","row_count":50450,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ma_claims_processing_contact","notes":"Register source cms_ma_claims_processing_contacts (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 50,450 rows, 69 editions, 0 duplicate (edition, row_seq); Athena 765f37de, 3317dfcf, 5f024593). Cell reconciliation PASS on the oldest and newest editions (every row compared). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_claims_processing_contacts","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["edition","row_seq"],"backing_store":"glue"},{"source_id":"cms_snp_hedis_general","source_fqn":"medicare_silver.snp_hedis_general","title":"SNP HEDIS general file (plan x report year), 2019-2025","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, report_year).","description":"One row per SNP plan (contract x PBP) per report year: organization and plan type, SNP type, plan and contract enrollment, region, patient population, Part D and EGWP flags. 2025: 1,054 plans (708 Dual-Eligible, 228 Chronic, 118 Institutional) with 6,215,762 members.","identity_key":"contract_id,plan_id,report_year","row_count":4936,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.snp_hedis_general","known_gaps":["snp_plan_grain_never_add_to_contract: Rows are per PBP (contract x plan_id), SNP plans only. Never treat a row as the contract's rate, never add SNP rows to medicare_silver.hedis_measures_v2 contract rows, and never expect them to reconcile: summed SNP plan denominators equal the contract denominator on only 1,478 of 7,516 2025 keys (19.7%; 3,939 smaller, 2,039 larger; Athena 00609dc7).","snp_measurement_year: report_year is the PUF year; the HEDIS measurement year is report_year - 1. Join medicare_silver.snp_data (the SNP comprehensive report) in the measurement year: (contract, plan) matches 94.6% in 2025.","snp_only_contracts: Some SNP-reporting contracts have no MA HEDIS contract row (36 in 2025, e.g. H1277, H1526; Athena 8ade0aef): a contract-level HEDIS rate is not available for every SNP plan.","snp_national_rates_not_served: The SNP national-rates sheet (medicare_silver.snp_hedis_national_rates) is loaded but not served: its eligible_population holds NR-0070 (enrollees of the reporting PBPs) and measure_name holds NR-0030 (the indicator name). It waits for a documented-name view.","2020 was not published (CMS COVID skip).","2008-2018 are on the page but not loaded (legacy field codes; gated in the record).","medicare_silver.snp_hedis_national_rates is not served (defects SNPH-1 / SNPH-2)."],"notes":"Register source cms_snp_hedis_puf (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30 for all four tables: general 4,936, service area 124,273, measures 211,299, RAU 52,668 rows; 0 duplicate keys; Athena d363fb91, fcad559b, 4404b749, 0a8f9699). Cell reconciliation PASS on 2019, 2021, 2024 and 2025 including the documentation-code check (every General-00xx code read against that year's PUF documentation). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_snp_hedis_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":["report_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_snp_hedis_service_area","source_fqn":"medicare_silver.snp_hedis_service_area","title":"SNP HEDIS service area (plan x county), 2019-2025","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, ssa_code, ansi_code, report_year).","description":"The counties each SNP plan served in the HEDIS year, with SSA and ANSI (FIPS) county codes and the employer-only flag. 2025: 31,292 rows.","identity_key":"contract_id,plan_id,ssa_code,ansi_code,report_year","row_count":124273,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.snp_hedis_service_area","known_gaps":["snp_plan_grain_never_add_to_contract: Rows are per PBP (contract x plan_id), SNP plans only. Never treat a row as the contract's rate, never add SNP rows to medicare_silver.hedis_measures_v2 contract rows, and never expect them to reconcile: summed SNP plan denominators equal the contract denominator on only 1,478 of 7,516 2025 keys (19.7%; 3,939 smaller, 2,039 larger; Athena 00609dc7).","snp_measurement_year: report_year is the PUF year; the HEDIS measurement year is report_year - 1. Join medicare_silver.snp_data (the SNP comprehensive report) in the measurement year: (contract, plan) matches 94.6% in 2025.","snp_only_contracts: Some SNP-reporting contracts have no MA HEDIS contract row (36 in 2025, e.g. H1277, H1526; Athena 8ade0aef): a contract-level HEDIS rate is not available for every SNP plan.","snp_national_rates_not_served: The SNP national-rates sheet (medicare_silver.snp_hedis_national_rates) is loaded but not served: its eligible_population holds NR-0070 (enrollees of the reporting PBPs) and measure_name holds NR-0030 (the indicator name). It waits for a documented-name view.","2020 was not published (CMS COVID skip).","2008-2018 are on the page but not loaded (legacy field codes; gated in the record).","medicare_silver.snp_hedis_national_rates is not served (defects SNPH-1 / SNPH-2)."],"notes":"Register source cms_snp_hedis_puf (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30 for all four tables: general 4,936, service area 124,273, measures 211,299, RAU 52,668 rows; 0 duplicate keys; Athena d363fb91, fcad559b, 4404b749, 0a8f9699). Cell reconciliation PASS on 2019, 2021, 2024 and 2025 including the documentation-code check (every General-00xx code read against that year's PUF documentation). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_snp_hedis_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":["report_year"],"unmapped_key_tokens":["ansi_code","ssa_code"],"backing_store":"glue"},{"source_id":"cms_snp_hedis_measures","source_fqn":"medicare_silver.snp_hedis_measures","title":"SNP HEDIS measure rates (plan x indicator), 2019-2025","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, measure_code, indicator_key, report_year).","description":"The HEDIS rate per SNP plan, measure and indicator, with confidence limits and (where published) numerator, denominator and eligible population. 2025: 38,961 rows; Care for Older Adults medication review (200737_20) averages 84.23 over 676 D-SNP plans.","identity_key":"contract_id,plan_id,measure_code,indicator_key,report_year","row_count":211299,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.snp_hedis_measures","known_gaps":["snp_plan_grain_never_add_to_contract: Rows are per PBP (contract x plan_id), SNP plans only. Never treat a row as the contract's rate, never add SNP rows to medicare_silver.hedis_measures_v2 contract rows, and never expect them to reconcile: summed SNP plan denominators equal the contract denominator on only 1,478 of 7,516 2025 keys (19.7%; 3,939 smaller, 2,039 larger; Athena 00609dc7).","snp_status_not_zero: rate NULL means a publisher status in rate_raw (NA = suppressed or denominator too small, BR = biased rate, UN = unaudited in 2019), never 0. 2025: 15,552 NA and 18 BR.","snp_measurement_year: report_year is the PUF year; the HEDIS measurement year is report_year - 1. Join medicare_silver.snp_data (the SNP comprehensive report) in the measurement year: (contract, plan) matches 94.6% in 2025.","snp_only_contracts: Some SNP-reporting contracts have no MA HEDIS contract row (36 in 2025, e.g. H1277, H1526; Athena 8ade0aef): a contract-level HEDIS rate is not available for every SNP plan.","snp_national_rates_not_served: The SNP national-rates sheet (medicare_silver.snp_hedis_national_rates) is loaded but not served: its eligible_population holds NR-0070 (enrollees of the reporting PBPs) and measure_name holds NR-0030 (the indicator name). It waits for a documented-name view.","2020 was not published (CMS COVID skip).","2008-2018 are on the page but not loaded (legacy field codes; gated in the record).","medicare_silver.snp_hedis_national_rates is not served (defects SNPH-1 / SNPH-2)."],"notes":"Register source cms_snp_hedis_puf (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30 for all four tables: general 4,936, service area 124,273, measures 211,299, RAU 52,668 rows; 0 duplicate keys; Athena d363fb91, fcad559b, 4404b749, 0a8f9699). Cell reconciliation PASS on 2019, 2021, 2024 and 2025 including the documentation-code check (every General-00xx code read against that year's PUF documentation). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_snp_hedis_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":["report_year"],"unmapped_key_tokens":["indicator_key","measure_code"],"backing_store":"glue"},{"source_id":"cms_snp_hedis_rau_measures","source_fqn":"medicare_silver.snp_hedis_rau_measures","title":"SNP HEDIS risk-adjusted utilization (plan x indicator), 2021-2025","domain":"medicare","stage":"silver","status":"live","grain":"One row per (contract_id, plan_id, measure_code, indicator_key, report_year).","description":"Risk-adjusted utilization measures per SNP plan (e.g. plan all-cause readmissions): denominator, member and outlier counts, observed and expected counts and the variance, 2021 onward. 2025: 12,636 rows.","identity_key":"contract_id,plan_id,measure_code,indicator_key,report_year","row_count":52668,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.snp_hedis_rau_measures","known_gaps":["snp_plan_grain_never_add_to_contract: Rows are per PBP (contract x plan_id), SNP plans only. Never treat a row as the contract's rate, never add SNP rows to medicare_silver.hedis_measures_v2 contract rows, and never expect them to reconcile: summed SNP plan denominators equal the contract denominator on only 1,478 of 7,516 2025 keys (19.7%; 3,939 smaller, 2,039 larger; Athena 00609dc7).","snp_measurement_year: report_year is the PUF year; the HEDIS measurement year is report_year - 1. Join medicare_silver.snp_data (the SNP comprehensive report) in the measurement year: (contract, plan) matches 94.6% in 2025.","snp_only_contracts: Some SNP-reporting contracts have no MA HEDIS contract row (36 in 2025, e.g. H1277, H1526; Athena 8ade0aef): a contract-level HEDIS rate is not available for every SNP plan.","snp_national_rates_not_served: The SNP national-rates sheet (medicare_silver.snp_hedis_national_rates) is loaded but not served: its eligible_population holds NR-0070 (enrollees of the reporting PBPs) and measure_name holds NR-0030 (the indicator name). It waits for a documented-name view.","2020 was not published (CMS COVID skip).","2008-2018 are on the page but not loaded (legacy field codes; gated in the record).","medicare_silver.snp_hedis_national_rates is not served (defects SNPH-1 / SNPH-2)."],"notes":"Register source cms_snp_hedis_puf (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30 for all four tables: general 4,936, service area 124,273, measures 211,299, RAU 52,668 rows; 0 duplicate keys; Athena d363fb91, fcad559b, 4404b749, 0a8f9699). Cell reconciliation PASS on 2019, 2021, 2024 and 2025 including the documentation-code check (every General-00xx code read against that year's PUF documentation). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_snp_hedis_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":["report_year"],"unmapped_key_tokens":["indicator_key","measure_code"],"backing_store":"glue"},{"source_id":"cms_hos_puf","source_fqn":"medicare_semantic.vw_hos_puf_respondent_v2","title":"Medicare HOS public use files, respondent level (documented names), cohorts 18-27","domain":"medicare","stage":"semantic_view","status":"live","grain":"One row per (puf_file, case_id): one anonymised respondent in one cohort file.","description":"Anonymised Medicare Advantage HOS respondents per cohort file with the publisher's item codes: VR-12 health status, ADLs, chronic conditions, pain, depression, incontinence, activity, falls, sleep, survey mode and disposition, demographics (age_group, race, sex, education) and the CMS plan region. c27b: 341,557 respondents.","identity_key":"puf_file,case_id","row_count":2712105,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hos_puf_respondent_v2","notes":"Register source cms_hos_puf (w3, serve raw). RAW, through the documented-name view medicare_semantic.vw_hos_puf_respondent_v2 (created 2026-09-30, Athena 0b537b3d; view rows = table rows = 2,712,105, age_group EXCEPT age = 0; pipelines/medicare/semantic/hos_puf_respondent_v2.sql). The physical medicare_silver.hos_puf_respondent is unchanged and not registered. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 0 duplicate (puf_file, case_id); Athena d80723fd, 9d208055). Cell reconciliation PASS on c18a, c22a, c26b, c27b (168 fields each). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_hos_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["case_id","puf_file"],"backing_store":"glue"},{"source_id":"cms_ma_geographic_variation","source_fqn":"medicare_silver.fact_ma_geographic_variation","title":"Medicare Advantage Geographic Variation, national and state, 2016-2023","domain":"medicare","stage":"silver","status":"live","grain":"One row per (year, state, bene_geo_cd) per release; is_current marks the newest release.","description":"MA enrollees' demographics and service use per state and nationally per year, 2016-2023, from encounter data: users, share of enrollees (a proportion 0-1) and stays / days / events per 1,000 for 15 service types. 2023 national: 31,848,969 full-year MA enrollees, 13.29% with an inpatient stay, 205.16 stays per 1,000.","identity_key":"year,state,bene_geo_cd","row_count":432,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ma_geographic_variation","notes":"Register source cms_ma_geographic_variation (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 432 rows = 8 years x 54 geographies, 450 suppressed cells = the publisher's blanks, 0 duplicate keys; Athena 93581620, e78d361f, 3eb78e12). Cell reconciliation PASS (76 fields; every count column summed over the file). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_geographic_variation","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["bene_geo_cd","year"],"backing_store":"glue"},{"source_id":"cms_medicare_monthly_enrollment","source_fqn":"medicare_silver.fact_medicare_monthly_enrollment","title":"Medicare Monthly Enrollment (national, state, county), 2013-2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (release, year, month, bene_geo_lvl, bene_state_abrvtn, bene_fips_cd).","description":"Medicare beneficiaries by county, state and nation, monthly from 2013-01 (plus person-year rows): total, Original Medicare vs MA and other plans, aged / disabled / ESRD, demographics, dual status and Part D. January 2026 national: 70,290,546 beneficiaries, 35,705,175 in MA and other plans.","identity_key":"year,month,bene_geo_lvl,bene_state_abrvtn,bene_fips_cd","row_count":583780,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_medicare_monthly_enrollment","notes":"Register source cms_medicare_monthly_enrollment (w2, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 583,780 rows, 3,604,780 suppressed cells = the publisher's '*', 0 duplicate keys, CT planning regions 2022+; Athena 78df6a64, a732994c, e59455d3). Cell reconciliation PASS (59 fields; 54 control totals over the whole file). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_medicare_monthly_enrollment","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["bene_fips_cd","bene_geo_lvl","bene_state_abrvtn","month","year"],"backing_store":"glue"},{"source_id":"cms_mssp_county_expenditure_risk","source_fqn":"medicare_silver.fact_mssp_county_expenditure_risk","title":"MSSP county expenditure and risk of assignable beneficiaries, CY2019-2025","domain":"medicare","stage":"silver","status":"live","grain":"One row per (publisher_version, state_id, county_id) per release.","description":"Per county, per SSP file: per-capita Parts A and B FFS expenditure, average CMS-HCC prospective and demographic risk score and person-years of assignable beneficiaries, by ESRD, disabled, aged/dual, aged/non-dual. The FFS cost and risk of a county: the other side of the MA benchmark.","identity_key":"publisher_version,state_id,county_id","row_count":45154,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_mssp_county_expenditure_risk","notes":"Register source cms_mssp_county_expenditure_risk (w2, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 45,154 rows over 14 versions, status matches the NULLs, suppressed / missing cells per version equal the evidence; Athena 4be554f6, 645beb45, d14c7892). Cell reconciliation PASS on the oldest and newest versions (18 fields). Registered 2026-09-30.","superseded_by":null,"tools":[],"dataset_id":"cms_mssp_county_expenditure_risk","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["county_id","publisher_version","state_id"],"backing_store":"glue"},{"source_id":"cms_quarterly_part_d_spending_by_drug","source_fqn":"medicare_silver.fact_part_d_spending_by_drug_quarterly","title":"Medicare Quarterly Part D Spending by Drug (preliminary), 2025-2026","domain":"drug","stage":"silver","status":"live","grain":"One row per (brnd_name, gnrc_name, mftr_name, period_label) per quarterly release.","description":"Preliminary Part D gross spending per drug (brand x generic x manufacturer, plus an Overall row) for the prior full year and the current year to date: beneficiaries, claims, spending and per-claim / per-beneficiary averages. 2025 (Q1-Q4): $350.87B over Overall rows; Eliquis $24.05B.","identity_key":"brnd_name,gnrc_name,mftr_name,period_label","row_count":27748,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_part_d_spending_by_drug_quarterly","notes":"Register source cms_quarterly_part_d_spending_by_drug (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 27,748 rows, 7,025 Overall rows, Overall spend by period equals the publisher; Athena 36f45f70, 5e7cb5aa, 679a2d74). Cell reconciliation PASS (row count, claims, beneficiaries and manufacturer sums over the whole file). Registered 2026-09-30 in W3 beside the annual Part D spending source.","superseded_by":null,"tools":[],"dataset_id":"cms_quarterly_part_d_spending_by_drug","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["brnd_name","gnrc_name","mftr_name","period_label"],"backing_store":"glue"},{"source_id":"cms_part_d_prescribers_by_provider","source_fqn":"medicare_silver.fact_part_d_prescriber_by_provider","title":"Medicare Part D Prescribers by Provider (NPI x year), 2013-2024","domain":"drug","stage":"silver","status":"live","grain":"One row per (publisher_version = data year, prscrbr_npi) per release.","description":"One row per Part D prescriber NPI per year, 2013-2024: identity, address, specialty, claims, fills, cost, day supply and beneficiaries, split by 65+, brand / generic, MAPD / PDP and LIS; opioid, antibiotic and antipsychotic prescribing; beneficiary demographics and risk. 2024: 1,416,883 NPIs, 1,709,828,271 claims.","identity_key":"publisher_version,prscrbr_npi","row_count":14636994,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_part_d_prescriber_by_provider","notes":"Register source cms_part_d_prescribers_by_provider (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 14,636,994 rows = the publisher API counts per year, 0 duplicate (data year, NPI), NPIs 10 digits; Athena 18df3977, 347f6ce2, 8b8911c8). Cell reconciliation PASS on 2013 and 2024 (every count column summed over the whole file). Registered 2026-09-30 in W3 beside the by-drug prescriber source.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_prescribers_by_provider","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["prscrbr_npi","publisher_version"],"backing_store":"glue"},{"source_id":"cms_part_d_opioid_prescribing_geo","source_fqn":"medicare_silver.fact_part_d_opioid_prescribing_geo","title":"Medicare Part D Opioid Prescribing Rates by Geography, 2013-2024","domain":"drug","stage":"silver","status":"live","grain":"One row per (year, prscrbr_geo_lvl, prscrbr_geo_cd, breakout_type, breakout) per release.","description":"Part D opioid and long-acting opioid prescribing per year for the nation, states, counties and ZIP codes, with rural / urban breakouts: prescribers, opioid prescribers, claims and the published rates with 1- and 5-year changes. 2024 national: 3.52 opioid claims per 100 Part D claims.","identity_key":"year,prscrbr_geo_lvl,prscrbr_geo_cd,breakout_type,breakout","row_count":359139,"last_updated":"2026-09-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_part_d_opioid_prescribing_geo","notes":"Register source cms_part_d_opioid_prescribing_geo (w3, serve raw). RAW. Loaded 2026-09-29 (verify_tracker_loads PASS 2026-09-30: 359,139 rows over 12 years, NULL counts per column equal the publisher's blank cells, county / ZIP codes 5 characters; Athena df9c94ad, a3a39a12, aed1a947). Cell reconciliation PASS (row count and prescriber sums over the whole file). Registered 2026-09-30 in W3 beside the Part D prescriber sources.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_opioid_prescribing_geo","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["breakout","breakout_type","prscrbr_geo_cd","prscrbr_geo_lvl","year"],"backing_store":"glue"},{"source_id":"cms_mssp_aco_performance","source_fqn":"medicare_silver.fact_mssp_aco_performance_cell","title":"MSSP ACO performance year financial and quality results, PY2013-PY2024","domain":"medicare","stage":"silver","status":"live","grain":"One row per ACO per published column per publisher_version (cell grain); is_current marks the served version.","description":"Every Shared Savings Program ACO's annual reconciliation as CMS published it, one row per cell: assigned beneficiaries, benchmark and actual expenditures, savings rate, earned shared savings or losses, quality score, risk scores and per-capita spending by enrollment type. PY2024: 476 ACOs, $4.12B earned shared savings, 10.3M assigned beneficiaries.","identity_key":"publisher_version,aco_id,field_name","row_count":878574,"last_updated":"2026-10-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_mssp_aco_performance_cell","notes":"Register source cms_mssp_aco_performance (w5, serve raw). RAW. Loaded 2026-09-30 (verify_tracker_loads PASS 2026-10-01: 878,574 cells over 13 versions, ACOs and suppressed cells per version equal the data-api evidence; Athena fcb18e9e, 82f9058a, 5537d492). Cell reconciliation PASS on all 13 versions (every marker class count equals the served value_status count). Registered 2026-10-01 in W5 beside the ACO participant list.","superseded_by":null,"tools":[],"dataset_id":"cms_mssp_aco_performance","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["aco_id","field_name","publisher_version"],"backing_store":"glue"},{"source_id":"cms_retiree_drug_subsidy_puf","source_fqn":"medicare_silver.fact_retiree_drug_subsidy_sponsor","title":"Medicare Part D Retiree Drug Subsidy sponsors, payment years 2006-2024","domain":"medicare","stage":"silver","status":"live","grain":"One row per plan sponsor (business name) per payment year.","description":"Every employer or union plan sponsor CMS paid the Part D Retiree Drug Subsidy, with the subsidy paid and retirees covered, per payment year 2006-2024. PY2024: 1,081 sponsors, $497.7M paid, 988,527 retirees (2006: 4,220 sponsors, $3.56B).","identity_key":"payment_year,business_name","row_count":45769,"last_updated":"2026-10-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_retiree_drug_subsidy_sponsor","notes":"Register source cms_retiree_drug_subsidy_puf (w3, serve raw). RAW. Loaded 2026-09-30 (verify_tracker_loads PASS 2026-10-01: 45,769 rows over 19 payment years, retiree totals and zero-paid rows per year equal the raw XML reader; Athena 95fdcee6, 005cb28c, 9106403c). Cell reconciliation PASS on all 19 years (sum of subsidy_paid and retiree_count per year). Registered 2026-10-01 in W3.","superseded_by":null,"tools":[],"dataset_id":"cms_retiree_drug_subsidy_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["business_name","payment_year"],"backing_store":"glue"},{"source_id":"cms_ma_part_d_warning_letters","source_fqn":"medicare_silver.fact_ma_part_d_warning_letter","title":"CMS MA and Part D warning letters, September 2024 - September 2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract per warning letter per monthly edition; is_current marks each letter's newest edition.","description":"Every warning letter CMS issued to an MA or Part D sponsor since September 2024, one row per contract named, per monthly edition: compliance issue id, date sent, issue type, topic, summary, parent and contact. 195 letters (115 Drug Benefit, 60 Health and Drug, 20 Health Benefit) to 2026-05-15.","identity_key":"edition,row_seq","row_count":3079,"last_updated":"2026-10-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_ma_part_d_warning_letter","notes":"Register source cms_ma_part_d_warning_letters (w3, serve raw). RAW. Loaded 2026-09-30 (verify_tracker_loads PASS 2026-10-01: 3,079 rows over 12 editions, 195 distinct letters, each exactly one current edition; Athena d53a23ed, b88cbd93, 06cf55e1). Cell reconciliation PASS on all 12 editions (HTML read by lxml, the 2024 CSV by csv). Registered 2026-10-01 in W3 beside the Ad-Hoc CAPs.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_part_d_warning_letters","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["edition","row_seq"],"backing_store":"glue"},{"source_id":"cms_dmepos_fee_schedule","source_fqn":"medicare_silver.fact_dmepos_fee_schedule","title":"Medicare DMEPOS fee schedule, every release October 1998 - October 2026","domain":"medicare","stage":"silver","status":"live","grain":"One row per (release_id, hcpcs, modifier_1, modifier_2, state).","description":"Medicare's DMEPOS fee schedule as CMS published it in 95 quarterly and corrective releases: per HCPCS code, modifiers and state, the non-rural fee and (2016 on) rural fee, ceiling, floor, category, jurisdiction and gap-fill indicator. October 2026 (dme26-d): CPAP E0601 rental $50.04 non-rural / $97.02 rural in NY.","identity_key":"release_id,hcpcs,modifier_1,modifier_2,state","row_count":14503024,"last_updated":"2026-10-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_dmepos_fee_schedule","notes":"Register source cms_dmepos_fee_schedule (w2, serve raw). RAW. Loaded 2026-09-30 (verify_tracker_loads PASS 2026-10-01: 14,503,024 rows over 95 releases, zero and rural fees per release equal the TXT reader, 1,060 late dme22-r keys start 2022-10-01; Athena 99c5d166, 782d81d2, 71728d80). Cell reconciliation PASS on 16 releases (every amount >= $100,000 compared). Registered 2026-10-01 in W2.","superseded_by":null,"tools":[],"dataset_id":"cms_dmepos_fee_schedule","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:hcpcs","usps:state"],"entity_key_columns":{"cms:hcpcs":["hcpcs"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["modifier_1","modifier_2","release_id"],"backing_store":"glue"},{"source_id":"drug_spuf_insulin_cost_share","source_fqn":"drug_silver.fact_part_d_insulin_cost_share","title":"Part D insulin beneficiary cost sharing (CMS SPUF member), 2023-Q4 to 2026-Q2","domain":"drug","stage":"silver","status":"live","grain":"One row per (report_quarter, contract_id, plan_id, segment_id, tier, days_supply).","description":"The quarterly SPUF's insulin beneficiary cost file: per Part D plan, tier and days-supply code, the insulin copay or coinsurance at preferred / standard retail and mail-order pharmacies, 2023-Q4 onward. 2026-Q2: 43,057 rows for 5,496 plans; the 30-day preferred-retail copay tops out at $35.","identity_key":"report_quarter,contract_id,plan_id,segment_id,tier,days_supply","row_count":441006,"last_updated":"2026-10-01","freshness_sla":"Quarterly, with the SPUF release (~6 weeks after quarter close).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the SPUF quarter.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_part_d_insulin_cost_share (filter is_current, pin report_quarter)","provenance_chain_ref":"M-2 envelope on every row (source_url + sha256_content_hash + bronze_object_key + asserted_at + parser_artifact_hash + source_id + vintage_tag).","context_doc_path":"docs/context_library/drug/part_d_monthly_formulary_and_spuf_members.md","known_gaps":["insulin_cap_per_month_supply: The insulin file's days_supply is a CODE (1 = 30 days, 2 = 90, 4 = 60), and the $35 IRA cap is per month's supply: 2026-Q2 copays reach $35 at days_supply 1, $70 at 4 and $105 at 2 (Athena 3802cf09). Never read a $105 copay as over the cap.","insulin_null_tier_is_defined_standard: tier NULL ('.' in the file) means a defined standard plan with no tiers; it is part of the key, not a missing value.","insulin_member_from_2023_q4: The insulin member starts 2023-Q4 and the indication-based coverage member 2020-Q1 (CMS added them then); earlier quarters hold none.","Quarters before 2023-Q4 have no insulin member (CMS added it with the CY2024 insulin files)."],"notes":"Register source cms_part_d_spuf (w3, serve raw). RAW. Member of the quarterly SPUF release (one release, one source; RESULT-3). Loaded on the drug fleet 2026-09-30; verify_tracker_loads PASS 2026-10-01 (spec added in the round-2 registration PR, expected rows = the independent reader's count of every bronze member); cell reconciliation PASS on every quarter. Registered 2026-10-01.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["days_supply","report_quarter","tier"],"backing_store":"glue"},{"source_id":"drug_spuf_indication_based_coverage","source_fqn":"drug_silver.fact_part_d_indication_based_coverage","title":"Part D indication-based coverage (CMS SPUF member), 2020-Q1 to 2026-Q2","domain":"drug","stage":"silver","status":"live","grain":"One row per (report_quarter, contract_id, plan_id, rxcui, disease).","description":"The quarterly SPUF's indication-based coverage member: the drugs a Part D plan covers only for listed FDA indications, with each indication, 2020-Q1 onward. 2026-Q2: 397 rows, 31 plans, 8 RxCUIs.","identity_key":"report_quarter,contract_id,plan_id,rxcui,disease","row_count":10669,"last_updated":"2026-10-01","freshness_sla":"Quarterly, with the SPUF release (~6 weeks after quarter close).","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the SPUF quarter.","freshness_threshold, expected_delta, and stale_behavior are intentionally null: not pinned in source docs."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_part_d_indication_based_coverage (filter is_current, pin report_quarter)","provenance_chain_ref":"M-2 envelope on every row (source_url + sha256_content_hash + bronze_object_key + asserted_at + parser_artifact_hash + source_id + vintage_tag).","context_doc_path":"docs/context_library/drug/part_d_monthly_formulary_and_spuf_members.md","known_gaps":["insulin_member_from_2023_q4: The insulin member starts 2023-Q4 and the indication-based coverage member 2020-Q1 (CMS added them then); earlier quarters hold none.","ibc_on_formulary_only_for_listed_indications: Indication-based coverage lists the FDA indications for which a plan covers a drug; the drug is on formulary ONLY for those (2026-Q2: 397 rows, 31 plans, 8 RxCUIs). Never read a row as general formulary coverage.","2019 quarters have no indication-based coverage member."],"notes":"Register source cms_part_d_spuf (w3, serve raw). RAW. Member of the quarterly SPUF release (one release, one source; RESULT-3). Loaded on the drug fleet 2026-09-30; verify_tracker_loads PASS 2026-10-01 (spec added in the round-2 registration PR, expected rows = the independent reader's count of every bronze member); cell reconciliation PASS on every quarter. Registered 2026-10-01.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","nlm:rxcui"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"nlm:rxcui":["rxcui"]},"technical_keys":[],"unmapped_key_tokens":["disease","report_quarter"],"backing_store":"glue"},{"source_id":"drug_spuf_initial_coverage_limit","source_fqn":"drug_silver.fact_part_d_plan_initial_coverage_limit","title":"Part D plan initial coverage limit (ICL), CMS SPUF sidecar, 2019-Q1 to 2024-Q3","domain":"drug","stage":"silver","status":"live","grain":"One row per (report_quarter, contract_id, plan_id, segment_id), the key of drug_silver.dim_part_d_plan.","description":"Each Part D plan segment's initial coverage limit (ICL, dollars): the total drug spend at which the initial coverage phase ends and the coverage gap (donut hole) begins, from the ICL field of the quarterly SPUF plan information file, which the original SPUF parser never read. A sidecar of drug_silver.dim_part_d_plan: join on (contract_id, plan_id, segment_id, report_quarter) to the parent's is_current = true rows; every sidecar row joins exactly one parent row and every parent row in 2019-Q1..2024-Q3 has one. 127,086 rows in 23 quarters; icl runs $2,750 to $11,000 (Athena 693d78a1).","identity_key":"report_quarter,contract_id,plan_id,segment_id","row_count":127086,"last_updated":"2026-10-07","freshness_sla":"Closed series. The coverage gap was abolished from contract year 2025 (Inflation Reduction Act Part D redesign), so CMS publishes no ICL from the 2024-Q4 release on; no new quarters will land.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the SPUF quarter.","Closed series (2019-Q1..2024-Q3); the coverage gap ended after CY2024."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_part_d_plan_initial_coverage_limit JOIN drug_silver.dim_part_d_plan (or vw_dim_part_d_plan_v4) USING (contract_id, plan_id, segment_id, report_quarter), parent is_current = true, pin report_quarter","provenance_chain_ref":"Parsed by pipelines/drug/ingest/spuf_coverage_gap_runner.py (#3105, PDPM-2) from the same bronze members the parent rows came from (bronze_object_key, SHA-256 checked); M-2 envelope on every row. Verification: verify_tracker_loads --lane PL --only partd_spuf PASS; reconcile_cells 0 mismatches, row count and column sums equal to the publisher (cloud run 20261007T003432Z-eb037065). Plan docs/data-tracker/RELOAD-PLAN-PARSE-LOSS-3105-2026-10-06.md section B.","context_doc_path":"docs/context_library/drug/part_d_monthly_formulary_and_spuf_members.md","known_gaps":["CY2019-CY2024 only (report quarters 2019-Q1..2024-Q3; a Q4 release carries the next contract year): the IRA Part D redesign abolished the coverage gap from CY2025, so the 2024-Q4 release on has no ICL column. The missing later quarters are correct, not a load gap.","icl is NULL on 906 rows: CMS printed '.' (SAS missing). NULL is unknown, never $0 and never the standard-benefit ICL.","One value per plan segment: the plan information file repeats a segment once per county it serves, and the runner refused any file where the repeats disagree. Never sum icl; it is a per-plan threshold.","Join to the parent's is_current = true rows and pin report_quarter; geography is not here or on the parent dim (join fact_part_d_plan_service_area)."],"notes":"Register source cms_part_d_spuf (w3, serve raw). RAW. Sidecar of drug_silver.dim_part_d_plan; the parent is unchanged. Loaded on the drug fleet 2026-10-06/07; registered 2026-10-07.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["report_quarter"],"backing_store":"glue"},{"source_id":"drug_spuf_cost_share_gap_coverage","source_fqn":"drug_silver.fact_part_d_plan_cost_share_gap_coverage","title":"Part D tier coverage in the coverage gap (GAP_COV_TIER), CMS SPUF sidecar, 2019-Q1 to 2024-Q3","domain":"drug","stage":"silver","status":"live","grain":"One row per (report_quarter, contract_id, plan_id, segment_id, coverage_level, tier, days_supply), the key of drug_silver.fact_part_d_plan_cost_share.","description":"Whether each cost-sharing tier of a Part D plan is covered in the coverage gap: gap_cov_tier 1 = fully covered, 2 = partially covered, 3 = not covered (PUFRecordLayout-2024), from the GAP_COV_TIER field of the quarterly SPUF beneficiary cost file, which the original SPUF parser never read. A sidecar of drug_silver.fact_part_d_plan_cost_share: join on (contract_id, plan_id, segment_id, coverage_level, tier, days_supply, report_quarter) to the parent's is_current = true rows (in vw_fact_part_d_plan_cost_share_v3 the days_supply column is days_supply_code). Every sidecar row joins exactly one parent row and every parent row in 2019-Q1..2024-Q3 has one. 3,933,149 rows in 23 quarters: 753,954 fully, 139,770 partially, 3,039,425 not covered, 0 NULL (Athena 0f3b8f11).","identity_key":"report_quarter,contract_id,plan_id,segment_id,coverage_level,tier,days_supply","row_count":3933149,"last_updated":"2026-10-07","freshness_sla":"Closed series. The coverage gap was abolished from contract year 2025 (Inflation Reduction Act Part D redesign), so CMS publishes no GAP_COV_TIER from the 2024-Q4 release on; no new quarters will land.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the SPUF quarter.","Closed series (2019-Q1..2024-Q3); the coverage gap ended after CY2024."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_part_d_plan_cost_share_gap_coverage JOIN drug_silver.vw_fact_part_d_plan_cost_share_v3 on the seven key columns (days_supply = days_supply_code), parent is_current = true, pin report_quarter","provenance_chain_ref":"Parsed by pipelines/drug/ingest/spuf_coverage_gap_runner.py (#3105, PDPM-2) from the same bronze members the parent rows came from (bronze_object_key, SHA-256 checked); M-2 envelope on every row. Verification: verify_tracker_loads --lane PL --only partd_spuf PASS; reconcile_cells 0 mismatches, row count and column sums equal to the publisher (cloud run 20261007T003432Z-eb037065). Plan docs/data-tracker/RELOAD-PLAN-PARSE-LOSS-3105-2026-10-06.md section B.","context_doc_path":"docs/context_library/drug/part_d_monthly_formulary_and_spuf_members.md","known_gaps":["CY2019-CY2024 only (report quarters 2019-Q1..2024-Q3; a Q4 release carries the next contract year): the IRA Part D redesign abolished the coverage gap from CY2025, so the 2024-Q4 release on has no GAP_COV_TIER column. The missing later quarters are correct, not a load gap.","Tier grain, not drug grain: the value is the plan's gap coverage for a whole cost-sharing tier, repeated on every coverage_level and days_supply row of that tier. Count tiers with COUNT(DISTINCT contract_id, plan_id, segment_id, tier) per quarter, never COUNT(*); whether one drug is covered in the gap comes from joining its formulary tier (fact_drug_formulary.tier_level_value), and for excluded drugs from drug_silver.fact_drug_formulary_excluded_gap_coverage.","gap_cov_tier is a code (1 fully, 2 partially, 3 not covered), never a count or a dollar amount; never average it.","days_supply is CMS's code (1 = 30 days, 2 = 90, 4 = 60), as on the parent table; it equals days_supply_code in vw_fact_part_d_plan_cost_share_v3.","Join to the parent's is_current = true rows and pin report_quarter; never sum or count sidecar rows on their own as plan counts."],"notes":"Register source cms_part_d_spuf (w3, serve raw). RAW. Sidecar of drug_silver.fact_part_d_plan_cost_share; the parent is unchanged. Loaded on the drug fleet 2026-10-06/07; registered 2026-10-07.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["coverage_level","days_supply","report_quarter","tier"],"backing_store":"glue"},{"source_id":"drug_spuf_excluded_gap_coverage","source_fqn":"drug_silver.fact_drug_formulary_excluded_gap_coverage","title":"Part D excluded-drug coverage in the coverage gap (GAP_COV), CMS SPUF sidecar, 2019-Q1 to 2024-Q3","domain":"drug","stage":"silver","status":"live","grain":"One row per (report_quarter, contract_id, plan_id, drug_identifier, drug_identifier_type), the key of drug_silver.fact_drug_formulary_excluded.","description":"Whether a plan covers each drug on its excluded-drug list (the supplemental coverage of drugs excluded from the basic Part D benefit) in the coverage gap: gap_cov true = Y, false = N, from the GAP_COV field of the quarterly SPUF excluded drugs file, which the original SPUF parser never read. A sidecar of drug_silver.fact_drug_formulary_excluded: join on (contract_id, plan_id, drug_identifier, drug_identifier_type, report_quarter) to the parent's is_current = true rows; every sidecar row joins exactly one parent row and every parent row in 2019-Q1..2024-Q3 has one. 268,567 rows in 23 quarters: 189,204 covered, 79,363 not, 0 NULL; 19,537 NDC-keyed and 249,030 RxCUI-keyed rows (Athena d3768534).","identity_key":"report_quarter,contract_id,plan_id,drug_identifier,drug_identifier_type","row_count":268567,"last_updated":"2026-10-07","freshness_sla":"Closed series. The coverage gap was abolished from contract year 2025 (Inflation Reduction Act Part D redesign), so CMS publishes no GAP_COV from the 2024-Q4 release on; no new quarters will land.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_quarter' is the SPUF quarter.","Closed series (2019-Q1..2024-Q3); the coverage gap ended after CY2024."]},"raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_formulary_excluded_gap_coverage JOIN drug_silver.fact_drug_formulary_excluded USING (contract_id, plan_id, drug_identifier, drug_identifier_type, report_quarter), parent is_current = true, pin report_quarter","provenance_chain_ref":"Parsed by pipelines/drug/ingest/spuf_coverage_gap_runner.py (#3105, PDPM-2) from the same bronze members the parent rows came from (bronze_object_key, SHA-256 checked); M-2 envelope on every row. Verification: verify_tracker_loads --lane PL --only partd_spuf PASS; reconcile_cells 0 mismatches, row count and column sums equal to the publisher (cloud run 20261007T003432Z-eb037065). Plan docs/data-tracker/RELOAD-PLAN-PARSE-LOSS-3105-2026-10-06.md section B.","context_doc_path":"docs/context_library/drug/part_d_monthly_formulary_and_spuf_members.md","known_gaps":["CY2019-CY2024 only (report quarters 2019-Q1..2024-Q3; a Q4 release carries the next contract year): the IRA Part D redesign abolished the coverage gap from CY2025, so the 2024-Q4 release on has no GAP_COV column. The missing later quarters are correct, not a load gap.","Excluded drugs only: GAP_COV says nothing about drugs on the plan's basic formulary; for those use the tier's gap coverage in drug_silver.fact_part_d_plan_cost_share_gap_coverage.","drug_identifier is NDC11 or RxCUI depending on the quarter's file era (19,537 NDC rows, 249,030 RxCUI rows; NDC in 2019, RxCUI from 2020-Q1, as on the parent (Athena 809be7df)); always filter drug_identifier_type before matching, and join on both columns.","Join to the parent's is_current = true rows and pin report_quarter; never sum or count sidecar rows on their own as plan counts."],"notes":"Register source cms_part_d_spuf (w3, serve raw). RAW. Sidecar of drug_silver.fact_drug_formulary_excluded; the parent is unchanged. Loaded on the drug fleet 2026-10-06/07; registered 2026-10-07.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":[],"unmapped_key_tokens":["drug_identifier","drug_identifier_type","report_quarter"],"backing_store":"glue"},{"source_id":"drug_monthly_formulary_v2","source_fqn":"drug_silver.vw_fact_drug_formulary_monthly_v2","title":"Part D formulary coverage, monthly (CMS), selected-drug flag only where CMS published it","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (release_month, formulary_id, ndc11).","description":"Every Part D formulary's covered drugs (proxy NDC, RxCUI, tier, quantity limit, prior authorization, step therapy, negotiation-selected flag) in every monthly edition 2019-01..2026-09. 2026-09: 328 formularies, 1,129,364 rows, 12,424 selected-drug rows.","identity_key":"release_month,formulary_id,ndc11","row_count":130452180,"last_updated":"2026-10-01","freshness_sla":"Monthly; a view over drug_silver.fact_drug_formulary_monthly, so a new month appears when the loader appends it.","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.vw_fact_drug_formulary_monthly_v2 (filter is_current, pin release_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW from pipelines/drug/semantic/fact_drug_formulary_monthly_v2.sql over drug_silver.fact_drug_formulary_monthly (#3064, PDPM-4); every row keeps the M-2 envelope. Rollback: DROP VIEW.","known_gaps":["current_required: Filter is_current = true.","month_required: Pin release_month; every table holds one snapshot per month (90 months).","october_is_next_year: October-December editions carry the NEXT contract year (2025-10 = CY2026, 0 exceptions over 90 months); filter contract_year, never infer it from release_month.","never_union_with_spuf: At each quarter's last month the rows equal the SPUF quarter row for row (2026-06 = 2026-Q2 in all five tables, 0 rows differ either way; Athena 3d5d3d50), but the file checksum differs at all 30 quarter ends (Athena 63bc51b4). Never UNION a *_monthly table with its SPUF table; dedupe by row content, never by sha256_content_hash.","reposted_editions_have_no_rows: 2021-07, 2022-07 and 2025-05 equal the prior month: CMS re-posted 2021-06, 2022-06 and 2025-04 unchanged (same edition hash), so those release_months hold no rows. Read the prior month; a missing month is not a coverage gap.","selected_drug_flag_only_from_2025_10: SELECTED_DRUG_YN first appears in the 2025-10 edition; vw_fact_drug_formulary_monthly_v2 serves NULL before it (116,981,270 rows), never FALSE. Never count a NULL as 'not a negotiation drug'.","tier_level_value is a coverage tier, not dollars; ~29% of SPUF NDCs do not resolve to dim_drug (legacy NDCs)."],"notes":"Register source cms_monthly_pdp_formulary_pharmacy_network (w3, serve raw). RAW. Loaded 2026-09-30 on the drug fleet (verify_tracker_loads PASS 2026-10-01 on all five tables: rows per month equal the independent reader's count of every bronze member, 0 duplicate keys, 0 null lineage; Athena 20aeca6c, 20b9bd5a, 8d309e07, 8d22a4d9, 88f1284b; PDPM-1 / PDPM-4 view sentinels PASS). Cell reconciliation PASS on 5 editions per table, except vw_dim_part_d_plan_monthly_v3 plan_name (PDPM-5, a documented trap). Registered 2026-10-01 in W3; the quarterly SPUF and its readers are untouched.","superseded_by":null,"tools":[],"dataset_id":"cms_monthly_pdp_formulary_pharmacy_network","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["fda:ndc"],"entity_key_columns":{"fda:ndc":["ndc11"]},"technical_keys":[],"unmapped_key_tokens":["formulary_id","release_month"],"backing_store":"glue"},{"source_id":"drug_monthly_plan_dim_v3","source_fqn":"drug_silver.vw_dim_part_d_plan_monthly_v3","title":"Part D plan dimension, monthly (CMS), plan type from CMS's organization type","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (release_month, contract_id, plan_id, segment_id).","description":"Every MA-PD and PDP plan segment in every monthly edition 2019-01..2026-09: names, formulary, premium, deductible, region codes, SNP type, and plan_type from CMS's organization type. 2026-09: 5,518 segments (5,141 MA-PD, 10 COST, 367 PDP).","identity_key":"release_month,contract_id,plan_id,segment_id","row_count":499050,"last_updated":"2026-10-01","freshness_sla":"Monthly; a view over drug_silver.dim_part_d_plan_monthly and a contract-level organization type, so a new month appears when the loader appends it.","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.vw_dim_part_d_plan_monthly_v3 (filter is_current, pin release_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW from pipelines/drug/semantic/dim_part_d_plan_monthly_v3.sql over drug_silver.dim_part_d_plan_monthly LEFT JOIN a contract-level organization type from medicare_silver.enrollment_monthly_plan (#3064, PDPM-1 rev 3); every row keeps the M-2 envelope.","known_gaps":["current_required: Filter is_current = true.","month_required: Pin release_month; every table holds one snapshot per month (90 months).","october_is_next_year: October-December editions carry the NEXT contract year (2025-10 = CY2026, 0 exceptions over 90 months); filter contract_year, never infer it from release_month.","never_union_with_spuf: At each quarter's last month the rows equal the SPUF quarter row for row (2026-06 = 2026-Q2 in all five tables, 0 rows differ either way; Athena 3d5d3d50), but the file checksum differs at all 30 quarter ends (Athena 63bc51b4). Never UNION a *_monthly table with its SPUF table; dedupe by row content, never by sha256_content_hash.","reposted_editions_have_no_rows: 2021-07, 2022-07 and 2025-05 equal the prior month: CMS re-posted 2021-06, 2022-06 and 2025-04 unchanged (same edition hash), so those release_months hold no rows. Read the prior month; a missing month is not a coverage gap.","plan_type_from_cms_organization_type: plan_type comes from CMS's organization type for the contract (2026-09: 5,141 MA-PD, 10 COST, 367 PDP); the contract-id prefix is not a plan type (H contracts also hold 1876 Cost and Medicare-Medicaid demo plans). plan_type_legacy is the broken legacy value, kept for audit.","plan_name_replacement_character: PDPM-5: 364 current rows (Puerto Rico plan names written by CMS in Windows-1252, e.g. 'Optimo', 'Maximo') carry U+FFFD in place of the accented letter in every month 2019-01..2026-09, including 36 in 2026; match plan names by contract_id + plan_id, never by name, until the correction table lands.","Geography is NOT on this dim; state/county filters join fact_part_d_plan_service_area_monthly."],"notes":"Register source cms_monthly_pdp_formulary_pharmacy_network (w3, serve raw). RAW. Loaded 2026-09-30 on the drug fleet (verify_tracker_loads PASS 2026-10-01 on all five tables: rows per month equal the independent reader's count of every bronze member, 0 duplicate keys, 0 null lineage; Athena 20aeca6c, 20b9bd5a, 8d309e07, 8d22a4d9, 88f1284b; PDPM-1 / PDPM-4 view sentinels PASS). Cell reconciliation PASS on 5 editions per table, except vw_dim_part_d_plan_monthly_v3 plan_name (PDPM-5, a documented trap). Registered 2026-10-01 in W3; the quarterly SPUF and its readers are untouched.","superseded_by":null,"tools":[],"dataset_id":"cms_monthly_pdp_formulary_pharmacy_network","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["release_month"],"backing_store":"glue"},{"source_id":"drug_monthly_plan_dim_v4","source_fqn":"drug_silver.vw_dim_part_d_plan_monthly_v4","title":"Part D plan dimension, monthly (CMS), plan type from CMS's organization type, names as CMS wrote them","domain":"drug","stage":"semantic_view","status":"live","grain":"One row per (release_month, contract_id, plan_id, segment_id).","description":"Every MA-PD and PDP plan segment in every monthly edition 2019-01..2026-09: names, formulary, premium, deductible, region codes, SNP type, and plan_type from CMS's organization type. 2026-09: 5,518 segments (5,141 MA-PD, 10 COST, 367 PDP). Plan names carry CMS's accented letters (v4).","identity_key":"release_month,contract_id,plan_id,segment_id","row_count":499050,"last_updated":"2026-10-01","freshness_sla":"Monthly; a view over drug_silver.dim_part_d_plan_monthly and a contract-level organization type, so a new month appears when the loader appends it.","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.vw_dim_part_d_plan_monthly_v4 (filter is_current, pin release_month)","provenance_chain_ref":"Glue VIRTUAL_VIEW created 2026-10-01 (Athena ae3735d4-965a-4519-9dfb-72b8ed4b25a3) from pipelines/drug/semantic/dim_part_d_plan_monthly_v4.sql over drug_silver.vw_dim_part_d_plan_monthly_v3 LEFT JOIN drug_silver.part_d_plan_name_correction_v1.","known_gaps":["PLAN NAMES: CMS writes the Puerto Rico and other accented plan names in Windows-1252; v3 serves 364 rows with U+FFFD in place of the letter ('�ptimo Plus (PPO)'). Here plan_name is re-read from each row's bronze plan-information member and decoded as cp1252 ('Óptimo Plus (PPO)'); plan_name_legacy keeps v3's value and plan_name_source says which (defect PDPM-5, drug_silver.part_d_plan_name_correction_v1).","current_required: Filter is_current = true.","month_required: Pin release_month; every table holds one snapshot per month (90 months).","october_is_next_year: October-December editions carry the NEXT contract year (2025-10 = CY2026, 0 exceptions over 90 months); filter contract_year, never infer it from release_month.","never_union_with_spuf: At each quarter's last month the rows equal the SPUF quarter row for row (2026-06 = 2026-Q2 in all five tables, 0 rows differ either way; Athena 3d5d3d50), but the file checksum differs at all 30 quarter ends (Athena 63bc51b4). Never UNION a *_monthly table with its SPUF table; dedupe by row content, never by sha256_content_hash.","reposted_editions_have_no_rows: 2021-07, 2022-07 and 2025-05 equal the prior month: CMS re-posted 2021-06, 2022-06 and 2025-04 unchanged (same edition hash), so those release_months hold no rows. Read the prior month; a missing month is not a coverage gap.","plan_type_from_cms_organization_type: plan_type comes from CMS's organization type for the contract (2026-09: 5,141 MA-PD, 10 COST, 367 PDP); the contract-id prefix is not a plan type (H contracts also hold 1876 Cost and Medicare-Medicaid demo plans). plan_type_legacy is the broken legacy value, kept for audit.","Geography is NOT on this dim; state/county filters join fact_part_d_plan_service_area_monthly."],"notes":"Versioned view (Data Tracker small-served-fixes lane, 2026-10-01, defect PDPM-5 history): v3 plus the 364 corrected plan names; v4 minus v3 rows = 0 (Athena 4d442f75). Record docs/reference/source-audit/source-mastery/records/cms_monthly_pdp_formulary.json (served_corrections).","superseded_by":null,"tools":[],"dataset_id":"cms_monthly_pdp_formulary_pharmacy_network","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["release_month"],"backing_store":"glue"},{"source_id":"drug_monthly_plan_service_area","source_fqn":"drug_silver.fact_part_d_plan_service_area_monthly","title":"Part D plan service area (geographic locator), monthly (CMS)","domain":"drug","stage":"silver","status":"live","grain":"One row per (release_month, contract_id, plan_id, segment_id, state, county_code).","description":"For every local MA-PD plan segment, the states and SSA counties it serves, in every monthly edition 2019-01..2026-09. 2026-09: 111,899 rows, 5,123 plan segments, 3,155 counties.","identity_key":"release_month,contract_id,plan_id,segment_id,state,county_code","row_count":7581448,"last_updated":"2026-10-01","freshness_sla":"Monthly, with the Monthly Formulary and Pharmacy Network release.","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_part_d_plan_service_area_monthly (filter is_current, pin release_month)","provenance_chain_ref":"M-2 envelope on every row (source_url + sha256_content_hash + bronze_object_key + asserted_at + parser_artifact_hash + source_id + vintage_tag).","known_gaps":["current_required: Filter is_current = true.","month_required: Pin release_month; every table holds one snapshot per month (90 months).","october_is_next_year: October-December editions carry the NEXT contract year (2025-10 = CY2026, 0 exceptions over 90 months); filter contract_year, never infer it from release_month.","never_union_with_spuf: At each quarter's last month the rows equal the SPUF quarter row for row (2026-06 = 2026-Q2 in all five tables, 0 rows differ either way; Athena 3d5d3d50), but the file checksum differs at all 30 quarter ends (Athena 63bc51b4). Never UNION a *_monthly table with its SPUF table; dedupe by row content, never by sha256_content_hash.","reposted_editions_have_no_rows: 2021-07, 2022-07 and 2025-05 equal the prior month: CMS re-posted 2021-06, 2022-06 and 2025-04 unchanged (same edition hash), so those release_months hold no rows. Read the prior month; a missing month is not a coverage gap.","county_code_is_ssa: county_code on the service-area table is the 5-character SSA state+county code (H contracts only), not FIPS.","Regional MA and PDP plans name no county here (their regions are on the plan dim)."],"notes":"Register source cms_monthly_pdp_formulary_pharmacy_network (w3, serve raw). RAW. Loaded 2026-09-30 on the drug fleet (verify_tracker_loads PASS 2026-10-01 on all five tables: rows per month equal the independent reader's count of every bronze member, 0 duplicate keys, 0 null lineage; Athena 20aeca6c, 20b9bd5a, 8d309e07, 8d22a4d9, 88f1284b; PDPM-1 / PDPM-4 view sentinels PASS). Cell reconciliation PASS on 5 editions per table, except vw_dim_part_d_plan_monthly_v3 plan_name (PDPM-5, a documented trap). Registered 2026-10-01 in W3; the quarterly SPUF and its readers are untouched.","superseded_by":null,"tools":[],"dataset_id":"cms_monthly_pdp_formulary_pharmacy_network","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["county_code","release_month"],"backing_store":"glue"},{"source_id":"drug_monthly_plan_cost_share","source_fqn":"drug_silver.fact_part_d_plan_cost_share_monthly","title":"Part D plan beneficiary cost sharing, monthly (CMS)","domain":"drug","stage":"silver","status":"live","grain":"One row per (release_month, contract_id, plan_id, segment_id, coverage_level, tier, days_supply).","description":"Per Part D plan, coverage level, tier and days-supply code: the copay or coinsurance at preferred / standard retail and mail-order pharmacies, specialty-tier and deductible flags, every monthly edition 2019-01..2026-09. 2026-09: 172,549 rows.","identity_key":"release_month,contract_id,plan_id,segment_id,coverage_level,tier,days_supply","row_count":15305647,"last_updated":"2026-10-01","freshness_sla":"Monthly, with the Monthly Formulary and Pharmacy Network release.","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_part_d_plan_cost_share_monthly (filter is_current, pin release_month)","provenance_chain_ref":"M-2 envelope on every row (source_url + sha256_content_hash + bronze_object_key + asserted_at + parser_artifact_hash + source_id + vintage_tag).","known_gaps":["current_required: Filter is_current = true.","month_required: Pin release_month; every table holds one snapshot per month (90 months).","october_is_next_year: October-December editions carry the NEXT contract year (2025-10 = CY2026, 0 exceptions over 90 months); filter contract_year, never infer it from release_month.","never_union_with_spuf: At each quarter's last month the rows equal the SPUF quarter row for row (2026-06 = 2026-Q2 in all five tables, 0 rows differ either way; Athena 3d5d3d50), but the file checksum differs at all 30 quarter ends (Athena 63bc51b4). Never UNION a *_monthly table with its SPUF table; dedupe by row content, never by sha256_content_hash.","reposted_editions_have_no_rows: 2021-07, 2022-07 and 2025-05 equal the prior month: CMS re-posted 2021-06, 2022-06 and 2025-04 unchanged (same edition hash), so those release_months hold no rows. Read the prior month; a missing month is not a coverage gap.","cost_type says whether cost_amt is a copay (dollars) or a coinsurance (fraction); never compare them raw.","CY2026 IRA redesign changes coverage levels; do not aggregate across the 2025/2026 boundary (methodology_era)."],"notes":"Register source cms_monthly_pdp_formulary_pharmacy_network (w3, serve raw). RAW. Loaded 2026-09-30 on the drug fleet (verify_tracker_loads PASS 2026-10-01 on all five tables: rows per month equal the independent reader's count of every bronze member, 0 duplicate keys, 0 null lineage; Athena 20aeca6c, 20b9bd5a, 8d309e07, 8d22a4d9, 88f1284b; PDPM-1 / PDPM-4 view sentinels PASS). Cell reconciliation PASS on 5 editions per table, except vw_dim_part_d_plan_monthly_v3 plan_name (PDPM-5, a documented trap). Registered 2026-10-01 in W3; the quarterly SPUF and its readers are untouched.","superseded_by":null,"tools":[],"dataset_id":"cms_monthly_pdp_formulary_pharmacy_network","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["coverage_level","days_supply","release_month","tier"],"backing_store":"glue"},{"source_id":"drug_monthly_formulary_excluded","source_fqn":"drug_silver.fact_drug_formulary_excluded_monthly","title":"Part D excluded drugs covered as a supplemental benefit, monthly (CMS)","domain":"drug","stage":"silver","status":"live","grain":"One row per (release_month, contract_id, plan_id, drug_identifier).","description":"Drugs excluded from Part D that a plan covers as a supplemental benefit, with tier and utilization management, every monthly edition 2019-01..2026-09. 2026-09: 13,717 rows, 44 drugs.","identity_key":"release_month,contract_id,plan_id,drug_identifier","row_count":1103415,"last_updated":"2026-10-01","freshness_sla":"Monthly, with the Monthly Formulary and Pharmacy Network release.","raw_queryable_via":"Athena (read-only via query_substrate): drug_silver.fact_drug_formulary_excluded_monthly (filter is_current, pin release_month)","provenance_chain_ref":"M-2 envelope on every row (source_url + sha256_content_hash + bronze_object_key + asserted_at + parser_artifact_hash + source_id + vintage_tag).","known_gaps":["current_required: Filter is_current = true.","month_required: Pin release_month; every table holds one snapshot per month (90 months).","october_is_next_year: October-December editions carry the NEXT contract year (2025-10 = CY2026, 0 exceptions over 90 months); filter contract_year, never infer it from release_month.","never_union_with_spuf: At each quarter's last month the rows equal the SPUF quarter row for row (2026-06 = 2026-Q2 in all five tables, 0 rows differ either way; Athena 3d5d3d50), but the file checksum differs at all 30 quarter ends (Athena 63bc51b4). Never UNION a *_monthly table with its SPUF table; dedupe by row content, never by sha256_content_hash.","reposted_editions_have_no_rows: 2021-07, 2022-07 and 2025-05 equal the prior month: CMS re-posted 2021-06, 2022-06 and 2025-04 unchanged (same edition hash), so those release_months hold no rows. Read the prior month; a missing month is not a coverage gap.","excluded_drug_identifier: drug_identifier is an NDC in the 2019 editions (2019-01..2019-12, 58,718 rows) and an RXCUI from 2020-01 (Athena 5ee1d69c); drug_identifier_type says which. Never join across the switch without a crosswalk.","quantity_limit_yn is published 0/1 in this file (Y/N elsewhere)."],"notes":"Register source cms_monthly_pdp_formulary_pharmacy_network (w3, serve raw). RAW. Loaded 2026-09-30 on the drug fleet (verify_tracker_loads PASS 2026-10-01 on all five tables: rows per month equal the independent reader's count of every bronze member, 0 duplicate keys, 0 null lineage; Athena 20aeca6c, 20b9bd5a, 8d309e07, 8d22a4d9, 88f1284b; PDPM-1 / PDPM-4 view sentinels PASS). Cell reconciliation PASS on 5 editions per table, except vw_dim_part_d_plan_monthly_v3 plan_name (PDPM-5, a documented trap). Registered 2026-10-01 in W3; the quarterly SPUF and its readers are untouched.","superseded_by":null,"tools":[],"dataset_id":"cms_monthly_pdp_formulary_pharmacy_network","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":[],"unmapped_key_tokens":["drug_identifier","release_month"],"backing_store":"glue"},{"source_id":"dsnp_integration_status_v1","source_fqn":"medicare_silver.dsnp_integration_status_v1","title":"D-SNP integration status (FIDE / HIDE / CO / CO-P, AIP, zero-dollar cost sharing, dual categories) by plan segment and state, CY2023-2027","domain":"medicare","stage":"silver","status":"live","grain":"One row per (plan_year, contract_id, plan_id, segment_id, state_code); a multi-state plan segment has one row per state (plan_segment_state_rank = 1 for plan counts). CY2027: 1,052 plan segments.","description":"CMS integration level of every D-SNP from the MA Landscape (CY2023-2027), with the last SNP Comprehensive Report month of the year (status, AIP, partial-dual-only, enrollment), the CMS MMCO integration list (status incl. CO-P, integrated-care SEP, dual categories the plan may enroll, age and enrollment limits) and the PBP filing as cross-checks. Identifiers as CMS prints them (segment unpadded), the format of pbp_section_a and vw_benefit_vector.","identity_key":"plan_year,contract_id,plan_id,segment_id,state_code","row_count":4795,"last_updated":"2026-10-10","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dsnp_integration_status_v1","notes":"Registered 2026-10-12 under register source cms_dsnp_integration_status (W3; Ben's yes, switch-on stage 1.2). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"cms_dsnp_integration_status","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_dsnp_integration_status_list_v1","source_fqn":"medicare_silver.cms_dsnp_integration_status_list_v1","title":"CMS MMCO Integration Status for Contract Year D-SNPs, every edition CY2021-2027","domain":"medicare","stage":"silver","status":"live","grain":"One row per edition (sha256_content_hash) x contract x plan x state; is_latest_edition marks the edition used per contract year.","description":"CMS's per-plan D-SNP integration list from its review of every State Medicaid Agency Contract: FIDE / HIDE / CO / CO-P, AIP, integrated-care SEP (CY2025+), Medicaid MCO organization (CY2025), dual-eligible categories the plan may enroll, age and enrollment limits (CY2027).","identity_key":"contract_year,sha256_content_hash,contract_id,plan_id,state_code","row_count":6783,"last_updated":"2026-10-10","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_dsnp_integration_status_list_v1","notes":"Registered 2026-10-12 under register source cms_dsnp_integration_status_list (W3; Ben's yes, switch-on stage 1.2). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"cms_dsnp_integration_status_list","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["contract_year","sha256_content_hash"],"backing_store":"glue"},{"source_id":"cms_dsnp_lookalike_list_v1","source_fqn":"medicare_silver.cms_dsnp_lookalike_list_v1","title":"CMS D-SNP look-alike lists CY2022-2026 (plan-level % dual eligible)","domain":"medicare","stage":"silver","status":"live","grain":"One row per contract_year x contract x plan x segment x state.","description":"Non-SNP MA plans whose January enrollment is at least the threshold share dual eligible (80% CY2022-2024, 70% CY2025, 60% CY2026): total enrollment and % dual, the only public plan-level dual share.","identity_key":"contract_year,contract_id,plan_id,segment_id,state_code","row_count":108,"last_updated":"2026-10-10","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.cms_dsnp_lookalike_list_v1","notes":"Registered 2026-10-12 under register source cms_dsnp_lookalike_list (W3; Ben's yes, switch-on stage 1.2). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"cms_dsnp_lookalike_list","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["contract_year"],"backing_store":"glue"},{"source_id":"state_duals_kb_source_v5","source_fqn":"medicare_silver.state_duals_kb_source_v5","title":"State duals knowledge base v5: source","domain":"state","stage":"silver","status":"live","grain":"Key source_id. Spine: 15 documents and actors.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"source_id","row_count":632,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_source_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena c4d36670-4fff-4fd4-90b1-7ff81032cee1). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_source_v4","source_fqn":"medicare_silver.state_duals_kb_source_v4","title":"State duals knowledge base v4 (retired; superseded by v5): source","domain":"state","stage":"silver","status":"retired","grain":"Key source_id. Spine: 15 documents and actors.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"source_id","row_count":632,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_source_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_source_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_source_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_source_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_rule_v5","source_fqn":"medicare_silver.state_duals_kb_rule_v5","title":"State duals knowledge base v5: rule","domain":"state","stage":"silver","status":"live","grain":"Key rule_id. Spine: 12 policy and authority (rule); 9 coverage / 3 population via applies_to.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"rule_id","row_count":1582,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_rule_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 9a296732-e9f1-4e2a-af62-61f3ea66e391). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rule_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_rule_v4","source_fqn":"medicare_silver.state_duals_kb_rule_v4","title":"State duals knowledge base v4 (retired; superseded by v5): rule","domain":"state","stage":"silver","status":"retired","grain":"Key rule_id. Spine: 12 policy and authority (rule); 9 coverage / 3 population via applies_to.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"rule_id","row_count":1582,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_rule_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_rule_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_rule_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_rule_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rule_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_state_program_v5","source_fqn":"medicare_silver.state_duals_kb_state_program_v5","title":"State duals knowledge base v5: state program","domain":"state","stage":"silver","status":"live","grain":"Key program_id. Spine: 2 program (+ 12 authority, 8 geography).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"program_id","row_count":270,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_state_program_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 3882e7f5-8781-4425-8152-96b1e27d989b). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["program_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_state_program_v4","source_fqn":"medicare_silver.state_duals_kb_state_program_v4","title":"State duals knowledge base v4 (retired; superseded by v5): state program","domain":"state","stage":"silver","status":"retired","grain":"Key program_id. Spine: 2 program (+ 12 authority, 8 geography).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"program_id","row_count":270,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_state_program_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_state_program_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_state_program_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_state_program_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["program_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_benefit_coverage_v5","source_fqn":"medicare_silver.state_duals_kb_benefit_coverage_v5","title":"State duals knowledge base v5: benefit coverage","domain":"state","stage":"silver","status":"live","grain":"Key coverage_id. Spine: 9 coverage x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"coverage_id","row_count":819,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_benefit_coverage_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena b9628309-5da7-460a-92b3-c73a1aeadf22). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["coverage_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_benefit_coverage_v4","source_fqn":"medicare_silver.state_duals_kb_benefit_coverage_v4","title":"State duals knowledge base v4 (retired; superseded by v5): benefit coverage","domain":"state","stage":"silver","status":"retired","grain":"Key coverage_id. Spine: 9 coverage x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"coverage_id","row_count":819,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_benefit_coverage_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_benefit_coverage_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_benefit_coverage_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_benefit_coverage_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["coverage_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_payer_chain_v5","source_fqn":"medicare_silver.state_duals_kb_payer_chain_v5","title":"State duals knowledge base v5: payer chain","domain":"state","stage":"silver","status":"live","grain":"Key state_code, integration_type, state_arrangement, dual_category, benefit, payer_order, effective_from. Spine: 9 coverage x 3 population x D-SNP integration (CMS 42 CFR 422.2).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"state_code,integration_type,state_arrangement,dual_category,benefit,payer_order,effective_from","row_count":2171,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_payer_chain_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena e12c61af-22b9-4e39-8cfa-7b8b328c0a9c). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["benefit","dual_category","effective_from","integration_type","payer_order","state_arrangement"],"backing_store":"glue"},{"source_id":"state_duals_kb_payer_chain_v4","source_fqn":"medicare_silver.state_duals_kb_payer_chain_v4","title":"State duals knowledge base v4 (retired; superseded by v5): payer chain","domain":"state","stage":"silver","status":"retired","grain":"Key state_code, integration_type, state_arrangement, dual_category, benefit, payer_order, effective_from. Spine: 9 coverage x 3 population x D-SNP integration (CMS 42 CFR 422.2).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"state_code,integration_type,state_arrangement,dual_category,benefit,payer_order,effective_from","row_count":2171,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_payer_chain_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_payer_chain_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_payer_chain_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_payer_chain_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["benefit","dual_category","effective_from","integration_type","payer_order","state_arrangement"],"backing_store":"glue"},{"source_id":"state_duals_kb_dsnp_requirement_v5","source_fqn":"medicare_silver.state_duals_kb_dsnp_requirement_v5","title":"State duals knowledge base v5: dsnp requirement","domain":"state","stage":"silver","status":"live","grain":"Key requirement_id. Spine: 12 policy and authority (SMAC = contract); 2 program.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"requirement_id","row_count":327,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_dsnp_requirement_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 73ca3598-ce41-4c32-964e-8bde5e48e421). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["requirement_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_dsnp_requirement_v4","source_fqn":"medicare_silver.state_duals_kb_dsnp_requirement_v4","title":"State duals knowledge base v4 (retired; superseded by v5): dsnp requirement","domain":"state","stage":"silver","status":"retired","grain":"Key requirement_id. Spine: 12 policy and authority (SMAC = contract); 2 program.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"requirement_id","row_count":327,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_dsnp_requirement_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_dsnp_requirement_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_dsnp_requirement_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_dsnp_requirement_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["requirement_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_cost_sharing_v5","source_fqn":"medicare_silver.state_duals_kb_cost_sharing_v5","title":"State duals knowledge base v5: cost sharing","domain":"state","stage":"silver","status":"live","grain":"Key cost_sharing_id. Spine: 9 coverage (cost sharing) x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"cost_sharing_id","row_count":247,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_cost_sharing_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena dc100764-d1c8-4a7f-b375-3f0406b20f21). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["cost_sharing_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_cost_sharing_v4","source_fqn":"medicare_silver.state_duals_kb_cost_sharing_v4","title":"State duals knowledge base v4 (retired; superseded by v5): cost sharing","domain":"state","stage":"silver","status":"retired","grain":"Key cost_sharing_id. Spine: 9 coverage (cost sharing) x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"cost_sharing_id","row_count":247,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_cost_sharing_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_cost_sharing_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_cost_sharing_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_cost_sharing_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["cost_sharing_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_msp_limits_v5","source_fqn":"medicare_silver.state_duals_kb_msp_limits_v5","title":"State duals knowledge base v5: msp limits","domain":"state","stage":"silver","status":"live","grain":"Key msp_limit_id. Spine: 3 population (eligibility group).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"msp_limit_id","row_count":217,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_msp_limits_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 4b7af29b-862c-48d8-a66e-35c22b6f1419). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["msp_limit_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_msp_limits_v4","source_fqn":"medicare_silver.state_duals_kb_msp_limits_v4","title":"State duals knowledge base v4 (retired; superseded by v5): msp limits","domain":"state","stage":"silver","status":"retired","grain":"Key msp_limit_id. Spine: 3 population (eligibility group).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"msp_limit_id","row_count":217,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_msp_limits_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_msp_limits_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_msp_limits_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_msp_limits_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["msp_limit_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_change_log_v5","source_fqn":"medicare_silver.state_duals_kb_change_log_v5","title":"State duals knowledge base v5: change log","domain":"state","stage":"silver","status":"live","grain":"Key change_id. Spine: 12 policy and authority (dated change).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"change_id","row_count":226,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_change_log_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 7dab4df5-d1c1-42b0-8c3d-77a06f0a9f27). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["change_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_change_log_v4","source_fqn":"medicare_silver.state_duals_kb_change_log_v4","title":"State duals knowledge base v4 (retired; superseded by v5): change log","domain":"state","stage":"silver","status":"retired","grain":"Key change_id. Spine: 12 policy and authority (dated change).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"change_id","row_count":226,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_change_log_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_change_log_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_change_log_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_change_log_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["change_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_open_question_v5","source_fqn":"medicare_silver.state_duals_kb_open_question_v5","title":"State duals knowledge base v5: open question","domain":"state","stage":"silver","status":"live","grain":"Key question_id. Spine: 14 quality and enrollment rules / availability grid (MEDICAID-SPINE section 4).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"question_id","row_count":224,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_open_question_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 60623518-b200-4f38-9113-fa093632cff2). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["question_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_open_question_v4","source_fqn":"medicare_silver.state_duals_kb_open_question_v4","title":"State duals knowledge base v4 (retired; superseded by v5): open question","domain":"state","stage":"silver","status":"retired","grain":"Key question_id. Spine: 14 quality and enrollment rules / availability grid (MEDICAID-SPINE section 4).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"question_id","row_count":227,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_open_question_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_open_question_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_open_question_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_open_question_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["question_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_plan_effective_benefit_v5","source_fqn":"medicare_silver.state_duals_kb_plan_effective_benefit_v5","title":"State duals knowledge base v5: plan effective benefit","domain":"state","stage":"silver","status":"live","grain":"Key effective_benefit_id. Spine: 9 coverage x 3 population x 1 organization (contract-plan) x D-SNP integration.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v5: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth, under neutral source and rule ids). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4 through v5/neutralise_v5.yaml; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"effective_benefit_id","row_count":540,"last_updated":"2026-10-12","freshness_sla":"Event-driven: a new or restated document becomes new rows in a new table version (_v6).","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_plan_effective_benefit_v5","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena eee11d93-fa58-49a9-b685-bdaad3351109). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["Payer chains and SMAC terms exist for NY and the researched states (waves 1-4); other jurisdictions carry the national baseline (benefit coverage, programs, MSP limits); PR and the territories have no rows.","National coverage rows describe the general adult (21-64) package, mostly FFS; state primary rows win where present.","A missing row is no KB row, never 'not covered'; read confidence before quoting (only exact rows are verbatim)."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["effective_benefit_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_plan_effective_benefit_v4","source_fqn":"medicare_silver.state_duals_kb_plan_effective_benefit_v4","title":"State duals knowledge base v4 (retired; superseded by v5): plan effective benefit","domain":"state","stage":"silver","status":"retired","grain":"Key effective_benefit_id. Spine: 9 coverage x 3 population x 1 organization (contract-plan) x D-SNP integration.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays (current version v4: v1 seeds + CA/FL/TX/PA/NJ depth + wave-3 and wave-4 demand-driven depth). Every row carries source_id, a verbatim quote + locator on exact rows, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1..v4; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"effective_benefit_id","row_count":540,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_plan_effective_benefit_v5.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_plan_effective_benefit_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_plan_effective_benefit_v5.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v4.py --execute, cloud run 20261011T143907Z-e3c75d17 (create); rerun 20261011T144043Z-e3c75d17: 12 of 12 objects unchanged (idempotent). Row counts Athena b9ba077b (0 mismatches); re-measured 2026-10-12 Athena 08f29265-7c78-4547-ad42-1f00ee3cad8c. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py; wave-4 independent audit in docs/reference/source-audit/source-mastery/state_duals_kb/AUDIT-wave4.md. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE4_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_plan_effective_benefit_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["effective_benefit_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_filing_patterns_v2","source_fqn":"medicare_silver.state_duals_kb_filing_patterns_v2","title":"State duals knowledge base: filing patterns (how a state rule shows up in CY2027 D-SNP filings)","domain":"state","stage":"silver","status":"live","grain":"Key pattern_id: state x plan_year x rule x filing field; the unit counted is a D-SNP plan segment unless match_definition says otherwise.","description":"For each deep state, how a state Medicaid / SMAC rule shows up in the CY2027 D-SNP filings: the expected pattern, the measured share of plan segments that match (n_plans, n_match, observed_share), the top-5 plans, the exceptions and their reading, with the evidence query ids. confidence grades the causal reading rule -> filing. An exception is a question for the plan or the state, never 'noncompliant'.","identity_key":"pattern_id","row_count":49,"last_updated":"2026-10-12","freshness_sla":"Re-measured when a filing year or a state rule changes; a new measurement is a new table version (_v3).","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["plan_year is the filing year measured (CY2027)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_duals_kb_filing_patterns_v2","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 97fdb89d-1b68-4fb6-856d-3d7ae30509b6). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["CY2027 filings of the 11 deep states only (49 patterns); observed_share is a measured filing share, not a compliance verdict."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["pattern_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_filing_patterns_v1","source_fqn":"medicare_silver.state_duals_kb_filing_patterns_v1","title":"State duals knowledge base: filing patterns (how a state rule shows up in CY2027 D-SNP filings) (v1, retired; superseded by v2)","domain":"state","stage":"silver","status":"retired","grain":"Key pattern_id: state x plan_year x rule x filing field; the unit counted is a D-SNP plan segment unless match_definition says otherwise.","description":"For each deep state, how a state Medicaid / SMAC rule shows up in the CY2027 D-SNP filings: the expected pattern, the measured share of plan segments that match (n_plans, n_match, observed_share), the top-5 plans, the exceptions and their reading, with the evidence query ids. confidence grades the causal reading rule -> filing. An exception is a question for the plan or the state, never 'noncompliant'.","identity_key":"pattern_id","row_count":49,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read state_duals_kb_filing_patterns_v2.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["plan_year is the filing year measured (CY2027)."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_filing_patterns_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_filing_patterns_v2.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Generated by ops/scripts/build_state_duals_filing_patterns_v1.py (seeds pipelines/medicare/data/state_duals_kb/v2/filing_patterns.<st>.csv; explainers docs/reference/source-audit/source-mastery/state_duals_kb/filing_patterns_<st>.md); loaded with KB v2 by ops/scripts/load_state_duals_kb_v2.py, cloud run 20261011T004959Z-8bf54a08, rerun unchanged. Counts measured 2026-10-10 through query_substrate (query ids in each row).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_filing_patterns_v2 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["pattern_id"],"backing_store":"glue"},{"source_id":"vw_dsnp_medicaid_wrap_v5","source_fqn":"medicare_semantic.vw_dsnp_medicaid_wrap_v5","title":"Each D-SNP plan segment x state with its integration status and the state's Medicaid wrap (dental, eyeglasses, hearing, NEMT, overriding SMAC rules)","domain":"medicare","stage":"semantic_view","status":"live","grain":"Same as medicare_silver.dsnp_integration_status_v1.","description":"Joins dsnp_integration_status_v1 to the state duals KB v5: per plan_year, state and benefit the KB row in effect that year for a full-benefit dual (latest effective_from, ties exact > rule > judged); dental, eyeglasses, hearing aids, NEMT, eye exam, personal care, adult day, home services, home modifications and MCO value-added fitness, plus the SMAC rules that override plan filings in the plan year.","identity_key":"plan_year,contract_id,plan_id,segment_id,state_code","row_count":4795,"last_updated":"2026-10-12","freshness_sla":"Follows its inputs.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the edition coordinate."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_dsnp_medicaid_wrap_v5","commercial_terms":"Public data.","provenance_chain_ref":"Built by ops/scripts/load_state_duals_kb_v5.py from seed set v4 (pipelines/medicare/data/state_duals_kb/v1..v4, unchanged) through pipelines/medicare/dsnp_wrap/neutralise.py with pipelines/medicare/data/state_duals_kb/v5/neutralise_v5.yaml (neutral source / rule / question ids; every other column identical to v4); parquet put by cloud run 20261012T234645Z-083bcb34; created through ops/scripts/apply_athena_sql.py (Athena 7d143232-c709-41c0-a549-4ad1f66c3a30). Rails 2026-10-12: row counts d5abce17, fact-column checksums vs v4 093eae1e, text rail 47dcbbc2, view identity 9f6463ef: all PASS. Record docs/operations/artifacts/state-duals-kb-v5-neutral-2026-10-12.md.","known_gaps":["The Medicaid columns describe the state's package for a FULL-benefit dual; partial duals get none of it.","A NULL Medicaid column means no KB row for that state x benefit x year, never 'not covered'.","snp_report_plan_segment_enrollment repeats on each state row of a multi-state plan segment: sum only where plan_segment_state_rank = 1.","The columns describe the state's package, not the payer: who delivers each benefit is in state_duals_kb_payer_chain_v5."],"notes":"Registered 2026-10-12 under register source state_duals_kb (W8) as the successor of the v4 object (same facts under neutral ids). Serving takes effect with the next MCP bridge release.","superseded_by":null,"tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"vw_dsnp_medicaid_wrap_v4","source_fqn":"medicare_semantic.vw_dsnp_medicaid_wrap_v4","title":"Each D-SNP plan segment x state with its integration status and the state's Medicaid wrap (dental, eyeglasses, hearing, NEMT, overriding SMAC rules) (v4, retired; superseded by v5)","domain":"medicare","stage":"semantic_view","status":"retired","grain":"Same as medicare_silver.dsnp_integration_status_v1.","description":"Joins dsnp_integration_status_v1 to the state duals KB v4: per plan_year, state and benefit the KB row in effect that year for a full-benefit dual (latest effective_from, ties exact > rule > judged); dental, eyeglasses, hearing aids, NEMT, eye exam, personal care, adult day, home services, home modifications and MCO value-added fitness, plus the SMAC rules that override plan filings in the plan year.","identity_key":"plan_year,contract_id,plan_id,segment_id,state_code","row_count":4795,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read vw_dsnp_medicaid_wrap_v5.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the edition coordinate."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_semantic.vw_dsnp_medicaid_wrap_v4 stays in Athena as history, but query_substrate treats it as retired and points to medicare_semantic.vw_dsnp_medicaid_wrap_v5.","commercial_terms":"Public data.","provenance_chain_ref":"pipelines/medicare/semantic/vw_dsnp_medicaid_wrap_v4.sql (created by the v4 load; never replaced)","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v5 is the served version."],"notes":"RETIRED 2026-10-12: superseded by the v5 object (the same facts under neutral ids; a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_semantic.vw_dsnp_medicaid_wrap_v5 (state duals KB v5, 2026-10-12: the same facts under neutral ids; the old object is kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_source_v3","source_fqn":"medicare_silver.state_duals_kb_source_v3","title":"State duals knowledge base v3 (retired; superseded by v4): source","domain":"state","stage":"silver","status":"retired","grain":"Key source_id. Spine: 15 documents and actors.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"source_id","row_count":530,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_source_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_source_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_source_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_rule_v3","source_fqn":"medicare_silver.state_duals_kb_rule_v3","title":"State duals knowledge base v3 (retired; superseded by v4): rule","domain":"state","stage":"silver","status":"retired","grain":"Key rule_id. Spine: 12 policy and authority (rule); 9 coverage / 3 population via applies_to.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"rule_id","row_count":1353,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_rule_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_rule_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_rule_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rule_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_state_program_v3","source_fqn":"medicare_silver.state_duals_kb_state_program_v3","title":"State duals knowledge base v3 (retired; superseded by v4): state program","domain":"state","stage":"silver","status":"retired","grain":"Key program_id. Spine: 2 program (+ 12 authority, 8 geography).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"program_id","row_count":259,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_state_program_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_state_program_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_state_program_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["program_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_benefit_coverage_v3","source_fqn":"medicare_silver.state_duals_kb_benefit_coverage_v3","title":"State duals knowledge base v3 (retired; superseded by v4): benefit coverage","domain":"state","stage":"silver","status":"retired","grain":"Key coverage_id. Spine: 9 coverage x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"coverage_id","row_count":738,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_benefit_coverage_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_benefit_coverage_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_benefit_coverage_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["coverage_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_payer_chain_v3","source_fqn":"medicare_silver.state_duals_kb_payer_chain_v3","title":"State duals knowledge base v3 (retired; superseded by v4): payer chain","domain":"state","stage":"silver","status":"retired","grain":"Key state_code, integration_type, state_arrangement, dual_category, benefit, payer_order, effective_from. Spine: 9 coverage x 3 population x D-SNP integration (CMS 42 CFR 422.2).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"state_code,integration_type,state_arrangement,dual_category,benefit,payer_order,effective_from","row_count":1779,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_payer_chain_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_payer_chain_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_payer_chain_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["benefit","dual_category","effective_from","integration_type","payer_order","state_arrangement"],"backing_store":"glue"},{"source_id":"state_duals_kb_dsnp_requirement_v3","source_fqn":"medicare_silver.state_duals_kb_dsnp_requirement_v3","title":"State duals knowledge base v3 (retired; superseded by v4): dsnp requirement","domain":"state","stage":"silver","status":"retired","grain":"Key requirement_id. Spine: 12 policy and authority (SMAC = contract); 2 program.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"requirement_id","row_count":313,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_dsnp_requirement_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_dsnp_requirement_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_dsnp_requirement_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["requirement_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_cost_sharing_v3","source_fqn":"medicare_silver.state_duals_kb_cost_sharing_v3","title":"State duals knowledge base v3 (retired; superseded by v4): cost sharing","domain":"state","stage":"silver","status":"retired","grain":"Key cost_sharing_id. Spine: 9 coverage (cost sharing) x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"cost_sharing_id","row_count":219,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_cost_sharing_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_cost_sharing_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_cost_sharing_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["cost_sharing_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_msp_limits_v3","source_fqn":"medicare_silver.state_duals_kb_msp_limits_v3","title":"State duals knowledge base v3 (retired; superseded by v4): msp limits","domain":"state","stage":"silver","status":"retired","grain":"Key msp_limit_id. Spine: 3 population (eligibility group).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"msp_limit_id","row_count":217,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_msp_limits_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_msp_limits_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_msp_limits_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["msp_limit_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_change_log_v3","source_fqn":"medicare_silver.state_duals_kb_change_log_v3","title":"State duals knowledge base v3 (retired; superseded by v4): change log","domain":"state","stage":"silver","status":"retired","grain":"Key change_id. Spine: 12 policy and authority (dated change).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"change_id","row_count":205,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_change_log_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_change_log_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_change_log_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["change_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_open_question_v3","source_fqn":"medicare_silver.state_duals_kb_open_question_v3","title":"State duals knowledge base v3 (retired; superseded by v4): open question","domain":"state","stage":"silver","status":"retired","grain":"Key question_id. Spine: 14 quality and enrollment rules / availability grid (MEDICAID-SPINE section 4).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"question_id","row_count":177,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_open_question_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_open_question_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_open_question_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["question_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_plan_effective_benefit_v3","source_fqn":"medicare_silver.state_duals_kb_plan_effective_benefit_v3","title":"State duals knowledge base v3 (retired; superseded by v4): plan effective benefit","domain":"state","stage":"silver","status":"retired","grain":"Key effective_benefit_id. Spine: 9 coverage x 3 population x 1 organization (contract-plan) x D-SNP integration.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2 + v3; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"effective_benefit_id","row_count":540,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_plan_effective_benefit_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_plan_effective_benefit_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v3.py --execute, cloud run 20261011T043112Z-2a5a37d7 (create); rerun 20261011T043247Z-2a5a37d7: 12 of 12 objects unchanged (idempotent). Row counts Athena 10c9cd3c (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE3_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_plan_effective_benefit_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["effective_benefit_id"],"backing_store":"glue"},{"source_id":"vw_dsnp_medicaid_wrap_v3","source_fqn":"medicare_semantic.vw_dsnp_medicaid_wrap_v3","title":"Each D-SNP plan segment x state with its integration status and the state's Medicaid wrap (dental, eyeglasses, hearing, NEMT, overriding SMAC rules) (retired; superseded by v4)","domain":"medicare","stage":"semantic_view","status":"retired","grain":"Same as medicare_silver.dsnp_integration_status_v1.","description":"Version 3 of the wrap view over the state duals KB v3; superseded by v4.","identity_key":"plan_year,contract_id,plan_id,segment_id,state_code","row_count":4795,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the edition coordinate."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_semantic.vw_dsnp_medicaid_wrap_v3 stays in Athena as history, but query_substrate treats it as retired and points to medicare_semantic.vw_dsnp_medicaid_wrap_v4.","commercial_terms":"Public data.","provenance_chain_ref":"pipelines/medicare/semantic/vw_dsnp_medicaid_wrap_v3.sql (created by the v3 load; never replaced)","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_semantic.vw_dsnp_medicaid_wrap_v4 (state duals KB v4, loaded 2026-10-11; v3 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_source_v2","source_fqn":"medicare_silver.state_duals_kb_source_v2","title":"State duals knowledge base v2 (retired; superseded by v4): source","domain":"state","stage":"silver","status":"retired","grain":"Key source_id. Spine: 15 documents and actors.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"source_id","row_count":255,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_source_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_source_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_source_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_rule_v2","source_fqn":"medicare_silver.state_duals_kb_rule_v2","title":"State duals knowledge base v2 (retired; superseded by v4): rule","domain":"state","stage":"silver","status":"retired","grain":"Key rule_id. Spine: 12 policy and authority (rule); 9 coverage / 3 population via applies_to.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"rule_id","row_count":641,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_rule_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_rule_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_rule_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rule_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_state_program_v2","source_fqn":"medicare_silver.state_duals_kb_state_program_v2","title":"State duals knowledge base v2 (retired; superseded by v4): state program","domain":"state","stage":"silver","status":"retired","grain":"Key program_id. Spine: 2 program (+ 12 authority, 8 geography).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"program_id","row_count":201,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_state_program_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_state_program_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_state_program_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["program_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_benefit_coverage_v2","source_fqn":"medicare_silver.state_duals_kb_benefit_coverage_v2","title":"State duals knowledge base v2 (retired; superseded by v4): benefit coverage","domain":"state","stage":"silver","status":"retired","grain":"Key coverage_id. Spine: 9 coverage x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"coverage_id","row_count":510,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_benefit_coverage_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_benefit_coverage_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_benefit_coverage_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["coverage_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_payer_chain_v2","source_fqn":"medicare_silver.state_duals_kb_payer_chain_v2","title":"State duals knowledge base v2 (retired; superseded by v4): payer chain","domain":"state","stage":"silver","status":"retired","grain":"Key state_code, integration_type, state_arrangement, dual_category, benefit, payer_order, effective_from. Spine: 9 coverage x 3 population x D-SNP integration (CMS 42 CFR 422.2).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"state_code,integration_type,state_arrangement,dual_category,benefit,payer_order,effective_from","row_count":776,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_payer_chain_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_payer_chain_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_payer_chain_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["benefit","dual_category","effective_from","integration_type","payer_order","state_arrangement"],"backing_store":"glue"},{"source_id":"state_duals_kb_dsnp_requirement_v2","source_fqn":"medicare_silver.state_duals_kb_dsnp_requirement_v2","title":"State duals knowledge base v2 (retired; superseded by v4): dsnp requirement","domain":"state","stage":"silver","status":"retired","grain":"Key requirement_id. Spine: 12 policy and authority (SMAC = contract); 2 program.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"requirement_id","row_count":185,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_dsnp_requirement_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_dsnp_requirement_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_dsnp_requirement_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["requirement_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_cost_sharing_v2","source_fqn":"medicare_silver.state_duals_kb_cost_sharing_v2","title":"State duals knowledge base v2 (retired; superseded by v4): cost sharing","domain":"state","stage":"silver","status":"retired","grain":"Key cost_sharing_id. Spine: 9 coverage (cost sharing) x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"cost_sharing_id","row_count":116,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_cost_sharing_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_cost_sharing_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_cost_sharing_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["cost_sharing_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_msp_limits_v2","source_fqn":"medicare_silver.state_duals_kb_msp_limits_v2","title":"State duals knowledge base v2 (retired; superseded by v4): msp limits","domain":"state","stage":"silver","status":"retired","grain":"Key msp_limit_id. Spine: 3 population (eligibility group).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"msp_limit_id","row_count":210,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_msp_limits_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_msp_limits_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_msp_limits_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["msp_limit_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_change_log_v2","source_fqn":"medicare_silver.state_duals_kb_change_log_v2","title":"State duals knowledge base v2 (retired; superseded by v4): change log","domain":"state","stage":"silver","status":"retired","grain":"Key change_id. Spine: 12 policy and authority (dated change).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"change_id","row_count":126,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_change_log_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_change_log_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_change_log_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["change_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_open_question_v2","source_fqn":"medicare_silver.state_duals_kb_open_question_v2","title":"State duals knowledge base v2 (retired; superseded by v4): open question","domain":"state","stage":"silver","status":"retired","grain":"Key question_id. Spine: 14 quality and enrollment rules / availability grid (MEDICAID-SPINE section 4).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"question_id","row_count":87,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_open_question_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_open_question_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_open_question_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["question_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_plan_effective_benefit_v2","source_fqn":"medicare_silver.state_duals_kb_plan_effective_benefit_v2","title":"State duals knowledge base v2 (retired; superseded by v4): plan effective benefit","domain":"state","stage":"silver","status":"retired","grain":"Key effective_benefit_id. Spine: 9 coverage x 3 population x 1 organization (contract-plan) x D-SNP integration.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1 + v2; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"effective_benefit_id","row_count":540,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_plan_effective_benefit_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_plan_effective_benefit_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_state_duals_kb_v2.py --execute, cloud run 20261011T004959Z-8bf54a08 (create); rerun 20261011T005145Z-8bf54a08: 13 of 13 objects unchanged (idempotent). Row counts Athena 12430453 (0 mismatches). Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json (STATE_DUALS_KB_WAVE2_PROGRESS.md).","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_plan_effective_benefit_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["effective_benefit_id"],"backing_store":"glue"},{"source_id":"vw_dsnp_medicaid_wrap_v2","source_fqn":"medicare_semantic.vw_dsnp_medicaid_wrap_v2","title":"Each D-SNP plan segment x state with its integration status and the state's Medicaid wrap (dental, eyeglasses, hearing, NEMT, overriding SMAC rules) (retired; superseded by v4)","domain":"medicare","stage":"semantic_view","status":"retired","grain":"Same as medicare_silver.dsnp_integration_status_v1.","description":"Version 2 of the wrap view over the state duals KB v2; superseded by v4.","identity_key":"plan_year,contract_id,plan_id,segment_id,state_code","row_count":4795,"last_updated":"2026-10-11","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the edition coordinate."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_semantic.vw_dsnp_medicaid_wrap_v2 stays in Athena as history, but query_substrate treats it as retired and points to medicare_semantic.vw_dsnp_medicaid_wrap_v4.","commercial_terms":"Public data.","provenance_chain_ref":"pipelines/medicare/semantic/vw_dsnp_medicaid_wrap_v2.sql (created by the v2 load; never replaced)","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_semantic.vw_dsnp_medicaid_wrap_v4 (state duals KB v4, loaded 2026-10-11; v2 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_source_v1","source_fqn":"medicare_silver.state_duals_kb_source_v1","title":"State duals knowledge base v1 (retired; superseded by v4): source","domain":"state","stage":"silver","status":"retired","grain":"Key source_id. Spine: 15 documents and actors.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"source_id","row_count":133,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_source_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_source_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_source_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["source_id"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"state_duals_kb_rule_v1","source_fqn":"medicare_silver.state_duals_kb_rule_v1","title":"State duals knowledge base v1 (retired; superseded by v4): rule","domain":"state","stage":"silver","status":"retired","grain":"Key rule_id. Spine: 12 policy and authority (rule); 9 coverage / 3 population via applies_to.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"rule_id","row_count":306,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_rule_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_rule_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_rule_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rule_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_state_program_v1","source_fqn":"medicare_silver.state_duals_kb_state_program_v1","title":"State duals knowledge base v1 (retired; superseded by v4): state program","domain":"state","stage":"silver","status":"retired","grain":"Key program_id. Spine: 2 program (+ 12 authority, 8 geography).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"program_id","row_count":164,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_state_program_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_state_program_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_state_program_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["program_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_benefit_coverage_v1","source_fqn":"medicare_silver.state_duals_kb_benefit_coverage_v1","title":"State duals knowledge base v1 (retired; superseded by v4): benefit coverage","domain":"state","stage":"silver","status":"retired","grain":"Key coverage_id. Spine: 9 coverage x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"coverage_id","row_count":415,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_benefit_coverage_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_benefit_coverage_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_benefit_coverage_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["coverage_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_payer_chain_v1","source_fqn":"medicare_silver.state_duals_kb_payer_chain_v1","title":"State duals knowledge base v1 (retired; superseded by v4): payer chain","domain":"state","stage":"silver","status":"retired","grain":"Key state_code, integration_type, state_arrangement, dual_category, benefit, payer_order, effective_from. Spine: 9 coverage x 3 population x D-SNP integration (CMS 42 CFR 422.2).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"state_code,integration_type,state_arrangement,dual_category,benefit,payer_order,effective_from","row_count":348,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_payer_chain_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_payer_chain_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_payer_chain_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["benefit","dual_category","effective_from","integration_type","payer_order","state_arrangement"],"backing_store":"glue"},{"source_id":"state_duals_kb_dsnp_requirement_v1","source_fqn":"medicare_silver.state_duals_kb_dsnp_requirement_v1","title":"State duals knowledge base v1 (retired; superseded by v4): dsnp requirement","domain":"state","stage":"silver","status":"retired","grain":"Key requirement_id. Spine: 12 policy and authority (SMAC = contract); 2 program.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"requirement_id","row_count":96,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_dsnp_requirement_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_dsnp_requirement_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_dsnp_requirement_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["requirement_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_cost_sharing_v1","source_fqn":"medicare_silver.state_duals_kb_cost_sharing_v1","title":"State duals knowledge base v1 (retired; superseded by v4): cost sharing","domain":"state","stage":"silver","status":"retired","grain":"Key cost_sharing_id. Spine: 9 coverage (cost sharing) x 3 population.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"cost_sharing_id","row_count":72,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_cost_sharing_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_cost_sharing_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_cost_sharing_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["cost_sharing_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_msp_limits_v1","source_fqn":"medicare_silver.state_duals_kb_msp_limits_v1","title":"State duals knowledge base v1 (retired; superseded by v4): msp limits","domain":"state","stage":"silver","status":"retired","grain":"Key msp_limit_id. Spine: 3 population (eligibility group).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"msp_limit_id","row_count":204,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_msp_limits_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_msp_limits_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_msp_limits_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["msp_limit_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_change_log_v1","source_fqn":"medicare_silver.state_duals_kb_change_log_v1","title":"State duals knowledge base v1 (retired; superseded by v4): change log","domain":"state","stage":"silver","status":"retired","grain":"Key change_id. Spine: 12 policy and authority (dated change).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"change_id","row_count":72,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_change_log_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_change_log_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_change_log_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["change_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_open_question_v1","source_fqn":"medicare_silver.state_duals_kb_open_question_v1","title":"State duals knowledge base v1 (retired; superseded by v4): open question","domain":"state","stage":"silver","status":"retired","grain":"Key question_id. Spine: 14 quality and enrollment rules / availability grid (MEDICAID-SPINE section 4).","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"question_id","row_count":48,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_open_question_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_open_question_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_open_question_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["question_id"],"backing_store":"glue"},{"source_id":"state_duals_kb_plan_effective_benefit_v1","source_fqn":"medicare_silver.state_duals_kb_plan_effective_benefit_v1","title":"State duals knowledge base v1 (retired; superseded by v4): plan effective benefit","domain":"state","stage":"silver","status":"retired","grain":"Key effective_benefit_id. Spine: 9 coverage x 3 population x 1 organization (contract-plan) x D-SNP integration.","description":"Cited, curated state-by-state knowledge of what Medicaid gives each dual category and who pays: every row carries source_id, verbatim quote + locator, confidence (exact / rule / judged), effective dates and spine_ref. Seeds pipelines/medicare/data/state_duals_kb/v1; row contract pipelines/medicare/dsnp_wrap/kb.py.","identity_key":"effective_benefit_id","row_count":540,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"event_driven","watermark_field":"seed_sha256","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'seed_sha256' identifies the seed file a row came from; a new seed set is a new table version."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_silver.state_duals_kb_plan_effective_benefit_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_silver.state_duals_kb_plan_effective_benefit_v4.","commercial_terms":"Derived from public documents (federal, national trackers, state agencies).","provenance_chain_ref":"Loaded by ops/scripts/load_dsnp_dual_medicaid_wrap_v1.py --parts kb,view, cloud run 20261010T200503Z-a3be32d9 (create; view DDL Athena b77687f3-be9b-4d4a-af9d-91e4257e0097); rerun 20261010T200649Z-a3be32d9: 15 of 15 objects unchanged (idempotent). Row counts Athena 4a2092ce-e04c-4f64-af8e-e22a7b66b7ef. Seeds validated fail-closed by pipelines/medicare/dsnp_wrap/kb.py. Record docs/reference/source-audit/source-mastery/records/state_duals_knowledge_base.json.","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_silver.state_duals_kb_plan_effective_benefit_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["effective_benefit_id"],"backing_store":"glue"},{"source_id":"vw_dsnp_medicaid_wrap_v1","source_fqn":"medicare_semantic.vw_dsnp_medicaid_wrap_v1","title":"Each D-SNP plan segment x state with its integration status and the state's Medicaid wrap (dental, eyeglasses, hearing, NEMT, overriding SMAC rules) (retired; superseded by v4)","domain":"medicare","stage":"semantic_view","status":"retired","grain":"Same as medicare_silver.dsnp_integration_status_v1.","description":"Joins dsnp_integration_status_v1 to the state duals KB (latest ALL_FULL coverage row per state and benefit; SMAC requirements that override plan filings in the plan year).","identity_key":"plan_year,contract_id,plan_id,segment_id,state_code","row_count":4795,"last_updated":"2026-10-10","freshness_sla":"Frozen as a definition; read v4.","recollection":{"cadence":"annual","watermark_field":"plan_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'plan_year' is the edition coordinate."]},"raw_queryable_via":"Retired 2026-10-12 and kept: the Glue object medicare_semantic.vw_dsnp_medicaid_wrap_v1 stays in Athena as history, but query_substrate treats it as retired and points to medicare_semantic.vw_dsnp_medicaid_wrap_v4.","commercial_terms":"Public data.","provenance_chain_ref":"pipelines/medicare/semantic/vw_dsnp_medicaid_wrap_v1.sql","known_gaps":["Retired; every trap of the register source state_duals_kb applies, and v4 is the served version."],"notes":"RETIRED 2026-10-12 at registration (register source state_duals_kb, W8): superseded by v4 (a new seed set is a new table version, never an overwrite). Registered as retired so the door answers it with a redirect.","superseded_by":"medicare_semantic.vw_dsnp_medicaid_wrap_v4 (state duals KB v4, loaded 2026-10-11; v1 kept as history, never overwritten)","tools":[],"dataset_id":"state_duals_kb","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"usps:state":["state_code"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ma_spine_county","source_fqn":"medicare_semantic.ma_spine_county_v20261012a","title":"MA spine: counties (CMS SSA code, FIPS beside it)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per CPSC SSA county code: state, FIPS (latest and every FIPS seen), name, first/last month.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"county_ssa","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_county_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Six FIPS cover several SSA counties (LA 06037 = 05200 + 05210): SSA is the key, FIPS a label."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ma_spine_landscape_county","source_fqn":"medicare_semantic.ma_spine_landscape_county_v20261012b","title":"MA spine: Landscape county names mapped to SSA","domain":"medicare","stage":"mart","status":"planned","grain":"One row per Landscape (report_year, state, county name) x matched SSA, with match_kind (matched / statewide / ambiguous / unmatched).","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"report_year,state_raw,county_raw,county_ssa","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_landscape_county_v20261012b (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Statewide rows ('All Counties') cover every SSA of the state; LA's two SSA codes stay 'ambiguous', never picked."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":["report_year"],"unmapped_key_tokens":["county_raw","state_raw"],"backing_store":"glue"},{"source_id":"ma_spine_parent_month","source_fqn":"medicare_semantic.ma_spine_parent_month_v20261012a","title":"MA spine: the parent of every contract, every month, as it was and as it is now","domain":"medicare","stage":"mart","status":"planned","grain":"One row per contract x month (2006-08..): parent as was (effective-dated, Aetna is Aetna before 2019), parent as now (contract alive today -> today's parent; closed contract -> whole-company acquisitions/mergers/renames, never book sales), the rule used.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"contract_id,report_month","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_parent_month_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["vw_ma_parent_resolved_v1 mixes as-was and as-now (a brand_of_acquirer row maps Aetna to CVS from 2006); this table separates them."],"notes":null,"superseded_by":"medicare_semantic.ma_spine_parent_month_v20261017a (card ma_spine_parent_month_v20261017a, the 2026-10-17 rebuild; rebuilds take the next letter, never overwrite). This name stays readable as the rollback.","tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["report_month"],"backing_store":"glue"},{"source_id":"ma_spine_plan_lineage","source_fqn":"medicare_semantic.ma_spine_plan_lineage_v20261012a","title":"MA spine: plan lineage through the CMS crosswalk","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan x plan year with its lineage id (renewal, consolidation, renumber, split, new) and one 'ended' row per terminated plan.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"plan_year,plan,is_end","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_plan_lineage_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Splits keep one continuing plan (own id, else the larger successor); the others branch and record branch_of."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["is_end","plan"],"backing_store":"glue"},{"source_id":"ma_spine_plan_year","source_fqn":"medicare_semantic.ma_spine_plan_year_v20261012c","title":"MA spine: plan-year keys (market, product, Part D, parent, lineage)","domain":"medicare","stage":"mart","status":"partial","grain":"One row per plan segment x plan year, 2008-2027: market (MA, PACE, Cost, MMP, PDP) and market_key (EGWP suffixed), product type, SNP class, Part D with its source, parent as was / as now, lineage, classification_source.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Accepted for the raw door 2026-11-02 (acceptance gate CANDIDATE, reachable, has data, schema captured; Omega's MA enrollment master reads it).","identity_key":"plan_year,plan_segment_key","row_count":null,"last_updated":"2026-10-12","freshness_sla":"Rebuilt by the spine orchestrator when the Tracker loads the CMS source release.","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_plan_year_v20261012c (accepted 2026-11-02)","known_gaps":["2008-2014 are plan grain (segment '000') from CMS's plan file and SNP report; 2006-2007 not covered (plan grain spotty before 2008-06)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_ma_spine_core","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["plan_segment_key"],"backing_store":"glue"},{"source_id":"ma_spine_parent_month_v20261017a","source_fqn":"medicare_semantic.ma_spine_parent_month_v20261017a","title":"MA spine: parent per contract x month (as was, as now)","domain":"medicare","stage":"mart","status":"partial","grain":"One row per contract_id x report_month: the parent organization as CMS printed it that month (parent_of_record), the parent as it was then (parent_id_as_was, parent_name_as_was) and the parent as it is today (parent_id_as_now, parent_name_as_now, with as_now_rule and as_now_events naming the restatement), method_tier, confidence, organization_type, plan_type, enrollment_count, spine_version.","description":"Part of the MA spine (docs/architecture/2026-10-12-ma-spine.md; Alpha lane; rebuilds take the next letter, never overwrite). Joins enroll_plan_county / enroll_plan_month on contract_id + report_month; read parent_*_as_now to restate history to today's parent, parent_*_as_was for the parent of the day. Accepted for the raw door 2026-11-02 (acceptance gate CANDIDATE, reachable, has data, schema captured; Omega's MA enrollment master reads it).","identity_key":"contract_id,report_month","row_count":null,"last_updated":"2026-10-17","freshness_sla":"Rebuilt by the spine orchestrator when the Tracker loads the CMS source release; a rebuild is a new versioned name.","recollection":{"cadence":"monthly","watermark_field":"report_month","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_parent_month_v20261017a (versioned name; accepted 2026-11-02)","known_gaps":["parent_of_record is CMS's own string for the month; as_was / as_now are the spine's bindings with their rule and confidence on the row; read method_tier before quoting a parent for a month CMS did not print one.","VERSIONED by name (v20261017a): a rebuild is a new table; the catalog pointer moves, the old name stays readable."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_ma_spine_core","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["report_month"],"backing_store":"glue"},{"source_id":"tracker_ma_directory_plan_npi_site_v1","source_fqn":"medicare_bronze.ma_directory_plan_npi_site_v1","title":"MA plan networks: plan year x CMS plan x NPI x listed location (2026, 2027)","domain":"medicare","stage":"bronze","status":"partial","grain":"One row per listing observation: plan_year x cms_plan_id (H1234-001-000) x npi x the location as listed (location_name, city, state, zip5, phone) x the source page (url, page, raw_sha256). No unique row key: the membership grain is (plan_year, cms_plan_id, npi), served DISTINCT, never as raw row counts. Stage 20 (dataset_id 7bceef45cc9e5910e64caa428a1f3e40869f91d149c4e19f08cc55f5e468ba7c, 2026-11-02): 2026 218,950,666 rows / 645 contracts / 3,581 plans / 2,437,003 NPIs; 2027 289,906,332 / 614 / 4,305 / 2,421,994; plan_year unknown 826,292 rows (4 contracts), excluded from answers.","description":"The Data Tracker's plan-network build (docs/data-tracker/SERVING-HANDOFF-PLAN-NETWORKS.md): which NPIs each Medicare Advantage plan lists, from the payer's own Plan-Net API, the printed directory, a name match to NPPES, or the Medicare Plan Finder export (npi_basis), with a grade on matched rows (A name+ZIP unique, B name+state unique, N name unique nationally: name-matched, never presented as printed) and plan_key_basis saying how the row reached its CMS plan id (the publisher's own id, a network map, or the CMS crosswalk carry-back: 2027 rows carrying plan_key_basis cy2026_directory_2027_not_yet_posted: 42 contracts / 1,132,045 members at stage 21 whose 2026 directory stands in; label or exclude them). A contract with no rows is UNCOVERED (the handoff's open-gap list), never \"no network\"; absence of an NPI is a claim only for a covered contract and only \"not listed in the published directory\". Typed tools (get_plan_network, is_provider_in_plan, get_network_change) are proposed and start on Ben's go.","identity_key":"npi","row_count":null,"last_updated":"2026-11-02","freshness_sla":"One immutable publish per stage now, monthly later; the current dataset_id is in s3://vlada-platform-raw/medicare/bronze/ma_directory_plan_npi_site_v1/_current.json (written only after a verified, replay-identical publish).","recollection":{"cadence":"monthly","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_bronze.ma_directory_plan_npi_site_v1 WHERE dataset_id = '<the current publish>' (versioned: pin dataset_id; never count across datasets)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs and CMS files.","provenance_chain_ref":"tools/data_tracker/publish_directory_network.py (one dataset_id per publish; every row carries url, page, raw_sha256).","known_gaps":["VERSIONED: pin dataset_id (the partition); the current one is in the _current.json pointer; never count across datasets.","No unique row key: 1.9% exact duplicates measured in a 4-contract sample, kept at source (a global DISTINCT over 510M rows spilled 81 GB and failed stage 21, so the assembler does not remove them); serve DISTINCT on (plan_year, cms_plan_id, npi) for membership and on (location_name, city, state, zip5) for sites.","page is a string: cast before ordering or taking a max. Matched grade N rows can lack city, state and ZIP.","Listings whose printed name does not resolve to a single NPI are kept with npi empty (grade C, several NPIs fit, 7.17M rows; grade D, none fit, 4.16M; all npi_basis matched; Humana PDFs 8.3M, Wellcare 0.9M); membership answers count NPIs, so they are excluded there. api, printed and mpf rows always carry an NPI.","Coverage (stage 21, 2026-11-02): 99.1% of 2026 MA members and 96.1% of 2027 members from 2027 sources; the open-gap contracts (HCSC, Geisinger 2027, Highmark Wholecare, Elderplan, Mercy Care, Elevate, CarePartners CT, six thin Elevance contracts) are UNCOVERED, not empty."],"notes":null,"superseded_by":null,"tools":["get_network_change","get_plan_network","is_provider_in_plan"],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"bronze","asset_type":"table","purpose":"source_data","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ma_spine_contract_stars","source_fqn":"medicare_semantic.ma_spine_contract_stars_v20261012b","title":"MA spine: Stars per contract and rating year (published current and first edition, recomputed score, QBP)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per contract x rating year: Overall / Part C / Part D current and as first published (restatements named), recomputed raw score and half-star distances, QBP tier, bonus %, rebate share, 4.0-cliff dollars.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"contract_id,rating_year","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_contract_stars_v20261012b (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Serving names v20261012a (recompute v9) until the Stars lane accepts v10 for serving."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["rating_year"],"backing_store":"glue"},{"source_id":"ma_spine_plan_stars","source_fqn":"medicare_semantic.ma_spine_plan_stars_v20261012c","title":"MA spine: Stars on every plan row (displayed and paid)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan segment x plan year: stars_displayed (rating year = plan year) and stars_paid (rating year = plan year - 1, with QBP tier / bonus / rebate share). Contract grain, labeled.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"plan_year,plan_segment_key","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_plan_stars_v20261012c (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["stars_ratings_summary.payment_year equals the rating year and is never read as a payment year."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["plan_segment_key"],"backing_store":"glue"},{"source_id":"ma_spine_contract_measures","source_fqn":"medicare_semantic.ma_spine_contract_measures_v20261012a","title":"MA spine: Stars measures per contract (value, star, cut points, distance to the next star)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per contract x rating year x measure: canonical name across renumbering, part, domain, weight, direction, CMS value and star, the cut points, the star re-derived from them, distance to the next star.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"contract_id,rating_year,measure_id","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_contract_measures_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["star_from_cuts differs from CMS's star on 4-9% of graded rows (disaster, hold-harmless, rounding): carried, not corrected."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["measure_id","rating_year"],"backing_store":"glue"},{"source_id":"ma_spine_moves","source_fqn":"medicare_semantic.ma_spine_moves_v20261012a","title":"MA spine: where every plan's members stand on January 1 (plan x county)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan x county x base year (September members): renewed, crosswalked, lost (terminated), lost (county exit), with the successor plan and both parents.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"base_year,plan,county_ssa","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_moves_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Individual MA only; reproduces fact_landscape_disposition_v1 within 2% of members per transition."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["base_year","plan"],"backing_store":"glue"},{"source_id":"ma_spine_plan_payment","source_fqn":"medicare_semantic.ma_spine_plan_payment_v20261012a","title":"MA spine: plan payment (Part C and Part D)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per payment year x contract x plan (and contract-level rows): A/B PMPM, Part C risk, rebate PMPM, MSA deposit, Part D direct subsidy, risk, reinsurance, LICS.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"payment_year,contract_id,plan_id,contract_level_row","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_plan_payment_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["A/B is standardized to a 1.0 risk score; PMPM averages, not totals; latest payment year 2024."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":[],"unmapped_key_tokens":["contract_level_row","payment_year"],"backing_store":"glue"},{"source_id":"ma_spine_contract_mlr","source_fqn":"medicare_semantic.ma_spine_contract_mlr_v20261012a","title":"MA spine: MLR per contract and year","domain":"medicare","stage":"mart","status":"planned","grain":"One row per contract x contract year: adjusted / unadjusted MLR, numerator and denominator where filed, member months, remittance, revenue, claims, the method used.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"contract_year,contract_id","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_contract_mlr_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["2018-2022 carry only the adjusted MLR; latest 2023."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":["contract_year"],"backing_store":"glue"},{"source_id":"ma_spine_plan_econ","source_fqn":"medicare_semantic.ma_spine_plan_econ_v20261012a","title":"MA spine: economics on every plan row, lags labeled","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan segment x plan year: payment (plan, else contract, labeled), MLR (contract), and for years past the latest held the latest held value in its own *_latest column.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"plan_year,plan_segment_key","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_plan_econ_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Never carried forward silently: 2025-2027 payment is NULL plus *_latest (2024)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["plan_segment_key"],"backing_store":"glue"},{"source_id":"ma_spine_company","source_fqn":"medicare_semantic.ma_spine_company_v20261012c","title":"MA spine: the master company registry (one row per company, every domain maps in)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per master_company_id (vc: + the MA canonical parent id; vc:medicaid:<id> for a Medicaid-only parent): name, the company it belongs to today, coverage flags (MA, PDP; Medicaid from the provisional map; Marketplace and hospital payer NULL = not yet mapped), first / last month, contracts.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"master_company_id","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"event_driven","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_company_v20261012c (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Medicaid coverage is provisional until the Medicaid spine locks; Marketplace and hospital payer not yet mapped (NULL, never false)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["master_company_id"],"backing_store":"glue"},{"source_id":"ma_spine_company_anchor","source_fqn":"medicare_semantic.ma_spine_company_anchor_v20261012f","title":"MA spine: company anchors (CMS contract, CMS parent string, SEC CIK, NAIC, Medicaid parent) by validity","domain":"medicare","stage":"mart","status":"planned","grain":"One row per master company x anchor type x anchor value x validity window: cms_contract and cms_parent_string (effective-dated; Aetna strings split at CMS recognition), sec_cik (reviewed seed, anchors/sec_cik_ma.csv), naic_group / naic_company / medicaid_parent (Medicaid lane map, provisional), with source, method and rollup_authorized.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"master_company_id,anchor_type,anchor_value,valid_from","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"event_driven","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_company_anchor_v20261012f (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["A domain new mapping replaces its previous one; Medicaid rows provisional; 25 Medicaid legal entities with no parent edge are left out, named in STATUS."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["anchor_type","anchor_value","master_company_id","valid_from"],"backing_store":"glue"},{"source_id":"ma_spine_county_market","source_fqn":"medicare_semantic.ma_spine_county_market_v20261012b","title":"MA spine: the county market (penetration, beneficiaries, duals, Part D, benchmarks, competition)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per county SSA x year 2015-2027: eligibles, MA enrolled two ways, penetration, Medicare beneficiaries, OM vs MA, full/partial duals, PDP vs MA-PD, LIS, ratebook rates, plans and parents offered, parent HHI.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"year,county_ssa","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_county_market_v20261012b (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Penetration holes named (CT 2024-08+, AK 2025-07+); a FIPS covering several SSA counties is flagged fips_group."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county"],"entity_key_columns":{"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["year"],"backing_store":"glue"},{"source_id":"ma_spine_partd_plan","source_fqn":"medicare_semantic.ma_spine_partd_plan_v20261012c","title":"MA spine: Part D design and premium per plan","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan segment x plan year: Part D premium (basic / supplemental), deductible, LIS zero-premium, benchmark, de minimis, formulary id, D-SNP full-dual premium column.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"plan_year,plan_segment_key","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_partd_plan_v20261012c (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Before 2025 the premium split comes from the Plan and Premium file with the year corrected (LAND-3) and '$-' read as $0 (LAND-1); CY2027 formulary not loaded."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["plan_segment_key"],"backing_store":"glue"},{"source_id":"ma_spine_formulary","source_fqn":"medicare_semantic.ma_spine_formulary_v20261012a","title":"MA spine: formulary summary","domain":"medicare","stage":"mart","status":"planned","grain":"One row per formulary x contract year: drugs, shares with prior auth / step therapy / quantity limit, tier mix.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"contract_year,formulary_id","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_formulary_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["September release of each contract year; CY2027 not loaded."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["contract_year","formulary_id"],"backing_store":"glue"},{"source_id":"ma_spine_formulary_churn","source_fqn":"medicare_semantic.ma_spine_formulary_churn_v20261012b","title":"MA spine: formulary churn per plan, followed through its lineage","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan x plan year: its formulary vs last year's (the predecessor's): drugs removed, added, tier up/down, prior auth added.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"plan_year,plan","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_formulary_churn_v20261012b (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["RxCUI level."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["plan"],"backing_store":"glue"},{"source_id":"ma_spine_enroll_plan_county","source_fqn":"medicare_semantic.ma_spine_enroll_plan_county_v20261012a","title":"MA spine: enrollment per plan x county x month (known counts)","domain":"medicare","stage":"mart","status":"partial","grain":"One row per contract-plan x county SSA x month with a published count (MA contracts H/R), market, product, lineage, parent as was / as now. Partitioned by year.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Accepted for the raw door 2026-11-02 (acceptance gate CANDIDATE, reachable, has data, schema captured; Omega's MA enrollment master reads it).","identity_key":"contract_id,plan_id,county_ssa,report_month","row_count":null,"last_updated":"2026-10-12","freshness_sla":"Rebuilt by the spine orchestrator when the Tracker loads the CMS source release.","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_enroll_plan_county_v20261012a (accepted 2026-11-02)","known_gaps":["Suppressed cells (<11) are in ma_spine_enroll_suppressed with bounds, never 0."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_ma_spine_core","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","cms:plan_id","ssa:county"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"ssa:county":["county_ssa"]},"technical_keys":[],"unmapped_key_tokens":["report_month"],"backing_store":"glue"},{"source_id":"ma_spine_enroll_plan_month","source_fqn":"medicare_semantic.ma_spine_enroll_plan_month_v20261012a","title":"MA spine: enrollment per plan x month","domain":"medicare","stage":"mart","status":"planned","grain":"One row per contract-plan x month from CMS's plan file, with keys and parents.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"contract_id,plan_id,report_month","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_enroll_plan_month_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Within 0.1% of CMS's contract summary every September 2019-2026."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":[],"unmapped_key_tokens":["report_month"],"backing_store":"glue"},{"source_id":"ma_spine_enroll_parent_month","source_fqn":"medicare_semantic.ma_spine_enroll_parent_month_v20261012a","title":"MA spine: enrollment per parent x market x product x month","domain":"medicare","stage":"mart","status":"planned","grain":"One row per month x parent (as was, as now) x market_key x product type.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"report_month,parent_id_as_was,parent_id_as_now,market_key,product_type","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_enroll_parent_month_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Before 2008 keys are unclassified."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["market_key","parent_id_as_now","parent_id_as_was","product_type","report_month"],"backing_store":"glue"},{"source_id":"ma_spine_rules","source_fqn":"medicare_semantic.ma_spine_rules_v20261012b","title":"MA spine: the rules (CMS parameters, boundaries, reading rules), every row cited","domain":"medicare","stage":"mart","status":"planned","grain":"One row per year x rule x region: CMS Part D and benchmark parameters (2006-2027), Part C memo limits (2026-2027), series boundaries, Vlada reading rules with versions.","description":"Part of the MA spine (one connected, normalized Medicare Advantage layer: docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass (docs/architecture/ma-spine/STATUS.md). Status planned until accepted for serving.","identity_key":"year,rule_kind,rule,region","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_rules_v20261012b (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/2026-10-12-ma-spine.md; docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["MOOP limits and Part D standard benefit before 2026 are to_source (RULES.yaml)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["region","rule","rule_kind","year"],"backing_store":"glue"},{"source_id":"ma_spine_plan_footprint","source_fqn":"medicare_semantic.ma_spine_plan_footprint_v20261012a","title":"MA spine: footprint, where each plan is sold","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan segment x county SSA x plan year 2015-2027 from the filed PBP plan area (latest quarter; segment from bid_id) and, for regional PPOs, the Landscape; EGHP and partial-county flags.","description":"Part of the MA spine (docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass. Status planned until accepted for serving.","identity_key":"plan_year,contract_id,plan_id,segment_id,county_ssa","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_plan_footprint_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Regional PPOs come from the Landscape (absent from the county plan area)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id","ssa:county"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"],"ssa:county":["county_ssa"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"ma_spine_snp","source_fqn":"medicare_semantic.ma_spine_snp_v20261012a","title":"MA spine: SNP depth (D-SNP integration, look-alikes, C-SNP conditions, the Medicaid organization as filed)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per SNP (or look-alike) plan segment x state x plan year: integration status and agreement flags (adopted from dsnp_integration_status_v1), CMS list fields, look-alike dual share, C-SNP conditions, CMS's named Medicaid MCO organization.","description":"Part of the MA spine (docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass. Status planned until accepted for serving.","identity_key":"plan_year,plan_segment_key,state_code","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_snp_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["CMS names the Medicaid organization only in its 2025 list edition; matching to the Medicaid spine is the cross-domain company id (not built)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":["plan_year"],"unmapped_key_tokens":["plan_segment_key"],"backing_store":"glue"},{"source_id":"ma_spine_plan_bid","source_fqn":"medicare_semantic.ma_spine_plan_bid_v20261012a","title":"MA spine: bid economics (derived, method published)","domain":"medicare","stage":"mart","status":"planned","grain":"One row per plan x payment year 2015-2024: standardized bid (A/B), rebate, rebate share, implied benchmark, ratebook benchmark at the bonus tier, bid-to-benchmark both ways.","description":"Part of the MA spine (docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass. Status planned until accepted for serving.","identity_key":"payment_year,contract_id,plan_id","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_plan_bid_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Derived: CMS does not publish bids. Regional PPO / PFFS / MSA follow other benchmark rules (flagged)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":[],"unmapped_key_tokens":["payment_year"],"backing_store":"glue"},{"source_id":"ma_spine_pdp_plan_year","source_fqn":"medicare_semantic.ma_spine_pdp_plan_year_v20261012a","title":"MA spine: stand-alone Part D plans (PDP) per year","domain":"medicare","stage":"mart","status":"planned","grain":"One row per PDP plan x year: September members, company as was / as now, region, premiums, deductible, benchmark, de minimis, LIS zero premium, formulary id.","description":"Part of the MA spine (docs/architecture/2026-10-12-ma-spine.md). Built by tools/ma_spine/, rails pass. Status planned until accepted for serving.","identity_key":"plan_year,contract_id,plan_id","row_count":null,"last_updated":"2026-10-12","recollection":{"cadence":"annual","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena: medicare_semantic.ma_spine_pdp_plan_year_v20261012a (planned: not in the queryable set until accepted)","provenance_chain_ref":"tools/ma_spine/ (docs/architecture/ma-spine/SOURCE-REGISTER.csv)","known_gaps":["Landscape lists individual PDPs only; employer PDPs carry members but no Landscape fields."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"ds_ma_spine","dataset_assignment_basis":"context_doc","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","cms:plan_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_monthly_enrollment_by_state","source_fqn":"medicare_silver.ma_pdp_enrollment_by_state_v1","title":"CMS Monthly Enrollment by State: Medicare eligibles and MA, other and PDP enrollment by state","domain":"medicare","stage":"silver","status":"live","grain":"One state or territory x report_month, as CMS totals it (eligibles, MA enrolled, other enrolled, PDP enrolled). 6,565 rows, 118 months 2016-10..2026-09 (Athena c59eb5a8, 2026-10-13).","description":"CMS's own monthly state totals of Medicare eligibles and of enrollees in Medicare Advantage, in 'other' plans (1876 Cost, PACE, demonstrations) and in stand-alone PDPs, per state and territory. The external state-level rail for CPSC county enrollment: it prints totals CPSC suppresses, and it carries eligibles, which CPSC does not.","identity_key":"report_month,state_code","row_count":6565,"last_updated":"2026-10-13","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_pdp_enrollment_by_state_v1","notes":"Registered 2026-10-13 by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13) after the cloud load of #3567: 6,565 rows = the dry run, months 2016-10..2026-09 less 2017-02/03 (Athena c59eb5a8). Door RAW, World W3.","superseded_by":null,"tools":[],"dataset_id":"cms_monthly_enrollment_by_state","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["report_month"],"backing_store":"glue"},{"source_id":"cms_ma_pdp_enrollment_by_state_county_contract","source_fqn":"medicare_silver.ma_pdp_enrollment_by_state_county_contract_v1","title":"CMS MA and PDP Enrollment by State/County/Contract (SCC), full version","domain":"medicare","stage":"silver","status":"live","grain":"One program (MA or PDP) x contract x county of residence x report_month, as CMS prints the full SCC file. 143,610,809 rows: MA 2006-10..2026-09, PDP 2007-01..2026-09, 240 distinct months (Athena c59eb5a8, 2026-10-13).","description":"CMS's monthly enrollment by contract and the enrollee's county of residence (the payment county, not the service area), for MA (incl. 1876 Cost, HCPP, PACE, MSA, PFFS, LI NET) and stand-alone PDP contracts, with organization type and plan type per contract-county. The full version keeps the rows of 10 or fewer as suppressed cells. Heavy: pin report_month.","identity_key":"report_month,program,contract_id,state_code,county_name,ssa_county_code,fips_county_code,plan_type","row_count":143610809,"last_updated":"2026-10-13","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_pdp_enrollment_by_state_county_contract_v1 (pin report_month; 143.6M rows)","notes":"Registered 2026-10-13 by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13) after the cloud load of #3567: 143,610,809 rows = the dry run (Athena c59eb5a8). Door RAW, World W3.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pdp_enrollment_by_state_county_contract","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","ssa:county","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"ssa:county":["ssa_county_code"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["county_name","fips_county_code","plan_type","program","report_month"],"backing_store":"glue"},{"source_id":"cms_ma_pdp_enrollment_by_state_county_plan_type","source_fqn":"medicare_silver.ma_pdp_enrollment_by_state_county_plan_type_v1","title":"CMS MA and PDP Enrollment by State/County/Plan Type (SCP)","domain":"medicare","stage":"silver","status":"live","grain":"One program (MA or PDP) x county x plan type x report_month. 3,048,097 rows, 120 months 2016-10..2026-09 (MA 118, PDP 119; Athena c59eb5a8, 2026-10-13).","description":"CMS's monthly county enrollment by plan type, MA and stand-alone PDP files: the county total with the least suppression CMS publishes (it suppresses at plan type x county, not contract x county).","identity_key":"report_month,program,state_code,county_name,ssa_county_code,fips_county_code,plan_type","row_count":3048097,"last_updated":"2026-10-13","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_pdp_enrollment_by_state_county_plan_type_v1","notes":"Registered 2026-10-13 by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13) after the cloud load of #3567: 3,048,097 rows = the dry run (Athena c59eb5a8). Door RAW, World W3.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pdp_enrollment_by_state_county_plan_type","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["ssa_county_code"],"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["county_name","fips_county_code","plan_type","program","report_month"],"backing_store":"glue"},{"source_id":"cms_ma_partd_agent_broker_compensation_limit","source_fqn":"medicare_silver.ma_partd_agent_broker_compensation_limit_v1","title":"CMS MA / Part D agent and broker compensation limits (FMV initial and renewal caps, referral fee caps), CY2019-CY2027","domain":"medicare","stage":"silver","status":"live","grain":"One plan_year x program (MA / PDP) x payment type (initial, renewal, referral) x jurisdiction x memo version. 118 rows CY2019-CY2027; CY2025 carries two memos (12 current + 12 superseded; Athena d2b07c0d, 2026-10-13).","description":"The most an MA organization, 1876 cost plan or PDP sponsor may pay an independent agent or broker each contract year, as CMS's annual HPMS memo prints it: fair market value for an initial enrollment, the renewal cap (at most 50% of FMV), and the referral/finder's fee cap; MA by jurisdiction (national; CT, PA, DC; CA, NJ; PR, VI), PDP national. Each row cites its memo, page and regulation. A regulatory ceiling, not what any plan pays.","identity_key":"plan_year,program,applies_to,payment_type,jurisdiction,doc_id","row_count":118,"last_updated":"2026-10-13","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_partd_agent_broker_compensation_limit_v1","notes":"Registered 2026-10-13 by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13) after the cloud load of #3557: 118 rows = the cited seed, re-read from bronze by an independent pypdf reader (Athena d2b07c0d). Door RAW, World W3.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_partd_agent_broker_compensation_limit","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["applies_to","doc_id","jurisdiction","payment_type","program"],"backing_store":"glue"},{"source_id":"cms_hhs_risk_adjustment_transfers_current","source_fqn":"medicare_semantic.vw_aca_risk_adjustment_transfer_current_v1","title":"HHS risk adjustment transfers by issuer, one report revision per benefit year and appendix (current view)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One amount cell of the current revision: (benefit_year, source_appendix, sheet_name, source_row_number, source_column_number). 14,415 rows BY2021-BY2025; BY2024 = 2,850 C + 57 D, the July 23, 2025 revision only (Athena af6735d5, 2026-10-13).","description":"The read surface over medicare_silver.fact_aca_risk_adjustment_transfer_history that cannot double count: per benefit year and appendix it keeps the highest cms_vintage_sequence, then the latest asserted_at (the BY2024 revision wins over the June 30 original). Same columns as the history table.","identity_key":"benefit_year,source_appendix,sheet_name,source_row_number,source_column_number","row_count":14415,"last_updated":"2026-10-13","freshness_sla":"Follows the history table: annual each June 30, revisions as CMS posts them.","recollection":{"cadence":"annual","watermark_field":"benefit_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'benefit_year' is the benefit year the transfers settle; a new revision of a benefit year replaces the old one in this view automatically, and the history table keeps both."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_aca_risk_adjustment_transfer_current_v1","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_hhs_risk_adjustment_transfers.json","known_gaps":["is_current is carried through from the history table and is FALSE on every row; never filter is_current = true (history_only in vlada/query/versioned_tables.json, so the door injects nothing).","Transfers are signed (positive = payment to the issuer, negative = charge) and net to about zero per state market risk pool: use the payments side or abs() for size.","A publisher dash is no enrollment in that pool: amount_status no_enrollment_in_pool, amount_usd NULL, never zero.","Pre-HHS-RADV amounts; Appendix E/F default charges are not here. Only BY2021-BY2025 (BY2014-2020 not header-reviewed)."],"notes":"View from #3564 (pipelines/medicare/semantic/aca_risk_adjustment_transfer_current_v1.sql), created by the coordinator; canary BY2024 C=2,850, D=57 (Athena af6735d5). Registered 2026-10-13 under register w4 cms_hhs_risk_adjustment_transfers by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_hhs_risk_adjustment_transfers","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["sheet_name","source_row_number"],"unmapped_key_tokens":["benefit_year","source_appendix","source_column_number"],"backing_store":"glue"},{"source_id":"cms_insurer_mlr_current","source_fqn":"insurer_silver.vw_insurer_mlr_current","title":"Commercial Insurer MLR: current read surface (financials joined to issuer identity)","domain":"commercial","stage":"semantic_view","status":"live","grain":"One row per (business_year, market, issuer submission) of the current vintage, with carrier group, name, EIN, HIOS id and business state; Grand Total rollup rows excluded. 18,818 rows RY2017-2024 (Athena c0257f5f, 2026-10-13).","description":"The semantic read surface over fact_insurer_mlr: the highest cms_vintage_sequence per (business_year, submission, market), joined to dim_insurer_mlr_identity, with derived loss_ratio, retention, PMPMs, the re-bought (admin, broker, sales, claims adjustment, cost containment, QI) and harvested (taxes, fees) splits and the underwriting-margin residual. Defined in ops/sql/vw_insurer_mlr_current.sql.","identity_key":"business_year,market,carrier_ein,hios_issuer_id,state","row_count":18818,"last_updated":"2026-10-13","freshness_sla":"Follows fact_insurer_mlr (annual CMS MLR PUF).","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["business_year is the MLR reporting year of the filing."]},"raw_queryable_via":"Athena (read-only via query_substrate): insurer_silver.vw_insurer_mlr_current","known_gaps":["underwriting_margin is a residual (retention less every itemized line), so it also absorbs anything the PUF does not itemize; it is not pure profit.","MLR is filed per issuer x state x market; one carrier group has many rows per year. Aggregate to the group with carrier_group, and never sum loss_ratio (recompute from premium and claims).","RY2011-2016 not held (gated); RY2025 posts about October 2026."],"notes":"Registered 2026-10-13 under register w4 cms_insurer_mlr_puf by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_insurer_mlr_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":["business_year"],"unmapped_key_tokens":["carrier_ein","hios_issuer_id","market"],"backing_store":"glue"},{"source_id":"cms_machine_readable_url_puf_redacted","source_fqn":"medicare_semantic.vw_machine_readable_url_puf_redacted_v1","title":"CMS CCIIO Machine Readable URL PUF, redacted: issuer index URLs per plan year, no contact fields","domain":"commercial","stage":"semantic_view","status":"live","grain":"One publisher worksheet row of the current artifact per business_year: state, HIOS issuer id, issuer name (PY2016 only), submitted URL. 4,045 rows PY2016-2026 (SELECT body run read-only, Athena a8f5a74e, 2026-10-13).","description":"The customer read surface for the Machine Readable URL PUF: the issuer-submitted machine-readable index URL per state and issuer per plan year, with every contact column (Tech POC Email) left out and the lossless raw_values_json / row hash not exposed. Defined in ops/sql/vw_machine_readable_url_puf_redacted_v1.sql.","identity_key":"business_year,artifact_id,sheet_name,source_row_number","row_count":4045,"last_updated":"2026-10-13","freshness_sla":"Follows the base table (annual plan-year PUF).","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the plan year of the PUF; a new header in a future year is not read until the view names it, so review the header list on every new plan year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_machine_readable_url_puf_redacted_v1","commercial_terms":"Public CMS/CCIIO data; contact fields are excluded from this view by design.","known_gaps":["A submitted URL is an issuer assertion, not proof the file is reachable; url_not_submitted marks CMS's NOT SUBMITTED sentinel (24 rows, PY2016).","issuer_name exists only in PY2016; join Plan Attributes on (business_year, hios_issuer_id) for names and geography.","The base table medicare_silver.fact_machine_readable_url_puf_history stays held at the door (versioned, so the is_current rule returns nothing) because its rows carry the Tech POC e-mail; read this view."],"notes":"SQL written 2026-10-13 by the Data Tracker registration lane (PR claude/tracker-registration-2026-10-13); the coordinator creates the view (ops/scripts/apply_athena_sql.py ops/sql/vw_machine_readable_url_puf_redacted_v1.sql --execute) before this registration merges. Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_machine_readable_url_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","sheet_name","source_row_number"],"unmapped_key_tokens":["artifact_id"],"backing_store":"glue"},{"source_id":"cms_exchange_plan_profile_v2","source_fqn":"medicare_silver.fact_exchange_plan_profile_v2","title":"Exchange Plan Profile v2: composed ACA marketplace plan brain, rebuilt from the CMS Rate PUF ZIPs","domain":"commercial","stage":"silver","status":"live","grain":"One row per (business_year, plan_id), unique: 60,591 plan-years PY2014-2026 (4,402 / 6,789 / 5,821 / 4,538 / 2,670 / 2,938 / 3,511 / 3,885 / 5,407 / 6,366 / 5,339 / 4,723 / 4,202; Athena 1c070757 and 72c4ad5e, 2026-10-13).","description":"The composed \"plan brain\" for the ACA marketplace, same 35 columns as fact_exchange_plan_profile: attributes (metal, type, on/off exchange, issuer, TIN) from Plan Attributes, premium benchmarks (age 21/40/60 min across rating areas, age-40 max) from the Rate PUF, network name, county footprint, covered-benefit counts and headline cost shares, CMS quality ratings and the issuer's individual-market MLR. Built reproducibly by tools/data_tracker/build_exchange_plan_profile.py (ops/sql/build_fact_exchange_plan_profile.sql, edition v2, #3579) with medicare_semantic.vw_rate_puf_current (the CMS ZIP history) as the Rate input in place of the truncated data.healthcare.gov mirror. Equal to v1 cell for cell in PY2014, 2016 and 2019-2025.","identity_key":"business_year,plan_id","row_count":60591,"last_updated":"2026-10-13","freshness_sla":"Rebuilt as a new _vN edition when a constituent PUF or the MLR PUF refreshes (annual plan-year cadence); never rewritten in place.","recollection":{"cadence":"derived","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the plan year a row describes, not the build date (2026-10-13).","Freshness is bounded by the constituent PUFs; a new plan year needs a new _vN edition (PLAN-PROFILE-BUILDER-2026-10-13.md, PY2027)."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_exchange_plan_profile_v2","provenance_chain_ref":"docs/data-tracker/marketplace/PLAN-PROFILE-BUILDER-2026-10-13.md","known_gaps":["WHAT CHANGED FROM v1 (compare, Athena d753adb1 / 70c9350c / 400b643c): PY2015 age-40 premium filled for 6,789 of 6,789 plans (v1 1,252; none of the 1,252 changed); PY2017 rate columns on 329 plans and PY2018 on 16 (NH 6, NJ 10) corrected from the CMS ZIPs (the mirror differed from CMS); PY2026 network_name on 19 plans and premium_age40_max on 18 MT plans from CMS's 2026-08-10 revision. No other cell moved.","Always pin business_year (the plan year). premium_age21/40/60 are the MIN across the plan's rating areas (premium_age40_max beside it); a specific rating area or age bucket comes from medicare_semantic.vw_rate_puf_current, where age is a string bucket ('0-14', '21', '64 and over').","PY2026 reflects CMS's 2026-08-10 repost of the Rate and Network PUFs, not the 2026-05-04 original.","Copays are parsed from raw text: null means unparseable or not covered, never $0. Quality only PY2023, 2024 and 2026; MLR only RY2019-2024 (the v2 edition widens neither). FFM states only.","No is_current column (unversioned at the door): one materialized edition per table; v1 (medicare_silver.fact_exchange_plan_profile) stays as the rollback."],"notes":"Built 2026-10-13 by the coordinator (ctas --edition v2, #3579; Athena be3aa33f). Registered 2026-10-13 under register w4 vlada_w4_exchange_plan_profile as the successor of fact_exchange_plan_profile by the Data Tracker registration lane (PR claude/tracker-register-profile-v2-rate-history). get_exchange_plan_profile reads it after the MCP lane's repoint (#3588). Door BOTH, World W4.","superseded_by":null,"tools":["get_exchange_plan_profile"],"dataset_id":"vlada_w4_exchange_plan_profile","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:plan_id"],"entity_key_columns":{"cms:plan_id":["plan_id"]},"technical_keys":["business_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"cms_rate_puf_current","source_fqn":"medicare_semantic.vw_rate_puf_current","title":"CMS CCIIO Rate PUF: current read surface (one CMS ZIP revision per plan year)","domain":"commercial","stage":"semantic_view","status":"live","grain":"One publisher record of the selected revision per business_year: plan x rating area x age x tobacco x rate-effective period. 36,535,872 rows PY2014-2026, one revision per year (Athena 5189dd09, 2026-10-13).","description":"The read surface over medicare_silver.fact_rate_puf_history: for each business_year it keeps one CMS ZIP revision (cms_vintage_sequence DESC, then asserted_at DESC), with typed rates (individual, tobacco, family tiers), the raw record and Bronze lineage. Defined in pipelines/medicare/semantic/rate_puf_current.sql. Successor of medicare_silver.fact_rate_puf: PY2015 is complete (4,676,092 rows, 37 states, against the mirror's 1,048,575 rows in 6 states) and PY2017/PY2018 follow CMS, not the mirror.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":36535872,"last_updated":"2026-10-13","freshness_sla":"Follows the history table: annual plan-year PUF, with CMS reposts (e.g. PY2026 2026-08-10) selected automatically.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the plan year; a CMS repost of a plan year becomes a new revision in the history table and replaces the old one in this view."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_rate_puf_current (pin business_year)","commercial_terms":"Public CMS/CCIIO data; redistribution subject to official source terms.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_rate_puf_history_manifest.json","known_gaps":["ALWAYS pin business_year: 1.9-4.7M rows per plan year.","age is a string bucket, never cast it to a number: '21'..'63' every year; '0-14', '15'..'20' and '64 and over' in 9 plan years, '0-20', '64' and '65 and over' in the other 4; 'Family Option' rows carry the family tiers (Athena 64e88bc1). rating_area_id is the CCIIO rating area, not a county.","PY2026 is CMS's 2026-08-10 repost (publisher_modified_at 2026-08-10T14:02:01Z), not the 2026-05-04 original (Athena 9f28c104).","Premiums (what the member pays for the plan), not provider payment rates.","The selected revision keeps the publisher's own exact repeats (PY2014 32,022 extra rows): 36,535,872 rows, 36,498,054 distinct (business_year, plan_id, rating_area_id, age, tobacco, rate_effective_date) (Athena 97e6587e). Aggregate explicitly when one premium per cell is needed.","plan_id is the 14-character base plan; joining every 17-character Plan Attributes variant fans out.","No is_current column (unversioned at the door): the view already selects one revision per business_year; never add an is_current filter."],"notes":"View from #3568/#3576 (pipelines/medicare/semantic/rate_puf_current.sql) over the CMS ZIP history. Registered 2026-10-13 under register w4 cms_cciio_rate_puf as the successor of medicare_silver.fact_rate_puf by the Data Tracker registration lane (PR claude/tracker-register-profile-v2-rate-history). get_exchange_plan_profile's rate curve reads it after #3588. Door RAW, World W4.","superseded_by":null,"tools":["get_exchange_plan_profile"],"dataset_id":"cms_cciio_rate_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_rate_puf_history","source_fqn":"medicare_silver.fact_rate_puf_history","title":"CMS CCIIO Rate PUF: lossless revision history from the CMS ZIPs, PY2014-2026","domain":"commercial","stage":"silver","status":"live","grain":"One publisher CSV record per CMS ZIP revision: (business_year, archive_member_sha256, source_row_number). 36,535,872 rows, PY2014-2026, one revision per business_year today (3,796,388 / 4,676,092 / 4,171,845 / 3,098,756 / 2,287,807 / 1,968,926 / 1,886,351 / 2,136,450 / 2,498,402 / 2,752,441 / 2,608,212 / 2,418,441 / 2,235,761; Athena 7aa09831, 2026-10-13).","description":"Append-only, lossless history of the CMS Exchange Rate PUF read from the 13 official CMS ZIPs (pipelines/medicare/silver/rate_puf_history_writer.py, #3568/#3576): typed rates beside raw_values_json, header hash, schema era, archive member and Bronze lineage on every row. Replaces the data.healthcare.gov mirror behind medicare_silver.fact_rate_puf. Read it through medicare_semantic.vw_rate_puf_current unless you need a specific revision.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":36535872,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year PUF; each CMS repost is appended as a new revision (never replaced).","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the plan year; asserted_at and publisher_modified_at date each CMS revision."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_rate_puf_history (pin business_year; prefer vw_rate_puf_current)","commercial_terms":"Public CMS/CCIIO data; redistribution subject to official source terms.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/manifests/cms_rate_puf_history_manifest.json","known_gaps":["is_current is FALSE on every row by writer contract (36,535,872 of 36,535,872, Athena 91f64ddd; history_only at the door); never filter is_current = true. Pick a revision with cms_vintage_sequence / asserted_at, or read vw_rate_puf_current.","ALWAYS pin business_year: 1.9-4.7M rows per plan year.","age is a string bucket, never cast it to a number: '21'..'63' every year; '0-14', '15'..'20' and '64 and over' in 9 plan years, '0-20', '64' and '65 and over' in the other 4; 'Family Option' rows carry the family tiers (Athena 64e88bc1). rating_area_id is the CCIIO rating area, not a county.","PY2026 is CMS's 2026-08-10 repost (publisher_modified_at 2026-08-10T14:02:01Z), not the 2026-05-04 original (Athena 9f28c104).","Premiums (what the member pays for the plan), not provider payment rates.","The selected revision keeps the publisher's own exact repeats (PY2014 32,022 extra rows): 36,535,872 rows, 36,498,054 distinct (business_year, plan_id, rating_area_id, age, tobacco, rate_effective_date) (Athena 97e6587e). Aggregate explicitly when one premium per cell is needed.","plan_id is the 14-character base plan; joining every 17-character Plan Attributes variant fans out."],"notes":"Loaded from the CMS ZIPs by #3568/#3576 (one revision per business_year, source_id cms_rate_puf only). Registered 2026-10-13 under register w4 cms_cciio_rate_puf by the Data Tracker registration lane (PR claude/tracker-register-profile-v2-rate-history). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_rate_puf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_sbe_plan_attributes_puf_history","source_fqn":"medicare_silver.fact_sbe_plan_attributes_puf_history","title":"CMS independent state-based exchange Plan Attributes PUF: lossless history, PY2016-2026","domain":"commercial","stage":"silver","status":"live","grain":"One publisher CSV record per CMS SBE package member: (business_year, state, archive_member_sha256, source_row_number). 113,005 rows, PY2016-2026 (10,489 / 8,464 / 7,457 / 7,318 / 8,348 / 10,253 / 12,554 / 10,850 / 11,728 / 12,327 / 13,217; 17, 16, 14, 14, 15, 17, 19, 19, 20, 21, 22 states; Athena 4f7c541b, 9f6177ba, 2026-10-13).","description":"Plan Attributes for the states that run their own exchange (not HealthCare.gov), from CMS's state-based PUF packages: one row per plan variant with standard_component_id, plan_id, issuer, market (Individual and SHOP), metal level, plan type, network and service area ids, plan-level deductibles, MOOPs and SBC scenarios inside raw_values_json, beside the lossless raw record and Bronze lineage. Parsed with the federal Plan Attributes parser (header-driven) plus a reviewed spelling-only header alias table.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":113005,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year packages (PY2027 expected spring-summer 2027); a changed CMS ZIP is captured byte-exact to bronze and appended as a new revision, never replaced.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the package plan year on the CMS page, not a revision timestamp; asserted_at dates each captured revision."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_sbe_plan_attributes_puf_history (pin business_year and state_code; never filter is_current)","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_independent_sbe_packages.json","known_gaps":["FEDERAL AND SBE ARE SEPARATE TABLES: for 51-state coverage union this table with the federal current view of the same family (medicare_semantic.vw_plan_attributes_puf_current); together they hold 51 of 51 jurisdictions every plan year PY2016-2026 (Plan Attributes, Athena ce4ab83f). 22 state-years appear in BOTH (AR, MS, OR, UT PY2016-17; NM PY2018-21; AR PY2019; OR PY2016-26; Athena 3765ab4c, a557f524): there the SBE package is the state's own SHOP (small-group) exchange and the federal PUF the individual market, so no state-year pairs the same market (Plan Attributes 0 same-market state-years, 0 shared standard_component_id; Athena a8803040, 4bfd6e2c). Exception: the PY2019 AR, NM and OR SBE Rate files also repeat 172 federal individual-market plans (AR 34, NM 66, OR 72; 36,975 SBE rows; Athena 617f479b, 061c8bce), and issuers, service areas and networks repeat across both. Never count a state-year twice: count states with DISTINCT (business_year, trim(state_code)), filter market_coverage, and dedupe plans on (business_year, plan_id) before a union total.","Market: 173 SBE state-years carry Individual plans and 156 carry SHOP (small group) plans (Athena 47fdc0c3); filter market_coverage. AR PY2019's Plan file was published empty.","is_current is FALSE on every row by writer contract (history_only at the door); never filter is_current = true. One CMS ZIP member per (business_year, state, family) today, so read by business_year and state_code; a later CMS repost is appended as a new archive_member_sha256 beside the old one.","SBE plan files only exist from PY2016: CMS published no state-based exchange package for PY2014-PY2015 (29 SBE state-years have no plan-level CMS file).","publisher_etag is NULL on every row and publisher_modified_at on some rows (CMS's state-based PUF page serves no ETag for these ZIPs); sha256_content_hash with archive_member_sha256 is the identity, never the ETag.","state_code (and market_coverage) carry trailing blanks in some PY2018 files (Benefits 465,902 rows, Business Rules 13,883, Service Area 19,977; Athena c215378a, e9694ced, 5a7b9ece): trim(state_code) before grouping or joining.","Still gated, not loaded: MA PY2017 Service Area (row 1 is an entire-state row that also lists ZIPs; fails closed until a rule) and the WA PY2018 original Plan file (12 records split by unquoted line breaks). WA PY2018 plans are held from the round3 revision (197 rows).","Publisher absences and empty members are first-class, not zero: e.g. CA Business Rules absent PY2016-2021 and empty PY2022-2026; VT Service Area and Network absent PY2016-2021 and empty PY2022-2025; DC Service Area absent PY2016-2020."],"notes":"Loaded 2026-10-13 by the coordinator through pipelines/medicare/ingest/independent_sbe_puf_runner.py --write (proof cell tracker-runs/20261013T051002Z-b7981e0c; full load 20261013T051148Z-b7981e0c committed 1,125 cells; re-run 20261013T074520Z-b7981e0c committed 0 and skipped 1,126 held cells). Sibling of the federal family table: federal column set + source_id cms_independent_sbe_packages, family identity in vintage_tag. Registered 2026-10-13 under register w4 cms_independent_sbe_packages by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_independent_sbe_packages","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_sbe_benefits_cost_sharing_puf_history","source_fqn":"medicare_silver.fact_sbe_benefits_cost_sharing_puf_history","title":"CMS independent state-based exchange Benefits and Cost Sharing PUF: lossless history, PY2016-2026","domain":"commercial","stage":"silver","status":"live","grain":"One publisher CSV record per CMS SBE package member: (business_year, state, archive_member_sha256, source_row_number). 8,401,524 rows, PY2016-2026 (826,084 / 607,958 / 465,902 / 592,897 / 633,953 / 762,909 / 932,995 / 808,079 / 870,855 / 913,471 / 986,421; Athena 602bb22e, 4d0b683d, 2026-10-13).","description":"Benefits and Cost Sharing for the independent state-based exchanges: one row per plan variant and benefit with coverage, EHB, state-mandate, quantity-limit and exclusion fields, from CMS's SBE template, kept losslessly (raw_values_json + ordered_header_json) with Bronze lineage.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":8401524,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year packages (PY2027 expected spring-summer 2027); a changed CMS ZIP is captured byte-exact to bronze and appended as a new revision, never replaced.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the package plan year on the CMS page, not a revision timestamp; asserted_at dates each captured revision."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_sbe_benefits_cost_sharing_puf_history (pin business_year and state_code; never filter is_current)","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_independent_sbe_packages.json","known_gaps":["FEDERAL AND SBE ARE SEPARATE TABLES: for 51-state coverage union this table with the federal current view of the same family (medicare_semantic.vw_benefits_cost_sharing_current); together they hold 51 of 51 jurisdictions every plan year PY2016-2026 (Plan Attributes, Athena ce4ab83f). 22 state-years appear in BOTH (AR, MS, OR, UT PY2016-17; NM PY2018-21; AR PY2019; OR PY2016-26; Athena 3765ab4c, a557f524): there the SBE package is the state's own SHOP (small-group) exchange and the federal PUF the individual market, so no state-year pairs the same market (Plan Attributes 0 same-market state-years, 0 shared standard_component_id; Athena a8803040, 4bfd6e2c). Exception: the PY2019 AR, NM and OR SBE Rate files also repeat 172 federal individual-market plans (AR 34, NM 66, OR 72; 36,975 SBE rows; Athena 617f479b, 061c8bce), and issuers, service areas and networks repeat across both. Never count a state-year twice: count states with DISTINCT (business_year, trim(state_code)), filter market_coverage, and dedupe plans on (business_year, plan_id) before a union total.","NO COPAY OR COINSURANCE: the SBE Benefits template carries no copay or coinsurance columns, so copay_*_raw and coins_*_raw are NULL on 8,401,524 of 8,401,524 rows (Athena cd87ec1e). Georgia PY2025-26 is the only SBE state with benefit-level cost sharing, through its own Georgia Access direct exports (source ga_georgia_access_puf), not this table. Plan-level deductibles and MOOPs are in the Plan Attributes table (medicare_silver.fact_sbe_plan_attributes_puf_history).","Heavy: 8.4M rows; pin business_year and state_code.","is_current is FALSE on every row by writer contract (history_only at the door); never filter is_current = true. One CMS ZIP member per (business_year, state, family) today, so read by business_year and state_code; a later CMS repost is appended as a new archive_member_sha256 beside the old one.","SBE plan files only exist from PY2016: CMS published no state-based exchange package for PY2014-PY2015 (29 SBE state-years have no plan-level CMS file).","publisher_etag is NULL on every row and publisher_modified_at on some rows (CMS's state-based PUF page serves no ETag for these ZIPs); sha256_content_hash with archive_member_sha256 is the identity, never the ETag.","state_code (and market_coverage) carry trailing blanks in some PY2018 files (Benefits 465,902 rows, Business Rules 13,883, Service Area 19,977; Athena c215378a, e9694ced, 5a7b9ece): trim(state_code) before grouping or joining.","Still gated, not loaded: MA PY2017 Service Area (row 1 is an entire-state row that also lists ZIPs; fails closed until a rule) and the WA PY2018 original Plan file (12 records split by unquoted line breaks). WA PY2018 plans are held from the round3 revision (197 rows).","Publisher absences and empty members are first-class, not zero: e.g. CA Business Rules absent PY2016-2021 and empty PY2022-2026; VT Service Area and Network absent PY2016-2021 and empty PY2022-2025; DC Service Area absent PY2016-2020."],"notes":"Loaded 2026-10-13 by the coordinator through pipelines/medicare/ingest/independent_sbe_puf_runner.py --write (proof cell tracker-runs/20261013T051002Z-b7981e0c; full load 20261013T051148Z-b7981e0c committed 1,125 cells; re-run 20261013T074520Z-b7981e0c committed 0 and skipped 1,126 held cells). Sibling of the federal family table: federal column set + source_id cms_independent_sbe_packages, family identity in vintage_tag. Registered 2026-10-13 under register w4 cms_independent_sbe_packages by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_independent_sbe_packages","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_sbe_business_rules_puf_history","source_fqn":"medicare_silver.fact_sbe_business_rules_puf_history","title":"CMS independent state-based exchange Business Rules PUF: lossless history, PY2016-2026","domain":"commercial","stage":"silver","status":"live","grain":"One publisher CSV record per CMS SBE package member: (business_year, state, archive_member_sha256, source_row_number). 219,047 rows, PY2016-2026 (11,229 / 8,673 / 13,883 / 27,880 / 24,035 / 15,997 / 13,547 / 24,345 / 23,602 / 28,102 / 27,754; Athena 602bb22e, 541de06f, 2026-10-13).","description":"Business Rules (age determination, dependent and cohabitation rules per issuer product) for the independent state-based exchanges, from CMS's SBE packages, kept losslessly with Bronze lineage.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":219047,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year packages (PY2027 expected spring-summer 2027); a changed CMS ZIP is captured byte-exact to bronze and appended as a new revision, never replaced.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the package plan year on the CMS page, not a revision timestamp; asserted_at dates each captured revision."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_sbe_business_rules_puf_history (pin business_year and state_code; never filter is_current)","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_independent_sbe_packages.json","known_gaps":["FEDERAL AND SBE ARE SEPARATE TABLES: for 51-state coverage union this table with the federal current view of the same family (medicare_semantic.vw_business_rules_puf_current); together they hold 51 of 51 jurisdictions every plan year PY2016-2026 (Plan Attributes, Athena ce4ab83f). 22 state-years appear in BOTH (AR, MS, OR, UT PY2016-17; NM PY2018-21; AR PY2019; OR PY2016-26; Athena 3765ab4c, a557f524): there the SBE package is the state's own SHOP (small-group) exchange and the federal PUF the individual market, so no state-year pairs the same market (Plan Attributes 0 same-market state-years, 0 shared standard_component_id; Athena a8803040, 4bfd6e2c). Exception: the PY2019 AR, NM and OR SBE Rate files also repeat 172 federal individual-market plans (AR 34, NM 66, OR 72; 36,975 SBE rows; Athena 617f479b, 061c8bce), and issuers, service areas and networks repeat across both. Never count a state-year twice: count states with DISTINCT (business_year, trim(state_code)), filter market_coverage, and dedupe plans on (business_year, plan_id) before a union total.","Fewer states than the other families: CA Business Rules are absent PY2016-2021 and empty PY2022-2026, AR PY2016 and MD PY2020 absent, MD PY2018-2019 empty.","is_current is FALSE on every row by writer contract (history_only at the door); never filter is_current = true. One CMS ZIP member per (business_year, state, family) today, so read by business_year and state_code; a later CMS repost is appended as a new archive_member_sha256 beside the old one.","SBE plan files only exist from PY2016: CMS published no state-based exchange package for PY2014-PY2015 (29 SBE state-years have no plan-level CMS file).","publisher_etag is NULL on every row and publisher_modified_at on some rows (CMS's state-based PUF page serves no ETag for these ZIPs); sha256_content_hash with archive_member_sha256 is the identity, never the ETag.","state_code (and market_coverage) carry trailing blanks in some PY2018 files (Benefits 465,902 rows, Business Rules 13,883, Service Area 19,977; Athena c215378a, e9694ced, 5a7b9ece): trim(state_code) before grouping or joining.","Still gated, not loaded: MA PY2017 Service Area (row 1 is an entire-state row that also lists ZIPs; fails closed until a rule) and the WA PY2018 original Plan file (12 records split by unquoted line breaks). WA PY2018 plans are held from the round3 revision (197 rows).","Publisher absences and empty members are first-class, not zero: e.g. CA Business Rules absent PY2016-2021 and empty PY2022-2026; VT Service Area and Network absent PY2016-2021 and empty PY2022-2025; DC Service Area absent PY2016-2020."],"notes":"Loaded 2026-10-13 by the coordinator through pipelines/medicare/ingest/independent_sbe_puf_runner.py --write (proof cell tracker-runs/20261013T051002Z-b7981e0c; full load 20261013T051148Z-b7981e0c committed 1,125 cells; re-run 20261013T074520Z-b7981e0c committed 0 and skipped 1,126 held cells). Sibling of the federal family table: federal column set + source_id cms_independent_sbe_packages, family identity in vintage_tag. Registered 2026-10-13 under register w4 cms_independent_sbe_packages by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_independent_sbe_packages","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_sbe_service_area_puf_history","source_fqn":"medicare_silver.fact_sbe_service_area_puf_history","title":"CMS independent state-based exchange Service Area PUF: lossless history, PY2016-2026","domain":"commercial","stage":"silver","status":"live","grain":"One publisher CSV record per CMS SBE package member: (business_year, state, archive_member_sha256, source_row_number). 115,672 rows, PY2016-2026 (20,720 / 19,973 / 19,977 / 4,982 / 3,493 / 4,483 / 4,746 / 4,856 / 9,457 / 11,326 / 11,659; Athena 602bb22e, c319e6ba, 2026-10-13).","description":"Service areas (issuer x service area x county or ZIP) for the independent state-based exchanges, from CMS's SBE packages, with the documented normalizations beside the published values (county_raw, zip_codes_raw).","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":115672,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year packages (PY2027 expected spring-summer 2027); a changed CMS ZIP is captured byte-exact to bronze and appended as a new revision, never replaced.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the package plan year on the CMS page, not a revision timestamp; asserted_at dates each captured revision."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_sbe_service_area_puf_history (pin business_year and state_code; never filter is_current)","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_independent_sbe_packages.json","known_gaps":["FEDERAL AND SBE ARE SEPARATE TABLES: for 51-state coverage union this table with the federal current view of the same family (medicare_semantic.vw_service_area_puf_current); together they hold 51 of 51 jurisdictions every plan year PY2016-2026 (Plan Attributes, Athena ce4ab83f). 22 state-years appear in BOTH (AR, MS, OR, UT PY2016-17; NM PY2018-21; AR PY2019; OR PY2016-26; Athena 3765ab4c, a557f524): there the SBE package is the state's own SHOP (small-group) exchange and the federal PUF the individual market, so no state-year pairs the same market (Plan Attributes 0 same-market state-years, 0 shared standard_component_id; Athena a8803040, 4bfd6e2c). Exception: the PY2019 AR, NM and OR SBE Rate files also repeat 172 federal individual-market plans (AR 34, NM 66, OR 72; 36,975 SBE rows; Athena 617f479b, 061c8bce), and issuers, service areas and networks repeat across both. Never count a state-year twice: count states with DISTINCT (business_year, trim(state_code)), filter market_coverage, and dedupe plans on (business_year, plan_id) before a union total.","DOCUMENTED TRANSFORMS (raw kept beside each): CoverEntireState and PartialCounty true/false map to Yes/No; County is parsed from 'Name - FIPS' and from bare codes (state FIPS + code, zero-padded) and accepted only when that county belongs to the row state in vlada_curated.dim_geography (county_fips_normalized; county_raw keeps the text); 4-digit ZIPs are left-padded to 5 only in states whose ZIPs all start with 0 (this cleared MA PY2021-2022; zip_codes_raw keeps the published value); the literal 'NULL' token becomes NULL in partial_county.","MA PY2017 Service Area is not loaded (gated); DC PY2016-2020 and VT PY2016-2021 absent, VT PY2022-2025 empty.","is_current is FALSE on every row by writer contract (history_only at the door); never filter is_current = true. One CMS ZIP member per (business_year, state, family) today, so read by business_year and state_code; a later CMS repost is appended as a new archive_member_sha256 beside the old one.","SBE plan files only exist from PY2016: CMS published no state-based exchange package for PY2014-PY2015 (29 SBE state-years have no plan-level CMS file).","publisher_etag is NULL on every row and publisher_modified_at on some rows (CMS's state-based PUF page serves no ETag for these ZIPs); sha256_content_hash with archive_member_sha256 is the identity, never the ETag.","state_code (and market_coverage) carry trailing blanks in some PY2018 files (Benefits 465,902 rows, Business Rules 13,883, Service Area 19,977; Athena c215378a, e9694ced, 5a7b9ece): trim(state_code) before grouping or joining.","Still gated, not loaded: MA PY2017 Service Area (row 1 is an entire-state row that also lists ZIPs; fails closed until a rule) and the WA PY2018 original Plan file (12 records split by unquoted line breaks). WA PY2018 plans are held from the round3 revision (197 rows).","Publisher absences and empty members are first-class, not zero: e.g. CA Business Rules absent PY2016-2021 and empty PY2022-2026; VT Service Area and Network absent PY2016-2021 and empty PY2022-2025; DC Service Area absent PY2016-2020."],"notes":"Loaded 2026-10-13 by the coordinator through pipelines/medicare/ingest/independent_sbe_puf_runner.py --write (proof cell tracker-runs/20261013T051002Z-b7981e0c; full load 20261013T051148Z-b7981e0c committed 1,125 cells; re-run 20261013T074520Z-b7981e0c committed 0 and skipped 1,126 held cells). Sibling of the federal family table: federal column set + source_id cms_independent_sbe_packages, family identity in vintage_tag. Registered 2026-10-13 under register w4 cms_independent_sbe_packages by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_independent_sbe_packages","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_sbe_network_puf_history","source_fqn":"medicare_silver.fact_sbe_network_puf_history","title":"CMS independent state-based exchange Network PUF: lossless history, PY2016-2026","domain":"commercial","stage":"silver","status":"live","grain":"One publisher CSV record per CMS SBE package member: (business_year, state, archive_member_sha256, source_row_number). 5,292 rows, PY2016-2026 (460 / 396 / 353 / 610 / 744 / 465 / 452 / 442 / 440 / 454 / 476; Athena 602bb22e, 76eaed22, 2026-10-13).","description":"Provider network names, ids and URLs per issuer for the independent state-based exchanges, from CMS's SBE packages, kept losslessly with Bronze lineage.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":5292,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year packages (PY2027 expected spring-summer 2027); a changed CMS ZIP is captured byte-exact to bronze and appended as a new revision, never replaced.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the package plan year on the CMS page, not a revision timestamp; asserted_at dates each captured revision."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_sbe_network_puf_history (pin business_year and state_code; never filter is_current)","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_independent_sbe_packages.json","known_gaps":["FEDERAL AND SBE ARE SEPARATE TABLES: for 51-state coverage union this table with the federal current view of the same family (medicare_semantic.vw_network_puf_current); together they hold 51 of 51 jurisdictions every plan year PY2016-2026 (Plan Attributes, Athena ce4ab83f). 22 state-years appear in BOTH (AR, MS, OR, UT PY2016-17; NM PY2018-21; AR PY2019; OR PY2016-26; Athena 3765ab4c, a557f524): there the SBE package is the state's own SHOP (small-group) exchange and the federal PUF the individual market, so no state-year pairs the same market (Plan Attributes 0 same-market state-years, 0 shared standard_component_id; Athena a8803040, 4bfd6e2c). Exception: the PY2019 AR, NM and OR SBE Rate files also repeat 172 federal individual-market plans (AR 34, NM 66, OR 72; 36,975 SBE rows; Athena 617f479b, 061c8bce), and issuers, service areas and networks repeat across both. Never count a state-year twice: count states with DISTINCT (business_year, trim(state_code)), filter market_coverage, and dedupe plans on (business_year, plan_id) before a union total.","A network URL is the issuer's assertion, not proof the directory is reachable. VT PY2016-2021 absent and PY2022-2025 empty.","is_current is FALSE on every row by writer contract (history_only at the door); never filter is_current = true. One CMS ZIP member per (business_year, state, family) today, so read by business_year and state_code; a later CMS repost is appended as a new archive_member_sha256 beside the old one.","SBE plan files only exist from PY2016: CMS published no state-based exchange package for PY2014-PY2015 (29 SBE state-years have no plan-level CMS file).","publisher_etag is NULL on every row and publisher_modified_at on some rows (CMS's state-based PUF page serves no ETag for these ZIPs); sha256_content_hash with archive_member_sha256 is the identity, never the ETag.","state_code (and market_coverage) carry trailing blanks in some PY2018 files (Benefits 465,902 rows, Business Rules 13,883, Service Area 19,977; Athena c215378a, e9694ced, 5a7b9ece): trim(state_code) before grouping or joining.","Still gated, not loaded: MA PY2017 Service Area (row 1 is an entire-state row that also lists ZIPs; fails closed until a rule) and the WA PY2018 original Plan file (12 records split by unquoted line breaks). WA PY2018 plans are held from the round3 revision (197 rows).","Publisher absences and empty members are first-class, not zero: e.g. CA Business Rules absent PY2016-2021 and empty PY2022-2026; VT Service Area and Network absent PY2016-2021 and empty PY2022-2025; DC Service Area absent PY2016-2020."],"notes":"Loaded 2026-10-13 by the coordinator through pipelines/medicare/ingest/independent_sbe_puf_runner.py --write (proof cell tracker-runs/20261013T051002Z-b7981e0c; full load 20261013T051148Z-b7981e0c committed 1,125 cells; re-run 20261013T074520Z-b7981e0c committed 0 and skipped 1,126 held cells). Sibling of the federal family table: federal column set + source_id cms_independent_sbe_packages, family identity in vintage_tag. Registered 2026-10-13 under register w4 cms_independent_sbe_packages by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_independent_sbe_packages","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_sbe_rate_puf_history","source_fqn":"medicare_silver.fact_sbe_rate_puf_history","title":"CMS independent state-based exchange Rate PUF: lossless history, PY2016-2026","domain":"commercial","stage":"silver","status":"live","grain":"One publisher CSV record per CMS SBE package member: (business_year, state, archive_member_sha256, source_row_number). 12,056,664 rows, PY2016-2026 (907,348 / 658,932 / 750,732 / 1,615,006 / 1,501,958 / 1,189,365 / 1,001,714 / 996,686 / 1,042,210 / 1,211,449 / 1,181,264; Athena 6ccbb983, 4f9d969a, 2026-10-13).","description":"Premium rates (plan x rating area x age x tobacco, with family tiers) for the independent state-based exchanges, from CMS's SBE packages, typed beside the lossless raw record (numeric_parse_status_json) and Bronze lineage.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":12056664,"last_updated":"2026-10-13","freshness_sla":"Annual plan-year packages (PY2027 expected spring-summer 2027); a changed CMS ZIP is captured byte-exact to bronze and appended as a new revision, never replaced.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the package plan year on the CMS page, not a revision timestamp; asserted_at dates each captured revision."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_sbe_rate_puf_history (pin business_year and state_code; never filter is_current)","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_independent_sbe_packages.json","known_gaps":["FEDERAL AND SBE ARE SEPARATE TABLES: for 51-state coverage union this table with the federal current view of the same family (medicare_semantic.vw_rate_puf_current); together they hold 51 of 51 jurisdictions every plan year PY2016-2026 (Plan Attributes, Athena ce4ab83f). 22 state-years appear in BOTH (AR, MS, OR, UT PY2016-17; NM PY2018-21; AR PY2019; OR PY2016-26; Athena 3765ab4c, a557f524): there the SBE package is the state's own SHOP (small-group) exchange and the federal PUF the individual market, so no state-year pairs the same market (Plan Attributes 0 same-market state-years, 0 shared standard_component_id; Athena a8803040, 4bfd6e2c). Exception: the PY2019 AR, NM and OR SBE Rate files also repeat 172 federal individual-market plans (AR 34, NM 66, OR 72; 36,975 SBE rows; Athena 617f479b, 061c8bce), and issuers, service areas and networks repeat across both. Never count a state-year twice: count states with DISTINCT (business_year, trim(state_code)), filter market_coverage, and dedupe plans on (business_year, plan_id) before a union total.","Heavy: 12.1M rows; ALWAYS pin business_year and state_code. Premiums (what the member pays), not provider payment rates. age is a string bucket ('0-14', '21', '64 and over'), never a number; rating_area_id is the state's rating area, not a county.","is_current is FALSE on every row by writer contract (history_only at the door); never filter is_current = true. One CMS ZIP member per (business_year, state, family) today, so read by business_year and state_code; a later CMS repost is appended as a new archive_member_sha256 beside the old one.","SBE plan files only exist from PY2016: CMS published no state-based exchange package for PY2014-PY2015 (29 SBE state-years have no plan-level CMS file).","publisher_etag is NULL on every row and publisher_modified_at on some rows (CMS's state-based PUF page serves no ETag for these ZIPs); sha256_content_hash with archive_member_sha256 is the identity, never the ETag.","state_code (and market_coverage) carry trailing blanks in some PY2018 files (Benefits 465,902 rows, Business Rules 13,883, Service Area 19,977; Athena c215378a, e9694ced, 5a7b9ece): trim(state_code) before grouping or joining.","Still gated, not loaded: MA PY2017 Service Area (row 1 is an entire-state row that also lists ZIPs; fails closed until a rule) and the WA PY2018 original Plan file (12 records split by unquoted line breaks). WA PY2018 plans are held from the round3 revision (197 rows).","Publisher absences and empty members are first-class, not zero: e.g. CA Business Rules absent PY2016-2021 and empty PY2022-2026; VT Service Area and Network absent PY2016-2021 and empty PY2022-2025; DC Service Area absent PY2016-2020."],"notes":"Loaded 2026-10-13 by the coordinator through pipelines/medicare/ingest/independent_sbe_puf_runner.py --write (proof cell tracker-runs/20261013T051002Z-b7981e0c; full load 20261013T051148Z-b7981e0c committed 1,125 cells; re-run 20261013T074520Z-b7981e0c committed 0 and skipped 1,126 held cells). Sibling of the federal family table: federal column set + source_id cms_independent_sbe_packages, family identity in vintage_tag. Registered 2026-10-13 under register w4 cms_independent_sbe_packages by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_independent_sbe_packages","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_quality_puf_current","source_fqn":"medicare_semantic.vw_quality_puf_current","title":"CMS Marketplace Quality PUF: current read surface (one CMS artifact per plan year)","domain":"commercial","stage":"semantic_view","status":"live","grain":"One publisher row of the selected data unit per business_year: 35,752 rows PY2017-2026, one CMS artifact per business_year (830 / 553 / 768 / 3,511 / 3,885 / 5,407 / 6,378 / 5,395 / 4,723 / 4,302; Athena 7678a908, 2026-10-13).","description":"The read surface over medicare_silver.fact_quality_puf_history (append-only): for each business_year it keeps one CMS data unit (cms_vintage_sequence DESC, then asserted_at DESC, then archive member as tie-breakers) and returns its publisher rows unchanged (raw_values_json keyed by ordered_header_json). Defined in pipelines/medicare/semantic/quality_puf_current.sql (#3583). A later CMS repost of a plan year replaces the earlier artifact here and stays in the history table.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":35752,"last_updated":"2026-10-13","freshness_sla":"Follows the history table: annual plan-year PUF; a CMS repost is selected automatically.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the publication plan year, not the measurement year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_quality_puf_current (pin business_year)","commercial_terms":"Public CMS/CCIIO data; redistribution subject to official source terms.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_marketplace_quality_puf.json","known_gaps":["is_current is FALSE on every row: the view selects history rows as they are, so it is history_only at the door and no current filter is injected; never filter is_current = true.","Pin business_year: the header changes across plan years, so look cells up by header name in ordered_header_json, never by position.","Not every plan is rated; absence is not a low rating. The publication plan year is not the measurement year."],"notes":"View from #3583, created 2026-10-13 by the coordinator. Registered 2026-10-13 under its source's w4 register card as the current read surface by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_quality_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_nationwide_qrs_puf_current","source_fqn":"medicare_semantic.vw_nationwide_qrs_puf_current","title":"CMS Nationwide QRS PUF: current read surface (one CMS artifact per plan year)","domain":"commercial","stage":"semantic_view","status":"live","grain":"One publisher row of the selected data unit per business_year: 1,986 rows PY2019-2026, one CMS artifact per business_year (195 / 198 / 198 / 209 / 264 / 276 / 315 / 331; Athena cff587ab, 2026-10-13).","description":"The read surface over medicare_silver.fact_nationwide_qrs_puf_history (append-only): for each business_year it keeps one CMS data unit (cms_vintage_sequence DESC, then asserted_at DESC, then archive member as tie-breakers) and returns its publisher rows unchanged (raw_values_json keyed by ordered_header_json). Defined in pipelines/medicare/semantic/nationwide_qrs_puf_current.sql (#3583). A later CMS repost of a plan year replaces the earlier artifact here and stays in the history table.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":1986,"last_updated":"2026-10-13","freshness_sla":"Follows the history table: annual plan-year PUF; a CMS repost is selected automatically.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the publication plan year, not the measurement year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_nationwide_qrs_puf_current (pin business_year)","commercial_terms":"Public CMS/CCIIO data; redistribution subject to official source terms.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_nationwide_qrs_puf.json","known_gaps":["is_current is FALSE on every row: the view selects history rows as they are, so it is history_only at the door and no current filter is injected; never filter is_current = true.","Pin business_year: the header changes across plan years, so look cells up by header name in ordered_header_json, never by position.","Ratings are per issuer-state-product reporting unit, never per plan id; dot, blank, BR, CSR-I and NR are distinct coded states, not zero."],"notes":"View from #3583, created 2026-10-13 by the coordinator. Registered 2026-10-13 under its source's w4 register card as the current read surface by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_nationwide_qrs_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"cms_enrollee_survey_puf_current","source_fqn":"medicare_semantic.vw_enrollee_survey_puf_current_v1","title":"CMS QHP Enrollee Survey PUF: current read surface (one CMS artifact per plan year)","domain":"commercial","stage":"semantic_view","status":"live","grain":"One publisher row of the selected data unit per business_year: 1,586 rows PY2022-2026, one CMS artifact per business_year (266 / 298 / 325 / 343 / 354; Athena bccf9835, 2026-10-13).","description":"The read surface over medicare_silver.fact_enrollee_survey_puf_history (append-only): for each business_year it keeps one CMS data unit (cms_vintage_sequence DESC, then asserted_at DESC, then archive member as tie-breakers) and returns its publisher rows unchanged (raw_values_json keyed by ordered_header_json). Defined in pipelines/medicare/semantic/enrollee_survey_puf_current_v1.sql (#3583). A later CMS repost of a plan year replaces the earlier artifact here and stays in the history table.","identity_key":"business_year,archive_member_sha256,source_row_number","row_count":1586,"last_updated":"2026-10-13","freshness_sla":"Follows the history table: annual plan-year PUF; a CMS repost is selected automatically.","recollection":{"cadence":"annual","watermark_field":"business_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'business_year' is the publication plan year, not the measurement year."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_enrollee_survey_puf_current_v1 (pin business_year)","commercial_terms":"Public CMS/CCIIO data; redistribution subject to official source terms.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/cms_enrollee_survey_puf.json","known_gaps":["is_current is FALSE on every row: the view selects history rows as they are, so it is history_only at the door and no current filter is injected; never filter is_current = true.","Pin business_year: the header changes across plan years, so look cells up by header name in ordered_header_json, never by position.","Survey scores are per reporting unit (plus a national row), never per plan id. PY2026 is the survey results (354 rows, cms_vintage_sequence 2), not CMS's data dictionary."],"notes":"View from #3583, created 2026-10-13 by the coordinator. Registered 2026-10-13 under its source's w4 register card as the current read surface by the Data Tracker registration lane (PR claude/tracker-register-sbe-quality-views). Door RAW, World W4.","superseded_by":null,"tools":[],"dataset_id":"cms_cciio_enrollee_survey_puf","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":["business_year","source_row_number"],"unmapped_key_tokens":["archive_member_sha256"],"backing_store":"glue"},{"source_id":"vw_medicaid_sdp_program_year_operative_v1","source_fqn":"medicare_semantic.vw_medicaid_sdp_program_year_operative_v1","title":"Medicaid state directed payments, national: certified program-year amounts, operative version (42 CFR 438.6(c) preprints, 32 states)","domain":"state","stage":"semantic_view","status":"partial","grain":"One operative row per program-year (program_year_key unique = state|program_id|rating_period; the operative version_id). 729 rows, 32 states, all certification_status = certified, rating periods starting 2021-2027 (Athena 9c08dac4, 2026-10-13).","description":"Every state directed payment (SDP) CMS approved under 42 CFR 438.6(c) in 32 states, one row per certified program-year, ready to add up: the preprint's Q4 total, federal and non-federal shares, the approval letter's figure, the payment type and provider class, and the PDF hash, page and locator behind every amount. A Vlada certified layer over CMS's posted approval packages (approval letter + the state's preprint): each amount was read by two independent PDF engines, checked against the letter and against later CMS versions, and passed a third independent audit (SDP-AUDIT-3, PASS). The amounts are approved or proposed ceilings, not payments.","identity_key":"program_year_key","row_count":729,"last_updated":"2026-10-13","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_sdp_program_year_operative_v1 (pin state and rating_period_start; one basis per sum)","notes":"Registered 2026-10-13 under register w8 cms_medicaid_state_directed_payments as the only SDP read surface (PR claude/medicaid-sdp-operative-view), after the MCP lane staging gate (mcp-bridge-6771cbd2) found an unfiltered sum over the version table answering $534.3B with no caveat. Door RAW, World W8, status partial, class unversioned. The version table medicare_silver.medicaid_sdp_program_year_versions_v1 is internal: no card, no World, refused NO_COVERAGE. Ship via the MCP release lane.","superseded_by":null,"tools":[],"dataset_id":"cms_medicaid_state_directed_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["program_year_key"],"backing_store":"glue"},{"source_id":"cms_ma_landscape_contract_year_v20261013a","source_fqn":"medicare_silver.vw_ma_landscape_contract_year_v20261013a","title":"CMS MA / Part D Landscape with the true contract year (corrected Plan and Premium year)","domain":"medicare","stage":"semantic_view","status":"live","grain":"The rows of medicare_silver.fact_ma_landscape (is_current) unchanged, plus contract_year and contract_year_basis: 2,880,985 rows (1,814,465 landscape + 1,066,520 plan_premium), CY2006-2027 (Athena 057d2d5a, 0b2f4ab9, 2026-10-13).","description":"Read-side correction of the Landscape year (LAND-3), nothing restamped in place. For record_family = 'plan_premium' rows contract_year applies parser 1.3.0's rule (#3107) to the stored source_member path: release-date stamps are stripped, then the innermost segment's year is taken. Every other row keeps contract_year = report_year. Defined in pipelines/medicare/semantic/pbp/adhoc_views/vw_ma_landscape_contract_year_v20261013a.sql (#3630); proved equal to the fixed loader and to the files' own title rows on all 45 held members (tools/data_tracker/landscape_contract_year_check.py, Athena 14934086).","identity_key":"contract_id,plan_id,segment_id","row_count":2880985,"last_updated":"2026-10-13","freshness_sla":"Follows medicare_silver.fact_ma_landscape (annual, late September for the next contract year).","recollection":{"cadence":"annual","watermark_field":"contract_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'contract_year' is the contract year the row describes (report_year corrected for the Plan and Premium family); a view, it follows medicare_silver.fact_ma_landscape and holds nothing of its own."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.vw_ma_landscape_contract_year_v20261013a (filter contract_year and record_family)","commercial_terms":"Public CMS data.","provenance_chain_ref":"pipelines/medicare/semantic/pbp/adhoc_views/vw_ma_landscape_contract_year_v20261013a.sql over medicare_silver.fact_ma_landscape (row-level source_url, sha256_content_hash, source_member)","context_doc_path":"docs/context_library/medicare/ma_enrollment_cpsc.md","known_gaps":["Filter contract_year, never report_year: for record_family = 'plan_premium' report_year is the release stamp (2016 holds CY2016 and CY2017; 2017-2022 hold CY2018-CY2023). contract_year_basis says which rows moved ('member_folder_year_corrects_report_year').","Filter record_family: 'landscape' is the plan roster (CY2006-2027), 'plan_premium' the Plan and Premium files (CY2007-2024; from CY2025 the combined Landscape file carries the Part C / Part D split).","is_current is true on every row (the view selects is_current rows of the base table).","Strings as published; cast premiums before arithmetic. SNP is its own category: category IN ('MA','SNP') is Medicare Advantage. No enrollment in the file: an average is per plan."],"notes":"View from #3630, created on Athena 2026-10-13. Registered 2026-10-13 under the cms_ma_landscape register card by the Data Tracker (PR claude/tracker-landscape-pbp-traps). Door RAW, World W3. Readers repoint per docs/data-tracker/LANDSCAPE-PBP-DEFECTS-2026-10-13.md s1.5.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_landscape","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"medicare_pbp_mrx_current_v20261013a","source_fqn":"medicare_silver.vw_pbp_mrx_current_v20261013a","title":"MA pbp mrx, current parse revision per year and quarter","domain":"medicare","stage":"semantic_view","status":"partial","grain":"The rows of medicare_silver.pbp_mrx of each (report_year, quarter) slice's latest parse_revision, plus slice_latest_parse_revision: 270,466 rows on 2026-10-13, equal to the table while no slice holds two revisions (Athena 057d2d5a).","description":"The read side of the append-only pbp_mrx contract (#3630): a parser fix for unchanged CMS bytes is appended as a new parse_revision of its (report_year, quarter) slice, never written over it, and this view returns only each slice's latest revision, so a superseded parse is never read beside its correction. Defined in pipelines/medicare/semantic/pbp/adhoc_views/vw_pbp_mrx_current_v20261013a.sql.","identity_key":"contract_id,plan_id,segment_id,version,mrx_grp_type_id,mrx_grp_id,report_year,quarter","row_count":270466,"last_updated":"2026-10-13","freshness_sla":"Follows medicare_silver.pbp_mrx (CMS PBP publication cadence).","recollection":{"cadence":"annual","watermark_field":"report_year","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["watermark_field 'report_year' is the plan year the bid is for; a view, it follows medicare_silver.pbp_mrx and holds nothing of its own."]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.vw_pbp_mrx_current_v20261013a (pin report_year and quarter)","commercial_terms":"Public CMS data.","provenance_chain_ref":"pipelines/medicare/semantic/pbp/adhoc_views/vw_pbp_mrx_current_v20261013a.sql over medicare_silver.pbp_mrx (M-2 substrate: sha256_content_hash + source_url + asserted_at on every row)","context_doc_path":"docs/context_library/medicare/pbp_supplemental_sections.md","known_gaps":["CY2020 Q1 is still the empty parse (parse_revision 2): 0 of 1,713 Part D deductible amounts and every numeric mrx_* column empty, version 0 on all 7,300 rows, until its corrected revision 3 is appended. CY2020 Q2 and Q4 (parse_revision 3, 2026-10-13) carry 1,701 deductible amounts each; CMS posted no CY2020 Q3 (Athena 216477b9).","Pin report_year and quarter: PBP is quarterly 2018-2024 and annual otherwise; one quarter per plan-year read.","Null numeric benefit amount is NOT $0 (docs/skills/pbp-semantics/SKILL.md).","Raw PBP is CMS-software-coded (era shifts, skip logic); for benefit analysis the cleaned medicare_semantic.vw_pbp_* views are the read surface."],"notes":"View from #3630, created on Athena 2026-10-13. Registered 2026-10-13 under the cms_ma_pbp register card by the Data Tracker (PR claude/tracker-landscape-pbp-traps). Door RAW, Worlds W3 and W7 like its base table.","superseded_by":null,"tools":[],"dataset_id":"cms_ma_pbp","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":["report_year","version"],"unmapped_key_tokens":["mrx_grp_id","mrx_grp_type_id","quarter"],"backing_store":"glue"},{"source_id":"drug_spuf_pharmacy_network","source_fqn":"drug_silver.fact_part_d_pharmacy_network","title":"Part D pharmacy networks and dispensing fees, CMS SPUF member, 2019-Q1 to 2026-Q3","domain":"drug","stage":"silver","status":"live","grain":"One row per (report_quarter, contract_id, plan_id, segment_id, pharmacy_number).","description":"CMS quarterly Part D pharmacy network membership, preferred retail/mail flags, in-area flag, floor price and brand/generic/selected-drug dispensing fees by plan and pharmacy. 31 quarters, including 306,634,467 rows in 2026-Q3.","identity_key":"report_quarter,contract_id,plan_id,segment_id,pharmacy_number","row_count":10248730900,"last_updated":"2026-10-15","freshness_sla":"Quarterly with the CMS SPUF release; pin report_quarter and is_current.","recollection":{"cadence":"quarterly","watermark_field":"report_quarter","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A release quarter can describe the next contract year from Q4; pin quarter."]},"raw_queryable_via":"Athena via submit_query for national work; query_substrate only with a pinned quarter and narrow plan/pharmacy filters. Requires MCP release of this registration.","provenance_chain_ref":"docs/data-tracker/PHARMACY-NETWORK-GATE-2026-10-01.md; docs/data-tracker/releases/2026-10-15/","context_doc_path":"docs/context_library/drug/part_d_monthly_formulary_and_spuf_members.md","known_gaps":["A row is a plan-pharmacy link, not a person or a unique pharmacy. Count DISTINCT pharmacy_number within the pinned quarter to count pharmacies.","HEAVY TABLE: over 10 billion rows. Always filter is_current and one report_quarter; narrow by contract/plan/pharmacy. Use submit_query for national or historical work. Never run an unbounded scan.","PHARMACY_NUMBER is the publisher 12-digit code: literal 10 followed by the 10-digit NPI. Keep it as text; a validated substring(pharmacy_number,3) joins NPI. Preserve ZIP leading zeros.","Dispensing fees are dollars per fill, not ingredient unit prices or net plan costs. Preferred-status flags distinguish retail and mail; do not collapse them.","Blank and dot fee cells are NULL, never zero. Selected-drug fee columns first appear in 2025-Q4; earlier NULL is era-not-applicable.","This is quarterly pharmacy-network data. The CY2027 October monthly package is separately archived; it is not integrated into this quarterly table. Never UNION cadences."],"notes":"Independent whole-quarter counts and per-contract totals passed for the first 30 quarters; era-boundary/middle cell checks passed (66,944 cells). New Q3 load: exact raw count, 240 seeded publisher rows preserved, duplicate keys zero; current-release reconciliation and joins recorded in the 2026-10-15 proof directory. Registration prepared by Tracker; customer door remains unavailable until MCP ships.","superseded_by":null,"tools":[],"dataset_id":"cms_part_d_spuf","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":["cms:contract_id","cms:plan_id","cms:segment_id"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"cms:segment_id":["segment_id"]},"technical_keys":[],"unmapped_key_tokens":["pharmacy_number","report_quarter"],"backing_store":"glue"},{"source_id":"vw_medicaid_va_hospital_actual_payments_v1","source_fqn":"medicare_semantic.vw_medicaid_va_hospital_actual_payments_v1","title":"Virginia Medicaid hospital payments, actual: DSH, medical education, UPL and private-acute enhanced payments by hospital and state fiscal year (DMAS reports, SFY2016-2025)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per printed provider x program_component x sfy from the one canonical edition of that component-year (observation_id unique). 1,831 rows, 43 component-years, SFY2016-2025, 181 printed provider names (Athena a1d0bb29, d8a57f90, 2026-10-19).","description":"What Virginia Medicaid actually paid each hospital, by program and state fiscal year, as DMAS printed it in its reports to the General Assembly: disproportionate share (DSH), graduate and indirect medical education, upper payment limit supplemental payments and the private-acute enhanced payments, SFY2016-2025. For each program component x year the one canonical edition is kept (the latest whose printed total passes and ties to its rows), so a sum within one component and one year is that report's printed total. Every amount carries the report (source_url, source_sha256), page and locator. Actual publisher-reported payments, not ceilings.","identity_key":"observation_id","row_count":1831,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_va_hospital_actual_payments_v1 (pin one program_component and one sfy per sum; never with SDP ceilings)","notes":"Registered 2026-10-19 under register w8 (va_medicaid_hospital_actual_payments) as the only read surface (PR claude/medicaid-payments-va-la-load). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_va_hospital_actual_payments_v1 is internal: no card, no World, refused NO_COVERAGE (the #3612 lesson: required_filters do not refuse). Ship via the MCP release lane; production needs Ben's yes.","superseded_by":null,"tools":[],"dataset_id":"va_medicaid_hospital_actual_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["observation_id"],"backing_store":"glue"},{"source_id":"vw_medicaid_la_hospital_actual_payments_v1","source_fqn":"medicare_semantic.vw_medicaid_la_hospital_actual_payments_v1","title":"Louisiana Medicaid hospital payments, actual: DSH and supplemental payments by hospital, year-to-date snapshots (LDH legislative report item F, SFY2023-2026)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per Medicaid provider ID x snapshot x program_component (DSH or SUPPLEMENTAL); row_key unique. 119 rows, 42 providers, four year-to-date snapshots SFY2023_Q3, SFY2024_Q4, SFY2025_Q2, SFY2026_Q3 (Athena 7a3481e4, ac94dc27, 2026-10-19).","description":"What Louisiana Medicaid reported paying each hospital in disproportionate share (DSH) and other supplemental payments, from the Louisiana Department of Health's legislative hospital reports (item F, 'other supplemental'), as year-to-date snapshots for SFY2023-2026. DSH and supplemental are separate rows; the report's per-hospital total is a control, not served. Each row carries its coverage months and period, the Medicaid provider ID, a CCN only where CMS POS proves it active and unique, and the PDF (source_url, source_sha256), page and line. Actual reported payments, not ceilings and not modeled allocations.","identity_key":"row_key","row_count":119,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_la_hospital_actual_payments_v1 (pin one snapshot and one program_component per sum; never with SDP ceilings)","notes":"Registered 2026-10-19 under register w8 (la_medicaid_hospital_actual_payments) as the only read surface (PR claude/medicaid-payments-va-la-load). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_la_hospital_actual_payments_v1 is internal: no card, no World, refused NO_COVERAGE (the #3612 lesson: required_filters do not refuse). Ship via the MCP release lane; production needs Ben's yes.","superseded_by":null,"tools":[],"dataset_id":"la_medicaid_hospital_actual_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["row_key"],"backing_store":"glue"},{"source_id":"vw_medicaid_ut_provider_actual_payments_v1","source_fqn":"medicare_semantic.vw_medicaid_ut_provider_actual_payments_v1","title":"Utah Medicaid provider payments, actual: DSH and nursing-facility / outpatient UPL by provider and period (DHHS, 2018-2026)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per printed provider x program x period_key (source_sha256 + source_locator unique). 2,061 rows: DSH 161 (4 rate years), NF_UPL 1,178 (16 quarters), OP_PRIVATE_UPL 722 (19 quarters) (Athena 19491e1b, 2026-10-19).","description":"What Utah Medicaid actually paid each hospital and nursing facility in disproportionate share (DSH) and upper payment limit supplemental payments, by the publisher's own period, from Utah DHHS workbooks. Audited canonical scope only; every amount carries its workbook (source_url, source_sha256) and cell. Actual payments, not ceilings.","identity_key":"source_sha256,source_locator","row_count":2061,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_ut_provider_actual_payments_v1 (program = <one> AND period_key = <one>)","notes":"Registered 2026-10-19 under register w8 (ut_medicaid_provider_actual_payments) as the only read surface (PR claude/medicaid-payments-ut-ok-load). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_ut_provider_actual_payments_v1 is internal: no card, no World, refused NO_COVERAGE. Ships with the MCP lane's next main-based release.","superseded_by":null,"tools":[],"dataset_id":"ut_medicaid_provider_actual_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_locator","source_sha256"],"backing_store":"glue"},{"source_id":"vw_medicaid_ut_uumg_medical_group_payments_v1","source_fqn":"medicare_semantic.vw_medicaid_ut_uumg_medical_group_payments_v1","title":"Utah Medicaid ACO directed payments to the University of Utah Medical Group, actual, by plan and service month (2021-2022)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per plan x medical group x service month (period_key) x payment reference; 79 rows, 4 plans, 23 service months (Athena 33adf85b, 2026-10-19).","description":"Plan-reported directed payments Utah's ACO plans made to the University of Utah Medical Group, dated and referenced, with in-transfer offsets kept signed. A separate surface from the UT core payments view; never added to it. Actual payments, not ceilings.","identity_key":"source_sha256,source_locator","row_count":79,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_ut_uumg_medical_group_payments_v1 (program = <one> AND period_key = <one>)","notes":"Registered 2026-10-19 under register w8 (ut_medicaid_uumg_medical_group_payments) as the only read surface (PR claude/medicaid-payments-ut-ok-load). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_ut_uumg_medical_group_payments_v1 is internal: no card, no World, refused NO_COVERAGE. Ships with the MCP lane's next main-based release.","superseded_by":null,"tools":[],"dataset_id":"ut_medicaid_uumg_medical_group_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_locator","source_sha256"],"backing_store":"glue"},{"source_id":"vw_medicaid_ok_provider_actual_payments_v1","source_fqn":"medicare_semantic.vw_medicaid_ok_provider_actual_payments_v1","title":"Oklahoma Medicaid provider payments, actual: DSH, practitioner PIP and FFS hospital access by provider and period (OHCA, 2021-2026)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per provider x program x period_key (source_sha256 + source_locator unique). 20,413 rows: DSH 120 (2 rate years), PIP 19,673 (5 payment runs), FFS_HOSPITAL_ACCESS 620 (4 calendar quarters) (Athena 41d5e3c5, 2026-10-19).","description":"What Oklahoma Medicaid actually paid in audited DSH (hospitals), practitioner PIP payment runs and FFS hospital access payments (interim, controlled typed actuals), by the publisher's own period, from OHCA reports and workbooks. Audited scope only; every amount carries its source and locator. Actual payments, not ceilings.","identity_key":"source_sha256,source_locator","row_count":20413,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_ok_provider_actual_payments_v1 (program = <one> AND period_key = <one>)","notes":"Registered 2026-10-19 under register w8 (ok_medicaid_provider_actual_payments) as the only read surface (PR claude/medicaid-payments-ut-ok-load). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_ok_provider_actual_payments_v1 is internal: no card, no World, refused NO_COVERAGE. Ships with the MCP lane's next main-based release.","superseded_by":null,"tools":[],"dataset_id":"ok_medicaid_provider_actual_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_locator","source_sha256"],"backing_store":"glue"},{"source_id":"cms_federal_idr_bimonthly_status","source_fqn":"medicare_silver.fact_idr_bimonthly_status","title":"CMS Federal IDR (No Surprises Act) bi-monthly operations reports: disputes initiated and closed","domain":"commercial","stage":"silver","status":"live","grain":"One row per (report_as_of, measure, window_type, window_start, window_end): disputes initiated, or closed by reason, in the two-month period / year to date / program to date / a month. 169 rows, nine editions As of May 31, 2025 ... As of September 30, 2026 (Athena f68def95, 2026-10-23).","description":"The Departments' bi-monthly Federal IDR operations snapshot (HTML tables on the CMS IDR reports page, May 31, 2025 onward). Table 1 disputes initiated and Table 2 reasons for closure, each in three windows, plus the narrative's monthly figures. Counts of disputes. The most current public IDR volume: the quarterly PUF and Supplemental Tables stop at 2025 Q4.","identity_key":null,"row_count":169,"last_updated":"2026-10-23","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_idr_bimonthly_status (pin one report_as_of and one window_type; never difference or sum across editions)","notes":"Athena external table, Parquet, PARTITIONED BY (report_as_of date); each edition at medicare/silver/fact_idr_bimonthly_status/report_as_of=<d>/<parquet_sha256>/; a new edition appends a partition, an existing one is never rewritten (a changed edition REFUSES). RDS-free loader run via cloud_run (tools/data_tracker/idr_bimonthly_load.sh). Registered 2026-10-23 under register w1 (cms_federal_idr_bimonthly_status), door RAW (PR claude/idr-register).","superseded_by":null,"tools":[],"dataset_id":"cms_federal_idr_bimonthly_status","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"tx_tdi_idr_summary","source_fqn":"medicare_silver.vw_fact_tx_tdi_idr_summary","title":"Texas TDI Independent Dispute Resolution (SB 1264) summary data: monthly mediation and arbitration counts, every captured daily edition","domain":"commercial","stage":"semantic_view","status":"live","grain":"One row per (edition, request_type, count_type, activity_year, activity_month); read WHERE is_current. 5,254 rows over four held editions (2025-05-16, 2026-01-17, 2026-01-18, 2026-10-23T135729Z); the current edition holds 1,478 rows (Athena 3382bd59, 2026-10-23). One edition is added per day TDI refreshes.","description":"Texas Department of Insurance monthly IDR portal counts (data.texas.gov bn27-65ad) for state-regulated health plans and opted-in ERISA plans since February 2020. Mediation (out-of-network facilities) and arbitration (out-of-network providers) requests received, teleconference settlements, facilitator strikes by plan and by provider, both-party facilitator choices, assignments, arbitration decisions, and distinct counts of submitters, providers, involved health plans and assigned facilitators. Every captured edition is kept so restatements show; is_current marks the newest held one.","identity_key":null,"row_count":5254,"last_updated":"2026-10-23","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.vw_fact_tx_tdi_idr_summary WHERE is_current (the base table medicare_silver.fact_tx_tdi_idr_summary is internal)","notes":"Registered 2026-10-23 under register w1 (tx_tdi_idr_summary) as the only read surface (PR claude/idr-register). Door RAW, World W1. The base table medicare_silver.fact_tx_tdi_idr_summary is internal: no card, World internal, refused NO_COVERAGE (#3612: required_filters do not refuse). Known value: requests received in 2023 (is_current) = 519,095 (arbitration 222,817 + mediation 296,278; TDI's 2025 IDR explainer p.19; Athena 82e42302).","superseded_by":null,"tools":[],"dataset_id":"tx_tdi_idr_summary","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"va_boi_balance_billing_arbitration","source_fqn":"medicare_silver.fact_va_boi_balance_billing_arbitration","title":"Virginia BOI balance billing arbitration reports: state IDR outcomes, offers, awards, OON claims","domain":"commercial","stage":"silver","status":"live","grain":"One row per printed report-table cell (report_id, exhibit_id, row_order, column_order, component). 1,637 rows from 10 reports, July series RD261-RD363 and December series RD750-RD934 (Athena 10e61330, 2026-10-23).","description":"Virginia State Corporation Commission Bureau of Insurance reports to the General Assembly under Code of Virginia 38.2-3445.02 I (July, 2021-2025) and 38.2-3445.2 C (December, 2021-). Arbitration decisions by specialty and prevailing party, average offers and awards per claimant, share of bundled arbitrations, carrier-reported out-of-network claim counts (emergency and in-network-facility surgical/ancillary), network terminations, reinstatement payment levels and emergency allowed claims.","identity_key":"report_id","row_count":1637,"last_updated":"2026-10-23","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_va_boi_balance_billing_arbitration (value_status = 'reported'; one series per count)","notes":"External Parquet table partitioned by report_id; each report's partition sits at a content-addressed location (rows sha256). A new report adds a partition only after its exhibit contract is written (pipelines/medicare/silver/va_boi_balance_billing_spec.py). Registered 2026-10-23 under register w1 (va_boi_balance_billing_arbitration), door RAW (PR claude/idr-register). Known value: RD934-T4 FY 2025 network terminations total = 46,601 (Athena e266cdd4).","superseded_by":null,"tools":[],"dataset_id":"va_boi_balance_billing_arbitration","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["report_id"],"backing_store":"glue"},{"source_id":"dc_medicaid_enrollment_history","source_fqn":"medicare_silver.dc_medicaid_enrollment_history_observation","title":"District of Columbia Medicaid monthly enrollment report history","domain":"state","stage":"silver","status":"live","grain":"One official report edition × observation month × printed section × plan/program row; all report revisions retained.","description":"Source-native DHCF Medicaid and Alliance monthly report observations from 121 known official PDFs as of October 24, 2026. Later reports can revise earlier months; a preferred-report flag marks the source selection without discarding older rows.","identity_key":"semantic_row_sha256","row_count":53274,"last_updated":"2026-10-24","freshness_sla":"Monthly publisher report cadence, subject to late publication and rolling restatements; verify official controller before claiming a current edition.","recollection":{"cadence":"monthly","watermark_field":"observation_period","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["The source-load date is not an observation period or publisher freshness assertion.","Report edition and observation period are separate axes; later reports can revise earlier months.","Parent and national comparison serving require separate derived-data proofs."]},"raw_queryable_via":"Internal Athena/Glue source table only; no independent customer raw-row entitlement. Customer ledger and parent routes have separate governed acceptance.","commercial_terms":"Public District of Columbia government report; consult official publisher terms for redistribution.","provenance_chain_ref":"docs/reference/source-audit/source-mastery/records/dc_medicaid_enrollment_history.json","context_doc_path":"docs/context_library/medicaid/dc_medicaid_enrollment_history.md","known_gaps":["No recovered official or Wayback report before the asset carrying October 2010 observations; earlier months remain unavailable, never zero.","Publisher totals, overlapping sections, FFS, D-SNP, PACE, and specialty program rows are not an additive Medicaid member universe.","The October 24 source load/replay proved 53,274 source-native rows at snapshot 3652576647968323779, but did not refresh or accept the materialized parent fact or national v7 census."],"notes":"The October 24 source edition retains all 49,816 August rows and adds 3,458 observations from seven additional report PDFs. It has 9,827 preferred rows. Bundle SHA-256 8611f691cc98019e3b5dce5956dedda7414c322d87ea0147d785cce0d7de8b23; identical replay left the snapshot and Bronze version unchanged.","superseded_by":null,"tools":[],"dataset_id":null,"dataset_assignment_basis":null,"layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["semantic_row_sha256"],"backing_store":"glue"},{"source_id":"vlada_cvi_plan_county_v4","source_fqn":"medicare_semantic.cvi_plan_county_v4","title":"Vlada County Volatility Index v4 by plan and county: each MA plan's September members and what happened to them the next plan year (plan ended, moved, material cut, stable), 2016-2027","domain":"medicare","stage":"mart","status":"live","grain":"One row per plan_year x state x county_ssa x contract_id x plan_id (unique: 691,982 rows = 691,982 keys, Athena a6054eb1), individual H/R plans 001-799 with members the September before. Rows by plan_year: 2016 28,272; 2017 29,496; 2018 30,350; 2019 34,225; 2020 40,924; 2021 48,591; 2022 58,066; 2023 68,999; 2024 78,640; 2025 88,940; 2026 91,821; 2027 93,658 (Athena 7e8f6cb5). 3,163 county FIPS, 10,971 plans, every row with a FIPS.","description":"The County Volatility Index (Report 2) at its own grain, the rows medicare_semantic.cvi_county_v4 sums: Of the members in a county's individual Medicare Advantage plans the September before a plan year, those whose plan ended (no successor sold in the county), who were moved by the insurer into another plan ID, or whose plan stayed and made a material cut (premium up $10+ a month, in-network MOOP up $500+ outside CMS's ceiling-to-ceiling move, comprehensive dental max down $500+ or dropped), per 100. Each member counts once, in the first bucket that applies (plan ended > moved > material cut > stable); gains are counted beside, never netted. One row per plan in a county with its September members, its bucket, which benefit was cut (cut_premium, cut_moop, cut_dental), the ceiling-to-ceiling MOOP flag, any_gain, the two years' premium, MOOP and dental values (prem_old/new, moop_old/new, dent_old/new), the plan name and CMS's parent the September before (parent_raw). The read layer of get_volatility_index and get_county_view sections=volatility. The index of a group = 100 x sum(members where bucket IN ('plan_ended','moved','material_cut')) / sum(members).","identity_key":"plan_year,state,county_ssa,contract_id,plan_id","row_count":691982,"last_updated":"2026-10-26","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.cvi_plan_county_v4 (pin plan_year; group and SUM members, never count rows; filter product for one product type)","provenance_chain_ref":"ops/ma_report_cube/sql/cvi_plan_county_v4.sql (CTAS, Athena query 20261026_213125_00124_qnhu6) over medicare_semantic.exits_cells_county_2016_v1 .. _2027_v1 (the locked exit cells), medicare_silver.fact_ma_landscape, plan_crosswalks_annual and medicare_semantic.vw_benefit_vector; s3://vlada-platform-raw/medicare_semantic/cvi_plan_county_v4/. Reconciled 2026-10-26: cvi_plan_county_v4 summed to county x product x year matches cvi_county_v4 on all 140,775 cells, 0 differences on members, plan ended, moved, material cut, premium cut, ceiling-to-ceiling and gains (ops/ma_report_cube/sql/cvi_plan_county_v4_recon.sql; Athena ce1dcd7b).","known_gaps":["NEVER SUM cut BEFORE 2021: benefits are scored from 2021 (both years locked); 2016-2020 carry plan ended and moved only. cvi_county_v4.cut (and stable, gains, the cut_* columns) is NULL on all 47,042 county x product rows 2016-2020 (Athena 2b51c797); cvi_plan_county_v4 puts those stayed members in bucket 'stayed_unscored' (140,013 rows, 67,727,079 member-years; f579ed3b). COALESCE(cut, 0) turns the exit part into a fake index: nationally 2020 reads 8.5, 2021 21.3, of which 16.1 is the cut that only starts being counted (480b4765). Before 2021 say 'exit part' (plan ended + moved), never the index.","NEVER AVERAGE COUNTY INDEXES: weight by members (sum the member counts of each part, then divide). For 2027 the member-weighted national index is 55.8; the simple average of the 3,096 county indexes is 64.7 and of the 2,785 ranked counties 63.0 (2023: 15.7 against 18.2), because small counties run hotter (Athena aeaad794). State, parent and product figures are sums of members over sums of members too.","THIN CELLS ARE OUT OF RANKINGS: the size rule is 250+ members the September before AND 2+ plans. cvi_county_v4.thin marks a county x product cell below it: 72,075 of the 140,775 cells, holding 9,441,693 member-years (Athena 2b51c797). A pooled county is judged on its own pooled members and plans: in 2027 311 of 3,096 counties (39,966 members) fail and are never ranked, but are counted in state and national figures (aeaad794). Rank only cells that pass, as get_volatility_index does.","2027 IS PLANS AS FILED, NOT AN OUTCOME: every year counts the plans as filed for that year against the prior September's members; 2027's 29,862,383 members are the September 2026 base of the locked exit cells (exits_cells_county_2027_v1 sums to the same 29,862,383; Athena 4f98ab12). It is what members face, not where they went or what they chose: nothing in either table is 2027 enrollment.","county_ssa IS CMS's SSA CODE, NOT FIPS: Hennepin is county_ssa 24260, county_fips 27053 (Athena 7686b1c2). cvi_county_v4 has no FIPS column; cvi_plan_county_v4 has both. Los Angeles is two SSA counties (05200, 05210) on one FIPS 06037 (da4db93a): grouping by county_fips (the tools) gives 3,163 counties, by state + county_ssa (cvi_county_v4) 3,164 (7e8f6cb5).","MEMBERS ARE A FLOOR: plan x county cells CMS suppresses (under 11 enrollees) are not in the table; the smallest members value is 11 (Athena ff49d5bc). The benefit part is a floor too: OTC and the Part B giveback are left out, and a stayed member whose plan has no benefit filing in one of the two years is never counted as cut.","D-SNP, C-SNP and I-SNP are their own product types (product: regular_hmo, regular_ppo, regular_other, dsnp_hmo, dsnp_ppo, csnp_hmo, csnp_ppo, isnp_hmo, isnp_ppo); a county's headline pools all of them, a product row never pools SNPs with regular plans. A plan that only followed CMS's in-network MOOP ceiling to the new ceiling is moop_ceiling_to_ceiling, never a cut (5,726,661 members in 2027, Athena 480b4765). parent_raw is CMS's reported parent the September before, not a canonical chain across acquisitions."],"notes":"Registered 2026-10-26 under register w3 vlada_w3_county_volatility_index, door BOTH (tools get_volatility_index and get_county_view sections=volatility), World W3 (PR claude/cvi-release (#4329)). Unversioned (no is_current). Spec docs/mcp/CVI-SERVING-SPEC-2026-10-26.md. Check value, Hennepin MN (FIPS 27053) 2027: 123,564 members in 32 plans, index 91.7 = 54.2 plan ended + 16.6 moved + 20.8 material cut per 100 (Athena 7686b1c2), rank 140 of 2,785 ranked counties nationally and 50 of 82 in Minnesota (the tool's rank query, db35c895).","superseded_by":null,"tools":["get_county_view","get_volatility_index"],"dataset_id":"vlada_w3_county_volatility_index","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id","cms:plan_id","ssa:county","usps:state"],"entity_key_columns":{"cms:contract_id":["contract_id"],"cms:plan_id":["plan_id"],"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":["plan_year"],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"vlada_cvi_county_v4","source_fqn":"medicare_semantic.cvi_county_v4","title":"Vlada County Volatility Index v4 by county and product type (Report 2's audited table): members, plan ended, moved, material cut, stable and gains, 2016-2027","domain":"medicare","stage":"mart","status":"live","grain":"One row per plan_year x state x county_ssa x product (unique: 140,775 rows = 140,775 keys, Athena 45461f1a); nine product types, 3,164 SSA counties. Rows by plan_year: 2016 8,930; 2017 8,957; 2018 9,052; 2019 9,710; 2020 10,393; 2021 11,097; 2022 11,734; 2023 12,632; 2024 13,587; 2025 14,380; 2026 15,013; 2027 15,290 (Athena 2b51c797). No FIPS column (cvi_plan_county_v4 carries it).","description":"Report 2's audited County Volatility Index table: Of the members in a county's individual Medicare Advantage plans the September before a plan year, those whose plan ended (no successor sold in the county), who were moved by the insurer into another plan ID, or whose plan stayed and made a material cut (premium up $10+ a month, in-network MOOP up $500+ outside CMS's ceiling-to-ceiling move, comprehensive dental max down $500+ or dropped), per 100. Each member counts once, in the first bucket that applies (plan ended > moved > material cut > stable); gains are counted beside, never netted. Per county x product type x plan year: members, plans, must_pick (plan ended), moved, cut, stable, no_benefit_row, benefit_any_unknown, gain_any, gain_only, the cut by benefit (cut_premium, cut_moop, cut_dental; cut_moop_raw = the raw rise before the ceiling rule), moop_ceiling_to_ceiling, the OTC and Part B giveback side columns, benefit_part_locked and thin. Index = 100 x (must_pick + moved + cut) / members, from 2021.","identity_key":"plan_year,state,county_ssa,product","row_count":140775,"last_updated":"2026-10-26","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.cvi_county_v4 (pin plan_year; SUM the member columns and divide; filter NOT thin to rank)","provenance_chain_ref":"ops/ma_report_cube/sql/cvi_county_v4.sql (CTAS, Athena query 20261026_164050_00016_bdz8y; independent audit AUDIT-CVI-V2-2026-10-26.md, design CVI-DESIGN-2026-10-26.md, MOOP rule CVI-MOOP-DECISION-2026-10-26.md on the report branch) over the locked exit cells exits_cells_county_2016_v1 .. _2027_v1, fact_ma_landscape, plan_crosswalks_annual and vw_benefit_vector (benefit lock 1023m); s3://vlada-platform-raw/medicare_semantic/cvi_county_v4/. Reconciled 2026-10-26: cvi_plan_county_v4 summed to county x product x year matches cvi_county_v4 on all 140,775 cells, 0 differences on members, plan ended, moved, material cut, premium cut, ceiling-to-ceiling and gains (ops/ma_report_cube/sql/cvi_plan_county_v4_recon.sql; Athena ce1dcd7b).","known_gaps":["NEVER SUM cut BEFORE 2021: benefits are scored from 2021 (both years locked); 2016-2020 carry plan ended and moved only. cvi_county_v4.cut (and stable, gains, the cut_* columns) is NULL on all 47,042 county x product rows 2016-2020 (Athena 2b51c797); cvi_plan_county_v4 puts those stayed members in bucket 'stayed_unscored' (140,013 rows, 67,727,079 member-years; f579ed3b). COALESCE(cut, 0) turns the exit part into a fake index: nationally 2020 reads 8.5, 2021 21.3, of which 16.1 is the cut that only starts being counted (480b4765). Before 2021 say 'exit part' (plan ended + moved), never the index.","NEVER AVERAGE COUNTY INDEXES: weight by members (sum the member counts of each part, then divide). For 2027 the member-weighted national index is 55.8; the simple average of the 3,096 county indexes is 64.7 and of the 2,785 ranked counties 63.0 (2023: 15.7 against 18.2), because small counties run hotter (Athena aeaad794). State, parent and product figures are sums of members over sums of members too.","THIN CELLS ARE OUT OF RANKINGS: the size rule is 250+ members the September before AND 2+ plans. cvi_county_v4.thin marks a county x product cell below it: 72,075 of the 140,775 cells, holding 9,441,693 member-years (Athena 2b51c797). A pooled county is judged on its own pooled members and plans: in 2027 311 of 3,096 counties (39,966 members) fail and are never ranked, but are counted in state and national figures (aeaad794). Rank only cells that pass, as get_volatility_index does.","2027 IS PLANS AS FILED, NOT AN OUTCOME: every year counts the plans as filed for that year against the prior September's members; 2027's 29,862,383 members are the September 2026 base of the locked exit cells (exits_cells_county_2027_v1 sums to the same 29,862,383; Athena 4f98ab12). It is what members face, not where they went or what they chose: nothing in either table is 2027 enrollment.","county_ssa IS CMS's SSA CODE, NOT FIPS: Hennepin is county_ssa 24260, county_fips 27053 (Athena 7686b1c2). cvi_county_v4 has no FIPS column; cvi_plan_county_v4 has both. Los Angeles is two SSA counties (05200, 05210) on one FIPS 06037 (da4db93a): grouping by county_fips (the tools) gives 3,163 counties, by state + county_ssa (cvi_county_v4) 3,164 (7e8f6cb5).","MEMBERS ARE A FLOOR: plan x county cells CMS suppresses (under 11 enrollees) are not in the table; the smallest members value is 11 (Athena ff49d5bc). The benefit part is a floor too: OTC and the Part B giveback are left out, and a stayed member whose plan has no benefit filing in one of the two years is never counted as cut.","cut_otc_side AND cut_giveback_side ARE SIDE COLUMNS, NOT IN THE INDEX: they are filled only in the years both benefit years are locked (OTC 2023, 2024 and 2027; Part B giveback 2021-2024) and NULL otherwise (Athena 2b51c797). Never add them to cut.","Product types are never pooled in a product row (D-SNP, C-SNP, I-SNP are their own); a county headline sums every product row of the county. moop_ceiling_to_ceiling members (a plan that only followed CMS's MOOP ceiling) are their own line, never in cut; cut_moop_raw is the raw rise kept beside it."],"notes":"Registered 2026-10-26 under register w3 vlada_w3_county_volatility_index, door BOTH, World W3 (PR claude/cvi-release (#4329)). Unversioned (no is_current). The tools read cvi_plan_county_v4 (FIPS, plans, parents); this is the report's table of record. Check value, Hennepin MN (FIPS 27053) 2027: 123,564 members in 32 plans, index 91.7 = 54.2 plan ended + 16.6 moved + 20.8 material cut per 100 (Athena 7686b1c2), rank 140 of 2,785 ranked counties nationally and 50 of 82 in Minnesota (the tool's rank query, db35c895).","superseded_by":null,"tools":[],"dataset_id":"vlada_w3_county_volatility_index","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["ssa:county","usps:state"],"entity_key_columns":{"ssa:county":["county_ssa"],"usps:state":["state"]},"technical_keys":["plan_year"],"unmapped_key_tokens":["product"],"backing_store":"glue"},{"source_id":"cms_urr_ratereview_submissions","source_fqn":"medicare_silver.fact_urr_submission_history","title":"CMS rate review site (ratereview.healthcare.gov): ACA individual and small-group rate filings, requested and final average rate change, PY2019-2027","domain":"commercial","stage":"silver","status":"live","grain":"One row per element of one capture bundle: record_type 'submission' (one filing: issuer x state x market x effective date x review period) or 'product' (one product in a filing; captured for PY2026-2027 only). Never add the two. 11,095 rows: 7,372 submissions PY2019-2027 + 3,723 products (PY2026 2,156, PY2027 1,567), one capture per plan year, all taken 2026-10-26 (Athena 178ad67a, 2026-10-26).","description":"CMS's public summary of every ACA single-risk-pool rate filing, captured from the site's public JSON service: the issuer's requested average rate change, the final change once the state or CMS finishes review, the range across the filing's products, review status and determination, and links to the redacted actuarial memorandum and the consumer justification narrative. The only national source of next year's requested changes before the URR PUF posts, and of FINAL changes per filing (the PUF carries filed changes only). Rates are percent points.","identity_key":"plan_year,sha256_content_hash,record_type,capture_line,element_index","row_count":11095,"last_updated":"2026-10-26","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_urr_submission_history (filter plan_year and record_type; newest capture = max(capture_started_at) per plan_year; never filter is_current)","notes":"Registered 2026-10-26 under register w4 (cms_urr_ratereview_submissions), door RAW, World W4 (PR claude/urr-register, stacked on #4295). History-only: listed in vlada/query/versioned_tables.json history_only, so the door never injects is_current (as versioned it would inject WHERE is_current and return no rows). Join to fact_rate_review_puf_history measured: Annual (state, HIOS issuer, market) site pairs found in the PUF WKSH1 2024 Individual 348/348, Small Group 405/405; 2025 337/339, 331/331; 2026 344/344, 317/317 (Athena 758f78f9). Newest capture SQL: capture_started_at = (SELECT max(capture_started_at) FROM medicare_silver.fact_urr_submission_history WHERE plan_year = <year>).","superseded_by":null,"tools":[],"dataset_id":"cms_urr_ratereview_submissions","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":["plan_year"],"unmapped_key_tokens":["capture_line","element_index","record_type","sha256_content_hash"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notices","source_fqn":"medicare_silver.ma_rate_notice_figure","title":"MA rate notices CY2000-2027: documents, every printed number, curated figures","domain":"medicare","stage":"silver","status":"live","grain":"Figures: one row per (rate_year, stage, figure_key, qualifier, source_stage). Values: one row per printed number (sha256_content_hash, page, line_index, token_index). Documents: one row per pinned file.","description":"CMS's Early Preview, Advance Notice, Rate Announcement and fact sheets for every rate year since 2000, loaded as data: the payment impact table, the risk score trend, growth percentages, normalization factors, the coding adjustment, and every other number with its verbatim line.","identity_key":"rate_year,stage,figure_key,qualifier,source_stage","row_count":697,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_figure, ma_rate_notice_value, ma_rate_notice_document","provenance_chain_ref":"Every row carries source_url, sha256_content_hash, bronze_publication_id, asserted_at and parser_artifact_hash; values and figures add the verbatim source_line, page and engine2_confirmed.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["figure_key","qualifier","rate_year","source_stage","stage"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_value","source_fqn":"medicare_silver.ma_rate_notice_value","title":"MA rate notices CY2000-2027: every printed number with its verbatim line","domain":"medicare","stage":"silver","status":"live","grain":"One row per printed number: (sha256_content_hash, page, line_index, token_index).","description":"Every number printed in CMS's MA rate notices and fact sheets since CY2000, with its page, row label, column header, table caption, verbatim source line and whether a second PDF engine re-found it (engine2_confirmed). Raw print: it includes years, page and section numbers; filter by table_caption and row_label, never sum it. The curated figures are cms_ma_rate_notices.","identity_key":"sha256_content_hash,page,line_index,token_index","row_count":209398,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_figure, ma_rate_notice_value, ma_rate_notice_document","provenance_chain_ref":"Every row carries source_url, sha256_content_hash, bronze_publication_id, asserted_at and parser_artifact_hash; values and figures add the verbatim source_line, page and engine2_confirmed.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["line_index","page","sha256_content_hash","token_index"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_document","source_fqn":"medicare_silver.ma_rate_notice_document","title":"MA rate notices CY2000-2027: the pinned documents (PDF, ZIP, HTML)","domain":"medicare","stage":"silver","status":"live","grain":"One row per pinned file: (rate_year, sha256_content_hash).","description":"The register of every CMS MA rate notice file since CY2000 (Early Preview, Advance Notice, Rate Announcement, fact sheets and their ZIP attachments): stage, title, release date, source URL, SHA-256, pages, how many values were parsed and the parse scope. Join ma_rate_notice_value and ma_rate_notice_figure on sha256_content_hash.","identity_key":"rate_year,sha256_content_hash","row_count":124,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_figure, ma_rate_notice_value, ma_rate_notice_document","provenance_chain_ref":"Every row carries source_url, sha256_content_hash, bronze_publication_id, asserted_at and parser_artifact_hash; values and figures add the verbatim source_line, page and engine2_confirmed.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["rate_year","sha256_content_hash"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_stage_change","source_fqn":"medicare_silver.ma_rate_notice_stage_change","title":"MA rate notices CY2000-2027: how each Advance Notice figure moved to the final","domain":"medicare","stage":"silver","status":"live","grain":"One row per figure x rate year: the Advance Notice value against the final, with CMS's restatement: (rate_year,figure_key,qualifier).","description":"A product of the CMS MA rate notices (register cms_ma_rate_notices): how each Advance Notice figure moved to the final, one row per figure x rate year: the Advance Notice value against the final, with CMS's restatement. Built from the same load as the value table and pointing at the printed number (sha256_content_hash, page, line_index, source_line); never more certain than the print. Read the dataset's traps before comparing years.","identity_key":"rate_year,figure_key,qualifier","row_count":374,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_stage_change","provenance_chain_ref":"Every row carries sha256_content_hash, source_line, asserted_at and parser_artifact_hash (ma_rate_notice_parser@1.8.1, run 20261029T122731Z-4e7e67d6); join ma_rate_notice_document on sha256_content_hash for the file.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["figure_key","qualifier","rate_year"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_uspcc_estimate","source_fqn":"medicare_silver.ma_rate_notice_uspcc_estimate","title":"MA rate notices CY2000-2027: the per capita cost (USPCC) history","domain":"medicare","stage":"silver","status":"live","grain":"One row per calendar year x part x population as printed in one edition, current and prior estimate: (sha256_content_hash,table_kind,population,part,calendar_year,row_variant).","description":"A product of the CMS MA rate notices (register cms_ma_rate_notices): the per capita cost (USPCC) history, one row per calendar year x part x population as printed in one edition, current and prior estimate. Built from the same load as the value table and pointing at the printed number (sha256_content_hash, page, line_index, source_line); never more certain than the print. Read the dataset's traps before comparing years.","identity_key":"sha256_content_hash,table_kind,population,part,calendar_year,row_variant","row_count":5571,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_uspcc_estimate","provenance_chain_ref":"Every row carries sha256_content_hash, source_line, asserted_at and parser_artifact_hash (ma_rate_notice_parser@1.8.1, run 20261029T122731Z-4e7e67d6); join ma_rate_notice_document on sha256_content_hash for the file.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["calendar_year","part","population","row_variant","sha256_content_hash","table_kind"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_risk_model_cell","source_fqn":"medicare_silver.ma_rate_notice_risk_model_cell","title":"MA rate notices CY2000-2027: every printed risk model factor","domain":"medicare","stage":"silver","status":"live","grain":"One row per printed risk factor (CMS-HCC, RxHCC, ESRD, frailty, risk score, predictive ratio, CY2004-2007 dollar coefficients, CY2005-2008 transplant calculations): (sha256_content_hash,page,line_index,token_index).","description":"A product of the CMS MA rate notices (register cms_ma_rate_notices): every printed risk model factor, one row per printed risk factor (CMS-HCC, RxHCC, ESRD, frailty, risk score, predictive ratio, CY2004-2007 dollar coefficients, CY2005-2008 transplant calculations). Built from the same load as the value table and pointing at the printed number (sha256_content_hash, page, line_index, source_line); never more certain than the print. Read the dataset's traps before comparing years.","identity_key":"sha256_content_hash,page,line_index,token_index","row_count":57194,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_risk_model_cell","provenance_chain_ref":"Every row carries sha256_content_hash, source_line, asserted_at and parser_artifact_hash (ma_rate_notice_parser@1.8.1, run 20261029T122731Z-4e7e67d6); join ma_rate_notice_document on sha256_content_hash for the file.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["line_index","page","sha256_content_hash","token_index"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_part_d_parameter","source_fqn":"medicare_silver.ma_rate_notice_part_d_parameter","title":"MA rate notices CY2000-2027: the Part D benefit parameters by year","domain":"medicare","stage":"silver","status":"live","grain":"One row per Part D parameter x contract year, and the annual percentage (API / CPI) indexing rows: (sha256_content_hash,page,line_index,token_index).","description":"A product of the CMS MA rate notices (register cms_ma_rate_notices): the Part D benefit parameters by year, one row per Part D parameter x contract year, and the annual percentage (API / CPI) indexing rows. Built from the same load as the value table and pointing at the printed number (sha256_content_hash, page, line_index, source_line); never more certain than the print. Read the dataset's traps before comparing years.","identity_key":"sha256_content_hash,page,line_index,token_index","row_count":3388,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_part_d_parameter","provenance_chain_ref":"Every row carries sha256_content_hash, source_line, asserted_at and parser_artifact_hash (ma_rate_notice_parser@1.8.1, run 20261029T122731Z-4e7e67d6); join ma_rate_notice_document on sha256_content_hash for the file.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["line_index","page","sha256_content_hash","token_index"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_payment_parameter","source_fqn":"medicare_silver.ma_rate_notice_payment_parameter","title":"MA rate notices CY2000-2027: the MA payment parameter tables","domain":"medicare","stage":"silver","status":"live","grain":"One row per cell of the rebate, applicable percentage, bid-to-benchmark, blended benchmark, actuarial value and claims-processing tables: (sha256_content_hash,page,line_index,token_index).","description":"A product of the CMS MA rate notices (register cms_ma_rate_notices): the MA payment parameter tables, one row per cell of the rebate, applicable percentage, bid-to-benchmark, blended benchmark, actuarial value and claims-processing tables. Built from the same load as the value table and pointing at the printed number (sha256_content_hash, page, line_index, source_line); never more certain than the print. Read the dataset's traps before comparing years.","identity_key":"sha256_content_hash,page,line_index,token_index","row_count":1978,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_payment_parameter","provenance_chain_ref":"Every row carries sha256_content_hash, source_line, asserted_at and parser_artifact_hash (ma_rate_notice_parser@1.8.1, run 20261029T122731Z-4e7e67d6); join ma_rate_notice_document on sha256_content_hash for the file.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["line_index","page","sha256_content_hash","token_index"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_projection","source_fqn":"medicare_silver.ma_rate_notice_projection","title":"MA rate notices CY2000-2027: the projection and trend-basis tables","domain":"medicare","stage":"silver","status":"live","grain":"One row per cell of the key projection, enrollment, Part A/B, service category and USPCC trend-basis tables: (sha256_content_hash,page,line_index,token_index).","description":"A product of the CMS MA rate notices (register cms_ma_rate_notices): the projection and trend-basis tables, one row per cell of the key projection, enrollment, Part A/B, service category and USPCC trend-basis tables. Built from the same load as the value table and pointing at the printed number (sha256_content_hash, page, line_index, source_line); never more certain than the print. Read the dataset's traps before comparing years.","identity_key":"sha256_content_hash,page,line_index,token_index","row_count":17358,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_projection","provenance_chain_ref":"Every row carries sha256_content_hash, source_line, asserted_at and parser_artifact_hash (ma_rate_notice_parser@1.8.1, run 20261029T122731Z-4e7e67d6); join ma_rate_notice_document on sha256_content_hash for the file.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["line_index","page","sha256_content_hash","token_index"],"backing_store":"glue"},{"source_id":"cms_ma_rate_notice_call_letter","source_fqn":"medicare_silver.ma_rate_notice_call_letter","title":"MA rate notices CY2000-2027: the call letter MOOP, cost-sharing and MLR tables","domain":"medicare","stage":"silver","status":"live","grain":"One row per cell of the MOOP, cost-sharing and MLR credibility tables: (sha256_content_hash,page,line_index,token_index).","description":"A product of the CMS MA rate notices (register cms_ma_rate_notices): the call letter MOOP, cost-sharing and MLR tables, one row per cell of the MOOP, cost-sharing and MLR credibility tables. Built from the same load as the value table and pointing at the printed number (sha256_content_hash, page, line_index, source_line); never more certain than the print. Read the dataset's traps before comparing years.","identity_key":"sha256_content_hash,page,line_index,token_index","row_count":2259,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_rate_notice_call_letter","provenance_chain_ref":"Every row carries sha256_content_hash, source_line, asserted_at and parser_artifact_hash (ma_rate_notice_parser@1.8.1, run 20261029T122731Z-4e7e67d6); join ma_rate_notice_document on sha256_content_hash for the file.","known_gaps":[],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"cms_ma_rate_notices","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["line_index","page","sha256_content_hash","token_index"],"backing_store":"glue"},{"source_id":"vw_medicaid_wa_provider_actual_payments_v1","source_fqn":"medicare_semantic.vw_medicaid_wa_provider_actual_payments_v1","title":"Washington Medicaid provider payments, actual: DSH, HSNA, SDP managed-care / DPH and trauma payments by provider and period (HCA)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per provider x program x period_key x metric (source_sha256 + source_locator unique); 8,702 rows, 10 programs, 124 periods (Athena 87ed7b91, 2026-10-19).","description":"What Washington Medicaid (HCA) paid hospitals and providers in DSH, hospital safety-net (HSNA CAH grants and FFS), state directed payments through managed care and DPH, and trauma payments, by the publisher's own period, from HCA PDFs and workbooks. Re-audited scope only; interim rows are labelled. Actual payments, not ceilings.","identity_key":"source_sha256,source_locator","row_count":8702,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_wa_provider_actual_payments_v1 (program = <one> AND period_key = <one>)","notes":"Registered 2026-10-19 under register w8 (wa_medicaid_provider_actual_payments) as the only read surface (registration branch codex/medicaid-fedreports). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_wa_provider_actual_payments_v1 is internal: no card, no World, refused NO_COVERAGE. Ships with the MCP lane's next main-based release.","superseded_by":null,"tools":[],"dataset_id":"wa_medicaid_provider_actual_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_locator","source_sha256"],"backing_store":"glue"},{"source_id":"vw_medicaid_az_provider_actual_payments_v1","source_fqn":"medicare_semantic.vw_medicaid_az_provider_actual_payments_v1","title":"Arizona Medicaid (AHCCCS) hospital payments, actual: inpatient, outpatient, DSH, GME, CAH, Prop202 and other components by hospital and year (FFY2019-2024)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per hospital x program (component) x period_key from the current summary edition (source_sha256 + source_locator unique); 4,461 rows, 9 programs, 12 periods (Athena 11b1c28f, 2026-10-19).","description":"What Arizona Medicaid paid each hospital by payment component and year, from the AHCCCS Hospital Payment Summary (current edition), with native FFY / SFY / academic-year periods. Re-audited scope only; RHIF is held for its period relabel. Actual payments (DSH and HEALTHII interim), not ceilings.","identity_key":"source_sha256,source_locator","row_count":4461,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_az_provider_actual_payments_v1 (program = <one> AND period_key = <one>)","notes":"Registered 2026-10-19 under register w8 (az_medicaid_provider_actual_payments) as the only read surface (registration branch codex/medicaid-fedreports). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_az_provider_actual_payments_v1 is internal: no card, no World, refused NO_COVERAGE. Ships with the MCP lane's next main-based release.","superseded_by":null,"tools":[],"dataset_id":"az_medicaid_provider_actual_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_locator","source_sha256"],"backing_store":"glue"},{"source_id":"vw_medicaid_tx_sdp_reconciliation_calculations_v1","source_fqn":"medicare_semantic.vw_medicaid_tx_sdp_reconciliation_calculations_v1","title":"Texas directed-payment reconciliation calculations (TIPPS, DPP-BHS, RAPPS) by NPI, plan and state fiscal year: NOT payments","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per NPI x plan x program x period_key (source_sha256 + source_locator unique); 42,503 rows: TIPPS 2,260, DPP-BHS 35,229, RAPPS 5,014, SFY2022-2025.","description":"Texas HHSC's published reconciliation workbooks for three directed-payment programs: scorecard, recalculated, allocation and recoupment CALCULATIONS by NPI and plan. These are calculations, not payments: no paid amount, no hospital receipt, never comparable with payments or SDP ceilings.","identity_key":"source_sha256,source_locator","row_count":42503,"last_updated":"2026-10-19","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_tx_sdp_reconciliation_calculations_v1 (program = <one> AND period_key = <one>)","notes":"Registered 2026-10-19 under register w8 (tx_medicaid_sdp_reconciliation_calculations) as the only read surface (registration branch codex/medicaid-fedreports). Door RAW, World W8, status partial, class unversioned. The base table medicare_silver.medicaid_tx_sdp_reconciliation_calculations_v1 is internal: no card, no World, refused NO_COVERAGE. Ships with the MCP lane's next main-based release.","superseded_by":null,"tools":[],"dataset_id":"tx_medicaid_sdp_reconciliation_calculations","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["source_locator","source_sha256"],"backing_store":"glue"},{"source_id":"vw_medicaid_procurement_open_now","source_fqn":"medicare_semantic.vw_medicaid_procurement_open_now","title":"Medicaid managed-care procurement open and upcoming watch, sourced partial tracker","domain":"state","stage":"semantic_view","status":"partial","grain":"One currently open or announced procurement per state and procurement ID; 22 rows in the 2026-10-28 snapshot.","description":"Officially sourced Medicaid plan and adjacent vendor procurements with the next published milestone. bidding_open_now distinguishes a verified open proposal window from an announced upcoming process.","identity_key":"state,procurement_id","row_count":22,"last_updated":"2026-10-28","freshness_sla":"Weekly Monday national re-check; source and milestone dates must be no more than seven days stale at promotion.","recollection":{"cadence":"weekly","watermark_field":"as_of_date","freshness_threshold":"7 days","expected_delta":null,"stale_behavior":"Withhold stale open status and re-check the official source.","caveats":["An announced procurement is upcoming and has no open bid window until the publisher posts one."]},"raw_queryable_via":"Athena: medicare_semantic.vw_medicaid_procurement_open_now","commercial_terms":"Public state procurement notices; consult each linked publisher's terms.","provenance_chain_ref":"docs/research/justin/procurement/SERVING-RECEIPT-20261028T042028Z.json","context_doc_path":"docs/research/justin/procurement/OPEN-NOW-RECHECK-2026-10-28.md","known_gaps":["Research-partial coverage; jurisdiction sweep and full national release gate remain incomplete.","A portal OPEN label alone is not proof that proposal submissions are currently open; use bidding_open_now and the source milestone."],"notes":"Immutable source snapshot da4461050879ae4a9b84db8a10783487612afaaed624356841f4a8856212b426 in vlada_curated.fact_medicaid_procurement_open_now_da4461050879. View includes coverage_status=research_partial. Readback 22 rows, Athena df6408c5-7776-41ca-a9de-f755d66697d5. MCP exposure is a separate release.","superseded_by":null,"tools":[],"dataset_id":null,"dataset_assignment_basis":null,"layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state"]},"technical_keys":[],"unmapped_key_tokens":["procurement_id"],"backing_store":"glue"},{"source_id":"medicaid_mco_rate_timing_v1","source_fqn":"medicare_semantic.vw_medicaid_mco_rate_timing_v1","title":"Medicaid managed care rate timing by certified cycle and amendment","domain":"state","stage":"semantic_view","status":"partial","grain":"One capitation v2 state, program, rating period and amendment key.","description":"Source-linked rate periods, certification dates, actuary and publisher-reported program change percentages with explicit nulls for unrecovered CMS submission, approval and amendment details. Successor dates distinguish published periods from period-end projections.","identity_key":"state_code,program_name_raw,rating_period_start,rating_period_end,amendment_seq","row_count":null,"last_updated":"2026-10-26","freshness_sla":"Event-driven after a certified capitation v2 edition is served.","recollection":{"cadence":"event_driven","watermark_field":"rating_period_start","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["A new v2 cycle edition flows through this view; projections need fresh source review before publication as a certified future cycle."]},"raw_queryable_via":"Athena read-only at medicare_semantic.vw_medicaid_mco_rate_timing_v1.","commercial_terms":"Vlada-derived from public state Medicaid publications.","provenance_chain_ref":"docs/operations/artifacts/medicaid-mco-rate-timing-v1-2026-10-26.SERVED.json","context_doc_path":"docs/context_library/medicaid/medicaid_mco_rate_timing_v1.md","known_gaps":["Source v2 is incomplete across states, programs and historical periods; this view does not imply a continuous national history.","Unpublished CMS submission and approval dates, effective amendment dates, amendment reasons and retroactivity remain null.","Period-end successor projections are explicitly marked and are not certified future rates."],"notes":"The shared capitation v2 cycle key also joins to rate_cell_v2; no rate cells are duplicated here.","superseded_by":null,"tools":[],"dataset_id":"medicaid_capitation_v1","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["amendment_seq","program_name_raw","rating_period_end","rating_period_start"],"backing_store":"glue"},{"source_id":"medicaid_mco_upcoming_rate_events_v1","source_fqn":"medicare_semantic.vw_medicaid_mco_upcoming_rate_events_v1","title":"Medicaid managed care upcoming rate-cycle events, next 18 months","domain":"state","stage":"semantic_view","status":"partial","grain":"Latest known program period successor event by state and program, next 18 months.","description":"Published or projected next rate-cycle start dates for each state-program with a current source period, with event-date basis and provenance. Projection is the day after the latest period end, and is not a published certification.","identity_key":"state_code,program_name_raw","row_count":null,"last_updated":"2026-10-26","freshness_sla":"Live relative 18-month window over the capitation v2 cycle edition.","recollection":{"cadence":"event_driven","watermark_field":"event_date","freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":["Recheck latest certification source and period completeness before treating a projected event as settled."]},"raw_queryable_via":"Athena read-only at medicare_semantic.vw_medicaid_mco_upcoming_rate_events_v1.","commercial_terms":"Vlada-derived from public state Medicaid publications.","provenance_chain_ref":"docs/operations/artifacts/medicaid-mco-rate-timing-v1-2026-10-26.SERVED.json","context_doc_path":"docs/context_library/medicaid/medicaid_mco_rate_timing_v1.md","known_gaps":["Missing latest program periods are absent; this is not a complete national events calendar.","Projected dates are period-end calculations, explicitly labeled, and not evidence that a successor was certified."],"notes":"Current-date filtered view; rate-cell values are not included.","superseded_by":null,"tools":[],"dataset_id":"medicaid_capitation_v1","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":["usps:state"],"entity_key_columns":{"usps:state":["state_code"]},"technical_keys":[],"unmapped_key_tokens":["program_name_raw"],"backing_store":"glue"},{"source_id":"medicaid_mco_forward_exposure_v1","source_fqn":"medicare_silver.medicaid_mco_forward_exposure_v1","title":"Medicaid MCO public-parent forward exposure, partial v7 cohort","domain":"state","stage":"silver","status":"partial","grain":"One public parent x forecast quarter x event_type x horizon_months.","description":"Reported v7 same-store component members facing a dated RFP or contract end, or a certified rate-cycle reset. Includes the observed denominator, known-schedule members, coverage, lower and upper exposure bounds, and an explicit held reason. The current edition contains ten accepted states and no publishable headline.","identity_key":"ticker,quarter,event_type,horizon_months","row_count":216,"last_updated":"2026-10-26","raw_queryable_via":"Athena (read-only) at medicare_silver.medicaid_mco_forward_exposure_v1; filter headline_publishable=true for any point estimate.","notes":"Content-addressed Parquet with serving lock, Glue location readback, 216 unique keys, six parents and zero published rows.","superseded_by":null,"tools":[],"dataset_id":"medicaid_mco_forward_exposure_v1","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["event_type","horizon_months","quarter","ticker"],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_rate_v2","source_fqn":"vlada_curated.vw_state_medicaid_rate_v2","title":"States M2 FFS rate book: vw_state_medicaid_rate_v2","domain":"state","stage":"semantic_view","status":"partial","grain":"The state's Medicaid fee-for-service fee schedules, one row per published rate. 294,254 rows (Athena, 2026-10-29). Period 2006-04-03 to 2027-01-01 (edition_effective_date).","description":"Medicaid product M2 (FFS rate book) of the States lane: the state's Medicaid fee-for-service fee schedules, one row per published rate. Filter state and is_current = true, then code (and modifiers, provider_type, setting) before reading rate; rate_type and rate_unit say what the number is (a fee, a percent of Medicare, a per-diem). These are the state's FFS maximums, never managed care negotiated rates. 46 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KY LA MD ME MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TX UT VA WA WI WV WY.","identity_key":null,"row_count":294254,"last_updated":"2026-10-29","freshness_sla":"Event-driven per state (each fee schedule edition).","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_rate_v2 (filter state)","provenance_chain_ref":"Served by the States lane (tools/states/publish_*.py; receipts under docs/research/states/_serving/); every row names its source sha256 and locator.","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 46 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KY LA MD ME MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TX UT VA WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","VERSIONED: read WHERE is_current (the door injects it on a single-table select)."],"notes":null,"superseded_by":null,"tools":["get_medicaid_rate"],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_rate_change_v1","source_fqn":"vlada_curated.vw_state_medicaid_rate_change_v1","title":"States M2 FFS rate book: vw_state_medicaid_rate_change_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per rate key per dated rate that moved against the previous dated rate (increase / decrease), or a code that first appears after the schedule''s first dated rate (new_code). 423,962 rows, 46 states (Athena, 2026-11-02 15:37Z serve; re-keyed by effective date 16:07Z).","description":"Medicaid product M2 (FFS rate book) of the States lane: what moved. Each rate is dated by its own effective date (cumulative schedules reprint old rates in every edition; the latest edition printing a dated rate wins); a change is one key whose rate differs from its previous dated rate, with prev_effective_from, effective_from, prev_rate, rate, change_kind, pct_change. ambiguous_key marks a printing with more than one rate for the same date; never average one. Filter state (and service_line, effective_from window) before reading.","identity_key":null,"row_count":null,"last_updated":"2026-11-02","freshness_sla":"Event-driven per state (each fee schedule edition); the view recomputes from vlada_curated.vw_state_medicaid_rate_v2 on every read.","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_rate_change_v1 (filter state or code)","provenance_chain_ref":"Served by the States lane (tools/states/publish_m2_rate_views.py; receipts under docs/research/states/_serving/m2-rate-views-*.json); every row names its source sha256 and locator. The typed door is get_medicaid_rate.","known_gaps":["Coverage is state by state (46 states with a change row on 2026-11-02); a state with no rows has one dated rate held or is not built yet, never flat.","A reprinted rate is one dated rate, not a change: schedules that reprint history (IA, NY, NC, ME) are read by effective date (docs/research/medicaid-ffs/KEYS-AMBIGUITY-2026-11-02.md).","Not versioned (a view over the versioned base); the base's is_current is applied inside the view's rules."],"notes":null,"superseded_by":null,"tools":["get_medicaid_rate"],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_rate_compare_v1","source_fqn":"vlada_curated.vw_state_medicaid_rate_compare_v1","title":"States M2 FFS rate book: vw_state_medicaid_rate_compare_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per state x code_system x code x modifiers x basis: the rate in force today (the latest dated rate on or before today for a key the current edition still prints), with the national median / p25 / p75 across states on the same basis, the state''s ratio and rank. 128,547 rows, 48 states (Athena, 2026-11-02).","description":"Medicaid product M2 (FFS rate book) of the States lane: one code across states on ONE basis. basis is per_hour when the unit is a time unit (rate x 60 / unit_minutes), else the printed unit; a state on another basis is a different row, never converted. Five-character CPT / HCPCS codes are mapped to code_system HCPCS so cpt and CPT compare together. Keys with more than one rate for the same date are left out (1 on 2026-11-02). Filter code (and modifiers, basis) before reading; state_rate is the median across the state's unambiguous keys.","identity_key":null,"row_count":null,"last_updated":"2026-11-02","freshness_sla":"Event-driven per state (each fee schedule edition); the view recomputes from vlada_curated.vw_state_medicaid_rate_v2 on every read.","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_rate_compare_v1 (filter state or code)","provenance_chain_ref":"Served by the States lane (tools/states/publish_m2_rate_views.py; receipts under docs/research/states/_serving/m2-rate-views-*.json); every row names its source sha256 and locator. The typed door is get_medicaid_rate.","known_gaps":["Comparison needs n_states >= 2 to mean anything; read n_states on the row (1,222 codes compared in 10+ states on 2026-11-02).","state_min / state_max show the spread across the state's schedules, programs and provider types for the code; state_rate is their median, not a single published number.","Not versioned (a view over the versioned base)."],"notes":null,"superseded_by":null,"tools":["get_medicaid_rate"],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_rate_vs_medicare_v1","source_fqn":"vlada_curated.vw_state_medicaid_rate_vs_medicare_v1","title":"States M2 FFS rate book: vw_state_medicaid_rate_vs_medicare_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per state x schedule x program x provider_type x setting x geography x population x code (no modifier, one printed rate): the Medicaid rate in force beside the Medicare PFS non-facility rate for the same code in the same state. 145,476 rows, 36 states (Athena, 2026-11-02).","description":"Medicaid product M2 (FFS rate book) of the States lane: Medicaid as a share of Medicare. medicare_rate is the Medicare Physician Fee Schedule non-facility amount, no modifier, the unweighted mean of the state's localities for the latest PFS year held (medicare_year, medicare_localities); medicaid_pct_of_medicare = medicaid_rate / medicare_rate. Only Medicaid rows with a per-service / unit / visit / 15_min unit and a 5-character CPT / HCPCS code join. Filter state (and code) before reading.","identity_key":null,"row_count":null,"last_updated":"2026-11-02","freshness_sla":"Event-driven per state (each fee schedule edition); the view recomputes from vlada_curated.vw_state_medicaid_rate_v2 on every read.","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_rate_vs_medicare_v1 (filter state or code)","provenance_chain_ref":"Served by the States lane (tools/states/publish_m2_rate_views.py; receipts under docs/research/states/_serving/m2-rate-views-*.json); every row names its source sha256 and locator. The typed door is get_medicaid_rate.","known_gaps":["The Medicare side is one basis (PFS non-facility, latest year): a Medicaid per-15-minute rate against a per-service Medicare amount is NOT a like-for-like share; read rate_unit before quoting medicaid_pct_of_medicare.","A code with no PFS RVU (status not A / R / T, or carrier-priced) has no row here; absence is not a zero.","Not versioned (a view over the versioned base)."],"notes":null,"superseded_by":null,"tools":["get_medicaid_rate"],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_procurement_contract_runway","source_fqn":"medicare_semantic.vw_medicaid_procurement_contract_runway","title":"States M5 RFP / procurement tracker: vw_medicaid_procurement_contract_runway","domain":"state","stage":"semantic_view","status":"partial","grain":"Medicaid managed care procurements: each contract's award, go-live, base and option term and the months left, with current members. 220 rows (Athena, 2026-10-29). Period 2014-01-01 to not_published (term_start).","description":"Medicaid product M5 (RFP / procurement tracker) of the States lane: Medicaid managed care procurements: each contract's award, go-live, base and option term and the months left, with current members. One row per state x program x procurement x winning entity. term_end_base and term_end_max are the contract's base and outside dates; extension_exercise_status says whether an option was used. Dates read 'not_published' where the state does not print them: that text is a finding, not a date. current_members is the latest enrollment month (current_enrollment_month), not the award. 43 state(s): AR AZ CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD MI MO MS NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC TN TX UT VA WA WI WV.","identity_key":null,"row_count":220,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_procurement_contract_runway (filter state)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m5_rfp_procurement_tracker","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mco_ownership_bridge_v1","source_fqn":"medicare_semantic.vw_medicaid_mco_ownership_bridge_v1","title":"States M6 Ownership + subcontracting: vw_medicaid_mco_ownership_bridge_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Who owns each Medicaid managed care plan and who it subcontracts to: the reviewed plan-to-parent bridge, the state ownership disclosures and the plan subcontracts. 577 rows (Athena, 2026-10-29). Period 2004-01-01 to 2026-07-01 (effective_start).","description":"Medicaid product M6 (Ownership + subcontracting) of the States lane: who owns each Medicaid managed care plan and who it subcontracts to: the reviewed plan-to-parent bridge, the state ownership disclosures and the plan subcontracts. vw_medicaid_mco_ownership_bridge_v1: one reviewed decision per plan identity, effective-dated (effective_start, effective_end); read the row whose interval covers your date. org_control_disclosure: one row per disclosed owner, ownership_percent as printed; a plan can list several owners and the percents need not sum to 100. medicaid_plan_subcontract_v1 (the subcontracting half): one row per state x plan (canonical id, dated parent) x function (pharmacy_pbm, dental, vision, behavioral_health, nemt) x subcontractor, dated valid_from / valid_to; arrangement says delegated_subcontract, affiliate_subcontract, plan_performs or carved_out_state_program. status = not_published rows are findings, never zero or absence. A delegate's members are never added to the prime's, and a delegated network is not a full-risk transfer. 43 state(s): AR AZ CA DC DE FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC TN TX UT VA WA WI WV.","identity_key":null,"row_count":577,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_ownership_bridge_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 43 state(s): AR AZ CA DC DE FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC TN TX UT VA WA WI WV.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m6_ownership_subcontracting","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_org_control_disclosure","source_fqn":"medicare_silver.org_control_disclosure","title":"States M6 Ownership + subcontracting: org_control_disclosure","domain":"state","stage":"silver","status":"partial","grain":"Who owns each Medicaid managed care plan and who it subcontracts to: the reviewed plan-to-parent bridge, the state ownership disclosures and the plan subcontracts. 1,663 rows (Athena, 2026-10-29). Period 2019-12-31 to 2026-10-13 (disclosure_date).","description":"Medicaid product M6 (Ownership + subcontracting) of the States lane: who owns each Medicaid managed care plan and who it subcontracts to: the reviewed plan-to-parent bridge, the state ownership disclosures and the plan subcontracts. vw_medicaid_mco_ownership_bridge_v1: one reviewed decision per plan identity, effective-dated (effective_start, effective_end); read the row whose interval covers your date. org_control_disclosure: one row per disclosed owner, ownership_percent as printed; a plan can list several owners and the percents need not sum to 100. medicaid_plan_subcontract_v1 (the subcontracting half): one row per state x plan (canonical id, dated parent) x function (pharmacy_pbm, dental, vision, behavioral_health, nemt) x subcontractor, dated valid_from / valid_to; arrangement says delegated_subcontract, affiliate_subcontract, plan_performs or carved_out_state_program. status = not_published rows are findings, never zero or absence. A delegate's members are never added to the prime's, and a delegated network is not a full-risk transfer. 20 state(s): AR AZ FL GA HI IL KY LA MA MI NC NJ NY OH PA TN TX UT VA WA.","identity_key":null,"row_count":1663,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.org_control_disclosure (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 20 state(s): AR AZ FL GA HI IL KY LA MA MI NC NJ NY OH PA TN TX UT VA WA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m6_ownership_subcontracting","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_az_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_az_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_az_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 6 rows (Athena, 2026-10-29). Period 2026-10-01 to 2026-10-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): AZ.","identity_key":null,"row_count":6,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_az_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): AZ.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_ca_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_ca_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_ca_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 22 rows (Athena, 2026-10-29). Period 2026-09-01 to 2026-09-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): CA.","identity_key":null,"row_count":22,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ca_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): CA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_fl_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_fl_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_fl_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 27 rows (Athena, 2026-10-29). Period 2026-09-30 to 2026-09-30 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): FL.","identity_key":null,"row_count":27,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_fl_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): FL.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_ga_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_ga_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_ga_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 3 rows (Athena, 2026-10-29). Period 2022-05-01 to 2022-05-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): GA.","identity_key":null,"row_count":3,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ga_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): GA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_il_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_il_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_il_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 5 rows (Athena, 2026-10-29). Period 2026-09-01 to 2026-09-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): IL.","identity_key":null,"row_count":5,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_il_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): IL.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_in_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_in_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_in_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 12 rows (Athena, 2026-10-29). Period 2026-09-01 to 2026-09-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): IN.","identity_key":null,"row_count":12,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_in_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): IN.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_ky_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_ky_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_ky_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 5 rows (Athena, 2026-10-29). Period 2026-08-01 to 2026-08-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): KY.","identity_key":null,"row_count":5,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ky_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): KY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_la_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_la_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_la_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 5 rows (Athena, 2026-10-29). Period 2026-07-01 to 2026-07-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): LA.","identity_key":null,"row_count":5,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_la_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): LA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_mi_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_mi_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_mi_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 9 rows (Athena, 2026-10-29). Period 2026-09-01 to 2026-09-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): MI.","identity_key":null,"row_count":9,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_mi_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MI.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_mn_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_mn_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_mn_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 32 rows (Athena, 2026-10-29).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): MN.","identity_key":null,"row_count":32,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_mn_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MN.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","No observation_period column (older exposure schema)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_mo_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_mo_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_mo_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 3 rows (Athena, 2026-10-29).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): MO.","identity_key":null,"row_count":3,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_mo_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MO.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","No observation_period column (older exposure schema)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_ms_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_ms_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_ms_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 3 rows (Athena, 2026-10-29).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): MS.","identity_key":null,"row_count":3,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ms_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MS.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","No observation_period column (older exposure schema)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_nc_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_nc_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_nc_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 8 rows (Athena, 2026-10-29). Period 2026-10-01 to 2026-10-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): NC.","identity_key":null,"row_count":8,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_nc_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NC.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_nj_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_nj_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_nj_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 5 rows (Athena, 2026-10-29). Period 2026-08-01 to 2026-08-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): NJ.","identity_key":null,"row_count":5,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_nj_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NJ.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_ny_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_ny_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_ny_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 12 rows (Athena, 2026-10-29). Period 2026-09-01 to 2026-09-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): NY.","identity_key":null,"row_count":12,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ny_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_oh_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_oh_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_oh_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 6 rows (Athena, 2026-10-29). Period 2014-06-01 to 2014-06-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): OH.","identity_key":null,"row_count":6,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_oh_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): OH.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_ok_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_ok_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_ok_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 3 rows (Athena, 2026-10-29).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): OK.","identity_key":null,"row_count":3,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_ok_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): OK.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","No observation_period column (older exposure schema)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_pa_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_pa_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_pa_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 7 rows (Athena, 2026-10-29). Period 2026-09-01 to 2026-09-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): PA.","identity_key":null,"row_count":7,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_pa_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): PA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_tx_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_tx_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_tx_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 32 rows (Athena, 2026-10-29). Period 2026-05-01 to 2026-05-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): TX.","identity_key":null,"row_count":32,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_tx_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): TX.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_va_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_va_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_va_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 5 rows (Athena, 2026-10-29). Period 2026-10-01 to 2026-10-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): VA.","identity_key":null,"row_count":5,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_va_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): VA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_wa_medicaid_mco_rate_procurement_exposure_v1","source_fqn":"medicare_semantic.vw_wa_medicaid_mco_rate_procurement_exposure_v1","title":"States M7 Forward exposure: vw_wa_medicaid_mco_rate_procurement_exposure_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. 5 rows (Athena, 2026-10-29). Period 2026-09-01 to 2026-09-01 (observation_period).","description":"Medicaid product M7 (Forward exposure) of the States lane: forward exposure: members whose plan faces a rate reset or a procurement event, by plan and parent. One view per state (vw_<st>_medicaid_mco_rate_procurement_exposure_v1). One row per plan for the observation period; enrollment_with_rate_reset_next_6_months is members, not plans. MN, MO, MS and OK views are an older schema without observation_period. 1 state(s): WA.","identity_key":null,"row_count":5,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_wa_medicaid_mco_rate_procurement_exposure_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): WA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m7_forward_exposure","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mcpar_plan_pdf_2025_v1","source_fqn":"medicare_semantic.vw_medicaid_mcpar_plan_pdf_2025_v1","title":"States M8 Federal reports + payments: vw_medicaid_mcpar_plan_pdf_2025_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Federal Medicaid managed care reports by plan (MCPAR 2025 responses, plan MLR). 40,590 rows (Athena, 2026-10-30). Period 2025 to 2025 ('2025').","description":"Medicaid product M8 (Federal reports + payments) of the States lane: federal Medicaid managed care reports by plan (MCPAR 2025 responses, plan MLR). vw_medicaid_mcpar_plan_pdf_2025_v1: one row per plan x MCPAR question as printed (response_raw; response_numeric when it parses); filter question_number. vw_medicaid_mcpar_pdf_source_2025_v1 is its locator: one row per state x program PDF (source_url, sha256_content_hash, source_pages); plan_table_status not_printed means the PDF prints no plan table, so that program has no plan rows, never zero plans. vw_medicaid_mlr_plan_v1: one row per plan x reporting period; adjusted_mlr_printed is the state's printed ratio, never recompute it from the numerator and denominator. 42 state(s): AR AZ CA CO DC FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS NC ND NE NH NJ NM NV OH OK PA PR RI SC TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":40590,"last_updated":"2026-10-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mcpar_plan_pdf_2025_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 42 state(s): AR AZ CA CO DC FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS NC ND NE NH NJ NM NV OH OK PA PR RI SC TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m8_federal_reports_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mlr_plan_v1","source_fqn":"medicare_semantic.vw_medicaid_mlr_plan_v1","title":"States M8 Federal reports + payments: vw_medicaid_mlr_plan_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Federal Medicaid managed care reports by plan (MCPAR 2025 responses, plan MLR). 1,926 rows (Athena, 2026-10-30). Period 2017 to 2022 (report_year).","description":"Medicaid product M8 (Federal reports + payments) of the States lane: federal Medicaid managed care reports by plan (MCPAR 2025 responses, plan MLR). vw_medicaid_mcpar_plan_pdf_2025_v1: one row per plan x MCPAR question as printed (response_raw; response_numeric when it parses); filter question_number. vw_medicaid_mcpar_pdf_source_2025_v1 is its locator: one row per state x program PDF (source_url, sha256_content_hash, source_pages); plan_table_status not_printed means the PDF prints no plan table, so that program has no plan rows, never zero plans. vw_medicaid_mlr_plan_v1: one row per plan x reporting period; adjusted_mlr_printed is the state's printed ratio, never recompute it from the numerator and denominator. 23 state(s): AL AZ CA DE FL GA IL IN KY LA MI MO NC NJ NY OH OR PA SC TN TX VA WA.","identity_key":null,"row_count":1926,"last_updated":"2026-10-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mlr_plan_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 23 state(s): AL AZ CA DE FL GA IL IN KY LA MI MO NC NJ NY OH OR PA SC TN TX VA WA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m8_federal_reports_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_rate_review_puf_current_v1","source_fqn":"medicare_semantic.vw_rate_review_puf_current_v1","title":"States K2 Rate filing book: vw_rate_review_puf_current_v1","domain":"commercial","stage":"semantic_view","status":"partial","grain":"The ACA rate filing book: every filing in the CMS Unified Rate Review PUF, by issuer x state x market, with the build-up and the year-over-year drivers. 1,030,348 rows (Athena, 2026-10-29). Period 2014 to 2026 (plan_year).","description":"Marketplace product K2 (Rate filing book) of the States lane: the ACA rate filing book: every filing in the CMS Unified Rate Review PUF, by issuer x state x market, with the build-up and the year-over-year drivers. vw_rate_review_puf_current_v1 is the PUF's current bytes per plan year (filter plan_year and worksheet). vw_rate_filing_market_v1 is one row per filing with its build-up; vw_rate_filing_yoy_drivers_v1 sets each issuer x state x market against its prior year with the parent. schema_era changes column meaning (G54 in 2016); -9.99 is a placeholder, not a value (docs/context_library/commercial/rate_review_puf.md). 51 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":1030348,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_rate_review_puf_current_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 51 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k2_rate_filing_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_marketplace_state_rate_decision_v1","source_fqn":"medicare_silver.marketplace_state_rate_decision_v1","title":"States K3 Rate review cycle + state rules: marketplace_state_rate_decision_v1","domain":"commercial","stage":"silver","status":"partial","grain":"State rate review decisions and each state's filing calendar and rules. 16,001 rows (Athena, 2026-10-29). Period 2013 to 2027 (plan_year_int).","description":"Marketplace product K3 (Rate review cycle + state rules) of the States lane: state rate review decisions and each state's filing calendar and rules. marketplace_state_rate_decision_v1: one row per state x plan year x market x issuer decision; requested_pct_num and approved_pct_num are percents; statewide_bool rows are the state's average, never add them to issuer rows. marketplace_state_calendar_rule_v1: one row per state x plan year x calendar item (kind, item, value_raw, effective_date_d). 51 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":16001,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_state_rate_decision_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k3_rate_review_cycle_state_rules","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_marketplace_state_calendar_rule_v1","source_fqn":"medicare_silver.marketplace_state_calendar_rule_v1","title":"States K3 Rate review cycle + state rules: marketplace_state_calendar_rule_v1","domain":"commercial","stage":"silver","status":"partial","grain":"State rate review decisions and each state's filing calendar and rules. 3,509 rows (Athena, 2026-10-29). Period 2014 to 2029 (plan_year_int).","description":"Marketplace product K3 (Rate review cycle + state rules) of the States lane: state rate review decisions and each state's filing calendar and rules. marketplace_state_rate_decision_v1: one row per state x plan year x market x issuer decision; requested_pct_num and approved_pct_num are percents; statewide_bool rows are the state's average, never add them to issuer rows. marketplace_state_calendar_rule_v1: one row per state x plan year x calendar item (kind, item, value_raw, effective_date_d). 51 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":3509,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_state_calendar_rule_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k3_rate_review_cycle_state_rules","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_marketplace_state_participation_event_v1","source_fqn":"medicare_silver.marketplace_state_participation_event_v1","title":"States K4 Participation / certification tracker: marketplace_state_participation_event_v1","domain":"commercial","stage":"silver","status":"partial","grain":"Issuer entries, exits and county footprint changes in each state's Marketplace. 2,740 rows (Athena, 2026-10-29). Period 2011 to 2027 (plan_year_int).","description":"Marketplace product K4 (Participation / certification tracker) of the States lane: issuer entries, exits and county footprint changes in each state's Marketplace. One row per state x plan year x issuer event (event: enter, exit, expand, reduce); counties_raw as printed. evidence_kind says whether the event was announced or inferred by comparing two documents. 51 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":2740,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_state_participation_event_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k4_participation_certification_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_marketplace_issuer_parent_v1","source_fqn":"medicare_silver.marketplace_issuer_parent_v1","title":"States K5 Ownership / affiliation / delegation: marketplace_issuer_parent_v1","domain":"commercial","stage":"silver","status":"partial","grain":"Each Marketplace issuer's legal entity and its dated parent. 8,676 rows (Athena, 2026-10-29). Period 2014 to 2026 (plan_year).","description":"Marketplace product K5 (Ownership / affiliation / delegation) of the States lane: each Marketplace issuer's legal entity and its dated parent. One row per state x plan year x market x HIOS issuer. Pick one parent basis (canonical_parent_id_as_was or _as_now) and read parent_resolution_status; filter in_enrollment = 'true' for issuers with members. 51 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":8676,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_issuer_parent_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k5_ownership_affiliation_delegation","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_marketplace_forward_exposure_v1","source_fqn":"medicare_silver.marketplace_forward_exposure_v1","title":"States K8 Forward exposure: marketplace_forward_exposure_v1","domain":"commercial","stage":"silver","status":"partial","grain":"Forward exposure in the Marketplace: members facing a known event by parent. 19,530 rows (Athena, 2026-10-29). Period 2026 to 2028 (forecast_year).","description":"Marketplace product K8 (Forward exposure) of the States lane: forward exposure in the Marketplace: members facing a known event by parent. One row per state x parent x measure x forecast quarter. Quote the lower and upper bounds beside the point estimate; headline_publishable = false rows are held (held_reasons) and are not a headline. 51 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":19530,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_forward_exposure_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k8_forward_exposure","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_state_coverage_block_v1","source_fqn":"medicare_silver.state_coverage_block_v1","title":"States W1 Coverage map: state_coverage_block_v1","domain":"state","stage":"silver","status":"partial","grain":"Coverage by source (employer, Medicare, Medicaid, Marketplace, uninsured) by county and age band, from Census tables. 330,720 rows (Athena, 2026-10-29). Period 2019 to 2024 (estimate_year).","description":"State product W1 (Coverage map) of the States lane: coverage by source (employer, Medicare, Medicaid, Marketplace, uninsured) by county and age band, from Census tables. One row per state x county x estimate year x coverage block x age band; members over population_universe is the share. additive_to_population = false blocks overlap (dual coverage) and must not be summed. 10 state(s): CA FL GA IL MI NC NY OH PA TX.","identity_key":null,"row_count":330720,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_coverage_block_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w1_coverage_map","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_state_facility_v1","source_fqn":"medicare_silver.state_facility_v1","title":"States W2 Facilities, ownership + finances: state_facility_v1","domain":"hospital","stage":"silver","status":"partial","grain":"Every licensed facility in the state with its owner, chain, 340B status and latest cost report finances. 239,616 rows (Athena, 2026-10-29). Period 2026-06-25 to 2026-10-18 (as_of).","description":"State product W2 (Facilities, ownership + finances) of the States lane: every licensed facility in the state with its owner, chain, 340B status and latest cost report finances. One row per facility. facility_class separates hospitals, SNFs, labs and the rest; owner_status and cost_report_status say when the owner or finances are missing, never read a null margin as zero. 15 state(s): AZ CA FL GA IL MI NC NJ NY OH PA TN TX VA WA.","identity_key":null,"row_count":239616,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.state_facility_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w2_facilities_ownership_finances","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_state_affiliation_edge_v1","source_fqn":"vlada_curated.state_affiliation_edge_v1","title":"States W3 Networks + affiliations: state_affiliation_edge_v1","domain":"hospital","stage":"silver","status":"partial","grain":"Affiliation edges: which clinician, group or facility belongs to which system, dated, with evidence. 7,013,685 rows (Athena, 2026-10-29). Period 2016-08-30 to 2026-10-29 (as_of).","description":"State product W3 (Networks + affiliations) of the States lane: affiliation edges: which clinician, group or facility belongs to which system, dated, with evidence. One row per child -> parent edge (child_kind, parent_kind, edge_type) with first_seen / last_seen; filter state_code. last_seen is the last file the edge appeared in, not an end date. 5 state(s): CA FL NY PA TX.","identity_key":null,"row_count":7013685,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.state_affiliation_edge_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w3_networks_affiliations","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_al_v1","source_fqn":"medicare_semantic.vw_state_medicare_al_v1","title":"States W4 Medicare in the state: vw_state_medicare_al_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 455,947 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): AL.","identity_key":null,"row_count":455947,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_al_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): AL.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ar_v1","source_fqn":"medicare_semantic.vw_state_medicare_ar_v1","title":"States W4 Medicare in the state: vw_state_medicare_ar_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 509,894 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): AR.","identity_key":null,"row_count":509894,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ar_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): AR.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_az_v1","source_fqn":"medicare_semantic.vw_state_medicare_az_v1","title":"States W4 Medicare in the state: vw_state_medicare_az_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 106,297 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): AZ.","identity_key":null,"row_count":106297,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_az_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): AZ.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ca_v1","source_fqn":"medicare_semantic.vw_state_medicare_ca_v1","title":"States W4 Medicare in the state: vw_state_medicare_ca_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 397,361 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): CA.","identity_key":null,"row_count":397361,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ca_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): CA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_co_v1","source_fqn":"medicare_semantic.vw_state_medicare_co_v1","title":"States W4 Medicare in the state: vw_state_medicare_co_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 423,517 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): CO.","identity_key":null,"row_count":423517,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_co_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): CO.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ct_v1","source_fqn":"medicare_semantic.vw_state_medicare_ct_v1","title":"States W4 Medicare in the state: vw_state_medicare_ct_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 59,978 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): CT.","identity_key":null,"row_count":59978,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ct_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): CT.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_fl_v1","source_fqn":"medicare_semantic.vw_state_medicare_fl_v1","title":"States W4 Medicare in the state: vw_state_medicare_fl_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 479,334 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): FL.","identity_key":null,"row_count":479334,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_fl_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): FL.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ga_v1","source_fqn":"medicare_semantic.vw_state_medicare_ga_v1","title":"States W4 Medicare in the state: vw_state_medicare_ga_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 1,123,967 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): GA.","identity_key":null,"row_count":1123967,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ga_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): GA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ia_v1","source_fqn":"medicare_semantic.vw_state_medicare_ia_v1","title":"States W4 Medicare in the state: vw_state_medicare_ia_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 659,130 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): IA.","identity_key":null,"row_count":659130,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ia_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): IA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_il_v1","source_fqn":"medicare_semantic.vw_state_medicare_il_v1","title":"States W4 Medicare in the state: vw_state_medicare_il_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 708,106 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): IL.","identity_key":null,"row_count":708106,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_il_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): IL.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_in_v1","source_fqn":"medicare_semantic.vw_state_medicare_in_v1","title":"States W4 Medicare in the state: vw_state_medicare_in_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 635,654 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): IN.","identity_key":null,"row_count":635654,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_in_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): IN.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ks_v1","source_fqn":"medicare_semantic.vw_state_medicare_ks_v1","title":"States W4 Medicare in the state: vw_state_medicare_ks_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 688,235 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): KS.","identity_key":null,"row_count":688235,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ks_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): KS.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ky_v1","source_fqn":"medicare_semantic.vw_state_medicare_ky_v1","title":"States W4 Medicare in the state: vw_state_medicare_ky_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 819,154 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): KY.","identity_key":null,"row_count":819154,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ky_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): KY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_la_v1","source_fqn":"medicare_semantic.vw_state_medicare_la_v1","title":"States W4 Medicare in the state: vw_state_medicare_la_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 446,306 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): LA.","identity_key":null,"row_count":446306,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_la_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): LA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ma_v1","source_fqn":"medicare_semantic.vw_state_medicare_ma_v1","title":"States W4 Medicare in the state: vw_state_medicare_ma_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 101,496 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): MA.","identity_key":null,"row_count":101496,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ma_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_md_v1","source_fqn":"medicare_semantic.vw_state_medicare_md_v1","title":"States W4 Medicare in the state: vw_state_medicare_md_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 163,047 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): MD.","identity_key":null,"row_count":163047,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_md_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MD.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_mi_v1","source_fqn":"medicare_semantic.vw_state_medicare_mi_v1","title":"States W4 Medicare in the state: vw_state_medicare_mi_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 563,466 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): MI.","identity_key":null,"row_count":563466,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_mi_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MI.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_mn_v1","source_fqn":"medicare_semantic.vw_state_medicare_mn_v1","title":"States W4 Medicare in the state: vw_state_medicare_mn_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 575,850 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): MN.","identity_key":null,"row_count":575850,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_mn_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MN.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_mo_v1","source_fqn":"medicare_semantic.vw_state_medicare_mo_v1","title":"States W4 Medicare in the state: vw_state_medicare_mo_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 777,069 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): MO.","identity_key":null,"row_count":777069,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_mo_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MO.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ms_v1","source_fqn":"medicare_semantic.vw_state_medicare_ms_v1","title":"States W4 Medicare in the state: vw_state_medicare_ms_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 545,656 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): MS.","identity_key":null,"row_count":545656,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ms_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MS.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_nc_v1","source_fqn":"medicare_semantic.vw_state_medicare_nc_v1","title":"States W4 Medicare in the state: vw_state_medicare_nc_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 703,326 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): NC.","identity_key":null,"row_count":703326,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_nc_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NC.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_nj_v1","source_fqn":"medicare_semantic.vw_state_medicare_nj_v1","title":"States W4 Medicare in the state: vw_state_medicare_nj_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 149,820 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): NJ.","identity_key":null,"row_count":149820,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_nj_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NJ.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_nv_v1","source_fqn":"medicare_semantic.vw_state_medicare_nv_v1","title":"States W4 Medicare in the state: vw_state_medicare_nv_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 117,655 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): NV.","identity_key":null,"row_count":117655,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_nv_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NV.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ny_v1","source_fqn":"medicare_semantic.vw_state_medicare_ny_v1","title":"States W4 Medicare in the state: vw_state_medicare_ny_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 438,270 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): NY.","identity_key":null,"row_count":438270,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ny_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_oh_v1","source_fqn":"medicare_semantic.vw_state_medicare_oh_v1","title":"States W4 Medicare in the state: vw_state_medicare_oh_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 628,001 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): OH.","identity_key":null,"row_count":628001,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_oh_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): OH.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ok_v1","source_fqn":"medicare_semantic.vw_state_medicare_ok_v1","title":"States W4 Medicare in the state: vw_state_medicare_ok_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 513,759 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): OK.","identity_key":null,"row_count":513759,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ok_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): OK.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_or_v1","source_fqn":"medicare_semantic.vw_state_medicare_or_v1","title":"States W4 Medicare in the state: vw_state_medicare_or_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 242,380 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): OR.","identity_key":null,"row_count":242380,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_or_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): OR.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_pa_v1","source_fqn":"medicare_semantic.vw_state_medicare_pa_v1","title":"States W4 Medicare in the state: vw_state_medicare_pa_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 492,394 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): PA.","identity_key":null,"row_count":492394,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_pa_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): PA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_sc_v1","source_fqn":"medicare_semantic.vw_state_medicare_sc_v1","title":"States W4 Medicare in the state: vw_state_medicare_sc_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 325,937 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): SC.","identity_key":null,"row_count":325937,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_sc_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): SC.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_tn_v1","source_fqn":"medicare_semantic.vw_state_medicare_tn_v1","title":"States W4 Medicare in the state: vw_state_medicare_tn_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 651,283 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): TN.","identity_key":null,"row_count":651283,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_tn_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): TN.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_tx_v1","source_fqn":"medicare_semantic.vw_state_medicare_tx_v1","title":"States W4 Medicare in the state: vw_state_medicare_tx_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 1,782,138 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): TX.","identity_key":null,"row_count":1782138,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_tx_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): TX.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_ut_v1","source_fqn":"medicare_semantic.vw_state_medicare_ut_v1","title":"States W4 Medicare in the state: vw_state_medicare_ut_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 193,226 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): UT.","identity_key":null,"row_count":193226,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_ut_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): UT.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_va_v1","source_fqn":"medicare_semantic.vw_state_medicare_va_v1","title":"States W4 Medicare in the state: vw_state_medicare_va_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 928,540 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): VA.","identity_key":null,"row_count":928540,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_va_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): VA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_wa_v1","source_fqn":"medicare_semantic.vw_state_medicare_wa_v1","title":"States W4 Medicare in the state: vw_state_medicare_wa_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 262,250 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): WA.","identity_key":null,"row_count":262250,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_wa_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): WA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicare_wi_v1","source_fqn":"medicare_semantic.vw_state_medicare_wi_v1","title":"States W4 Medicare in the state: vw_state_medicare_wi_v1","domain":"medicare","stage":"semantic_view","status":"partial","grain":"Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. 493,458 rows (Athena, 2026-10-29). Period 2019 to 2027 (period_year).","description":"State product W4 (Medicare in the state) of the States lane: Medicare in the state: MA enrollment, plans and parents by county and year, Original Medicare, and the plan-county rows. One view per state (vw_state_medicare_<st>_v1). Filter row_kind first (e.g. plan_county_year), then measure; value is one measure per row, so never sum across measures. canonical_parent_id is dated (parent_as_of). 1 state(s): WI.","identity_key":null,"row_count":493458,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_state_medicare_wi_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): WI.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w4_medicare_in_the_state","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_state_pricing_coverage_v1","source_fqn":"vlada_curated.state_pricing_coverage_v1","title":"States W5 Pricing coverage: state_pricing_coverage_v1","domain":"hospital","stage":"silver","status":"partial","grain":"Pricing coverage: for each site x payer, whether we hold a negotiated price, why not, and the members a gap affects. 256,223 rows (Athena, 2026-10-29). Period 2026-10-28 to 2026-10-29 (as_of).","description":"State product W5 (Pricing coverage) of the States lane: pricing coverage: for each site x payer, whether we hold a negotiated price, why not, and the members a gap affects. One row per site x payer x price_kind; has_price false rows carry missing_reason and members_affected. This is coverage of our price holdings, never a price. 9 state(s): CA FL GA IL NC NY OH PA TX.","identity_key":null,"row_count":256223,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.state_pricing_coverage_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w5_pricing_coverage","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_state_quality_v1","source_fqn":"vlada_curated.state_quality_v1","title":"States W6 Quality: state_quality_v1","domain":"hospital","stage":"silver","status":"partial","grain":"Quality by entity (plans, hospitals, facilities) with its parent, every measure and rating status. 538,616 rows (Athena, 2026-10-29). Period 2015-01-01 to 2026-10-08 (as_of).","description":"State product W6 (Quality) of the States lane: quality by entity (plans, hospitals, facilities) with its parent, every measure and rating status. One row per entity x program x measure x period. Filter quality_program and is_latest; rating_status and not_rated_reason explain a missing value, which is never zero. 8 state(s): CA FL GA IL NY OH PA TX.","identity_key":null,"row_count":538616,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.state_quality_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w6_quality","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_state_employer_plan_v1","source_fqn":"vlada_curated.state_employer_plan_v1","title":"States W7 Employer coverage: state_employer_plan_v1","domain":"drug","stage":"silver","status":"partial","grain":"Employer health plans filed on Form 5500: sponsor, size, funding, carriers, brokers and premiums. 138,488 rows (Athena, 2026-10-29). Period 2022 to 2025 (plan_year).","description":"State product W7 (Employer coverage) of the States lane: employer health plans filed on Form 5500: sponsor, size, funding, carriers, brokers and premiums. One row per filing (ack_id) x plan year. funding_class says insured vs self-funded; premiums and broker commissions come from Schedule A and are blank on self-funded plans. 11 state(s): CA FL GA IL MI NC NJ NY OH PA TX.","identity_key":null,"row_count":138488,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.state_employer_plan_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w7_employer_coverage","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_rate_filing_market_v1","source_fqn":"medicare_semantic.vw_rate_filing_market_v1","title":"States K2 Rate filing book: vw_rate_filing_market_v1","domain":"commercial","stage":"semantic_view","status":"partial","grain":"The ACA rate filing book: every filing in the CMS Unified Rate Review PUF, by issuer x state x market, with the build-up and the year-over-year drivers. 12,967 rows (Athena, 2026-10-29).","description":"Marketplace product K2 (Rate filing book) of the States lane: the ACA rate filing book: every filing in the CMS Unified Rate Review PUF, by issuer x state x market, with the build-up and the year-over-year drivers. vw_rate_review_puf_current_v1 is the PUF's current bytes per plan year (filter plan_year and worksheet). vw_rate_filing_market_v1 is one row per filing with its build-up; vw_rate_filing_yoy_drivers_v1 sets each issuer x state x market against its prior year with the parent. schema_era changes column meaning (G54 in 2016); -9.99 is a placeholder, not a value (docs/context_library/commercial/rate_review_puf.md).","identity_key":null,"row_count":12967,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_rate_filing_market_v1","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k2_rate_filing_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_rate_filing_yoy_drivers_v1","source_fqn":"medicare_semantic.vw_rate_filing_yoy_drivers_v1","title":"States K2 Rate filing book: vw_rate_filing_yoy_drivers_v1","domain":"commercial","stage":"semantic_view","status":"partial","grain":"The ACA rate filing book: every filing in the CMS Unified Rate Review PUF, by issuer x state x market, with the build-up and the year-over-year drivers. 11,187 rows (Athena, 2026-10-29).","description":"Marketplace product K2 (Rate filing book) of the States lane: the ACA rate filing book: every filing in the CMS Unified Rate Review PUF, by issuer x state x market, with the build-up and the year-over-year drivers. vw_rate_review_puf_current_v1 is the PUF's current bytes per plan year (filter plan_year and worksheet). vw_rate_filing_market_v1 is one row per filing with its build-up; vw_rate_filing_yoy_drivers_v1 sets each issuer x state x market against its prior year with the parent. schema_era changes column meaning (G54 in 2016); -9.99 is a placeholder, not a value (docs/context_library/commercial/rate_review_puf.md).","identity_key":null,"row_count":11187,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_rate_filing_yoy_drivers_v1","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k2_rate_filing_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"vlada_ontology_l1_entity","source_fqn":"vlada_ontology.l1_entity","title":"Vlada ontology layer one (entity)","domain":"curated","stage":"mart","status":"live","grain":"One row per entity (entity_id): legal entity, brand, NAIC group, instrument (contract, plan, Medicaid plan, HIOS issuer), place; status active, redirected (with redirect_to) or ended.","description":"The Vlada ontology, layer one (who holds and who owns every Medicare, Medicaid and Marketplace instrument, over time), SIGNED by Ben on build v3o (2026-10-28; docs/architecture/ontology-v2/L1-SIGNOFF.md). Permanent IDs; a legal entity is not its brand nor the contract it holds; history is dated events with filings; every fact graded A/B/C with its evidence; two clocks. Built by tools/ontology2/build.py, served by tools/ontology2/serve.py (the view moves only to a signed build). Tools: resolve_entity, describe_entity; API: /v1/entities.","identity_key":"entity_id","row_count":153681,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only): vlada_ontology.l1_entity","notes":"Dates are strings YYYY-MM-DD; an empty valid_to is an open end; from_basis first_observed means \"at least since\"; observed_to means \"last seen\". Skill docs/architecture/ontology-v2/API-CONTRACT.md.","superseded_by":null,"tools":["describe_entity","resolve_entity"],"dataset_id":"vlada_spine_ontology_l1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["entity_id"],"backing_store":"glue"},{"source_id":"vlada_ontology_l1_identifier","source_fqn":"vlada_ontology.l1_identifier","title":"Vlada ontology layer one (identifier)","domain":"curated","stage":"mart","status":"live","grain":"One row per identifier that names an entity: namespace (cms_org_name, ein, naic, cik, hios, ...), value, value_norm, validity window, evidence.","description":"The Vlada ontology, layer one (who holds and who owns every Medicare, Medicaid and Marketplace instrument, over time), SIGNED by Ben on build v3o (2026-10-28; docs/architecture/ontology-v2/L1-SIGNOFF.md). Permanent IDs; a legal entity is not its brand nor the contract it holds; history is dated events with filings; every fact graded A/B/C with its evidence; two clocks. Built by tools/ontology2/build.py, served by tools/ontology2/serve.py (the view moves only to a signed build). Tools: resolve_entity, describe_entity; API: /v1/entities.","identity_key":"entity_id","row_count":4716,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only): vlada_ontology.l1_identifier","notes":"Dates are strings YYYY-MM-DD; an empty valid_to is an open end; from_basis first_observed means \"at least since\"; observed_to means \"last seen\". Skill docs/architecture/ontology-v2/API-CONTRACT.md.","superseded_by":null,"tools":["describe_entity","resolve_entity"],"dataset_id":"vlada_spine_ontology_l1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["entity_id"],"backing_store":"glue"},{"source_id":"vlada_ontology_l1_edge","source_fqn":"vlada_ontology.l1_edge","title":"Vlada ontology layer one (edge)","domain":"curated","stage":"mart","status":"live","grain":"One row per SERVED dated relationship: held_by, reported_parent, member_of_group, owned_by, controlled_by (basis, grade), brand_of, merged_into, part_of, continues_as; from_basis, observed and confirmed windows; candidate and refuted rows never appear.","description":"The Vlada ontology, layer one (who holds and who owns every Medicare, Medicaid and Marketplace instrument, over time), SIGNED by Ben on build v3o (2026-10-28; docs/architecture/ontology-v2/L1-SIGNOFF.md). Permanent IDs; a legal entity is not its brand nor the contract it holds; history is dated events with filings; every fact graded A/B/C with its evidence; two clocks. Built by tools/ontology2/build.py, served by tools/ontology2/serve.py (the view moves only to a signed build). Tools: resolve_entity, describe_entity; API: /v1/entities.","identity_key":"from_id, to_id, rel, valid_from","row_count":279515,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only): vlada_ontology.l1_edge","notes":"Dates are strings YYYY-MM-DD; an empty valid_to is an open end; from_basis first_observed means \"at least since\"; observed_to means \"last seen\". Skill docs/architecture/ontology-v2/API-CONTRACT.md.","superseded_by":null,"tools":["describe_entity","resolve_entity"],"dataset_id":"vlada_spine_ontology_l1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["from_id","rel","to_id","valid_from"],"backing_store":"glue"},{"source_id":"vlada_ontology_l1_evidence","source_fqn":"vlada_ontology.l1_evidence","title":"Vlada ontology layer one (evidence)","domain":"curated","stage":"mart","status":"live","grain":"One row per evidence record (evidence_id): source_type, document reference, field.","description":"The Vlada ontology, layer one (who holds and who owns every Medicare, Medicaid and Marketplace instrument, over time), SIGNED by Ben on build v3o (2026-10-28; docs/architecture/ontology-v2/L1-SIGNOFF.md). Permanent IDs; a legal entity is not its brand nor the contract it holds; history is dated events with filings; every fact graded A/B/C with its evidence; two clocks. Built by tools/ontology2/build.py, served by tools/ontology2/serve.py (the view moves only to a signed build). Tools: resolve_entity, describe_entity; API: /v1/entities.","identity_key":"entity_id","row_count":14210,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only): vlada_ontology.l1_evidence","notes":"Dates are strings YYYY-MM-DD; an empty valid_to is an open end; from_basis first_observed means \"at least since\"; observed_to means \"last seen\". Skill docs/architecture/ontology-v2/API-CONTRACT.md.","superseded_by":null,"tools":["describe_entity","resolve_entity"],"dataset_id":"vlada_spine_ontology_l1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["entity_id"],"backing_store":"glue"},{"source_id":"vlada_ontology_l1_event","source_fqn":"vlada_ontology.l1_event","title":"Vlada ontology layer one (event)","domain":"curated","stage":"mart","status":"live","grain":"One row per sourced corporate event: acquisition, merger, formation, transfer of business, divestiture, rename, with announced and closed dates, buyer and targets.","description":"The Vlada ontology, layer one (who holds and who owns every Medicare, Medicaid and Marketplace instrument, over time), SIGNED by Ben on build v3o (2026-10-28; docs/architecture/ontology-v2/L1-SIGNOFF.md). Permanent IDs; a legal entity is not its brand nor the contract it holds; history is dated events with filings; every fact graded A/B/C with its evidence; two clocks. Built by tools/ontology2/build.py, served by tools/ontology2/serve.py (the view moves only to a signed build). Tools: resolve_entity, describe_entity; API: /v1/entities.","identity_key":"entity_id","row_count":565,"last_updated":"2026-10-28","raw_queryable_via":"Athena (read-only): vlada_ontology.l1_event","notes":"Dates are strings YYYY-MM-DD; an empty valid_to is an open end; from_basis first_observed means \"at least since\"; observed_to means \"last seen\". Skill docs/architecture/ontology-v2/API-CONTRACT.md.","superseded_by":null,"tools":["describe_entity","resolve_entity"],"dataset_id":"vlada_spine_ontology_l1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["entity_id"],"backing_store":"glue"},{"source_id":"states_medicaid_mco_state_month_reconciliation_mat_v1","source_fqn":"medicare_silver.medicaid_mco_state_month_reconciliation_mat_v1","title":"States M1 Enrollment tracker: medicaid_mco_state_month_reconciliation_mat_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 3,738 rows (Athena, 2026-10-29). Period 2000-01-01 to 2026-10-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 31 state(s): AZ CA DC FL GA HI IA IL IN KY LA MI MN MO MS NJ NM NV NY OK OR PA RI SC TN TX UT VA WA WI WV.","identity_key":null,"row_count":3738,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_state_month_reconciliation_mat_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 31 state(s): AZ CA DC FL GA HI IA IL IN KY LA MI MN MO MS NJ NM NV NY OK OR PA RI SC TN TX UT VA WA WI WV.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_pa_medicaid_chc_enrollment_mco_population_v1","source_fqn":"medicare_silver.pa_medicaid_chc_enrollment_mco_population_v1","title":"States M1 Enrollment tracker: pa_medicaid_chc_enrollment_mco_population_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 990 rows (Athena, 2026-10-29). Period 2020-11-01 to 2026-04-01 (month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 1 state(s): PA.","identity_key":null,"row_count":990,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.pa_medicaid_chc_enrollment_mco_population_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): PA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_az_v1","source_fqn":"vlada_curated.parent_book_az_v1","title":"States W8 Parent book of business: parent_book_az_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 87,920 rows (Athena, 2026-10-29). Period 2005-10-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): AZ.","identity_key":null,"row_count":87920,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_az_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): AZ.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_ca_v1","source_fqn":"vlada_curated.parent_book_ca_v1","title":"States W8 Parent book of business: parent_book_ca_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 382,233 rows (Athena, 2026-10-29). Period 2007-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): CA.","identity_key":null,"row_count":382233,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_ca_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): CA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_fl_v1","source_fqn":"vlada_curated.parent_book_fl_v1","title":"States W8 Parent book of business: parent_book_fl_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 418,680 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): FL.","identity_key":null,"row_count":418680,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_fl_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): FL.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_ga_v1","source_fqn":"vlada_curated.parent_book_ga_v1","title":"States W8 Parent book of business: parent_book_ga_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 949,715 rows (Athena, 2026-10-29). Period 2009-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): GA.","identity_key":null,"row_count":949715,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_ga_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): GA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_il_v1","source_fqn":"vlada_curated.parent_book_il_v1","title":"States W8 Parent book of business: parent_book_il_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 606,483 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): IL.","identity_key":null,"row_count":606483,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_il_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): IL.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_mi_v1","source_fqn":"vlada_curated.parent_book_mi_v1","title":"States W8 Parent book of business: parent_book_mi_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 470,826 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): MI.","identity_key":null,"row_count":470826,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_mi_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): MI.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_nc_v1","source_fqn":"vlada_curated.parent_book_nc_v1","title":"States W8 Parent book of business: parent_book_nc_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 592,189 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): NC.","identity_key":null,"row_count":592189,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_nc_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NC.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_nj_v1","source_fqn":"vlada_curated.parent_book_nj_v1","title":"States W8 Parent book of business: parent_book_nj_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 123,761 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): NJ.","identity_key":null,"row_count":123761,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_nj_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NJ.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_ny_v1","source_fqn":"vlada_curated.parent_book_ny_v1","title":"States W8 Parent book of business: parent_book_ny_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 383,018 rows (Athena, 2026-10-29). Period 2019-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): NY.","identity_key":null,"row_count":383018,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_ny_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): NY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_oh_v1","source_fqn":"vlada_curated.parent_book_oh_v1","title":"States W8 Parent book of business: parent_book_oh_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 530,376 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): OH.","identity_key":null,"row_count":530376,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_oh_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): OH.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_pa_v1","source_fqn":"vlada_curated.parent_book_pa_v1","title":"States W8 Parent book of business: parent_book_pa_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 428,141 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): PA.","identity_key":null,"row_count":428141,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_pa_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): PA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_tn_v1","source_fqn":"vlada_curated.parent_book_tn_v1","title":"States W8 Parent book of business: parent_book_tn_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 546,069 rows (Athena, 2026-10-29). Period 2005-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): TN.","identity_key":null,"row_count":546069,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_tn_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): TN.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_tx_v1","source_fqn":"vlada_curated.parent_book_tx_v1","title":"States W8 Parent book of business: parent_book_tx_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 1,524,029 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): TX.","identity_key":null,"row_count":1524029,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_tx_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): TX.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_va_v1","source_fqn":"vlada_curated.parent_book_va_v1","title":"States W8 Parent book of business: parent_book_va_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 788,185 rows (Athena, 2026-10-29). Period 2014-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): VA.","identity_key":null,"row_count":788185,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_va_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): VA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_parent_book_wa_v1","source_fqn":"vlada_curated.parent_book_wa_v1","title":"States W8 Parent book of business: parent_book_wa_v1","domain":"state","stage":"silver","status":"partial","grain":"The parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. 216,636 rows (Athena, 2026-10-29). Period 2019-01-01 to 2026-12-31 (period_start).","description":"whole_state product W8 (Parent book of business) of the States lane: the parent book of business: every line a parent holds in the state, one measure per row, bound through the parent crosswalk. One table per state (parent_book_<st>_v1, state_code). Filter line, segment and measure before summing; value_status and coverage_scope say what the value covers. 1 state(s): WA.","identity_key":null,"row_count":216636,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.parent_book_wa_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): WA.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_w8_parent_book_of_business","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_fact_tx_medicaid_mco_parent_share_sfy_final_v1","source_fqn":"medicare_silver.fact_tx_medicaid_mco_parent_share_sfy_final_v1","title":"States M1S SFY final enrollment by parent: fact_tx_medicaid_mco_parent_share_sfy_final_v1","domain":"state","stage":"silver","status":"partial","grain":"Medicaid and CHIP managed care members by parent by state fiscal year: the state's final SFY average monthly enrollment, with each parent's share of the state total. 781 rows (Athena, 2026-10-29). Period 2019 to 2025 (state_fiscal_year).","description":"Medicaid product M1S (SFY final enrollment by parent) of the States lane: Medicaid and CHIP managed care members by parent by state fiscal year: the state's final SFY average monthly enrollment, with each parent's share of the state total. ANNUAL, NOT MONTHLY: measure sfy_average_monthly_final is the state fiscal year's average monthly enrollment, HHSC final (Texas SFY runs September to August; period_start and period_end bound it). Never mix it into the monthly M1 series and never chart it as months. Filter state_fiscal_year and program (or segment_id) before summing: programs overlap (All = Medicaid + CHIP; CHIP = CHIP Perinatal + CHIP Regular; Medicaid = STAR, STAR+PLUS, STAR Kids, STAR Health, Dual Demo), so summing across programs double counts. One row per year x program x parent; is_unmapped_bucket rows hold members not yet bound to a parent. Parents sum to statewide_total_printed, the state's own total for that year and program. 1 state(s): TX.","identity_key":null,"row_count":781,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.fact_tx_medicaid_mco_parent_share_sfy_final_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1s_sfy_final_enrollment_by_parent","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_plan_subcontract_v1","source_fqn":"medicare_silver.medicaid_plan_subcontract_v1","title":"States M6 Ownership + subcontracting: medicaid_plan_subcontract_v1","domain":"state","stage":"silver","status":"partial","grain":"Who owns each Medicaid managed care plan and who it subcontracts to: the reviewed plan-to-parent bridge, the state ownership disclosures and the plan subcontracts. 378 rows (Athena, 2026-10-30). Period 2010-04-23 to 2026-10-30 (valid_from).","description":"Medicaid product M6 (Ownership + subcontracting) of the States lane: who owns each Medicaid managed care plan and who it subcontracts to: the reviewed plan-to-parent bridge, the state ownership disclosures and the plan subcontracts. vw_medicaid_mco_ownership_bridge_v1: one reviewed decision per plan identity, effective-dated (effective_start, effective_end); read the row whose interval covers your date. org_control_disclosure: one row per disclosed owner, ownership_percent as printed; a plan can list several owners and the percents need not sum to 100. medicaid_plan_subcontract_v1 (the subcontracting half): one row per state x plan (canonical id, dated parent) x function (pharmacy_pbm, dental, vision, behavioral_health, nemt) x subcontractor, dated valid_from / valid_to; arrangement says delegated_subcontract, affiliate_subcontract, plan_performs or carved_out_state_program. status = not_published rows are findings, never zero or absence. A delegate's members are never added to the prime's, and a delegated network is not a full-risk transfer. 3 state(s): FL PA TX.","identity_key":null,"row_count":378,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_plan_subcontract_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 3 state(s): FL PA TX.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","Members is blank on every row today (378 of 378); receipts docs/research/states/_serving/M6-<ST>-*.json."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m6_ownership_subcontracting","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_marketplace_sbe_slcsp_county_v1","source_fqn":"medicare_silver.marketplace_sbe_slcsp_county_v1","title":"States K6 Premium + benefit book: marketplace_sbe_slcsp_county_v1","domain":"commercial","stage":"silver","status":"partial","grain":"The second-lowest-cost silver (benchmark) premium by county for state-based exchanges. 1,738 rows (Athena, 2026-10-30). Period 2021 to 2027 (plan_year).","description":"Marketplace product K6 (Premium + benefit book) of the States lane: the second-lowest-cost silver (benchmark) premium by county for state-based exchanges. One row per state x plan_year x county_fips x geo_part x age_band x route. Pick ONE route and ONE age_band before reading benchmark_premium_usd: route printed is the exchange's own printed benchmark, computed and computed_exchange are ours from its plan and rate files, and a county-year can carry two routes, so never sum or average across routes. geo_part splits a county where the exchange prices by ZIP (California; geo_zip_list). tieout_status says whether ours ties to the printed or CMS figure. HealthCare.gov states are not in this table yet; absent is not built, never no benchmark. 2 state(s): CA PA.","identity_key":null,"row_count":1738,"last_updated":"2026-10-29","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_sbe_slcsp_county_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k6_premium_benefit_book","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_marketplace_sbm_issuer_enrollment_history_v1","source_fqn":"medicare_silver.marketplace_sbm_issuer_enrollment_history_v1","title":"States K1H SBM enrollment history: marketplace_sbm_issuer_enrollment_history_v1","domain":"commercial","stage":"silver","status":"partial","grain":"State-based exchange enrollment by issuer before CMS's issuer file reaches them (2014-2017), from the exchanges' own reports. 1,715 rows (Athena, 2026-10-30). Period 2014 to 2017 (business_year).","description":"Marketplace product K1H (SBM enrollment history) of the States lane: state-based exchange enrollment by issuer before CMS's issuer file reaches them (2014-2017), from the exchanges' own reports. THE EXCHANGE'S OWN COUNT, NOT THE CMS ISSUER PUF: never splice it onto the CMS series (vw_marketplace_enrollment_by_parent_v1) without keeping source_label beside every year. The measure differs by state: NY is qhp_individual_enrollees from the open enrollment report, CA is active_members_paid_effectuated, so never compare or add the two as one measure. Filter geo_level: NY prints counties and the state row is derivation sum_of_printed_county_cells, so summing both double counts. CA is quarterly snapshots (one source_label per as_of_date): pick one, never sum a year's quarters. parent_id_as_now is null where the issuer has no parent match (issuer_match_basis says why); WA does not publish it (absent is not zero). 2 state(s): CA NY.","identity_key":null,"row_count":1715,"last_updated":"2026-10-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.marketplace_sbm_issuer_enrollment_history_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_k1h_sbm_enrollment_history","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mcpar_pdf_source_2025_v1","source_fqn":"medicare_semantic.vw_medicaid_mcpar_pdf_source_2025_v1","title":"States M8 Federal reports + payments: vw_medicaid_mcpar_pdf_source_2025_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Federal Medicaid managed care reports by plan (MCPAR 2025 responses, plan MLR). 120 rows (Athena, 2026-10-30).","description":"Medicaid product M8 (Federal reports + payments) of the States lane: federal Medicaid managed care reports by plan (MCPAR 2025 responses, plan MLR). vw_medicaid_mcpar_plan_pdf_2025_v1: one row per plan x MCPAR question as printed (response_raw; response_numeric when it parses); filter question_number. vw_medicaid_mcpar_pdf_source_2025_v1 is its locator: one row per state x program PDF (source_url, sha256_content_hash, source_pages); plan_table_status not_printed means the PDF prints no plan table, so that program has no plan rows, never zero plans. vw_medicaid_mlr_plan_v1: one row per plan x reporting period; adjusted_mlr_printed is the state's printed ratio, never recompute it from the numerator and denominator. 44 state(s): AL AR AZ CA CO DC FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS MT NC ND NE NH NJ NM NV OH OK PA PR RI SC TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":120,"last_updated":"2026-10-30","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mcpar_pdf_source_2025_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 44 state(s): AL AR AZ CA CO DC FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS MT NC ND NE NH NJ NM NV OH OK PA PR RI SC TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","One row per state x program PDF; plan_table_status printed 108, not_printed 12."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m8_federal_reports_payments","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mco_duals_bridge_v1","source_fqn":"medicare_silver.medicaid_mco_duals_bridge_v1","title":"States M1D Duals bridge: medicaid_mco_duals_bridge_v1","domain":"state","stage":"silver","status":"partial","grain":"Dual-eligible integrated plan members by parent by state by month (D-SNP by integration level, MMP, PACE), to add or subtract duals in the M1 tie-out to company filings. 253,984 rows (Athena, 2026-10-31). Period 2019-01-01 to 2026-10-01 (report_month).","description":"Medicaid product M1D (Duals bridge) of the States lane: dual-eligible integrated plan members by parent by state by month (D-SNP by integration level, MMP, PACE), to add or subtract duals in the M1 tie-out to company filings. One row per report_month x state_code x parent x dual_product_type (DSNP_CO, DSNP_HIDE, DSNP_FIDE, MMP, OTHER_INTEGRATED_PACE, DSNP_UNCLASSIFIED). Pick the product types before summing. HIDE/FIDE before 2022-07 is inferred from each plan's first CMS-reported status (integration_status_basis backcast_from_first_cms_status), not reported. MMP ends 2025-12 and converts into FIDE/HIDE in 2026-01: compare MMP + FIDE + HIDE across that boundary, never MMP alone. likely_in_medicaid_line is a default, not a filing fact: which company line reports duals is in docs/research/states/M1-SEC-COUNT-BASIS.csv (UNH's Medicaid line includes Community & State D-SNPs). state_code UNALLOCATED holds members with no county row (6 rows, 2019-12): include it in a national total, never in a state. members_weak_allocation is the part of members split by county-row count because every CPSC cell was suppressed (0.008%). canonical_parent_id follows the MA estate's mapping, which differs from vlada_curated.parent_crosswalk_v1 for about 14 organisations: join M1 on the same mapping. 57 state(s): AK AL AR AS AZ CA CO CT DC DE FL GA GU HI IA ID IL IN KS KY LA MA MD ME MI MN MO MP MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC SD TN TX UNALLOCATED UT VA VI VT WA WI WV WY.","identity_key":null,"row_count":253984,"last_updated":"2026-10-31","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_duals_bridge_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1d_duals_bridge","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_state_monthly_total_recent_v1","source_fqn":"medicare_silver.medicaid_state_monthly_total_recent_v1","title":"States M1T State-published totals: medicaid_state_monthly_total_recent_v1","domain":"state","stage":"silver","status":"partial","grain":"Each state's own published monthly Medicaid total (and its managed care total where published), read from the state's dashboards and reports. 494 rows (Athena, 2026-10-31). Period 2026-01 to 2026-10 (observation_month).","description":"Medicaid product M1T (State-published totals) of the States lane: each state's own published monthly Medicaid total (and its managed care total where published), read from the state's dashboards and reports. THE STATE'S OWN TOTAL, NOT CMS's: state totals run 0-22% above CMS's Medicaid + CHIP figure because they count limited-benefit groups CMS excludes (Medicare savings only, family planning, emergency); population_includes says which. Never splice a state month into the CMS monthly series; quote it as that state's own total, labeled. Filter measure (total_medicaid, total_medicaid_chip, managed_care_total): states publish different ones, so never compare two states on different measures. count_basis differs by state (first of month, month end, mid month, ever enrolled in the month); ever enrolled runs above a point-in-time count. A state or month absent is not published or not read yet, never zero. 39 state(s): AR AZ CO DC DE FL HI IA ID IL IN KS KY LA MA MD MI MN MO MS NC NH NJ NM NV NY OK OR PA RI SC TN TX UT VA VT WA WI WV.","identity_key":null,"row_count":494,"last_updated":"2026-10-31","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_state_monthly_total_recent_v1 (filter state_code)","notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1t_state_published_totals","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mco_enrollment_tracker_v2","source_fqn":"medicare_silver.medicaid_mco_enrollment_tracker_v2","title":"States M1 Enrollment tracker: medicaid_mco_enrollment_tracker_v2","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 69,987 rows (Athena, 2026-11-01). Period 2000-01-01 to 2026-11-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 52 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":69987,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_enrollment_tracker_v2 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 52 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC SD TN TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","2026-11-01 07:00Z round 3: observed 47,515 / estimated 13,780 / modeled 4,813 / not_published 2,962 / not_applicable 917; intervals widen with the total horizon where the state total is carried."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mco_enrollment_assumptions_v1","source_fqn":"medicare_silver.medicaid_mco_enrollment_assumptions_v1","title":"States M1 Enrollment tracker: medicaid_mco_enrollment_assumptions_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 41 rows (Athena, 2026-11-01).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero).","identity_key":null,"row_count":41,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_enrollment_assumptions_v1","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mco_enrollment_assumption_v1","source_fqn":"medicare_silver.medicaid_mco_enrollment_assumption_v1","title":"States M1 Enrollment tracker: medicaid_mco_enrollment_assumption_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 952 rows (Athena, 2026-11-01).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 44 state(s): AR AZ CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS NC ND NE NH NJ NM NV NY OH OK OR PA RI SC TN TX UT VA VT WA WI WV.","identity_key":null,"row_count":952,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_enrollment_assumption_v1 (filter state)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 44 state(s): AR AZ CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS NC ND NE NH NJ NM NV NY OH OK OR PA RI SC TN TX UT VA VT WA WI WV.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mco_enrollment_tracker_v2_parent_state_month","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_state_month","title":"States M1 Enrollment tracker: vw_medicaid_mco_enrollment_tracker_v2_parent_state_month","domain":"state","stage":"semantic_view","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 51,875 rows (Athena, 2026-11-01). Period 2000-01-01 to 2026-11-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 52 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":51875,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_state_month (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 52 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC SD TN TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mco_enrollment_tracker_v2_parent_national_month","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_national_month","title":"States M1 Enrollment tracker: vw_medicaid_mco_enrollment_tracker_v2_parent_national_month","domain":"state","stage":"semantic_view","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 29,025 rows (Athena, 2026-11-01). Period 2000-01-01 to 2026-11-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero).","identity_key":null,"row_count":29025,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_national_month","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mco_sec_tieout_v2","source_fqn":"medicare_silver.medicaid_mco_sec_tieout_v2","title":"States M1 Enrollment tracker: medicaid_mco_sec_tieout_v2","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 6 rows (Athena, 2026-11-01). Period 2026-06-30 to 2026-06-30 (sec_period_end).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero).","identity_key":null,"row_count":6,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_sec_tieout_v2","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar).","Q2 2026 like for like: UNH 1.0073, CNC 0.9789, ELV 0.9772, HUM 0.9599, CVS 0.9479, MOH 0.9430; NY CHP and Essential Plan columns live (NY DOH healthweb-back host)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mco_enrollment_tracker_v2_sec_tieout","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_sec_tieout","title":"States M1 Enrollment tracker: vw_medicaid_mco_enrollment_tracker_v2_sec_tieout","domain":"state","stage":"semantic_view","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 6 rows (Athena, 2026-11-01). Period 2026-06-30 to 2026-06-30 (sec_period_end).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero).","identity_key":null,"row_count":6,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_sec_tieout","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_m1_program_observation_v1","source_fqn":"medicare_silver.medicaid_m1_program_observation_v1","title":"States M1 Enrollment tracker: medicaid_m1_program_observation_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 41,368 rows (Athena, 2026-11-01). Period 2007-01-01 to 2026-10-01 (observation_period).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 10 state(s): CA CO DC IN MN NY OH PA WI WV.","identity_key":null,"row_count":41368,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_m1_program_observation_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 10 state(s): CA CO DC IN MN NY OH PA WI WV.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mco_plan_enrollment_hunt_v1","source_fqn":"medicare_silver.medicaid_mco_plan_enrollment_hunt_v1","title":"States M1 Enrollment tracker: medicaid_mco_plan_enrollment_hunt_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 1,781 rows (Athena, 2026-11-01). Period 2013-09-01 to 2026-08-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 4 state(s): AR MA ND VT.","identity_key":null,"row_count":1781,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_plan_enrollment_hunt_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 4 state(s): AR MA ND VT.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mco_plan_enrollment_hunt_cogank_v1","source_fqn":"medicare_silver.medicaid_mco_plan_enrollment_hunt_cogank_v1","title":"States M1 Enrollment tracker: medicaid_mco_plan_enrollment_hunt_cogank_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 5,498 rows (Athena, 2026-11-01). Period 2008-04-01 to 2026-07-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 4 state(s): CO GA KS NE.","identity_key":null,"row_count":5498,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mco_plan_enrollment_hunt_cogank_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 4 state(s): CO GA KS NE.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_mcpar_plan_avg_enrollment_v1","source_fqn":"medicare_silver.medicaid_mcpar_plan_avg_enrollment_v1","title":"States M1 Enrollment tracker: medicaid_mcpar_plan_avg_enrollment_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 2,018 rows (Athena, 2026-11-01). Period 2023 to 2025 (performance_year).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 48 state(s): AL AR AZ CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":2018,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_mcpar_plan_avg_enrollment_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 48 state(s): AL AR AZ CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC TN TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_medicaid_limited_benefit_plan_enrollment_v1","source_fqn":"medicare_silver.medicaid_limited_benefit_plan_enrollment_v1","title":"States M1L Limited benefit plans: medicaid_limited_benefit_plan_enrollment_v1","domain":"state","stage":"silver","status":"partial","grain":"Medicaid limited-benefit plan members by plan and parent by state and month: behavioral health, dental, PACE, non-emergency transportation and other limited plans. 52,589 rows (Athena, 2026-11-01). Period 2006-08-01 to 2026-10-01 (month).","description":"Medicaid product M1L (Limited benefit plans) of the States lane: Medicaid limited-benefit plan members by plan and parent by state and month: behavioral health, dental, PACE, non-emergency transportation and other limited plans. NEVER SUM WITH THE COMPREHENSIVE OR MLTSS TRACKER (M1), OR ACROSS benefit_type: one person can be in a medical MCO, a dental plan, a behavioral health plan and NEMT at once. Filter benefit_type and measure_class and never add across measure_class: rows mix enrollment, CMS July point-in-time, member months, Colorado RAE attributed caseload, Michigan capitation eligibles and Pennsylvania's derived behavioral health (Physical HealthChoices county enrollment x the BH-MCO county map, basis derived). basis says the source: observed (the state's report), derived (PA), cms_annual (July point in time), observed_cms_monthly (PACE: MEDICARE enrollment in PACE contracts, not the Medicaid count). also_in_flagship = true rows (Arizona RBHA, Wisconsin Care4Kids) are already inside the M1 totals. Michigan's PIHPs are monthly only 2015-10..2021-10 (Section 918 reports via Wayback). The parent view vw_medicaid_limited_benefit_parent_state_month_v1 carries series_rank and the sum_rule on every row, and keeps only in_segment_series = true rows: where a state has its own monthly series, its CMS July row is in_segment_series = false (replaced by the state series under measure_class enrollment), so the view's cms_july figures cover ONLY states without a monthly series. For a CMS July national figure read the view's cms_july_total column (the CMS July count for that state x benefit_type x parent, whether or not a monthly series replaces it; null outside July and where CMS has no row): 2024-07 DentaQuest 5,282,870, ModivCare 4,505,110, MCNA 3,447,425 (measured 2026-11-01). Never add cms_july_total and members together, and never add across benefit_type. 46 state(s): AL AR AZ CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MO MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":52589,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.medicaid_limited_benefit_plan_enrollment_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 46 state(s): AL AR AZ CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MO MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC TN TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1l_limited_benefit_plans","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_limited_benefit_parent_state_month_v1","source_fqn":"medicare_semantic.vw_medicaid_limited_benefit_parent_state_month_v1","title":"States M1L Limited benefit plans: vw_medicaid_limited_benefit_parent_state_month_v1","domain":"state","stage":"semantic_view","status":"partial","grain":"Medicaid limited-benefit plan members by plan and parent by state and month: behavioral health, dental, PACE, non-emergency transportation and other limited plans. 30,225 rows (Athena, 2026-11-01). Period 2006-08-01 to 2026-10-01 (month).","description":"Medicaid product M1L (Limited benefit plans) of the States lane: Medicaid limited-benefit plan members by plan and parent by state and month: behavioral health, dental, PACE, non-emergency transportation and other limited plans. NEVER SUM WITH THE COMPREHENSIVE OR MLTSS TRACKER (M1), OR ACROSS benefit_type: one person can be in a medical MCO, a dental plan, a behavioral health plan and NEMT at once. Filter benefit_type and measure_class and never add across measure_class: rows mix enrollment, CMS July point-in-time, member months, Colorado RAE attributed caseload, Michigan capitation eligibles and Pennsylvania's derived behavioral health (Physical HealthChoices county enrollment x the BH-MCO county map, basis derived). basis says the source: observed (the state's report), derived (PA), cms_annual (July point in time), observed_cms_monthly (PACE: MEDICARE enrollment in PACE contracts, not the Medicaid count). also_in_flagship = true rows (Arizona RBHA, Wisconsin Care4Kids) are already inside the M1 totals. Michigan's PIHPs are monthly only 2015-10..2021-10 (Section 918 reports via Wayback). The parent view vw_medicaid_limited_benefit_parent_state_month_v1 carries series_rank and the sum_rule on every row, and keeps only in_segment_series = true rows: where a state has its own monthly series, its CMS July row is in_segment_series = false (replaced by the state series under measure_class enrollment), so the view's cms_july figures cover ONLY states without a monthly series. For a CMS July national figure read the view's cms_july_total column (the CMS July count for that state x benefit_type x parent, whether or not a monthly series replaces it; null outside July and where CMS has no row): 2024-07 DentaQuest 5,282,870, ModivCare 4,505,110, MCNA 3,447,425 (measured 2026-11-01). Never add cms_july_total and members together, and never add across benefit_type. 45 state(s): AL AR CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MO MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":30225,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_limited_benefit_parent_state_month_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 45 state(s): AL AR CA CO DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MO MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC TN TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1l_limited_benefit_plans","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month","title":"States M1 Enrollment tracker: vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month","domain":"state","stage":"semantic_view","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 52,968 rows (Athena, 2026-11-01). Period 2000-01-01 to 2026-11-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 52 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC SD TN TX UT VA VT WA WI WV WY.","identity_key":null,"row_count":52968,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 52 state(s): AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA PR RI SC SD TN TX UT VA VT WA WI WV WY.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_medicaid_mco_enrollment_tracker_v2_parent_dated_national_month","source_fqn":"medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_dated_national_month","title":"States M1 Enrollment tracker: vw_medicaid_mco_enrollment_tracker_v2_parent_dated_national_month","domain":"state","stage":"semantic_view","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 30,063 rows (Athena, 2026-11-01). Period 2000-01-01 to 2026-11-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero).","identity_key":null,"row_count":30063,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_dated_national_month","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_tx_medicaid_mco_fsr_member_months_v1","source_fqn":"medicare_silver.tx_medicaid_mco_fsr_member_months_v1","title":"States M1 Enrollment tracker: tx_medicaid_mco_fsr_member_months_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 26,595 rows (Athena, 2026-11-01). Period 2007-09-01 to 2026-02-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 1 state(s): TX.","identity_key":null,"row_count":26595,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.tx_medicaid_mco_fsr_member_months_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): TX.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_tx_medicaid_mco_enrollment_other_sources_v1","source_fqn":"medicare_silver.tx_medicaid_mco_enrollment_other_sources_v1","title":"States M1 Enrollment tracker: tx_medicaid_mco_enrollment_other_sources_v1","domain":"state","stage":"silver","status":"partial","grain":"The Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. 3,442 rows (Athena, 2026-11-01). Period 2003-09-01 to 2026-06-01 (observation_month).","description":"Medicaid product M1 (Enrollment tracker) of the States lane: the Medicaid MCO enrollment tracker: members by plan and parent by state by month, every cell graded (observed, estimated, untested, not published), with parent rollups and the quarterly tie-out to what public parents report to the SEC. Start from medicaid_mco_enrollment_tracker_v2 (state x plan x parent x month) or its views vw_medicaid_mco_enrollment_tracker_v2_parent_state_month / _parent_national_month. READ basis ON EVERY ROW: observed is the state's printed figure; estimated is ours, and method names how (M-a carry-forward, M-b plan share x state total, M-e the tracker's nowcast model, PUB-PRELIM the publisher's own preliminary estimate; docs/research/states/M1-TRACKER-V2-DESIGN.md section 4), with interval_low / interval_high, inputs_as_of and assumption_ids. modeled is an M-e value where the method missed the accuracy bar: INDICATIVE ONLY, its interval is the measured error, and it is excluded from members_total; never sum it into an observed or estimated total (the views carry members_observed, members_estimated, members_modeled and members_with_modeled apart). not_published and not_applicable rows have members null: they are not zeros. Filter measure_class (members, member_months, weighted_members, average_monthly_members) and never add across it: average_monthly_members (with averaging_window; RI from 2023-12 prints average daily enrollment per month) never adds into members. measure is the publisher's own label. California is observed 2021-01..2026-09; Kaiser's publisher-suppressed county cells carry a labelled lower bound (assumption A-SUPPRESSED-LB). TWO PARENT QUESTIONS, two view pairs: the dated views vw_medicaid_mco_enrollment_tracker_v2_parent_dated_state_month / _parent_dated_national_month answer 'who owned it then' (parent_as_of_month; WellCare is its own parent before 2020, so Centene July 2016 is 5.92M there); the current views _parent_state_month / _parent_national_month answer 'today's companies' history' (Centene July 2016 is 9.93M there), with parent the CURRENT binding today (parent_status, parent_basis); never mix the two in one series. Assumptions: medicaid_mco_enrollment_assumption_v1 is the per-state register (populations counted, count basis, auto-assignment, carve-ins); medicaid_mco_enrollment_assumptions_v1 is the build's. SEC: read capture ratios only from vw_medicaid_mco_enrollment_tracker_v2_sec_tieout (like for like, duals adjusted per docs/research/states/M1-SEC-COUNT-BASIS.csv); comparability_class says when the filed number is broader than the tracker. SHOW THE GRADED adj_* COLUMNS, NEVER ONLY THE RATIO: each adjustment is its own labelled column (e.g. adj_subcontract_molina_la / _out measured from DMHC, adj_risk_share_healthy_blue_nc, adj_subcontract_lacare_anthem ESTIMATED with its low bound in the detail, adj_dsnp_from_ma_gap a JUDGMENT that a dual is counted in both lines, the 'once' alternative in the detail); a capture above 1.00 (UNH Q2 2026 1.007) means a judgment column over-explains. The two NY columns keep their _held names for schema stability but are LIVE: adj_ny_chp_held (NY Child Health Plus members, CNC 188,720, ELV 40,405) and sec_ny_essential_plan_excluded_held (NY Essential Plan is not Medicaid and comes off the SEC side, CNC -388,602), source NY DOH healthweb-back.health.ny.gov, recorded by the States lane as allowed by Ben on 2026-11-01; null where no NY figure exists or it is not measured (UNH), never zero. sec_asc_excluded is per quarter; exits are listed apart. ESTIMATE INTERVALS widen with the TOTAL horizon where the state total is carried past its last published month (months since the last observed plan value + months the total is carried): inputs_as_of is the last published total month and value_status says 'state total carried from <month>'. TEXAS: observed monthly by MCO x program 2007-09..2026-02 from HHSC MCO Financial Statistical Reports (tx_medicaid_mco_fsr_member_months_v1: filter is_latest_filing = true, since restated filings stay as rows, and grain); after 2026-02 plan values scale by HHSC's own monthly total. 234 TX observed members rows are FRACTIONAL by rule (part-month adjustments in the filed member months; HHSC defines the line as members enrolled in the month and it ties to HHSC final SFY averages within 0.04-0.38%, assumption A-TX-FSR-RETRO): they stay measure_class members, never rounded, so a fractional-members check exempts source_family state_fsr. measure_class members_hhsc_prelim_plan_total (HHSC 2026-05 preliminary per-plan totals) never adds to members. tx_medicaid_mco_enrollment_other_sources_v1 holds TDI HMO quarter-ends, 1115 waiver tables, CHIP 2003-13 and HHSC preliminary months, one series per row (filter series and period_kind), never mixed with the FSR months. INPUTS behind the tracker, read only with their labels: medicaid_m1_program_observation_v1 is the programs the spine lacked (MN, PA CHC, NY MLTC/MAP/FIDA-IDD, IN PathWays, CO Denver Health, OH MyCare, WI Family Care, WV MHP, CA SCAN, DC Dual Choice), one row per published cell (read value_unit and source_time_basis: some are member months). medicaid_mco_plan_enrollment_hunt_v1 and _hunt_cogank_v1 are hunted series (ND VT CO GA monthly, MA AR quarterly, NE EQR points, KS year-to-date averages): filter tracker_use, because only observed_monthly and observed_point rows are observations; quarterly_anchor and average_anchor are anchors, check_only and not_read are never a figure, and grain says month, quarter, rolling_quarter, calendar_ytd or point_in_time. medicaid_mcpar_plan_avg_enrollment_v1 is MCPAR annual average monthly members by plan (PY2023-25, 48 states), an anchor only, never a monthly count; suspect = true rows (77) are flagged. medicaid_mco_state_month_reconciliation_mat_v1 is the earlier plan-sum vs state and CMS totals reconciliation (cms_monthly_denominator_available = false is a missing denominator, never zero). 1 state(s): TX.","identity_key":null,"row_count":3442,"last_updated":"2026-11-01","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.tx_medicaid_mco_enrollment_other_sources_v1 (filter state_code)","known_gaps":["COVERAGE IS STATE BY STATE: the States lane builds Florida and Pennsylvania first, then the next states; a state absent here is not built yet, never 'none'. 1 state(s): TX.","Read the product's gates before quoting it: docs/operations/STATES-LANE.md section 5 and docs/research/states/<ST>/SCORECARD.md (a table can be built and still short of its Gold bar)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m1_enrollment_tracker","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_jcode_vs_asp_v1","source_fqn":"vlada_curated.vw_state_medicaid_jcode_vs_asp_v1","title":"States M2 J-code book: Medicaid J-code rates vs Medicare ASP (vw_state_medicaid_jcode_vs_asp_v1)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per in-force priced HCPCS J-code rate (state x schedule x code x modifiers x program x provider type x setting), beside the Medicare ASP payment limit for the same code in the current quarter and in the quarter the rate took effect. 79,302 rows, 44 states (Athena, 2026-11-05).","description":"Medicaid physician-administered drug rates (HCPCS J-codes) as each state prints them, beside Medicare's ASP payment limit (ASP + 6%) for the same code and billing unit (hcpcs_dosage). implied_asp_plus = rate / (limit / 1.06) - 1, so 0.06 means the state pays ASP + 6%. Two readings: _at_eff (the ASP quarter the rate took effect, how the state priced it) and _current (today's ASP quarter). A printed $0 / NDC-required / by-report line is never here.","identity_key":null,"row_count":null,"last_updated":"2026-11-05","freshness_sla":"Event-driven per state (each J-code / physician-administered drug edition, quarterly in ASP states); the views recompute from vlada_curated.vw_state_medicaid_rate_v2 and drug_silver.fact_drug_asp_quarterly_v2 on every read.","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_jcode_vs_asp_v1 (filter state (and code) before reading; read provider_type and setting on every row)","provenance_chain_ref":"Served by the States lane (tools/states/publish_m2_jcode_views.py); every rate row names its state source sha256 and locator, the ASP side its CMS release quarter. Book page: docs/product/medicaid-rates/JCODE-BOOK-2026-11-05.md; audits docs/research/medicaid-ffs/AUDIT-JCODE-2026-11-04.md (dollars 134/134) and AUDIT-JCODE-RECHECK-2026-11-04.md.","known_gaps":["ASP covers about 70% of J rows; a code with no ASP row has null limits, never zero.","Provider types are separate rows (KS mid-level injection rows print a flat $1.73 on every code): filter provider_type before reading a median; vw_state_medicaid_jcode_basis_v1 does this per provider type.","Not versioned (a view over the versioned base)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_jcode_basis_v1","source_fqn":"vlada_curated.vw_state_medicaid_jcode_basis_v1","title":"States M2 J-code book: measured pricing basis per state (vw_state_medicaid_jcode_basis_v1)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per state x schedule x provider type: the median implied ASP+ at the effective quarter, p25 / p75, matched codes, codes within one point, modal_rate_share and flat_amount. 271 rows, 44 states (Athena, 2026-11-05).","description":"The measured J-code pricing basis: what each state actually pays relative to Medicare ASP, per schedule and provider type (one payment basis per median; provider types are never blended). Read beside the state's stated method in docs/research/medicaid-ffs/drug_pricing/DRUG-PRICING-METHODS.csv (51 of 51). flat_amount = one rate on half or more of >= 20 rows: an administration amount, not a drug basis (KS mid-level injection $1.73, injection admin $2.30). Example 2026-11-05: KS base fee ASP + 6.0% on 590 codes, 532 within one point; CA PAD schedule ASP + 6.0%.","identity_key":null,"row_count":null,"last_updated":"2026-11-05","freshness_sla":"Event-driven per state (each J-code / physician-administered drug edition, quarterly in ASP states); the views recompute from vlada_curated.vw_state_medicaid_rate_v2 and drug_silver.fact_drug_asp_quarterly_v2 on every read.","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_jcode_basis_v1 (filter state; prefer n_matched >= 100 and flat_amount = false; never average across provider types)","provenance_chain_ref":"Served by the States lane (tools/states/publish_m2_jcode_views.py); every rate row names its state source sha256 and locator, the ASP side its CMS release quarter. Book page: docs/product/medicaid-rates/JCODE-BOOK-2026-11-05.md; audits docs/research/medicaid-ffs/AUDIT-JCODE-2026-11-04.md (dollars 134/134) and AUDIT-JCODE-RECHECK-2026-11-04.md.","known_gaps":["A basis needs >= 100 matched codes to stand (M2-JCODE-MATRIX.md); smaller rows are shown, not ranked.","Facility schedules (OPPS / APC / ASC) pay facility shares of the Medicare limit, not a drug basis.","Not versioned (a view over the versioned base)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_jcode_computed_v1","source_fqn":"vlada_curated.vw_state_medicaid_jcode_computed_v1","title":"States M2 J-code book: rates computed by published rule, FL + MA (vw_state_medicaid_jcode_computed_v1)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per state x code x ASP quarter for states that print no J-code fees and pay a published rule on the CMS ASP file. 16,285 rows, 2 states (FL from 2022Q1, MA from 2026Q1; Athena 2026-11-05).","description":"Florida (106% of ASP, rule 59G-4.251(8)) and Massachusetts (the quarterly Medicare Part B ASP fee, 101 CMR 317.04(1)(a)) print no J-code fee schedule; their rates are the rule applied to the CMS ASP payment limit. rate_type computed_by_rule, the rule document's sha256 on every row. Kept apart from the printed rate book (vw_state_medicaid_rate_v2 is printed values only).","identity_key":null,"row_count":null,"last_updated":"2026-11-05","freshness_sla":"Event-driven per state (each J-code / physician-administered drug edition, quarterly in ASP states); the views recompute from vlada_curated.vw_state_medicaid_rate_v2 and drug_silver.fact_drug_asp_quarterly_v2 on every read.","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_jcode_computed_v1 (filter state and is_current (or effective_from for a quarter); never mix with printed rates in one median)","provenance_chain_ref":"Served by the States lane (tools/states/publish_m2_jcode_views.py); every rate row names its state source sha256 and locator, the ASP side its CMS release quarter. Book page: docs/product/medicaid-rates/JCODE-BOOK-2026-11-05.md; audits docs/research/medicaid-ffs/AUDIT-JCODE-2026-11-04.md (dollars 134/134) and AUDIT-JCODE-RECHECK-2026-11-04.md.","known_gaps":["Computed, not printed: the state's rule applied to CMS's file; a state override for one drug is not seen.","Not versioned (one row per quarter; is_current marks today's quarter)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"states_vw_state_medicaid_homecare_v1","source_fqn":"vlada_curated.vw_state_medicaid_homecare_v1","title":"States M2 home care: reviewed home health and private duty nursing rates (vw_state_medicaid_homecare_v1)","domain":"state","stage":"semantic_view","status":"partial","grain":"One row per rate-book row a reviewed per-state schedule registry names as home health (agency visit rates) or private duty nursing (RN / LPN home nursing), homecare_line in front; a row may appear under both lines when one printed rate is both (IN, AL). 2,500 current home health rows in 46 states, 455 current PDN rows in 47 states (Athena, 2026-11-06).","description":"Home health and private duty nursing rates as each state prints them, classified by a person who read each schedule (docs/research/states/<ST>/HOMECARE-SCHEDULES.csv, evidence per row), not by code: hospice, supplies, waiver, school and facility nursing are left out. Final independent check 2026-11-06: 96% of sampled rows correctly classed, dollars 40 of 40 match the state files. States that publish no FFS rate (paid through MCOs, cost-based, or case by case) have no rows here; the proof is in each state's ledger.","identity_key":null,"row_count":null,"last_updated":"2026-11-05","freshness_sla":"Event-driven per state (each J-code / physician-administered drug edition, quarterly in ASP states); the views recompute from vlada_curated.vw_state_medicaid_rate_v2 and drug_silver.fact_drug_asp_quarterly_v2 on every read.","raw_queryable_via":"Athena (read-only via query_substrate): vlada_curated.vw_state_medicaid_homecare_v1 (filter homecare_line, state and is_current; read rate_unit on every row; never compare across units)","provenance_chain_ref":"Served by the States lane (tools/states/publish_m2_jcode_views.py); every rate row names its state source sha256 and locator, the ASP side its CMS release quarter. Book page: docs/product/medicaid-rates/JCODE-BOOK-2026-11-05.md; audits docs/research/medicaid-ffs/AUDIT-JCODE-2026-11-04.md (dollars 134/134) and AUDIT-JCODE-RECHECK-2026-11-04.md.","known_gaps":["Units are as printed (visit, 15 minutes, hour, day, service): filter rate_unit before comparing states; no per-hour normalization yet for home care.","Not versioned (a view over the versioned base)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_states_m2_ffs_rate_book","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"tracker_dim_network_specialty_v1","source_fqn":"medicare_silver.dim_network_specialty_v1","title":"MA network intelligence: NUCC taxonomy -> normalized specialty (CMS MA network-adequacy types)","domain":"medicare","stage":"dim","status":"partial","grain":"One row per NUCC taxonomy code (884, NUCC v26.0): provider_class, specialty, adequacy_type, map_version.","description":"The specialty vocabulary of the network layer: each NPPES taxonomy code mapped to one specialty, CMS's MA network-adequacy provider specialty types (30) where the code belongs to one, a plain group otherwise. The mapping is Vlada's (tools/data_tracker/network_specialty_map.py), by NUCC classification and specialization, first match wins.","identity_key":"taxonomy_code","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.dim_network_specialty_v1 (join taxonomy_code = vlada_curated.dim_provider.taxonomy_code_1)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["Our mapping, not CMS's: CMS publishes the specialty types and NUCC the codes, not a crosswalk.","Not versioned (map_version names the build)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"dimension","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["taxonomy_code"],"backing_store":"glue"},{"source_id":"tracker_ma_network_provider_v1","source_fqn":"medicare_silver.ma_network_provider_v1","title":"MA network intelligence: plan x NPI x listed ZIP with normalized specialty and county (2026, 2027)","domain":"medicare","stage":"mart","status":"partial","grain":"One row per plan_year x cms_plan_id x npi x listed zip5, members only (api, printed, mpf, matched grade A/B): contract_id, plan_key (H1234-001), key_level (plan or contract), state, county_fips, NPPES entity_type and taxonomy, provider_class, specialty, adequacy_type, best_basis, year_basis (own_year | carried), plan_key_bases, sources, listings. Partitioned by dataset_id, plan_year.","description":"The directory table reduced to members and normalized: one specialty per NPI from NPPES (99.96% mapped; the printed label is blank on 87% of rows), the listed ZIP's county, the best source, and whether the row is the plan's own-year list or a labelled stand-in from the other year.","identity_key":"npi","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_network_provider_v1 (pin dataset_id and plan_year; count DISTINCT npi)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["VERSIONED by the dataset_id partition (the directory publish it was built from; the current one is in s3://vlada-platform-raw/medicare/bronze/ma_directory_plan_npi_site_v1/_current.json): pin it; never count across datasets.","About 2% of rows carry a ZIP with no county (PO box or unique ZIPs).","Membership is DISTINCT npi per (plan_year, plan_key or cms_plan_id); rows repeat per listed ZIP."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"tracker_ma_network_plan_county_v1","source_fqn":"medicare_silver.ma_network_plan_county_v1","title":"MA network intelligence: network breadth per plan x county x specialty vs the county's rivals","domain":"medicare","stage":"mart","status":"partial","grain":"One row per plan_year x plan_key x county_fips x specialty ('*' = every provider): plan_npis, county_npis (the county's listed universe), breadth, rank_in_county, plans_ranked, plans_offered, rival_median_breadth, rival_max_breadth, matched_share, carried_share, contract_level_share, employer_plan. Partitioned by dataset_id, plan_year.","description":"How broad each MA plan's published network is in every county of its CMS service area against the other plans sold there: the providers it lists in the county over every provider any MA plan lists there (the listed universe), ranked among the county's individual plans. Typed door get_network_breadth.","identity_key":"plan_key","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_network_plan_county_v1 (pin dataset_id and plan_year; filter specialty ('*' for all) and county_fips or contract_id)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["VERSIONED by the dataset_id partition (the directory publish it was built from; the current one is in s3://vlada-platform-raw/medicare/bronze/ma_directory_plan_npi_site_v1/_current.json): pin it; never count across datasets.","Breadth is a share of what MA plans list, not of every practising clinician.","Name-matched lists under-count (names matching no single NPI are dropped): read matched_share."],"notes":null,"superseded_by":null,"tools":["get_network_breadth"],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":["plan_key"],"backing_store":"glue"},{"source_id":"tracker_ma_network_plan_hospital_v1","source_fqn":"medicare_silver.ma_network_plan_hospital_v1","title":"MA network intelligence: hospitals in each plan's published network, with evidence (CCN)","domain":"medicare","stage":"mart","status":"partial","grain":"One row per plan_year x plan_key x hospital CCN with any evidence: facility_npi_listed, clinicians_listed, clinicians_affiliated, clinician_share, signal (hospital_npi_listed | many_affiliated_clinicians | few_affiliated_clinicians), hospital name, state, county, system_id, system_name, in_service_area, carried. Partitioned by dataset_id, plan_year.","description":"Which hospitals each plan's directory puts in network: the hospital's own NPI listed (CMS hospital enrollment NPI = CCN), or how many of the clinicians CMS records as affiliated with it the plan lists (CMS Doctors and Clinicians, 2026-05-29), with the health system. Typed door get_plan_hospitals.","identity_key":"ccn","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_network_plan_hospital_v1 (pin dataset_id and plan_year; read signal before calling a hospital in network)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["VERSIONED by the dataset_id partition (the directory publish it was built from; the current one is in s3://vlada-platform-raw/medicare/bronze/ma_directory_plan_npi_site_v1/_current.json): pin it; never count across datasets.","Absence is 'no evidence in the published directory', never 'out of network'.","Clinician affiliation covers 4,606 hospitals; others appear only by their own NPI."],"notes":null,"superseded_by":null,"tools":["get_plan_hospitals"],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:ccn"],"entity_key_columns":{"cms:ccn":["ccn"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"tracker_ma_network_change_v1","source_fqn":"medicare_silver.ma_network_change_v1","title":"MA network intelligence: 2026 -> 2027 network change per contract x health system / specialty","domain":"medicare","stage":"mart","status":"partial","grain":"One row per contract_id x rollup_level (all | specialty | system) x rollup_key: listed_2026, listed_2027, stayed, left_network, joined, keep_rate, contract_keep_rate, contract_keep_rate_2027, zip3_both_years, source_changed, signal (exit_signal | join_signal). Partitioned by dataset_id.","description":"Who joined and left each contract's published network between 2026 and 2027, like for like (own-year lists only, ZIP3 areas listed in both years, members only), rolled to health systems through CMS's hospital affiliation and the system map, with exit / join signals where a system's listing collapsed while the rest of the network held. Typed door get_network_system_change.","identity_key":"contract_id","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_network_change_v1 (pin dataset_id; filter rollup_level and contract_id; read source_changed before a signal)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["VERSIONED by the dataset_id partition (the directory publish it was built from; the current one is in s3://vlada-platform-raw/medicare/bronze/ma_directory_plan_npi_site_v1/_current.json): pin it; never count across datasets.","A signal is a directory signal to verify, never proof a contract ended.","Contracts whose 2027 list is a 2026 stand-in, or whose 2026 list came only through the API carry-back, have no change rows."],"notes":null,"superseded_by":null,"tools":["get_network_system_change"],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"tracker_ma_network_active_v1","source_fqn":"medicare_silver.ma_network_active_v1","title":"MA network intelligence: active grade per listed provider (Medicare billing and enrollment)","domain":"medicare","stage":"mart","status":"partial","grain":"One row per plan_year x listed NPI: provider_class, specialty, enrolled_medicare (PECOS), billed_medicare_year (CMS billing file), contracts_listing, medicare_billing_type, active_grade (A billed Medicare in the newest year, B enrolled only, C neither, n/a a type that does not bill Medicare). Partitioned by dataset_id, plan_year.","description":"The network lockdown's active check (docs/data-tracker/network-intel/LOCKDOWN-LEDGER.md N1): whether Medicare's own files confirm a listed provider is active. 2027: 1,570,066 billing-type providers, A 52.9%, B 39.8%, C 7.4%.","identity_key":"npi","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_network_active_v1 (pin dataset_id and plan_year; read active_grade only where medicare_billing_type)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["VERSIONED by the dataset_id partition (the directory publish it was built from; the current one is in s3://vlada-platform-raw/medicare/bronze/ma_directory_plan_npi_site_v1/_current.json): pin it; never count across datasets.","C is unverified by Medicare's files, not proven gone: MA plans may contract with providers not enrolled in Medicare.","Billing year 2023 until the 2024 file loads; no deactivation file yet."],"notes":null,"superseded_by":null,"tools":["get_plan_network"],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"tracker_nppes_deactivated_npi_v1","source_fqn":"medicare_silver.nppes_deactivated_npi_v1","title":"CMS NPPES Deactivated NPI Report: every deactivated NPI with its date, one partition per monthly report","domain":"medicare","stage":"reference","status":"partial","grain":"One row per NPI x report_date: deactivation_date, source_url, source_member, sha256_content_hash. Partitioned by report_date.","description":"CMS's monthly list of NPIs deactivated in NPPES and not reactivated, loaded by tools/data_tracker/load_nppes_deactivated.py (raw ZIP archived under its sha256). 2026-11-02: 360,014 NPIs. Read the newest report_date; each report replaces the last.","identity_key":"npi","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.nppes_deactivated_npi_v1 (filter report_date to the newest; join on npi)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["Reports before 2026-11-02 not loaded (2026-07-13 held raw).","Monthly reload is manual."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"reference","entity_keys":["nppes:npi"],"entity_key_columns":{"nppes:npi":["npi"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"tracker_ma_network_contract_group_v1","source_fqn":"medicare_silver.ma_network_contract_group_v1","title":"MA network intelligence: each contract's network by billing group and health system (share of each listed)","domain":"medicare","stage":"mart","status":"partial","grain":"One row per plan_year x contract_id x rollup_level (group | system) x entity_key: entity_name, entity_state, clinicians_listed, entity_clinicians, share_listed. Partitioned by dataset_id, plan_year.","description":"The network lockdown's N3: a contract's listed clinicians rolled up to the billing groups they reassign Medicare payment to (CMS PECOS reassignment) and the health systems of their hospitals (CMS Doctors and Clinicians affiliation x the hospital system map). 2027: 4.22M contract x group rows (192K groups), 155.6K contract x system rows (643 systems). Typed door get_network_groups.","identity_key":"contract_id","row_count":null,"last_updated":"2026-11-05","freshness_sla":"Rebuilt after every directory publish (tools/data_tracker/build_network_intelligence.py reads the Tracker's pointer and builds that dataset's partitions; monthly with the directory refresh).","recollection":{"cadence":"derived","watermark_field":null,"freshness_threshold":null,"expected_delta":null,"stale_behavior":null,"caveats":[]},"raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.ma_network_contract_group_v1 (pin dataset_id and plan_year; filter rollup_level; read share_listed with entity_clinicians)","commercial_terms":"Vlada-derived from public payer directories, Plan-Net APIs, NPPES and CMS public files.","provenance_chain_ref":"tools/data_tracker/build_network_intelligence.py (Athena; method docs/data-tracker/network-intel/README.md); upstream medicare_bronze.ma_directory_plan_npi_site_v1, whose every row names its url, page and raw_sha256.","known_gaps":["VERSIONED by the dataset_id partition (the directory publish it was built from; the current one is in s3://vlada-platform-raw/medicare/bronze/ma_directory_plan_npi_site_v1/_current.json): pin it; never count across datasets.","Groups count Medicare-enrolled clinicians only.","Contract level: HMO and PPO networks of one contract are one."],"notes":null,"superseded_by":null,"tools":["get_network_groups"],"dataset_id":"vlada_ma_plan_networks_w1","dataset_assignment_basis":"source_register","layer":"curated","asset_type":"table","purpose":"mart","entity_keys":["cms:contract_id"],"entity_key_columns":{"cms:contract_id":["contract_id"]},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_plan_v1","source_fqn":"medicare_semantic.vw_hix_plan_v1","title":"Marketplace plans, every jurisdiction and year (vw_hix_plan_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per plan variant x plan year (standard and cost-sharing variants), individual market, medical. All 51 jurisdictions: HealthCare.gov states 2014-2027, state-run exchanges 2016-2027.","description":"Metal, plan type, network, service area, deductibles and MOOP (integrated, medical, drug), EHB share, HSA, child-only flag and the parent (parent_basis: the reviewed issuer-parent bridge, else the issuer name).","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_plan_v1 (filter plan_year and state_code; variant_kind separates standard plans from cost-sharing variants)","known_gaps":["2027 state-run plans carry no deductible or MOOP until CMS's 2027 state-run packages post.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_plan_premium_v1","source_fqn":"medicare_semantic.vw_hix_plan_premium_v1","title":"Marketplace premiums by plan, rating area and age (vw_hix_plan_premium_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per plan x rating area x age x tobacco status x plan year, with family tiers where filed. All 51 jurisdictions: HealthCare.gov states 2014-2027, state-run exchanges 2016-2027.","description":"List premiums from each source's own rate table; source names the file (CMS Exchange PUF, CMS state-run package, state rate file 2027, CMS rate review file 2027).","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_plan_premium_v1 (filter plan_year, state_code and plan_id; read source and rate_effective_date)","known_gaps":["New York and Vermont are community rated: age = 'community'.","Some files repeat a prior year's rates (2019) or quarterly rates: prefer rate_effective_date on January 1 of the plan year.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_plan_county_v1","source_fqn":"medicare_semantic.vw_hix_plan_county_v1","title":"Marketplace plans sold in each county (vw_hix_plan_county_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per plan x county x plan year: rating area, issuer, parent, metal, age-40 premium at list and EHB. 1,538,783 rows. All 51 jurisdictions: HealthCare.gov states 2014-2027, state-run exchanges 2016-2027.","description":"Every plan the engine found on sale in each county, from the same source as the county's benchmark.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_plan_county_v1 (filter year and state; aggregate in SQL)","known_gaps":["Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_county_benchmark_v1","source_fqn":"medicare_semantic.vw_hix_county_benchmark_v1","title":"Marketplace county benchmark: lowest and second-lowest silver (vw_hix_county_benchmark_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per county x plan year at age 40: 42,896 rows. All 51 jurisdictions: HealthCare.gov states 2014-2027, state-run exchanges 2016-2027. HealthCare.gov counties match CMS's Landscape (list-ranked) 2016-2027 to the cent, 2014 within $0.01, 2015 all but 29 counties.","description":"The second-lowest-cost silver plan (the credit benchmark, 26 CFR 1.36B-3: ranked on the EHB premium, shown at list), the lowest silver, the lowest bronze and gold, plan ids, parents and counts.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_county_benchmark_v1 (filter year and state; weight any average and name the weight)","known_gaps":["A state benchmark is a weighted mean of counties; name the weight.","State-run 2016-2021: CMS's packages carry no EHB share, so ranking and slcsp_ehb are the list premium.","Counties rated by 3-digit ZIP (Los Angeles, Massachusetts, Idaho 2014-2017) take the rating area holding most of their land.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_county_benchmark_ages_v1","source_fqn":"medicare_semantic.vw_hix_county_benchmark_ages_v1","title":"Marketplace county benchmark at every age (vw_hix_county_benchmark_ages_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per county x age x plan year: 2,085,501 rows, 42,896 county-years. The benchmark, lowest silver, bronze and gold plans at each age in the plan's own rate table.","description":"The same plans as vw_hix_county_benchmark_v1 (one age curve per state, so the plans do not change by age), priced at every age; materialized as medicare_silver.hix_county_benchmark_ages_v1 (materialize_ages.py) so one county answers in seconds.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_county_benchmark_ages_v1 (filter year, state and age)","known_gaps":["At age 40, 19 county-years differ from the age-40 table at the cent: one 2019 Massachusetts county by $5.92 (two January rates in CMS's file) and 18 Minnesota 2027 counties by one cent (sub-cent rates in the rate review file).","slcsp_ehb is the EHB part of the benchmark at each age, which sets the credit.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_market_structure_v1","source_fqn":"medicare_semantic.vw_hix_market_structure_v1","title":"Marketplace market structure by parent and county (vw_hix_market_structure_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per county x parent x plan year: 133,433 rows. All 51 jurisdictions: HealthCare.gov states 2014-2027, state-run exchanges 2016-2027.","description":"Plans by metal, cheapest silver and its rank among parents, whether the parent holds the lowest or the benchmark silver, and status against the year before (entered, continuing, exited; exited rows carry zero plans).","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_market_structure_v1 (filter year and state; status = 'exited' rows have no plans)","known_gaps":["Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_benchmark_change_v1","source_fqn":"medicare_semantic.vw_hix_benchmark_change_v1","title":"Marketplace benchmark change, every year pair (vw_hix_benchmark_change_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per county x (year - 1, year): 39,705 rows, 2015-2027.","description":"The benchmark move split into repricing (last year's benchmark plan's successor: CMS's crosswalk in HealthCare.gov states, the same plan id in state-run exchanges) and re-ranking, with who held it each year and why it changed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_benchmark_change_v1 (filter year and state; repricing_usd + reranking_usd = chg_usd where a successor exists)","known_gaps":["State-run exchanges have no CMS crosswalk: a renamed plan reads as no successor.","holder_change 'same plan' = last year's plan or its CMS crosswalk successor, same parent; successor_basis 'same plan id' wherever the crosswalk names none (state-run, and 71 HealthCare.gov county-years 2017-2020).","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_vw_hix_after_credit_v1","source_fqn":"medicare_semantic.vw_hix_after_credit_v1","title":"Marketplace premium tax credit by county, age and income (vw_hix_after_credit_v1)","domain":"commercial","stage":"semantic_view","status":"partial","grain":"One row per county x age x income (100-600% of the poverty line) x schedule x plan year, one adult.","description":"The credit = the EHB part of the benchmark (benchmark_ehb, 26 CFR 1.36B-3) less the applicable percentage of income (26 U.S.C. 36B), never below zero, beside the lowest silver, bronze and gold premiums. schedule 'in force' or 'without the enhancement' (2021-2025 where the IRS published it).","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_semantic.vw_hix_after_credit_v1 (filter year, state, age, income_pct_poverty and schedule = 'in force')","known_gaps":["Not modelled: Medicaid eligibility below 138% in expansion states, households over one.","No row at an income means no credit.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"semantic","asset_type":"view","purpose":"serving","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_credit_schedule_v1","source_fqn":"medicare_silver.hix_credit_schedule_v1","title":"Premium tax credit applicable percentages 2014-2027 (hix_credit_schedule_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per plan year x income band x regime: 114 rows.","description":"The applicable percentage table each year (statute 2014, IRS Rev. Procs 2015-2020 and 2026-2027, the enhanced schedule 2021-2025) with the document and URL on every row.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_credit_schedule_v1 (filter plan_year and regime; percentages are percent values)","known_gaps":["The without-the-enhancement tables for 2022, 2024 and 2025 were never published: blank, not derived.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_poverty_guidelines_v1","source_fqn":"medicare_silver.hix_poverty_guidelines_v1","title":"HHS poverty guidelines 2013-2026 (hix_poverty_guidelines_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per guideline year x area (48 states and DC, Alaska, Hawaii): 42 rows.","description":"HHS poverty guidelines from the Federal Register; plan year Y uses guideline year Y - 1.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_poverty_guidelines_v1 (filter guideline_year and area)","known_gaps":["2016 guidelines do not step evenly for households of 1-8; use the notice's table.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_plan_county_v1","source_fqn":"medicare_silver.hix_plan_county_v1","title":"Marketplace products, published CSV behind vw_hix_plan_county_v1 (hix_plan_county_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per plan x county x plan year; every column a string (the CSV as published to S3 by products.py / materialize_ages.py).","description":"The S3 CSV table that medicare_semantic.vw_hix_plan_county_v1 types and serves. Query the view; this table exists so the products are rebuilt whole and the view can be repointed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_plan_county_v1 (prefer medicare_semantic.vw_hix_plan_county_v1; here filter year and state as strings)","known_gaps":["Strings only: year, premiums and counts are typed in the semantic view.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_county_benchmark_v1","source_fqn":"medicare_silver.hix_county_benchmark_v1","title":"Marketplace products, published CSV behind vw_hix_county_benchmark_v1 (hix_county_benchmark_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per county x plan year at age 40; every column a string (the CSV as published to S3 by products.py / materialize_ages.py).","description":"The S3 CSV table that medicare_semantic.vw_hix_county_benchmark_v1 types and serves. Query the view; this table exists so the products are rebuilt whole and the view can be repointed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_county_benchmark_v1 (prefer medicare_semantic.vw_hix_county_benchmark_v1; here filter year and state as strings)","known_gaps":["Strings only: year, premiums and counts are typed in the semantic view.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_county_benchmark_ages_v1","source_fqn":"medicare_silver.hix_county_benchmark_ages_v1","title":"Marketplace products, published CSV behind vw_hix_county_benchmark_ages_v1 (hix_county_benchmark_ages_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per county x age x plan year (materialized by materialize_ages.py); every column a string (the CSV as published to S3 by products.py / materialize_ages.py).","description":"The S3 CSV table that medicare_semantic.vw_hix_county_benchmark_ages_v1 types and serves. Query the view; this table exists so the products are rebuilt whole and the view can be repointed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_county_benchmark_ages_v1 (prefer medicare_semantic.vw_hix_county_benchmark_ages_v1; here filter year and state as strings)","known_gaps":["Strings only: year, premiums and counts are typed in the semantic view.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_market_structure_v1","source_fqn":"medicare_silver.hix_market_structure_v1","title":"Marketplace products, published CSV behind vw_hix_market_structure_v1 (hix_market_structure_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per county x parent x plan year; every column a string (the CSV as published to S3 by products.py / materialize_ages.py).","description":"The S3 CSV table that medicare_semantic.vw_hix_market_structure_v1 types and serves. Query the view; this table exists so the products are rebuilt whole and the view can be repointed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_market_structure_v1 (prefer medicare_semantic.vw_hix_market_structure_v1; here filter year and state as strings)","known_gaps":["Strings only: year, premiums and counts are typed in the semantic view.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_benchmark_change_v1","source_fqn":"medicare_silver.hix_benchmark_change_v1","title":"Marketplace products, published CSV behind vw_hix_benchmark_change_v1 (hix_benchmark_change_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per county x (year - 1, year); every column a string (the CSV as published to S3 by products.py / materialize_ages.py).","description":"The S3 CSV table that medicare_semantic.vw_hix_benchmark_change_v1 types and serves. Query the view; this table exists so the products are rebuilt whole and the view can be repointed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_benchmark_change_v1 (prefer medicare_semantic.vw_hix_benchmark_change_v1; here filter year and state as strings)","known_gaps":["Strings only: year, premiums and counts are typed in the semantic view.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_sbe2027_state_rates_v1","source_fqn":"medicare_silver.hix_sbe2027_state_rates_v1","title":"Marketplace products, published CSV behind vw_hix_plan_premium_v1 (2027 state-run rows) (hix_sbe2027_state_rates_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per plan x rating area x age, 2027 state-run exchanges from the states' files; every column a string (the CSV as published to S3 by products.py / materialize_ages.py).","description":"The S3 CSV table that medicare_semantic.vw_hix_plan_premium_v1 (2027 state-run rows) types and serves. Query the view; this table exists so the products are rebuilt whole and the view can be repointed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_sbe2027_state_rates_v1 (prefer medicare_semantic.vw_hix_plan_premium_v1 (2027 state-run rows); here filter year and state as strings)","known_gaps":["Strings only: year, premiums and counts are typed in the semantic view.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"},{"source_id":"hix_hix_sbe2027_state_service_area_v1","source_fqn":"medicare_silver.hix_sbe2027_state_service_area_v1","title":"Marketplace products, published CSV behind vw_hix_plan_county_v1 (2027 state-run rows) (hix_sbe2027_state_service_area_v1)","domain":"commercial","stage":"silver","status":"partial","grain":"One row per plan x county, 2027 state-run exchanges from the states' files; every column a string (the CSV as published to S3 by products.py / materialize_ages.py).","description":"The S3 CSV table that medicare_semantic.vw_hix_plan_county_v1 (2027 state-run rows) types and serves. Query the view; this table exists so the products are rebuilt whole and the view can be repointed.","identity_key":null,"row_count":null,"last_updated":"2026-11-08","raw_queryable_via":"Athena (read-only via query_substrate): medicare_silver.hix_sbe2027_state_service_area_v1 (prefer medicare_semantic.vw_hix_plan_county_v1 (2027 state-run rows); here filter year and state as strings)","known_gaps":["Strings only: year, premiums and counts are typed in the semantic view.","Not versioned (rebuilt whole)."],"notes":null,"superseded_by":null,"tools":[],"dataset_id":"vlada_w4_hix_benchmark_products","dataset_assignment_basis":"source_register","layer":"silver","asset_type":"table","purpose":"source_data","entity_keys":[],"entity_key_columns":{},"technical_keys":[],"unmapped_key_tokens":[],"backing_store":"glue"}],"tools":[{"name":"asp_pricing_lookup","version":"1.1.0","description":"Given an HCPCS code or short-description search, returns Medicare Part B ASP quarterly payment-limit rows from drug_silver.fact_drug_asp_quarterly_v2 (is_current) with trend aggregates. Use for Part B reimbursement checks and CY 2026 IRA/MFP methodology caveats.","layer":"L2","domain":"drug","data_sources":["drug_silver.fact_drug_asp_quarterly_v2"],"underlying_silver_tables_for_pinning":["drug_silver.fact_drug_asp_quarterly_v2"],"semantic_views_used":[],"known_gaps":["asp_cy_2026_mpfs_ira_mfp_layering","asp_pricing_lookup_no_match","asp_pricing_lookup_truncated"]},{"name":"certified_measure","version":"1.0.0","description":"Run a GOVERNED KPI by name from the certified measures registry. A measure is a registry entry (definition + vintage bindings + official citation + canonical SQL); this tool runs ONLY that registry SQL, so a governed statistic (like the enrollment-weighted share of MA-PD enrollees in 4-plus star contracts) is computed by a compiled methodology, never an improvised join. Call with NO name to list every measure with its status and definition. Call with a name (and optionally rating_year, an int) to execute that measure and get the rows plus the vintage columns, the official citation, the certification status (draft / certified), and the definitional notes. Use this for any governed KPI FIRST; if no measure covers the question, fall back to query_substrate and label the result uncertified.","layer":"L2","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":["Runs ONLY the registry's canonical SQL; a governed question with no matching certified measure is NOT answered here, and there is currently NO sanctioned raw-SQL fallback (query_substrate is quarantined pending its truncation-honesty re-grade). An unanswered governed question stays unanswered rather than improvised.","A measure with status 'draft' has not yet been certified by the owner; treat its number as provisional until status is 'certified'."]},{"name":"compare_hospital_rates","version":"1.22.0","description":"NEGOTIATED RATES BY INSURER AND PLAN ARE SERVED HERE: hospital price-transparency files carry the rate each hospital filed for each payer and plan (the insurer-file / TiC tools are coming soon). Compares what a billing code costs ACROSS hospitals (cheapest real price first) with a p10/median/p90 benchmark AND a per-(payer x line-of-business) breakdown. The product query for 'where is care cheapest' and 'what does each payer actually pay'. Reads the canonical serving view `vlada_curated.vw_fact_hospital_chargemaster_canonical`, which resolves each raw payer string to its REAL parent entity (the canonical payer graph) and classifies each plan to a regulatory line-of-business (commercial / medicare_advantage / medicaid / marketplace / ...). Inputs: billing_code (required), state (optional 2-letter), code_system (optional), billing_class (default 'institutional' = facility/UB-04; or 'professional'/'both'; classes are never mixed -- since 1.6.0 'institutional'/'professional' each WIDEN to include billing_class_resolved='both' rows, a charge posted on both the facility and professional side of a bill per the HPT schema; pass 'institutional_only'/'professional_only' for the strict single-class stratum), limit (default 25), payer (optional brand OR parent, e.g. 'Aetna' or 'CVS Health'), line_of_business (optional, e.g. 'medicare_advantage'; `all_products` is one rate a hospital posts for all of a payer's products, and it is never in the commercial default). Each returned rate carries the view's canonical payer columns (`payer_canonical_id`, `payer_parent_name`, `payer_entity_class`, `payer_match_method`) plus `line_of_business` so a comparison is apples-to-apples (Aetna-MA != Aetna-Commercial). `value.by_payer_lob` is the 'rates across all the payers' table. CROSS-SUBSTRATE: every rate also carries x_medicare (the multiple of the Medicare allowed amount: PFS national non-facility for professional, OPPS APC for outpatient institutional, IPPS MS-DRG national base for inpatient DRG codes); `value.medicare` holds the allowed amount + schedule + year, so the answer is 'this payer pays 1.6x Medicare at this hospital'. VALIDATION (load-bearing): billing_class is normalized + inferred from code_system/rate_type where the source omits it; only the requested class is compared; class-implausible rates (e.g. $0.007 for a CT) and code-relative outliers are filtered. CHEAPEST HEADLINE (1.2.0): `value.cheapest` is ranked over rows PLAUSIBLE for the code's Medicare basis -- when the allowed amount is a real procedure (>= $500) a row under 0.3x Medicare (the comparability cascade's own lower sane bound) is set aside into `value.implausible_tail` (full rows + floor + reason, never deleted; benchmark still includes it), and the rest rank hospital-stated methodology (fee_schedule/case_rate/per_diem) before methodology-unknown, rate ascending within each tier -- read `plausibility` + `rank_tier` on each row. Under the $500 gate (imaging / visits / labs) only the placeholder floor below applies, so a $44 head CT still headlines. CASE-RATE HEADLINE (1.7.0): on a DRG/case-rate seat the floor is 0.5x (not 0.3x -- an inpatient rate below half of IPPS is not credible as the full case price), and `cheapest` headlines hospital-STATED case_rate rows ONLY when at least one survives the floor; methodology-unknown rows are demoted into `value.implausible_tail` (tail_reason='methodology_unknown_demoted') even when they themselves clear the floor. `cheapest` headlines an unknown row only when NO stated row survives, and a `headline_methodology_unknown` warning caveat says so. ENCOUNTER-BASIS FLOOR (1.15.0): the floor also reads the Medicare basis -- when the allowed amount is a facility-encounter payment (OPPS APC, IPPS MS-DRG, ASC; e.g. the comprehensive APC behind a CPT 27447 knee) the floor is 0.5x on every seat except per_diem, stated as `floor_rule='encounter_basis'` on every floor block and on value.implausible_tail. ONE CODE SYSTEM PER WINDOW (1.3.0): `cheapest` holds rows of the seated code system only (`value.code_system_resolved`, the dominant system or the caller's `code_system`), each row stamped `code_system`; when the floor empties a full window the tool re-asks once for rows at or above the floor rate (`value.cheapest_window.second_pass`), and if `cheapest` still ends empty a `no_plausible_rows_in_window` caveat says why. ONE METHODOLOGY FAMILY PER WINDOW (1.4.0): within the seated code system, `cheapest` and the re-seated `value.benchmark` / `comparable_benchmark` are further restricted to ONE methodology family -- fee_schedule (a line, the natural family for CPT/HCPCS/APC/RC), case_rate (an admission, the natural family for a DRG/MS-DRG seat), or per_diem (a day) -- because a case rate, a per diem and a fee schedule price different economic objects and must never share a median or a ranked list. `methodology_family` (optional: fee_schedule|case_rate|per_diem) overrides the natural seat. Rows the hospital stated in a DIFFERENT family are set aside into `value.other_family`, in full, never blended in; `value.by_methodology_family` reports n/n_hospitals/p10/median/p90 for every family present, and a `methodology_families_mixed` caveat fires when more than 10% of the population sits outside the seated family. BY_METHODOLOGY RECONCILES (1.6.1): `value.by_methodology` (percent_of_charge/fee_schedule/case_rate/per_diem/other/unknown, with median_rate_over_gross_charge) is narrowed to the SAME population `value.benchmark.n` reports -- sum(by_methodology[].n) == benchmark.n, ALWAYS, by construction; the unstratified, every-family view (within the seated code system) is `value.by_methodology_all_families`, which is what `value.percent_of_charge_share` and the `methodology_mix` caveat read (percent_of_charge rows are always 'unknown' family and would otherwise be invisible once a family is seated). SOURCE: CMS Hospital Price Transparency MRFs (45 CFR 180.50) + CMS Medicare PFS/OPPS fee schedules. KNOWN GAPS: not geo-aware beyond state; payer resolution covers ~80.9% of volume and line-of-business ~85.7% (measured on the 70553 probe, 2026-08-13; call state_expert for live per-state counts), unmatched rates fall to '(unresolved)'/'unspecified'; bare Blue-family labels (e.g. 'Bcbs') keep the Blue company the hospital's state or county identifies (the state's one licensee, or the county's Blue in a split state); with no such evidence they are bucketed '(blue family: label too generic to attribute)' with payer_resolution='generic_label' and never attributed to a specific Blue parent; IPPS DRG x_medicare is the national base (excludes wage index/IME/DSH/outliers); x_medicare null for revenue/non-HCPCS CDM codes; ghost-rate filter is heuristic. DRG GROUPER PRECISION: MS-DRG, APR-DRG and AP-DRG are different maintainers with different numbering (MS-DRG 470 = joint replacement, APR-DRG 470 = chronic kidney disease) and only MS-DRG prices against the IPPS base. Served data is split into MS_DRG / APR_DRG / TRIS_DRG / ... (code_system_precision 'token' or 'shape_inferred'), so an MS_DRG seat is `value.medicare.precision` 'exact' and the other groupers carry no Medicare basis; only a row still on the transitional bare 'DRG' string reads 'drg_grouper_unknown'. CODE-SYSTEM SPELLINGS (1.18.0): code_system is folded to the served bucket before anything runs ('MS-DRG' / 'ms_drg' / 'msdrg' -> 'MS_DRG', 'APR-DRG' -> 'APR_DRG', 'hcpcs' -> 'HCPCS_II', 'cpt-4' -> 'CPT'; a bare 'DRG' is not guessed), and code_system naming the cell's natural seat is served from the precomputed table. PAYER FROM THE TABLE (1.18.0): payer naming ONE parent company (the parent name, or a brand it owns: Aetna -> CVS Health, UHC -> UnitedHealth Group, Anthem -> Elevance Health) is read from the table's payer level -- the headline is that parent's seated-family rows; value.served_from.payer_scope names the match; by_methodology and comparable_benchmark are not in the table per payer and say so in value.sections_unavailable. `by_payer_lob` lists the seated methodology family first; `value.by_payer_lob_cut` and each tail's `rows_cut_note` say where a list was cut. PLACEHOLDER TAIL (1.18.0; from a $100 basis since 1.20.0): under the $500 gate, a rate under 0.25x a $100-$500 Medicare basis (a $50 ED visit at 0.12x, a $32 brain MRI at 0.13x) leaves the ranked `cheapest` list for value.implausible_tail (tail_reason='below_low_basis_floor'); the medians still include it until the table is rebuilt. NO HEADLINE WITHOUT ITS FLOOR (1.22.0): when the seat or the Medicare part misses the budget, `cheapest` is withheld (value.cheapest_empty rule 'seat_unavailable', status partial, retryable) and the window's rows are in value.cheapest_unassessed, unranked. BOTH-CLASS DEFAULT STRATUM (1.6.0): billing_class 'institutional'/'professional' each widen to include billing_class_resolved='both' rows (a charge the HPT schema posts for both sides of a bill); every row still carries its own resolved `billing_class`, and a `both_class_rows_included` caveat states the measured count whenever the answer includes at least one such row. Measured on CT (2026-08-18): 9.63% of REAL_NEGOTIATED rows are 'both', 100% with no institutional sibling row -- previously invisible at the old strict-institutional default. Pass 'institutional_only'/'professional_only' for the pre-1.6.0 strict single-class stratum.","layer":"L2","domain":"hospital","data_sources":["vlada_curated.vw_hospital_comparison_mart","vlada_curated.vw_fact_hospital_chargemaster_comparable","vlada_curated.vw_fact_hospital_chargemaster_canonical","vlada_curated.vw_medicare_benchmark"],"underlying_silver_tables_for_pinning":["vlada_curated.vw_hospital_comparison_mart","vlada_curated.vw_fact_hospital_chargemaster_comparable","vlada_curated.vw_fact_hospital_chargemaster_canonical","vlada_curated.vw_medicare_benchmark"],"semantic_views_used":[],"known_gaps":["hospital_billing_class_inferred","hospital_geo_state_only","hospital_ghost_rate_filter_heuristic"]},{"name":"coverage_status","version":"1.1.0","description":"DEPRECATED 2026-09-14 (one deprecation window): for 'what data does Vlada have?' call find_data_sources -- the one discovery door, whose inventory this tool now reports verbatim in `inventory`. What is kept here for the window is the LIVE section counts nothing else serves. The single LIVE answer to 'what data does Vlada have?'. Replaces the conflicting coverage numbers scattered across tool docs with one endpoint whose every figure is computed live, read from an authoritative catalog metadata surface, or deferred to submit_query when it needs a heavy scan, never hardcoded. Sections (default all): `hospital` (distinct CCNs with chargemaster rows, distinct CCNs with negotiated_dollar rows, total fact rows), `commercial` (served payers live from the canonical-graph engine registry — the payers the resolution engine can serve — plus the canonical semantic-registry count), `resolution` (payer_canonical_id non-null % and line_of_business specified % on a bounded state+code probe), and `freshness` (latest recorded vintage per source family). Every section carries computed_at + a method string; every number carries a definition string so there is exactly one meaning per figure. Request-path queries are partition- bounded under a ~10s budget; anything heavier is returned as available_via: submit_query. Pass allow_heavy_scan=true to compute the distinct-CCN tiers inline (deploy-time / off-request-path use).","layer":"L2","domain":"hospital","data_sources":["vlada_curated.vw_fact_hospital_chargemaster_current","vlada_curated.vw_fact_hospital_chargemaster_canonical"],"underlying_silver_tables_for_pinning":["vlada_curated.vw_fact_hospital_chargemaster_current","vlada_curated.vw_fact_hospital_chargemaster_canonical"],"semantic_views_used":["vlada_curated.vw_fact_hospital_chargemaster_canonical","vlada_curated.vw_fact_hospital_chargemaster_current"],"known_gaps":["distinct-CCN tiers are DEFERRED to submit_query by default because the hospital fact is partitioned by (hospital_state, version_id), not hospital_ccn; pass allow_heavy_scan=true to compute them inline.","total_fact_rows is a catalog metadata estimate (may lag the live table after a reingest); it is NOT a live COUNT(*).","resolution percentages are scoped to a single bounded probe (state + billing code), returned in `probe`, not the whole substrate.","freshness dates are catalog-recorded vintages, not live watermark reads.","served_payers counts BUILT canonical-graph serving indexes (the engine registry); a build's presence does not by itself certify every downstream table surface (catalog / provenance tiers gate that)."]},{"name":"describe_data_source","version":"1.3.0","description":"Return the catalog record for one substrate data source. Compact by default (grain, queryable, claim ceiling, freshness SLA, top caveats, recommended next action, columns); pass verbosity='full' for the previous full record: description, row count, provenance chain reference, context doc path, known gaps, and the full source_product_card. IDENTIFIERS: accepts the PUBLIC source_code that find_data_sources returns (e.g. cms_ma_plan_payment) as well as a table FQN (e.g. vlada_curated.fact_rate) or a catalog source_id -- all three resolve to the same card. Also accepts a data-point ID, returning its exact bound table plus the selected point's units, grain, nulls and execution route. When the card includes a coverage-check recipe, run its stated query to inspect retained editions; it is not measured coverage. Do not infer all-history coverage from current-only rows. Avoid extra schema calls when this card already supplies the needed columns. A RETIRED source answers with a redirect (status retired + superseded_by + the successor's fqn), never a card. COLUMNS (1.1.0): the card's `columns` field lists each column's name and type (and a one-line note where the source publishes one), read from a committed snapshot -- never a live Glue call -- so a caller no longer has to `SELECT * LIMIT n` on query_substrate just to learn a table's shape. A source not yet in the snapshot reads `columns_unavailable: run snapshot` rather than silently omitting the field; run ops/scripts/snapshot_catalog_columns.py to populate it. WHAT TO QUERY (2026-09-18): every card carries a block saying what to type. It states the literal fully-qualified table name the raw SQL door accepts -- neither the public source code nor the catalog source id is a table -- plus the predicates a correct read carries (a currentness filter, a year pin, a partition column), and one bounded example SELECT that has been run through the door's own SQL guard before it was printed. A source served by a typed tool instead names that tool and its call; a seat not entitled to the table is told which pack grants it. Column lists are split: the data columns first, the row-lineage columns every row carries in their own named group.","layer":"L1","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":[]},{"name":"describe_entity","version":"2.0.0","description":"Everything layer one holds about one entity (an entity_id from resolve_entity): what it is and its identifiers; who owned or controlled it on a date (on=YYYY-MM-DD, default today), the path to the top parent with each hop's basis, grade, dates and evidence; what it holds (contracts, plans, Medicaid plans, issuers, subsidiaries), or everything under its top parent with scope=group; its dated corporate events (acquisitions, mergers, transfers of business, renames) with filings. Every date follows the doctrine (at least since; last seen).","layer":"L2","domain":"curated","data_sources":["vlada_ontology.l1_entity","vlada_ontology.l1_identifier","vlada_ontology.l1_edge","vlada_ontology.l1_evidence","vlada_ontology.l1_event"],"underlying_silver_tables_for_pinning":["vlada_ontology.l1_entity","vlada_ontology.l1_identifier","vlada_ontology.l1_edge","vlada_ontology.l1_evidence","vlada_ontology.l1_event"],"semantic_views_used":["vlada_ontology.l1_entity","vlada_ontology.l1_identifier","vlada_ontology.l1_edge","vlada_ontology.l1_evidence","vlada_ontology.l1_event"],"known_gaps":["Layer one only: no facilities, doctors, networks or PBMs (layers two to five follow on Ben's signature).","About 16% of Medicare Advantage members sit under a chain with one hop resting on CMS's parent string alone (grade B); the top parent is not in doubt, the corroborating filing is not yet attached.","Belief time (what an earlier build served) is not yet queryable; every answer carries the build it was read from.","The 233 open review-queue rows (candidate contract transfers) are not served."]},{"name":"describe_schema","version":"1.0.0","description":"Return the semantic layer: marts, columns, invariants, canonical payers, and the tools YOU can call (the same list tools/list returns for you, never a wider catalog). Compact by default (a manifest: marts + a name + one-line summary per tool, under ~8K chars). Fetch one section with describe_schema(section='<mart>') / section='tools' / section='invariants'. Pass verbosity='full' for the previous full payload. Agents call this first to learn the surface, then fetch the section or tool they need.","layer":"L1","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":[]},{"name":"excluded_prescriber_payment_screen","version":"1.2.0","description":"Given an NPI (10-digit), returns OIG LEIE exclusion status and — if excluded — any Open Payments received OR Part D prescribing activity recorded AFTER the exclusion date (and before any reinstatement). The textbook qui-tam / False Claims Act screening query. Bridges three substrate sources: dim_oig_leie (LEIE), fact_drug_payment_to_prescriber (Open Payments), fact_part_d_prescriber (Part D Prescriber-by-Drug).\n\nReturns: total post-exclusion payment dollars + Part D drug-cost exposure, broken down by year + top 5 manufacturers. Every answer carries an explicit exclusion_status (not_in_leie, excluded, or excluded_then_reinstated) beside the dollars, so a $0 result is never ambiguous: a not-in-LEIE NPI returns zero ANCHORED to the LEIE snapshot date it was checked against (leie_asserted_at), which is a different thing from an excluded prescriber who drew no post-exclusion payments.\n\nKNOWN GAPS: open_payments_publication_lag_one_year (current PY publishes June+1); part_d_puf_annual_grain_only (Part D PUF is annual not monthly — finer-grain timing requires claims data). LEIE refreshes monthly per the M-6 schedule (cycle 2).","layer":"L2","domain":"drug","data_sources":["drug_silver.dim_oig_leie","drug_silver.fact_drug_payment_to_prescriber","drug_silver.fact_part_d_prescriber"],"underlying_silver_tables_for_pinning":["drug_silver.dim_oig_leie","drug_silver.fact_drug_payment_to_prescriber","drug_silver.fact_part_d_prescriber"],"semantic_views_used":[],"known_gaps":["open_payments_publication_lag_one_year","part_d_puf_annual_grain_only"]},{"name":"fetch_query","version":"1.0.0","description":"Fetch the result of an async job once it is done. Returns the wrapped tool's full response when status is done; a not_ready caveat while it is still queued/running; or the error when it failed.","layer":"L2","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":[]},{"name":"find_data_sources","version":"1.0.0","description":"Search the Vlada substrate catalog by keyword. Returns the matching data sources (commercial TiC, hospital HPT, Medicare, drug pricing, provider identity, curated marts, provenance registries) ranked by relevance. Compact by default (identity + queryable + claim ceiling + the exact describe_data_source call per hit); pass verbosity='full' for the previous full source_product_card per result. Paginates with limit (default 25, max 200) + offset; the response carries total_count, returned_count, and offset. Optional filters: {domain, stage, status, limit}. Agents call this first to discover what data Vlada has. Since 2026-09-02 the answer leads with DATA POINTS (`data_points`: the measure/dimension asked for, with its source, door, table.column and must-read trap) and the table cards follow as physical locations. Every hit carries `source_code` -- the one public code, which describe_data_source accepts verbatim -- alongside the table's `source_fqn`. Points and tables are ranked by ONE ranker (the authored data-point scorer). Retired tables are never returned; they appear only as `supersedes` on the live successor's card. BOUNDED (2026-09-18): the default call is compact and paged -- both the table cards and the data points come back a page at a time, each with its own total and next offset -- so a default call can never truncate. Pass verbosity='full' for the whole point record and the full source_product_card per hit.","layer":"L1","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":[]},{"name":"find_views","version":"1.0.0","description":"Look up the vetted analytic VIEWS for a question before you query. A view is the decision that comes before any table or chart: who is counted (population), against what base, compared to what, over which period and vintage, and what one row is (grain); plus the weight, the named measures, the forms that draw it (draw_as), how to reach the data (reach: the typed tool that carries the population and base first, then the source codes to read with describe_data_source and query_substrate), the rules that must hold and the ways the view goes wrong or contradicts another view (contradicts_if). Pass the user's question in their words; add a domain (ma_market, ma_benefits, hospital_prices, payer_rates, medicare_benchmark, ma_stars, medicaid, marketplace, drug_pricing, formulary, pbm, providers, employer, mlr, hospital_quality, drug_policy, ma_value, cross_domain) or a level (executive for a headline, actuarial for weights, cohorts, decompositions and distributions, detailed for row-level lookups) when you know it. Returns up to 8 views, best first; the default is 4. Use the returned population, base and period in your call and say them in the answer. A view is analytical guidance: it grants no data access and proves no coverage for the places, dates or populations in your question. Verify coverage with the source's own card before you quote a number. A question no view covers is composed from the same fields.","layer":"L1","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":["A view is guidance, not data: it grants no access to the tools or sources it names and proves no coverage for the places, dates or populations in the question.","Ranking is deterministic word overlap with the domain's vocabulary; a question phrased far from the catalog's words may rank a neighbouring view first. Pass a domain or a level to narrow it."]},{"name":"formulary_churn","version":"1.0.0","description":"Given a quarter-pair (report_quarter_from, report_quarter_to) AND a formulary or plan filter, returns the formulary delta: drugs added, drugs dropped, drugs re-tiered, and optionally drugs whose control flags (prior auth / step therapy / quantity limit) changed. Diffs drug_silver.fact_drug_formulary across two SPUF report_quarters on (formulary_id, drug) keys, where a drug is its RxCUI by default (grain='rxcui'), so a manufacturer or package NDC swap of the same drug is not churn; grain='ndc' gives the package-level diff. Pass rxcui_filter=[...] to ask whether coverage of specific drugs changed.\n\nReturns: per-category row lists (cap 5000 each), aggregates (formularies_compared, n_added, n_dropped, n_tier_changed, n_control_changed, n_unchanged, churn_rate, tier_movement_distribution), truncated_by_category flags.\n\nREADING churn_rate: it is (added + dropped + re-tiered) divided by the number of drugs on the formulary in the FROM quarter — CHANGE EVENTS PER FROM-QUARTER DRUG, not a percentage. It is >= 0 and CAN EXCEED 1 (a formulary that drops everything and adds as many new drugs scores 2.0), because added drugs are not members of the denominator. The answer carries churn_rate_definition saying exactly this, the two denominators (n_in_from_quarter, n_in_to_quarter), and two bounded companions that ARE 0-1: share_dropped (dropped / FROM-quarter drugs) and share_added (added / TO-quarter drugs).\n\nUse cases: year-over-year formulary stability tracking, drop investigations for a specific drug class, IRA-era churn rate (crossing 2025 → 2026 will surface the redesign-driven churn).\n\nKNOWN GAPS: spuf_quarterly_publication_lag (CMS publishes 6 weeks after quarter end; very recent quarter changes won't show); ira_era_break_2026 (IRA Part D redesign in 2026 changed formulary structures; churn comparison crossing this boundary mixes regime changes with normal churn); formulary_churn_truncated (per-category lists capped at 5000).","layer":"L2","domain":"drug","data_sources":["drug_silver.fact_drug_formulary","drug_silver.dim_part_d_plan"],"underlying_silver_tables_for_pinning":["drug_silver.fact_drug_formulary","drug_silver.dim_part_d_plan"],"semantic_views_used":[],"known_gaps":["spuf_quarterly_publication_lag","ira_era_break_2026","formulary_churn_truncated","formulary_churn_no_match"]},{"name":"get_benefit_change","version":"2.0.0","description":"The locked 2027 Medicare Advantage benefit tables in one call: what each benefit was in 2026 and what it is in 2027 for the SAME members, member-weighted from the CMS Plan Benefit Package filings and CMS September 2026 county enrollment, inside ONE product type, for the market or a parent organization, nationally, in a state or in a county. Premium, MOOP, the medical and Part D deductibles, the medical copays and coinsurance, the Part D tier cost shares, dental / OTC / hearing / eyewear / flex card dollars and offered shares, the Part B giveback and the supplemental services.\n\nARGUMENTS: product_type (required unless group_by='product_type': non-SNP HMO | non-SNP PPO | D-SNP HMO | D-SNP PPO | C-SNP HMO | C-SNP PPO | I-SNP HMO | I-SNP PPO; 'ALL' is refused, types are never pooled), geography (national | state | county; inferred from the place when omitted), state (two letters), county (the name as CMS spells it, e.g. 'Maricopa', with state) or county_ssa (five digits, e.g. '03060'), parent (the parent organization; a partial name matches, e.g. 'UnitedHealth'), plan_type (default 'ALL'; HMO | HMOPOS | Local PPO | Regional PPO), group_by (none | parent | state | county | plan_type | product_type; state needs geography national, county needs geography state), benefits ('key' default | 'all' | a comma-separated list of benefit names, listed in value.benefits), limit (rows, default 50, max 500, largest 2026 membership first).\n\nRETURNS value.summary (the market of the scope: every benefit for the scope's members) and value.rows (one per group, or per matching parent). Each row: members_2026 (every September 2026 member), members_continuing (the members on both sides of the change), plans, thin (true when the value rests on plans covering under 70% of the members or fewer than five plans) and, per benefit, {2026, 2027_same_members, change, coverage_2026, coverage_2027, 2026_all_members, unit}: 2026 is the continuing members' 2026 design, 2027_same_members those same members' 2027 design, change = 2027_same_members minus 2026; 2026_all_members is every 2026 member, context only, never one side of a change. coverage is the share of the row's members the value describes. A null value is unknown (no member filed it), never $0. Percent benefits are served 0-100. When an allowance is asked, like_for_like carries its dollars on the paired members (same form both years) with the share whose design changed form, which is a design change, never a raise or a cut.\n\nD-SNP figures are the FILED design: a full dual generally pays $0 under Medicaid; the full-dual reading is the Plan Value tool's full-dual column. Employer group plans and stand-alone Part D are not in the tables.\n\nTHE BENEFIT READING (mode = read | change | compare | drill; omit mode for the answer above). Each benefit is read as its DESIGN first (dental: a dollar maximum, the same plus a card that also pays dental, no maximum, on a card only, none), then as numbers that each carry their own denominator: value, measurable_pct (the share of the row's members the number describes; quote it), members, the simple_average across plans beside the member-weighted value, the trust tier, better_for_member, and on D-SNP rows the full_dual figure beside the filed design. benefits takes 'key', 'all', a family (allowance | card | cost_share | econ | service), a benefit (dental, otc, hearing, eyewear, card, primary_care, er, ...) or number ids such as dental:dollars_if, dental:cap_plus_card, cs:primary_care:pct_zero. years: e.g. '2024-2027' (2022-2026 each year's members; 2027 = the 2026 members followed into their 2027 plan).\n  read: the scope's cells for each year asked (include_overall=true adds a parent's labelled all-product row).\n  change: one BASE year (years='2026' = 2026 -> 2027): the same members and book vs book per number, plus value.transitions, members by from_design x to_design per benefit (exit = the plan ended with no successor), the like-for-like value change and the successor mix (renewed, restructured, crosswalked).\n  compare: parent and parent_b on the counties both serve with the product type (weight 'combined' or 'a'; overlap share printed), or contract_id against its closest contracts by footprint (precomputed).\n  drill: the plan segments behind the scope, largest first (a county, a state, or a parent nationally).\n\nSOURCE: Vlada benefit reading, edition v20261018b, from the CMS Plan Benefit Package filings, CMS county enrollment, the plan service area file and the CMS plan crosswalk.","layer":"L2","domain":"medicare","data_sources":["medicare_semantic.vw_benefit_reading_cells","medicare_semantic.vw_benefit_reading_cells_sd","medicare_semantic.vw_benefit_reading_simple","medicare_semantic.vw_benefit_reading_transitions","medicare_semantic.vw_benefit_contract_match","medicare_semantic.vw_benefit_reading_matched","medicare_semantic.vw_benefit_reading_atoms"],"underlying_silver_tables_for_pinning":[],"semantic_views_used":["medicare_semantic.vw_benefit_reading_cells","medicare_semantic.vw_benefit_reading_cells_sd","medicare_semantic.vw_benefit_reading_simple","medicare_semantic.vw_benefit_reading_transitions","medicare_semantic.vw_benefit_contract_match","medicare_semantic.vw_benefit_reading_matched","medicare_semantic.vw_benefit_reading_atoms"],"known_gaps":["Same-member change is 2026 continuing members against those members in 2027; members in plans that exit with no successor are in neither year, plans new in 2027 have no 2026 members.","Product types are never pooled: product_type ALL is refused.","D-SNP cost shares are the filed design; the dual-effective reading is Plan Value's full-dual column.","A null or zero weight is unknown, never $0; coverage rides beside every value.","Employer group plans and stand-alone Part D are not in the tables."]},{"name":"get_contract_profile","version":"1.0.0","description":"Everything Vlada holds on one Medicare Advantage contract, or one of its plans, in ONE call: the contract (name, parent, plan type, plans and counties served), enrollment by year and state, plan economics (risk score, Part A/B payment and rebate per member per month, by year), Overall / Part C / Part D stars by rating year, every plan's premium, MOOP, deductibles and supplemental allowances with the change from the prior plan year, ALL 36 filed benefits for a plan (doctor, hospital, emergency, diagnostics, equipment, drugs, dental, vision, hearing, OTC) with history back to 2019, the largest counties with share of county, and the 15 contracts it competes with most in its own counties.\n\nARGS: contract_id (H5549, R5826, ...). Optional plan_id ('011' or 'H5549-011'): that plan's benefits come back in full with their history. Without plan_id, benefits come back for the largest `benefit_plans` individual plans offered in the benefit year (default 3, max 5). Optional sections: any of contract, enrollment, economics, stars, plans, benefits, counties, competitors (default all).\n\nSOURCE: the same nightly build that serves vladahealth.com/ma (CMS monthly enrollment, CMS Landscape and plan benefit package filings, CMS plan payment files, CMS Star Ratings); value.build names it. Benefits are the plan's FILED design; a D-SNP member's cost is usually lower after Medicaid. Employer group plans (800-series) file placeholder cost sharing and are flagged egwp. The record holds the 40 largest plans and 40 largest counties; plan_count and county_count give the full numbers. For one benefit across many plans use get_pbp_benefit; for star measures use get_stars with include_measures.","layer":"L2","domain":"medicare","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":["The record carries the 40 largest plans and 40 largest counties of a contract; plan_count and county_count are the full counts.","Benefits are the filed plan benefit package design (one segment's row for a segmented plan), not what a dual eligible member pays after Medicaid.","The plan crosswalk is not part of this record."]},{"name":"get_contract_service_area","version":"0.2.0","description":"The county-level service area of Medicare Advantage contracts, month by month, from CMS's monthly MA Contract Service Area file (2006-10 on; 2022-11 was never published). Both directions: the counties a contract serves (contract_id) and the contracts serving a county (county_fips, 5 digits) or a state (state_code, 2 letters).\n\nWINDOW: report_month (YYYY-MM) or year; with neither, the newest month held (stated in value.query.report_month).\n\nRETURNS value.summary (distinct contracts, counties, contract-counties and contract-county-months; national, employer-group and partial-county counts; the months read), value.contracts (one row per contract: organization, organization type, plan type, counties served, employer-group and partial counties) and value.rows (one row per contract, county, month and flag combination: state_code, county_fips, county_ssa, county_name, eghp, partial_county, national_service_area). `limit` bounds both lists (default 100, max 2000); a truncated list carries a caveat.\n\nTHREE RULES: (1) eghp (employer-group only) and partial_county are CMS's own flags; eghp_only=true keeps employer-group rows. (2) A contract serving the whole country (National PACE and similar) is one national row with no state or county (national_service_area=true); it is never counted as a county, and a state or county filter leaves it out unless include_national=true. (3) CMS lists a contract-county twice when its plans there differ in the partial or employer flag, so count DISTINCT contract-counties, never rows; the summary already does.\n\nEach month is read at its newest CMS edition. Stand-alone Part D (PDP) service areas are a separate file and are not here.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.ma_contract_service_area_v2"],"underlying_silver_tables_for_pinning":["medicare_silver.ma_contract_service_area_v2"],"semantic_views_used":[],"known_gaps":["eghp and partial_county are CMS's own flags (parse revision 2); the revision-1 defect that read them false on every row does not apply.","National service-area rows have no state or county (national_service_area true); they are excluded from county counts and from state or county filters unless include_national is set.","A contract-county split across flag values appears on more than one row: count DISTINCT contract-counties.","CMS never published the 2022-11 file."]},{"name":"get_county_view","version":"1.5.0","description":"The whole Medicare Advantage picture of ONE county, over time, in one call: (1) enrollment by parent and product type each September from 2021, with CMS small-cell suppression carried as a floor and a ceiling, and the county's MA penetration where CMS holds it; (2) plan exits for every transition from 2023: continuing, departing, the five Day-One buckets, the true outcome where the crosswalk is held or the calibrated estimate range where not, parents before and parents continuing; (3) the same members' plan design this year against next (total premium, $0 premium share, MOOP, $0 Part D deductible share, D-SNP $0 cost sharing, star), at county grain where held, else the state figures under their own name with a coded note (get_landscape_benefit_change serves twelve metrics at state grain); (4) every plan sold in the county in the plan year with premium, MOOP, deductible and star, the D-SNP fields in their own columns, paged; (5) September members in contracts rated 4+ stars by rating year, with the rating-year to payment-year clock; (6) the County Volatility Index every plan year 2016-2027: per 100 members, those whose plan ended, who were moved, or whose plan made a material cut (premium +$10/month, MOOP +$500, dental max -$500 or dropped), pooled and by product type, beside the state and the nation, with the county's rank (detail=true adds the plans behind the newest year and what each changed; get_volatility_index ranks counties, states and insurers). Every tile is one row per product type with arrays over years or transitions, so the county reads over time in one call.\n\nARGUMENTS: state (two-letter) and county (the county name as CMS spells it, e.g. 'Cook', 'DuPage'; 'County' may be included or left off; a misspelling is refused naming the nearest CMS spellings), OR county_fips (five digits, e.g. '17031'), OR county_ssa (the five-digit CMS SSA state-county code, e.g. '14140', resolved to its FIPS through the CMS penetration file); year (the plan year for the plan list, default the newest Landscape year held); sections (comma-separated subset of enrollment, exits, benefit_change, plans, stars, volatility; default the first five: ask for volatility by name, e.g. sections=volatility for 'how volatile is my county'); detail: the two modes, summary (default, false: the product-type tiles, which fit one answer) and full (true: the tiles plus the parent x product type rows for enrollment and for the newest exits transition, and the plan list itself, paged); limit (rows per detail list per page, default 5, max 200) and offset (default 0), which page every detail list together, so a long page is one section at a time (sections=plans, detail=true, limit=100); include_cost_mmp (default false: industry = every product type but Cost and MMP).\n\nRETURNS value.blocks (one block per section: source, edition, the five clocks, the base, the seconds it took, its caveats, and a status of measured, substituted or unavailable with a code), value.county_by_year, value.enrollment_by_product_type, value.exits_by_product_type, value.benefit_change, value.plans_by_product_type, value.stars_exposure, value.volatility_by_year, value.volatility_by_product_type, value.summary; with detail=true also value.enrollment (parent x product type), value.exits (parent x product type, newest transition), value.plans and value.volatility_plans, each paged by limit and offset.\n\nRULES THE TOOL ENFORCES: the county is resolved by FIPS and the name key the Landscape carries is derived, never typed; the member base is H/R contracts, plans 001-799, September Y, matched to the Y Landscape by plan AND county; stand-alone Part D is never in it; D-SNP is its own product type and is never pooled; suppressed cells are carried as a floor and a ceiling, so every rollup keeps its bounds; parent is CMS's reported parent at each September and a parent's figure is the sum of its members, never a plan count; every section names its clocks.\n\nSOURCE: Vlada analysis of the CMS monthly enrollment by plan and county, the CMS MA state-county penetration file, the CMS MA/Part D Landscape files, the CMS plan crosswalk where held, and the CMS Star Ratings.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.enrollment_monthly_county_v4","medicare_semantic.vw_ma_state_county_penetration_v4","medicare_silver.fact_ma_landscape","medicare_silver.stars_ratings_summary","medicare_silver.plan_crosswalks_annual","medicare_semantic.vw_enrollment_monthly_county_v3","medicare_semantic.fact_landscape_disposition_v1","medicare_semantic.fact_landscape_benefits_v2","medicare_semantic.cvi_plan_county_v4"],"underlying_silver_tables_for_pinning":["medicare_silver.enrollment_monthly_county_v4","medicare_semantic.vw_ma_state_county_penetration_v4","medicare_silver.fact_ma_landscape","medicare_silver.stars_ratings_summary","medicare_silver.plan_crosswalks_annual"],"semantic_views_used":["medicare_semantic.vw_enrollment_monthly_county_v3","medicare_semantic.fact_landscape_disposition_v1","medicare_semantic.fact_landscape_benefits_v2","medicare_semantic.cvi_plan_county_v4"],"known_gaps":[]},{"name":"get_drug_source_inventory","version":"1.0.0","description":"Discover the drug substrate. Returns one row per drug_silver table (and per expected-but-missing source) with: domain, row_type, row count, time range, refresh cadence, next expected refresh, MCP tool(s) exposing the table, quality signals (dup_pk groups + null_bronze count + last quality-check outcome), cadence-drift and agent-usage signals, and the current Iceberg snapshot id reader at last inventory refresh.\n\nFilters: domain (spuf / drug_identity / regulatory / etc.), row_type (existing | expected_missing | deprecated | blocked_restricted), refresh_cadence, has_mcp_tool (bool — true=only MCP-exposed, false=dark-zone), quality_failing_only (bool), production_only (bool, default true), table_name (exact match), expected_source_id (filter negative-space rows).\n\nThis is the meta-tool for substrate discovery. Call FIRST to plan which other tools to call, to detect stale tables before relying on them, OR to find sources the substrate doesn't yet have (negative-space awareness via row_type='expected_missing' — a v2 addition over MA's v1).\n\nv2 additions over MA's get_ma_source_inventory: per-row quality signals (closes blind spot: existence ≠ correctness), snapshot pinning columns (closes blind spot: inventory ≠ current state), and negative-space rows for sources we expect but haven't ingested yet. v3 additions: cadence drift and trailing 7-day agent query counts.\n\nSOURCE: drug_silver.dim_drug_source_inventory — refreshed daily.","layer":"L2","domain":"drug","data_sources":[],"underlying_silver_tables_for_pinning":["drug_silver.dim_drug_source_inventory"],"semantic_views_used":[],"known_gaps":["drug_inventory_quality_check_stale"]},{"name":"get_enrollment","version":"0.4.0","description":"Returns CMS monthly enrollment for a Medicare Advantage plan or contract: the member count, the trend over time, and, at contract level, the MA-only vs Part-D split, plus org/parent and plan type. Filter by contract_id (required) + optional plan_id (plan grain vs contract total), and optional year ('2024') or month ('2024-03'); with neither, returns the latest month plus a trailing 13-month trend. Monthly coverage back to 2006. Every row carries the year-over-year change (yoy_change / yoy_pct) vs the same month one year earlier; plan rows carry the plan's SNP class (snp_type) when applicable.\n\nRETURNS a detail payload, not a bare count: value.summary (latest_month, latest_enrollment, yoy_change / yoy_pct, ma_only_count / part_d_count, trend min/max and change over the window), value.months (the per-month trend rows), value.row_counts (matched / returned / truncated / limit) and value.query (the filters actually applied). `limit` bounds the trend rows returned (default 13 months, max 2000); a truncated list always carries a caveat.\n\nEnrollment is the SPINE every other MA metric joins to (per-member, share-weighted). SUPPRESSION is honest: CMS redacts cells under 11 enrollees, which come back as count=null with a [lower, upper] bound and suppression_reason='redacted_small_cell', never a zero, and the suppression caveat fires only when a returned month is actually redacted. A contract id that does not exist returns found=false with a not_found_reason, never a suppression story.\n\nPair with get_pbp_benefit or get_stars to weight or normalize by members. SOURCE: CMS Monthly Enrollment by Plan / by Contract.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.enrollment_monthly_plan","medicare_silver.monthly_contract_enrollment_summary"],"underlying_silver_tables_for_pinning":["medicare_silver.enrollment_monthly_plan","medicare_silver.monthly_contract_enrollment_summary"],"semantic_views_used":[],"known_gaps":["Cells under 11 enrollees are CMS-redacted: count=null with a [lower, upper] bound and suppression_reason='redacted_small_cell'.","MA-only vs Part-D split is contract-level only (omit plan_id to get it).","County / market-share grain lives in enrollment_monthly_county (612M rows); this tool serves plan + contract totals."]},{"name":"get_exchange_plan_profile","version":"1.0.0","description":"One ACA Marketplace (healthcare.gov / HIX) plan's profile for a plan year, every field tagged with the CCIIO PUF it came from. Give plan_id (the 14-character HIOS standard component id, e.g. 38344AK1060001) for the plan: issuer, metal level, plan type (HMO/PPO/EPO/POS), Individual vs SHOP, on/off exchange, network, county footprint, premium benchmarks at age 21/40/60 (min across the plan's rating areas, plus the age-40 max), the per-age premium curve from the Rate PUF (include_rate_curve, default true), headline cost shares (PCP / specialist / ER / urgent care / generic drug copay, inpatient coinsurance), CMS quality stars, and the issuer's individual-market MLR. Or give state (+ optional plan_year, metal_level, issuer_id, plan_type, on_off_exchange) for the bounded list of that state's plans, cheapest age-40 premium first. plan_year defaults to the latest year held (PY2014-2026). Deductible / MOOP are returned as not_available (not in the composed profile). FFM states only: a state-based marketplace (CA, NY, PA, GA, ...) is absent at source and the tool says so rather than returning nothing silently.","layer":"L2","domain":"commercial","data_sources":["medicare_silver.fact_exchange_plan_profile_v2","medicare_semantic.vw_rate_puf_current"],"underlying_silver_tables_for_pinning":["medicare_silver.fact_exchange_plan_profile_v2","medicare_semantic.vw_rate_puf_current"],"semantic_views_used":[],"known_gaps":["FFM (healthcare.gov) states only; state-based marketplaces are absent at source.","Deductible / MOOP are not in the composed profile (untyped raw JSON in the Plan Attributes PUF today) and are returned as not_available.","premium_age21/40/60 are the MIN across the plan's rating areas (age-40 MAX also given); county-grain premium needs the rating area (use rate_curve / the Rate PUF).","Cost shares are the base variant (-01) as filed; CSR variants differ. Quality only for CMS-rated plans in PY2023/2024/2026; MLR only PY2019-2024; PY2015 premiums thin at source; medical plans only (v1)."]},{"name":"get_hos","version":"0.2.0","description":"Returns a Medicare Advantage contract's CMS Health Outcomes Survey (HOS) rates across the four survey topics (fall_risk_management, urinary_incontinence, osteoporosis_testing, physical_activity), each with the two reported rates and the year-over-year change. Filter by contract_id (required) + optional year (defaults to the latest; report years 2019-2025).\n\nRETURNS a detail payload, not a topic count: value.topics is the per-topic row list (topic, report_year, rate1, rate2, rate3, rate1_yoy), value.summary rolls it up (topic_count, which topics reported, the highest and lowest rate1), value.row_counts carries matched / returned / truncated and value.query the filters applied. `limit` bounds the rows (default 200, max 2000).\n\nHOS is the beneficiary-survey companion to the chart-abstracted HEDIS rates and feeds several Part C Star measures. rate1/rate2 are the survey's two published rates for the topic (e.g. the share who reported the issue and the share who discussed it with a provider); see the CMS HOS documentation for exact definitions. Pair with get_stars. A contract id with no HOS rows returns found=false with a not_found_reason.\n\nSOURCE: CMS Health Outcomes Survey (HOS) Public Use File.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.hedis_hos_frm","medicare_silver.hedis_hos_mui","medicare_silver.hedis_hos_oto","medicare_silver.hedis_hos_pao"],"underlying_silver_tables_for_pinning":["medicare_silver.hedis_hos_frm","medicare_silver.hedis_hos_mui","medicare_silver.hedis_hos_oto","medicare_silver.hedis_hos_pao"],"semantic_views_used":[],"known_gaps":["rate1/rate2 semantics are topic-specific; consult the CMS HOS documentation."]},{"name":"get_hospital_quality","version":"0.1.0","description":"Returns one hospital's CMS Care Compare quality record by CCN: the overall star rating (1-5) with hospital type / ownership; every Care Compare measure for the hospital (mortality and complication rates, unplanned readmission / ED-return rates, timely and effective care, healthcare-associated infections SIRs, outpatient imaging efficiency, maternal health) with the score, CMS's compared-to-national verdict where published, denominator, confidence bounds and measurement window; the HCAHPS patient-experience summary (summary star + per-dimension star ratings and linear mean scores) for the latest reporting year the hospital has; and the HRRP excess readmission ratios per condition for the latest fiscal year (ratio > 1 = more readmissions than nationally expected). Inputs: ccn (required, 6-char CMS certification number); optional measure_group (alias: measure_source) to get ONE group's measure rows (complications_deaths | unplanned_visits | timely_care | healthcare_assoc_infections | outpatient_imaging_efficiency | maternal_health); optional limit and offset to page the measure rows (default limit 25 once detail is asked for).\n\nTHE DEFAULT CALL IS A SUMMARY: ccn alone returns the overall rating, the HCAHPS and HRRP blocks, and the measure GROUPS with a count each (summary.measure_groups: measure_count / available / not_available / vs_national per group) — NOT the ~108 measure rows, which exceed the response budget for a single hospital. Totals are still reported (summary.measure_count) and row_counts.measures names what was withheld; ask again with measure_group, or limit / offset, for the rows.\n\nRETURNS a detail payload: value.summary (facility, overall_rating with status + footnote, hcahps_summary_star, counts, measure_groups, measure_detail_mode, and a `blocks` map saying which of overall_rating / measures / hcahps / hrrp are available for THIS hospital); value.measures, value.hcahps, value.hrrp row lists. Every row carries status = available | not_available (with the CMS footnote or reason), source_table and source_vintage (asserted_at). Nothing is fabricated: a suppressed or unreported measure is not_available, never a zero; an unrated hospital reports overall_rating null with the CMS footnote. All four sources are read WHERE is_current = true. An unknown CCN returns found=false.\n\nSOURCE: CMS Provider Data Catalog (Care Compare) Hospital General Information, hospital measure files, HCAHPS, and the HRRP hospital file.","layer":"L2","domain":"hospital","data_sources":["medicare_silver.dim_hospital_quality","medicare_silver.fact_hospital_quality_measure","medicare_silver.fact_hcahps","medicare_silver.fact_hrrp"],"underlying_silver_tables_for_pinning":["medicare_silver.dim_hospital_quality","medicare_silver.fact_hospital_quality_measure","medicare_silver.fact_hcahps","medicare_silver.fact_hrrp"],"semantic_views_used":[],"known_gaps":["overall_rating is null for hospitals CMS does not rate (~40% of CCNs) — unrated, not 0.","score_numeric is null for suppressed / categorical / footnoted measures; the row is returned as not_available with the footnote.","HCAHPS answer-percent distribution rows are not returned (star + linear mean summary only); HRRP is the latest fiscal year only.","Measure semantics differ per measure_id; do not compare scores across unlike measures."]},{"name":"get_landscape","version":"0.5.0","description":"Returns the CMS Landscape view of a Medicare plan: monthly premium, in-network MOOP, overall star rating, plan type, and the county/state service-area breadth. Filter by contract_id (required) + optional plan_id (1 to 3 digits, zero-padded), segment_id and year; omit plan_id to list all plans on a contract.\n\nRETURNS a detail payload, not a plan-year count: value.plans is the actual PLAN LIST, ONE ROW PER PLAN SEGMENT (report_year, plan_id, segment_id, segment_count, plan_name, org_name, parent_org_name, plan_type, category, snp_type, total_premium, total_premium_basis, premium_as_filed, consolidated_premium, part_c_premium, part_d_premium, moop_in_network, overall_star_rating, overall_star_status, service_area_county_count / state_count), sorted premium ascending so the cheapest lead; value.summary rolls it up (plan_count = distinct plans, segment_row_count, segmented_plan_count, total premium min / median / max, zero-premium count, premium basis counts, star min / max, total distinct counties); value.row_counts carries matched / returned / truncated and value.query the filters applied. `limit` bounds the row list (default 200, max 2000); a truncated list always carries a caveat.\n\nREADING THE PREMIUM. total_premium is the plan's monthly premium on one basis per row, named in total_premium_basis: 'consolidated' (CMS's Part C plus Part D figure), 'part_c_only_no_drug_coverage' (from CY2025 CMS prints the consolidated premium as 'Not Applicable' on every plan without drug coverage, so the Part C premium is the whole premium), 'part_d_only' (a PDP), or null when CMS filed no figure. CMS's own text is carried in premium_as_filed; its '$-' token (CY2014, 2015, 2019-2023) is a $0 premium, never missing. A segment is its own filed design: a segmented plan has one row per segment with its own premium and MOOP.\n\nCovers ALL plan categories (MA, PDP, SNP, MMP, Cost), 2007-2027; the CY2027 file loaded 2026-09-28. The Landscape drops ~early September, ahead of the October benefits drop, so it is the first official view of the upcoming plan year. Stars for 2013-2020 are read from CMS's text form ('3.5 Stars'); a CMS message in place of a star is carried in overall_star_status. Pair with get_pbp_benefit (benefits) for the full picture. A contract / plan / year with no Landscape rows returns found=false with a not_found_reason.\n\nSOURCE: CMS MA/Part-D Landscape source files.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.fact_ma_landscape"],"underlying_silver_tables_for_pinning":["medicare_silver.fact_ma_landscape"],"semantic_views_used":[],"known_gaps":[]},{"name":"get_landscape_benefit_change","version":"1.4.0","description":"What the plan design looked like for the SAME Medicare Advantage members in year Y and in year Y+1, member-weighted from the CMS Landscape files: total, Part C and Part D premiums and the $0 shares, the premium after full Extra Help, in-network MOOP and the share at or under $5,000, the Part D deductible and its $0 and standard shares, the tier-skips-deductible share, MA-PD and enhanced shares, the D-SNP $0 cost sharing, FIDE and HIDE shares, and the overall star. Both sides of a change are the SAME members: y = the Y design of the members whose plan continues in their county (same_store, Day-One) or is routed through the CMS crosswalk where that crosswalk is held (routed: continues + moved); y1 = those members' Y+1 design; change = y1 minus y. all_members_y = the Y design on every September-Y member (members_y), context only, never one side of a change. The members whose plan departs and is not yet crosswalked are in all_members_y and members_y but NOT in y, y1 or members_y1, and the row says how many.\n\nARGUMENTS: transition_year (Y, default the newest held), group_by (national | product_type | parent | state | parent_by_product | state_by_product | county; county needs state and returns one row per county of that state, each on its own members), product_type / state / parent (filters), county (filter, the county name as CMS spells it, e.g. 'Maricopa'; with product_type it cuts one county by product), metrics ('key' = the twelve headline metrics, 'all' = every metric, or a comma-separated list of metric names), weight (same_store | routed; any other value is refused by name, and routed is refused where the crosswalk is not held), include_cost_mmp (default false), limit (default 50, max 500, largest members first).\n\nRETURNS value.rows (one per group: members_y (every September-Y member), members_y1 (the same members on both sides of the change) and, per metric, {y, y1, change, all_members_y, unit}), value.summary (the national row for the same scope, the editions, the weight used) and value.metrics (the metric labels and units). Dollars are the filed monthly premium / annual MOOP or deductible in nominal dollars; pct metrics are shares of members in the metric's own domain (Part D metrics over MA-PD members, D-SNP metrics over D-SNP members).\n\nRULES THE TOOL ENFORCES: member base H/R contracts, plans 001-799, matched to the Y file by plan and county; PDP never; industry excludes Cost and MMP unless asked; D-SNP is its own product type; a change is over the same members, never a mix of two populations. Suppressed cells count as zero, so every weight is a floor.\n\nSOURCE: Vlada analysis of the CMS MA/Part D Landscape files, CMS monthly enrollment by plan and county, and the CMS plan crosswalk where held.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.fact_ma_landscape","medicare_silver.enrollment_monthly_county","medicare_silver.plan_crosswalks_annual","medicare_semantic.fact_landscape_benefits_v2","medicare_semantic.fact_landscape_benefits_county_v2"],"underlying_silver_tables_for_pinning":["medicare_silver.fact_ma_landscape","medicare_silver.enrollment_monthly_county","medicare_silver.plan_crosswalks_annual"],"semantic_views_used":["medicare_semantic.fact_landscape_benefits_v2","medicare_semantic.fact_landscape_benefits_county_v2"],"known_gaps":[]},{"name":"get_landscape_exits","version":"1.2.1","description":"Members of Medicare Advantage plans that do NOT continue into the next plan year, from the Landscape disposition: every September member of year Y placed against the Y+1 Landscape file. A member CONTINUES when the same plan is sold in their county next year; otherwise they are DEPARTING, split into the five Day-One buckets the two Landscape files can see (D1 a same-named plan in the county, D2 the plan still sold elsewhere, D3 the contract still in the county, D4 the parent still in the county, D5 the parent gone). When the CMS crosswalk for Y+1 is held, each row also carries the TRUE outcome (moved, split, stranded by a service-area reduction, terminated); when it is not yet held (the newest transition) the answer carries the calibrated estimate range of members who lose their plan, from the buckets' measured rates in the held years.\n\nARGUMENTS: transition_year (Y, the September enrollment year; default the newest held, 2026 = the 2026 to 2027 transition), group_by (national | product_type | parent | state | parent_by_product | state_by_product | county; default national; county needs state and returns one row per county of that state, each with its own members base), product_type (filter, e.g. 'non-SNP HMO', 'D-SNP HMO'), state (two-letter filter; required when group_by is county), county (filter, the county name as CMS spells it, e.g. 'Cook' or 'Maricopa'; with group_by county it returns that one county), parent (filter, the CMS parent organization as reported), include_cost_mmp (default false: industry = every product type but Cost and MMP), limit (rows, default 50, max 500, largest members first).\n\nRETURNS value.rows (one per group: base_members = THE MARKET, the number to quote as 'members in the market', the base pct_departing is over; continuing, departing, pct_departing, the five buckets, and either the true_* outcomes or est_lost_low / est_lost_high; then members_september = base_members PLUS the members whose plan-county is not in the Y Landscape list or is outside the Landscape, a reconciliation figure, never the market), value.summary (the totals for the same scope, the editions, and the calibration rates used). For 'your county, 2027': group_by county, state and county, then product_type to cut it by product.\n\nRULES THE TOOL ENFORCES: the member base is H/R contracts, plans 001-799, September Y, matched to the Y Landscape by plan AND county (members whose plan-county is not listed are counted separately, never silently); stand-alone Part D (PDP) is never in it; D-SNP is its own product type and is never pooled; parent is CMS's reported parent organization at September Y, not a canonical chain across renames. Suppressed enrollment cells (under 11) count as zero, so every figure is a floor.\n\nSOURCE: Vlada analysis of the CMS MA/Part D Landscape files, CMS monthly enrollment by plan and county, and the CMS plan crosswalk where held.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.fact_ma_landscape","medicare_silver.enrollment_monthly_county","medicare_silver.plan_crosswalks_annual","medicare_semantic.fact_landscape_disposition_v1"],"underlying_silver_tables_for_pinning":["medicare_silver.fact_ma_landscape","medicare_silver.enrollment_monthly_county","medicare_silver.plan_crosswalks_annual"],"semantic_views_used":["medicare_semantic.fact_landscape_disposition_v1"],"known_gaps":[]},{"name":"get_market_share","version":"0.3.1","description":"Returns a Medicare Advantage plan's or contract's county-level enrollment and its SHARE of the local MA market: for each county, the plan's enrollees, the county's total MA enrolled and Medicare-eligible population, the MA penetration rate, the plan's share of county MA enrollment, and the year-over-year change in the plan's county enrollment. Filter by contract_id (required) + optional plan_id (plan vs contract total), optional state (2-letter, e.g. 'FL'), and optional month ('2024-03'); defaults to the latest available month.\n\nRETURNS an actual SHARE with the arithmetic disclosed, not a raw headcount: value.summary.share_pct is the footprint share, and it always ships alongside its numerator (share_numerator_plan_enrollees) and its denominator (share_denominator_county_ma_enrolled), so nobody has to trust a bare percentage. The denominator is the total MA enrollment of the counties this plan actually operates in for the month in scope, NOT the national MA market. value.counties is the per-county row list (plan enrollees, county MA enrolled, county eligibles, penetration, share_pct, yoy_change), largest first; value.row_counts carries matched / returned / truncated and value.query the resolved month. `limit` bounds the county list (default 200, max 2000).\n\nThis is the geography + competition lens; pair with get_enrollment for the plan/contract totals. Suppressed county cells (CMS redacts under 11) come back with null enrollees and null share, never zero, and the summary carries a [low, high] bound on the numerator that brackets them. A contract id with no county rows returns found=false with a not_found_reason.\n\nSOURCE: CMS Monthly Enrollment by CPSC + MA State/County Penetration.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.enrollment_monthly_county_v4","medicare_silver.ma_state_county_penetration","medicare_semantic.vw_enrollment_monthly_county_v3","medicare_semantic.vw_ma_state_county_penetration_v4"],"underlying_silver_tables_for_pinning":["medicare_silver.enrollment_monthly_county_v4","medicare_silver.ma_state_county_penetration"],"semantic_views_used":["medicare_semantic.vw_enrollment_monthly_county_v3","medicare_semantic.vw_ma_state_county_penetration_v4"],"known_gaps":["County cells under 11 enrollees are CMS-redacted (null enrollees, null share).","Share = plan county enrollees / total MA enrolled in county (penetration file)."]},{"name":"get_medicaid_mco_enrollment","version":"0.5.0","description":"Returns Medicaid managed-care enrollment for ONE state. HEADLINE (value.summary.tracker, value.tracker_parents, value.tracker_months): the Medicaid MCO enrollment tracker v2, the state's own monthly figure by parent for its latest 13 months, every figure graded observed (a published count), estimated (ours, with an interval) or modeled (indicative only, never in a total) and summed apart; summary.tracker.headline is the latest month that carries a value, with its basis, methods and interval, and summary.tracker.last_observed the latest observed month. parent_basis (optional): 'current' (default) rolls every month up to each plan's parent as bound today; 'dated' rolls each month up to the parent that owned the plan in that month; never mix the two in one series. Behind it: the annual CMS 'Enrollment by Program and Plan' roster (each managed-care program x plan with SEPARATE Medicaid-only, dual and total member counts and a value_status per count, plus parent organization) for the requested or latest calendar year (2016-2024); the state's TOTAL Medicaid and CHIP enrollment from the CMS monthly state report for the latest 12 reporting months (context: all delivery systems, managed care and fee-for-service, CHIP separate); and, for the four T-MSIS dashboard pilot states (AZ, MI, NV, NM), the MCO roster with county footprint and service categories; and the state's OWN monthly plan-level publication for its latest month (45 jurisdictions). Inputs: state (required, 2-letter USPS code); optional year (plan-roster calendar year, defaults to the latest the state has); optional limit; optional offset (skips that many rows of value.plans and value.monthly_plans in their served order; summary.paging.next_page is the exact next call).\n\nRETURNS a detail payload: value.summary (state, plan_year, plan_count, program_count, the SOURCE-PUBLISHED sum of plan total_enrollment where reported_numeric for the comprehensive_medical benefit scope ONLY, plus per-benefit-scope sums that must never be added together, with the count of rows that are suppressed / not reported, the latest monthly total Medicaid+CHIP / Medicaid / CHIP enrollment with its reporting_period, and a `blocks` map saying which sources have rows for this state); value.plans (one row per program x plan x region, ordered comprehensive medical first and largest first BEFORE the row cap, summary.plans_page saying how many rows and of which scope are not on the page: benefit_scope (comprehensive_medical, behavioral_health, dental, pharmacy, ltss, pace, nemt, pccm, limited_benefit, unknown) with the rule that set it, medicaid_only / dual / total each with value + value_status, parent_organization = the parent in force through Vlada's effective-dated plan identity decisions (null when no decision covers the filed name), parent_label_as_filed = the parent column as the state filed it (in Florida the plan's own label), calendar_year, source_table); value.monthly (reporting_period, total_medicaid_and_chip_enrollment, total_medicaid_enrollment, total_chip_enrollment, adult / child enrollment, revision + final flags, source_table); value.mco_roster (mco_name, plan_category, county_count, service_categories, source_table; NO enrollment number); value.monthly_plans (the state-published plan rows for the latest monthly observation_period, statewide where the state publishes statewide rows, otherwise sub-state as published, each with reported_value, value_unit, value_status, row_role and source_url; never summed into a state total; per program, statewide rows where the program publishes them, otherwise sub-state rows; each row carries parent_share_segment when it lies inside the parent-share view's basis, and summary.parent_share_reconciliation names that basis and routes to it). The ledger stores 17 states' publisher totals as plan detail: rows whose plan label reads as a total, whose label is fee-for-service (fee_for_service_not_a_plan), whose label is an eligibility, population or unassigned count (population_count_not_a_plan), whose plan label is a bare number, whose program label is a total, or whose value equals a suspected total in the same cell are served with row_role publisher_total_suspected / fee_for_service_not_a_plan / population_count_not_a_plan / plan_label_numeric_suspected / overlapping_summary_suspected / equals_publisher_total_suspected, the stored role kept in row_role_as_published, ordered after plan detail, never dropped; summary.monthly_plans_not_plans lists the page's non-plan rows in their own block; summary.monthly_plans_guard carries the rule and the counts over the whole month. Each monthly_plans row carries cell_check (source_total, sum_of_plans, plan_rows, difference, status): within one cell (one table, measure, program, breakdown and geography) the plan rows are summed, never the re-labelled rows, and set beside the publisher's own total, so a reader sees whether the plans add up; plan rows are never added across cells. A fractional value under value_unit 'members' is an average and the row says so (value_unit_note); a published 0 may be a masked small cell (WA prints 0 for 1 to 10). Every number carries its as-of period and exact source table. Nothing is recomputed or reconciled across sources: Medicaid-only + dual is not re-summed, a published 0 is reported_zero_or_suppressed (never exact zero), and the annual plan roster is a different population and grain from the monthly state total. All sources are read WHERE is_current = true (monthly: is_latest_revision = true). An unknown state returns found=false.\n\nSOURCE: state Medicaid agencies' published plan enrollment through the Medicaid MCO enrollment tracker v2 (medicare_semantic.vw_medicaid_mco_enrollment_tracker_v2_parent_state_month); CMS/Data.Medicaid.gov Medicaid Managed Care Enrollment by Program and Plan (state-reported, annual); CMS Medicaid & CHIP Application, Eligibility and Enrollment monthly state report; CMS Medicaid MCO Dashboard (T-MSIS, four pilot states); state Medicaid agencies' monthly managed-care enrollment reports (medicare_semantic.vw_medicaid_mco_enrollment_tracker_reported_observation_v6).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.cms_medicaid_managed_care_plan_enrollment","medicare_silver.cms_medicaid_chip_enrollment_monthly_state","medicare_silver.fact_medicaid_managed_care"],"underlying_silver_tables_for_pinning":["medicare_silver.cms_medicaid_managed_care_plan_enrollment","medicare_silver.cms_medicaid_chip_enrollment_monthly_state","medicare_silver.fact_medicaid_managed_care"],"semantic_views_used":[],"known_gaps":["Tracker v2 headline: the latest month most states have printed lags the calendar; newer months are estimated (interval) or modeled (indicative, never in a total). Parents are today's binding, not the parent as of the month.","Plan roster is annual (2016-2024) and state-reported; plan labels and the filed parent column (parent_label_as_filed) are publisher text, not stable payer identities; parent_organization is read through the reviewed plan identity decisions and is null where none covers the filed name.","Published 0 may be exact zero or CMS confidentiality suppression under ten (reported_zero_or_suppressed) — never asserted as exact zero.","Monthly series = TOTAL Medicaid and CHIP enrollment (all delivery systems), not managed-care enrollment; CHIP is a separate column and is not inside the plan-level counts.","fact_medicaid_managed_care covers four pilot states (AZ, MI, NV, NM) and carries utilization, not enrollment; returned as a roster only."]},{"name":"get_medicaid_rate","version":"0.2.0","description":"State Medicaid fee-for-service (FFS) rates by code from every state's published fee schedules, with history, cross-state comparison and the Medicare benchmark. Five modes: lookup (state + code(s): the rate in force today or on as_of, with its unit, type, schedule, effective date and source), compare (one code across every state that publishes it, on one basis, with the national median, quartiles, ratio and rank), trend (one state x code: the dated rates by key with the change at each step), changes (every rate that moved in a state in a date window: increase, decrease, new_code, pct_change), vs_medicare (a state's Medicaid rates as a share of the Medicare PFS non-facility rate for the same codes).\n\nUse cases: 'What does Arizona Medicaid pay for 97153 (ABA)?'; 'Which states pay the most for T1019 personal care per hour?'; 'How has Ohio's H2019 rate moved since 2021?'; 'What changed in Florida's behavioral health rates this year?'; 'How does Texas Medicaid compare with Medicare for 99213?'.\n\nA rate is dated by its own effective date (schedules reprint old rates in each edition; the latest edition printing a dated rate wins; in force = the latest dated rate on or before the day, for a key the current edition still prints). Every rate names its unit (rate_unit, unit_minutes) and type (fee, per_diem, percent_of_charges, conversion_factor, manual_pricing, not_covered); a key with more than one rate for the same date is served flagged ambiguous_key and never averaged; compare keeps one basis (per_hour for time units) and lists other-basis states as not compared. These are the state's FFS maximums, never managed-care negotiated rates. Coverage is state by state (47 states on 2026-11-02): a state with no rows is not built yet, not zero.\n\nSOURCE: vlada_curated.vw_state_medicaid_rate_v2 (one row per published rate with its source file sha256 and locator) and the States lane's views vw_state_medicaid_rate_change_v1, _compare_v1, _vs_medicare_v1 (M2).","layer":"L2","domain":"state","data_sources":["vlada_curated.vw_state_medicaid_rate_v2","vlada_curated.vw_state_medicaid_rate_change_v1","vlada_curated.vw_state_medicaid_rate_compare_v1","vlada_curated.vw_state_medicaid_rate_vs_medicare_v1"],"underlying_silver_tables_for_pinning":["vlada_curated.vw_state_medicaid_rate_v2","vlada_curated.vw_state_medicaid_rate_change_v1","vlada_curated.vw_state_medicaid_rate_compare_v1","vlada_curated.vw_state_medicaid_rate_vs_medicare_v1"],"semantic_views_used":["vlada_curated.vw_state_medicaid_rate_change_v1","vlada_curated.vw_state_medicaid_rate_compare_v1","vlada_curated.vw_state_medicaid_rate_vs_medicare_v1"],"known_gaps":["Coverage is state by state (47 states on 2026-11-02; 147 of 255 state x service-line cells served): a state or line with no rows is not built yet, not zero.","A printing that holds more than one rate for the same date is served flagged ambiguous_key with its low and high, and kept out of compare (1 key on 2026-11-02 after the dated rule; 11,518 when keyed by edition).","History depth varies by state (back to 2021 in 71 of 147 cells; some schedules one dated rate).","vs_medicare joins only no-modifier, single-rate keys with a per-service / unit / visit / 15_min unit and a 5-character CPT/HCPCS code; the Medicare side is PFS non-facility, latest year, unweighted mean of the state's localities, so a per-15-minute Medicaid rate against a per-service Medicare amount is not like for like.","compare and trend read one code at a time; lookup and vs_medicare take up to 25 codes."]},{"name":"get_negotiated_rate","version":"2.1.0","description":"COMING SOON on the customer surface (withdrawn 2026-11-09; insurer files are thin): negotiated rates by insurer and plan are served from hospital files by compare_hospital_rates and plan_hospital_price. Get the negotiated rate a specific payer pays a specific NPI for a specific billing code, in a state. Resolves at query time through the canonical graph + inverted indexes (no precomputed edge table) and returns the most provider-specific rate with source lineage, methodology, evidence type, and Medicare-PUF corroboration. UHC custom codes are resolved automatically. Covers all built payers. Near-zero dollar rates (positive, under $1 — the ghost class the benchmark path excludes) are never picked over a plausible rate; if one is all that matched, it is served flagged is_ghost_candidate at confidence 0.2 with a caveat, never as a real price.","layer":"L2","domain":"commercial","data_sources":["vlada_curated.fact_rate","vlada_curated.idx_rate_lookup"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_rate","vlada_curated.idx_rate_lookup"],"semantic_views_used":[],"known_gaps":["state required for resolution","medical_mutual not yet indexed"]},{"name":"get_network_breadth","version":"0.2.0","description":"How broad a Medicare Advantage plan's published provider network is, county by county, against the other plans sold there: for a contract or CMS plan id and plan year (2026 or 2027), each county in its service area with the providers it lists there, the county's listed universe (every MA plan's published directory in that county), breadth (the share), its rank among the county's individual plans, and the rivals' median and best. Narrow to one specialty in CMS's network-adequacy vocabulary (Primary Care, Cardiology, Psychiatry, ...), a state, or one county; with a county, the rival plans are returned ranked.\n\nUse cases: 'Is H5938's network narrower than its rivals in Leon County?'; 'Where does this PPO rank on cardiologists in Florida?'; 'Which plan in Cook County lists the most psychiatrists for 2027?'.\n\nBreadth is a share of what MA plans list, not of every practising clinician. Every row carries the share of the plan's providers found by name match and the share carried from the other year's list, so a printed-PDF plan is not silently compared with an API plan. Specialty comes from NPPES's taxonomy, not the directory's label. The publish is pinned by dataset_id.\n\nSOURCE: medicare_silver.ma_network_plan_county_v1, built from the Data Tracker's directory table (medicare_bronze.ma_directory_plan_npi_site_v1), NPPES, and the CMS plan service area.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.ma_network_plan_county_v1","medicare_silver.fact_ma_landscape"],"underlying_silver_tables_for_pinning":["medicare_silver.ma_network_plan_county_v1","medicare_silver.fact_ma_landscape"],"semantic_views_used":[],"known_gaps":["Coverage follows the directory build (stage 25: 99.17% of 2026 MA members, 96.42% of 2027 members from 2027 sources); an uncovered contract answers no_coverage, and a plan with listings only outside its CMS service area has no breadth rows.","Name-matched lists under-count: names that resolve to no single NPI are dropped, so a printed-PDF plan can read narrower than it is (matched_share says how much of the list is name-matched).","About 2.5% of listings have a ZIP with no county and sit outside every county count.","Contract-level directories (one network for every plan in the contract) are applied to each plan sold in the county (contract_level_share)."]},{"name":"get_network_change","version":"0.2.0","description":"Who joined and who left a Medicare Advantage plan's published network between two directory years (2026 to 2027): the NPIs that stayed, joined and left, with rates, on published units only. The method: members are NPIs the payer printed, served by API or exported to Plan Finder, or name-matched at grade A/B; 2027 rows carried back from a 2026 directory are excluded; only ZIP3 areas the unit lists in both years count, so a service-area change does not read as an exit. By contract or by the publisher's own plan id.\n\nUse cases: 'Did H5938 lose providers for 2027?'; 'How much of Wellcare H1416's Texas network turned over?'.\n\nA directory signal is never evidence of a contract ending on its own (the method's public-confirmation rule); the health-system rollup and the exit signal are not served here. Both years must be covered or the answer is NO_COVERAGE.\n\nSOURCE: medicare_bronze.ma_directory_plan_npi_site_v1 (the Data Tracker's directory build).","layer":"L2","domain":"medicare","data_sources":["medicare_bronze.ma_directory_plan_npi_site_v1"],"underlying_silver_tables_for_pinning":["medicare_bronze.ma_directory_plan_npi_site_v1"],"semantic_views_used":[],"known_gaps":["No health-system rollup and no exit signal here (the method's steps 4-5 need the facility affiliation and dim_facility_system tables and a public confirmation); counts are by contract or plan.","Humana's 2027 joined rate reads high in the method's own scale table and may be a printing or matching artifact; treat a large joined count as unverified.","A contract uncovered in either year answers NO_COVERAGE."]},{"name":"get_network_groups","version":"0.2.0","description":"Which physician groups and health systems a Medicare Advantage contract's published network covers, and how much of each: for a contract and plan year (2026 or 2027), every billing group its listed clinicians bill Medicare through (or every health system of the hospitals they are affiliated with), with the clinicians the contract lists, the group's own clinician count and the share; or search one group or system by name across every contract.\n\nUse cases: 'What share of Virginia Mason's doctors does Regence list?'; 'Which MA contracts list most of Optum's physicians in Texas?'; 'Which large groups does H5938 cover?'.\n\nGroups are CMS's Medicare reassignment (the group a clinician bills through); systems are CMS's hospital affiliation through the hospital system map. A clinician in several groups counts in each. A share is of the group's Medicare-enrolled clinicians, as listed in the plan's published directory. The publish is pinned by dataset_id.\n\nSOURCE: medicare_silver.ma_network_contract_group_v1 (the Data Tracker's directory table x CMS PECOS reassignment x CMS Doctors and Clinicians facility affiliation x the hospital system map).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.ma_network_contract_group_v1","medicare_silver.fact_ma_landscape"],"underlying_silver_tables_for_pinning":["medicare_silver.ma_network_contract_group_v1","medicare_silver.fact_ma_landscape"],"semantic_views_used":[],"known_gaps":["Groups come from Medicare reassignment: a group's clinicians who do not bill Medicare are not counted.","Contract level: a contract with several networks (HMO and PPO plans) is read as one.","Coverage follows the directory build (stage 25); an uncovered contract answers no_coverage."]},{"name":"get_network_system_change","version":"0.2.0","description":"Which health systems (or specialties) Medicare Advantage networks gained and lost between 2026 and 2027, from the plans' own published directories: for a contract, every health system with the clinicians listed in each year, how many stayed, left and joined, and an exit or join signal where a system's listing collapsed while the rest of the network held; or search one health system by name across every contract.\n\nUse cases: 'Did Humana drop Ohio State for 2027?'; 'Which systems left H5216's network?'; 'Which contracts lost cardiologists for 2027?'.\n\nLike for like: only each contract's own-year lists (no stand-ins), only ZIP3 areas it lists in both years, members only. A signal is a DIRECTORY SIGNAL to verify with the system or plan, never proof a contract ended; a contract whose source changed between years carries no signal. The publish is pinned by dataset_id.\n\nSOURCE: medicare_silver.ma_network_change_v1 (the Data Tracker's directory table x CMS Doctors and Clinicians facility affiliation x the hospital system map).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.ma_network_change_v1","medicare_silver.fact_ma_landscape"],"underlying_silver_tables_for_pinning":["medicare_silver.ma_network_change_v1","medicare_silver.fact_ma_landscape"],"semantic_views_used":[],"known_gaps":["Only contracts with an own-year list in both 2026 and 2027 are compared; the 40 contracts whose 2027 list is their 2026 directory standing in have no change rows.","A clinician affiliated with several systems counts in each; system membership is CMS's hospital affiliation (2026-05-29) through the hospital system map.","A publisher that moved from a thin API snapshot to a full one reads as a high joined rate; joined rates above 20% are flagged unverified."]},{"name":"get_pbp_benefit","version":"0.5.0","description":"Returns Plan Benefit Package (PBP) benefit detail for an MA plan for a specific category (dental, inpatient_hospital, ER, etc.).\n\nPolymorphic — pass `category` to route to the right semantic view. All categories share the standard envelope: cost_share_string, copay_amount, coinsurance_pct, limit_text, auth_required, referral_required, network_type, max_oop_applies + category-specific extension fields (e.g., dental_sub_benefit).\n\nRequired: contract_id, plan_id, payment_year, category. The category must be one of the 35 live categories (listed below).\n\nThe response `value` is the full benefit-detail object: `rows` (every matched benefit row, with cost sharing, limits, and category extension fields), `row_count`, the resolved `category`/`human_label`/`view_fqn`, the `audit_chain` (CMS source URL + sha256 per row), and a `summary` sub-field carrying the single-row headline cost_share_string (or the row count when multiple sub-benefit rows match) for a quick read. Plus any methodology-shift caveats (e.g., 'B16 dental restructured CY2025' when querying dental for 2025+). Cross-year queries get cross-shift caveats.\n\nWhen the full answer would not fit in one response, `rows` come back compact (`row_format: \"compact\"`): fields identical on every row sit once in `row_common`, and a field absent from a row is null.\n\nLive categories are discovered from the contract registry at load time, so this list cannot drift from what the tool serves; an unknown category is refused (INVALID_INPUT) with this same list, never a failure. The 35 live categories are: ambulance, b19_combined_package, cardiac_pulmonary_rehab, clinical_diagnostic_therapeutic, combined_supplemental, dental, dme, dsnp_cost_share, emergency_urgent, health_professionals, hearing, home_health, inpatient_hospital, inpatient_psychiatric, meals, moop, optional_package, otc, outpatient_hospital, partb_rx_drugs, partd_drugs, partd_tier, partial_hospitalization, plan_deductible, plan_premium, preventive, prior_auth_referral, renal_dialysis, section_c_pos_oon, snf, ssbci, supplemental_other, supplemental_services, transportation, vision. The premium is `plan_premium` (not 'premium'), the deductible is `plan_deductible`, the out-of-pocket maximum is `moop`.\n\n`summary.value` is the one number a reader asks for: for plan_premium the monthly premium in USD; for plan_deductible the in-network annual deductible in USD (or null with the filed reason); for moop the in-network annual MOOP in USD, which on a D-SNP is the plan design before Medicaid and Extra Help, never what a dual pays. `summary.label` says which. Limits read in words (\"6 visits every year\"; 999 is CMS's unlimited sentinel and reads \"unlimited\"); the filed code is kept in `limit_text_raw`.\n\nA contract/plan/year/category combination with NO rows is REFUSED with code NO_DATA, not answered with an empty complete: the refusal states what was searched and routes to get_landscape (the plan ids that really exist for that contract and year) and names the valid categories. One view is read, so a nonexistent plan and a plan with nothing in this category cannot be told apart here; the refusal says so.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.fact_ma_landscape","medicare_silver.pbp_mrx","medicare_silver.pbp_mrx_p","medicare_silver.pbp_mrx_tier","medicare_silver.pbp_section_a","medicare_silver.pbp_section_b10_amb_trans","medicare_silver.pbp_section_b11_dme_prosth_orth_sup","medicare_silver.pbp_section_b12_renal_dialysis","medicare_silver.pbp_section_b13_other_services","medicare_silver.pbp_section_b14_preventive","medicare_silver.pbp_section_b15_partb_rx_drugs","medicare_silver.pbp_section_b16_dental","medicare_silver.pbp_section_b17_eye_exams_wear","medicare_silver.pbp_section_b18_hearing_exams_aids","medicare_silver.pbp_section_b1a_inpat_hosp","medicare_silver.pbp_section_b1b_inpat_hosp_psych","medicare_silver.pbp_section_b20","medicare_silver.pbp_section_b2_snf","medicare_silver.pbp_section_b3_cardiac_rehab","medicare_silver.pbp_section_b4_emerg_urgent","medicare_silver.pbp_section_b5_partial_hosp","medicare_silver.pbp_section_b6_home_health","medicare_silver.pbp_section_b7_health_prof","medicare_silver.pbp_section_b8_clin_diag_ther","medicare_silver.pbp_section_b9_outpat_hosp","medicare_silver.pbp_section_c","medicare_silver.pbp_section_c_oon","medicare_silver.pbp_section_c_pos","medicare_silver.pbp_section_d","medicare_silver.pbp_section_d_opt","medicare_semantic.vw_pbp_ambulance","medicare_semantic.vw_pbp_b19_combined_package","medicare_semantic.vw_pbp_cardiac_pulmonary_rehab","medicare_semantic.vw_pbp_clinical_diagnostic_therapeutic","medicare_semantic.vw_pbp_combined_supplemental","medicare_semantic.vw_pbp_dental","medicare_semantic.vw_pbp_dme","medicare_semantic.vw_pbp_dsnp_cost_share","medicare_semantic.vw_pbp_emergency_urgent","medicare_semantic.vw_pbp_health_professionals","medicare_semantic.vw_pbp_hearing","medicare_semantic.vw_pbp_home_health","medicare_semantic.vw_pbp_inpatient_hospital","medicare_semantic.vw_pbp_inpatient_psychiatric","medicare_semantic.vw_pbp_meals","medicare_semantic.vw_pbp_moop","medicare_semantic.vw_pbp_optional_package","medicare_semantic.vw_pbp_otc","medicare_semantic.vw_pbp_outpatient_hospital","medicare_semantic.vw_pbp_partb_rx_drugs","medicare_semantic.vw_pbp_partd_drugs","medicare_semantic.vw_pbp_partd_tier","medicare_semantic.vw_pbp_partial_hospitalization","medicare_semantic.vw_pbp_plan_deductible","medicare_semantic.vw_pbp_plan_premium","medicare_semantic.vw_pbp_preventive","medicare_semantic.vw_pbp_renal_dialysis","medicare_semantic.vw_pbp_section_c_pos_oon","medicare_semantic.vw_pbp_snf","medicare_semantic.vw_pbp_supplemental_other","medicare_semantic.vw_pbp_supplemental_services","medicare_semantic.vw_pbp_transportation","medicare_semantic.vw_pbp_vision"],"underlying_silver_tables_for_pinning":["medicare_silver.fact_ma_landscape","medicare_silver.pbp_mrx","medicare_silver.pbp_mrx_p","medicare_silver.pbp_mrx_ssm","medicare_silver.pbp_mrx_tier","medicare_silver.pbp_section_a","medicare_silver.pbp_section_b10_amb_trans","medicare_silver.pbp_section_b10_b19b_amb_trans_vbid_uf","medicare_silver.pbp_section_b11_dme_prosth_orth_sup","medicare_silver.pbp_section_b12_renal_dialysis","medicare_silver.pbp_section_b13_b19b_other_services_vbid_uf","medicare_silver.pbp_section_b13_other_services","medicare_silver.pbp_section_b13i_b19b_other_services_vbid_ssbci","medicare_silver.pbp_section_b13i_b19b_services_vbid_ssbci","medicare_silver.pbp_section_b14_preventive","medicare_silver.pbp_section_b14b_b19b_preventive_vbid_uf","medicare_silver.pbp_section_b14c_b19b_preventive_vbid_uf","medicare_silver.pbp_section_b15_partb_rx_drugs","medicare_silver.pbp_section_b16_b19b_dental_vbid_uf","medicare_silver.pbp_section_b16_dental","medicare_silver.pbp_section_b17_b19b_eye_exams_wear_vbid_uf","medicare_silver.pbp_section_b17_eye_exams_wear","medicare_silver.pbp_section_b18_b19b_hearing_exams_aids_vbid_uf","medicare_silver.pbp_section_b18_hearing_exams_aids","medicare_silver.pbp_section_b19a_model_test_vbid_uf","medicare_silver.pbp_section_b19b_model_test_vbid_uf","medicare_silver.pbp_section_b1a_b19a_inpat_hosp_vbid_uf","medicare_silver.pbp_section_b1a_b19b_inpat_hosp_vbid_uf","medicare_silver.pbp_section_b1a_inpat_hosp","medicare_silver.pbp_section_b1b_b19a_inpat_hosp_vbid_uf","medicare_silver.pbp_section_b1b_b19b_inpat_hosp_vbid_uf","medicare_silver.pbp_section_b1b_inpat_hosp_psych","medicare_silver.pbp_section_b20","medicare_silver.pbp_section_b2_b19a_snf_vbid_uf","medicare_silver.pbp_section_b2_b19b_snf_vbid_uf","medicare_silver.pbp_section_b2_snf","medicare_silver.pbp_section_b3_b19b_cardiac_rehab_vbid_uf","medicare_silver.pbp_section_b3_cardiac_rehab","medicare_silver.pbp_section_b4_b19b_emerg_urgent_vbid_uf","medicare_silver.pbp_section_b4_emerg_urgent","medicare_silver.pbp_section_b5_partial_hosp","medicare_silver.pbp_section_b6_home_health","medicare_silver.pbp_section_b7_health_prof","medicare_silver.pbp_section_b8_clin_diag_ther","medicare_silver.pbp_section_b9_outpat_hosp","medicare_silver.pbp_section_c","medicare_silver.pbp_section_c_oon","medicare_silver.pbp_section_c_pos","medicare_silver.pbp_section_d","medicare_silver.pbp_section_d_opt","medicare_silver.pbp_step_16","medicare_silver.pbp_step_17b","medicare_silver.pbp_step_18b"],"semantic_views_used":["medicare_semantic.vw_pbp_ambulance","medicare_semantic.vw_pbp_b19_combined_package","medicare_semantic.vw_pbp_cardiac_pulmonary_rehab","medicare_semantic.vw_pbp_clinical_diagnostic_therapeutic","medicare_semantic.vw_pbp_combined_supplemental","medicare_semantic.vw_pbp_dental","medicare_semantic.vw_pbp_dme","medicare_semantic.vw_pbp_dsnp_cost_share","medicare_semantic.vw_pbp_emergency_urgent","medicare_semantic.vw_pbp_health_professionals","medicare_semantic.vw_pbp_hearing","medicare_semantic.vw_pbp_home_health","medicare_semantic.vw_pbp_inpatient_hospital","medicare_semantic.vw_pbp_inpatient_psychiatric","medicare_semantic.vw_pbp_meals","medicare_semantic.vw_pbp_moop","medicare_semantic.vw_pbp_optional_package","medicare_semantic.vw_pbp_otc","medicare_semantic.vw_pbp_outpatient_hospital","medicare_semantic.vw_pbp_partb_rx_drugs","medicare_semantic.vw_pbp_partd_drugs","medicare_semantic.vw_pbp_partd_tier","medicare_semantic.vw_pbp_partial_hospitalization","medicare_semantic.vw_pbp_plan_deductible","medicare_semantic.vw_pbp_plan_premium","medicare_semantic.vw_pbp_preventive","medicare_semantic.vw_pbp_prior_auth_referral","medicare_semantic.vw_pbp_renal_dialysis","medicare_semantic.vw_pbp_section_c_pos_oon","medicare_semantic.vw_pbp_snf","medicare_semantic.vw_pbp_ssbci","medicare_semantic.vw_pbp_supplemental_other","medicare_semantic.vw_pbp_supplemental_services","medicare_semantic.vw_pbp_transportation","medicare_semantic.vw_pbp_vision"],"known_gaps":["PBP-PK-PRE-2010","PBP-QUARTERLY-PRE-2018"]},{"name":"get_plan_hospitals","version":"0.2.0","description":"The hospitals in a Medicare Advantage plan's published provider network for 2026 or 2027, by contract or CMS plan id: each hospital (CMS certification number, name, state, health system) with the evidence that it is in network: the hospital's own NPI listed in the directory, or how many of the clinicians CMS records as affiliated with it the plan lists (and the share). Narrow by hospital state or health system; choose the weakest evidence to return.\n\nUse cases: 'Which hospitals are in H5938's 2027 network?'; 'Is the Cleveland Clinic in this plan?'; 'Which HCA hospitals does H1036 list in Florida?'.\n\nA hospital's own NPI in the directory is strong evidence; many affiliated clinicians listed is good evidence; a few affiliated clinicians is weak and labelled so. A hospital absent from the list is 'no evidence in the published directory', never 'out of network'. The publish is pinned by dataset_id.\n\nSOURCE: medicare_silver.ma_network_plan_hospital_v1 (the Data Tracker's directory table x CMS hospital enrollment NPI = CCN x CMS Doctors and Clinicians facility affiliation x the hospital system map).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.ma_network_plan_hospital_v1"],"underlying_silver_tables_for_pinning":["medicare_silver.ma_network_plan_hospital_v1"],"semantic_views_used":[],"known_gaps":["Many directories list clinicians and not facilities: a hospital reached only through affiliated clinicians is inferred from CMS's affiliation file (2026-05-29), not printed by the plan.","Affiliation covers hospitals where CMS records clinicians (4,606); a hospital with no affiliated clinicians can appear only by its own NPI.","Coverage follows the directory build (stage 25); an uncovered contract answers no_coverage."]},{"name":"get_plan_network","version":"0.2.0","description":"The provider network a Medicare Advantage plan publishes: the NPIs its directory lists for a plan year (2026 or 2027), by contract or CMS plan id, with the source of every listing (the payer's own Plan-Net API, the printed directory, a name match to NPPES with its grade, or the Medicare Plan Finder export), the counts by source and grade, and a page of listings with name, specialty, location and the file and page each came from. Filter by state, ZIP or specialty.\n\nUse cases: 'How many providers does H5959 list for 2027?'; 'Which cardiologists are in H5938's network in Tallahassee?'; 'Is this plan's directory API-served or printed?'.\n\nMembership is DISTINCT NPIs, never row counts. Name-matched rows are flagged by grade and never presented as printed; listings whose name resolves to no single NPI are kept without an NPI and are not members. A contract with no rows is UNCOVERED (the open-gap list), never 'no network'. 2027 rows carried back from a 2026 directory are labelled (plan_key_basis). The publish is pinned by dataset_id.\n\nSOURCE: medicare_bronze.ma_directory_plan_npi_site_v1 (the Data Tracker's directory build; every row names its url, page and raw_sha256).","layer":"L2","domain":"medicare","data_sources":["medicare_bronze.ma_directory_plan_npi_site_v1","medicare_silver.fact_ma_landscape","medicare_silver.ma_network_active_v1"],"underlying_silver_tables_for_pinning":["medicare_bronze.ma_directory_plan_npi_site_v1","medicare_silver.fact_ma_landscape","medicare_silver.ma_network_active_v1"],"semantic_views_used":[],"known_gaps":["Coverage: 99.1% of 2026 MA members and 96.1% of 2027 members from 2027 sources (stage 21, 2026-11-02); the open-gap contracts (HCSC, Geisinger 2027, Highmark Wholecare, Elderplan, Mercy Care, Elevate, CarePartners CT, six thin Elevance contracts) are UNCOVERED and answer NO_COVERAGE.","Listings whose printed name does not resolve to a single NPI (about 11.3M rows, grade C or D, mostly Humana PDFs) are kept without an NPI and are not counted as members.","Matched grade N rows can lack city, state and ZIP; page is a string.","42 contracts' (1,132,045 members') 2027 rows are their 2026 directory applied through the CMS crosswalk (plan_key_basis *_2026_plan_via_crosswalk): labelled, not a 2027 directory."]},{"name":"get_plan_value","version":"1.6.2","description":"Vlada Plan Value: MODELED value to the member of a Medicare Advantage plan, per member per month, for 2026 and 2027 (never a filed benefit, a bid or a paid claim). The headline is medical cost-sharing value at the expected position in each filed range + extras (the flex card valued by what the money buys) + Part D + the Part B buydown - the member premium, one figure per leg. D-SNP has two columns: the headline is the full-dual column (extras + Part D against the Extra Help comparator, medical $0) and the filed design rides beside it.\n\nTHREE MODES, chosen by the arguments.\nPLAN: contract_id (e.g. 'H0609') + plan_id (e.g. '025') [+ segment_id] -> each plan segment's value 2026 and 2027, the five legs, the range ends, the card bounds, the value without Part D, the filed design, and for a D-SNP the full-dual column, Part D against Extra Help and Medicaid's cost-sharing protection (published beside, never in a total), plus part_d_2027_basis. A contract alone lists its plan segments (largest first).\nMARKET: product_type (required; non-SNP HMO | non-SNP PPO | D-SNP HMO | D-SNP PPO | C-SNP HMO | C-SNP PPO | I-SNP HMO | I-SNP PPO; 'ALL' is refused) + geography (national | state | county; inferred from the place) + state / county (name as CMS spells it, with state) / county_ssa, optional parent (partial name matches) and plan_type (default 'ALL'), group_by (parent by default | none | state | county | plan_type | product_type) -> value.summary is the market: its levels (2026 = every September 2026 member, 2027 = those members followed to their 2027 plan) and its same-member change (members valued in both years: 2026, 2027, change), every leg; value.rows are the parents (or groups), largest first.\nRANK: rank=true with product_type and a geography -> who cut and who added most, on two bases side by side: 'same members' (member-weighted, the members followed) and 'plans on the shelf' (the simple average of the plans offered), each with its rank.\n\nHISTORY: history=true adds the earlier years of the same signed build. With a plan: each segment's value, legs, card bounds, value without Part D, filed design, outlier flag and September members for every plan year 2023-2027 (a plan that has since ended is found too). With a market (geography national or state, plan_type 'ALL', group_by parent | none | state | product_type): the levels for 2023-2026, each year on that year's own September members. Every year is in 2026 dollars: its filed design priced the way 2026 is, its dollar terms restated to 2026 by CMS's Medicare Advantage growth index; 2020 to 2022 are held back until their checks pass. History carries no same-member change, no county and no filed-range ends: year-to-year differences in the levels are two populations, not a change.\n\nlimit bounds the rows (default 25, max 500).\n\nREAD IT RIGHT: compare only inside one product type; a null is not valued, never $0; levels are not changes (the change is the same-member block); the 2027 Part D leg is final, priced on CMS's CY2027 formulary (a plan whose Part D could not be priced is labelled refused, never $0), and the value without Part D is the like-for-like reading of the other legs; the plan's ER cost is an upper bound (the ER copay charged on every visit, waiver on admission not applied; CMS convention); the card is the largest open sensitivity (quote the card bounds); 2027 is priced on the 2026 cohort, statute and dollars, a design comparison and not a forecast.\n\nSOURCE: Vlada Plan Value (build v12 = Method 1.2: the base-premium credit (D8), CMS's full copay (D4 cap off), card rule v3, stratum credibility, the SNF 3-day waiver, brochure-mid theta; D1 SSBCI eligibility 0.80 and D2 uncounted inpatient days off, served as sensitivities; the ER copay on every visit; signed 2026-11-02) from the CMS Plan Benefit Package filings, CMS county enrollment, the CMS plan crosswalk and the CMS Part D formulary files.","layer":"L2","domain":"medicare","data_sources":["medicare_semantic.vw_plan_value_plans","medicare_semantic.vw_plan_value_cells","medicare_semantic.vw_plan_value_pairs"],"underlying_silver_tables_for_pinning":[],"semantic_views_used":["medicare_semantic.vw_plan_value_plans","medicare_semantic.vw_plan_value_cells","medicare_semantic.vw_plan_value_pairs","medicare_semantic.vw_plan_value_history_plans","medicare_semantic.vw_plan_value_history_cells"],"known_gaps":["Every value is modeled value to the member, never a filed benefit, bid or paid claim.","The 2027 Part D leg is final: priced on CMS's CY2027 formulary (the October 2026 release); refused plans are labelled.","Medical: the plan's ER cost is an upper bound (the ER copay charged on every visit, waiver on admission not applied; CMS convention).","D-SNP headline is the full-dual column; the filed design rides beside it; Medicaid protection is never in a total.","Levels and the same-member change are different populations; the change is read from the pairs.","rank=true needs medicare_semantic.plan_value_shelf_v12; until it is published the rank mode refuses with recover_with rank=false.","history=true: 2023 onward, each year's filed design in 2026 dollars on 2026 law and prices; levels by year are each year's own members, not a same-member change; no county, plan type or filed-range ends before 2026."]},{"name":"get_quality_bonus","version":"1.0.0","description":"MA quality bonus dollars by contract or parent and payment year. For each: the star tier CMS pays on (bonus % of the benchmark and the rebate share), members, risk score, rebate, the benchmark bonus, and what the star tier is worth in revenue per member per month and per year, three ways: benefits held (rebate fixed), observed (what carriers did when a contract crossed a tier, 2015-2024), and the 4.0 cliff (4.0 over 3.5).\n\nARGUMENTS: contract_id (e.g. H5216) or parent (part of the parent organization's name, e.g. 'Humana'), group_by (contract | parent; default contract when contract_id is given, else parent), payment_year (default: every year for one contract, otherwise the newest year), limit (default 50, most members first).\n\nRETURNS value.rows: a contract row per payment year (tier, tier source and check against the tier CMS's payment file implies, members, PMPM and annual dollars), or a parent row per payment year (members, member-weighted star, bonus %, PMPM figures, annual dollars summed, contracts). value.summary carries the scope and which years are measured and which are modeled.\n\nRULES THE TOOL ENFORCES: rating year Y sets the bonus paid in payment year Y+1 (PY2028 uses the RY2027 stars) and every row names both; PY2025-2028 are modeled (period 'forward') and labeled; new contracts of an existing parent take the parent's member-weighted star, not 3.5; all of MA is priced (individual, employer group and regional PPO) and the share not priced is shown; a parent row weights PMPM by members priced and sums dollars.\n\nSOURCE: CMS MA ratebooks, plan payment files (average payment, risk score, rebate), Rate Announcements, Star Ratings and monthly enrollment, through Vlada's QBP financial chain (audited twice; method: STARS-QBP-FINANCIAL-CHAIN).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.stars_ratings_summary","medicare_silver.ma_plan_payment_part_c_v2"],"underlying_silver_tables_for_pinning":["medicare_silver.stars_ratings_summary","medicare_silver.ma_plan_payment_part_c_v2"],"semantic_views_used":["medicare_semantic.stars_qbp_financial_v4"],"known_gaps":["The paid bonus for very small and new-parent contracts follows CMS's stated policy and is not verifiable from public data (under 1.5% of members)."]},{"name":"get_service_line_prices","version":"1.0.0","description":"A market's or a hospital's negotiated prices across a whole SERVICE LINE in ONE call: GI endoscopy, MRI, CT, cardiology, orthopedics, maternity, lab, and the rest of CMS's 70 shoppable services grouped the way buyers shop. For each code: how many hospitals price it, the market median (median of hospital medians), the 25th to 75th percentile, the low and high, and the multiple of Medicare. For each hospital: its price per code and a service-line index (its typical multiple of Medicare across the line), ranked low to high.\n\nARGS: service_line (call with service_line='list' to see every line and its codes) or codes (up to 30 CPT/HCPCS or MS-DRG). state (2 letters, required: prices are stored by state). Optional: hospitals (up to 25 CCNs) or cbsa (CMS's wage-index CBSA or metro division: Miami 33124, Houston 26420) to narrow the market; line_of_business (commercial default, medicare_advantage, medicaid, exchange, unspecified); billing_class (institutional default = the facility price; professional = the physician fee); limit (hospitals listed, default 25, max 100).\n\nRULES the tool applies: posted negotiated DOLLAR rates the comparability screen calls real (never a percent of charges); one median per method (case rate, fee schedule, per diem never mixed); line of business never pooled; a DRG is a whole inpatient stay, a CPT code one procedure. These are prices hospitals post, not paid claims. For one code in depth (per payer, methodology detail) use compare_hospital_rates.","layer":"L2","domain":"hospital","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":["Prices are what hospitals post in their price-transparency files, not paid claims.","Hospitals that post a code only as a percent of charges or with an unclear method are left out of that code.","The service-line index compares hospitals on the codes each prices; coverage says how many of the line's codes that is."]},{"name":"get_star_benchmark","version":"1.0.0","description":"How a Medicare Advantage contract performs on the Star measures against the market, its peers, its competitors and CMS's cut points, over time. Two views in one answer. FAMILIES: for each measure family (all measures, HEDIS, HOS, CAHPS, pharmacy, complaints and leaving, appeals, call center, plan reporting) and each rating year, the contract's actual performance % (CMS-weighted mean of its measure scores; lower-is-better rates counted as their complement, so 10% readmitted = 90%; complaints per 1,000 and improvement scores are counted, not averaged), the 4-star line over exactly the measures it was scored on, and its weighted star; beside the market (member-weighted and one contract one vote), a cohort (default: its dominant product in its dominant state, e.g. D-SNPs in NY), its peer class (national carrier, Blue Cross Blue Shield plan, Kaiser, provider-sponsored, regional plan, MA-focused entrant) and the average of its five nearest competitors. MEASURES: for the latest rating year, every measure's score, star, CMS message where there is no score, the 2-5 star cut points, the market mean (members and contracts), median and middle half, the cohort mean, the gap to the market (positive = better, direction-aware), the percentile among MA contracts, and each competitor's score.\n\nARGUMENTS: contract_id (required, H or R contract, e.g. H5549), rating_year (default the newest held), years (1-13, default 5), cohort (one of product_state, product, peer_class, parent, peer_class_product, cai_group, size_band, star_band, state, org_type; default product_state), family (optional: restrict the measures view to one family, e.g. hedis), limit (measure rows, default 60).\n\nRETURNS value.summary (contract, rating year, parent, peer class, product, state, members, the cohort used, the five competitors with their parents and shared-county members), value.families (one row per family per year) and value.measures (one row per measure, latest year).\n\nRULES THE TOOL ENFORCES: every number is read from the stored benchmark tables, never averaged at call time; a score belongs to the whole contract, so a contract sits in the one product and state holding most of its members; text cells (plan too small, not enough data) are counted and never imputed; CAHPS cut points are approximate because CMS also tests significance; stand-alone drug plans are a separate market and are not included.\n\nSOURCE: CMS Part C and D Star Ratings data tables and CMS monthly enrollment, through Vlada's measure benchmark engine (stars_measure_benchmark@1.0.0).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.stars_ratings_measure","medicare_silver.stars_ratings_summary"],"underlying_silver_tables_for_pinning":["medicare_silver.stars_ratings_measure","medicare_silver.stars_ratings_summary"],"semantic_views_used":["medicare_semantic.stars_measure_benchmark_v2","medicare_semantic.stars_measure_benchmark_contract_v2","medicare_semantic.stars_measure_benchmark_category_v2","medicare_semantic.stars_measure_benchmark_category_contract_v2","medicare_semantic.stars_measure_benchmark_competitor_v2"],"known_gaps":[]},{"name":"get_star_decomposition","version":"1.5.2","description":"How a contract's star is built, and what moves it to the next line. For one Medicare Advantage contract and rating year: for the Overall, Part C and Part D summaries, the raw score (the weighted mean of the measure stars), the categorical adjustment (CAI), the reward factor, the score before rounding, the published star and the recomputed one, the cushion above the line the star was earned at and the gap to the next half-star line (and to 3.75, which rounds to 4.0). Then every measure: score, star, weight, direction, the next star's cut point and the distance to it in the measure's own units, and what one more star on it adds to each summary's raw score; plus the shortest list of one-star gains that closes the gap to the next line.\n\nARGUMENTS: contract_id (required, e.g. H5216), rating_year (default the newest held for the contract), limit (measure rows, default 60).\n\nRETURNS value.summary (contract, rating_year, pays_in, parts: one block per summary with its decomposition, gaps and path) and value.measures (one row per measure).\n\nRULES THE TOOL ENFORCES: the arithmetic is CMS's (the raw score over the measure set CMS used, picked so the weights add up to the recompute engine's total; the Overall leaves out the two Part D measures that duplicate Part C); one more star adds weight / total weight to the raw score; the path holds the CAI and the reward factor constant and says so; distances are in the measure's own units and direction (for a lower-is-better measure the score must fall); survey (CAHPS) cut points are approximate, because CMS also tests significance and reliability; improvement measures have no cut point. The recomputed star is the engine's, the published star is CMS's; where they differ the row says why.\n\nFLOOR BANDS: where CMS printed NA for a measure's lowest star bands (some measures in RY2015 and RY2018-2021), every score earns at least that star; the measure's floor_cut says so and it cannot be lost.\n\nSOURCE: CMS Part C and D Star Ratings Data Tables and Technical Notes, through Vlada's recompute engine, which reproduces 99.03% of the summary stars CMS published (RY2015-2027) exactly: 18,499 of 18,680.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.stars_ratings_measure","medicare_silver.dim_stars_measures","medicare_silver.stars_ratings_summary","medicare_silver.stars_cai","medicare_semantic.dim_stars_measure_identity_v7"],"underlying_silver_tables_for_pinning":["medicare_silver.stars_ratings_measure","medicare_silver.dim_stars_measures","medicare_silver.stars_ratings_summary","medicare_silver.stars_cai"],"semantic_views_used":["medicare_semantic.stars_summary_recomputed_v10","medicare_semantic.dim_stars_measure_identity_v7"],"known_gaps":[]},{"name":"get_star_risk","version":"4.0.0","description":"Star Risk: odds a star falls, holds or rises next year. For one Medicare Advantage contract and origin rating year, for the Overall, Part C and Part D summaries, scored on the forecast year's own rules (the final rule's measure set and weights, named in the answer): Down / Same / Up for next year's star, the chance it falls below this year's star (chance to drop), the chance it lands below 4.0 (the quality bonus line; for a contract at 4.0 the same event and the same number as dropping, for one at 3.5 one minus the chance of rising) and the chance it rises (Upside), each with a status saying what it is worth. The Overall headline is Release 2r: a blend of Vlada's simulation (70%, Engine 4g) and a statistical model of the outcome with benefit and growth changes (30%), both calibrated on every year before the forecast year; the simulation's own odds ride beside it, labeled. Also: the expected star and its distribution (simulated), Star Distance (typical years of movement between the score before rounding and the line it earned), the raw score and the reward factor apart (and the chance the reward factor drops), three layers of distance (each measure to its own line, a cut point or for survey measures a modeled effective line; the score before rounding to its half-star lines; the raw mean and spread to the reward factor's thresholds), the Effective Star Cushion and Reach (descriptive), the cheapest sets of measure gains that reach the next half star (up paths), the per-contract Focus list (context) and the protect list (measures with the fewest score points above the line that keeps their star). With parent instead: the parent organization's book, the measures where contracts that improved moved up a star more often (expected members gaining a star, contracts helped; the top 3 are the held-out tested list), its protect list, and each of its contracts' Down / Same / Up.\n\nARGUMENTS: contract_id (e.g. H5216; H or R contracts, employer direct E contracts are not scored) or parent (a parent organization name such as Humana, or a contract id to use its parent); exactly one. part (Overall, C or D; default all three; contract only), rating_year (the origin rating year; default the newest scored), limit (rows, default 60).\n\nRETURNS for a contract value.summary (contract, rating_year, forecast_year, engine version and runs, the headline model, the rule set, parts: one block per summary, each probability with a _status, down_same_up, and the simulation's own odds under simulation) and value.measures (one row per measure: star, weight this year and next, removed next year, weight share, distances down and up in score points and in typical years, the line they are measured to, lift per typical year); for a parent value.summary (parent, book, focus, protect) and value.contracts (each contract's stars and odds).\n\nWHAT EACH NUMBER IS WORTH, as the answer says: on 2024-2027 (years read while the engine was built; RY2028 is the clean test), Release 2r's chance to drop ranks contracts well (AUC 0.771) and is sharper than history (Brier skill +0.079, 90% interval +0.058 to +0.101, against +0.032 for the previous model); its odds are close to calibrated (slope 1.08) but run about 3 points high on average (35.6% predicted, 32.8% actual); by origin star it predicted 14% Down for 3.0 contracts against 10% actual, 44% for 4.0 against 41%, 55% for 4.5 against 49% and 57% for 5.0 against 65%; a chance above 90% is shown as over 90% (only 5 such cases in history); a year-wide shock can move every contract together; below 4.0 is tested for contracts within half a star of the line (skill +0.100) and is context further from it; Upside is tested (from 3.5 it is the chance of reaching 4.0); Down / Same / Up is tested as one forecast; the simulation's own odds are shown only for comparison; Part C and Part D are simulated shares, uncalibrated and untested; the expected star is simulated and runs low; the parent focus list is an association tested on held-out years (top 3 only), never a promise of a star; the per-contract focus list did not pass its test and is context only; the protect list is a ranking rule, not a tested prediction, and never lists a measure CMS removes next year; slip paths are not served; the Effective Star Cushion and Reach are descriptive, never predictive; where the path engine does not reproduce CMS's published star its paths are flagged untrusted. Every number is a model forecast, not an observed rating.\n\nSOURCE: CMS Part C and D Star Ratings Data Tables, Technical Notes, cut points and the forecast year's final rule, through Vlada's Star Risk engine (simulation on CMS's exact summary arithmetic, calibrated on every earlier year, blended with a statistical model fitted on every earlier year, judged on 2024-2027 and graded on RY2028 in October 2027).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.stars_ratings_measure","medicare_silver.stars_ratings_summary","medicare_silver.stars_cai"],"underlying_silver_tables_for_pinning":["medicare_silver.stars_ratings_measure","medicare_silver.stars_ratings_summary","medicare_silver.stars_cai"],"semantic_views_used":["medicare_semantic.stars_risk_score_v6","medicare_semantic.stars_risk_focus_v6","medicare_semantic.stars_risk_parent_focus_v6"],"known_gaps":[]},{"name":"get_stars","version":"0.8.1","description":"Returns a Medicare Advantage contract's CMS Star Ratings: the Overall, Part C, and Part D summary stars for a rating year, each with the year-over-year change vs the prior year. Set include_measures=true to also get the full per-measure breakdown (measure name, identity key, part, domain, weight, direction, the raw value and its star, the 4-star line, and the star's YoY change) so you can see exactly which measures moved the rating. The prior-year star is matched by MEASURE IDENTITY through the Stars measure spine, never by code (CMS renumbered 27 of 33 Part C codes for RY2026); prior_year_measure_id names the code the prior star was filed under. Filter by contract_id (required) + optional year (the rating_year, defaults to the latest) + optional limit (max measure rows returned). Rating years 2012-2027 (RY2027 is CMS's final October 2026 release). The answer is a detail payload: the headline stars sit in value.summary, the part rows in value.summary_parts, the measure rows in value.measures.\n\nStars drive the quality-bonus payment and rebate, so this sits directly upstream of the plan economics (payment and MLR) and is reported at the CONTRACT level (no plan_id).\n\nScores are served at the precision CMS publishes (float32 storage noise is removed on the wire). Each measure row's four_star_ladder names the cut point ladder its four-star line came from: CMS calculates MA-PD and PDP Part D cut points separately, so an MA contract (H, R) reads the MA-PD ladder and a stand-alone drug plan contract (S) the PDP ladder; ALL is a ladder CMS published for every organisation (Part C).\n\nRESTATED OVERALL. CMS restated 50 contracts' RY2026 Overall rating on July 22, 2026 (after the Clover Health ruling) without changing any measure star, so for those contracts the measure breakdown reflects the original calculation and can round to a different star than the served Overall. The answer says so in a caveat and names the original value in summary.overall_restated_from (summary.overall_restated_from_text carries CMS's text when the original was a message such as 'Not enough data available').\n\nFLOOR BANDS. Where CMS printed NA for a measure's lowest star bands (some measures in RY2015 and RY2018-2021) the measure row names the lowest band CMS printed in floor_star and floor_note.\n\nSOURCE: CMS Star Ratings (summary + measure-level) and the Vlada measure spine medicare_semantic.dim_stars_measure_identity_v7.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.stars_ratings_summary","medicare_silver.stars_ratings_measure","medicare_silver.dim_stars_measures","medicare_semantic.dim_stars_measure_identity_v7"],"underlying_silver_tables_for_pinning":["medicare_silver.stars_ratings_summary","medicare_silver.stars_ratings_measure","medicare_silver.dim_stars_measures"],"semantic_views_used":["medicare_semantic.dim_stars_measure_identity_v7"],"known_gaps":["Stars are contract-level (no plan_id).","Measure set + weights are methodology-versioned per rating_year; a measure retired or added between years has no YoY counterpart (null change)."]},{"name":"get_stars_cutpoints","version":"0.6.1","description":"Returns CMS-published per-measure star-level cut points (the threshold a contract must reach for stars 2 to 5) for a rating_year, read through the Stars measure spine so a measure keeps its identity across years even when CMS renumbers its code (27 of 33 Part C codes moved for RY2026).\n\nTWO SHAPES. Pass measure_id (that year's code, e.g. C09; a trailing ':' as stored is accepted) or measure_identity_key (the stable key, e.g. 'c:controlling_blood_pressure') for ONE measure: value.measure carries the identity, the star_2 to star_5 thresholds with their ops, the prior and next year's code and the ladder direction; value.cutpoints carries the raw CMS rows; include_history=true adds value.history, the same identity's ladder in every rated year (cut point drift). With neither, value.measures is a paged index of the year's measures (limit, offset; default 50 rows) and the answer names the per-measure call.\n\nLADDER. CMS calculates MA-PD and PDP Part D cut points separately. The header (value.measure and the index rows) reads the ladder for org_subtype: MA-PD by default (the Medicare Advantage question), PDP for a stand-alone drug plan question; cutpoint_org_subtype names the ladder read, and it is ALL only where CMS published one ladder for every organisation (Part C). org_subtype (MA-PD | PDP | ALL) and star_level (1-5) also filter the raw rows.\n\nUse cases: 'what is the 4-star line for Controlling Blood Pressure in RY2027?'; 'how did that line move since RY2024?'; 'how much would contract H1234 need to improve to reach 5 stars on D08?'.\n\nSOURCE: CMS Tech Notes Attachment H (Tukey-aware threshold tables) for RY2024+, Attachment H pre-Tukey for RY2017-RY2023, pre-fixed cut points for RY2015-RY2016. RY2027 is CMS's final release (the 2027 Data Tables, 2026-10-08); the plan-preview rows it replaced stay readable as superseded (is_current = false). Spine: medicare_semantic.dim_stars_measure_identity_v7 (tools/ma_brain/stars_measure_spine_publish.py), whose direction flag agrees with CMS's own cut point ladder in every rated year.\n\nFLOOR BANDS. Where CMS printed NA for the lowest star bands (some measures in RY2015 and RY2018-2021), the band's op is 'floor' and its threshold is null: every score reaches it. floor_star names the lowest band CMS printed (3 stars on every MA floor ladder, e.g. RY2019 Kidney Disease Monitoring: no 1- or 2-star band, 3 stars at 87% or more; RY2020 Complaints about the Health Plan: 3 stars above 1.29).\n\nHOLDINGS ARE NAMED, NEVER IMPLIED. When a rating year holds only ONE Part D ladder the answer says so and which population it is for. A measure with no cut point rows in a year is reported as not held in this edition, with the years held named; CMS publishes cut points every year. Thresholds are served at the precision CMS publishes (float32 storage noise is removed on the wire).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.stars_cutpoints","medicare_silver.dim_stars_measures","medicare_semantic.dim_stars_measure_identity_v7"],"underlying_silver_tables_for_pinning":["medicare_silver.stars_cutpoints","medicare_silver.dim_stars_measures"],"semantic_views_used":["medicare_semantic.dim_stars_measure_identity_v7"],"known_gaps":["stars_methodology_pdf_uncited"]},{"name":"get_stars_rollup","version":"1.2.0","description":"MA Star Ratings by parent, product type or state, year over year. For a rating year against the year before: members in rated and unrated contracts, the member-weighted Overall star, the share of members (and of contracts) at 4 stars or more, and members by Overall star. Optionally the weighted measure star for a measure group, like for like.\n\nARGUMENTS: rating_year (default the newest with Overall stars), compare_year (default rating_year minus 1), group_by (national | parent | product_type | parent_by_product | state | state_by_product), parent (filter: part of the parent organization's name, e.g. 'UnitedHealth'), product_type (filter: nonsnp_hmo | nonsnp_ppo | dsnp_hmo | dsnp_ppo | csnp_hmo | csnp_ppo | isnp | other), state (filter: two-letter code), measure_group (optional: all | part_c | part_d | patient_safety | domain:<CMS domain code, e.g. HD3 or DD4> | source:<CMS data source, e.g. HEDIS, CAHPS, HOS, PDE> | measure:<measure identity key, e.g. c:controlling_blood_pressure>), limit (default 50, largest rated members first).\n\nRETURNS value.rows (one per group), each with members_rated, members_unrated, contracts_rated, contracts_unrated, pct_members_4plus, wtd_avg_star, pct_contracts_4plus, members_by_star, prior (the same fields for compare_year) and change; with measure_group, a measure_group block {measures, contracts, wtd_measure_star, wtd_measure_star_prior, change}. value.summary is the national row for the same filters, with each year's weight month.\n\nRULES THE TOOL ENFORCES: rating year Y is weighted by December of the payment year (Y+1), or the latest month when that December is not published, and says which (the certified house convention); the parent is the enrollment file's parent at the weight month; stand-alone drug plans are out; unrated contracts are counted apart, never as zero stars; product types are the fixed buckets (non-SNP, D-SNP, C-SNP by HMO and PPO; I-SNP; other), never pooled; a star belongs to the contract, so a product type or state row weights the contract's star by its members there; a measure group change compares the same contracts, measures, weights (the rating year's) and members, and leaves out new measures, re-specified measures and the improvement measures. Measure stars are CMS's normalization; raw scores are never averaged across measures.\n\nSOURCE: CMS Part C and D Star Ratings Data Tables and CMS monthly enrollment (contract, plan, SNP and county files).","layer":"L2","domain":"medicare","data_sources":["medicare_silver.stars_ratings_summary","medicare_silver.stars_contracts","medicare_silver.stars_ratings_measure","medicare_silver.dim_stars_measures","medicare_silver.monthly_contract_enrollment_summary","medicare_silver.enrollment_monthly_plan","medicare_silver.enrollment_monthly_county","medicare_semantic.dim_stars_measure_identity_v7","medicare_semantic.vw_snp_data_v3"],"underlying_silver_tables_for_pinning":["medicare_silver.stars_ratings_summary","medicare_silver.stars_contracts","medicare_silver.stars_ratings_measure","medicare_silver.dim_stars_measures","medicare_silver.monthly_contract_enrollment_summary","medicare_silver.enrollment_monthly_plan","medicare_silver.enrollment_monthly_county"],"semantic_views_used":["medicare_semantic.dim_stars_measure_identity_v7","medicare_semantic.vw_snp_data_v3"],"known_gaps":[]},{"name":"get_volatility_index","version":"1.0.0","description":"The County Volatility Index, ranked across counties, states or insurers: per 100 members of individual Medicare Advantage plans the September before a plan year, those whose plan ended, who were moved into another plan by their insurer, or whose plan stayed and made a material cut (premium up $10+ a month, in-network MOOP up $500+, comprehensive dental max down $500+ or dropped). Use it for 'most volatile counties in Texas for 2027', 'which insurers' members faced the most change', 'regular PPOs vs HMOs', 'which counties settled since 2023'. For ONE county's full picture (its index every year, by product type, its rank and the plans behind it) use get_county_view with sections=volatility.\n\nARGS: level (county default, state, parent = CMS parent organization the September before); state (two letters, narrows counties or parents to one state); product (all default, or regular_hmo, regular_ppo, regular_other, dsnp_hmo, dsnp_ppo, csnp_hmo, csnp_ppo, isnp_hmo, isnp_ppo); year (plan year 2016-2027, default 2027); compare_year (default 2023; 'none' to omit); order (most default, or least); min_members (default 250; counties also need 2+ plans to be ranked); limit (default 25, max 200) and offset.\n\nRETURNS value.rows (rank, name, members, plans, index, plan ended / moved / material cut / gains per 100, the compare-year index and the change), value.scope (the same figures for the whole state or nation), value.nation, value.summary (how many entities passed the size rule).\n\nRULES THE TOOL ENFORCES: every year is plans as filed against the prior September's members, what members face, not outcomes; before 2021 only the exit part (plan ended + moved) exists and is never called the index; rates are sums of members, county indexes are never averaged; small counties are counted in totals but never ranked; special-needs plans are their own product types; plans that only followed CMS's MOOP ceiling are their own line, never a cut.\n\nSOURCE: Vlada analysis of the CMS plan crosswalk, Landscape, plan benefit filings and monthly enrollment by plan and county (County Volatility Index v4, Report 2).","layer":"L2","domain":"medicare","data_sources":["medicare_semantic.cvi_plan_county_v4"],"underlying_silver_tables_for_pinning":[],"semantic_views_used":["medicare_semantic.cvi_plan_county_v4"],"known_gaps":["Every year is plans as filed against the prior September's members: what members face, not where they go.","The benefit part is a floor: over-the-counter and Part B giveback cuts are not counted.","Benefits are scored from 2021; earlier years carry plans ending and members moved only."]},{"name":"how_to_join","version":"1.3.0","description":"Return the fail-closed measured way to join two Vlada substrate tables, including an explicit DIRECT_OK, DIRECT_DECLARED_KEY, NEEDS_GRAIN, ROUTE_THROUGH_DIM, ROUTE_MULTIHOP, or DO_NOT_SERVE directive. Direct joins come from (in order) the measured connection registry, the VALIDATED join graph (catalog.json join_edges: uniqueness >= 0.999 and match >= 0.80, measured live), or the semantic layer's declared shared surrogate key (DIRECT_DECLARED_KEY, labelled not-live-measured); a validated or declared direct join is always preferred over a route and never refused. Route coverage (min_coverage) is the weaker side of the weakest hop; a route under 50% is labelled low_coverage_route. Unproved composite, NEEDS_GRAIN, quarantined, impossible, or N:M direct evidence cannot be served. With only table_a, it lists every executable connection from that table.","layer":"L2","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":["Only joins resolvable to physical columns + measurable live are in the registry; big-fact joins are dimension-routed. Absence of a verified join means 'not proven', not 'impossible'."]},{"name":"ira_drug_label_risk_screen","version":"1.0.0","description":"Given an optional drug_name (brand or generic substring), returns IRA-Selected Drugs with their CURRENT FDA structured-label posture (boxed warning / REMS / pregnancy / pediatric flags) and most-recent Drugs@FDA approval activity. When drug_name is omitted, screens ALL drugs in fact_drug_reimbursement.\n\nThe wedge: drugs with active boxed warning + REMS carry FDA-acknowledged safety signals that weaken the manufacturer's MFP-defense argument during CMS negotiation. Hedge funds track this for negotiated-rate directional signal; pharma market access uses it to brief the negotiation team; plaintiff bar uses it to weight cross-substrate exposure.\n\nSubstrate joins: fact_drug_reimbursement (IRA list) × dim_drug_label (shipped 2026-05-16, SPL summary) × dim_drug_application (shipped 2026-05-16, Drugs@FDA approval history).\n\nReference demo (MEASURED 2026-08-01): ELIQUIS -> 22 current label revisions, boxed warning YES, REMS no, pregnancy warning YES, risk_signal_count 2. Across the whole IRA cohort: 25 drugs screened, 14 carry a boxed warning, 0 carry a REMS.\n\nKNOWN GAPS: ira_drug_name_to_label_fuzzy_match (drug_name match is case-insensitive substring on brand_name OR generic_name — no robust ingredient resolver yet). manufacturer_to_sponsor_fuzzy_match (IRA manufacturer field matched against dim_drug_application.sponsor_name via substring — same name can appear in multiple corporate forms).","layer":"L2","domain":"drug","data_sources":["drug_silver.fact_drug_reimbursement#ira_mfp","drug_silver.dim_drug_label","drug_silver.dim_drug_application"],"underlying_silver_tables_for_pinning":["drug_silver.fact_drug_reimbursement","drug_silver.dim_drug_label","drug_silver.dim_drug_application"],"semantic_views_used":[],"known_gaps":["ira_drug_name_to_label_fuzzy_match","manufacturer_to_sponsor_fuzzy_match"]},{"name":"ira_mfp_exposure","version":"1.0.0","description":"Returns the cross-payer federal exposure for an IRA-eligible drug: IRA Maximum Fair Price (when in the IPAY-2026 cohort) + Part D total spend + Part B total spend + Medicaid SDUD total spend, anchored to a specific data year. Reference demos, MEASURED 2026-08-01 against live Athena: STELARA DY2023 = Part D $2,987,778,599.90 + Part B $27,614,584.61 + Medicaid SDUD $3,302,074,349.03 = $6,317,467,533.54 combined, IRA MFP $4,695.00/dose CY2026. ELIQUIS DY2023 = Part D $18,273,451,967.00 + Medicaid SDUD $2,233,903,339.92 = $20,507,355,306.92 combined, IRA MFP $237.25/dose CY2026. (This description previously read 'Stelara ... = $20.5B'. $20.5B is real but it is ELIQUIS; Stelara is $6.32B. The label was on the wrong drug, which is why the tool looked ~3x low against its own demo.)\n\nSOURCE COVERAGE: IRA MFP (fact_drug_reimbursement) covers 10 IPAY-2026 drugs only; queries outside that cohort return ira_mfp_unit_price_usd=null with a coverage_gap caveat (federal-payor spend is still answered). Part D + Part B PUFs publish annually. Medicaid SDUD has per-cell suppression (suppression_used=true rows excluded from totals with a suppression_warning caveat).\n\nALIAS RESOLUTION: M-6 parent_alias + FDA dim_drug fallback applied to drug_name — brand inputs (Stelara) resolve to generic (ustekinumab) and vice-versa. Aliases used are surfaced in the response envelope.\n\nKNOWN PUBLICATION GAPS: see gap_registry entries ira_mfp_partial_cohort_ipay_2026, medicaid_sdud_suppression_used_flag, part_d_puf_annual_grain_only.","layer":"L2","domain":"drug","data_sources":["drug_silver.fact_drug_reimbursement#ira_mfp","drug_silver.fact_drug_spending_part_d","drug_silver.fact_drug_spending_part_b","drug_silver.fact_drug_medicaid_utilization","drug_silver.dim_drug"],"underlying_silver_tables_for_pinning":["drug_silver.fact_drug_reimbursement","drug_silver.fact_drug_spending_part_d","drug_silver.fact_drug_spending_part_b","drug_silver.fact_drug_medicaid_utilization","drug_silver.dim_drug"],"semantic_views_used":[],"known_gaps":["ira_mfp_partial_cohort_ipay_2026","medicaid_sdud_suppression_used_flag","part_d_puf_annual_grain_only"]},{"name":"is_provider_in_plan","version":"0.2.0","description":"Every Medicare Advantage plan whose published directory lists an NPI for a plan year (2026 or 2027): contract, CMS plan id, the source of the listing (the payer's API, the printed directory, a name match with its grade, or the Plan Finder export), the location as listed, and the file and page it came from. Narrow by state or contract.\n\nUse cases: 'Which MA plans list NPI 1275507170 for 2027?'; 'Is Dr X in Humana's Florida network?'.\n\nA listing is evidence the directory names the NPI; an absence is 'not listed in the published directory' for covered contracts only (an uncovered contract says nothing). Name-matched rows are flagged by grade. The publish is pinned by dataset_id.\n\nSOURCE: medicare_bronze.ma_directory_plan_npi_site_v1 (every row names its url, page and raw_sha256).","layer":"L2","domain":"medicare","data_sources":["medicare_bronze.ma_directory_plan_npi_site_v1"],"underlying_silver_tables_for_pinning":["medicare_bronze.ma_directory_plan_npi_site_v1"],"semantic_views_used":[],"known_gaps":["An NPI absent from every directory is 'not listed' only for the covered contracts (99.1% of 2026 members, 96.1% of 2027 from 2027 sources, stage 21); the open-gap contracts say nothing.","A plan listed through a 2026 directory carried back to 2027 (plan_key_basis *_2026_plan_via_crosswalk) is labelled."]},{"name":"lookup_rates_for_npi","version":"1.1.0","description":"COMING SOON on the customer surface (withdrawn 2026-11-09; insurer files are thin): negotiated rates by insurer and plan are served from hospital files by compare_hospital_rates and plan_hospital_price. Look up the negotiated rates a payer pays a specific provider (NPI), resolved at query time through the canonical graph: NPI → provider groups → pg_sets → rates (no precomputed edge table). Returns matching rates with evidence_type (provider_specific vs broad applicability) and Medicare-PUF corroboration (presence ⇒ real; absence ⇒ unverified, NOT ghost). Optional code filter. Covers all built payers. PAGED: `limit` (default 25, max 500) and `offset` bound both `matching_rates` and `provider_groups`; `rate_count` / `provider_group_count` are the full totals and `paging` names what was cut plus the call that returns the next page. `value` is a COUNT, never a price: it is the TOTAL number of matching rates, `unit` says so, and `headline` spells it out in fields (kind=count, is_a_price=false). The prices themselves are one per row in `matching_rates`.","layer":"L2","domain":"commercial","data_sources":["vlada_curated.fact_rate","vlada_curated.idx_rate_lookup"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_rate","vlada_curated.idx_npi_provider_group","vlada_curated.idx_rate_lookup"],"semantic_views_used":[],"known_gaps":["insurer price-transparency files are indexed for a limited set of payers only; a payer outside it has no build (the miss lists the payers we index)"]},{"name":"lookup_rates_for_tin","version":"1.1.0","description":"COMING SOON on the customer surface (withdrawn 2026-11-09; insurer files are thin): negotiated rates by insurer and plan are served from hospital files by compare_hospital_rates and plan_hospital_price. Look up the negotiated rates a payer attaches to a tax entity (TIN/EIN), resolved at query time through the canonical graph: TIN → provider groups (idx_tin_provider_group) → pg_sets → rates. Accepts hyphenated EINs (normalized digits-only 9). Every result carries provenance: tin_business_name (the payer-asserted entity name), tin_scope_class (fanout class), and tin_index_path ('membership' = payer-asserted NPI↔TIN rows; 'bridge' = system-level group evidence). A TIN is system-shared, NOT building-exact — use lookup_rates_for_npi first for building-specific evidence; this is the fallback rung of the facility identity ladder. Payers without a TIN index (e.g. carefirst-class, no usable EIN rows) return an honest empty. PAGED: `limit` (default 25, max 500) and `offset` bound both `matching_rates` and `provider_groups`; `rate_count` / `provider_group_count` are the full totals and `paging` names what was cut plus the call that returns the next page. `value` is a COUNT, never a price: it is the TOTAL number of matching rates, `unit` says so, and `headline` spells it out in fields (kind=count, is_a_price=false). The prices themselves are one per row in `matching_rates`.","layer":"L2","domain":"commercial","data_sources":["vlada_curated.fact_rate","vlada_curated.idx_rate_lookup"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_rate","vlada_curated.idx_tin_provider_group","vlada_curated.idx_rate_lookup"],"semantic_views_used":[],"known_gaps":["TIN evidence is system-shared, not building-exact","carefirst-class payers (NPI stuffed into tin_value) have no TIN index"]},{"name":"medicare_allowed","version":"0.1.0","description":"Returns the Medicare allowed amount for ONE billing code (CPT/HCPCS, or an MS-DRG for inpatient) from every Medicare fee schedule that prices it: PFS (professional, national non-facility), OPPS Addendum B (hospital outpatient APC), ASC, CLFS (lab), and IPPS (national DRG amount). Inputs: billing_code (required); optional care_class to pick the setting that fits a site (02_asc, 03_outpatient, 04_urgent_care, 05_imaging, 06_lab, 07_dialysis — the same preference table the care-site price bridge uses for its Medicare floor); optional setting to return one schedule only (PFS_non_facility | OPPS_APC | ASC | CLFS | IPPS_MSDRG_national); optional medicare_year to PIN a schedule vintage (4-digit year; omit it and the LATEST edition held for the chosen schedule is served — an older vintage is never returned unless you pin it); optional limit.\n\nRETURNS a detail payload: value.medicare_year and value.setting state the vintage and schedule actually served; value.summary carries the PREFERRED row for the requested care_class (medicare_allowed, medicare_source, medicare_year, billing_class), the latest year held per schedule (latest_year_by_schedule) and whether the year was pinned or resolved (medicare_year_selection), plus the count of schedules that price the code; value.settings lists EVERY schedule row for the code with what it is (fee_schedule, professional vs facility component, site, national basis, locality_adjusted=false, source_table, medicare_year vintage). Every number is NATIONAL — no GPCI / wage-index localisation is applied, and PFS is the NON-FACILITY (office) professional rate. A code priced on no schedule returns found=false ('not priced on these Medicare schedules', never $0). Reads the latest available edition per schedule (vlada_curated.vw_medicare_benchmark_effective per schedule, so an ASC rate is listed beside the OPPS rate for the same code; the underlying M-2 fact tables are read WHERE is_current).\n\nSOURCE: CMS PFS RVU + conversion factor, OPPS Addendum B, ASC addendum, CLFS, IPPS Table 5 + base rates.","layer":"L2","domain":"medicare","data_sources":["vlada_curated.vw_medicare_benchmark","vlada_curated.vw_medicare_benchmark_effective","medicare_silver.fact_pfs_rvu","medicare_silver.fact_opps_addendum_b","medicare_silver.fact_asc_addendum","medicare_silver.fact_clfs_national_rate"],"underlying_silver_tables_for_pinning":["vlada_curated.vw_medicare_benchmark","vlada_curated.vw_medicare_benchmark_effective","medicare_silver.fact_pfs_rvu","medicare_silver.fact_opps_addendum_b","medicare_silver.fact_asc_addendum","medicare_silver.fact_clfs_national_rate"],"semantic_views_used":[],"known_gaps":["National amounts only: no GPCI (PFS) or wage-index (OPPS/ASC/IPPS) localisation.","PFS is the non-facility (office) professional rate; the facility-setting professional rate is not served.","DMEPOS / anesthesia / ESRD schedules are not loaded; a code absent from every served schedule is 'not priced here', not $0."]},{"name":"pbm_compensation_rollup","version":"2.0.0","description":"Sums Form 5500 Schedule C direct + indirect compensation for a named PBM across one or more plan years. Every aggregate runs SERVER-SIDE in SQL over the whole matching population; the per-provider-name and per-plan-year rows the total is made of ride the answer, and each alias spelling carries its own measured attribution. M-6 alias chain resolves OptumRx -> OPTUMRX + OPTUM RX + Catamaran (post-2015 acquisition), Express Scripts -> ESI / ESI MAIL PHARMACY, CVS Caremark -> all variants; a name that is NOT a registered alias_form says so instead of silently searching one literal string.\n\nReference demo (re-measured live 2026-08-01): OptumRx plan year 2023 -> $1,461,686,909 direct comp across 295 plan-filings and 295 provider rows, attributed OPTUMRX $1,036,556,258 / OPTUM RX $425,110,391 / Catamaran $20,260.","layer":"L2","domain":"drug","data_sources":["drug_silver.fact_form5500_service_provider","drug_silver.fact_form5500_filing"],"underlying_silver_tables_for_pinning":["drug_silver.fact_form5500_service_provider","drug_silver.fact_form5500_filing"],"semantic_views_used":[],"known_gaps":[]},{"name":"plan_commercial_price_proof","version":"1.3.0","description":"COMING SOON on the customer surface (withdrawn 2026-11-09; insurer files are thin): negotiated rates by insurer and plan are served from hospital files by compare_hospital_rates and plan_hospital_price. Dry-run a bounded commercial fact_rate proof. Reads insurer price-transparency files, held only for the payers we index (a payer outside that set has no build). Requires payer, version_id, state, and code. version_id is 'latest' (the newest indexed build for the payer; the receipt records the concrete one) or a build month 'YYYY-MM' (e.g. '2026-04'). Plans Iceberg files/bytes before materializing rows, and returns a receipt-shaped plan. On no_match (version_id not found) the value includes `available_versions`: the version_ids that do carry rows for that payer/state/code, so an agent can pick a valid one.","layer":"L2","domain":"commercial","data_sources":["vlada_curated.fact_rate"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_rate"],"semantic_views_used":[],"known_gaps":[]},{"name":"plan_hospital_price","version":"1.5.0","description":"One hospital, one code, the rate by payer and plan name as the hospital filed it (where negotiated rates by insurer live today; the insurer-file / TiC tools are coming soon). Dry-run a bounded hospital fact_hospital_chargemaster proof. Requires hospital_ccn and billing_code, plans Iceberg files/bytes before materializing rows, and returns a receipt-shaped plan.","layer":"L2","domain":"hospital","data_sources":["vlada_curated.fact_hospital_chargemaster"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_hospital_chargemaster"],"semantic_views_used":[],"known_gaps":[]},{"name":"poll_query","version":"1.0.0","description":"Poll the status of an async job submitted with submit_query. Returns queued/running/done/error and whether it is terminal. When done, read the result with fetch_query.","layer":"L2","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":[]},{"name":"prove_commercial_price","version":"1.3.0","description":"COMING SOON on the customer surface (withdrawn 2026-11-09; insurer files are thin): negotiated rates by insurer and plan are served from hospital files by compare_hospital_rates and plan_hospital_price. Execute a bounded commercial fact_rate price proof and return rate summary values plus a receipt with source snapshot, filters, row count, caveats, input hash, response hash, and replay pointer. Reads insurer price-transparency files, held only for the payers we index. version_id is 'latest' (the newest indexed build for the payer; the receipt records the concrete one) or a build month 'YYYY-MM'. On no_match (version_id not found) the value includes `available_versions`: the version_ids that do carry rows for that payer/state/code, so an agent can pick a valid one and re-run.","layer":"L2","domain":"commercial","data_sources":["vlada_curated.fact_rate"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_rate"],"semantic_views_used":[],"known_gaps":[]},{"name":"prove_hospital_price","version":"1.5.0","description":"One hospital, one code, the rate by payer and plan name with a receipt (where negotiated rates by insurer live today; the insurer-file / TiC tools are coming soon). Execute a bounded hospital chargemaster price proof and return rate summary values plus a receipt with source snapshot, filters, raw byte provenance, caveats, input hash, response hash, and replay pointer.","layer":"L2","domain":"hospital","data_sources":["vlada_curated.fact_hospital_chargemaster"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_hospital_chargemaster"],"semantic_views_used":[],"known_gaps":[]},{"name":"prove_ma_enrollment_trend","version":"0.1.0","description":"Execute a bounded MA enrollment-trend proof. Returns the answer value plus a receipt with substrate, source snapshots, filters, guardrails, caveats, input hash, response hash, and replay pointer. Reads three silver tables (CPSC county, monthly-enrollment-plan, plan-crosswalks) at their published snapshots.","layer":"L2","domain":"medicare","data_sources":["medicare_silver.enrollment_monthly_county","medicare_silver.enrollment_monthly_plan","medicare_silver.plan_crosswalks_annual","medicare_silver.monthly_contract_enrollment_summary"],"underlying_silver_tables_for_pinning":["medicare_silver.enrollment_monthly_county","medicare_silver.enrollment_monthly_plan","medicare_silver.plan_crosswalks_annual","medicare_silver.monthly_contract_enrollment_summary"],"semantic_views_used":[],"known_gaps":[]},{"name":"query","version":"0.3.0","description":"SAFE STUB. Given a catalog source FQN, return HOW to query it FROM THIS MCP -- and only paths executable here: query_substrate (sync, small) or submit_query -> poll_query -> fetch_query (async), each with the source's fqn and one working example SELECT carrying an explicit LIMIT (and WHERE is_current when the table is M-2 versioned). Never executes SQL. A source outside the queryable set (retired / partial / planned / unattributed) gets no executable path and the rule that excluded it. COLUMNS (0.3.0): example_sql names the first ~6 real columns instead of `SELECT *` when the source is in the committed columns snapshot (same one describe_data_source's `columns` field reads); falls back to `SELECT *` when it is not, never a guessed column list. IDENTIFIERS (2026-09-18): this accepts every identifier describe_data_source accepts -- the public source code, a catalog source id, or a table FQN -- and answers with the same what-to-type block, so the two can never disagree about whether an identifier exists.","layer":"L1","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":[]},{"name":"query_substrate","version":"1.1.0","description":"Set fresh=true for a user-requested saved-view update: execute without the result cache; all access and scan limits still apply. Run a read-only SQL SELECT directly over the Vlada cost-data substrate (Athena/Iceberg) and get the rows back, with provenance. Use this when the pre-built tools don't answer your exact question. WORKFLOW: first call find_data_sources / describe_data_source to find the table + read its card (grain, columns, and the CAVEATS you must apply — e.g. filter ghost rates, never blend across modifiers/methodologies), THEN write SQL against the table's fully-qualified name (e.g. vlada_curated.fact_hospital_chargemaster). RULES: read-only SELECT only (no INSERT/UPDATE/DDL — rejected); you may only query tables in the queryable set your account is entitled to (others are rejected); M-2 versioned tables must be filtered on is_current (injected for a single-table SELECT, otherwise rejected with the column named); results are LIMIT-bounded by your plan's per-call row cap (at most 10000), the delivered payload is bounded to ~47K chars, and the scan is cost-capped. Any bound that drops rows is reported as truncated:true with rows_returned + rows_dropped/total_rows_estimate and a caveat saying how to get the rest: aggregate in SQL (GROUP BY, COUNT, approx_percentile) or narrow the predicate, so the engine computes over the full set and returns the answer in a few rows. Vlada answers questions; it does not export whole tables: paging past the first page (OFFSET) and the bulk lane (submit_query) are not on free or Studio. Every result carries provenance (the engine, query id, bytes scanned, tables read). Apply the source card's methodology yourself: raw SQL does not enforce it.","layer":"L1","domain":"commercial","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":["Raw SQL does NOT enforce a source's methodology (ghost-rate filter, modifier/methodology non-blending) — the agent must apply the caveats from the source card. For warranted, methodology-enforced numbers use the source's specialized tool."]},{"name":"recall_spend_window","version":"2.0.0","description":"Given an FDA-assigned recall_number, returns recall metadata plus Medicare Part D and Medicaid SDUD federal spend on the recalled drug during the recall window (initiation -> termination), summed SERVER-SIDE with per-year Part D rows and per-NDC Medicaid rows riding the answer. The recall source carries NO NDC (openfda_product_ndc_first is NULL on all 17,830 current rows), so the Medicaid leg reaches NDCs through dim_drug on the openFDA product name and says so. Each leg reports its own published-year coverage, so 'no spend', 'not published yet' and 'no join key' are three different answers instead of one null.\n\nMedicaid totals EXCLUDE the SDUD national roll-up, which CMS publishes under state 'XX' beside the 50 state rows and which would otherwise roughly double every Medicaid figure.\n\nReference demo: recall_number D-1489-2019 (Fresenius Kabi fluorouracil, Class I, window 2019-2022) exercises both legs and the NDC bridge. This description quotes NO dollar figure on purpose: the answer is the only place a number lives, so a change to the computation can never leave a stale figure in the documentation. It did once -- the demo totals here were the pre-2026-08-10 national-roll-up double count and stood six weeks after the fix.","layer":"L2","domain":"drug","data_sources":["drug_silver.fact_drug_recall","drug_silver.fact_drug_spending_part_d","drug_silver.fact_drug_medicaid_utilization","drug_silver.dim_drug"],"underlying_silver_tables_for_pinning":["drug_silver.fact_drug_recall","drug_silver.fact_drug_spending_part_d","drug_silver.fact_drug_medicaid_utilization","drug_silver.dim_drug"],"semantic_views_used":[],"known_gaps":["medicaid_sdud_suppression_used_flag","part_d_puf_annual_grain_only"]},{"name":"replay_commercial_price_proof","version":"1.3.0","description":"COMING SOON on the customer surface (withdrawn 2026-11-09; insurer files are thin): negotiated rates by insurer and plan are served from hospital files by compare_hospital_rates and plan_hospital_price. Replay a commercial price-proof receipt by re-running its recorded tool inputs and comparing response hash, Iceberg snapshot, plan hash, status, and row count.","layer":"L2","domain":"commercial","data_sources":["vlada_curated.fact_rate"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_rate"],"semantic_views_used":[],"known_gaps":[]},{"name":"replay_hospital_price","version":"1.5.0","description":"Replay a hospital price-proof receipt by re-running its recorded tool inputs and comparing response hash, Iceberg snapshot, plan hash, row count, status, and raw-byte source descriptor.","layer":"L2","domain":"hospital","data_sources":["vlada_curated.fact_hospital_chargemaster"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_hospital_chargemaster"],"semantic_views_used":[],"known_gaps":[]},{"name":"resolve_entity","version":"2.0.0","description":"Resolve any company name or ID to Vlada's canonical entity: a legal entity (le:...), a brand, an NAIC group, a CMS contract (H1234), a plan (H1234-001@2027), a Medicaid plan, a Marketplace issuer (HIOS). Matches exactly on IDs, EIN, NAIC code, CIK and names, then on names that contain every word of the text (returned as candidates, never as a match). Pass on=YYYY-MM-DD to match names as of a date. Then call describe_entity with the entity_id for its owners on a date, what it holds, and its events.","layer":"L2","domain":"curated","data_sources":["vlada_ontology.l1_entity","vlada_ontology.l1_identifier","vlada_ontology.l1_edge","vlada_ontology.l1_evidence","vlada_ontology.l1_event"],"underlying_silver_tables_for_pinning":["vlada_ontology.l1_entity","vlada_ontology.l1_identifier","vlada_ontology.l1_edge","vlada_ontology.l1_evidence","vlada_ontology.l1_event"],"semantic_views_used":["vlada_ontology.l1_entity","vlada_ontology.l1_identifier","vlada_ontology.l1_edge","vlada_ontology.l1_evidence","vlada_ontology.l1_event"],"known_gaps":["Layer one only: no facilities, doctors, networks or PBMs (layers two to five follow on Ben's signature).","About 16% of Medicare Advantage members sit under a chain with one hop resting on CMS's parent string alone (grade B); the top parent is not in doubt, the corroborating filing is not yet attached.","Belief time (what an earlier build served) is not yet queryable; every answer carries the build it was read from.","The 233 open review-queue rows (candidate contract transfers) are not served."]},{"name":"resolve_provider","version":"1.0.0","description":"Resolve a provider's identity: an NPI, an EIN, or an organisation name (+ state) -> the Medicare CCN(s) it maps to, the CCN's provider type from the CCN authority (vlada_curated.dim_provider_ccn: 101,528 CCNs across hospitals, SNFs, home health, hospice, FQHC, RHC, ASC, dialysis, IRF, LTCH), the NPPES record, the PECOS Medicare enrollment(s) with organisation name and provider type, and (include_ownership, default true) the PECOS ownership edges — owners, percentage, and the private-equity / REIT / holding-company / chain flags. Every candidate carries its match method, a confidence, and the source table per field. NPI->CCN is resolved by AGREEMENT across two bridges (provider_facility_xref, dim_hospital_external); if they disagree the answer is ambiguous_conflict with both candidates and no resolved CCN, never a guess. An unknown NPI returns unresolved with the reason, not an error. EIN and name resolution reach hospitals only (the estate's EIN-bearing roster); a shared-system EIN lists every CCN as a candidate. Each candidate carries ccn, npi, hospital_name and health_system at its top level; resolution carries resolved_npi and resolved_health_system; repeated PECOS rows are collapsed to one per enrollment.","layer":"L2","domain":"provider_identity","data_sources":["vlada_curated.dim_provider_ccn","vlada_curated.dim_provider","vlada_curated.provider_facility_xref","vlada_curated.dim_hospital_external","medicare_silver.fact_pecos_enrollment","medicare_silver.fact_provider_ownership","vlada_curated.dim_facility","vlada_curated.dim_hospital_system"],"underlying_silver_tables_for_pinning":["vlada_curated.dim_provider_ccn","vlada_curated.dim_provider","vlada_curated.provider_facility_xref","vlada_curated.dim_hospital_external","medicare_silver.fact_pecos_enrollment","medicare_silver.fact_provider_ownership","vlada_curated.dim_facility","vlada_curated.dim_hospital_system"],"semantic_views_used":[],"known_gaps":["NPI->CCN recall ~87% (bridge union, measured 2026-06 by the employer-book harness); individual NPIs and non-hospital organisations usually resolve to PECOS + NPPES only.","EIN and name resolution reach hospitals (dim_hospital_external) plus PECOS org names; the non-hospital rosters carry no EIN.","provider_type follows the ten CMS rosters in dim_provider_ccn; a provider type we hold no roster for is absent from the authority.","Ownership edges are keyed on PECOS enrollment_id and are self-reported; percentage can be null for indirect interests."]},{"name":"search_tools","version":"1.0.0","description":"DEPRECATED 2026-09-14 (one deprecation window): call find_data_sources instead -- it ranks the DATA POINT you asked for with the served tool that answers it, using the same ranker this tool now adapts. Kept callable so nothing in flight breaks. Find the right tool for a task. Given a natural-language description of what you want to do, returns the best-matching tools ranked by relevance, each as name + one_line_summary + params (compact by default; pass verbose=true for the full descriptions), so you can DISCOVER the correct specialized tool instead of scanning the whole catalog. Use this FIRST when you're unsure which tool fits (e.g. 'analyze PBM spread', 'reprice a hospital bill', 'compare MA plan benefits'); then call the tool it points you to. Paginates with limit (default 25, max 200) + offset. Only returns tools you are entitled to call. This is a DISCOVERY helper: it does not answer the question itself, it tells you which tool will.","layer":"L2","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":["Keyword/relevance ranking over tool name + description — not semantic embedding. Describe the task in domain terms (e.g. 'negotiated rate', 'reprice', 'formulary') for the best matches."]},{"name":"state_expert","version":"1.2.1","description":"The callable STATE EXPERT — the data-availability + regulation X-ray for a US state. Given a 2-letter state code (e.g. 'CT'), returns: (1) DATA AVAILABILITY — how many hospitals are priced, total price rows, distinct billing codes, care sites mapped, and payers with resolved coverage; (2) the REGULATION object — the rules of the game in that state (transparency regime, required disclosures, public datasets like an APCD or rate-setting authority, and the completeness bar); and (3) the computed GAPS — required-or-known datasets we have NOT yet ingested (e.g. a mandatory APCD), so absence is reported as gap-vs-expected, not silently. This is the 'what data do we have in this state, what is required here, and what is missing' entry a higher-level agent or operator reasons over. Because hospital pricing is a NATIONAL substrate, a state can show many hospitals priced even before its county map is built (e.g. MD). Stateless + state-parameterized: one runtime serves every state. To price a code across the state's hospitals, call compare_hospital_rates. SOURCE: curated hospital chargemaster + care-site registry + the state-regulation object. KNOWLEDGE (1.2.0): every answer lists the state's Marketplace and Medicaid knowledge pages (the States lane's per-state pages: regulators, what the state publishes, the rules, the plans) with their sections; pass page='marketplace' or 'medicaid' (and optionally section='<heading text>') to read one. Pages exist for states hospital rules do not yet cover, so a found=false answer can still carry them.","layer":"L2","domain":"curated","data_sources":["vlada_curated.fact_hospital_chargemaster","vlada_curated.dim_care_site","vlada_curated.agg_care_site_payer_coverage"],"underlying_silver_tables_for_pinning":["vlada_curated.fact_hospital_chargemaster","vlada_curated.dim_care_site","vlada_curated.agg_care_site_payer_coverage"],"semantic_views_used":[],"known_gaps":["regulation_object_is_seed_not_yet_dim_state_regulation","freshness_not_yet_tracked_pending_refresh_cascade","county_map_built_for_CT_only"]},{"name":"submit_query","version":"1.1.0","description":"Submit a heavy/long-running query to run OFF the request path and get a job_id back immediately, instead of blocking (and risking a timeout) on a statewide/cross-hospital scan. Arguments are validated against the target tool's own input model AT ACCEPT TIME, so a malformed submit is refused immediately (reason=invalid_arguments) instead of after you waited for the job. A POINT-LOOKUP CALL IS REFUSED, not queued: the refusal carries the direct call to make instead, with your own arguments already in it. That includes a bounded compare_hospital_rates read (one billing_code + one state), which the precomputed window answers in about a second. Pass force=true only when the SYNC door sent you here (too_large_for_sync, tool_timeout) — that route is always accepted. Poll with poll_query(job_id) and read the result with fetch_query(job_id). A refusal names the async-eligible targets and their current serving state, so you always know what this lane can run today.","layer":"L2","domain":"curated","data_sources":[],"underlying_silver_tables_for_pinning":[],"semantic_views_used":[],"known_gaps":[]}]}