@htilabs/platform-common-models 0.8.12 → 0.8.14

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 (130) hide show
  1. package/README.md +44 -0
  2. package/dist/config/index.cjs +4 -0
  3. package/dist/config/index.cjs.map +1 -1
  4. package/dist/config/index.d.cts +16 -1
  5. package/dist/config/index.d.ts +16 -1
  6. package/dist/config/index.js +2 -0
  7. package/dist/config/index.js.map +1 -1
  8. package/dist/constants/index.cjs +143 -287
  9. package/dist/constants/index.cjs.map +1 -1
  10. package/dist/constants/index.d.cts +1 -1
  11. package/dist/constants/index.d.ts +1 -1
  12. package/dist/constants/index.js +143 -275
  13. package/dist/constants/index.js.map +1 -1
  14. package/dist/cvcs/index.cjs +12173 -969
  15. package/dist/cvcs/index.cjs.map +1 -1
  16. package/dist/cvcs/index.d.cts +14927 -2662
  17. package/dist/cvcs/index.d.ts +14927 -2662
  18. package/dist/cvcs/index.js +12141 -968
  19. package/dist/cvcs/index.js.map +1 -1
  20. package/dist/{index-I-DiX9eQ.d.ts → index-CDoqrfc1.d.ts} +1 -1
  21. package/dist/{index-CoVr1jIV.d.cts → index-Zu_mOJRn.d.cts} +1 -1
  22. package/dist/index.cjs +13297 -1361
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.d.cts +1118 -130
  25. package/dist/index.d.ts +1118 -130
  26. package/dist/index.js +13239 -1346
  27. package/dist/index.js.map +1 -1
  28. package/dist/models/index.d.cts +2 -2
  29. package/dist/models/index.d.ts +2 -2
  30. package/dist/mongo/index.cjs +383 -0
  31. package/dist/mongo/index.cjs.map +1 -0
  32. package/dist/mongo/index.d.cts +221 -0
  33. package/dist/mongo/index.d.ts +221 -0
  34. package/dist/mongo/index.js +351 -0
  35. package/dist/mongo/index.js.map +1 -0
  36. package/dist/{platform-auth-BwfZ0bxU.d.cts → platform-auth-AsfnIXfK.d.cts} +2 -74
  37. package/dist/{platform-auth-BwfZ0bxU.d.ts → platform-auth-AsfnIXfK.d.ts} +2 -74
  38. package/dist/schemas/index.cjs +5 -153
  39. package/dist/schemas/index.cjs.map +1 -1
  40. package/dist/schemas/index.d.cts +29 -25
  41. package/dist/schemas/index.d.ts +29 -25
  42. package/dist/schemas/index.js +5 -153
  43. package/dist/schemas/index.js.map +1 -1
  44. package/dist/services/index.cjs +0 -3
  45. package/dist/services/index.cjs.map +1 -1
  46. package/dist/services/index.js +0 -3
  47. package/dist/services/index.js.map +1 -1
  48. package/dist/types/index.d.cts +2 -2
  49. package/dist/types/index.d.ts +2 -2
  50. package/package.json +13 -1
  51. package/src/__sot__/README.md +56 -0
  52. package/src/__sot__/coreIndicators.pin.json +220 -0
  53. package/src/__sot__/cvcIndex.pin.json +268 -0
  54. package/src/__sot__/scoringEmits.pin.json +176 -0
  55. package/src/__tests__/__snapshots__/cvc-sot.snap +125 -37
  56. package/src/__tests__/cvc-136-scoring-invariant.test.ts +326 -0
  57. package/src/__tests__/cvc-drift-gate.test.ts +607 -0
  58. package/src/__tests__/cvc-sot-snapshot.test.ts +50 -8
  59. package/src/__tests__/cvc-structural.test.ts +43 -1
  60. package/src/__tests__/mongo-verifier.test.ts +502 -0
  61. package/src/config/index.ts +8 -2
  62. package/src/constants/ic.ts +213 -333
  63. package/src/constants/service-catalog.ts +4 -2
  64. package/src/cvcs/adminRoles.v1.0.0.json +153 -0
  65. package/src/cvcs/administeringJurisdiction.v1.0.0.json +40 -40
  66. package/src/cvcs/ageBinReporting.v1.0.0.json +40 -40
  67. package/src/cvcs/assertionDomain.v1.1.0.json +78 -105
  68. package/src/cvcs/assertionStatus.v1.0.0.json +80 -0
  69. package/src/cvcs/citizenship.v1.0.0.json +3062 -0
  70. package/src/cvcs/contactInfoTypes.v1.0.0.json +40 -40
  71. package/src/cvcs/coreDhState.v1.0.0.json +113 -0
  72. package/src/cvcs/coreIndicators.v1.0.0.json +2905 -0
  73. package/src/cvcs/createdBySystem.v1.0.0.json +89 -0
  74. package/src/cvcs/employmentStatus.v1.0.0.json +60 -60
  75. package/src/cvcs/exploitationType.v1.0.0.json +106 -0
  76. package/src/cvcs/facilitatorEntityType.v1.0.0.json +40 -40
  77. package/src/cvcs/highestEducationLevelCompleted.v1.0.0.json +50 -50
  78. package/src/cvcs/hmisCurrentLivingSituation.v1.0.0.json +409 -0
  79. package/src/cvcs/hmisSex.v1.0.0.json +89 -0
  80. package/src/cvcs/homelessStatus.v1.0.0.json +27 -27
  81. package/src/cvcs/housingSubsidyTypes.v1.0.0.json +26 -24
  82. package/src/cvcs/incarcerationEpisodeType.v1.0.0.json +106 -0
  83. package/src/cvcs/incidentInvolvementRoles.v1.0.0.json +40 -40
  84. package/src/cvcs/incidentParticipationRoles.v1.0.0.json +40 -40
  85. package/src/cvcs/index.ts +73 -2
  86. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +106 -0
  87. package/src/cvcs/juvenileJusticeInvolvementStatus.v1.0.0.json +32 -32
  88. package/src/cvcs/militaryBranch.v1.0.0.json +20 -20
  89. package/src/cvcs/militaryStatus.v1.0.0.json +20 -20
  90. package/src/cvcs/minorAdultStatus.v1.0.0.json +80 -0
  91. package/src/cvcs/nameType.v1.0.0.json +40 -40
  92. package/src/cvcs/offenderStatus.v1.0.0.json +40 -40
  93. package/src/cvcs/offenderStatusFamily.v1.0.0.json +36 -36
  94. package/src/cvcs/poPetitionBasis.v1.0.0.json +96 -0
  95. package/src/cvcs/poStatus.v1.0.0.json +144 -0
  96. package/src/cvcs/poViolationStatus.v1.0.0.json +76 -0
  97. package/src/cvcs/radiusBucket.v1.0.0.json +23 -11
  98. package/src/cvcs/recencyBand.v1.0.0.json +126 -42
  99. package/src/cvcs/referralEntityCategory.v1.0.0.json +40 -40
  100. package/src/cvcs/riskSeverityBand.v1.0.0.json +139 -0
  101. package/src/cvcs/roiScope.v1.0.0.json +111 -3
  102. package/src/cvcs/roiStatus.v1.0.0.json +18 -10
  103. package/src/cvcs/romanticRelationshipChangeType.v1.0.0.json +2 -1
  104. package/src/cvcs/serviceCategories.v1.0.0.json +44 -44
  105. package/src/cvcs/serviceDeliveryChannel.v1.0.0.json +147 -0
  106. package/src/cvcs/serviceMechanisms.v1.0.0.json +36 -36
  107. package/src/cvcs/serviceStates.v1.0.0.json +40 -40
  108. package/src/cvcs/sessionTemplate.v1.0.0.json +261 -0
  109. package/src/cvcs/sexProviderSubrole.v1.0.0.json +35 -28
  110. package/src/cvcs/smtType.v1.0.0.json +40 -40
  111. package/src/cvcs/sourceCategory.v1.1.0.json +8 -1
  112. package/src/cvcs/sourceInstrument.v1.0.0.json +458 -0
  113. package/src/cvcs/sourceSystem.v1.0.0.json +203 -0
  114. package/src/cvcs/subjectType.v1.0.0.json +80 -0
  115. package/src/cvcs/traffickingRelevantRole.v1.0.0.json +104 -0
  116. package/src/cvcs/userRoles.v1.0.0.json +203 -0
  117. package/src/cvcs/victimStatusFamily.v1.0.0.json +40 -40
  118. package/src/cvcs/whyNots.v1.0.0.json +385 -0
  119. package/src/generated/cvc-enums.ts +1121 -127
  120. package/src/index.ts +20 -0
  121. package/src/mongo/catalog.ts +65 -0
  122. package/src/mongo/contract.ts +157 -0
  123. package/src/mongo/index.ts +343 -0
  124. package/src/mongo/similarity.ts +133 -0
  125. package/src/mongo/uri.ts +53 -0
  126. package/src/schemas/common.ts +4 -0
  127. package/src/services/cvcRegistryService.ts +1 -1
  128. package/src/cvcs/riskBand.v1.0.0.json +0 -98
  129. package/dist/{cvcEntry-BCj1OWqL.d.cts → cvcEntry-0BIB9sen.d.cts} +8 -8
  130. package/dist/{cvcEntry-BCj1OWqL.d.ts → cvcEntry-0BIB9sen.d.ts} +8 -8
@@ -0,0 +1,144 @@
1
+ {
2
+ "domain": "po_status",
3
+ "name": "Core Protection Order Status (CVC-214)",
4
+ "version": "1.0.0",
5
+ "_status": "CANONICAL — imported 0.8.13 from the Notion Final CVC codebook (CVC-214, Owner Crysta Price, Status 'Drafted - Needs Review'). Lifecycle status of a protection order (IC-62). The codebook's `Level` column encodes a LIFECYCLE STAGE (1 = filing, 2 = interim/ex-parte, 3 = final, 4 = terminal), NOT a parent/child hierarchy — the codebook declares no parents. All values are therefore modelled FLAT and the canonical stage is carried verbatim in `lifecycleStage` rather than inventing a tree.",
6
+ "_source": "htilabstech/prototype@a596eb9 Protection Orders (IC-62)/core - PO_status CVC — codebook 1.csv (CVC-214)",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Protection order status"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "214-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
+ "214-000-000-000-000-000-001",
20
+ "214-000-000-000-000-000-002",
21
+ "214-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."
24
+ },
25
+ {
26
+ "code": "214-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "214-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Unknown or cannot be determined from the available information.",
33
+ "canonicalCode": "UNK"
34
+ },
35
+ {
36
+ "code": "214-000-000-000-000-000-002",
37
+ "key": "anonymous",
38
+ "title": "Anonymous / declined to answer",
39
+ "selectable": true,
40
+ "parentCode": "214-000-000-000-000-000-000",
41
+ "childCodes": [],
42
+ "definition": "Information may be withheld by preference or due to redaction; identity is anonymous or redacted.",
43
+ "canonicalCode": "ANON"
44
+ },
45
+ {
46
+ "code": "214-000-000-000-000-000-003",
47
+ "key": "data_not_collected",
48
+ "title": "Data not collected",
49
+ "selectable": true,
50
+ "parentCode": "214-000-000-000-000-000-000",
51
+ "childCodes": [],
52
+ "definition": "No attempt was made to collect the information.",
53
+ "canonicalCode": "DNC"
54
+ },
55
+ {
56
+ "code": "214-001-000-000-000-000-000",
57
+ "key": "filed",
58
+ "title": "Filed / Requested",
59
+ "selectable": true,
60
+ "parentCode": null,
61
+ "childCodes": [],
62
+ "definition": "A protection order petition or request has been formally submitted to the court.",
63
+ "canonicalCode": "FILED",
64
+ "lifecycleStage": 1
65
+ },
66
+ {
67
+ "code": "214-002-000-000-000-000-000",
68
+ "key": "ex_parte_granted",
69
+ "title": "Ex Parte Granted",
70
+ "selectable": true,
71
+ "parentCode": null,
72
+ "childCodes": [],
73
+ "definition": "Temporary or emergency protection has been granted prior to a full hearing or final adjudication.",
74
+ "canonicalCode": "EX_PARTE_GRANTED",
75
+ "lifecycleStage": 2
76
+ },
77
+ {
78
+ "code": "214-003-000-000-000-000-000",
79
+ "key": "hearing_pending",
80
+ "title": "Show Cause Hearing Pending",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "Temporary or emergency protection was not granted and the case is awaiting or proceeding to a hearing or court-ordered appearance.",
85
+ "canonicalCode": "HEARING_PENDING",
86
+ "lifecycleStage": 2
87
+ },
88
+ {
89
+ "code": "214-004-000-000-000-000-000",
90
+ "key": "denied_outright",
91
+ "title": "Denied Outright",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "The protection order petition was denied at initial review without advancing to a hearing.",
96
+ "canonicalCode": "DENIED_OUTRIGHT",
97
+ "lifecycleStage": 2
98
+ },
99
+ {
100
+ "code": "214-005-000-000-000-000-000",
101
+ "key": "final_granted",
102
+ "title": "Final Granted",
103
+ "selectable": true,
104
+ "parentCode": null,
105
+ "childCodes": [],
106
+ "definition": "A final protection order has been granted following hearing or final court determination.",
107
+ "canonicalCode": "FINAL_GRANTED",
108
+ "lifecycleStage": 3
109
+ },
110
+ {
111
+ "code": "214-006-000-000-000-000-000",
112
+ "key": "final_denied_or_dismissed",
113
+ "title": "Final Denied or Dismissed",
114
+ "selectable": true,
115
+ "parentCode": null,
116
+ "childCodes": [],
117
+ "definition": "The petition was denied or dismissed following hearing or final court review.",
118
+ "canonicalCode": "FINAL_DENIED_OR_DISMISSED",
119
+ "lifecycleStage": 3
120
+ },
121
+ {
122
+ "code": "214-007-000-000-000-000-000",
123
+ "key": "expired",
124
+ "title": "Expired",
125
+ "selectable": true,
126
+ "parentCode": null,
127
+ "childCodes": [],
128
+ "definition": "A protection order has reached the end of its effective period and is no longer active.",
129
+ "canonicalCode": "EXPIRED",
130
+ "lifecycleStage": 4
131
+ },
132
+ {
133
+ "code": "214-008-000-000-000-000-000",
134
+ "key": "emergency",
135
+ "title": "Emergency Granted",
136
+ "selectable": true,
137
+ "parentCode": null,
138
+ "childCodes": [],
139
+ "definition": "An emergency protective order has been issued in response to an immediate and present danger, typically outside normal court processes (e.g., via law enforcement or after-hours judicial authorization). Provides short-term protection pending formal court review.",
140
+ "canonicalCode": "EMERGENCY",
141
+ "lifecycleStage": 2
142
+ }
143
+ ]
144
+ }
@@ -0,0 +1,76 @@
1
+ {
2
+ "domain": "po_violation_status",
3
+ "name": "Core Protection Order Violation Status (CVC-215)",
4
+ "version": "1.0.0",
5
+ "_status": "CANONICAL — imported 0.8.13 from the Notion Final CVC codebook (CVC-215, Owner Crysta Price, Status 'Drafted - Needs Review'). Whether a protection order was violated during its effective period (IC-62).",
6
+ "_source": "htilabstech/prototype@a596eb9 Protection Orders (IC-62)/core PO violation status CVC — codebook 1.csv (CVC-215)",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Protection order violation status"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "215-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
+ "215-000-000-000-000-000-001",
20
+ "215-000-000-000-000-000-002",
21
+ "215-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."
24
+ },
25
+ {
26
+ "code": "215-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "215-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Unknown or cannot be determined from the available information.",
33
+ "canonicalCode": "UNK"
34
+ },
35
+ {
36
+ "code": "215-000-000-000-000-000-002",
37
+ "key": "anonymous",
38
+ "title": "Anonymous / declined to answer",
39
+ "selectable": true,
40
+ "parentCode": "215-000-000-000-000-000-000",
41
+ "childCodes": [],
42
+ "definition": "Information may be withheld by preference or due to redaction; identity is anonymous or redacted.",
43
+ "canonicalCode": "ANON"
44
+ },
45
+ {
46
+ "code": "215-000-000-000-000-000-003",
47
+ "key": "data_not_collected",
48
+ "title": "Data not collected",
49
+ "selectable": true,
50
+ "parentCode": "215-000-000-000-000-000-000",
51
+ "childCodes": [],
52
+ "definition": "No attempt was made to collect the information.",
53
+ "canonicalCode": "DNC"
54
+ },
55
+ {
56
+ "code": "215-001-000-000-000-000-000",
57
+ "key": "violated",
58
+ "title": "Violated",
59
+ "selectable": true,
60
+ "parentCode": null,
61
+ "childCodes": [],
62
+ "definition": "There is a known or credible indication that the respondent violated the terms of the protection order during its effective period.",
63
+ "canonicalCode": "VIOLATED"
64
+ },
65
+ {
66
+ "code": "215-002-000-000-000-000-000",
67
+ "key": "notviolated",
68
+ "title": "Not Violated",
69
+ "selectable": true,
70
+ "parentCode": null,
71
+ "childCodes": [],
72
+ "definition": "No known or indicated violation of the protection order during its effective period.",
73
+ "canonicalCode": "NOTVIOLATED"
74
+ }
75
+ ]
76
+ }
@@ -2,7 +2,14 @@
2
2
  "domain": "radius_bucket",
3
3
  "name": "radiusBucket",
4
4
  "version": "1.0.0",
5
- "_status": "PROVISIONAL — net-new value-CVC not yet in Notion; provisional 900+ numbering; substantive values sourced verbatim from the PAVE @pave/domain enum of the same name (D10 source-from-platform-common). PENDING canonical Notion authoring + steward ratification of titles/definitions.",
5
+ "_status": {
6
+ "vocabStatus": "provisional-pending-notion-ratification",
7
+ "authoredBy": "platform-common 0.8.13",
8
+ "evidence": "Substantive values sourced verbatim from the PAVE @pave/domain enum of the same name (pave-2.0/packages/domain/src/enums.ts). Net-new value-CVC not yet in Notion; provisional 900-block numbering (967).",
9
+ "keyFix": "BREAKING (provisional domain). Keys were the bare numerals 10 / 50 / 100 / 250 / 500, which VIOLATE the CVC key contract /^[a-z][a-z0-9_]*$/ (a key may not start with a digit). They are now mi_10 / mi_50 / mi_100 / mi_250 / mi_500, with the numeric mileage carried losslessly on each entry as `radiusMiles`. Codes are UNCHANGED (967-001..967-005). Caught by the new CVC drift gate (assertion G) — this domain had never been validated, because cvc-structural.test.ts drives off a hand-maintained file list that omitted it. The gate scans the directory instead, so nothing can hide from it again.",
10
+ "upstreamReconciliation": "radius_bucket has no Notion CVC number. Confirm the 5 buckets and assign a canonical number, or confirm it should stay PAVE-local.",
11
+ "consumerRebind": "pave-2.0 RadiusBucketKeys: '10' -> 'mi_10' etc. Read the mileage from `radiusMiles` rather than parsing the key."
12
+ },
6
13
  "_source": "pave-2.0/packages/domain/src/enums.ts",
