@htilabs/platform-common-models 0.8.3 → 0.8.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@htilabs/platform-common-models",
3
- "version": "0.8.3",
3
+ "version": "0.8.5",
4
4
  "description": "Shared constants, types, and models for HTI Labs applications",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -163,8 +163,8 @@
163
163
  "hash": "f78d52bf1960fb88e12cefb895a3defbdba971abda49618216460ae330f4addb"
164
164
  },
165
165
  "income_benefits_sources": {
166
- "count": 39,
167
- "hash": "e5995e3f865bfa0de1a89ba348c180e39195810aa4cbf2395e3177f9a4d56d05"
166
+ "count": 41,
167
+ "hash": "2c4c08fad1d49bf23f7cb3b1cec4f209b92cfac657b80e09ff0468420339a422"
168
168
  },
169
169
  "enrollment_application_status": {
170
170
  "count": 12,
@@ -351,8 +351,8 @@
351
351
  "hash": "5d32f251b24af795609cf5a354de58f2a67fa0884e94c864a3b2425052542d3b"
352
352
  },
353
353
  "identification_status": {
354
- "count": 7,
355
- "hash": "a247e3de63a950557afe4a072ff56bae82a92e51a0f92bd2d37f7187bb91218c"
354
+ "count": 9,
355
+ "hash": "123525b1e4f981f8fe18cdfb1e34abc93c280c3295296db1512e7ee1f8c341ea"
356
356
  },
357
357
  "investigative_request_type": {
358
358
  "count": 8,
@@ -507,8 +507,8 @@
507
507
  "hash": "b215354a1492256e7b235bcfcf96988227105458b0eb9e49bbea42386b5d4e3c"
508
508
  },
509
509
  "housing_subsidy_types": {
510
- "count": 11,
511
- "hash": "79fdaa8ff5c9eed6131e9aa81449dd0ee674031c09e4ba5b56da122e8cba8272"
510
+ "count": 16,
511
+ "hash": "4341619e6016822fcc353987a635421c767391a85f2ff7602726ca02bfa0f4f7"
512
512
  }
513
513
  }
514
514
  }
@@ -366,12 +366,14 @@ const SOT_SPECS: readonly SotSpec[] = [
366
366
  domain: "referral_entity_category",
367
367
  expectedCount: 43,
368
368
  },
369
- // CVC-171 — 5 L1 type groups + 28 L2 source codes + 1 additive L1
370
- // `victim_compensation` group leaf (171-006) + 5 missingness = 39.
369
+ // CVC-171 — 5 L1 type groups + 30 L2 source codes + 1 additive L1
370
+ // `victim_compensation` group leaf (171-006) + 5 missingness = 41.
371
+ // Additive orphan leaves: informal_income (171-001-002) under earned_income
372
+ // and family_friend_support (171-004-003) under transfer_support.
371
373
  {
372
374
  file: "incomeBenefitsSources.v1.0.0.json",
373
375
  domain: "income_benefits_sources",
374
- expectedCount: 39,
376
+ expectedCount: 41,
375
377
  },
376
378
  // CVC-175 — 8 flat Level-1 enrollment lifecycle statuses + 1 missingness
377
379
  // root + 3 canonical missingness children = 12.
