@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
@@ -0,0 +1,134 @@
1
+ {
2
+ "domain": "needs_assessment_change_type",
3
+ "name": "Needs Assessment Change Type",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering; codes sourced verbatim from PAVE `@pave/domain` NEEDS_ASSESSMENT_CHANGE_TYPES (packages/domain/src/assertionVerbs.ts, PR #439) — PAVE author-own-vocab per the 2026-07-02 steer, working CVC name `core - needs_assessment_change_type`. CASING NORMALIZED: PAVE stores these SCREAMING_SNAKE (ANSWER_RECORDED…); CVC keys are lower_snake per the key regex. This is the FINE-GRAINED per-mutation change_type vocabulary, DISTINCT from the coarse 3-verb section-boundary runtime registry NEEDS_ASSESSMENT_VERB_REGISTRY (sectionSubmitted/sectionDeclined/needLogged), which stays as-is. PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "pave-2.0/packages/domain/src/assertionVerbs.ts NEEDS_ASSESSMENT_CHANGE_TYPES (PR #439); prototype/docs/components/COMPONENT_NeedsAssessmentSection.md § 6 (the 9-verb emit table)",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Needs-assessment change event (CAR verb)"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "982-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
+ "982-000-000-000-000-000-001",
20
+ "982-000-000-000-000-000-002",
21
+ "982-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 PAVE enum enumerates only the substantive change types, so the quadruplet is added per SOT convention."
24
+ },
25
+ {
26
+ "code": "982-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "982-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Change-event type is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "982-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "982-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": "982-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "982-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": "982-001-000-000-000-000-000",
54
+ "key": "answer_recorded",
55
+ "title": "Answer recorded",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "First commit on a previously-untouched question. Payload `(q, value)`; the diff is taken via a `prior` lookup in HTI_NEEDS_ANSWERS. (PAVE code ANSWER_RECORDED.)"
60
+ },
61
+ {
62
+ "code": "982-002-000-000-000-000-000",
63
+ "key": "answer_changed",
64
+ "title": "Answer changed",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Subsequent commit on an already-answered question. Payload `(q, value)`; freetext commits are debounced 1500ms. (PAVE code ANSWER_CHANGED.)"
69
+ },
70
+ {
71
+ "code": "982-003-000-000-000-000-000",
72
+ "key": "answer_cleared",
73
+ "title": "Answer cleared",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Value goes from non-empty to empty (radio cleared, textarea blanked). Payload `(q)`. Only fires when the prior value was non-empty. (PAVE code ANSWER_CLEARED.)"
78
+ },
79
+ {
80
+ "code": "982-004-000-000-000-000-000",
81
+ "key": "section_declined",
82
+ "title": "Section declined",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Decline-to-answer toggle flipped ON for a section. Payload `(slug)`; carries `assertion_value_anon: \"ANON\"` per GLOBAL_DESIGN_RULES § 6.5.8. (PAVE code SECTION_DECLINED.)"
87
+ },
88
+ {
89
+ "code": "982-005-000-000-000-000-000",
90
+ "key": "section_undeclined",
91
+ "title": "Section undeclined",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Decline-to-answer toggle flipped OFF. Marks the prior section_declined row `status: \"superseded\"` BEFORE emitting. (PAVE code SECTION_UNDECLINED.)"
96
+ },
97
+ {
98
+ "code": "982-006-000-000-000-000-000",
99
+ "key": "section_submitted",
100
+ "title": "Section submitted",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "Per-section Save button click. Payload `(slug, answeredCount)`. Always fires on Save when `answered > 0 OR declined`; does not fire when nothing is committable. (PAVE code SECTION_SUBMITTED.)"
105
+ },
106
+ {
107
+ "code": "982-007-000-000-000-000-000",
108
+ "key": "assessment_submitted",
109
+ "title": "Assessment submitted",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "Footer-level Submit Needs Assessment click. Payload `(answeredCount, totalCount)`; locks the assessment as a complete instrument run. (PAVE code ASSESSMENT_SUBMITTED.)"
114
+ },
115
+ {
116
+ "code": "982-008-000-000-000-000-000",
117
+ "key": "service_instance_generated",
118
+ "title": "Service instance generated",
119
+ "selectable": true,
120
+ "parentCode": null,
121
+ "childCodes": [],
122
+ "definition": "A `loggedServiceWhen` rule fires `addServiceInstance` with a fresh instance. Payload `(q, instanceId)`; pairs with an INSTANCE_ADDED row on the service_delivery domain. (PAVE code SERVICE_INSTANCE_GENERATED.)"
123
+ },
124
+ {
125
+ "code": "982-009-000-000-000-000-000",
126
+ "key": "service_instance_linked",
127
+ "title": "Service instance linked",
128
+ "selectable": true,
129
+ "parentCode": null,
130
+ "childCodes": [],
131
+ "definition": "A `loggedServiceWhen` rule re-evaluates and binds an already-existing service instance. Payload `(q, instanceId)`; idempotent path. (PAVE code SERVICE_INSTANCE_LINKED.)"
132
+ }
133
+ ]
134
+ }
@@ -7,6 +7,46 @@
7
7
  "1": "Offender status"