7
14
  "levels": {
8
15
  "0": "Unknown or Missing",
@@ -51,48 +58,53 @@
51
58
  },
52
59
  {
53
60
  "code": "967-001-000-000-000-000-000",
54
- "key": "10",
61
+ "key": "mi_10",
55
62
  "title": "10 miles",
56
63
  "selectable": true,
57
64
  "parentCode": null,
58
65
  "childCodes": [],
59
- "definition": "Search/proximity radius bucket: 10 miles."
66
+ "definition": "Search/proximity radius bucket: 10 miles.",
67
+ "radiusMiles": 10
60
68
  },
61
69
  {
62
70
  "code": "967-002-000-000-000-000-000",
63
- "key": "50",
71
+ "key": "mi_50",
64
72
  "title": "50 miles",
65
73
  "selectable": true,
66
74
  "parentCode": null,
67
75
  "childCodes": [],
68
- "definition": "Search/proximity radius bucket: 50 miles."
76
+ "definition": "Search/proximity radius bucket: 50 miles.",
77
+ "radiusMiles": 50
69
78
  },
70
79
  {
71
80
  "code": "967-003-000-000-000-000-000",
72
- "key": "100",
81
+ "key": "mi_100",
73
82
  "title": "100 miles",
74
83
  "selectable": true,
75
84
  "parentCode": null,
76
85
  "childCodes": [],
77
- "definition": "Search/proximity radius bucket: 100 miles."
86
+ "definition": "Search/proximity radius bucket: 100 miles.",
87
+ "radiusMiles": 100
78
88
  },