@@ -515,7 +517,7 @@ const SOT_SPECS: readonly SotSpec[] = [
515
517
  { file: "hopeScaleCaptureContext.v1.0.0.json", domain: "hope_scale_capture_context", expectedCount: 11 },
516
518
  { file: "hopeScaleResponseOptions.v1.0.0.json", domain: "hope_scale_response_options", expectedCount: 12 },
517
519
  { file: "hopeScaleTier.v1.0.0.json", domain: "hope_scale_tier", expectedCount: 8 },
518
- { file: "identificationStatus.v1.0.0.json", domain: "identification_status", expectedCount: 7 },
520
+ { file: "identificationStatus.v1.0.0.json", domain: "identification_status", expectedCount: 9 },
519
521
  { file: "investigativeRequestType.v1.0.0.json", domain: "investigative_request_type", expectedCount: 8 },
520
522
  { file: "languages.v1.0.0.json", domain: "languages", expectedCount: 212 },
521
523
  { file: "leReportStatus.v1.0.0.json", domain: "le_report_status", expectedCount: 8 },
@@ -575,12 +577,15 @@ const SOT_SPECS: readonly SotSpec[] = [
575
577
  // ten_plus_years) + 1 missingness root + 3 canonical missingness children = 10.
576
578
  // CVC number is PROVISIONAL pending codebook-session ratification.
577
579
  { file: "recencyBand.v1.0.0.json", domain: "recency_band", expectedCount: 10 },
578
- // PROVISIONAL CVC-233 housing_subsidy_types — 7 HMIS-aligned subsidy types
580
+ // PROVISIONAL CVC-233 housing_subsidy_types — 12 HMIS-aligned subsidy types
579
581
  // (housing_choice_voucher, public_housing, project_based_rental_assistance,
580
582
  // permanent_supportive_housing, rapid_rehousing_assistance,
581
- // other_housing_subsidy, no_subsidy) + 1 missingness root + 3 canonical
582
- // missingness children = 11. CVC number is PROVISIONAL pending ratification.
583
- { file: "housingSubsidyTypes.v1.0.0.json", domain: "housing_subsidy_types", expectedCount: 11 },
583
+ // other_housing_subsidy, no_subsidy, plus additive va_supportive_housing,
584
+ // grant_per_diem_transition_in_place, housing_stability_voucher,
585
+ // family_unification_program, foster_youth_to_independence) + 1 missingness
586
+ // root + 3 canonical missingness children = 16. CVC number is PROVISIONAL
587
+ // pending ratification.
588
+ { file: "housingSubsidyTypes.v1.0.0.json", domain: "housing_subsidy_types", expectedCount: 16 },
584
589
  ] as const;
585
590
 
586
591
  // ─── Helpers ────────────────────────────────────────────────────────────────
@@ -92,6 +92,51 @@
92
92
  "childCodes": [],
93
93
  "definition": "Time-limited rental assistance and housing-stabilization services to help a household quickly exit homelessness into permanent housing (HUD CoC/ESG rapid re-housing)."
94
94
  },
95
+ {
96
+ "code": "233-008-000-000-000-000-000",
97
+ "key": "va_supportive_housing",
98
+ "title": "VA Supportive Housing (HUD-VASH)",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "HUD-VASH: a HUD Housing Choice Voucher paired with VA case management and clinical services for homeless Veterans."
103
+ },
104
+ {
105
+ "code": "233-009-000-000-000-000-000",
106
+ "key": "grant_per_diem_transition_in_place",
107
+ "title": "Grant and Per Diem Transition-in-Place (GPD TIP)",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "VA Grant and Per Diem Transition-in-Place: transitional housing that converts to permanent housing for the Veteran in the same unit."
112
+ },
113
+ {
114
+ "code": "233-010-000-000-000-000-000",
115
+ "key": "housing_stability_voucher",
116
+ "title": "Housing Stability Voucher (HSV)",
117
+ "selectable": true,
118
+ "parentCode": null,
119
+ "childCodes": [],
120
+ "definition": "Housing Stability Voucher: rental assistance for individuals and families who are homeless, at risk of homelessness, or fleeing domestic violence."
121
+ },
122
+ {
123
+ "code": "233-011-000-000-000-000-000",
124
+ "key": "family_unification_program",
125
+ "title": "Family Unification Program (FUP)",
126
+ "selectable": true,
127
+ "parentCode": null,
128
+ "childCodes": [],
129
+ "definition": "Family Unification Program: HUD vouchers for families at risk of child-welfare separation and for eligible youth aging out of foster care."
130
+ },
131
+ {
132
+ "code": "233-012-000-000-000-000-000",
133
+ "key": "foster_youth_to_independence",
134
+ "title": "Foster Youth to Independence (FYI)",
135
+ "selectable": true,
136
+ "parentCode": null,
137
+ "childCodes": [],
138
+ "definition": "Foster Youth to Independence: HUD vouchers for youth aging out of foster care who are homeless or at risk of homelessness."
139
+ },
95
140
  {
96
141
  "code": "233-006-000-000-000-000-000",
97
142
  "key": "other_housing_subsidy",
@@ -75,6 +75,24 @@
75
75
  "parentCode": null,
76
76
  "childCodes": [],
77
77
  "definition": "Advocate's deliberate choice to keep the person's name off the subject's record even when known (privacy / safety / legal-strategy reasons), or when documenting the name would risk the survivor or third party. Pairs with Name kind 'Anonymous'. This is a capture-intent posture, distinct from the missingness 'anonymous' sentinel."
78
+ },
79
+ {
80
+ "code": "929-004-000-000-000-000-000",
81
+ "key": "estimated_persona",
82
+ "title": "Estimated persona",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "A persona that exists in data/systems (resolved _id with linked source records) but has NOT been confirmed to represent a real person. Typically inferred (entity resolution / algorithm-clustered ads); maps 1:1 to the LEADS IDB 'not verified' icon. An estimated_persona record must never render as an identified person. Added 2026-06-12 per ruling M3 (Terry) so the platform-milestone IDENTIFICATION value maps exactly; RENAMED that day from the prototype's working code SYSTEM_ENTITY to avoid collision with facilitator_entity_type. Previously approximated as unidentified."
87
+ },
88
+ {
89
+ "code": "929-005-000-000-000-000-000",
90
+ "key": "confirmed",
91
+ "title": "Confirmed (identity unknown)",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Confirmed to be a real person, but the specific identity is unknown — the 'real person, identity unknown' degree that sat between unidentified and identified with no code before 2026-06-12 (ruling M3). Distinct from unidentified (capture intent: known-of via relationship, no name) in that confirmation is an explicit analyst/advocate determination that the entity is real."
78
96
  }
