Implement Utah Unemployment Insurance (ut_ui)

changelog.d/ut-ui.added.md

@@ -0,0 +1 @@
+Added Utah Unemployment Insurance (UI), including weekly benefit amount, duration, and maximum benefit calculation using the High Quarter Wage formula.

lessons/agent-lessons.md

@@ -0,0 +1,24 @@
+# Agent Lessons Learned
+
+Accumulated from /encode-policy-v2 and /backdate-program runs across all contributors.
+Loaded by implementation agents on future runs.
+
+## New Lessons from Utah UI (2026-05-13)
+
+### PARAMETER
+- For annually-recomputed parameters, never use a single dated entry to cover multiple years — create one dated entry per distinct value year so future audits and tests can isolate per-year regressions.
+- When two parameters derive from the same underlying statutory quantity (e.g., max WBA and min base-period wages both keyed to the IAFY wage), cross-check them mathematically after entry; an inconsistent ratio reveals a transcription error in one of them.
+- When a parameter value is sourced from a year-labeled form, embed the form number AND the effective year in the reference title so rolling-URL drift is detectable on audit.
+
+### REFERENCE
+- When citing a document via a URL that the publisher overwrites annually (current-year landing page), pair the live URL with a Wayback Machine snapshot capturing the historical version, and label the live URL as "current year — rolls over annually."
+- When the PDF's printed page number differs from the file page number (front-matter offset), annotate both in any human-readable comment (e.g., "page 11 (PDF file p. 13)") and use the file page number in the `#page=` anchor.
+- Never let a code comment cite one page number while the adjacent URL anchor uses a different one — readers cannot tell which is correct without rendering the PDF.
+
+### TEST
+- For parameters with multiple dated entries, place at least one boundary test inside each distinct year so a value regression in any single year fails its own dedicated test.
+- Include a cross-year regression-guard test that uses an old year's threshold against the new year's expected behavior — this catches accidental parameter collapse (single-entry-applied-to-all-years bugs).
+
+### WORKFLOW
+- Document-collector agents must fall back to the Read tool on PDF files when sandboxed binaries like `pdftotext`/`pdftoppm` are unavailable, rather than reporting the PDF as unreadable.
+- When a parameter value changes during review, grep test files for old-value-anchored case names, header comments, and inline comments — not just numeric inputs — and rewrite the prose so documentation does not drift from the new value.

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/duration/max_weeks.yaml

@@ -0,0 +1,12 @@
+description: Utah limits the potential benefit duration to this threshold under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 26
+
+metadata:
+  unit: week
+  period: year
+  label: Utah UI maximum potential duration
+  reference:
+    - title: Utah Code § 35A-4-401(4)(b)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S401.html

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/duration/min_weeks.yaml

@@ -0,0 +1,12 @@
+description: Utah sets the minimum potential benefit duration to this threshold under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 10
+
+metadata:
+  unit: week
+  period: year
+  label: Utah UI minimum potential duration
+  reference:
+    - title: Utah Code § 35A-4-401(4)(b)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S401.html

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/duration/multiplier.yaml

@@ -0,0 +1,12 @@
+description: Utah uses this multiplier on total base-period wages when computing the potential benefit duration under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 0.27
+
+metadata:
+  unit: /1
+  period: year
+  label: Utah UI duration wage multiplier
+  reference:
+    - title: Utah Code § 35A-4-401(4)(b)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S401.html

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/partial/earnings_disregard_rate.yaml

@@ -0,0 +1,14 @@
+description: Utah excludes this share of the weekly benefit amount from countable earnings during partial unemployment under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 0.3
+
+metadata:
+  unit: /1
+  period: year
+  label: Utah UI partial benefit earnings disregard rate
+  reference:
+    - title: Utah Code § 35A-4-401(3)(a)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S401.html
+    - title: Utah Admin Code R994-401-301
+      href: https://www.law.cornell.edu/regulations/utah/Utah-Admin-Code-R994-401-301

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/partial/hours_threshold.yaml

@@ -0,0 +1,14 @@
+description: Utah limits weekly hours worked to less than this threshold for benefit eligibility under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 40
+
+metadata:
+  unit: hour
+  period: week
+  label: Utah UI weekly hours threshold
+  reference:
+    - title: Utah Code § 35A-4-207
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S207.html
+    - title: Utah DWS Claimant Guide (Jan 2025)
+      href: https://jobs.utah.gov/ui/jobseeker/claimantguide.pdf#page=13

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/wba/divisor.yaml

@@ -0,0 +1,12 @@
+description: Utah uses this divisor on high-quarter wages when computing the weekly benefit amount under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 26
+
+metadata:
+  unit: /1
+  period: year
+  label: Utah UI weekly benefit amount divisor
+  reference:
+    - title: Utah Code § 35A-4-401(2)(a)(ii)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S401.html

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/wba/max_amount.yaml