79
89
  {
80
90
  "code": "967-004-000-000-000-000-000",
81
- "key": "250",
91
+ "key": "mi_250",
82
92
  "title": "250 miles",
83
93
  "selectable": true,
84
94
  "parentCode": null,
85
95
  "childCodes": [],
86
- "definition": "Search/proximity radius bucket: 250 miles."
96
+ "definition": "Search/proximity radius bucket: 250 miles.",
97
+ "radiusMiles": 250
87
98
  },
88
99
  {
89
100
  "code": "967-005-000-000-000-000-000",
90
- "key": "500",
101
+ "key": "mi_500",
91
102
  "title": "500 miles",
92
103
  "selectable": true,
93
104
  "parentCode": null,
94
105
  "childCodes": [],
95
- "definition": "Search/proximity radius bucket: 500 miles."
106
+ "definition": "Search/proximity radius bucket: 500 miles.",
107
+ "radiusMiles": 500
96
108
  }
97
109
  ]
98
110
  }
@@ -1,105 +1,189 @@
1
1
  {
2
2
  "domain": "recency_band",
3
- "name": "Core Recency Band (PROVISIONAL CVC-232 — pending codebook ratification)",
3
+ "name": "Core Recency Band (CVC-137)",
4
4
  "version": "1.0.0",
5
5
  "levels": {
6
6
  "0": "Unknown or Missing",
7
7
  "1": "Recency band"
8
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"
19
+ },
9
20
  "entries": [
10
21
  {
11
- "code": "232-000-000-000-000-000-000",
22
+ "code": "137-000-000-000-000-000-000",
12
23
  "key": "missingness_root",
13
24
  "title": "Unknown, Redacted, or Missing",
14
25
  "selectable": false,
15
26
  "parentCode": null,
16
27
  "childCodes": [
17
- "232-000-000-000-000-000-001",
18
- "232-000-000-000-000-000-002",
19
- "232-000-000-000-000-000-003"
28
+ "137-000-000-000-000-000-001",
29
+ "137-000-000-000-000-000-002",
30
+ "137-000-000-000-000-000-003"
20
31
  ],
21
- "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"]
22
36
  },
23
37
  {
24
- "code": "232-000-000-000-000-000-001",
38
+ "code": "137-000-000-000-000-000-001",
25
39
  "key": "unknown",
26
- "title": "Unknown / not captured",
40
+ "title": "Unknown",
27
41
  "selectable": true,
28
- "parentCode": "232-000-000-000-000-000-000",
42
+ "parentCode": "137-000-000-000-000-000-000",
29
43
  "childCodes": [],
30
- "definition": "The recency band is unknown or cannot be determined from the available information."
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"]
31
48
  },
32
49
  {
33
- "code": "232-000-000-000-000-000-002",
50
+ "code": "137-000-000-000-000-000-002",
34
51
  "key": "anonymous",
35
- "title": "Anonymous / declined to answer",
52
+ "title": "Anonymous",
36
53
  "selectable": true,
37
- "parentCode": "232-000-000-000-000-000-000",
54
+ "parentCode": "137-000-000-000-000-000-000",
38
55
  "childCodes": [],
39
- "definition": "The recency band may be withheld by preference or due to redaction; identity is anonymous 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"]
40
60
  },
