Skip to content

TX: Weatherization Assistance Program Discovery#1425

Open
patwey wants to merge 7 commits intomainfrom
pat/mfb-675-tx-add-weatherization-assistance-program
Open

TX: Weatherization Assistance Program Discovery#1425
patwey wants to merge 7 commits intomainfrom
pat/mfb-675-tx-add-weatherization-assistance-program

Conversation

@patwey
Copy link
Collaborator

@patwey patwey commented Mar 20, 2026

Program Details

  • Program: Weatherization Assistance Program
  • State: TX
  • White Label: tx
  • Research Date: 2026-03-19

Summary by CodeRabbit

  • New Features

    • Added support for the Texas Weatherization Assistance Program (WAP) including program metadata, required documents, navigator contact info, application and learn links, and benefit estimates.
  • Documentation

    • Added a detailed TX WAP specification with eligibility criteria, data-gap notes, acceptance/test scenarios, and source references.
  • Tests

    • Added validation test cases covering eligible, ineligible, and SNAP-categorically-eligible household scenarios.

@patwey patwey self-assigned this Mar 20, 2026
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 20, 2026

Note

.coderabbit.yaml has unrecognized properties

CodeRabbit is using all valid settings from your configuration. Unrecognized properties (listed below) have been ignored and may indicate typos or deprecated fields that can be removed.

⚠️ Parsing warnings (1)
Validation error: Unrecognized key(s) in object: 'base_branches'
⚙️ Configuration instructions
  • Please see the configuration documentation for more information.
  • You can also validate your configuration using the online YAML validator.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository: MyFriendBen/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5f16da22-9fd0-463f-886a-4c5be3d7f211

📥 Commits

Reviewing files that changed from the base of the PR and between 471888c and f5ec4ef.

📒 Files selected for processing (2)
  • programs/management/commands/import_program_config_data/data/tx_wap_initial_config.json
  • programs/programs/tx/wap/spec.md
✅ Files skipped from review due to trivial changes (2)
  • programs/management/commands/import_program_config_data/data/tx_wap_initial_config.json
  • programs/programs/tx/wap/spec.md

📝 Walkthrough

Walkthrough

Adds Texas Weatherization Assistance Program (WAP) artifacts: a program configuration JSON with metadata, documents, and navigator; a detailed program spec describing eligibility, gaps, benefit estimate, and test/acceptance scenarios; and a validation fixture JSON with three test households covering income- and SNAP-based paths.

Changes

Cohort / File(s) Summary
Program config & import data
programs/management/commands/import_program_config_data/data/tx_wap_initial_config.json
New JSON adds TX WAP initial program config: white_label.code = "tx", program_category.external_name = "tx_housing", year 2025, legal-status requirements, names/descriptions, apply/learn URLs, estimated times/values, warning_message: null, required documents list, and navigators (211_texas).
Program specification
programs/programs/tx/wap/spec.md
New Markdown spec for TX WAP (research date 2026-03-19): enumerates eligibility criteria (income ≤200% FPL, categorical paths including SSI/TANF/LIHEAP, residency by zipcode/county), notes dwelling-related data gaps, adds a has_liheap screener field, lists a $372/year benefit estimate, implementation coverage, 10 acceptance scenarios and 10 test scenarios, and source links.
Validation fixtures
validations/management/commands/import_validations/data/tx_wap.json
New JSON fixture with three test households: (1) eligible via monthly Social Security income, (2) ineligible due to wages >200% FPL, (3) eligible via SNAP categorical eligibility. Each case includes household metadata, members, incomes, and expected tx_wap results.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description provides only program details (name, state, white label, research date) but omits required template sections including Context & Motivation, Changes Made, Testing, Deployment, and Notes for Reviewers. Complete the PR description using the provided template: add context/motivation explaining why this discovery work was needed, detail all files added, specify any testing/deployment steps, and note any reviewer considerations.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the primary change: adding discovery/specification work for Texas's Weatherization Assistance Program, matching the actual changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch pat/mfb-675-tx-add-weatherization-assistance-program

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link

codecov bot commented Mar 20, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

patwey added 3 commits March 20, 2026 13:23
- Remove selection priority criteria (elderly, disabled, children, energy burden) from eligibility section
- Mark dwelling type as data gap (not collected in TX screener)
- Remove administrative criteria: landlord permission, income docs, health/safety inspection, acquisition/demolition, local subgrantee
- Update citizenship criterion: WAP has no federal citizenship restriction; all immigration statuses eligible; handled by front-end filtering
- Move landlord permission and rental multi-unit rules into program description
- Update implementation coverage counts (6 evaluable, 3 data gaps)
…nergy savings

