@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,109 @@
1
+ {
2
+ "domain": "risk_identification_milestone",
3
+ "name": "Core Risk Identification Milestone (CVC-267)",
4
+ "version": "1.0.0",
5
+ "_status": "CANONICAL -- ratified 2026-08-29 (Crysta knock-out walk). The identification-FUNNEL rung value set: the vocabulary `assertion_value_code` resolves against when `assertion_domain` is `signal_identification` (CVC-159 159-066) or, for `determined`, `investigative_legal` (159-067). Homes the `identification_rung_reached` CAR (Crysta-named 2026-08-23) minted once per subject per rung first reached, deterministic id `ast-t1r-<sid>-<rung>`, retroactively over the derived corpus. The rung CAR is a sibling EVENT record joined to the derived milestone row via `pm_ref`: the derived row remains derived and re-derives, and a milestone row never IS the CAR (spine 5.5). The 2026-05-11 no-CAR ruling STAYS IN FORCE for Track-3 rollups -- this is a carve-out for rung events, not a new default. Modelled as its OWN vocabulary rather than as Level-2 rows inside CVC-159: `AssertionDomainKeys` is consumed as the set of DOMAINS, and folding values into it breaks that contract downstream. Naming guard (Crysta 2026-06-30): identification FUNNEL / pipeline rungs -- never 'identification ladder', a retired synonym for the identity-CONFIDENCE axis `identity_status`.",
6
+ "_source": "htilabstech/prototype Final CVCs core - risk_identification_milestone (CVC-267) + data/cvcs/core_assertion_domain_extensions_signal_identification.yaml (PR #519); Notion 'Signal / identification question' (2026-08-29)",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Identification funnel rung"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "267-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
+ "267-000-000-000-000-000-001",
20
+ "267-000-000-000-000-000-002",
21
+ "267-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": "267-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "267-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "canonicalCode": "UNK",
33
+ "definition": "Unknown or cannot be determined from the available information. NOT a safe default. Distinct from having reached NO rung: a subject who has reached no rung has NO rows at all. The milestone-symmetry `NO_IDENTIFICATION` row is deliberately NOT part of this value set (ruling 2026-08-29, OR2) -- absence of rung CARs IS the no-state, and minting a 'none' assertion would re-assert a derived status."
34
+ },
35
+ {
36
+ "code": "267-000-000-000-000-000-002",
37
+ "key": "anonymous",
38
+ "title": "Anonymous / declined to answer",
39
+ "selectable": true,
40
+ "parentCode": "267-000-000-000-000-000-000",
41
+ "childCodes": [],
42
+ "definition": "Value is intentionally withheld or redacted. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel."
43
+ },
44
+ {
45
+ "code": "267-000-000-000-000-000-003",
46
+ "key": "data_not_collected",
47
+ "title": "Data not collected",
48
+ "selectable": true,
49
+ "parentCode": "267-000-000-000-000-000-000",
50
+ "childCodes": [],
51
+ "definition": "No attempt was made to collect the value. System-only sentinel per GLOBAL_DESIGN_RULES."
52
+ },
53
+ {
54
+ "code": "267-001-000-000-000-000-000",
55
+ "key": "on_radar",
56
+ "title": "On radar",
57
+ "selectable": true,
58
+ "parentCode": null,
59
+ "childCodes": [],
60
+ "ordinal": 1,
61
+ "assertionDomain": "signal_identification",
62
+ "definition": "Rung 1. The subject is known to the system at all. EVERY new person record counts, with the origin kind carried on the derived milestone row (ruling 2026-08-20, confirmed x3). Stored `assertion_domain`: `signal_identification`."
63
+ },
64
+ {
65
+ "code": "267-002-000-000-000-000-000",
66
+ "key": "screened",
67
+ "title": "Screened",
68
+ "selectable": true,
69
+ "parentCode": null,
70
+ "childCodes": [],
71
+ "ordinal": 2,
72
+ "assertionDomain": "signal_identification",
73
+ "definition": "Rung 2. A screening instrument was administered. A CLEAN screening still counts -- the rung measures REACH, not result; results are row data (ruling 2026-08-20, confirmed x3). Stored `assertion_domain`: `signal_identification`."
74
+ },
75
+ {
76
+ "code": "267-003-000-000-000-000-000",
77
+ "key": "at_risk",
78
+ "title": "At risk",
79
+ "selectable": true,
80
+ "parentCode": null,
81
+ "childCodes": [],
82
+ "ordinal": 3,
83
+ "assertionDomain": "signal_identification",
84
+ "definition": "Rung 3. Satisfiable by EITHER an upward risk-band crossing OR a screening `recommended_followup` -- both count, and `satisfied_by` is carried on every row so analysis can separate the sources (ruling 2026-08-20 R1). Stored `assertion_domain`: `signal_identification`."
85
+ },
86
+ {
87
+ "code": "267-004-000-000-000-000-000",
88
+ "key": "assessed",
89
+ "title": "Assessed",
90
+ "selectable": true,
91
+ "parentCode": null,
92
+ "childCodes": [],
93
+ "ordinal": 4,
94
+ "assertionDomain": "signal_identification",
95
+ "definition": "Rung 4. A full assessment was completed. Stored `assertion_domain`: `signal_identification`."
96
+ },
97
+ {
98
+ "code": "267-005-000-000-000-000-000",
99
+ "key": "determined",
100
+ "title": "Determined",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "ordinal": 5,
105
+ "assertionDomain": "investigative_legal",
106
+ "definition": "Rung 5. A determination was reached in a safe setting. A NO-INDICATION determination still counts -- the rung measures reaching a conclusion, not which conclusion (ruling 2026-08-20, confirmed x3). STORED `assertion_domain` is `investigative_legal` (159-067) because CVC-267 TRAFFICKING_STATUS carries that domain; DOCUMENTED under `signal_identification` too (filed-under-both ruling 2026-08-29) without changing what is stored. Cross-population caveat: most determinations on file predate the screening rail, so a subject can legitimately show `determined` with no `screened` above it -- correct, not a broken chain."
107
+ }
108
+ ]
109
+ }
@@ -0,0 +1,139 @@
1
+ {
2
+ "domain": "risk_severity_band",
3
+ "name": "Core Risk Severity Band (CVC-238)",
4
+ "version": "1.0.0",
5
+ "_status": "CANONICAL — VERIFIED. Replaces the WITHDRAWN provisional `risk_band` (CVC-981, shipped in 0.8.11), which duplicated this vocabulary under an invented number AND dropped its load-bearing thresholds. Sourced from `data/cvcs/core_risk_severity_band.yaml` @ prototype HEAD a596eb9 (vocab_status: verified; Notion CVC-238, Owner Crysta Price, Verification 'Verified', Status 'Ready for dev'). IMPORTED FROM THE YAML MIRROR, NOT THE FINAL CSV EXPORT: the Final export's Code column is corrupted with a leading em-dash (`—risk-1` … `—risk-5`); the yaml is clean. KEY SYSTEM: CVC entry keys must match /^[a-z][a-z0-9_]*$/, so the canonical hyphenated codes `risk-1`…`risk-5` are carried verbatim in the `canonicalCode` field and the keys are their underscore transliterations `risk_1`…`risk_5`. THRESHOLDS ARE LOAD-BEARING and are carried here (`lowerBand` 0/20/40/60/80): the milestone band-crossing trigger reads them (upward crossings only). Internal scale is 0–100; the leads-app / prototype display scale is 0–10 (x10). RECONCILED with @hti/scoring @ 9b5d654 `weights/risk.weights.json` `bands` = {severe: 8.0, elevated: 6.0, review: 4.0, watch: 2.0} on the 0–10 DISPLAY scale — these AGREE with CVC-238's `lowerBand` 80/60/40/20 on the 0–100 internal scale (x10), and the band NAMES agree exactly (stable/watch/review/elevated/severe). `stable` is the terminal else-branch and correctly has no cutoff of its own. NO DISAGREEMENT. Cutoffs remain CALIBRATION owned by @hti/scoring and may be recalibrated without a CVC change; the values recorded here are the canonical codebook's own, per ADR-CONTRACT-scoring-vocab-model-boundary. ONE scale applied at TWO scopes: per-person AGGREGATE band (the weighted rollup) and per-indicator ATOMIC severity.",
6
+ "_source": "htilabstech/prototype@a596eb9 data/cvcs/core_risk_severity_band.yaml (CVC-238, verified) + Final CVCs/Risk Signal & Severity (CVC-238)/",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Risk severity band"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "238-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
+ "238-000-000-000-000-000-001",
20
+ "238-000-000-000-000-000-002",
21
+ "238-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 canonical export carries a single L0 `UNK`; the anonymous / data_not_collected sentinels are added per SOT convention."
24
+ },
25
+ {
26
+ "code": "238-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "238-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "canonicalCode": "UNK",
33
+ "definition": "Unknown or cannot be determined from the available information. NOT a safe default: do not treat as a neutral “safe” value in a derived current status, do not persist as a long-term state, and consider excluding from training labels — trigger a follow-up prompt instead. Distinct from `risk_1` (Stable): an unscored subject has no band, it is not banded low."
34
+ },
35
+ {
36
+ "code": "238-000-000-000-000-000-002",
37
+ "key": "anonymous",
38
+ "title": "Anonymous / declined to answer",
39
+ "selectable": true,
40
+ "parentCode": "238-000-000-000-000-000-000",
41
+ "childCodes": [],
42
+ "definition": "Value is intentionally withheld or redacted. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel."
43
+ },
44
+ {
45
+ "code": "238-000-000-000-000-000-003",
46
+ "key": "data_not_collected",
47
+ "title": "Data not collected",
48
+ "selectable": true,
49
+ "parentCode": "238-000-000-000-000-000-000",
50
+ "childCodes": [],
51
+ "definition": "No attempt was made to collect the value. System-only sentinel per GLOBAL_DESIGN_RULES."
52
+ },
53
+ {
54
+ "code": "238-001-000-000-000-000-000",
55
+ "key": "risk_1",
56
+ "title": "Stable",
57
+ "selectable": true,
58
+ "parentCode": null,
59
+ "childCodes": [],
60
+ "definition": "Stable — band 1 of the canonical five-tier risk severity scale (CVC-238). Internal score range 0 – 19 (0–100); display range 0.0 – 1.9 (0–10). As an indicator severity: Protective / autonomy — chooses own clients, sets own schedule. Floor band. Stable is PROTECTIVE, not merely “absent” (load-bearing): the floor explicitly means reassuring/autonomy signals, so they render green and actually pull the score down rather than reading as a neutral zero. NOT a missingness value — an unscored subject is not banded at all (use the missingness quadruplet).",
61
+ "canonicalCode": "risk-1",
62
+ "ordinal": 1,
63
+ "lowerBand": 0,
64
+ "bandRangeInternal": "0 – 19",
65
+ "bandRangeDisplay": "0.0 – 1.9",
66
+ "asIndicator": "Protective / autonomy — chooses own clients, sets own schedule",
67
+ "descriptorVictim": "Few indicators present. Routine follow-up.",
68
+ "descriptorOffender": "Few indicators present. Routine follow-up."
69
+ },
70
+ {
71
+ "code": "238-002-000-000-000-000-000",
72
+ "key": "risk_2",
73
+ "title": "Watch",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Watch — band 2 of the canonical five-tier risk severity scale (CVC-238). Internal score range 20 – 39 (0–100); display range 2.0 – 3.9 (0–10). As an indicator severity: Low-severity context signal.",
78
+ "canonicalCode": "risk-2",
79
+ "ordinal": 2,
80
+ "lowerBand": 20,
81
+ "bandRangeInternal": "20 – 39",
82
+ "bandRangeDisplay": "2.0 – 3.9",
83
+ "asIndicator": "Low-severity context signal",
84
+ "descriptorVictim": "Some signals worth noting. Keep a light watch.",
85
+ "descriptorOffender": "Some signals worth noting. Keep a light watch."
86
+ },
87
+ {
88
+ "code": "238-003-000-000-000-000-000",
89
+ "key": "risk_3",
90
+ "title": "Review",
91
+ "selectable": true,
92
+ "parentCode": null,
93
+ "childCodes": [],
94
+ "definition": "Review — band 3 of the canonical five-tier risk severity scale (CVC-238). Internal score range 40 – 59 (0–100); display range 4.0 – 5.9 (0–10). As an indicator severity: Contextual vulnerability — homelessness, isolation, in CS industry.",
95
+ "canonicalCode": "risk-3",
96
+ "ordinal": 3,
97
+ "lowerBand": 40,
98
+ "bandRangeInternal": "40 – 59",
99
+ "bandRangeDisplay": "4.0 – 5.9",
100
+ "asIndicator": "Contextual vulnerability — homelessness, isolation, in CS industry",
101
+ "descriptorVictim": "Indicators present but mixed. Worth a closer look.",
102
+ "descriptorOffender": "Indicators present but mixed. Worth a closer look."
103
+ },
104
+ {
105
+ "code": "238-004-000-000-000-000-000",
106
+ "key": "risk_4",
107
+ "title": "Elevated",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "Elevated — band 4 of the canonical five-tier risk severity scale (CVC-238). Internal score range 60 – 79 (0–100); display range 6.0 – 7.9 (0–10). As an indicator severity: Control / coercion mechanism — debt, no ID, “turned out”.",
112
+ "canonicalCode": "risk-4",
113
+ "ordinal": 4,
114
+ "lowerBand": 60,
115
+ "bandRangeInternal": "60 – 79",
116
+ "bandRangeDisplay": "6.0 – 7.9",
117
+ "asIndicator": "Control / coercion mechanism — debt, no ID, “turned out”",
118
+ "descriptorVictim": "Converging signals. Prioritise and plan a response.",
119
+ "descriptorOffender": "Converging signals. Prioritise and plan a response."
120
+ },
121
+ {
122
+ "code": "238-005-000-000-000-000-000",
123
+ "key": "risk_5",
124
+ "title": "Severe",
125
+ "selectable": true,
126
+ "parentCode": null,
127
+ "childCodes": [],
128
+ "definition": "Severe — band 5 of the canonical five-tier risk severity scale (CVC-238). Internal score range 80 – 100 (0–100); display range 8.0 – 10.0 (0–10). As an indicator severity: Confirmed harm / coercion — forced sex act, strangulation.",
129
+ "canonicalCode": "risk-5",
130
+ "ordinal": 5,
131
+ "lowerBand": 80,
132
+ "bandRangeInternal": "80 – 100",
133
+ "bandRangeDisplay": "8.0 – 10.0",
134
+ "asIndicator": "Confirmed harm / coercion — forced sex act, strangulation",
135
+ "descriptorVictim": "Strong, consistent indicators. Act now.",
136
+ "descriptorOffender": "Strong, converging facilitation evidence. Act now."
137
+ }
138
+ ]
139
+ }
@@ -0,0 +1,107 @@
1
+ {
2
+ "domain": "roi_method",
3
+ "name": "roiMethod",
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": "ROI delivery method"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "970-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
+ "970-000-000-000-000-000-001",
20
+ "970-000-000-000-000-000-002",
21
+ "970-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "970-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "970-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "The roi_method is unknown or cannot be determined."
33
+ },
34
+ {
35
+ "code": "970-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "970-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld, declined, or redacted."
42
+ },
43
+ {
44
+ "code": "970-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "970-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "970-001-000-000-000-000-000",
54
+ "key": "thread_caseshare",
55
+ "title": "Thread CaseShare",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "ROI delivered via a Thread CaseShare."
60
+ },
61
+ {
62
+ "code": "970-002-000-000-000-000-000",
63
+ "key": "thread_magic_link",
64
+ "title": "Thread magic link",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "ROI delivered via a Thread magic-link referral."
69
+ },
70
+ {
71
+ "code": "970-003-000-000-000-000-000",
72
+ "key": "email",
73
+ "title": "Email",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "ROI delivered by email."
78
+ },
79
+ {
80
+ "code": "970-004-000-000-000-000-000",
81
+ "key": "fax",
82
+ "title": "Fax",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "ROI delivered by fax."
87
+ },
88
+ {
89
+ "code": "970-005-000-000-000-000-000",
90
+ "key": "secure_portal",
91
+ "title": "Secure portal",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "ROI delivered via a secure portal."
96
+ },
97
+ {
98
+ "code": "970-006-000-000-000-000-000",
99
+ "key": "in_person",
100
+ "title": "In person",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "ROI delivered in person."
105
+ }
106
+ ]
107
+ }
@@ -0,0 +1,296 @@
1
+ {
2
+ "domain": "roi_scope",
3
+ "name": "ROI Scope",
4
+ "version": "1.1.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering. 0.8.13: COMPLETED against the canonical 27-item source. 0.8.12 shipped 15 of the canonical 27; the missing 12 are added here. Nothing PAVE shipped was invented — this was purely a gap. Canonical source: `HTI_SHARE_SCOPE_GROUPS` in HTI-LEADS-PAVE-Thread-prototype.html @ HEAD a596eb9 (7 groups x items = 27): identifying (5) + risk (4) + contact (3) + notes (3) + health_accommodation (6) + immigration_legal_status (5) + system (1). The GROUP axis (identifying / risk / contact / notes / health_accommodation / immigration_legal_status / system) is a separate presentation concern and is deliberately NOT modelled as hierarchy rows here — this CVC is the flat item vocabulary that an ROI authorizes. PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "htilabstech/prototype@a596eb9 HTI-LEADS-PAVE-Thread-prototype.html HTI_SHARE_SCOPE_GROUPS",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "ROI scope item"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "983-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
+ "983-000-000-000-000-000-001",
20
+ "983-000-000-000-000-000-002",
21
+ "983-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 scope items, so the quadruplet is added per SOT convention."
24
+ },
25
+ {
26
+ "code": "983-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "983-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "ROI scope item is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "983-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "983-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": "983-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "983-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": "983-001-000-000-000-000-000",
54
+ "key": "names",
55
+ "title": "Names + aliases",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "All logged name entries for the subject. Identifying-information scope group."
60
+ },
61
+ {
62
+ "code": "983-002-000-000-000-000-000",
63
+ "key": "dob",
64
+ "title": "Date of birth",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "The subject's date of birth. Identifying-information scope group."
69
+ },
70
+ {
71
+ "code": "983-003-000-000-000-000-000",
72
+ "key": "addresses",
73
+ "title": "Addresses",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Logged addresses for the subject. Identifying-information scope group."
78
+ },
79
+ {
80
+ "code": "983-004-000-000-000-000-000",
81
+ "key": "additional_ids",
82
+ "title": "Additional identifiers",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Other identifiers entered separately from the primary identity record. Identifying-information scope group."
87
+ },
88
+ {
89
+ "code": "983-005-000-000-000-000-000",
90
+ "key": "demographics",
91
+ "title": "Demographics",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Demographic attributes of the subject. Identifying-information scope group."
96
+ },
97
+ {
98
+ "code": "983-006-000-000-000-000-000",
99
+ "key": "screen_indicators",
100
+ "title": "Screen indicators + risk level",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "Screening indicators and the derived risk level. Risk-related scope group."
105
+ },
106
+ {
107
+ "code": "983-007-000-000-000-000-000",
108
+ "key": "victimization",
109
+ "title": "Victimization determination",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "The recorded victimization determination. Risk-related scope group."
114
+ },
115
+ {
116
+ "code": "983-008-000-000-000-000-000",
117
+ "key": "ida_full",
118
+ "title": "Full IDA answers + notes",
119
+ "selectable": true,
120
+ "parentCode": null,
121
+ "childCodes": [],
122
+ "definition": "The complete In-Depth Assessment instrument response, including notes. Risk-related scope group."
123
+ },
124
+ {
125
+ "code": "983-009-000-000-000-000-000",
126
+ "key": "ida_consid",
127
+ "title": "IDA “Additional considerations”",
128
+ "selectable": true,
129
+ "parentCode": null,
130
+ "childCodes": [],
131
+ "definition": "The IDA free-text “Additional considerations” field. Risk-related scope group."
132
+ },
133
+ {
134
+ "code": "983-010-000-000-000-000-000",
135
+ "key": "contact_info",
136
+ "title": "Contact info + safety preferences",
137
+ "selectable": true,
138
+ "parentCode": null,
139
+ "childCodes": [],
140
+ "definition": "How to reach the subject, plus their contact-safety preferences. Contact & history scope group."
141
+ },
142
+ {
143
+ "code": "983-011-000-000-000-000-000",
144
+ "key": "service_history",
145
+ "title": "Service referrals + needs",
146
+ "selectable": true,
147
+ "parentCode": null,
148
+ "childCodes": [],
149
+ "definition": "Service referrals made and needs recorded for the subject. Contact & history scope group."
150
+ },
151
+ {
152
+ "code": "983-012-000-000-000-000-000",
153
+ "key": "screen_notes",
154
+ "title": "Screen notes",
155
+ "selectable": true,
156
+ "parentCode": null,
157
+ "childCodes": [],
158
+ "definition": "Narrative notes captured during screening. Narrative-notes scope group."
159
+ },
160
+ {
161
+ "code": "983-013-000-000-000-000-000",
162
+ "key": "case_notes",
163
+ "title": "Detailed case notes",
164
+ "selectable": true,
165
+ "parentCode": null,
166
+ "childCodes": [],
167
+ "definition": "Detailed narrative case notes. Narrative-notes scope group."
168
+ },
169
+ {
170
+ "code": "983-014-000-000-000-000-000",
171
+ "key": "background",
172
+ "title": "Background information",
173
+ "selectable": true,
174
+ "parentCode": null,
175
+ "childCodes": [],
176
+ "definition": "Background/narrative context about the subject. Narrative-notes scope group."
177
+ },
178
+ {
179
+ "code": "983-015-000-000-000-000-000",
180
+ "key": "system_info",
181
+ "title": "System metadata",
182
+ "selectable": true,
183
+ "parentCode": null,
184
+ "childCodes": [],
185
+ "definition": "System-level record metadata (identifiers, timestamps, provenance). System-metadata scope group."
186
+ },
187
+ {
188
+ "code": "983-016-000-000-000-000-000",
189
+ "key": "contact_history",
190
+ "title": "Contact history with this agency",
191
+ "selectable": true,
192
+ "parentCode": null,
193
+ "childCodes": [],
194
+ "definition": "Prior contacts/interactions between the subject and this agency. Canonical scope group `contact` (Contact & history)."
195
+ },
196
+ {
197
+ "code": "983-017-000-000-000-000-000",
198
+ "key": "accommodation_needs",
199
+ "title": "Accommodation needs",
200
+ "selectable": true,
201
+ "parentCode": null,
202
+ "childCodes": [],
203
+ "definition": "Accessibility / accommodation needs. Canonical scope group `health_accommodation` (Health & Accommodation)."
204
+ },
205
+ {
206
+ "code": "983-018-000-000-000-000-000",
207
+ "key": "disability_subtypes",
208
+ "title": "Disability types",
209
+ "selectable": true,
210
+ "parentCode": null,
211
+ "childCodes": [],
212
+ "definition": "Disability subtype detail (CVC-914 `disability_subtype`). Canonical scope group `health_accommodation`."
213
+ },
214
+ {
215
+ "code": "983-019-000-000-000-000-000",
216
+ "key": "mental_health_status",
217
+ "title": "Mental health status",
218
+ "selectable": true,
219
+ "parentCode": null,
220
+ "childCodes": [],
221
+ "definition": "Mental health status (CVC-974 `mental_health_status`). Canonical scope group `health_accommodation`."
222
+ },
223
+ {
224
+ "code": "983-020-000-000-000-000-000",
225
+ "key": "substance_use_status",
226
+ "title": "Substance use status",
227
+ "selectable": true,
228
+ "parentCode": null,
229
+ "childCodes": [],
230
+ "definition": "Substance use status (CVC-958 `substance_use_status`). Canonical scope group `health_accommodation`."
231
+ },
232
+ {
233
+ "code": "983-021-000-000-000-000-000",
234
+ "key": "chronic_health_status",
235
+ "title": "Chronic health status",
236
+ "selectable": true,
237
+ "parentCode": null,
238
+ "childCodes": [],
239
+ "definition": "Chronic / ongoing health condition status. Canonical scope group `health_accommodation`."
240
+ },
241
+ {
242
+ "code": "983-022-000-000-000-000-000",
243
+ "key": "hiv_status",
244
+ "title": "HIV status",
245
+ "selectable": true,
246
+ "parentCode": null,
247
+ "childCodes": [],
248
+ "definition": "HIV status (CVC-973 `hiv_status`). No special toggle — the canonical Authorization Model handles the privacy posture. Canonical scope group `health_accommodation`."
249
+ },
250
+ {
251
+ "code": "983-023-000-000-000-000-000",
252
+ "key": "immigration_status",
253
+ "title": "Immigration status",
254
+ "selectable": true,
255
+ "parentCode": null,
256
+ "childCodes": [],
257
+ "definition": "Immigration status: visa type + birth country + relevant flags. Canonical scope group `immigration_legal_status` (Immigration & Legal Status)."
258
+ },
259
+ {
260
+ "code": "983-024-000-000-000-000-000",
261
+ "key": "uscis_alien_number",
262
+ "title": "USCIS A-Number",
263
+ "selectable": true,
264
+ "parentCode": null,
265
+ "childCodes": [],
266
+ "definition": "USCIS Alien Registration Number. Canonical scope group `immigration_legal_status`."
267
+ },
268
+ {
269
+ "code": "983-025-000-000-000-000-000",
270
+ "key": "federal_protection_applications",
271
+ "title": "Federal protection applications",
272
+ "selectable": true,
273
+ "parentCode": null,
274
+ "childCodes": [],
275
+ "definition": "Federal protection applications: T-Visa, Continued Presence, U-Visa, VAWA, Asylum, SIJS. Canonical scope group `immigration_legal_status`."
276
+ },
277
+ {
278
+ "code": "983-026-000-000-000-000-000",
279
+ "key": "tvap_enrollment",
280
+ "title": "TVAP enrollment",
281
+ "selectable": true,
282
+ "parentCode": null,
283
+ "childCodes": [],
284
+ "definition": "Trafficking Victim Assistance Program enrollment (USCRI federal trafficking-survivor grant). Canonical scope group `immigration_legal_status`."
285
+ },
286
+ {
287
+ "code": "983-027-000-000-000-000-000",
288
+ "key": "le_report_status",
289
+ "title": "Law enforcement engagement",
290
+ "selectable": true,
291
+ "parentCode": null,
292
+ "childCodes": [],
293
+ "definition": "Law-enforcement report + interview status (CVC-932 `le_report_status`); relevant for foreign-national cases. Canonical scope group `immigration_legal_status`."
294
+ }
295
+ ]
296
+ }