@htilabs/platform-common-models 0.9.0 → 0.12.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 (149) hide show
  1. package/dist/config/index.cjs +85 -0
  2. package/dist/config/index.cjs.map +1 -1
  3. package/dist/config/index.d.cts +94 -4
  4. package/dist/config/index.d.ts +94 -4
  5. package/dist/config/index.js +81 -1
  6. package/dist/config/index.js.map +1 -1
  7. package/dist/constants/index.cjs +456 -181
  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 +453 -169
  12. package/dist/constants/index.js.map +1 -1
  13. package/dist/cvcs/index.cjs +15331 -801
  14. package/dist/cvcs/index.cjs.map +1 -1
  15. package/dist/cvcs/index.d.cts +18167 -2208
  16. package/dist/cvcs/index.d.ts +18167 -2208
  17. package/dist/cvcs/index.js +15282 -801
  18. package/dist/cvcs/index.js.map +1 -1
  19. package/dist/{index-Zu_mOJRn.d.cts → index-CoVr1jIV.d.cts} +1 -1
  20. package/dist/{index-CDoqrfc1.d.ts → index-I-DiX9eQ.d.ts} +1 -1
  21. package/dist/index.cjs +17070 -1056
  22. package/dist/index.cjs.map +1 -1
  23. package/dist/index.d.cts +1638 -12
  24. package/dist/index.d.ts +1638 -12
  25. package/dist/index.js +16969 -1043
  26. package/dist/index.js.map +1 -1
  27. package/dist/models/index.d.cts +2 -2
  28. package/dist/models/index.d.ts +2 -2
  29. package/dist/mongo/index.cjs +384 -0
  30. package/dist/mongo/index.cjs.map +1 -0
  31. package/dist/mongo/index.d.cts +221 -0
  32. package/dist/mongo/index.d.ts +221 -0
  33. package/dist/mongo/index.js +352 -0
  34. package/dist/mongo/index.js.map +1 -0
  35. package/dist/{platform-auth-XVB9aHqR.d.cts → platform-auth-v53r3BhN.d.cts} +19 -75
  36. package/dist/{platform-auth-XVB9aHqR.d.ts → platform-auth-v53r3BhN.d.ts} +19 -75
  37. package/dist/schemas/index.cjs +25 -156
  38. package/dist/schemas/index.cjs.map +1 -1
  39. package/dist/schemas/index.d.cts +25 -25
  40. package/dist/schemas/index.d.ts +25 -25
  41. package/dist/schemas/index.js +25 -156
  42. package/dist/schemas/index.js.map +1 -1
  43. package/dist/services/index.cjs +0 -3
  44. package/dist/services/index.cjs.map +1 -1
  45. package/dist/services/index.js +0 -3
  46. package/dist/services/index.js.map +1 -1
  47. package/dist/types/index.d.cts +2 -2
  48. package/dist/types/index.d.ts +2 -2
  49. package/package.json +9 -1
  50. package/src/__sot__/README.md +56 -0
  51. package/src/__sot__/coreIndicators.pin.json +215 -0
  52. package/src/__sot__/cvcIndex.pin.json +268 -0
  53. package/src/__sot__/scoringEmits.pin.json +176 -0
  54. package/src/__tests__/__snapshots__/cvc-sot.snap +227 -35
  55. package/src/__tests__/cvc-136-scoring-invariant.test.ts +323 -0
  56. package/src/__tests__/cvc-drift-gate.test.ts +603 -0
  57. package/src/__tests__/cvc-sot-snapshot.test.ts +122 -11
  58. package/src/__tests__/cvc-structural.test.ts +56 -1
  59. package/src/__tests__/mongo-verifier.test.ts +502 -0
  60. package/src/__tests__/runtime-contract-validator.test.ts +325 -1
  61. package/src/config/index.ts +197 -6
  62. package/src/constants/ic.ts +512 -206
  63. package/src/constants/service-catalog.ts +4 -2
  64. package/src/cvcs/activityType.v1.0.0.json +143 -0
  65. package/src/cvcs/adminRoles.v1.0.0.json +153 -0
  66. package/src/cvcs/administeringJurisdiction.v1.0.0.json +40 -40
  67. package/src/cvcs/ageBinReporting.v1.0.0.json +40 -40
  68. package/src/cvcs/assertionDomain.v1.1.0.json +629 -0
  69. package/src/cvcs/{checkInPhase.v1.0.0.json → checkInPhase.v1.1.0.json} +20 -2
  70. package/src/cvcs/childChangeType.v1.0.0.json +152 -0
  71. package/src/cvcs/citizenship.v1.0.0.json +3062 -0
  72. package/src/cvcs/contactInfoTypes.v1.0.0.json +40 -40
  73. package/src/cvcs/contactLinkType.v1.0.0.json +89 -0
  74. package/src/cvcs/coreDhState.v1.0.0.json +113 -0
  75. package/src/cvcs/coreFunctions.v1.0.0.json +746 -0
  76. package/src/cvcs/coreIndicators.v1.0.0.json +2840 -0
  77. package/src/cvcs/coreReferralOutcome.v1.0.0.json +71 -0
  78. package/src/cvcs/employmentStatus.v1.0.0.json +60 -60
  79. package/src/cvcs/exploitationType.v1.0.0.json +106 -0
  80. package/src/cvcs/facilitatorEntityType.v1.0.0.json +40 -40
  81. package/src/cvcs/highestEducationLevelCompleted.v1.0.0.json +55 -46
  82. package/src/cvcs/hivStatus.v1.0.0.json +71 -0
  83. package/src/cvcs/hmisCurrentLivingSituation.v1.0.0.json +409 -0
  84. package/src/cvcs/hmisRelationshipToHoh.v1.0.0.json +104 -0
  85. package/src/cvcs/homelessStatus.v1.0.0.json +27 -27
  86. package/src/cvcs/housingSubsidyTypes.v1.0.0.json +161 -0
  87. package/src/cvcs/htType.v1.0.0.json +87 -0
  88. package/src/cvcs/identificationStatus.v1.0.0.json +18 -0
  89. package/src/cvcs/immigrationLegalStatusChangeType.v1.0.0.json +143 -0
  90. package/src/cvcs/incarcerationEpisodeType.v1.0.0.json +106 -0
  91. package/src/cvcs/incidentInvolvementRoles.v1.0.0.json +40 -40
  92. package/src/cvcs/incidentParticipationRoles.v1.0.0.json +40 -40
  93. package/src/cvcs/incomeBenefitsSources.v1.0.0.json +31 -2
  94. package/src/cvcs/index.ts +106 -1
  95. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +28 -18
  96. package/src/cvcs/juvenileJusticeInvolvementStatus.v1.0.0.json +32 -32
  97. package/src/cvcs/livingSituation.v1.0.0.json +213 -0
  98. package/src/cvcs/mentalHealthStatus.v1.0.0.json +71 -0
  99. package/src/cvcs/militaryBranch.v1.0.0.json +20 -20
  100. package/src/cvcs/militaryStatus.v1.0.0.json +20 -20
  101. package/src/cvcs/nameType.v1.0.0.json +40 -40
  102. package/src/cvcs/needsAssessmentChangeType.v1.0.0.json +134 -0
  103. package/src/cvcs/offenderStatus.v1.0.0.json +40 -40
  104. package/src/cvcs/offenderStatusFamily.v1.0.0.json +36 -36
  105. package/src/cvcs/poPetitionBasis.v1.0.0.json +96 -0
  106. package/src/cvcs/poStatus.v1.0.0.json +144 -0
  107. package/src/cvcs/poViolationStatus.v1.0.0.json +76 -0
  108. package/src/cvcs/programEnrollmentChangeType.v1.0.0.json +134 -0
  109. package/src/cvcs/provenanceSourceId.v1.0.0.json +134 -0
  110. package/src/cvcs/radiusBucket.v1.0.0.json +110 -0
  111. package/src/cvcs/recencyBand.v1.0.0.json +104 -39
  112. package/src/cvcs/referralEntityCategory.v1.0.0.json +40 -40
  113. package/src/cvcs/relationshipConcern.v1.0.0.json +114 -0
  114. package/src/cvcs/riskCategory.v1.0.0.json +134 -0
  115. package/src/cvcs/riskSeverityBand.v1.0.0.json +139 -0
  116. package/src/cvcs/roiMethod.v1.0.0.json +107 -0
  117. package/src/cvcs/roiScope.v1.0.0.json +296 -0
  118. package/src/cvcs/roiStatus.v1.0.0.json +106 -0
  119. package/src/cvcs/romanticRelationshipChangeType.v1.0.0.json +162 -0
  120. package/src/cvcs/serviceAudience.v1.0.0.json +96 -0
  121. package/src/cvcs/serviceCategories.v1.0.0.json +44 -44
  122. package/src/cvcs/serviceDeliveryChannel.v1.0.0.json +147 -0
  123. package/src/cvcs/serviceMechanisms.v1.0.0.json +36 -36
  124. package/src/cvcs/serviceStates.v1.0.0.json +55 -33
  125. package/src/cvcs/sessionNoteVisibility.v1.0.0.json +80 -0
  126. package/src/cvcs/sessionTemplate.v1.0.0.json +261 -0
  127. package/src/cvcs/sexProviderSubrole.v1.0.0.json +35 -28
  128. package/src/cvcs/smtType.v1.0.0.json +40 -40
  129. package/src/cvcs/sourceCategory.v1.1.0.json +8 -1
  130. package/src/cvcs/sourceInstrument.v1.0.0.json +458 -0
  131. package/src/cvcs/sourceSubtype.v1.1.0.json +36 -0
  132. package/src/cvcs/sourceSystem.v1.0.0.json +203 -0
  133. package/src/cvcs/specialNeedsDisabilities.v1.0.0.json +143 -0
  134. package/src/cvcs/suggestionSource.v1.0.0.json +71 -0
  135. package/src/cvcs/traffickingRelevantRole.v1.0.0.json +104 -0
  136. package/src/cvcs/userRoles.v1.0.0.json +203 -0
  137. package/src/cvcs/verificationMethod.v1.0.0.json +18 -0
  138. package/src/cvcs/victimAbuseTypes.v1.0.0.json +276 -0
  139. package/src/cvcs/victimStatusFamily.v1.0.0.json +40 -40
  140. package/src/cvcs/whyNots.v1.0.0.json +385 -0
  141. package/src/generated/cvc-enums.ts +1729 -7
  142. package/src/mongo/catalog.ts +65 -0
  143. package/src/mongo/contract.ts +157 -0
  144. package/src/mongo/index.ts +343 -0
  145. package/src/mongo/similarity.ts +133 -0
  146. package/src/mongo/uri.ts +53 -0
  147. package/src/services/cvcRegistryService.ts +1 -1
  148. package/dist/{cvcEntry-0BIB9sen.d.cts → cvcEntry-BCj1OWqL.d.cts} +8 -8
  149. package/dist/{cvcEntry-0BIB9sen.d.ts → cvcEntry-BCj1OWqL.d.ts} +8 -8