79
97
  ]
80
98
  }
@@ -65,7 +65,8 @@
65
65
  "selectable": false,
66
66
  "parentCode": null,
67
67
  "childCodes": [
68
- "171-001-001-000-000-000-000"
68
+ "171-001-001-000-000-000-000",
69
+ "171-001-002-000-000-000-000"
69
70
  ],
70
71
  "definition": "Income from wages, salary, tips, gig/contract work, or other paid employment."
71
72
  },
@@ -78,6 +79,15 @@
78
79
  "childCodes": [],
79
80
  "definition": "Income from wages, salary, tips, gig/contract work, or other paid employment. Includes informal earned income that is not supported by official documentation."
80
81
  },
82
+ {
83
+ "code": "171-001-002-000-000-000-000",
84
+ "key": "informal_income",
85
+ "title": "Informal / undocumented income",
86
+ "selectable": true,
87
+ "parentCode": "171-001-000-000-000-000-000",
88
+ "childCodes": [],
89
+ "definition": "Informal or undocumented income, e.g. cash work or side activity not captured by formal employment or a benefit program."
90
+ },
81
91
  {
82
92
  "code": "171-002-000-000-000-000-000",
83
93
  "key": "cash_benefit",
@@ -326,7 +336,8 @@
326
336
  "parentCode": null,
327
337
  "childCodes": [
328
338
  "171-004-001-000-000-000-000",
329
- "171-004-002-000-000-000-000"
339
+ "171-004-002-000-000-000-000",
340
+ "171-004-003-000-000-000-000"
330
341
  ],
331
342
  "definition": "Income received as interpersonal transfers or support payments (e.g., child support, spousal support)."
332
343
  },
@@ -348,6 +359,15 @@
348
359
  "childCodes": [],
349
360
  "definition": "All periodic payments received from an ex-spouse as alimony or spousal support. Excludes one-time property settlements."
350
361
  },