@@ -0,0 +1,16 @@
+description: Utah limits the weekly benefit amount to this amount under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 712
+  2025-01-01: 777
+  2026-01-01: 806
+
+metadata:
+  unit: currency-USD
+  period: week
+  label: Utah UI maximum weekly benefit amount
+  reference:
+    - title: Utah Code § 35A-4-401(2)(b)(ii)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S401.html
+    - title: Utah DWS Unemployment Insurance Benefit Schedule (Form 04-13-0126)
+      href: https://jobs.utah.gov/ui/UIShared/PDFs/BenefitCalculation.pdf#page=1

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/benefit/wba/subtraction.yaml

@@ -0,0 +1,12 @@
+description: Utah deducts this amount from the high-quarter-derived weekly benefit amount under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 5
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Utah UI weekly benefit amount subtraction
+  reference:
+    - title: Utah Code § 35A-4-401(2)(a)(ii)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S401.html

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/eligibility/base_period_to_high_quarter_ratio.yaml

@@ -0,0 +1,14 @@
+description: Utah uses this multiple of high-quarter wages as the minimum total base-period wages under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 1.5
+
+metadata:
+  unit: /1
+  period: year
+  label: Utah UI base period to high quarter wage ratio
+  reference:
+    - title: Utah Code § 35A-4-403(1)(f)(i)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S403.html
+    - title: Utah Admin Code R994-401-202
+      href: https://www.law.cornell.edu/regulations/utah/Utah-Admin-Code-R994-401-202

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/eligibility/min_base_period_wages.yaml

@@ -0,0 +1,25 @@
+description: Utah limits monetary eligibility to claimants with total base-period wages of at least this amount under the Unemployment Insurance program.
+
+# The floor is recomputed annually per Utah Code § 35A-4-201(16):
+# 8% of the insured average fiscal-year wage for the preceding fiscal year,
+# rounded up to the next higher multiple of $100. The 2024 value is derived
+# from the 2024 max WBA ($712) per UC § 35A-4-201(16) (8% of insured average
+# fiscal year wage, rounded up to next $100) and § 35A-4-401(2)(b)(ii). DWS
+# no longer publishes the 2024 schedule PDF, but the value is recoverable
+# from the 2024 max WBA already encoded in `wba/max_amount.yaml`.
+values:
+  2024-01-01: 4_800
+  2025-01-01: 5_300
+  2026-01-01: 5_500
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Utah UI minimum base-period wages
+  reference:
+    - title: Utah Code § 35A-4-201(16)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S201.html
+    - title: Utah DWS Unemployment Insurance Benefit Schedule (Form 04-13-0125, archived 2025)
+      href: https://web.archive.org/web/20250304230024/https://jobs.utah.gov/ui/UIShared/PDFs/BenefitCalculation.pdf#page=1
+    - title: Utah DWS Unemployment Insurance Benefit Schedule (current year — URL rolls over annually)
+      href: https://jobs.utah.gov/ui/UIShared/PDFs/BenefitCalculation.pdf#page=1

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/eligibility/min_quarters_with_wages.yaml

@@ -0,0 +1,14 @@
+description: Utah sets the minimum number of base-period quarters with wages to this threshold under the Unemployment Insurance program.
+
+values:
+  2024-01-01: 2
+
+metadata:
+  unit: int
+  period: year
+  label: Utah UI minimum quarters with wages
+  reference:
+    - title: Utah Code § 35A-4-403(1)(f)
+      href: https://le.utah.gov/xcode/Title35A/Chapter4/35A-4-S403.html
+    - title: Utah Admin Code R994-401-202
+      href: https://www.law.cornell.edu/regulations/utah/Utah-Admin-Code-R994-401-202

policyengine_us/parameters/gov/states/ut/dwf/unemployment_insurance/index.yaml

@@ -0,0 +1,4 @@
+metadata:
+  propagate_metadata_to_children: true
+  economy: false
+  household: true

policyengine_us/programs.yaml

@@ -900,6 +900,17 @@ programs:
     variable: ny_drive_clean_rebate
     parameter_prefix: gov.states.ny.nyserda.drive_clean
 
+  - id: ut_ui
+    name: Utah UI
+    full_name: Utah Unemployment Insurance
+    category: Benefits
+    agency: State
+    status: complete
+    coverage: UT
+    verified_years: "2024-2026"
+    variable: ut_ui
+    parameter_prefix: gov.states.ut.dwf.unemployment_insurance
+
   - id: tx_fpp_benefit
     name: Texas FPP
     full_name: Texas Family Planning Program