Replaces placeholder with $372/year estimate derived from DOE's published
average annual energy savings figure, consistent with CO ($350) and NC ($300)
WAP implementations in the codebase.
@patwey patwey marked this pull request as ready for review March 20, 2026 21:20
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 6

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In
`@programs/management/commands/import_program_config_data/data/tx_wap_initial_config.json`:
- Line 20: The estimated_value field in the TX WAP JSON config is empty and
should be set to the committed WAP amount; update the "estimated_value" key in
tx_wap_initial_config.json to the string value "$372/year" so downstream
surfaces display the benefit value correctly.

In `@programs/programs/tx/wap/spec.md`:
- Around line 89-91: Remove the non-research "page chrome" links from the
references list by deleting the entries with link texts "[Skip the navigation]"
and "[Site map]" so only substantive research/source links remain in the
references section; ensure no other formatting or ordering is broken when
removing these two list items.
- Line 266: Replace the unhyphenated compound modifier "high energy burden" in
the multi-member household description (the sentence listing priority
categories: elderly, disabled, children, high energy burden) with the hyphenated
form "high-energy burden" so the compound modifier is grammatically correct.
- Around line 94-104: The spec still frames scenarios around removed
selection-priority criteria (elderly/disabled/children/high-energy-burden);
update the scenario list and related sections to remove any priority-based
wording and ensure scenarios only assert eligibility/outcome based on the final
eligibility rules. Specifically, edit the scenario descriptions (e.g., "Scenario
1" through "Scenario 11") and the other referenced blocks (around the ranges
noted) to strip terms like "priority", "elderly priority", "priority-based", and
any language implying selection tiers, replacing them with neutral eligibility
statements tied to explicit factors (income, residency, age thresholds,
SNAP/SSI, ZIP/rural) and keep outcomes (eligible/ineligible and $372/year)
intact. Ensure headers and any explanatory text elsewhere in the document no
longer describe priority-based acceptance criteria so the spec matches the PR
objective that selection-priority criteria were removed.
- Line 224: Scenario 8 in the spec uses the Texas ZIP "73301" for the "not a
Texas resident" exclusion, which makes the scenario ambiguous; update the
scenario's ZIP value (replace "73301" wherever referenced in Scenario 8) with a
clearly non‑Texas ZIP (e.g., "10001" or another confirmed out‑of‑state ZIP) so
the screener unambiguously treats the participant as non‑Texas; ensure any
related instruction text (Scenario 8) mentions the new ZIP and that if the
screener asks for state you still select a non‑Texas state.

In `@validations/management/commands/import_validations/data/tx_wap.json`:
- Line 64: The fixture uses the wrong program_name string so the exact-match
lookup in validate.py (line with if program["external_name"] ==
validation.program_name) fails; update the three expected_results blocks in the
tx_wap JSON fixture where "program_name" is "tx_weatherization assistance
program" to instead be "tx_wap" so the validation.lookup matches the program's
external_name and the scenarios are exercised.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository: MyFriendBen/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: ff19687d-4faa-4225-a4bb-e6b674102b86

📥 Commits

Reviewing files that changed from the base of the PR and between 1c52071 and e3f0b8d.

📒 Files selected for processing (3)
  • programs/management/commands/import_program_config_data/data/tx_wap_initial_config.json
  • programs/programs/tx/wap/spec.md
  • validations/management/commands/import_validations/data/tx_wap.json

- Remove out-of-state scenario (residency enforced by platform design via TX-only ZIP codes)
- Fix validation program_name from "tx_weatherization assistance program" to "tx_wap" to match external_name (critical: was causing all 3 validation scenarios to be skipped)
- Remove page-chrome links from research references
- Hyphenate "high-energy burden" compound modifier
- Renumber scenarios 9-11 → 8-10 after removal
patwey added 2 commits March 26, 2026 11:14
…_link

- Improve description: merge opening sentences, add process walkthrough
  (waitlist → auditor → contractor → inspector), clarify multi-unit
  renter language, add apply instructions for Help for Texans page
- Fix learn_more_link to working TDHCA URL
- Update apply_button_link to tdhca.texas.gov/help-for-texans
- Clear apply_button_description
- Remove SNAP as categorical eligibility (not listed in 10 CFR 440.22)
- Add LIHEAP as categorical eligibility per 10 CFR 440.22(a)(3)
- Tighten SSI/TANF sources to cite 10 CFR 440.22(a)(2) precisely
- Remove unsupported citizenship/immigration criterion
- Remove primary residence criterion (no valid source cited)
- Update TDHCA URL to current site (tdhca.texas.gov)
- Update implementation coverage counts
@patwey patwey requested a review from catonph March 26, 2026 21:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants