@htilabs/platform-common-models 0.9.0 → 0.12.1

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 (174) hide show
  1. package/dist/config/index.cjs +4 -0
  2. package/dist/config/index.cjs.map +1 -1
  3. package/dist/config/index.d.cts +16 -1
  4. package/dist/config/index.d.ts +16 -1
  5. package/dist/config/index.js +2 -0
  6. package/dist/config/index.js.map +1 -1
  7. package/dist/constants/index.cjs +473 -182
  8. package/dist/constants/index.cjs.map +1 -1
  9. package/dist/constants/index.d.cts +1 -1
  10. package/dist/constants/index.d.ts +1 -1
  11. package/dist/constants/index.js +470 -170
  12. package/dist/constants/index.js.map +1 -1
  13. package/dist/cvc-Cp4uWnAa.d.cts +298 -0
  14. package/dist/cvc-Cp4uWnAa.d.ts +298 -0
  15. package/dist/cvcs/index.cjs +21798 -811
  16. package/dist/cvcs/index.cjs.map +1 -1
  17. package/dist/cvcs/index.d.cts +25138 -2212
  18. package/dist/cvcs/index.d.ts +25138 -2212
  19. package/dist/cvcs/index.js +21736 -810
  20. package/dist/cvcs/index.js.map +1 -1
  21. package/dist/enums/index.cjs +4557 -0
  22. package/dist/enums/index.cjs.map +1 -0
  23. package/dist/enums/index.d.cts +5257 -0
  24. package/dist/enums/index.d.ts +5257 -0
  25. package/dist/enums/index.js +4354 -0
  26. package/dist/enums/index.js.map +1 -0
  27. package/dist/index.cjs +24053 -1052
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.cts +5 -3072
  30. package/dist/index.d.ts +5 -3072
  31. package/dist/index.js +23928 -1039
  32. package/dist/index.js.map +1 -1
  33. package/dist/mongo/index.cjs +383 -0
  34. package/dist/mongo/index.cjs.map +1 -0
  35. package/dist/mongo/index.d.cts +221 -0
  36. package/dist/mongo/index.d.ts +221 -0
  37. package/dist/mongo/index.js +351 -0
  38. package/dist/mongo/index.js.map +1 -0
  39. package/dist/{platform-auth-XVB9aHqR.d.cts → platform-auth-Dv5fu0Fh.d.cts} +22 -77
  40. package/dist/{platform-auth-XVB9aHqR.d.ts → platform-auth-Dv5fu0Fh.d.ts} +22 -77
  41. package/dist/schemas/index.cjs +30 -157
  42. package/dist/schemas/index.cjs.map +1 -1
  43. package/dist/schemas/index.js +30 -157
  44. package/dist/schemas/index.js.map +1 -1
  45. package/dist/services/index.cjs +0 -3
  46. package/dist/services/index.cjs.map +1 -1
  47. package/dist/services/index.js +0 -3
  48. package/dist/services/index.js.map +1 -1
  49. package/dist/types/index.d.cts +2 -2
  50. package/dist/types/index.d.ts +2 -2
  51. package/dist/validation/index.cjs +58 -0
  52. package/dist/validation/index.cjs.map +1 -1
  53. package/dist/validation/index.d.cts +82 -283
  54. package/dist/validation/index.d.ts +82 -283
  55. package/dist/validation/index.js +57 -0
  56. package/dist/validation/index.js.map +1 -1
  57. package/package.json +18 -1
  58. package/src/__sot__/README.md +91 -0
  59. package/src/__sot__/coreIndicatorFields.ts +331 -0
  60. package/src/__sot__/coreIndicators.pin.json +2149 -0
  61. package/src/__sot__/cvcIndex.pin.json +272 -0
  62. package/src/__sot__/scoringEmits.pin.json +176 -0
  63. package/src/__tests__/__snapshots__/cvc-sot.snap +260 -40
  64. package/src/__tests__/core-information-scope-invariant.test.ts +134 -0
  65. package/src/__tests__/cvc-136-scoring-invariant.test.ts +328 -0
  66. package/src/__tests__/cvc-181-182-country-parity.test.ts +163 -0
  67. package/src/__tests__/cvc-drift-gate.test.ts +1036 -0
  68. package/src/__tests__/cvc-sot-snapshot.test.ts +191 -18
  69. package/src/__tests__/cvc-status-parser.test.ts +150 -0
  70. package/src/__tests__/cvc-structural.test.ts +70 -1
  71. package/src/__tests__/mongo-verifier.test.ts +502 -0
  72. package/src/config/index.ts +8 -2
  73. package/src/constants/ic.ts +629 -206
  74. package/src/constants/service-catalog.ts +4 -2
  75. package/src/cvcs/activityType.v1.0.0.json +143 -0
  76. package/src/cvcs/adminRoles.v1.0.0.json +153 -0
  77. package/src/cvcs/administeringJurisdiction.v1.0.0.json +40 -40
  78. package/src/cvcs/ageBinReporting.v1.0.0.json +40 -40
  79. package/src/cvcs/assertionDomain.v1.1.0.json +647 -0
  80. package/src/cvcs/assertionStatus.v1.0.0.json +80 -0
  81. package/src/cvcs/carCorrectionReason.v1.0.0.json +89 -0
  82. package/src/cvcs/caseShareState.v1.0.0.json +62 -0
  83. package/src/cvcs/{checkInPhase.v1.0.0.json → checkInPhase.v1.1.0.json} +20 -2
  84. package/src/cvcs/childChangeType.v1.0.0.json +152 -0
  85. package/src/cvcs/citizenship.v1.0.0.json +3062 -0
  86. package/src/cvcs/contactInfoTypes.v1.0.0.json +40 -40
  87. package/src/cvcs/contactLinkType.v1.0.0.json +89 -0
  88. package/src/cvcs/coreDhState.v1.0.0.json +113 -0
  89. package/src/cvcs/coreFunctions.v1.0.0.json +746 -0
  90. package/src/cvcs/coreIndicators.v1.0.0.json +2918 -0
  91. package/src/cvcs/coreInformationScope.v1.0.0.json +1165 -0
  92. package/src/cvcs/coreReferralOutcome.v1.0.0.json +71 -0
  93. package/src/cvcs/countries.v1.0.0.json +3077 -0
  94. package/src/cvcs/createdBySystem.v1.0.0.json +89 -0
  95. package/src/cvcs/criminalOrgCategory.v1.0.0.json +116 -0
  96. package/src/cvcs/determinationHelperCategories.v1.0.0.json +1166 -0
  97. package/src/cvcs/employmentStatus.v1.0.0.json +60 -60
  98. package/src/cvcs/exploitationType.v1.0.0.json +106 -0
  99. package/src/cvcs/facilitatorEntityType.v1.0.0.json +40 -40
  100. package/src/cvcs/highestEducationLevelCompleted.v1.0.0.json +55 -46
  101. package/src/cvcs/hivStatus.v1.0.0.json +71 -0
  102. package/src/cvcs/hmisCurrentLivingSituation.v1.0.0.json +409 -0
  103. package/src/cvcs/hmisRelationshipToHoh.v1.0.0.json +104 -0
  104. package/src/cvcs/homelessStatus.v1.0.0.json +27 -27
  105. package/src/cvcs/housingSubsidyTypes.v1.0.0.json +161 -0
  106. package/src/cvcs/htType.v1.0.0.json +87 -0
  107. package/src/cvcs/identificationStatus.v1.0.0.json +18 -0
  108. package/src/cvcs/immigrationLegalStatusChangeType.v1.0.0.json +143 -0
  109. package/src/cvcs/incarcerationEpisodeType.v1.0.0.json +106 -0
  110. package/src/cvcs/incidentInvolvementRoles.v1.0.0.json +40 -40
  111. package/src/cvcs/incidentParticipationRoles.v1.0.0.json +47 -37
  112. package/src/cvcs/incomeBenefitsSources.v1.0.0.json +31 -2
  113. package/src/cvcs/index.ts +138 -1
  114. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +28 -18
  115. package/src/cvcs/juvenileJusticeInvolvementStatus.v1.0.0.json +32 -32
  116. package/src/cvcs/livingSituation.v1.0.0.json +213 -0
  117. package/src/cvcs/mentalHealthStatus.v1.0.0.json +71 -0
  118. package/src/cvcs/militaryBranch.v1.0.0.json +20 -20
  119. package/src/cvcs/militaryStatus.v1.0.0.json +20 -20
  120. package/src/cvcs/minorAdultStatus.v1.0.0.json +80 -0
  121. package/src/cvcs/nameType.v1.0.0.json +40 -40
  122. package/src/cvcs/needsAssessmentChangeType.v1.0.0.json +134 -0
  123. package/src/cvcs/offenderStatus.v1.0.0.json +40 -40
  124. package/src/cvcs/offenderStatusFamily.v1.0.0.json +36 -36
  125. package/src/cvcs/personRelationships.v1.0.0.json +67 -2
  126. package/src/cvcs/poPetitionBasis.v1.0.0.json +96 -0
  127. package/src/cvcs/poStatus.v1.0.0.json +144 -0
  128. package/src/cvcs/poViolationStatus.v1.0.0.json +76 -0
  129. package/src/cvcs/programEnrollmentChangeType.v1.0.0.json +134 -0
  130. package/src/cvcs/provenanceSourceId.v1.0.0.json +134 -0
  131. package/src/cvcs/radiusBucket.v1.0.0.json +110 -0
  132. package/src/cvcs/recencyBand.v1.0.0.json +104 -39
  133. package/src/cvcs/referralEntityCategory.v1.0.0.json +40 -40
  134. package/src/cvcs/referralOrigin.v1.0.0.json +26 -0
  135. package/src/cvcs/relationshipConcern.v1.0.0.json +123 -0
  136. package/src/cvcs/riskCategory.v1.0.0.json +134 -0
  137. package/src/cvcs/riskIdentificationMilestone.v1.0.0.json +109 -0
  138. package/src/cvcs/riskSeverityBand.v1.0.0.json +139 -0
  139. package/src/cvcs/roiMethod.v1.0.0.json +107 -0
  140. package/src/cvcs/roiScope.v1.0.0.json +296 -0
  141. package/src/cvcs/roiStatus.v1.0.0.json +106 -0
  142. package/src/cvcs/romanticRelationshipChangeType.v1.0.0.json +162 -0
  143. package/src/cvcs/serviceAudience.v1.0.0.json +96 -0
  144. package/src/cvcs/serviceCategories.v1.0.0.json +44 -44
  145. package/src/cvcs/serviceDeliveryChannel.v1.0.0.json +147 -0
  146. package/src/cvcs/serviceMechanisms.v1.0.0.json +36 -36
  147. package/src/cvcs/serviceStates.v1.0.0.json +55 -33
  148. package/src/cvcs/sessionNoteVisibility.v1.0.0.json +80 -0
  149. package/src/cvcs/sessionTemplate.v1.0.0.json +283 -0
  150. package/src/cvcs/sexProviderSubrole.v1.0.0.json +35 -28
  151. package/src/cvcs/sharePurpose.v1.0.0.json +80 -12
  152. package/src/cvcs/smtType.v1.0.0.json +40 -40
  153. package/src/cvcs/sourceCategory.v1.1.0.json +8 -1
  154. package/src/cvcs/sourceInstrument.v1.0.0.json +458 -0
  155. package/src/cvcs/sourceSubtype.v1.1.0.json +36 -0
  156. package/src/cvcs/sourceSystem.v1.0.0.json +203 -0
  157. package/src/cvcs/specialNeedsDisabilities.v1.0.0.json +143 -0
  158. package/src/cvcs/subjectType.v1.0.0.json +80 -0
  159. package/src/cvcs/suggestionSource.v1.0.0.json +71 -0
  160. package/src/cvcs/traffickingRelevantRole.v1.0.0.json +104 -0
  161. package/src/cvcs/userRoles.v1.0.0.json +203 -0
  162. package/src/cvcs/verificationMethod.v1.0.0.json +18 -0
  163. package/src/cvcs/victimAbuseTypes.v1.0.0.json +276 -0
  164. package/src/cvcs/victimStatusFamily.v1.0.0.json +40 -40
  165. package/src/cvcs/whyNots.v1.0.0.json +385 -0
  166. package/src/generated/cvc-enums.ts +2318 -10
  167. package/src/mongo/catalog.ts +65 -0
  168. package/src/mongo/contract.ts +157 -0
  169. package/src/mongo/index.ts +343 -0
  170. package/src/mongo/similarity.ts +133 -0
  171. package/src/mongo/uri.ts +53 -0
  172. package/src/services/cvcRegistryService.ts +1 -1
  173. package/src/validation/cvcStatus.ts +209 -0
  174. package/src/validation/index.ts +1 -0