@@ -0,0 +1,134 @@
1
+ {
2
+ "domain": "provenance_source_id",
3
+ "name": "provenanceSourceId",
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.",
6
+ "_source": "pave-2.0/packages/domain/src/enums.ts",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Provenance source id"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "966-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
+ "966-000-000-000-000-000-001",
20
+ "966-000-000-000-000-000-002",
21
+ "966-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "966-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "966-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "The provenance_source_id is unknown or cannot be determined."
33
+ },
34
+ {
35
+ "code": "966-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "966-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld, declined, or redacted."
42
+ },
43
+ {
44
+ "code": "966-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "966-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "966-001-000-000-000-000-000",
54
+ "key": "client_self_report",
55
+ "title": "Client Self Report",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Provenance source 'client_self_report' — the origin system/actor a value was derived from."
60
+ },
61
+ {
62
+ "code": "966-002-000-000-000-000-000",
63
+ "key": "system_derived_ads",
64
+ "title": "System Derived Ads",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Provenance source 'system_derived_ads' — the origin system/actor a value was derived from."
69
+ },
70
+ {
71
+ "code": "966-003-000-000-000-000-000",
72
+ "key": "system_derived_geocoder",
73
+ "title": "System Derived Geocoder",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Provenance source 'system_derived_geocoder' — the origin system/actor a value was derived from."
78
+ },
79
+ {
80
+ "code": "966-004-000-000-000-000-000",
81
+ "key": "staff_observation",
82
+ "title": "Staff Observation",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Provenance source 'staff_observation' — the origin system/actor a value was derived from."
87
+ },
88
+ {
89
+ "code": "966-005-000-000-000-000-000",
90
+ "key": "intake_form",
91
+ "title": "Intake Form",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Provenance source 'intake_form' — the origin system/actor a value was derived from."
96
+ },
97
+ {
98
+ "code": "966-006-000-000-000-000-000",
99
+ "key": "referral_partner",
100
+ "title": "Referral Partner",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "Provenance source 'referral_partner' — the origin system/actor a value was derived from."
105
+ },
106
+ {
107
+ "code": "966-007-000-000-000-000-000",
108
+ "key": "law_enforcement",
109
+ "title": "Law Enforcement",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "Provenance source 'law_enforcement' — the origin system/actor a value was derived from."
114
+ },
115
+ {
116
+ "code": "966-008-000-000-000-000-000",
117
+ "key": "id_document",
118
+ "title": "Id Document",
119
+ "selectable": true,
120
+ "parentCode": null,
121
+ "childCodes": [],
122
+ "definition": "Provenance source 'id_document' — the origin system/actor a value was derived from."
123
+ },
124
+ {
125
+ "code": "966-009-000-000-000-000-000",
126
+ "key": "social_profile",
127
+ "title": "Social Profile",
128
+ "selectable": true,
129
+ "parentCode": null,
130
+ "childCodes": [],
131
+ "definition": "Provenance source 'social_profile' — the origin system/actor a value was derived from."
132
+ }
133
+ ]
134
+ }
@@ -0,0 +1,110 @@
1
+ {
2
+ "domain": "radius_bucket",
3
+ "name": "radiusBucket",
4
+ "version": "1.0.0",
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
+ },
13
+ "_source": "pave-2.0/packages/domain/src/enums.ts",
14
+ "levels": {
15
+ "0": "Unknown or Missing",
16
+ "1": "Search radius bucket (miles)"
17
+ },
18
+ "entries": [
19
+ {
20
+ "code": "967-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
+ "967-000-000-000-000-000-001",
27
+ "967-000-000-000-000-000-002",
28
+ "967-000-000-000-000-000-003"
29
+ ],
30
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
31
+ },
32
+ {
33
+ "code": "967-000-000-000-000-000-001",
34
+ "key": "unknown",
35
+ "title": "Unknown",
36
+ "selectable": true,
37
+ "parentCode": "967-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "The radius_bucket is unknown or cannot be determined."
40
+ },
41
+ {
42
+ "code": "967-000-000-000-000-000-002",
43
+ "key": "anonymous",
44
+ "title": "Anonymous / declined to answer",
45
+ "selectable": true,
46
+ "parentCode": "967-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "Value is intentionally withheld, declined, or redacted."
49
+ },
50
+ {
51
+ "code": "967-000-000-000-000-000-003",
52
+ "key": "data_not_collected",
53
+ "title": "Data not collected",
54
+ "selectable": true,
55
+ "parentCode": "967-000-000-000-000-000-000",
56
+ "childCodes": [],
57
+ "definition": "No attempt was made to collect the value."
58
+ },
59
+ {
60
+ "code": "967-001-000-000-000-000-000",
61
+ "key": "mi_10",
62
+ "title": "10 miles",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "Search/proximity radius bucket: 10 miles.",
67
+ "radiusMiles": 10
68
+ },
69
+ {
70
+ "code": "967-002-000-000-000-000-000",
71
+ "key": "mi_50",
72
+ "title": "50 miles",
73
+ "selectable": true,
74
+ "parentCode": null,
75
+ "childCodes": [],
76
+ "definition": "Search/proximity radius bucket: 50 miles.",
77
+ "radiusMiles": 50
78
+ },
79
+ {
80
+ "code": "967-003-000-000-000-000-000",
81
+ "key": "mi_100",
82
+ "title": "100 miles",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Search/proximity radius bucket: 100 miles.",
87
+ "radiusMiles": 100
88
+ },
89
+ {
90
+ "code": "967-004-000-000-000-000-000",
91
+ "key": "mi_250",
92
+ "title": "250 miles",
93
+ "selectable": true,
94
+ "parentCode": null,
95
+ "childCodes": [],
96
+ "definition": "Search/proximity radius bucket: 250 miles.",
97
+ "radiusMiles": 250
98
+ },
99
+ {
100
+ "code": "967-005-000-000-000-000-000",
101
+ "key": "mi_500",
102
+ "title": "500 miles",
103
+ "selectable": true,
104
+ "parentCode": null,
105
+ "childCodes": [],
106
+ "definition": "Search/proximity radius bucket: 500 miles.",
107
+ "radiusMiles": 500
108
+ }
109
+ ]
110
+ }
@@ -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
  }