8
8
  },
9
9
  "entries": [
10
+ {
11
+ "code": "164-000-000-000-000-000-000",
12
+ "key": "missingness_root",
13
+ "title": "Unknown, Redacted, or Missing",
14
+ "selectable": false,
15
+ "parentCode": null,
16
+ "childCodes": [
17
+ "164-000-000-000-000-000-001",
18
+ "164-000-000-000-000-000-002",
19
+ "164-000-000-000-000-000-003"
20
+ ],
21
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Notion codebook explicitly lists UNK/ANON/DNC for this domain (no PNA)."
22
+ },
23
+ {
24
+ "code": "164-000-000-000-000-000-001",
25
+ "key": "unknown",
26
+ "title": "Unknown",
27
+ "selectable": true,
28
+ "parentCode": "164-000-000-000-000-000-000",
29
+ "childCodes": [],
30
+ "definition": "Unknown or cannot be determined from the available information. Missingness value; do not map to a justice stage. Consider prompting follow-up rather than persisting as a long-term state."
31
+ },
32
+ {
33
+ "code": "164-000-000-000-000-000-002",
34
+ "key": "anonymous",
35
+ "title": "Anonymous",
36
+ "selectable": true,
37
+ "parentCode": "164-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "Information may be withheld by preference or due to redaction; identity is anonymous or redacted. Missingness value; do not map to a justice stage. Distinct from Unknown (insufficient information)."
40
+ },
41
+ {
42
+ "code": "164-000-000-000-000-000-003",
43
+ "key": "data_not_collected",
44
+ "title": "Data not collected",
45
+ "selectable": true,
46
+ "parentCode": "164-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "No attempt was made to collect the information. Missingness value; do not map to a justice stage. Distinct from Unknown."
49
+ },
10
50
  {
11
51
  "code": "164-001-000-000-000-000-000",
12
52
  "key": "suspected_offender",
@@ -51,46 +91,6 @@
51
91
  "parentCode": null,
52
92
  "childCodes": [],
53
93
  "definition": "The subject has been convicted (or accepted a plea resulting in conviction) for a relevant offense within the program's scope."
54
- },
55
- {
56
- "code": "164-000-000-000-000-000-000",
57
- "key": "missingness_root",
58
- "title": "Unknown, Redacted, or Missing",
59
- "selectable": false,
60
- "parentCode": null,
61
- "childCodes": [
62
- "164-000-000-000-000-000-001",
63
- "164-000-000-000-000-000-002",
64
- "164-000-000-000-000-000-003"
65
- ],
66
- "definition": "Root group for values indicating absent, withheld, or uncollected data. Notion codebook explicitly lists UNK/ANON/DNC for this domain (no PNA)."
67
- },
68
- {
69
- "code": "164-000-000-000-000-000-001",
70
- "key": "unknown",
71
- "title": "Unknown",
72
- "selectable": true,
73
- "parentCode": "164-000-000-000-000-000-000",
74
- "childCodes": [],
75
- "definition": "Unknown or cannot be determined from the available information. Missingness value; do not map to a justice stage. Consider prompting follow-up rather than persisting as a long-term state."
76
- },
77
- {
78
- "code": "164-000-000-000-000-000-002",
79
- "key": "anonymous",
80
- "title": "Anonymous",
81
- "selectable": true,
82
- "parentCode": "164-000-000-000-000-000-000",
83
- "childCodes": [],
84
- "definition": "Information may be withheld by preference or due to redaction; identity is anonymous or redacted. Missingness value; do not map to a justice stage. Distinct from Unknown (insufficient information)."
85
- },
86
- {
87
- "code": "164-000-000-000-000-000-003",
88
- "key": "data_not_collected",
89
- "title": "Data not collected",
90
- "selectable": true,
91
- "parentCode": "164-000-000-000-000-000-000",
92
- "childCodes": [],
93
- "definition": "No attempt was made to collect the information. Missingness value; do not map to a justice stage. Distinct from Unknown."
94
94
  }
95
95
  ]
