Connect SNAP asset test to SIPP-imputed liquid assets

changelog_entry.yaml

@@ -0,0 +1,4 @@
+- bump: minor
+  changes:
+    added:
+      - Connect SNAP asset test to granular SIPP-imputed liquid resources per 7 CFR 273.8(c)(1) (bank accounts, stocks, bonds) so the resource limit binds in microsimulation.

policyengine_us/parameters/gov/usda/snap/asset_test/sources.yaml

@@ -0,0 +1,11 @@
+description: Countable liquid resources for SNAP asset limits per 7 CFR 273.8(c)(1).
+
+values:
+  2009-01-01:
+    - bank_account_assets
+    - stock_assets
+    - bond_assets
+metadata:
+  reference:
+    - title: 7 CFR 273.8(c)(1) - Liquid resources
+      href: https://www.law.cornell.edu/cfr/text/7/273.8#c_1

policyengine_us/tests/policy/baseline/gov/usda/snap/eligibility/snap_assets.yaml

@@ -0,0 +1,59 @@
+- name: No assets
+  period: 2024
+  input:
+    people:
+      person:
+        bank_account_assets: 0
+        stock_assets: 0
+        bond_assets: 0
+    spm_units:
+      spm_unit:
+        members: [person]
+  output:
+    snap_assets: 0
+
+- name: Bank account only
+  period: 2024
+  input:
+    people:
+      person:
+        bank_account_assets: 1_500
+        stock_assets: 0
+        bond_assets: 0
+    spm_units:
+      spm_unit:
+        members: [person]
+  output:
+    snap_assets: 1_500
+
+- name: All liquid asset types
+  period: 2024
+  input:
+    people:
+      person:
+        bank_account_assets: 1_000
+        stock_assets: 500
+        bond_assets: 200
+    spm_units:
+      spm_unit:
+        members: [person]
+  output:
+    snap_assets: 1_700
+
+- name: Multiple people in SPM unit
+  period: 2024
+  input:
+    people:
+      person1:
+        bank_account_assets: 1_000
+        stock_assets: 300
+        bond_assets: 0
+      person2:
+        bank_account_assets: 500
+        stock_assets: 0
+        bond_assets: 200
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+  output:
+    snap_assets: 2_000

policyengine_us/variables/gov/usda/snap/eligibility/snap_assets.py

@@ -5,6 +5,20 @@ class snap_assets(Variable):
     value_type = float
     entity = SPMUnit
     definition_period = YEAR
-    documentation = "Countable assets for SNAP limits"
+    documentation = (
+        "Countable liquid resources for SNAP asset limits. "
+        "Per 7 CFR 273.8(c)(1), liquid resources include "
+        "cash on hand, checking and savings accounts, "
+        "stocks, and bonds. Excluded per 7 USC 2014(g)(2-5): "
+        "home, retirement accounts (401k/IRA), "
+        "education savings (529/Coverdell), and vehicles "
+        "(subject to state fair-market-value exemptions)."
+    )
     label = "SNAP assets"
     unit = USD
+    reference = (
+        "https://www.law.cornell.edu/uscode/text/7/2014#g",
+        "https://www.law.cornell.edu/cfr/text/7/273.8",
+    )
+
+    adds = "gov.usda.snap.asset_test.sources"