@htilabs/platform-common-models 0.8.18 → 0.8.19

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.
package/src/cvcs/index.ts CHANGED
@@ -181,6 +181,7 @@ import serviceDeliveryChannelSot from "./serviceDeliveryChannel.v1.0.0.json" wit
181
181
  import whyNotsSot from "./whyNots.v1.0.0.json" with { type: "json" };
182
182
  import citizenshipSot from "./citizenship.v1.0.0.json" with { type: "json" };
183
183
  import countriesSot from "./countries.v1.0.0.json" with { type: "json" };
184
+ import determinationHelperCategoriesSot from "./determinationHelperCategories.v1.0.0.json" with { type: "json" };
184
185
  import traffickingRelevantRoleSot from "./traffickingRelevantRole.v1.0.0.json" with { type: "json" };
185
186
  // Domains that were never exported from this barrel (found by the CVC drift gate).
186
187
  import activityTypeSot from "./activityType.v1.0.0.json" with { type: "json" };
@@ -375,6 +376,7 @@ export {
375
376
  whyNotsSot,
376
377
  citizenshipSot,
377
378
  countriesSot,
379
+ determinationHelperCategoriesSot,
378
380
  traffickingRelevantRoleSot,
379
381
  activityTypeSot,
380
382
  assertionDomainSot,
@@ -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",
@@ -1,54 +1,63 @@
1
1
  {
2
2
  "domain": "relationship_concern",
3
- "name": "Core Relationship Concern (PROVISIONAL CVC-231 — pending codebook ratification)",
4
- "version": "1.0.0",
3
+ "name": "Core Relationship Concern (PROVISIONAL CVC-991 — pending codebook ratification)",
4
+ "version": "1.1.0",
5
+ "_status": {
6
+ "vocabStatus": "provisional-pending-notion-ratification",
7
+ "authoredBy": "platform-common 0.8.1 (`feature/cvc-author-missing-domains`), originally minted at provisional CVC-231. RENUMBERED 231 -> 991 engineer-direct on 2026-08-29 (ships in the next release).",
8
+ "renumber": "RENUMBERED FROM PROVISIONAL 231 ON CVC-231'S RATIFICATION TO THE DETERMINATION HELPER CATEGORIES, 2026-08-28 (Jevon). 231 was never this vocabulary's number — it was a provisional mint taken from the CANONICAL block (<900) at a time when `CVC_INDEX.md` carried no row for it, which is why this domain sat in the drift gate's `INDEX_ABSENT` list rather than in `CANONICAL_BINDING`. With 231 now ratified to the Determination Helper categories, holding it here would be a SQUAT in the exact sense GATE C describes: a wrong number does not merely mislabel the squatter, it makes the slot look occupied and thereby hides the absence of the domain that owns it (`housing_subsidy_types` on CVC-233 is the precedent that cost us `core-DH_state` entirely). Vacating 231 now, BEFORE the next `cvcIndex` pin refresh publishes the DH row, keeps that failure mode from ever arming. This domain has no canonical number of its own, so it moves to the provisional 900-block — the sanctioned escape hatch — rather than to another canonical number.",
9
+ "numberChoice": "991 = the next number above the highest provisional in use (990 `criminal_org_category`). The 900-block gaps below it are NOT free-for-reuse: 930 is claimed by the open `codebook-bridge/proposals/evidence_tier.v1.0.0.json`, and 964 / 981 are VACATED numbers (`assertion_domain` renumbered 964 -> canonical 159; `risk_band` withdrawn at 981 in favour of canonical CVC-238) which the house has deliberately left as historical gaps rather than recycled — the same stable-ordinal discipline `assertionDomain._status` states for its segment-2 gaps. 991 itself was briefly held by `core_information_scope` on the `feat/cvc-236-information-scope` branch and released within that same PR (f9a71b3, \"number core_information_scope at its canonical 236, not provisional 991\"); it never shipped in any release, so it is clean. Verified collision-free against every `src/cvcs/*.json`, `codebook-bridge/proposals/*.json`, and `cvcIndex.pin.json` (which carries no row for 231, 990, 991 or 992).",
10
+ "consumerImpact": "NONE at the type level. Consumers persist KEYS, not wire codes: PAVE binds this domain as `RELATIONSHIP_CONCERNS_KEYS = keysExceptRoot(RelationshipConcernKeys)` and every downstream `z.enum(...)` / Mongoose enum is over those keys. A repo-wide grep of pave-2.0 finds ZERO occurrences of a `\"231-...\"` positional code; the numeral appears only in prose comments and ADR text. Only the generated map VALUES change (`231-*` -> `991-*`) — the key identifiers and TypeScript types are unchanged. Regenerate `src/generated/cvc-enums.ts` (`npm run codegen:cvc`). No production data exists.",
11
+ "ordinals": "Segment-2 ordinals are preserved verbatim across the renumber (001..007 substantive, 000-000-001/002/003 missingness), so the diff is a pure prefix substitution and stays reviewable.",
12
+ "upstreamReconciliation": "Two things. (1) Notion must author this vocabulary and assign it a canonical number, at which point it renumbers out of the 900-block the way `assertion_domain` (964 -> 159) and `core_information_scope` (991 -> 236) did. (2) The Determination Helper categories now own CVC-231 and are NOT authored in platform-common at all — the same gap-behind-a-squat this renumber exists to expose. Authoring them at 231 is a separate item."
13
+ },
5
14
  "levels": {
6
15
  "0": "Unknown or Missing",
7
16
  "1": "Relationship concern"
8
17
  },
9
18
  "entries": [
10
19
  {
11
- "code": "231-000-000-000-000-000-000",
20
+ "code": "991-000-000-000-000-000-000",
12
21
  "key": "missingness_root",
13
22
  "title": "Unknown, Redacted, or Missing",
14
23
  "selectable": false,
15
24
  "parentCode": null,
16
25
  "childCodes": [
17
- "231-000-000-000-000-000-001",
18
- "231-000-000-000-000-000-002",
19
- "231-000-000-000-000-000-003"
26
+ "991-000-000-000-000-000-001",
27
+ "991-000-000-000-000-000-002",
28
+ "991-000-000-000-000-000-003"
20
29
  ],
21
30
  "definition": "Root group for values indicating absent, withheld, or uncollected data."
22
31
  },
23
32
  {
24
- "code": "231-000-000-000-000-000-001",
33
+ "code": "991-000-000-000-000-000-001",
25
34
  "key": "unknown",
26
35
  "title": "Unknown",
27
36
  "selectable": true,
28
- "parentCode": "231-000-000-000-000-000-000",
37
+ "parentCode": "991-000-000-000-000-000-000",
29
38
  "childCodes": [],
30
39
  "definition": "The relationship concern is unknown or cannot be determined from the available information."
31
40
  },
32
41
  {
33
- "code": "231-000-000-000-000-000-002",
42
+ "code": "991-000-000-000-000-000-002",
34
43
  "key": "anonymous",
35
44
  "title": "Anonymous / declined to answer",
36
45
  "selectable": true,
37
- "parentCode": "231-000-000-000-000-000-000",
46
+ "parentCode": "991-000-000-000-000-000-000",
38
47
  "childCodes": [],
39
48
  "definition": "The relationship concern may be withheld by preference or due to redaction; identity is anonymous or redacted."
40
49
  },
41
50
  {
42
- "code": "231-000-000-000-000-000-003",
51
+ "code": "991-000-000-000-000-000-003",
43
52
  "key": "data_not_collected",
44
53
  "title": "Data not collected",
45
54
  "selectable": true,
46
- "parentCode": "231-000-000-000-000-000-000",
55
+ "parentCode": "991-000-000-000-000-000-000",
47
56
  "childCodes": [],
48
57
  "definition": "No attempt was made to collect the relationship concern."
49
58
  },
50
59
  {
51
- "code": "231-001-000-000-000-000-000",
60
+ "code": "991-001-000-000-000-000-000",
52
61
  "key": "appears_controlling",
53
62
  "title": "Appears controlling",
54
63
  "selectable": true,
@@ -57,7 +66,7 @@
57
66
  "definition": "Employer, intimate partner, or family member who appears controlling in relation to the subject."
58
67
  },
59
68
  {
60
- "code": "231-002-000-000-000-000-000",
69
+ "code": "991-002-000-000-000-000-000",
61
70
  "key": "is_much_older",
62
71
  "title": "Is much older (age-disparate)",
63
72
  "selectable": true,
@@ -66,7 +75,7 @@
66
75
  "definition": "Significant age disparity in the relationship — a vulnerability signal, especially for youth."
67
76
  },
68
77
  {
69
- "code": "231-003-000-000-000-000-000",
78
+ "code": "991-003-000-000-000-000-000",
70
79
  "key": "physically_abusive",
71
80
  "title": "Physically abusive",
72
81
  "selectable": true,
@@ -75,7 +84,7 @@
75
84
  "definition": "Reports of physical harm or abuse from this person toward the subject."
76
85
  },
77
86
  {
78
- "code": "231-004-000-000-000-000-000",
87
+ "code": "991-004-000-000-000-000-000",
79
88
  "key": "emotionally_abusive",
80
89
  "title": "Emotionally abusive / threatening",
81
90
  "selectable": true,
@@ -84,7 +93,7 @@
84
93
  "definition": "Emotional abuse, threats, or intimidation by this person toward the subject."
85
94
  },
86
95
  {
87
- "code": "231-005-000-000-000-000-000",
96
+ "code": "991-005-000-000-000-000-000",
88
97
  "key": "has_legal_involvement",
89
98
  "title": "Has relevant legal involvement",
90
99
  "selectable": true,
@@ -93,7 +102,7 @@
93
102
  "definition": "This person has a legal case, protective order, or criminal history relevant to the subject's situation."
94
103
  },
95
104
  {
96
- "code": "231-006-000-000-000-000-000",
105
+ "code": "991-006-000-000-000-000-000",
97
106
  "key": "is_known_trafficker_or_suspect",
98
107
  "title": "Is known or suspected trafficker",
99
108
  "selectable": true,
@@ -102,7 +111,7 @@
102
111
  "definition": "This person is suspected or confirmed as a trafficker in relation to the subject. Complements (does not replace) role assignment via Add-Person."
103
112
  },
104
113
  {
105
- "code": "231-007-000-000-000-000-000",
114
+ "code": "991-007-000-000-000-000-000",
106
115
  "key": "other_concern",
107
116
  "title": "Other concern",
108
117
  "selectable": true,
@@ -1185,7 +1185,7 @@ export type RelationshipTiesKey = keyof typeof RelationshipTiesKeys;
1185
1185
  /**
1186
1186
  * Key → positional code map for the `person_relationships` CVC domain.
1187
1187
  *
1188
- * Domain: `person_relationships` · Version: 1.0.0 · Entries: 89
1188
+ * Domain: `person_relationships` · Version: 1.0.0 · Entries: 94
1189
1189
  */
1190
1190
  export const PersonRelationshipsKeys = {
1191
1191
  missingness_root: "126-000-000-000-000-000-000",
@@ -1204,9 +1204,14 @@ export const PersonRelationshipsKeys = {
1204
1204
  child_of: "126-001-005-001-000-000-000",
1205
1205
  parent_of: "126-001-005-002-000-000-000",
1206
1206
  sibling: "126-001-006-000-000-000-000",
1207
+ parental_figure_dependent: "126-001-007-000-000-000-000",
1208
+ dependent_of_parental_figure: "126-001-007-001-000-000-000",
1209
+ parental_figure_of: "126-001-007-002-000-000-000",
1207
1210
  romantic_partner: "126-002-000-000-000-000-000",
1208
1211
  dating_relationship: "126-002-001-000-000-000-000",
1209
1212
  spouse_partner: "126-002-002-000-000-000-000",
1213
+ intimate_romantic_partner: "126-002-003-000-000-000-000",
1214
+ intimate_partner_prior: "126-002-004-000-000-000-000",
1210
1215
  care_household: "126-003-000-000-000-000-000",
1211
1216
  caregiver_care_recipient: "126-003-001-000-000-000-000",
1212
1217
  care_recipient_of: "126-003-001-001-000-000-000",
@@ -3480,22 +3485,22 @@ export const HtTypeKeys = {
3480
3485
  export type HtTypeKey = keyof typeof HtTypeKeys;
3481
3486
 
3482
3487
  /**
3483
- * Key → positional code map for the `relationship_concern` CVC domain (PROVISIONAL CVC-231 — pending codebook ratification).
3488
+ * Key → positional code map for the `relationship_concern` CVC domain (PROVISIONAL CVC-991 — pending codebook ratification; renumbered from provisional 231 on CVC-231's ratification to the Determination Helper categories, 2026-08-28).
3484
3489
  *
3485
- * Domain: `relationship_concern` · Version: 1.0.0 · Entries: 11
3490
+ * Domain: `relationship_concern` · Version: 1.1.0 · Entries: 11
3486
3491
  */
3487
3492
  export const RelationshipConcernKeys = {
3488
- missingness_root: "231-000-000-000-000-000-000",
3489
- unknown: "231-000-000-000-000-000-001",
3490
- anonymous: "231-000-000-000-000-000-002",
3491
- data_not_collected: "231-000-000-000-000-000-003",
3492
- appears_controlling: "231-001-000-000-000-000-000",
3493
- is_much_older: "231-002-000-000-000-000-000",
3494
- physically_abusive: "231-003-000-000-000-000-000",
3495
- emotionally_abusive: "231-004-000-000-000-000-000",
3496
- has_legal_involvement: "231-005-000-000-000-000-000",
3497
- is_known_trafficker_or_suspect: "231-006-000-000-000-000-000",
3498
- other_concern: "231-007-000-000-000-000-000",
3493
+ missingness_root: "991-000-000-000-000-000-000",
3494
+ unknown: "991-000-000-000-000-000-001",
3495
+ anonymous: "991-000-000-000-000-000-002",
3496
+ data_not_collected: "991-000-000-000-000-000-003",
3497
+ appears_controlling: "991-001-000-000-000-000-000",
3498
+ is_much_older: "991-002-000-000-000-000-000",
3499
+ physically_abusive: "991-003-000-000-000-000-000",
3500
+ emotionally_abusive: "991-004-000-000-000-000-000",
3501
+ has_legal_involvement: "991-005-000-000-000-000-000",
3502
+ is_known_trafficker_or_suspect: "991-006-000-000-000-000-000",
3503
+ other_concern: "991-007-000-000-000-000-000",
3499
3504
  } as const;
3500
3505
 
3501
3506
  export type RelationshipConcernKey = keyof typeof RelationshipConcernKeys;
@@ -5348,6 +5353,73 @@ export const CountryKeys = {
5348
5353
 
5349
5354
  export type CountryKey = keyof typeof CountryKeys;
5350
5355
 
5356
+ /**
5357
+ * Key → positional code map for the `determination_helper_categories` CVC domain (CVC-231, provisional-pending-notion-ratification). The four-section frame an advocate reasons through when assessing a trafficking determination — § I Subject and Scope (5) · § II Activity (20) · § III Means (24) · § IV Status (4) = 53 rows, all selectable, plus the authored 3-value missingness set. `coding_mode: multi_label` — one event may carry several category codes at once (canonical example: nude photos in an escort ad = `2.2.1` + `2.1.3`), so consumers MUST model this as a multi-select. Positional codes are DERIVED from the canonical DOTTED codes rather than minted: each dotted component becomes one 3-digit segment, left to right (`2.1.1` → `231-002-001-001-000-000-000`), and the dotted code also rides on every entry verbatim as `canonicalCode` — reconcile the canonical `feeds_dh_subdomain_crossref` on that field, not on the key.
5358
+ *
5359
+ * Domain: `determination_helper_categories` · Version: 1.0.0 · Entries: 57
5360
+ */
5361
+ export const DeterminationHelperCategoryKeys = {
5362
+ missingness_root: "231-000-000-000-000-000-000",
5363
+ unknown: "231-000-000-000-000-000-001",
5364
+ anonymous: "231-000-000-000-000-000-002",
5365
+ data_not_collected: "231-000-000-000-000-000-003",
5366
+ subject_and_scope: "231-001-000-000-000-000-000",
5367
+ subjects: "231-001-001-000-000-000-000",
5368
+ roles: "231-001-002-000-000-000-000",
5369
+ time_scope: "231-001-003-000-000-000-000",
5370
+ age: "231-001-004-000-000-000-000",
5371
+ activity_action: "231-002-000-000-000-000-000",
5372
+ commercial_sex_activity: "231-002-001-000-000-000-000",
5373
+ commercial_sex_act_csa_linked_sex_act: "231-002-001-001-000-000-000",
5374
+ commercial_sex_solicitation_booking_or_arrangement: "231-002-001-002-000-000-000",
5375
+ commercial_sex_advertising_promotion: "231-002-001-003-000-000-000",
5376
+ other_commercial_sex_activity: "231-002-001-004-000-000-000",
5377
+ sexualized_content_sexual_performance_sexual_communications: "231-002-002-000-000-000-000",
5378
+ sexually_explicit_photo_video_image_activity: "231-002-002-001-000-000-000",
5379
+ online_sexual_performance_interactive_sexual_content: "231-002-002-002-000-000-000",
5380
+ in_person_sexualized_performance_appearance_based_activity: "231-002-002-003-000-000-000",
5381
+ sexual_or_romantic_communications_with_exploitation_relevance: "231-002-002-004-000-000-000",
5382
+ other_sexualized_content_performance_or_communication: "231-002-002-005-000-000-000",
5383
+ sexual_victimization_abuse: "231-002-003-000-000-000-000",
5384
+ labor_or_services: "231-002-004-000-000-000-000",
5385
+ debt_related_work_pledged_services_debt_repayment_arrangement: "231-002-004-001-000-000-000",
5386
+ adverse_work_labor_conditions: "231-002-004-002-000-000-000",
5387
+ criminalized_or_illicit_tasks: "231-002-004-003-000-000-000",
5388
+ recruitment_monitoring_or_control_of_others_as_assigned_activity: "231-002-004-004-000-000-000",
5389
+ other_labor_or_services_activity: "231-002-004-005-000-000-000",
5390
+ facilitation_operational_activities: "231-002-005-000-000-000-000",
5391
+ victim_vulnerabilities: "231-003-000-000-000-000-000",
5392
+ industry_novelty: "231-003-001-000-000-000-000",
5393
+ childhood_household_challenges: "231-003-002-000-000-000-000",
5394
+ experienced_traumas: "231-003-003-000-000-000-000",
5395
+ socioeconomic_circumstances: "231-003-004-000-000-000-000",
5396
+ behavioral_health_risks: "231-003-005-000-000-000-000",
5397
+ aggregated_prior_risk: "231-003-006-000-000-000-000",
5398
+ scheme_plan_pattern: "231-004-000-000-000-000-000",
5399
+ control: "231-004-001-000-000-000-000",
5400
+ deprivation: "231-004-002-000-000-000-000",
5401
+ resistance_reduction: "231-004-003-000-000-000-000",
5402
+ climate_of_fear: "231-004-004-000-000-000-000",
5403
+ threats: "231-004-005-000-000-000-000",
5404
+ harm_consequence_to_fear: "231-005-000-000-000-000-000",
5405
+ economic_housing: "231-005-001-000-000-000-000",
5406
+ family: "231-005-002-000-000-000-000",
5407
+ physical_sexual_emotional: "231-005-003-000-000-000-000",
5408
+ threat_of_harm: "231-005-004-000-000-000-000",
5409
+ legal_immigration: "231-005-005-000-000-000-000",
5410
+ fraud_financial_exploitation: "231-006-000-000-000-000-000",
5411
+ unusual_work_circumstances: "231-006-001-000-000-000-000",
5412
+ exploitative_working_conditions: "231-006-002-000-000-000-000",
5413
+ wage_earnings_exploitation: "231-006-003-000-000-000-000",
5414
+ deception_about_work: "231-006-004-000-000-000-000",
5415
+ victim_offender_status: "231-007-000-000-000-000-000",
5416
+ ht_determination_exploitation_type: "231-007-001-000-000-000-000",
5417
+ victim_status: "231-007-002-000-000-000-000",
5418
+ offender_status: "231-007-003-000-000-000-000",
5419
+ } as const;
5420
+
5421
+ export type DeterminationHelperCategoryKey = keyof typeof DeterminationHelperCategoryKeys;
5422
+
5351
5423
  /**
5352
5424
  * Key → positional code map for the `trafficking_relevant_role` CVC domain (CVC-235, canonical). The 4 top-level supply/demand/enabling/adjacent roles: worker_provider, facilitator_controller, buyer_client_direct_beneficiary, other_associate. Asserting a role does NOT assert victim or offender status.
5353
5425
  *
@@ -233,18 +233,18 @@ type SectionQuestionRef = InferRawDocType<typeof sectionQuestionRefSchema>;
233
233
  declare const guidanceSchema: Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
234
234
  _id: false;
235
235
  }, {
236
- text: string;
237
236
  type: "tip" | "warning" | "prompt";
238
- }, mongoose.Document<unknown, {}, {
239
237
  text: string;
238
+ }, mongoose.Document<unknown, {}, {
240
239
  type: "tip" | "warning" | "prompt";
240
+ text: string;
241
241
  }, {
242
242
  id: string;
243
243
  }, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
244
244
  _id: false;
245
245
  }>> & Omit<{
246
- text: string;
247
246
  type: "tip" | "warning" | "prompt";
247
+ text: string;
248
248
  } & {
249
249
  _id: mongoose.Types.ObjectId;
250
250
  } & {
@@ -252,8 +252,8 @@ declare const guidanceSchema: Schema<any, mongoose.Model<any, any, any, any, any
252
252
  }, "id"> & {
253
253
  id: string;
254
254
  }, unknown, {
255
- text: string;
256
255
  type: "tip" | "warning" | "prompt";
256
+ text: string;
257
257
  } & {
258
258
  _id: mongoose.Types.ObjectId;
259
259
  } & {
@@ -294,18 +294,18 @@ declare const sectionSchemaDefinition: {
294
294
  type: Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
295
295
  _id: false;
296
296
  }, {
297
- text: string;
298
297
  type: "tip" | "warning" | "prompt";
299
- }, mongoose.Document<unknown, {}, {
300
298
  text: string;
299
+ }, mongoose.Document<unknown, {}, {
301
300
  type: "tip" | "warning" | "prompt";
301
+ text: string;
302
302
  }, {
303
303
  id: string;
304
304
  }, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
305
305
  _id: false;
306
306
  }>> & Omit<{
307
- text: string;
308
307
  type: "tip" | "warning" | "prompt";
308
+ text: string;
309
309
  } & {
310
310
  _id: mongoose.Types.ObjectId;
311
311
  } & {
@@ -313,8 +313,8 @@ declare const sectionSchemaDefinition: {
313
313
  }, "id"> & {
314
314
  id: string;
315
315
  }, unknown, {
316
- text: string;
317
316
  type: "tip" | "warning" | "prompt";
317
+ text: string;
318
318
  } & {
319
319
  _id: mongoose.Types.ObjectId;
320
320
  } & {
@@ -233,18 +233,18 @@ type SectionQuestionRef = InferRawDocType<typeof sectionQuestionRefSchema>;
233
233
  declare const guidanceSchema: Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
234
234
  _id: false;
235
235
  }, {
236
- text: string;
237
236
  type: "tip" | "warning" | "prompt";
238
- }, mongoose.Document<unknown, {}, {
239
237
  text: string;
238
+ }, mongoose.Document<unknown, {}, {
240
239
  type: "tip" | "warning" | "prompt";
240
+ text: string;
241
241
  }, {
242
242
  id: string;
243
243
  }, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
244
244
  _id: false;
245
245
  }>> & Omit<{
246
- text: string;
247
246
  type: "tip" | "warning" | "prompt";
247
+ text: string;
248
248
  } & {
249
249
  _id: mongoose.Types.ObjectId;
250
250
  } & {
@@ -252,8 +252,8 @@ declare const guidanceSchema: Schema<any, mongoose.Model<any, any, any, any, any
252
252
  }, "id"> & {
253
253
  id: string;
254
254
  }, unknown, {
255
- text: string;
256
255
  type: "tip" | "warning" | "prompt";
256
+ text: string;
257
257
  } & {
258
258
  _id: mongoose.Types.ObjectId;
259
259
  } & {
@@ -294,18 +294,18 @@ declare const sectionSchemaDefinition: {
294
294
  type: Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
295
295
  _id: false;
296
296
  }, {
297
- text: string;
298
297
  type: "tip" | "warning" | "prompt";
299
- }, mongoose.Document<unknown, {}, {
300
298
  text: string;
299
+ }, mongoose.Document<unknown, {}, {
301
300
  type: "tip" | "warning" | "prompt";
301
+ text: string;
302
302
  }, {
303
303
  id: string;
304
304
  }, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
305
305
  _id: false;
306
306
  }>> & Omit<{
307
- text: string;
308
307
  type: "tip" | "warning" | "prompt";
308
+ text: string;
309
309
  } & {
310
310
  _id: mongoose.Types.ObjectId;
311
311
  } & {
@@ -313,8 +313,8 @@ declare const sectionSchemaDefinition: {
313
313
  }, "id"> & {
314
314
  id: string;
315
315
  }, unknown, {
316
- text: string;
317
316
  type: "tip" | "warning" | "prompt";
317
+ text: string;
318
318
  } & {
319
319
  _id: mongoose.Types.ObjectId;
320
320
  } & {