@htilabs/platform-common-models 0.8.10 → 0.8.12

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 (40) hide show
  1. package/dist/constants/index.cjs +2 -0
  2. package/dist/constants/index.cjs.map +1 -1
  3. package/dist/constants/index.d.cts +1 -1
  4. package/dist/constants/index.d.ts +1 -1
  5. package/dist/constants/index.js +2 -0
  6. package/dist/constants/index.js.map +1 -1
  7. package/dist/cvcs/index.cjs +1520 -5
  8. package/dist/cvcs/index.cjs.map +1 -1
  9. package/dist/cvcs/index.d.cts +3300 -1612
  10. package/dist/cvcs/index.d.ts +3300 -1612
  11. package/dist/cvcs/index.js +1513 -5
  12. package/dist/cvcs/index.js.map +1 -1
  13. package/dist/index.cjs +1705 -7
  14. package/dist/index.cjs.map +1 -1
  15. package/dist/index.d.cts +214 -5
  16. package/dist/index.d.ts +214 -5
  17. package/dist/index.js +1691 -7
  18. package/dist/index.js.map +1 -1
  19. package/dist/{platform-auth-BSKYSDKe.d.cts → platform-auth-BwfZ0bxU.d.cts} +1 -1
  20. package/dist/{platform-auth-BSKYSDKe.d.ts → platform-auth-BwfZ0bxU.d.ts} +1 -1
  21. package/dist/schemas/index.cjs.map +1 -1
  22. package/dist/schemas/index.js.map +1 -1
  23. package/dist/types/index.d.cts +2 -2
  24. package/dist/types/index.d.ts +2 -2
  25. package/package.json +1 -1
  26. package/src/__tests__/__snapshots__/cvc-sot.snap +32 -4
  27. package/src/__tests__/cvc-sot-snapshot.test.ts +24 -2
  28. package/src/__tests__/cvc-structural.test.ts +11 -1
  29. package/src/constants/ic.ts +14 -1
  30. package/src/cvcs/{assertionDomain.v1.0.0.json → assertionDomain.v1.1.0.json} +12 -3
  31. package/src/cvcs/{checkInPhase.v1.0.0.json → checkInPhase.v1.1.0.json} +20 -2
  32. package/src/cvcs/coreFunctions.v1.0.0.json +746 -0
  33. package/src/cvcs/coreReferralOutcome.v1.0.0.json +71 -0
  34. package/src/cvcs/index.ts +15 -1
  35. package/src/cvcs/needsAssessmentChangeType.v1.0.0.json +134 -0
  36. package/src/cvcs/riskBand.v1.0.0.json +98 -0
  37. package/src/cvcs/riskCategory.v1.0.0.json +134 -0
  38. package/src/cvcs/roiScope.v1.0.0.json +188 -0
  39. package/src/cvcs/roiStatus.v1.0.0.json +98 -0
  40. package/src/generated/cvc-enums.ts +225 -2