96
96
  }
@@ -7,42 +7,6 @@
7
7
  "1": "Offender status family"
8
8
  },
9
9
  "entries": [
10
- {
11
- "code": "167-001-000-000-000-000-000",
12
- "key": "no_indication",
13
- "title": "No indication",
14
- "selectable": true,
15
- "parentCode": null,
16
- "childCodes": [],
17
- "definition": "Indicates there is no evidence suggesting the individual is an offender of human trafficking or of related exploitation within the scope of this program's determination process."
18
- },
19
- {
20
- "code": "167-002-000-000-000-000-000",
21
- "key": "non_trafficking_exploitation_offender",
22
- "title": "Non-trafficking exploitation offender",
23
- "selectable": true,
24
- "parentCode": null,
25
- "childCodes": [],
26
- "definition": "Indicates the individual is an offender of exploitation that does not meet the statutory or programmatic thresholds for human trafficking (e.g., labor abuses, non-trafficking commercial sexual exploitation)."
27
- },
28
- {
29
- "code": "167-003-000-000-000-000-000",
30
- "key": "potential_trafficking_offender",
31
- "title": "Potential trafficking offender",
32
- "selectable": true,
33
- "parentCode": null,
34
- "childCodes": [],
35
- "definition": "Indicates the individual is suspected of being a human trafficking offender based on available indicators, but the determination has not been substantiated or confirmed."
36
- },
37
- {
38
- "code": "167-004-000-000-000-000-000",
39
- "key": "trafficking_offender",
40
- "title": "Trafficking offender",
41
- "selectable": true,
42
- "parentCode": null,
43
- "childCodes": [],
44
- "definition": "Indicates the individual is determined to be an offender of human trafficking under the program's applicable definition (e.g., recruiting, harboring, transporting, providing, or obtaining a person for labor or commercial sex through force, fraud, or coercion)."
45
- },
46
10
  {
47
11
  "code": "167-000-000-000-000-000-000",
48
12
  "key": "missingness_root",
@@ -82,6 +46,42 @@
82
46
  "parentCode": "167-000-000-000-000-000-000",
83
47
  "childCodes": [],
84
48
  "definition": "Indicates the offender status family question was not asked and/or a value was not obtained; distinguish from 'unknown' (asked but not known) and 'anonymous' (asked but withheld)."
49
+ },
50
+ {
51
+ "code": "167-001-000-000-000-000-000",
52
+ "key": "no_indication",
53
+ "title": "No indication",
54
+ "selectable": true,
55
+ "parentCode": null,
56
+ "childCodes": [],
57
+ "definition": "Indicates there is no evidence suggesting the individual is an offender of human trafficking or of related exploitation within the scope of this program's determination process."
58
+ },
59
+ {
60
+ "code": "167-002-000-000-000-000-000",
61
+ "key": "non_trafficking_exploitation_offender",
62
+ "title": "Non-trafficking exploitation offender",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "Indicates the individual is an offender of exploitation that does not meet the statutory or programmatic thresholds for human trafficking (e.g., labor abuses, non-trafficking commercial sexual exploitation)."
67
+ },
68
+ {
69
+ "code": "167-003-000-000-000-000-000",
70
+ "key": "potential_trafficking_offender",
71
+ "title": "Potential trafficking offender",
72
+ "selectable": true,
73
+ "parentCode": null,
74
+ "childCodes": [],
75
+ "definition": "Indicates the individual is suspected of being a human trafficking offender based on available indicators, but the determination has not been substantiated or confirmed."
76
+ },
77
+ {
78
+ "code": "167-004-000-000-000-000-000",
79
+ "key": "trafficking_offender",
80
+ "title": "Trafficking offender",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "Indicates the individual is determined to be an offender of human trafficking under the program's applicable definition (e.g., recruiting, harboring, transporting, providing, or obtaining a person for labor or commercial sex through force, fraud, or coercion)."
85
85
  }
86
86
  ]