@@ -1,10 +1,21 @@
1
1
  {
2
2
  "domain": "recency_band",
3
- "name": "Core Recency Band",
3
+ "name": "Core Recency Band (CVC-137)",
4
4
  "version": "1.0.0",
5
5
  "levels": {
6
6
  "0": "Unknown or Missing",
7
- "1": "Recency Band"
7
+ "1": "Recency band"
8
+ },
9
+ "sliceFamilies": {
10
+ "hmis_dv": ["w3m", "m3_6", "m6_12", "y1p"],
11
+ "unified_intake": ["w3m", "m3_6", "m6_12", "y1_3", "y3_10", "y10p"],
12
+ "long_horizon": ["ylt3", "y3_10", "y10p"],
13
+ "missingness": ["unknown", "data_not_collected", "anonymous"]
14
+ },
15
+ "hmisCollapse": {
16
+ "y1_3": "y1p",
17
+ "y3_10": "y1p",
18
+ "y10p": "y1p"
8
19
  },
9
20
  "entries": [
10
21
  {
@@ -16,10 +27,12 @@
16
27
  "childCodes": [
17
28
  "137-000-000-000-000-000-001",
18
29
  "137-000-000-000-000-000-002",
19
- "137-000-000-000-000-000-003",
20
- "137-000-000-000-000-000-004"
30
+ "137-000-000-000-000-000-003"
21
31
  ],
22
- "definition": "Root group for values indicating absent, withheld, or uncollected data."
32
+ "definition": "Root group for values indicating absent, withheld, or uncollected data.",
33
+ "canonicalCode": null,
34
+ "temporalAnchor": "none",
35
+ "families": ["missingness"]
23
36
  },
24
37
  {
25
38
  "code": "137-000-000-000-000-000-001",
@@ -28,7 +41,10 @@
28
41
  "selectable": true,
29
42
  "parentCode": "137-000-000-000-000-000-000",
30
43
  "childCodes": [],
31
- "definition": "Value is unknown at time of entry."
44
+ "definition": "The recency band is unknown or cannot be determined from the available information. Not derivable to a date window.",
45
+ "canonicalCode": "UNK",
46
+ "temporalAnchor": "none",
47
+ "families": ["missingness"]
32
48
  },
33
49
  {
34
50
  "code": "137-000-000-000-000-000-002",
@@ -37,7 +53,10 @@
37
53
  "selectable": true,
38
54
  "parentCode": "137-000-000-000-000-000-000",
39
55
  "childCodes": [],
40
- "definition": "Value is intentionally withheld or redacted."
56
+ "definition": "The recency band may be withheld by preference or due to redaction; identity is anonymous or redacted. Not derivable to a date window.",
57
+ "canonicalCode": "ANON",
58
+ "temporalAnchor": "none",
59
+ "families": ["missingness"]
41
60
  },
42
61
  {
43
62
  "code": "137-000-000-000-000-000-003",
@@ -46,79 +65,125 @@
46
65
  "selectable": true,
47
66
  "parentCode": "137-000-000-000-000-000-000",
48
67
  "childCodes": [],
49
- "definition": "No attempt was made to collect the value."
50
- },
51
- {
52
- "code": "137-000-000-000-000-000-004",
53
- "key": "prefer_not_to_answer",
54
- "title": "Client prefers not to answer",
55
- "selectable": true,
56
- "parentCode": "137-000-000-000-000-000-000",
57
- "childCodes": [],
58
- "definition": "Client was offered the opportunity to self-identify and explicitly declined to provide the value."
68
+ "definition": "No attempt was made to collect the recency band. Not derivable to a date window.",
69
+ "canonicalCode": "DNC",
70
+ "temporalAnchor": "none",
71
+ "families": ["missingness"]
59
72
  },
60
73
  {
61
74
  "code": "137-001-000-000-000-000-000",
62
- "key": "less_than_3_years",
63
- "title": "Less than 3 years ago",
75
+ "key": "w3m",
76
+ "title": "Within past 3 months",
64
77
  "selectable": true,
65
78
  "parentCode": null,
66
79
  "childCodes": [],
67
- "definition": "The asserted event occurred less than 3 years ago."
80
+ "definition": "The event or condition occurred within the past 3 months, relative to time_as_of. Both window edges are firm (temporalAnchor: bounded).",
81
+ "canonicalCode": "W3M",
82
+ "temporalAnchor": "bounded",
83
+ "families": ["hmis_dv", "unified_intake"]
68
84
  },
69
85
  {
70
86
  "code": "137-002-000-000-000-000-000",
71
- "key": "months_3_to_6",
72
- "title": "3-6 months ago",
87
+ "key": "m3_6",
88
+ "title": "3–6 months ago",
73
89
  "selectable": true,
74
90
  "parentCode": null,
75
91
  "childCodes": [],
76
- "definition": "The asserted event occurred between 3 and 6 months ago."
92
+ "definition": "The event or condition occurred 3 to 6 months before time_as_of. Both window edges are firm (temporalAnchor: bounded).",
93
+ "canonicalCode": "M3_6",
94
+ "temporalAnchor": "bounded",
95
+ "families": ["hmis_dv", "unified_intake"]
77
96
  },
78
97
  {
79
98
  "code": "137-003-000-000-000-000-000",
80
- "key": "months_6_to_12",
81
- "title": "6-12 months ago",
99
+ "key": "m6_12",
100
+ "title": "6–12 months ago",
82
101
  "selectable": true,
83
102
  "parentCode": null,
84
103
  "childCodes": [],
85
- "definition": "The asserted event occurred between 6 and 12 months ago."
104
+ "definition": "The event or condition occurred 6 to 12 months before time_as_of. Both window edges are firm (temporalAnchor: bounded).",
105
+ "canonicalCode": "M6_12",
106
+ "temporalAnchor": "bounded",
107
+ "families": ["hmis_dv", "unified_intake"]
86
108
  },
87
109
  {
88
110
  "code": "137-004-000-000-000-000-000",
89
- "key": "one_year_or_more",
90
- "title": "One year or more",
111
+ "key": "y1p",
112
+ "title": "1+ years ago",
91
113
  "selectable": true,
92
114
  "parentCode": null,
93
115
  "childCodes": [],
94
- "definition": "The asserted event occurred one year or more ago (without further granularity)."
116
+ "definition": "The event or condition occurred 1 or more years before time_as_of. Only the recent edge is firm (temporalAnchor: upper_only) — yields an upper-bounded age range. HMIS 4.11 DV-mappable terminal bucket; the unified_intake bands y1_3 / y3_10 / y10p collapse into this one for HMIS export.",
117
+ "canonicalCode": "Y1P",
118
+ "temporalAnchor": "upper_only",
119
+ "families": ["hmis_dv"]
95
120
  },
96
121
  {
97
122
  "code": "137-005-000-000-000-000-000",
98
- "key": "ten_plus_years",
99
- "title": "10+ years ago",
123
+ "key": "y1_3",
124
+ "title": "1–3 years ago",
100
125
  "selectable": true,
101
126
  "parentCode": null,
102
127
  "childCodes": [],
103
- "definition": "The asserted event occurred 10 or more years ago."
128
+ "definition": "The event or condition occurred 1 to 3 years before time_as_of. Both window edges are firm (temporalAnchor: bounded). NET-NEW in 0.8.13 — had no equivalent in the pre-0.8.13 6-slug key system.",
129
+ "canonicalCode": "Y1_3",
130
+ "temporalAnchor": "bounded",
131
+ "families": ["unified_intake"]
104
132
  },
105
133
  {
106
134
  "code": "137-006-000-000-000-000-000",
107
- "key": "within_3_months",
108
- "title": "Within past 3 months",
135
+ "key": "y3_10",
136
+ "title": "3–10 years ago",
109
137
  "selectable": true,
110
138
  "parentCode": null,
111
139
  "childCodes": [],
112
- "definition": "The asserted event occurred within the past 3 months."
140
+ "definition": "The event or condition occurred 3 to 10 years before time_as_of. Both window edges are firm (temporalAnchor: bounded).",
141
+ "canonicalCode": "Y3_10",
142
+ "temporalAnchor": "bounded",
143
+ "families": ["unified_intake", "long_horizon"]
113
144
  },
114
145
  {
115
146
  "code": "137-007-000-000-000-000-000",
116
- "key": "years_3_to_10",
117
- "title": "3-10 years ago",
147
+ "key": "y10p",
148
+ "title": "10+ years ago",
149
+ "selectable": true,
150
+ "parentCode": null,
151
+ "childCodes": [],
152
+ "definition": "The event or condition occurred 10 or more years before time_as_of. Only the recent edge is firm (temporalAnchor: upper_only) — yields an upper-bounded age range.",
153
+ "canonicalCode": "Y10P",
154
+ "temporalAnchor": "upper_only",
155
+ "families": ["unified_intake", "long_horizon"]
156
+ },
157
+ {
158
+ "code": "137-008-000-000-000-000-000",
159
+ "key": "ylt3",
160
+ "title": "Less than 3 years ago",
118
161
  "selectable": true,
119
162
  "parentCode": null,
120
163
  "childCodes": [],
121
- "definition": "The asserted event occurred between 3 and 10 years ago."
164
+ "definition": "The event or condition occurred less than 3 years before time_as_of. Both window edges are firm (temporalAnchor: bounded). NET-NEW in 0.8.13. NOT the same concept as y1p (`1+ years ago`) — ylt3 is a long_horizon-family band used by trafficking-last-experience instruments (e.g. TRA-43 → VIII-F), and the two bands OVERLAP rather than partition. Never mix families in one question.",
165
+ "canonicalCode": "YLT3",
166
+ "temporalAnchor": "bounded",
167
+ "families": ["long_horizon"]
122
168
  }
123
- ]
169
+ ],
170
+ "_status": {
171
+ "vocabStatus": "canonical",
172
+ "authoredBy": "platform-common 0.8.13",
173
+ "evidence": "prototype@a596eb9 data/cvcs/core_recency_band.yaml (cvc_ref: CVC-137, vocab_status: canonical, aligned 2026-07-01 per Crysta go-ahead; upstream_authority: Final CVCs/Assertion Contract/recency_band.md, 'Ready for dev'). CVC_INDEX.md:124 confirms recency_band = CVC-137.",
174
+ "changeInThisRelease": "KEY-SYSTEM ADOPTION. 0.8.13's first pass corrected the NUMBER only (provisional CVC-232 -> canonical CVC-137) and kept 6 semantic slugs. This pass adopts the canonical 8-band key system verbatim. Codes/labels/temporal anchors/slice families are carried from the yaml; keys are the lowercase transliteration of the canonical codes (CVC keys must match /^[a-z][a-z0-9_]*$/), with the canonical code carried verbatim in `canonicalCode` — the same pattern used for risk_severity_band (risk-1 -> risk_1).",
175
+ "keyMigration": {
176
+ "within_3_months": "w3m (W3M)",
177
+ "months_3_to_6": "m3_6 (M3_6)",
178
+ "months_6_to_12": "m6_12 (M6_12)",
179
+ "one_year_or_more": "y1p (Y1P)",
180
+ "years_3_to_10": "y3_10 (Y3_10)",
181
+ "ten_plus_years": "y10p (Y10P)"
182
+ },
183
+ "orphanedConsumerKeys": "NONE. All 6 pre-0.8.13 keys map 1:1 onto a canonical band. The change is additive in cardinality: +y1_3 (Y1_3, '1-3 years ago') and +ylt3 (YLT3, 'less than 3 years ago') are net-new and had no pre-0.8.13 equivalent. No consumer key is left without a canonical home.",
184
+ "semanticWarning": "y1p and ylt3 are NOT the same concept and are NOT interchangeable. y1p = '1+ years ago' (hmis_dv family, upper_only). ylt3 = 'less than 3 years ago' (long_horizon family, bounded). They overlap rather than partition. MUTUAL EXCLUSIVITY RULE (canonical): choose ONE slice family per question/instrument; never mix bands across families. hmisCollapse maps the unified_intake long bands onto y1p for HMIS 4.11 export.",
185
+ "upstreamReconciliation": "None required for the vocabulary itself — this is a verbatim adoption of an upstream `vocab_status: canonical` yaml. Crysta need only confirm that the lowercase key transliteration (w3m/m3_6/.../ylt3) is acceptable as the platform-side key, given the canonical uppercase codes are preserved in `canonicalCode`.",
186
+ "consumerRebind": "pave-2.0 packages/domain/src/cvc/cvcKeys.ts -> RecencyBandKeys: 6 keys -> 8, all 6 old keys renamed per keyMigration. Any surface that binds a recency radio must also pick its slice family."
187
+ },
188
+ "_source": "htilabstech/prototype@a596eb9 data/cvcs/core_recency_band.yaml (CVC-137, vocab_status: canonical) + Final CVCs/Assertion Contract/recency_band.md"
124
189
  }