@@ -0,0 +1,71 @@
1
+ {
2
+ "domain": "core_referral_outcome",
3
+ "name": "Core Referral Outcome",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering (975, the free gap in the provisional block); grounded in the HMIS FY2026 Data Standards “P2 Referrals Provided” outcome axis (attained / not attained) and IC-59. The binary outcome axis ONLY — the reason a referral was not attained is a separate vocabulary and is deliberately not folded in here. No prototype `core_referral_outcome.yaml` exists (verified 2026-07-13), so there is no prototype coverage to reconcile against. PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "HMIS FY2026 Data Standards — “P2 Referrals Provided” outcome axis; IC-59",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Referral outcome"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "975-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
+ "975-000-000-000-000-000-001",
20
+ "975-000-000-000-000-000-002",
21
+ "975-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 HMIS P2 outcome axis enumerates only the two substantive outcomes, so the quadruplet is added per SOT convention."
24
+ },
25
+ {
26
+ "code": "975-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "975-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Referral outcome is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "975-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "975-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": "975-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "975-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": "975-001-000-000-000-000-000",
54
+ "key": "attained",
55
+ "title": "Attained",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "The referred-to service or resource was obtained by the client. Maps to the HMIS FY2026 “P2 Referrals Provided” outcome “Attained” (the referral resulted in the client receiving the service)."
60
+ },
61
+ {
62
+ "code": "975-002-000-000-000-000-000",
63
+ "key": "not_attained",
64
+ "title": "Not attained",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "The referred-to service or resource was NOT obtained by the client (declined, ineligible, unavailable, no-show, or lost to follow-up). Maps to the HMIS FY2026 “P2 Referrals Provided” outcome “Not attained”. The REASON a referral was not attained is a separate axis and is not encoded here."
69
+ }
70
+ ]
71
+ }
package/src/cvcs/index.ts CHANGED
@@ -90,7 +90,7 @@ import announcementAudienceScopeSot from "./announcementAudienceScope.v1.0.0.jso
90
90
  import announcementResponseTypeSot from "./announcementResponseType.v1.0.0.json" with { type: "json" };
91
91
  import basisQuickPicksSot from "./basisQuickPicks.v1.0.0.json" with { type: "json" };
92
92
  import checkInActivitySot from "./checkInActivity.v1.0.0.json" with { type: "json" };
93
- import checkInPhaseSot from "./checkInPhase.v1.0.0.json" with { type: "json" };
93
+ import checkInPhaseSot from "./checkInPhase.v1.1.0.json" with { type: "json" };
94
94
  import childBehavioralConcernsSot from "./childBehavioralConcerns.v1.0.0.json" with { type: "json" };
95
95
  import childCustodyArrangementSot from "./childCustodyArrangement.v1.0.0.json" with { type: "json" };
96
96
  import daIncidentArchiveReasonSot from "./daIncidentArchiveReason.v1.0.0.json" with { type: "json" };
