@htilabs/platform-common-models 0.7.0 → 0.8.0

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.
Files changed (99) hide show
  1. package/dist/constants/index.cjs +72 -7
  2. package/dist/constants/index.cjs.map +1 -1
  3. package/dist/constants/index.d.cts +1 -1
  4. package/dist/constants/index.d.ts +1 -1
  5. package/dist/constants/index.js +71 -7
  6. package/dist/constants/index.js.map +1 -1
  7. package/dist/cvcs/index.cjs +10051 -10
  8. package/dist/cvcs/index.cjs.map +1 -1
  9. package/dist/cvcs/index.d.cts +11750 -554
  10. package/dist/cvcs/index.d.ts +11750 -554
  11. package/dist/cvcs/index.js +9986 -9
  12. package/dist/cvcs/index.js.map +1 -1
  13. package/dist/index.cjs +11341 -19
  14. package/dist/index.cjs.map +1 -1
  15. package/dist/index.d.cts +1480 -8
  16. package/dist/index.d.ts +1480 -8
  17. package/dist/index.js +11212 -19
  18. package/dist/index.js.map +1 -1
  19. package/dist/{platform-auth-CjC57132.d.cts → platform-auth-7dL99tZh.d.cts} +18 -2
  20. package/dist/{platform-auth-CjC57132.d.ts → platform-auth-7dL99tZh.d.ts} +18 -2
  21. package/dist/schemas/index.cjs +63 -7
  22. package/dist/schemas/index.cjs.map +1 -1
  23. package/dist/schemas/index.js +63 -7
  24. package/dist/schemas/index.js.map +1 -1
  25. package/dist/types/index.d.cts +2 -2
  26. package/dist/types/index.d.ts +2 -2
  27. package/package.json +2 -2
  28. package/src/__tests__/__snapshots__/cvc-sot.snap +259 -3
  29. package/src/__tests__/cvc-sot-snapshot.test.ts +70 -2
  30. package/src/__tests__/cvc-structural.test.ts +65 -0
  31. package/src/constants/ic.ts +158 -3
  32. package/src/cvcs/accommodationType.v1.0.0.json +107 -0
  33. package/src/cvcs/actionStepCompletionStatus.v1.0.0.json +89 -0
  34. package/src/cvcs/actionStepType.v1.0.0.json +71 -0
  35. package/src/cvcs/announcementAudienceScope.v1.0.0.json +80 -0
  36. package/src/cvcs/announcementResponseType.v1.0.0.json +89 -0
  37. package/src/cvcs/basisQuickPicks.v1.0.0.json +123 -0
  38. package/src/cvcs/checkInActivity.v1.0.0.json +233 -0
  39. package/src/cvcs/checkInPhase.v1.0.0.json +152 -0
  40. package/src/cvcs/childBehavioralConcerns.v1.0.0.json +161 -0
  41. package/src/cvcs/childCustodyArrangement.v1.0.0.json +188 -0
  42. package/src/cvcs/collectionContext.v1.0.0.json +88 -0
  43. package/src/cvcs/daIncidentArchiveReason.v1.0.0.json +89 -0
  44. package/src/cvcs/daIncidentConfidence.v1.0.0.json +80 -0
  45. package/src/cvcs/daIncidentDayApprox.v1.0.0.json +89 -0
  46. package/src/cvcs/daIncidentSeverity.v1.0.0.json +97 -0
  47. package/src/cvcs/disabilitySubtype.v1.0.0.json +126 -0
  48. package/src/cvcs/discretionLevel.v1.0.0.json +89 -0
  49. package/src/cvcs/emergencyContactCallReason.v1.0.0.json +107 -0
  50. package/src/cvcs/emergencyContactPermissions.v1.0.0.json +125 -0
  51. package/src/cvcs/emergencyExitCascade.v1.0.0.json +89 -0
  52. package/src/cvcs/exitProcessChecklistItem.v1.0.0.json +152 -0
  53. package/src/cvcs/exitReasons.v1.0.0.json +224 -0
  54. package/src/cvcs/facialHair.v1.0.0.json +71 -0
  55. package/src/cvcs/funder.v1.0.0.json +125 -0
  56. package/src/cvcs/goalCategory.v1.0.0.json +161 -0
  57. package/src/cvcs/goalPriority.v1.0.0.json +80 -0
  58. package/src/cvcs/goalStatus.v1.0.0.json +98 -0
  59. package/src/cvcs/goalWithdrawalReason.v1.0.0.json +116 -0
  60. package/src/cvcs/hmisProjectType.v1.0.0.json +178 -0
  61. package/src/cvcs/hopeScaleCaptureContext.v1.0.0.json +116 -0
  62. package/src/cvcs/hopeScaleResponseOptions.v1.0.0.json +125 -0
  63. package/src/cvcs/hopeScaleTier.v1.0.0.json +89 -0
  64. package/src/cvcs/identificationStatus.v1.0.0.json +80 -0
  65. package/src/cvcs/index.ts +128 -0
  66. package/src/cvcs/investigativeRequestType.v1.0.0.json +89 -0
  67. package/src/cvcs/languages.v1.0.0.json +1924 -0
  68. package/src/cvcs/leReportStatus.v1.0.0.json +89 -0
  69. package/src/cvcs/legalActionType.v1.0.0.json +116 -0
  70. package/src/cvcs/messageReportReason.v1.0.0.json +107 -0
  71. package/src/cvcs/midStayEventType.v1.0.0.json +116 -0
  72. package/src/cvcs/milestoneType.v1.0.0.json +170 -0
  73. package/src/cvcs/needsResidentialAgain.v1.0.0.json +80 -0
  74. package/src/cvcs/personRelationships.v1.0.0.json +6 -6
  75. package/src/cvcs/petExitReason.v1.0.0.json +107 -0
  76. package/src/cvcs/petRelationshipBasis.v1.0.0.json +80 -0
  77. package/src/cvcs/programSpecificCode.v1.0.0.json +125 -0
  78. package/src/cvcs/proofOfIdType.v1.0.0.json +188 -0
  79. package/src/cvcs/referenceLinkType.v1.0.0.json +125 -0
  80. package/src/cvcs/relationshipDynamics.v1.0.0.json +445 -0
  81. package/src/cvcs/returnedToAbuserStatus.v1.0.0.json +80 -0
  82. package/src/cvcs/rsvpResponse.v1.0.0.json +80 -0
  83. package/src/cvcs/servicePlanClosureReason.v1.0.0.json +125 -0
  84. package/src/cvcs/servicePlanReviewSnoozeReason.v1.0.0.json +116 -0
  85. package/src/cvcs/serviceSource.v1.0.0.json +71 -0
  86. package/src/cvcs/serviceStates.v1.0.0.json +12 -2
  87. package/src/cvcs/severityFollowUp.v1.0.0.json +89 -0
  88. package/src/cvcs/signatureMethod.v1.0.0.json +89 -0
  89. package/src/cvcs/signatureType.v1.0.0.json +89 -0
  90. package/src/cvcs/smtBodyLocation.v1.0.0.json +314 -0
  91. package/src/cvcs/smtNameRelation.v1.0.0.json +116 -0
  92. package/src/cvcs/smtSignificanceFlags.v1.0.0.json +116 -0
  93. package/src/cvcs/substanceUseStatus.v1.0.0.json +90 -0
  94. package/src/cvcs/supportTopic.v1.0.0.json +116 -0
  95. package/src/cvcs/threadStatus.v1.0.0.json +80 -0
  96. package/src/cvcs/threadType.v1.0.0.json +98 -0
  97. package/src/cvcs/verificationStatus.v1.0.0.json +80 -0
  98. package/src/cvcs/visaType.v1.0.0.json +378 -0
  99. package/src/generated/cvc-enums.ts +1605 -5