87
87
  }
@@ -2,6 +2,15 @@
2
2
  "domain": "person_relationships",
3
3
  "name": "Core Person Relationships",
4
4
  "version": "1.0.0",
5
+ "_status": {
6
+ "vocabStatus": "canonical",
7
+ "authoredBy": "CVC-126 imported from the Notion codebook (`Final CVCs/Linking & Relationships (IC-13)/core person relationship CVC`, CVC_INDEX.md row `core person relationship CVC` = 126). Engineer-direct, 2026-08-29 (ships in the next release): APPENDS 3 relationship types + 2 directional roles the canonical prototype's relationship picker offers and the Notion-side export does not yet carry. Envelope `version` is deliberately UNCHANGED at 1.0.0: this is a purely additive append with every prior positional code stable, which is the CVC-136 0.8.17 append precedent (`coreIndicators.v1.0.0.json`, +1 code, version held). The renumber precedent (`housingSubsidyTypes`, 233 -> 194) is the one that bumps, because every code there moved.",
8
+ "evidence": "prototype@622410b `HTI-LEADS-PAVE-Thread-prototype.html` L121814-121993 (`REL_CATEGORIES`). At that pin the picker enumerates 33 relationship types across 7 categories; this codebook carried 30. The 3-type delta is exactly `parental_figure_dependent` (Familial / Kin), `intimate_romantic_partner` and `intimate_partner_prior` (Intimate / Partner).",
9
+ "localExtension": "`parental_figure_dependent` (126-001-007) with its 2 directional roles, `intimate_romantic_partner` (126-002-003) and `intimate_partner_prior` (126-002-004) are AUTHORED, not carried — all 5 are flagged `localExtension: true` so reporting can separate them. The canonical HTML flags the two Intimate entries itself: its inline comments at L121850-121885 say each `is not yet in the Notion-side 'core - person relationships' codebook export at 'Final CVCs/Linking & Relationships (IC-13)/'` and name the Crysta-led canonicalization as a queued follow-up (tracker row `RWT-NEW-intimate-partner-prior-canonicalize`). `parental_figure_dependent` carries no such inline note but is absent from this codebook for the same reason and is treated identically. PENDING canonical Notion authoring + steward ratification of titles/definitions. Structural precedent: CVC-47 serviceDeliveryChannel's `group_inperson` / `group_remote` (047-006 / 047-007) and CVC-181 countries' `non_us_unspecified` (181-250) — flagged, codebook-absent leaves appended after the enumerated set. Upstream must adopt or reject all three.",
10
+ "ordinals": "APPENDED, never interleaved. Segment-3 ordinals inside a topic are otherwise alphabetical by key, so alphabetical insertion would have put `parental_figure_dependent` at 126-001-005 and reshuffled `parent_child` / `sibling`. New types are appended at the end of their topic (126-001-007 after `sibling`; 126-002-003 / 126-002-004 after `spouse_partner`) so every previously issued positional code stays stable — the same rule CVC-136 states for its appends. Consumers persist KEYS, not wire codes, so the appends are additive in both directions.",
11
+ "roleStructure": "Unchanged by this append: an ASYMMETRIC type carries 2 level-3 directional role children ordered alphabetically by key (`guardian_dependent` -> `dependent_of` / `guardian_of`); a SYMMETRIC type carries none (`sibling`, `spouse_partner`, `dating_relationship`, ...). `parental_figure_dependent` is asymmetric and so mirrors `guardian_dependent` exactly; `intimate_romantic_partner` and `intimate_partner_prior` are symmetric in the canonical picker (`symmetric: true`) and so carry no role children."
12
+ },
13
+ "_source": "htilabstech/prototype@622410b HTI-LEADS-PAVE-Thread-prototype.html L121814-121993 (`REL_CATEGORIES`) — reference for the 3 appended types only; the 30 pre-existing types remain sourced from the Notion codebook",
5
14
  "levels": {
6
15
  "0": "Unknown or Missing",
7
16
  "1": "Topic",
@@ -51,7 +60,8 @@
51
60
  "126-001-003-000-000-000-000",
52
61
  "126-001-004-000-000-000-000",
53
62
  "126-001-005-000-000-000-000",
54
- "126-001-006-000-000-000-000"
63
+ "126-001-006-000-000-000-000",
64
+ "126-001-007-000-000-000-000"
55
65
  ],