@@ -153,6 +153,13 @@ import childChangeTypeSot from "./childChangeType.v1.0.0.json" with { type: "jso
153
153
  import immigrationLegalStatusChangeTypeSot from "./immigrationLegalStatusChangeType.v1.0.0.json" with { type: "json" };
154
154
  import programEnrollmentChangeTypeSot from "./programEnrollmentChangeType.v1.0.0.json" with { type: "json" };
155
155
  import romanticRelationshipChangeTypeSot from "./romanticRelationshipChangeType.v1.0.0.json" with { type: "json" };
156
+ import riskCategorySot from "./riskCategory.v1.0.0.json" with { type: "json" };
157
+ import riskBandSot from "./riskBand.v1.0.0.json" with { type: "json" };
158
+ import coreFunctionsSot from "./coreFunctions.v1.0.0.json" with { type: "json" };
159
+ import needsAssessmentChangeTypeSot from "./needsAssessmentChangeType.v1.0.0.json" with { type: "json" };
160
+ import roiScopeSot from "./roiScope.v1.0.0.json" with { type: "json" };
161
+ import roiStatusSot from "./roiStatus.v1.0.0.json" with { type: "json" };
162
+ import coreReferralOutcomeSot from "./coreReferralOutcome.v1.0.0.json" with { type: "json" };
156
163
 
157
164
  export {
158
165
  serviceCategoriesSot,
@@ -289,4 +296,11 @@ export {
289
296
  immigrationLegalStatusChangeTypeSot,
290
297
  programEnrollmentChangeTypeSot,
291
298
  romanticRelationshipChangeTypeSot,
299
+ riskCategorySot,
300
+ riskBandSot,
301
+ coreFunctionsSot,
302
+ needsAssessmentChangeTypeSot,
303
+ roiScopeSot,
304
+ roiStatusSot,
305
+ coreReferralOutcomeSot,
292
306
  };
@@ -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
+ }
@@ -0,0 +1,98 @@
1
+ {
2
+ "domain": "risk_band",
3
+ "name": "Risk Band",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering; codes/labels sourced verbatim from @hti/scoring (declared SOT) weights/risk.weights.json @ 9b5d654; NAMES ONLY per ADR-CONTRACT-scoring-vocab-model-boundary (weights/cutoffs/leaf-scales stay in @hti/scoring). PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "htilabstech/hti-scoring@9b5d654 weights/risk.weights.json",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Risk band tier"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "981-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
+ "981-000-000-000-000-000-001",
20
+ "981-000-000-000-000-000-002",
21
+ "981-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Variant: 3-value (unknown, anonymous, data_not_collected) under the workspace standard ANON semantic. The @hti/scoring artifact enumerates only the substantive values, so the triplet is added per SOT convention."
24
+ },
25
+ {
26
+ "code": "981-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "981-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Risk band is unknown at time of entry (no scored capture). Distinct from `stable`: an unscored subject has no band, it is not banded low."
33
+ },
34
+ {
35
+ "code": "981-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "981-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": "981-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "981-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": "981-001-000-000-000-000-000",
54
+ "key": "severe",
55
+ "title": "Severe",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Highest-severity band of the canonical five-tier risk banding (@hti/scoring GDR § 9.17). Assigned when the display score meets or exceeds the `severe` cutoff. Scale pin: banding is applied to the 0–10 DISPLAY score (the internal 0–1 form is never banded). Band cutoffs are calibration, NOT vocabulary: they live in @hti/scoring (`RISK_WEIGHTS.bands` in weights/risk.weights.json, consumed by `riskBand()` in src/core/bands.ts) and can be recalibrated without a CVC change. This CVC names the band; it does not define its boundary."
60
+ },
61
+ {
62
+ "code": "981-002-000-000-000-000-000",
63
+ "key": "elevated",
64
+ "title": "Elevated",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Second band of the canonical five-tier risk banding (@hti/scoring GDR § 9.17). Assigned when the display score meets or exceeds the `elevated` cutoff but falls below the `severe` cutoff. Scale pin: banding is applied to the 0–10 DISPLAY score (the internal 0–1 form is never banded). Band cutoffs are calibration, NOT vocabulary: they live in @hti/scoring (`RISK_WEIGHTS.bands` in weights/risk.weights.json, consumed by `riskBand()` in src/core/bands.ts) and can be recalibrated without a CVC change. This CVC names the band; it does not define its boundary."
69
+ },
70
+ {
71
+ "code": "981-003-000-000-000-000-000",
72
+ "key": "review",
73
+ "title": "Review",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Middle band of the canonical five-tier risk banding (@hti/scoring GDR § 9.17). Assigned when the display score meets or exceeds the `review` cutoff but falls below the `elevated` cutoff. Scale pin: banding is applied to the 0–10 DISPLAY score (the internal 0–1 form is never banded). Band cutoffs are calibration, NOT vocabulary: they live in @hti/scoring (`RISK_WEIGHTS.bands` in weights/risk.weights.json, consumed by `riskBand()` in src/core/bands.ts) and can be recalibrated without a CVC change. This CVC names the band; it does not define its boundary."
78
+ },
79
+ {
80
+ "code": "981-004-000-000-000-000-000",
81
+ "key": "watch",
82
+ "title": "Watch",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Fourth band of the canonical five-tier risk banding (@hti/scoring GDR § 9.17). Assigned when the display score meets or exceeds the `watch` cutoff but falls below the `review` cutoff. Scale pin: banding is applied to the 0–10 DISPLAY score (the internal 0–1 form is never banded). Band cutoffs are calibration, NOT vocabulary: they live in @hti/scoring (`RISK_WEIGHTS.bands` in weights/risk.weights.json, consumed by `riskBand()` in src/core/bands.ts) and can be recalibrated without a CVC change. This CVC names the band; it does not define its boundary."
87
+ },
88
+ {
89
+ "code": "981-005-000-000-000-000-000",
90
+ "key": "stable",
91
+ "title": "Stable",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Fall-through floor band of the canonical five-tier risk banding (@hti/scoring GDR § 9.17). Assigned when the display score falls below every cutoff. `stable` is the ONLY band with no cutoff of its own — @hti/scoring's `BandCutoffs` interface (src/core/types.ts) declares exactly four numeric fields (severe, elevated, review, watch) and `riskBand()` returns Stable as the terminal else-branch. NOT a missingness value: an unscored subject (null score) is not banded at all per GDR § 1.2 (missing data is omitted, not labeled) — use the missingness triplet for that, never `stable`. Scale pin: banding is applied to the 0–10 DISPLAY score (the internal 0–1 form is never banded). Band cutoffs are calibration, NOT vocabulary: they live in @hti/scoring (`RISK_WEIGHTS.bands` in weights/risk.weights.json, consumed by `riskBand()` in src/core/bands.ts) and can be recalibrated without a CVC change. This CVC names the band; it does not define its boundary."
96
+ }
97
+ ]
98
+ }
@@ -0,0 +1,134 @@
1
+ {
2
+ "domain": "risk_category",
3
+ "name": "Risk Category",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering; codes/labels sourced verbatim from @hti/scoring (declared SOT) weights/risk.weights.json @ 9b5d654; NAMES ONLY per ADR-CONTRACT-scoring-vocab-model-boundary (weights/cutoffs/leaf-scales stay in @hti/scoring). PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "htilabstech/hti-scoring@9b5d654 weights/risk.weights.json",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Risk assessment category"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "980-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "980-000-000-000-000-000-001",
20
+ "980-000-000-000-000-000-002",
21
+ "980-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Variant: 3-value (unknown, anonymous, data_not_collected) under the workspace standard ANON semantic. The @hti/scoring artifact enumerates only the substantive values, so the triplet is added per SOT convention."
24
+ },
25
+ {
26
+ "code": "980-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "980-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Risk category is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "980-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "980-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld or redacted. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel."
42
+ },
43
+ {
44
+ "code": "980-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "980-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value. System-only sentinel per GLOBAL_DESIGN_RULES."
51
+ },
52
+ {
53
+ "code": "980-001-000-000-000-000-000",
54
+ "key": "cat_i",
55
+ "title": "Qualifying Activity?",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Canonical @hti/scoring category id: `I`. Gating question: is this person engaged in a qualifying activity — a commercial sex act (18 U.S.C. § 1591(e)(3)) or labor/services performed for another's benefit (18 U.S.C. § 1589) — at the time of assessment? Treated as a boolean, not a 0–10 score. We treat 'yes' as confirmed if any source is at disclosed-or-better strength. Descriptive, per CVC-231 § II: activity coding answers 'what happened?', not 'does this legally equal trafficking?'. Why it matters: A confirmed 'yes' is what makes every other row on this page trafficking-relevant. Without it, the same signals describe something else. The arm that confirmed it (commercial sex vs labor/services) is shown on the gate read. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
60
+ },
61
+ {
62
+ "code": "980-002-000-000-000-000-000",
63
+ "key": "cat_ii",
64
+ "title": "Lack of Ability to Legally Consent",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Canonical @hti/scoring category id: `II`. Captures factors that compromise the person's capacity to legally consent to commercial sex: minor age, substance dependence, cognitive disability, active mental health crisis. Why it matters: If a person can't legally consent — because they're a minor or have impaired capacity — commercial sex transactions involving them are trafficking by definition, regardless of other evidence. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
69
+ },
70
+ {
71
+ "code": "980-003-000-000-000-000-000",
72
+ "key": "cat_iii",
73
+ "title": "Entry / Recruitment",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Canonical @hti/scoring category id: `III`. What we know about how the person first entered the qualifying activity — the commercial sex industry (§ 1591) or the compelled labor/services arrangement (§ 1589): age at entry, recruitment pathway, migration/recruitment debt, survival-driven start. Why it matters: Entry as a minor, entry driven by deception, recruitment, or debt, or entry out of survival — any of these means the activity started on coercive or exploitative footing, whichever arm it belongs to. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
78
+ },
79
+ {
80
+ "code": "980-004-000-000-000-000-000",
81
+ "key": "cat_iv",
82
+ "title": "Lack of Autonomy",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Canonical @hti/scoring category id: `IV`. The likelihood of third-party involvement (manager, recruiter, other facilitator) and the severity of that involvement. Includes not being in control of your documents, schedule, or who you see. Why it matters: Signals that someone else controls the work — shared phones, third-party posting, fixed schedules — are how trafficking tends to look in practice. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
87
+ },
88
+ {
89
+ "code": "980-005-000-000-000-000-000",
90
+ "key": "cat_v",
91
+ "title": "Fraud & financial exploitation",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Canonical @hti/scoring category id: `V`. Whether the person has been misled, lied to, or financially exploited by someone benefiting from their being in the industry. How much of their pay do they keep? Does that match what was promised? Why it matters: Withheld earnings, debt bondage, and broken promises about pay are core trafficking mechanisms — they're how 'I'll work for a while' becomes 'I can't leave'. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
96
+ },
97
+ {
98
+ "code": "980-006-000-000-000-000-000",
99
+ "key": "cat_vi",
100
+ "title": "Concerning working conditions",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "Canonical @hti/scoring category id: `VI`. Features of the work environment and advertisements that correlate with exploitation: availability patterns, dangerous services, price anomalies, substance references, outcall-only arrangements. Why it matters: Exploitative or dangerous conditions — always-available, dangerous services, quota-driven, substance-involved — predict vulnerability, whether through trafficking or survival-driven work. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
105
+ },
106
+ {
107
+ "code": "980-007-000-000-000-000-000",
108
+ "key": "cat_vii",
109
+ "title": "Constrained ability to exit",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "Canonical @hti/scoring category id: `VII`. Barriers to leaving: abusive or controlling relationships, withheld identification, dependence on the income for survival, threats, criminal records used as leverage, isolation from support. Why it matters: The harder it is for someone to walk away, the more exploitable they are — abusive relationships, lost ID, survival dependence. This is what 'coercion' looks like operationally. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
114
+ },
115
+ {
116
+ "code": "980-008-000-000-000-000-000",
117
+ "key": "cat_viii",
118
+ "title": "General Vulnerabilities",
119
+ "selectable": true,
120
+ "parentCode": null,
121
+ "childCodes": [],
122
+ "definition": "Canonical @hti/scoring category id: `VIII`. Background vulnerabilities that traffickers often take advantage of: prior traumas, behavioral/health risks, length of time in the industry, social isolation, economic hardship, LGBTQ+ status, age. Why it matters: Homelessness, isolation, prior trauma, and economic hardship are the background conditions traffickers look for and leverage. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
123
+ },
124
+ {
125
+ "code": "980-009-000-000-000-000-000",
126
+ "key": "cat_ix",
127
+ "title": "Network characteristics",
128
+ "selectable": true,
129
+ "parentCode": null,
130
+ "childCodes": [],
131
+ "definition": "Canonical @hti/scoring category id: `IX`. Structural properties of the social and ad network around the person: shared identifiers across many providers, proximity to known facilitators, geographic clustering. Why it matters: If a person was a trafficker in one situation, others connected to them are at higher risk. A person's network — who they share contacts, ads, or geography with — moves their score. (Display metadata only — the category's weight and aggregation fn stay in @hti/scoring weights/risk.weights.json.)"
132
+ }
133
+ ]
134
+ }