Add HUD utility allowance schedules for Texas and Kansas metro counties

[hua7450]

Summary

Extends hud_utility_allowance to the metropolitan counties where Housing Choice Voucher use concentrates, adding schedules for seven Texas metro counties and four Kansas counties (plus a 2026 Wichita vintage). Previously utility-allowance coverage was LA County, the rural TDHCA service area in Texas, and four Kansas PHAs — so the metro cores (Houston, Dallas, Fort Worth, San Antonio, Austin, El Paso, Waco) returned $0 even with tenant_pays_utilities.

Background

Utility allowances are set per public housing agency under 24 CFR 982.517, and the model keys them on county_fips. HUD does not publish a national dataset, so each county's schedule is transcribed from its dominant PHA and collapsed into one monthly amount per bedroom using the existing convention: Multi-Family unit type, all-electric, summed over every tenant-paid line item (heating/cooking/water-heating electric, other electric, air conditioning, water, sewer, trash, any flat electric service charge, and the range and refrigerator allowances).

Coverage added

Texas metro counties

County	FIPS	PHA
Dallas	48113	Dallas Housing Authority (DHA)
Harris	48201	Harris County Housing Authority
Tarrant	48439	Tarrant County Housing Assistance Office
Bexar	48029	Housing Authority of Bexar County
Travis	48453	Housing Authority of the City of Austin
El Paso	48141	El Paso County Housing Authority (+ El Paso Water Utilities for water/sewer/trash)
McLennan	48309	Waco Housing Authority (Schedule MC3, effective 2025-10-01)

Kansas counties

County	FIPS	PHA
Butler	20015	Wichita Housing Authority (2026 schedule; serves Butler)
Harvey	20079	Wichita Housing Authority (serves Harvey exc. City of Newton)
Douglas	20045	Lawrence-Douglas County Housing Authority
Riley	20161	Manhattan Housing Authority
Sedgwick	20173	Wichita Housing Authority — new 2026 vintage added alongside 2025

Verification

Every dollar value was checked against the originating PHA schedule PDF. Notable per-PHA quirks handled: flat "Electric Fee" service-charge rows (Johnson $14, Manhattan $15, Topeka $14, El Paso $12, Bexar $10); water/sewer/trash on separate sheets or provider tables (El Paso's 8 providers → El Paso Water Utilities PSB; Manhattan's separate water-sewer sheet plus a $35 trash row); one-schedule-per-county selection where a county hosts multiple PHAs (dominant PHA used, matching existing precedent); and McLennan's "ATMOS CC-23" row (a gas customer charge, excluded under the all-electric convention; the schedule has no electric service-charge row).

TDHCA itself publishes schedules for only 28 of its 34 service-area counties (2024 and 2026 vintages both cover the same 28). Of the remaining gap counties, McLennan is the only one with a published schedule from another PHA (Waco HA); Bosque, Cooke, Crockett, McMullen, and Wise have no schedule published online (Decatur HA provides Wise County's by email request only).

Not a formula change

hud_utility_allowance.py and utility_allowance/__init__.py are touched only for source references and coverage docstrings — the lookup already keys on county_fips, so new counties resolve automatically.

Partner contract tests

The analytics-coverage tripwire case housing_assistance_tx_tenant_pays_utilities_no_allowance was written to force a reviewed diff when Dallas gained a schedule; this PR is that diff. The case is renamed to ..._dallas_allowance and its expected value rises from 15,600 to 19,464 (Dallas 2-bd allowance of $322/mo = $3,864/yr, rent side still binding). A new ..._no_allowance case re-pins the uncovered-county boundary to Lubbock County (48303), which no encoded PHA schedule, ZIP payment standard, or mandatory-SAFMR designation covers. Partner impact: households in the newly covered counties with tenant_pays_utilities will see housing_assistance increase.

Tests

Adds one test case per new county (including McLennan at $240/mo for 2-bd); all pass. The existing Wichita SRO test (0.75 × $210 = $157.50) is unaffected, since the new 2026 Sedgwick vintage does not change period-2025 resolution.

Files

• parameters/gov/hud/utility_allowance/county_utility_allowances.csv
• parameters/gov/hud/utility_allowance/__init__.py (docstring only)
• variables/gov/hud/hud_utility_allowance.py (references/docstring only)
• tests/policy/baseline/gov/hud/hud_utility_allowance.yaml
• tests/policy/baseline/partners/analytics_coverage/edge_cases/federal/housing/housing_assistance/federal.yaml
• changelog.d/hud-metro-utility-allowances.added.md

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (ff39625) to head (4526bed).
⚠️ Report is 16 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #8984   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            1         1           
  Lines           18        24    +6     
=========================================
+ Hits            18        24    +6     

Flag	Coverage Δ
unittests	100.00% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.