362
+ {
363
+ "code": "171-004-003-000-000-000-000",
364
+ "key": "family_friend_support",
365
+ "title": "Family / friend financial support",
366
+ "selectable": true,
367
+ "parentCode": "171-004-000-000-000-000-000",
368
+ "childCodes": [],
369
+ "definition": "Informal financial support from family or friends, not a documented benefit program."
370
+ },
351
371
  {
352
372
  "code": "171-005-000-000-000-000-000",
353
373
  "key": "other_unspecified",
@@ -1371,7 +1371,7 @@ export type ReferralEntityCategoryKey = keyof typeof ReferralEntityCategoryKeys;
1371
1371
  /**
1372
1372
  * Key → positional code map for the `income_benefits_sources` CVC domain.
1373
1373
  *
1374
- * Domain: `income_benefits_sources` · Version: 1.0.0 · Entries: 39
1374
+ * Domain: `income_benefits_sources` · Version: 1.0.0 · Entries: 41
1375
1375
  */
1376
1376
  export const IncomeBenefitsSourcesKeys = {
1377
1377
  missingness_root: "171-000-000-000-000-000-000",
@@ -1381,6 +1381,7 @@ export const IncomeBenefitsSourcesKeys = {
1381
1381
  prefer_not_to_answer: "171-000-000-000-000-000-004",
1382
1382
  earned_income: "171-001-000-000-000-000-000",
1383
1383
  employment: "171-001-001-000-000-000-000",
1384
+ informal_income: "171-001-002-000-000-000-000",
1384
1385
  cash_benefit: "171-002-000-000-000-000-000",
1385
1386
  unemployment_insurance: "171-002-001-000-000-000-000",
1386
1387
  supplemental_security_income: "171-002-002-000-000-000-000",
@@ -1408,6 +1409,7 @@ export const IncomeBenefitsSourcesKeys = {
1408
1409
  transfer_support: "171-004-000-000-000-000-000",
1409
1410
  child_support: "171-004-001-000-000-000-000",
1410
1411
  alimony_spousal_support: "171-004-002-000-000-000-000",
1412
+ family_friend_support: "171-004-003-000-000-000-000",
1411
1413
  other_unspecified: "171-005-000-000-000-000-000",
1412
1414
  other_income: "171-005-001-000-000-000-000",
1413
1415
  other_benefit: "171-005-002-000-000-000-000",
@@ -2776,7 +2778,7 @@ export type HopeScaleTierKey = keyof typeof HopeScaleTierKeys;
2776
2778
  /**
2777
2779
  * Key → positional code map for the `identification_status` CVC domain.
2778
2780
  *
2779
- * Domain: `identification_status` · Version: 1.0.0 · Entries: 7
2781
+ * Domain: `identification_status` · Version: 1.0.0 · Entries: 9
2780
2782
  */
2781
2783
  export const IdentificationStatusKeys = {
2782
2784
  missingness_root: "929-000-000-000-000-000-000",
@@ -2786,6 +2788,8 @@ export const IdentificationStatusKeys = {
2786
2788
  identified: "929-001-000-000-000-000-000",
2787
2789
  unidentified: "929-002-000-000-000-000-000",
2788
2790
  anonymous_posture: "929-003-000-000-000-000-000",
2791
+ estimated_persona: "929-004-000-000-000-000-000",
2792
+ confirmed: "929-005-000-000-000-000-000",
2789
2793
  } as const;
2790
2794
 
2791
2795
  export type IdentificationStatusKey = keyof typeof IdentificationStatusKeys;
@@ -3478,7 +3482,7 @@ export type RecencyBandKey = keyof typeof RecencyBandKeys;
3478
3482
  /**
3479
3483
  * Key → positional code map for the `housing_subsidy_types` CVC domain (PROVISIONAL CVC-233 — pending codebook ratification).
3480
3484
  *
3481
- * Domain: `housing_subsidy_types` · Version: 1.0.0 · Entries: 11
3485
+ * Domain: `housing_subsidy_types` · Version: 1.0.0 · Entries: 16
3482
3486
  */
3483
3487
  export const HousingSubsidyTypesKeys = {
3484
3488
  missingness_root: "233-000-000-000-000-000-000",
@@ -3492,6 +3496,11 @@ export const HousingSubsidyTypesKeys = {
3492
3496
  rapid_rehousing_assistance: "233-005-000-000-000-000-000",
3493
3497
  other_housing_subsidy: "233-006-000-000-000-000-000",
3494
3498
  no_subsidy: "233-007-000-000-000-000-000",
3499
+ va_supportive_housing: "233-008-000-000-000-000-000",
3500
+ grant_per_diem_transition_in_place: "233-009-000-000-000-000-000",
3501
+ housing_stability_voucher: "233-010-000-000-000-000-000",
3502
+ family_unification_program: "233-011-000-000-000-000-000",
3503
+ foster_youth_to_independence: "233-012-000-000-000-000-000",
3495
3504
  } as const;
3496
3505
 
3497
3506
  export type HousingSubsidyTypesKey = keyof typeof HousingSubsidyTypesKeys;