@@ -9,6 +9,46 @@
9
9
  "3": "Variant"
10
10
  },
11
11
  "entries": [
12
+ {
13
+ "code": "048-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
+ "048-000-000-000-000-000-001",
20
+ "048-000-000-000-000-000-002",
21
+ "048-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "048-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "048-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Value is unknown at time of entry."
33
+ },
34
+ {
35
+ "code": "048-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous",
38
+ "selectable": true,
39
+ "parentCode": "048-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld or redacted."
42
+ },
43
+ {
44
+ "code": "048-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "048-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
12
52
  {
13
53
  "code": "048-001-000-000-000-000-000",
14
54
  "key": "self_referred",
@@ -394,46 +434,6 @@
394
434
  "parentCode": "048-013-000-000-000-000-000",
395
435
  "childCodes": [],
396
436
  "definition": "Other organization not otherwise captured by the listed categories."
397
- },
398
- {
399
- "code": "048-000-000-000-000-000-000",
400
- "key": "missingness_root",
401
- "title": "Unknown, Redacted, or Missing",
402
- "selectable": false,
403
- "parentCode": null,
404
- "childCodes": [
405
- "048-000-000-000-000-000-001",
406
- "048-000-000-000-000-000-002",
407
- "048-000-000-000-000-000-003"
408
- ],
409
- "definition": "Root group for values indicating absent, withheld, or uncollected data."
410
- },
411
- {
412
- "code": "048-000-000-000-000-000-001",
413
- "key": "unknown",
414
- "title": "Unknown",
415
- "selectable": true,
416
- "parentCode": "048-000-000-000-000-000-000",
417
- "childCodes": [],
418
- "definition": "Value is unknown at time of entry."
419
- },
420
- {
421
- "code": "048-000-000-000-000-000-002",
422
- "key": "anonymous",
423
- "title": "Anonymous",
424
- "selectable": true,
425
- "parentCode": "048-000-000-000-000-000-000",
426
- "childCodes": [],
427
- "definition": "Value is intentionally withheld or redacted."
428
- },
429
- {
430
- "code": "048-000-000-000-000-000-003",
431
- "key": "data_not_collected",
432
- "title": "Data not collected",
433
- "selectable": true,
434
- "parentCode": "048-000-000-000-000-000-000",
435
- "childCodes": [],
436
- "definition": "No attempt was made to collect the value."
437
437
  }
438
438
  ]
439
439
  }