41
61
  {
42
- "code": "232-000-000-000-000-000-003",
62
+ "code": "137-000-000-000-000-000-003",
43
63
  "key": "data_not_collected",
44
64
  "title": "Data not collected",
45
65
  "selectable": true,
46
- "parentCode": "232-000-000-000-000-000-000",
66
+ "parentCode": "137-000-000-000-000-000-000",
67
+ "childCodes": [],
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"]
72
+ },
73
+ {
74
+ "code": "137-001-000-000-000-000-000",
75
+ "key": "w3m",
76
+ "title": "Within past 3 months",
77
+ "selectable": true,
78
+ "parentCode": null,
79
+ "childCodes": [],
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"]
84
+ },
85
+ {
86
+ "code": "137-002-000-000-000-000-000",
87
+ "key": "m3_6",
88
+ "title": "3–6 months ago",
89
+ "selectable": true,
90
+ "parentCode": null,
47
91
  "childCodes": [],
48
- "definition": "No attempt was made to collect the recency band."
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"]
49
96
  },
50
97
  {
51
- "code": "232-001-000-000-000-000-000",
52
- "key": "within_3_months",
53
- "title": "Within the last 3 months",
98
+ "code": "137-003-000-000-000-000-000",
99
+ "key": "m6_12",
100
+ "title": "6–12 months ago",
54
101
  "selectable": true,
55
102
  "parentCode": null,
56
103
  "childCodes": [],
57
- "definition": "The event or condition occurred within the most recent 3 months (0 up to and including 3 months before time_as_of)."
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"]
58
108
  },