@@ -0,0 +1,89 @@
1
+ {
2
+ "domain": "emergency_exit_cascade",
3
+ "name": "Emergency Exit Cascade",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering; codes from prototype/data/cvcs/core_emergency_exit_cascade.yaml; PENDING canonical Notion authoring (PAVE Auditability backlog). Multi-select set of safety-driven cascade actions surfaced in the Move-Ins & Exit Exit modal when an enrollment's exit reason is cascade-eligible. YAML declares vocab_status: draft, 4 L1 actions + 1 L0 sentinel (UNK); the canonical missingness triplet is normalized here (the YAML's single UNK sentinel maps to the unknown child).",
6
+ "_source": "prototype/data/cvcs/core_emergency_exit_cascade.yaml",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Cascade action"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "918-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "918-000-000-000-000-000-001",
20
+ "918-000-000-000-000-000-002",
21
+ "918-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Variant: 3-value (unknown, anonymous, data_not_collected). The prototype YAML's single L0 'UNK' sentinel ('cascade action recorded but specific type unspecified') maps to the unknown child; anonymous and data_not_collected added per workspace standard."
24
+ },
25
+ {
26
+ "code": "918-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "918-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Cascade action recorded but specific type unspecified. Rarely used — the canonical capture flow expects advocates to confirm specific cascade actions or no cascades at all. Reserved for edge cases where the advocate marked a generic 'cascade required' without picking specific actions (the YAML 'UNK' sentinel)."
33
+ },
34
+ {
35
+ "code": "918-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "918-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld or redacted. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel."
42
+ },
43
+ {
44
+ "code": "918-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "918-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "918-001-000-000-000-000-000",
54
+ "key": "safety_plan_updated",
55
+ "title": "Update Safety Plan in Plans & Goals",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Trigger a safety plan update banner in the survivor's Plans & Goals Safety section. Per OAC 75:30 trauma-informed practice, emergency exits typically warrant explicit re-evaluation of the safety plan. Phase 1 dispatches hti:safety-plan-update-requested; Phase 2 wires the canonical Plans & Goals Safety Plan banner consumer."
60
+ },
61
+ {
62
+ "code": "918-002-000-000-000-000-000",
63
+ "key": "emergency_contacts_notified",
64
+ "title": "Notify emergency contacts (per ROIWizard scope)",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Trigger emergency contact notification flow scoped to the survivor's ROIWizard authorizations. Only contacts with active ROI scopes covering safety / emergency notification are notified. Phase 1 dispatches hti:emergency-contacts-notify-requested; Phase 2 wires the canonical ROIWizard consumer."
69
+ },
70
+ {
71
+ "code": "918-003-000-000-000-000-000",
72
+ "key": "destination_confidential",
73
+ "title": "Flag destination as confidential",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Sets confidentiality flag on the auto-created destination Living Situation entry (per HMIS 3.12). Honors 28 CFR § 90 (VAWA confidentiality) for survivors going to undisclosed locations post-emergency exit. Stamps confidential: true + suppresses address fields in cross-surface displays + restricts ROIWizard sharing scope."
78
+ },
79
+ {
80
+ "code": "918-004-000-000-000-000-000",
81
+ "key": "risk_algo_reevaluated",
82
+ "title": "Trigger risk-algo housing-instability re-evaluation",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Marks the survivor's housing-instability risk profile for re-evaluation given the emergency exit context. Routes through canonical risk-algo IS_AUTOFILL_RULES queueing for next session pickup. Phase 1 dispatches hti:risk-algo-reevaluate-requested; Phase 2 wires the canonical risk-algo consumer."
87
+ }
88
+ ]
89
+ }
@@ -0,0 +1,152 @@
1
+ {
2
+ "domain": "exit_process_checklist_item",
3
+ "name": "Exit Process Checklist Item",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering; codes from prototype/data/cvcs/core_exit_process_checklist_item.yaml; PENDING canonical Notion authoring (PAVE Auditability backlog). This is a CHECKLIST-ITEM controlled set (each entry is a canonical exit-process checklist item the advocate checks off, mirroring The Spring's 10-item EmpowerDB exit form), not a single-select demographic vocab — captured here faithfully as a flat code list of selectable items (10 canonical items + OTHER catch-all). YAML declares vocab_status: draft, 10 L1 items + OTHER + 1 L0 sentinel (UNK); the canonical missingness triplet is normalized here (the YAML UNK sentinel maps to the unknown child). Two items carry roi_check_required (schools_notified, counselor_notified) — preserved in their definitions.",
6
+ "_source": "prototype/data/cvcs/core_exit_process_checklist_item.yaml",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Checklist item"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "919-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "919-000-000-000-000-000-001",
20
+ "919-000-000-000-000-000-002",
21
+ "919-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Variant: 3-value (unknown, anonymous, data_not_collected). The prototype YAML's single L0 'UNK' sentinel (canonical missingness representation for export-pipeline consumers) maps to the unknown child; anonymous and data_not_collected added per workspace standard."
24
+ },
25
+ {
26
+ "code": "919-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "919-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Canonical missingness sentinel — not used directly in the Phase D Step 4 UI but available for export-pipeline downstream consumers that require canonical missingness representation (the YAML 'UNK' sentinel)."
33
+ },
34
+ {
35
+ "code": "919-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "919-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld or redacted. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel."
42
+ },
43
+ {
44
+ "code": "919-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "919-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "919-001-000-000-000-000-000",
54
+ "key": "discuss_exit_reasons",
55
+ "title": "Discuss reasons for exit with client",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Per Spring exit protocol + OAC 75:30-5-3 client records exit documentation requirement. Canonical first step in trauma-informed exit sequence."
60
+ },
61
+ {
62
+ "code": "919-002-000-000-000-000-000",
63
+ "key": "locks_returned",
64
+ "title": "Request locks from all assigned containers be returned",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Per Spring exit protocol; canonical residential program practice. Per-agency label_override available for non-residential programs."
69
+ },
70
+ {
71
+ "code": "919-003-000-000-000-000-000",
72
+ "key": "evaluation_form_sent",
73
+ "title": "Send evaluation form link to client",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Outcome tracking; canonical agency exit-evaluation practice. Typically optional per agency policy."
78
+ },
79
+ {
80
+ "code": "919-004-000-000-000-000-000",
81
+ "key": "forwarding_address_requested",
82
+ "title": "Request forwarding address form",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Canonical follow-up contact capture. Phase D Step 2 forwarding address shape persists the captured info. Typically mandatory per Spring policy."
87
+ },
88
+ {
89
+ "code": "919-005-000-000-000-000-000",
90
+ "key": "spiritual_care_offered",
91
+ "title": "Offered spiritual / pastoral care if welcomed",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Per Spring lived practice 'Offer to pray with them, offer a care bag'; canonical neutral framing supports faith-based + non-faith-based agencies. Per-agency label_override available (non-faith-based agencies override or hide)."
96
+ },
97
+ {
98
+ "code": "919-006-000-000-000-000-000",
99
+ "key": "schools_notified",
100
+ "title": "Notify any applicable schools of kids exit",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "roi_check_required: true. Triggers hti:roi-verification-requested with roi_purpose: 'school_notification' when the canonical Phase D Step 4 checkbox is checked. ROIWizard consumer queued Phase 2.x. Typically optional per agency policy."
105
+ },
106
+ {
107
+ "code": "919-007-000-000-000-000-000",
108
+ "key": "counselor_notified",
109
+ "title": "Notify counselor of exit if applicable",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "roi_check_required: true. Triggers hti:roi-verification-requested with roi_purpose: 'counselor_notification' when the canonical Phase D Step 4 checkbox is checked. ROIWizard consumer queued Phase 2.x."
114
+ },
115
+ {
116
+ "code": "919-008-000-000-000-000-000",
117
+ "key": "whiteboard_locker_erased",
118
+ "title": "Erase locker number on white board",
119
+ "selectable": true,
120
+ "parentCode": null,
121
+ "childCodes": [],
122
+ "definition": "Spring operational protocol; per-agency label_override available for non-residential programs. Typically mandatory per Spring policy."
123
+ },
124
+ {
125
+ "code": "919-009-000-000-000-000-000",
126
+ "key": "team_discharge_informed",
127
+ "title": "Inform team of program discharge; close out all information",
128
+ "selectable": true,
129
+ "parentCode": null,
130
+ "childCodes": [],
131
+ "definition": "Cross-shift continuity discipline; canonical hand-off. Typically mandatory per Spring policy."
132
+ },
133
+ {
134
+ "code": "919-010-000-000-000-000-000",
135
+ "key": "room_turnover_form_completed",
136
+ "title": "Complete a room turnover form",
137
+ "selectable": true,
138
+ "parentCode": null,
139
+ "childCodes": [],
140
+ "definition": "Spring operational protocol; per-agency label_override available for non-residential programs."
141
+ },
142
+ {
143
+ "code": "919-011-000-000-000-000-000",
144
+ "key": "other",
145
+ "title": "Other (custom)",
146
+ "selectable": true,
147
+ "parentCode": null,
148
+ "childCodes": [],
149
+ "definition": "Per-agency custom item. Free-text details_text required when checked."
150
+ }
151
+ ]
152
+ }
@@ -0,0 +1,224 @@
1
+ {
2
+ "domain": "exit_reasons",
3
+ "name": "Core Exit Reasons",
4
+ "version": "1.0.0",
5
+ "_source": "prototype/data/cvcs/core_exit_reasons.yaml (Final-CVC-derived), CVC-220",
6
+ "_status": "DRAFT — Notion page is Not-started/empty; codes from prototype pending Notion-sub-DB ratification",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Exit reason"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "220-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "220-000-000-000-000-000-001",
20
+ "220-000-000-000-000-000-002",
21
+ "220-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Variant: 3-value (unknown, anonymous, data_not_collected). No prefer_not_to_answer — Notion codebook rolls 'declined to answer' into the anonymous sentinel under the workspace standard ANON semantic. Maps the prototype L0 sentinels: data_not_collected ← DNC (HMIS data_not_collected), anonymous ← ANON (HMIS client_refused), unknown ← UNK (HMIS client_doesnt_know)."
24
+ },
25
+ {
26
+ "code": "220-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "220-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Exit reason cannot be determined from available information. Distinct from lost_to_followup (which is a canonical reason itself) — captures the 'exit happened + we know it happened but don't know the reason' case. HMIS canonical missingness mapping: client_doesnt_know."
33
+ },
34
+ {
35
+ "code": "220-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "220-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Exit reason intentionally withheld/redacted for privacy reasons. Sensitive cases may use this when capturing the reason would create re-identification risk. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel. HMIS canonical missingness mapping: client_refused."
42
+ },
43
+ {
44
+ "code": "220-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "220-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to capture the exit reason. Use only for legacy imports / pre-existing enrollments with no exit interview. HMIS canonical missingness mapping: data_not_collected."
51
+ },
52
+ {
53
+ "code": "220-001-000-000-000-000-000",
54
+ "key": "completed_program",
55
+ "title": "Completed program",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "The survivor completed the program's curriculum / treatment / service plan and exited as the program's intended graduation outcome. Most-positive exit outcome. outcome_polarity positive, initiator mutual. Counts as a positive outcome in agency monthly reporting and HMIS-derived dashboards."
60
+ },
61
+ {
62
+ "code": "220-002-000-000-000-000-000",
63
+ "key": "reached_maximum_allowed_stay",
64
+ "title": "Reached maximum allowed stay",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "The survivor reached the program's defined maximum stay duration (typically 30/60/90 days for emergency shelters). Exit is operational — not punitive, not a completion. outcome_polarity neutral_positive, initiator program. Common in emergency shelters with regulatory max-stay caps."
69
+ },
70
+ {
71
+ "code": "220-003-000-000-000-000-000",
72
+ "key": "transferred_to_another_program_internal",
73
+ "title": "Transferred to another program (same agency)",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "The survivor transferred to a different program at the same agency (e.g., emergency shelter → TLP; residential treatment → outpatient continuation). Typically captures a paired enrollment-start on the destination program. outcome_polarity positive, initiator mutual."
78
+ },
79
+ {
80
+ "code": "220-004-000-000-000-000-000",
81
+ "key": "transferred_to_another_program_external",
82
+ "title": "Transferred to another program (different agency)",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "The survivor transferred to a different program at a different agency. Captures cross-agency referral with confirmed destination enrollment. Distinct from the internal-transfer code for HMIS-CoC reporting alignment and agency-level outcome tracking. outcome_polarity positive, initiator mutual."
87
+ },
88
+ {
89
+ "code": "220-005-000-000-000-000-000",
90
+ "key": "left_early_voluntarily",
91
+ "title": "Left early — voluntarily",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "The survivor chose to leave before completing the program's intended duration. Honors the canonical survivor self-determination principle per OAC 75:30-3-1(c). Not a judgment / not a failure. outcome_polarity neutral (NOT negative by canonical design), initiator survivor."
96
+ },
97
+ {
98
+ "code": "220-006-000-000-000-000-000",
99
+ "key": "exited_for_safety_survivor_initiated",
100
+ "title": "Exited for safety — survivor-initiated",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "The survivor chose to leave due to safety concerns specific to their situation (perpetrator located them; co-resident conflict; community safety threat). outcome_polarity concerning, initiator survivor. Cascade-eligible: auto-reveals the emergency cascade block (safety plan update + emergency contact notification + destination confidentiality + risk-algo re-evaluation)."
105
+ },
106
+ {
107
+ "code": "220-007-000-000-000-000-000",
108
+ "key": "relocated_geographically",
109
+ "title": "Relocated geographically",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "The survivor moved out of the geographic service area (state/country/region) prior to program completion. Captures geographic transitions that aren't otherwise voluntary withdrawal. outcome_polarity neutral, initiator survivor."
114
+ },
115
+ {
116
+ "code": "220-008-000-000-000-000-000",
117
+ "key": "exited_by_program_behavioral_violation",
118
+ "title": "Exited by program — behavioral violation",
119
+ "selectable": true,
120
+ "parentCode": null,
121
+ "childCodes": [],
122
+ "definition": "The program ended enrollment due to rule violation (Do No Harm Agreement violation, behavioral expectations, attendance requirements). Distinct from exited_by_program_safety_to_others (which captures actual threats/violence/criminal activity). outcome_polarity negative, initiator program."
123
+ },
124
+ {
125
+ "code": "220-009-000-000-000-000-000",
126
+ "key": "exited_by_program_safety_to_others",
127
+ "title": "Exited by program — safety to others",
128
+ "selectable": true,
129
+ "parentCode": null,
130
+ "childCodes": [],
131
+ "definition": "The program ended enrollment because the survivor's behavior posed a safety risk to other residents / staff / participants. Distinct from behavioral_violation (which is rule-based) — this captures actual threats/violence/criminal activity. outcome_polarity negative, initiator program. Cascade-eligible: auto-reveals the emergency cascade block."
132
+ },
133
+ {
134
+ "code": "220-010-000-000-000-000-000",
135
+ "key": "needs_beyond_program_scope",
136
+ "title": "Needs beyond program scope",
137
+ "selectable": true,
138
+ "parentCode": null,
139
+ "childCodes": [],
140
+ "definition": "The program honestly acknowledged it couldn't meet this survivor's needs (medical complexity, behavioral health intensity, specialized services unavailable). Distinct from behavioral_violation — this isn't punitive; likely captures a referral to a better-fit program. outcome_polarity neutral, initiator program."
141
+ },
142
+ {
143
+ "code": "220-011-000-000-000-000-000",
144
+ "key": "health_related_exit",
145
+ "title": "Health-related exit",
146
+ "selectable": true,
147
+ "parentCode": null,
148
+ "childCodes": [],
149
+ "definition": "The survivor exited due to a medical or behavioral-health crisis requiring different placement (hospitalization, long-term care, psychiatric facility). Maps to HMIS Destination codes 20/22/24. outcome_polarity concerning, initiator external_event. Cascade-eligible: health crises warrant emergency contact notification + risk-algo housing-instability re-evaluation at minimum."
150
+ },
151
+ {
152
+ "code": "220-012-000-000-000-000-000",
153
+ "key": "placement_changed_by_authority",
154
+ "title": "Placement changed by authority",
155
+ "selectable": true,
156
+ "parentCode": null,
157
+ "childCodes": [],
158
+ "definition": "An external authority (court, CW system, JJ system, ICE, immigration adjudication, etc.) changed the survivor's placement. outcome_polarity concerning, initiator authority. Cascade-eligible: placement-shifts often warrant safety plan + destination confidentiality updates. For specific deportation events, prefer the dedicated deported code (FN intake reporting requires this distinction)."
159
+ },
160
+ {
161
+ "code": "220-013-000-000-000-000-000",
162
+ "key": "deported",
163
+ "title": "Deported",
164
+ "selectable": true,
165
+ "parentCode": null,
166
+ "childCodes": [],
167
+ "definition": "The survivor was deported during enrollment by an immigration enforcement action (ICE removal, deportation order execution). A specific subset of authority-driven placement change; FN intake reporting requires this distinction be capturable separately from generic placement_changed_by_authority. outcome_polarity concerning, initiator authority. Cascade-eligible. HMIS 3.12 Destination default: DEPORTED_OUTSIDE_US."
168
+ },
169
+ {
170
+ "code": "220-014-000-000-000-000-000",
171
+ "key": "recertification_lapsed",
172
+ "title": "Recertification deadline lapsed",
173
+ "selectable": true,
174
+ "parentCode": null,
175
+ "childCodes": [],
176
+ "definition": "Periodic recertification required by the program was missed and the enrollment auto-closed administratively. Common in programs with recertification cycles (TVAP, RHY, OVC, time-limited federal protections). Not punitive — captures administrative lapse without inferring survivor intent. outcome_polarity neutral, initiator external_event. Gated to funders with periodic recertification cycles (HUD-CoC, HUD-ESG, OVC-ECM, VOCA, FVPSA, OTHER)."
177
+ },
178
+ {
179
+ "code": "220-015-000-000-000-000-000",
180
+ "key": "program_ended",
181
+ "title": "Program ended at this agency",
182
+ "selectable": true,
183
+ "parentCode": null,
184
+ "childCodes": [],
185
+ "definition": "The agency-side program ended — funding cycle closed, agency-internal program discontinued, etc. The survivor wasn't individually exited; the entire program ended. Distinct from recertification_lapsed (per-survivor) and completed_program (per-survivor positive outcome). outcome_polarity neutral_positive, initiator program."
186
+ },
187
+ {
188
+ "code": "220-016-000-000-000-000-000",
189
+ "key": "lost_to_followup",
190
+ "title": "Lost to follow-up",
191
+ "selectable": true,
192
+ "parentCode": null,
193
+ "childCodes": [],
194
+ "definition": "The survivor stopped engaging without formal exit notification. Auto-exit-eligible per HMIS guidance after a community-defined absence threshold (typically 90 days for residential programs). May still be alive and safe. Not punitive — captures disconnection without inferring its cause. outcome_polarity concerning, initiator na. Distinct from auto_exit_no_exit_interview (ES Night-by-Night-specific)."
195
+ },
196
+ {
197
+ "code": "220-017-000-000-000-000-000",
198
+ "key": "auto_exit_no_exit_interview",
199
+ "title": "Auto-exit — no exit interview completed",
200
+ "selectable": true,
201
+ "parentCode": null,
202
+ "childCodes": [],
203
+ "definition": "Canonical HMIS Emergency Shelter Night-by-Night auto-exit semantics. When a survivor in an ES NbN project stops staying without an exit interview, the canonical record stamps this code and auto-defaults HMIS 3.12 Destination to NO_EXIT_INTERVIEW_COMPLETED. outcome_polarity neutral, initiator program. Cascade suppressed. Restricted to ES NbN project type and funders HUD-CoC + HUD-ESG + HHS-RHY."
204
+ },
205
+ {
206
+ "code": "220-018-000-000-000-000-000",
207
+ "key": "deceased",
208
+ "title": "Deceased",
209
+ "selectable": true,
210
+ "parentCode": null,
211
+ "childCodes": [],
212
+ "definition": "The survivor passed away during enrollment. Captured with care; should not appear in routine grant reports beyond mandatory aggregate counts. Specific date and cause are NOT captured in this CVC. outcome_polarity na, initiator external_event. HMIS 3.12 Destination default: DECEASED."
213
+ },
214
+ {
215
+ "code": "220-019-000-000-000-000-000",
216
+ "key": "other",
217
+ "title": "Other (specify)",
218
+ "selectable": true,
219
+ "parentCode": null,
220
+ "childCodes": [],
221
+ "definition": "Escape hatch for scenarios not covered by the canonical codes. Selecting this reveals an exit_reason_other_text free-text input on the modal. Future canonical re-export should sweep accumulated OTHER text and promote common patterns to dedicated codes. outcome_polarity na, initiator na."
222
+ }
223
+ ]
224
+ }
@@ -0,0 +1,71 @@
1
+ {
2
+ "domain": "facial_hair",
3
+ "name": "Facial Hair (Presence)",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering; codes from prototype/data/cvcs/core_facial_hair.yaml; PENDING canonical Notion authoring (PAVE Auditability backlog). Y/N/Unknown 3-state presence CVC backing the Facial Hair (presence) card in Core/Subject Profile; categorical refinement (beard vs mustache vs goatee) is intentionally deferred to a free-text description annex. The prototype YAML already carries the full L0 missingness triplet (ANON/UNK/DNC), mapped here onto the canonical missingness_root structure. IC alignment: Final CVCs/Demographics & Appearance (IC-3)/Physical Description (IC-12).",
6
+ "_source": "prototype/data/cvcs/core_facial_hair.yaml",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Facial hair presence"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "920-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "920-000-000-000-000-000-001",
20
+ "920-000-000-000-000-000-002",
21
+ "920-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Variant: 3-value (unknown, anonymous, data_not_collected). Maps the prototype YAML's L0 triplet: UNK (user-facing 'Unknown' pill) → unknown, ANON (explicit decline / section-level decline toggle) → anonymous, DNC (system-derived, never user-pickable) → data_not_collected."
24
+ },
25
+ {
26
+ "code": "920-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "920-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Facial-hair presence is not currently known. User-facing 'Unknown' pill on the Y/N/Unknown radio group emits this code (the YAML 'UNK' sentinel)."
33
+ },
34
+ {
35
+ "code": "920-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "920-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Subject explicitly declined to answer the facial-hair question, OR the section-level decline-to-answer toggle was activated. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel (the YAML 'ANON' sentinel)."
42
+ },
43
+ {
44
+ "code": "920-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "920-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "System-derived sentinel — the field has not yet been asked. DNC is system-only and never user-pickable (the YAML 'DNC' sentinel)."
51
+ },
52
+ {
53
+ "code": "920-001-000-000-000-000-000",
54
+ "key": "yes",
55
+ "title": "Yes",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Subject has visible facial hair (any kind — beard, mustache, goatee, stubble, etc.). Pair with the facial_hair_description free-text annex for specifics."
60
+ },
61
+ {
62
+ "code": "920-002-000-000-000-000-000",
63
+ "key": "no",
64
+ "title": "No",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Subject does not have facial hair (clean-shaven or never had)."
69
+ }
70
+ ]
71
+ }