56
66
  "definition": "Relationships between two people who are related through family or kinship, including immediate and extended family."
57
67
  },
@@ -172,6 +182,39 @@
172
182
  "childCodes": [],
173
183
  "definition": "A relationship between two people who share a sibling relationship."
174
184
  },
185
+ {
186
+ "code": "126-001-007-000-000-000-000",
187
+ "key": "parental_figure_dependent",
188
+ "title": "Parental figure / Dependent",
189
+ "selectable": true,
190
+ "parentCode": "126-001-000-000-000-000-000",
191
+ "childCodes": [
192
+ "126-001-007-001-000-000-000",
193
+ "126-001-007-002-000-000-000"
194
+ ],
195
+ "definition": "LOCAL EXTENSION (not in canonical CVC-126). A relationship where one person functions as a parental figure to the other: adult-child caretaking is clear, but the biological, adoptive, step, or legal-guardianship basis is unknown or not asserted. DISTINCT from `parent_child` (the parental basis IS known or asserted) and from `guardian_dependent` (legal or functional guardianship is the key fact) — this leaf carries the positive fact that a parental caretaking role exists WITHOUT claiming which basis produces it, which neither of those two can express. Asymmetric: the two directional roles are carried as level-3 children, mirroring `guardian_dependent`.",
196
+ "localExtension": true
197
+ },
198
+ {
199
+ "code": "126-001-007-001-000-000-000",
200
+ "key": "dependent_of_parental_figure",
201
+ "title": "Dependent",
202
+ "selectable": true,
203
+ "parentCode": "126-001-007-000-000-000-000",
204
+ "childCodes": [],
205
+ "definition": "LOCAL EXTENSION (not in canonical CVC-126). Use when the related person is the dependent of the anchor person's parental figure — i.e. the anchor person acts as the parental figure on this link. Distinct key from `dependent_of` (126-001-002-001), which is the guardianship-based role.",
206
+ "localExtension": true
207
+ },
208
+ {
209
+ "code": "126-001-007-002-000-000-000",
210
+ "key": "parental_figure_of",
211
+ "title": "Parental figure",
212
+ "selectable": true,
213
+ "parentCode": "126-001-007-000-000-000-000",
214
+ "childCodes": [],
215
+ "definition": "LOCAL EXTENSION (not in canonical CVC-126). Use when the related person is the parental figure of the anchor person.",
216
+ "localExtension": true
217
+ },
175
218
  {
176
219
  "code": "126-002-000-000-000-000-000",
177
220
  "key": "romantic_partner",
@@ -180,7 +223,9 @@
180
223
  "parentCode": null,
181
224
  "childCodes": [
182
225
  "126-002-001-000-000-000-000",
183
- "126-002-002-000-000-000-000"
226
+ "126-002-002-000-000-000-000",
227
+ "126-002-003-000-000-000-000",
228
+ "126-002-004-000-000-000-000"
184
229
  ],
185
230
  "definition": "Relationship between two people who are or were in a romantic or intimate partnership."
186
231
  },
@@ -202,6 +247,26 @@
202
247
  "childCodes": [],
203
248
  "definition": "Intimate partner relationship, including spouse, domestic partner, or romantic partner. Legal status and current/former status are modeled elsewhere (e.g., marital_status_legal, relationship_status_current, time_scope)."
204
249
  },