59
109
  {
60
- "code": "232-002-000-000-000-000-000",
61
- "key": "months_3_to_6",
62
- "title": "3 to 6 months ago",
110
+ "code": "137-004-000-000-000-000-000",
111
+ "key": "y1p",
112
+ "title": "1+ years ago",
63
113
  "selectable": true,
64
114
  "parentCode": null,
65
115
  "childCodes": [],
66
- "definition": "The event or condition occurred more than 3 and up to and including 6 months before time_as_of."
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"]
67
120
  },
68
121
  {
69
- "code": "232-003-000-000-000-000-000",
70
- "key": "months_6_to_12",
71
- "title": "6 to 12 months ago",
122
+ "code": "137-005-000-000-000-000-000",
123
+ "key": "y1_3",
124
+ "title": "1–3 years ago",
72
125
  "selectable": true,
73
126
  "parentCode": null,
74
127
  "childCodes": [],
75
- "definition": "The event or condition occurred more than 6 and up to and including 12 months before time_as_of."
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"]
76
132
  },
77
133
  {
78
- "code": "232-004-000-000-000-000-000",
79
- "key": "one_year_or_more",
80
- "title": "1 year or more ago",
134
+ "code": "137-006-000-000-000-000-000",
135
+ "key": "y3_10",
136
+ "title": "3–10 years ago",
81
137
  "selectable": true,
82
138
  "parentCode": null,
83
139
  "childCodes": [],
84
- "definition": "The event or condition occurred at least 1 year before time_as_of. Use a finer-grained band (years_3_to_10 or ten_plus_years) when the source supports it."
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"]
85
144
  },
86
145
  {
87
- "code": "232-005-000-000-000-000-000",
88
- "key": "years_3_to_10",
89
- "title": "3 to 10 years ago",
146
+ "code": "137-007-000-000-000-000-000",
147
+ "key": "y10p",
148
+ "title": "10+ years ago",
90
149
  "selectable": true,
91
150
  "parentCode": null,
92
151
  "childCodes": [],
93
- "definition": "The event or condition occurred more than 3 and up to and including 10 years before time_as_of."
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"]
94
156
  },
95
157
  {
96
- "code": "232-006-000-000-000-000-000",
97
- "key": "ten_plus_years",
98
- "title": "More than 10 years ago",
158
+ "code": "137-008-000-000-000-000-000",
159
+ "key": "ylt3",
160
+ "title": "Less than 3 years ago",
99
161
  "selectable": true,
100
162
  "parentCode": null,
101
163
  "childCodes": [],
102
- "definition": "The event or condition occurred more than 10 years before time_as_of."
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"]
103
168
  }
104
- ]
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"
105
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
  }