@@ -0,0 +1,26 @@
1
+ {
2
+ "domain": "referral_origin",
3
+ "name": "Core Referral Origin",
4
+ "version": "1.0.0",
5
+ "levels": { "1": "Origin" },
6
+ "entries": [
7
+ {
8
+ "code": "909-001-000-000-000-000-000",
9
+ "key": "internal",
10
+ "title": "Internal",
11
+ "selectable": true,
12
+ "parentCode": null,
13
+ "childCodes": [],
14
+ "definition": "A referral whose sending and receiving parties sit within the same agency or account boundary, so completing it involves no disclosure of client information across an organizational boundary."
15
+ },
16
+ {
17
+ "code": "909-002-000-000-000-000-000",
18
+ "key": "external",
19
+ "title": "External",
20
+ "selectable": true,
21
+ "parentCode": null,
22
+ "childCodes": [],
23
+ "definition": "A referral whose receiving party is a different agency, making acceptance a cross-agency disclosure of client information. Where an implementation cannot positively determine the origin, it must treat the referral as external, so that the stronger disclosure controls apply by default rather than the weaker ones."
24
+ }
25
+ ]
26
+ }
@@ -0,0 +1,123 @@
1
+ {
2
+ "domain": "relationship_concern",
3
+ "name": "Core Relationship Concern (PROVISIONAL CVC-991 — pending codebook ratification)",
4
+ "version": "1.1.0",
5
+ "_status": {
6
+ "vocabStatus": "provisional-pending-notion-ratification",
7
+ "authoredBy": "platform-common 0.8.1 (`feature/cvc-author-missing-domains`), originally minted at provisional CVC-231. RENUMBERED 231 -> 991 engineer-direct on 2026-08-29 (ships in the next release).",
8
+ "renumber": "RENUMBERED FROM PROVISIONAL 231 ON CVC-231'S RATIFICATION TO THE DETERMINATION HELPER CATEGORIES, 2026-08-28 (Jevon). 231 was never this vocabulary's number — it was a provisional mint taken from the CANONICAL block (<900) at a time when `CVC_INDEX.md` carried no row for it, which is why this domain sat in the drift gate's `INDEX_ABSENT` list rather than in `CANONICAL_BINDING`. With 231 now ratified to the Determination Helper categories, holding it here would be a SQUAT in the exact sense GATE C describes: a wrong number does not merely mislabel the squatter, it makes the slot look occupied and thereby hides the absence of the domain that owns it (`housing_subsidy_types` on CVC-233 is the precedent that cost us `core-DH_state` entirely). Vacating 231 now, BEFORE the next `cvcIndex` pin refresh publishes the DH row, keeps that failure mode from ever arming. This domain has no canonical number of its own, so it moves to the provisional 900-block — the sanctioned escape hatch — rather than to another canonical number.",
9
+ "numberChoice": "991 = the next number above the highest provisional in use (990 `criminal_org_category`). The 900-block gaps below it are NOT free-for-reuse: 930 is claimed by the open `codebook-bridge/proposals/evidence_tier.v1.0.0.json`, and 964 / 981 are VACATED numbers (`assertion_domain` renumbered 964 -> canonical 159; `risk_band` withdrawn at 981 in favour of canonical CVC-238) which the house has deliberately left as historical gaps rather than recycled — the same stable-ordinal discipline `assertionDomain._status` states for its segment-2 gaps. 991 itself was briefly held by `core_information_scope` on the `feat/cvc-236-information-scope` branch and released within that same PR (f9a71b3, \"number core_information_scope at its canonical 236, not provisional 991\"); it never shipped in any release, so it is clean. Verified collision-free against every `src/cvcs/*.json`, `codebook-bridge/proposals/*.json`, and `cvcIndex.pin.json` (which carries no row for 231, 990, 991 or 992).",
10
+ "consumerImpact": "NONE at the type level. Consumers persist KEYS, not wire codes: PAVE binds this domain as `RELATIONSHIP_CONCERNS_KEYS = keysExceptRoot(RelationshipConcernKeys)` and every downstream `z.enum(...)` / Mongoose enum is over those keys. A repo-wide grep of pave-2.0 finds ZERO occurrences of a `\"231-...\"` positional code; the numeral appears only in prose comments and ADR text. Only the generated map VALUES change (`231-*` -> `991-*`) — the key identifiers and TypeScript types are unchanged. Regenerate `src/generated/cvc-enums.ts` (`npm run codegen:cvc`). No production data exists.",
11
+ "ordinals": "Segment-2 ordinals are preserved verbatim across the renumber (001..007 substantive, 000-000-001/002/003 missingness), so the diff is a pure prefix substitution and stays reviewable.",
12
+ "upstreamReconciliation": "Two things. (1) Notion must author this vocabulary and assign it a canonical number, at which point it renumbers out of the 900-block the way `assertion_domain` (964 -> 159) and `core_information_scope` (991 -> 236) did. (2) The Determination Helper categories now own CVC-231 and are NOT authored in platform-common at all — the same gap-behind-a-squat this renumber exists to expose. Authoring them at 231 is a separate item."
13
+ },
14
+ "levels": {
15
+ "0": "Unknown or Missing",
16
+ "1": "Relationship concern"
17
+ },
18
+ "entries": [
19
+ {
20
+ "code": "991-000-000-000-000-000-000",
21
+ "key": "missingness_root",
22
+ "title": "Unknown, Redacted, or Missing",
23
+ "selectable": false,
24
+ "parentCode": null,
25
+ "childCodes": [
26
+ "991-000-000-000-000-000-001",
27
+ "991-000-000-000-000-000-002",
28
+ "991-000-000-000-000-000-003"
29
+ ],
30
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
31
+ },
32
+ {
33
+ "code": "991-000-000-000-000-000-001",
34
+ "key": "unknown",
35
+ "title": "Unknown",
36
+ "selectable": true,
37
+ "parentCode": "991-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "The relationship concern is unknown or cannot be determined from the available information."
40
+ },
41
+ {
42
+ "code": "991-000-000-000-000-000-002",
43
+ "key": "anonymous",
44
+ "title": "Anonymous / declined to answer",
45
+ "selectable": true,
46
+ "parentCode": "991-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "The relationship concern may be withheld by preference or due to redaction; identity is anonymous or redacted."
49
+ },
50
+ {
51
+ "code": "991-000-000-000-000-000-003",
52
+ "key": "data_not_collected",
53
+ "title": "Data not collected",
54
+ "selectable": true,
55
+ "parentCode": "991-000-000-000-000-000-000",
56
+ "childCodes": [],
57
+ "definition": "No attempt was made to collect the relationship concern."
58
+ },
59
+ {
60
+ "code": "991-001-000-000-000-000-000",
61
+ "key": "appears_controlling",
62
+ "title": "Appears controlling",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "Employer, intimate partner, or family member who appears controlling in relation to the subject."
67
+ },
68
+ {
69
+ "code": "991-002-000-000-000-000-000",
70
+ "key": "is_much_older",
71
+ "title": "Is much older (age-disparate)",
72
+ "selectable": true,
73
+ "parentCode": null,
74
+ "childCodes": [],
75
+ "definition": "Significant age disparity in the relationship — a vulnerability signal, especially for youth."
76
+ },
77
+ {
78
+ "code": "991-003-000-000-000-000-000",
79
+ "key": "physically_abusive",
80
+ "title": "Physically abusive",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "Reports of physical harm or abuse from this person toward the subject."
85
+ },
86
+ {
87
+ "code": "991-004-000-000-000-000-000",
88
+ "key": "emotionally_abusive",
89
+ "title": "Emotionally abusive / threatening",
90
+ "selectable": true,
91
+ "parentCode": null,
92
+ "childCodes": [],
93
+ "definition": "Emotional abuse, threats, or intimidation by this person toward the subject."
94
+ },
95
+ {
96
+ "code": "991-005-000-000-000-000-000",
97
+ "key": "has_legal_involvement",
98
+ "title": "Has relevant legal involvement",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "This person has a legal case, protective order, or criminal history relevant to the subject's situation."
103
+ },
104
+ {
105
+ "code": "991-006-000-000-000-000-000",
106
+ "key": "is_known_trafficker_or_suspect",
107
+ "title": "Is known or suspected trafficker",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "This person is suspected or confirmed as a trafficker in relation to the subject. Complements (does not replace) role assignment via Add-Person."
112
+ },
113
+ {
114
+ "code": "991-007-000-000-000-000-000",
115
+ "key": "other_concern",
116
+ "title": "Other concern",
117
+ "selectable": true,
118
+ "parentCode": null,
119
+ "childCodes": [],
120
+ "definition": "Catch-all for concerns not covered by the other codes. Requires accompanying free-text explanation; prefer a specific code whenever one applies."
121
+ }
122
+ ]
123
+ }
@@ -0,0 +1,134 @@
1
+ {
2
+ "domain": "risk_category",
3
+ "name": "Risk Category",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering; codes/labels sourced verbatim from @hti/scoring (declared SOT) weights/risk.weights.json @ 9b5d654; NAMES ONLY per ADR-CONTRACT-scoring-vocab-model-boundary (weights/cutoffs/leaf-scales stay in @hti/scoring). PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "htilabstech/hti-scoring@9b5d654 weights/risk.weights.json",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Risk assessment category"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "980-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
+ "980-000-000-000-000-000-001",
20
+ "980-000-000-000-000-000-002",
21
+ "980-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) under the workspace standard ANON semantic. The @hti/scoring artifact enumerates only the substantive values, so the triplet is added per SOT convention."
24
+ },
25
+ {
26
+ "code": "980-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "980-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Risk category is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "980-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "980-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": "980-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "980-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value. System-only sentinel per GLOBAL_DESIGN_RULES."
51
+ },
52
+ {
53
+ "code": "980-001-000-000-000-000-000",
54
+ "key": "cat_i",
55
+ "title": "Qualifying Activity?",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Canonical @hti/scoring category id: `I`. Gating question: is this person engaged in a qualifying activity — a commercial sex act (18 U.S.C. § 1591(e)(3)) or labor/services performed for another's benefit (18 U.S.C. § 1589) — at the time of assessment? Treated as a boolean, not a 0–10 score. We treat 'yes' as confirmed if any source is at disclosed-or-better strength. Descriptive, per CVC-231 § II: activity coding answers 'what happened?', not 'does this legally equal trafficking?'. Why it matters: A confirmed 'yes' is what makes every other row on this page trafficking-relevant. Without it, the same signals describe something else. The arm that confirmed it (commercial sex vs labor/services) is shown on the gate read. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
60
+ },
61
+ {
62
+ "code": "980-002-000-000-000-000-000",
63
+ "key": "cat_ii",
64
+ "title": "Lack of Ability to Legally Consent",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Canonical @hti/scoring category id: `II`. Captures factors that compromise the person's capacity to legally consent to commercial sex: minor age, substance dependence, cognitive disability, active mental health crisis. Why it matters: If a person can't legally consent — because they're a minor or have impaired capacity — commercial sex transactions involving them are trafficking by definition, regardless of other evidence. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
69
+ },
70
+ {
71
+ "code": "980-003-000-000-000-000-000",
72
+ "key": "cat_iii",
73
+ "title": "Entry / Recruitment",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Canonical @hti/scoring category id: `III`. What we know about how the person first entered the qualifying activity — the commercial sex industry (§ 1591) or the compelled labor/services arrangement (§ 1589): age at entry, recruitment pathway, migration/recruitment debt, survival-driven start. Why it matters: Entry as a minor, entry driven by deception, recruitment, or debt, or entry out of survival — any of these means the activity started on coercive or exploitative footing, whichever arm it belongs to. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
78
+ },
79
+ {
80
+ "code": "980-004-000-000-000-000-000",
81
+ "key": "cat_iv",
82
+ "title": "Lack of Autonomy",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Canonical @hti/scoring category id: `IV`. The likelihood of third-party involvement (manager, recruiter, other facilitator) and the severity of that involvement. Includes not being in control of your documents, schedule, or who you see. Why it matters: Signals that someone else controls the work — shared phones, third-party posting, fixed schedules — are how trafficking tends to look in practice. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
87
+ },
88
+ {
89
+ "code": "980-005-000-000-000-000-000",
90
+ "key": "cat_v",
91
+ "title": "Fraud & financial exploitation",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Canonical @hti/scoring category id: `V`. Whether the person has been misled, lied to, or financially exploited by someone benefiting from their being in the industry. How much of their pay do they keep? Does that match what was promised? Why it matters: Withheld earnings, debt bondage, and broken promises about pay are core trafficking mechanisms — they're how 'I'll work for a while' becomes 'I can't leave'. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
96
+ },
97
+ {
98
+ "code": "980-006-000-000-000-000-000",
99
+ "key": "cat_vi",
100
+ "title": "Concerning working conditions",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "Canonical @hti/scoring category id: `VI`. Features of the work environment and advertisements that correlate with exploitation: availability patterns, dangerous services, price anomalies, substance references, outcall-only arrangements. Why it matters: Exploitative or dangerous conditions — always-available, dangerous services, quota-driven, substance-involved — predict vulnerability, whether through trafficking or survival-driven work. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
105
+ },
106
+ {
107
+ "code": "980-007-000-000-000-000-000",
108
+ "key": "cat_vii",
109
+ "title": "Constrained ability to exit",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "Canonical @hti/scoring category id: `VII`. Barriers to leaving: abusive or controlling relationships, withheld identification, dependence on the income for survival, threats, criminal records used as leverage, isolation from support. Why it matters: The harder it is for someone to walk away, the more exploitable they are — abusive relationships, lost ID, survival dependence. This is what 'coercion' looks like operationally. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
114
+ },
115
+ {
116
+ "code": "980-008-000-000-000-000-000",
117
+ "key": "cat_viii",
118
+ "title": "General Vulnerabilities",
119
+ "selectable": true,
120
+ "parentCode": null,
121
+ "childCodes": [],
122
+ "definition": "Canonical @hti/scoring category id: `VIII`. Background vulnerabilities that traffickers often take advantage of: prior traumas, behavioral/health risks, length of time in the industry, social isolation, economic hardship, LGBTQ+ status, age. Why it matters: Homelessness, isolation, prior trauma, and economic hardship are the background conditions traffickers look for and leverage. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
123
+ },
124
+ {
125
+ "code": "980-009-000-000-000-000-000",
126
+ "key": "cat_ix",
127
+ "title": "Network characteristics",
128
+ "selectable": true,
129
+ "parentCode": null,
130
+ "childCodes": [],
131
+ "definition": "Canonical @hti/scoring category id: `IX`. Structural properties of the social and ad network around the person: shared identifiers across many providers, proximity to known facilitators, geographic clustering. Why it matters: If a person was a trafficker in one situation, others connected to them are at higher risk. A person's network — who they share contacts, ads, or geography with — moves their score. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
132
+ }
133
+ ]
134
+ }