250
+ {
251
+ "code": "126-002-003-000-000-000-000",
252
+ "key": "intimate_romantic_partner",
253
+ "title": "Intimate / Romantic Partner",
254
+ "selectable": true,
255
+ "parentCode": "126-002-000-000-000-000-000",
256
+ "childCodes": [],
257
+ "definition": "LOCAL EXTENSION (not in canonical CVC-126). Generic romantic-partner type that stays shape-stable across both marital postures: the legally-married vs. dating distinction is captured on the relationship ROW (`is_current_spouse`, `attributes.ties[] = LEGALLY_MARRIED`) rather than by the relationship type, so a partnership does not have to change type when its legal posture changes. The Households & Relationships \"Romantic Partner\" tile hard-locks to this code. Symmetric — an intimate partnership is mutual — so no directional role children. Prefer `spouse_partner` or `dating_relationship` when the asserted fact IS the marital or dating posture itself. Added upstream 2026-05-05 (H&R Phase 2, TILE_RULES extension).",
258
+ "localExtension": true
259
+ },
260
+ {
261
+ "code": "126-002-004-000-000-000-000",
262
+ "key": "intimate_partner_prior",
263
+ "title": "Former intimate partner",
264
+ "selectable": true,
265
+ "parentCode": "126-002-000-000-000-000-000",
266
+ "childCodes": [],
267
+ "definition": "LOCAL EXTENSION (not in canonical CVC-126). Use when an intimate partnership has ENDED. The \"prior\" semantic stays canonically derivable from the relationship row (`relationship_is_active: false` + `relationship_end`); this leaf exists so the picker and the label resolver recognise the code as an Intimate-category type and render \"Former intimate partner\" instead of falling back to the raw code. For active partnerships use `spouse_partner`, `dating_relationship`, or `intimate_romantic_partner` with the appropriate active/end attributes. Symmetric, so no directional role children. Added upstream 2026-05-26 (RWT-NEW-hector-audit-atomic-fixes Fix B); upstream tracker row `RWT-NEW-intimate-partner-prior-canonicalize` proposes either renaming to `spouse_partner` + scope=prior or promoting this code into the codebook.",
268
+ "localExtension": true
269
+ },
205
270
  {
206
271
  "code": "126-003-000-000-000-000-000",
207
272
  "key": "care_household",
@@ -0,0 +1,96 @@
1
+ {
2
+ "domain": "po_petition_basis",
3
+ "name": "Core Protection Order Petition Basis (CVC-213)",
4
+ "version": "1.0.0",
5
+ "_status": "CANONICAL — imported 0.8.13 from the Notion Final CVC codebook (CVC-213, Owner Crysta Price, Status 'Drafted - Needs Review'). The alleged conduct forming the basis of a protection-order petition (IC-62).",
6
+ "_source": "htilabstech/prototype@a596eb9 Protection Orders (IC-62)/core - PO_petition_basis CVC — codebook 1.csv (CVC-213)",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Protection order petition basis"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "213-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
+ "213-000-000-000-000-000-001",
20
+ "213-000-000-000-000-000-002",
21
+ "213-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": "213-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "213-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": "213-000-000-000-000-000-002",
37
+ "key": "anonymous",
38
+ "title": "Anonymous / declined to answer",
39
+ "selectable": true,
40
+ "parentCode": "213-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": "213-000-000-000-000-000-003",
47
+ "key": "data_not_collected",
48
+ "title": "Data not collected",
49
+ "selectable": true,
50
+ "parentCode": "213-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": "213-001-000-000-000-000-000",
57
+ "key": "dv",
58
+ "title": "Domestic Violence / Domestic Abuse",
59
+ "selectable": true,
60
+ "parentCode": null,
61
+ "childCodes": [],
62
+ "definition": "Abuse alleged between family or household members or intimate partners, including physical harm, attempted harm, credible threats, or non-consensual sexual conduct, forming the basis for a protective order petition.",
63
+ "canonicalCode": "DV"
64
+ },
65
+ {
66
+ "code": "213-002-000-000-000-000-000",
67
+ "key": "har",
68
+ "title": "Harassment",
69
+ "selectable": true,
70
+ "parentCode": null,
71
+ "childCodes": [],
72
+ "definition": "Repeated or ongoing unwanted contact or conduct (including stalking) alleged as the basis for a protective order petition, causing distress, fear, or intimidation.",
73
+ "canonicalCode": "HAR"
74
+ },
75
+ {
76
+ "code": "213-003-000-000-000-000-000",
77
+ "key": "sa",
78
+ "title": "Sexual Assault",
79
+ "selectable": true,
80
+ "parentCode": null,
81
+ "childCodes": [],
82
+ "definition": "Non-consensual sexual conduct or attempted conduct alleged as the basis for a protective order petition.",
83
+ "canonicalCode": "SA"
84
+ },
85
+ {
86
+ "code": "213-004-000-000-000-000-000",
87
+ "key": "other",
88
+ "title": "Other Qualifying Conduct",
89
+ "selectable": true,
90
+ "parentCode": null,
91
+ "childCodes": [],
92
+ "definition": "Conduct alleged as the basis for a protective order petition that does not fall within defined categories.",
93
+ "canonicalCode": "OTHER"
94
+ }
95
+ ]
96
+ }
@@ -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
+ }