@htilabs/platform-common-models 0.5.3-beta.4 → 0.7.0-beta.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 (87) hide show
  1. package/README.md +44 -0
  2. package/dist/config/index.cjs +191 -0
  3. package/dist/config/index.cjs.map +1 -0
  4. package/dist/config/index.d.cts +101 -0
  5. package/dist/config/index.d.ts +101 -0
  6. package/dist/config/index.js +165 -0
  7. package/dist/config/index.js.map +1 -0
  8. package/dist/constants/index.cjs +46 -5
  9. package/dist/constants/index.cjs.map +1 -1
  10. package/dist/constants/index.d.cts +1 -1
  11. package/dist/constants/index.d.ts +1 -1
  12. package/dist/constants/index.js +42 -5
  13. package/dist/constants/index.js.map +1 -1
  14. package/dist/cvcs/index.cjs +6874 -2
  15. package/dist/cvcs/index.cjs.map +1 -1
  16. package/dist/cvcs/index.d.cts +7562 -66
  17. package/dist/cvcs/index.d.ts +7562 -66
  18. package/dist/cvcs/index.js +6833 -1
  19. package/dist/cvcs/index.js.map +1 -1
  20. package/dist/index.cjs +7742 -6
  21. package/dist/index.cjs.map +1 -1
  22. package/dist/index.d.cts +1009 -3
  23. package/dist/index.d.ts +1009 -3
  24. package/dist/index.js +7656 -6
  25. package/dist/index.js.map +1 -1
  26. package/dist/{platform-auth-CjC57132.d.cts → platform-auth-C97LpsRd.d.cts} +8 -4
  27. package/dist/{platform-auth-CjC57132.d.ts → platform-auth-C97LpsRd.d.ts} +8 -4
  28. package/dist/schemas/index.cjs +43 -6
  29. package/dist/schemas/index.cjs.map +1 -1
  30. package/dist/schemas/index.d.cts +4 -0
  31. package/dist/schemas/index.d.ts +4 -0
  32. package/dist/schemas/index.js +43 -6
  33. package/dist/schemas/index.js.map +1 -1
  34. package/dist/types/index.d.cts +2 -2
  35. package/dist/types/index.d.ts +2 -2
  36. package/package.json +9 -2
  37. package/src/__tests__/__snapshots__/cvc-sot.snap +160 -0
  38. package/src/__tests__/cvc-sot-snapshot.test.ts +319 -0
  39. package/src/__tests__/cvc-structural.test.ts +40 -0
  40. package/src/__tests__/runtime-contract-validator.test.ts +556 -0
  41. package/src/config/fixtures/valid.yaml +90 -0
  42. package/src/config/index.ts +352 -0
  43. package/src/constants/ic.ts +49 -6
  44. package/src/cvcs/administeringJurisdiction.v1.0.0.json +105 -0
  45. package/src/cvcs/ageBinReporting.v1.0.0.json +114 -0
  46. package/src/cvcs/contactInfoTypes.v1.0.0.json +250 -0
  47. package/src/cvcs/contactSafetyStatus.v1.0.0.json +69 -0
  48. package/src/cvcs/employmentStatus.v1.0.0.json +302 -0
  49. package/src/cvcs/enrollmentApplicationStatus.v1.0.0.json +123 -0
  50. package/src/cvcs/eyeColor.v1.0.0.json +114 -0
  51. package/src/cvcs/facilitatorEntityType.v1.0.0.json +141 -0
  52. package/src/cvcs/facilitatorLabelUsedInSource.v1.0.0.json +159 -0
  53. package/src/cvcs/facilitatorSubrole.v1.0.0.json +381 -0
  54. package/src/cvcs/frequencyCadence.v1.0.0.json +114 -0
  55. package/src/cvcs/genderIdentity.v1.0.0.json +128 -0
  56. package/src/cvcs/hairColor.v1.0.0.json +105 -0
  57. package/src/cvcs/hasTattoos.v1.0.0.json +69 -0
  58. package/src/cvcs/highestEducationLevelCompleted.v1.0.0.json +124 -0
  59. package/src/cvcs/hmisSex.v1.0.0.json +89 -0
  60. package/src/cvcs/homelessStatus.v1.0.0.json +98 -0
  61. package/src/cvcs/incomeBenefitsSources.v1.0.0.json +392 -0
  62. package/src/cvcs/index.ts +80 -0
  63. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +96 -0
  64. package/src/cvcs/juvenileJusticeInvolvementStatus.v1.0.0.json +78 -0
  65. package/src/cvcs/locationType.v1.0.0.json +168 -0
  66. package/src/cvcs/maritalStatusLegal.v1.0.0.json +96 -0
  67. package/src/cvcs/militaryBranch.v1.0.0.json +85 -0
  68. package/src/cvcs/militaryStatus.v1.0.0.json +67 -0
  69. package/src/cvcs/nameType.v1.0.0.json +123 -0
  70. package/src/cvcs/offenderStatus.v1.0.0.json +96 -0
  71. package/src/cvcs/offenderStatusFamily.v1.0.0.json +87 -0
  72. package/src/cvcs/orientationIdentity.v1.0.0.json +97 -0
  73. package/src/cvcs/personRelationships.v1.0.0.json +924 -0
  74. package/src/cvcs/preferredContactMethod.v1.0.0.json +46 -0
  75. package/src/cvcs/pronouns.v1.0.0.json +87 -0
  76. package/src/cvcs/recencyBand.v1.0.0.json +124 -0
  77. package/src/cvcs/referralEntityCategory.v1.0.0.json +439 -0
  78. package/src/cvcs/relationshipStatusCurrent.v1.0.0.json +69 -0
  79. package/src/cvcs/relationshipTies.v1.0.0.json +291 -0
  80. package/src/cvcs/sexProviderSubrole.v1.0.0.json +78 -0
  81. package/src/cvcs/sharePurpose.v1.0.0.json +82 -0
  82. package/src/cvcs/smtType.v1.0.0.json +114 -0
  83. package/src/cvcs/tribes.v1.0.0.json +492 -0
  84. package/src/cvcs/victimStatusFamily.v1.0.0.json +96 -0
  85. package/src/generated/cvc-enums.ts +1048 -0
  86. package/src/index.ts +20 -0
  87. package/src/schemas/common.ts +4 -0
@@ -0,0 +1,123 @@
1
+ {
2
+ "domain": "enrollment_application_status",
3
+ "name": "Core Enrollment/Application Status",
4
+ "version": "1.0.0",
5
+ "levels": {
6
+ "0": "Unknown or Missing",
7
+ "1": "Status"
8
+ },
9
+ "entries": [
10
+ {
11
+ "code": "175-000-000-000-000-000-000",
12
+ "key": "missingness_root",
13
+ "title": "Unknown, Redacted, or Missing",
14
+ "selectable": false,
15
+ "parentCode": null,
16
+ "childCodes": [
17
+ "175-000-000-000-000-000-001",
18
+ "175-000-000-000-000-000-002",
19
+ "175-000-000-000-000-000-003"
20
+ ],
21
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
22
+ },
23
+ {
24
+ "code": "175-000-000-000-000-000-001",
25
+ "key": "unknown",
26
+ "title": "Unknown",
27
+ "selectable": true,
28
+ "parentCode": "175-000-000-000-000-000-000",
29
+ "childCodes": [],
30
+ "definition": "Enrollment/application status is unknown or cannot be determined from the available information."
31
+ },
32
+ {
33
+ "code": "175-000-000-000-000-000-002",
34
+ "key": "anonymous",
35
+ "title": "Anonymous",
36
+ "selectable": true,
37
+ "parentCode": "175-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "Status is intentionally withheld or redacted; also covers cases where the client prefers not to disclose application/enrollment status."
40
+ },
41
+ {
42
+ "code": "175-000-000-000-000-000-003",
43
+ "key": "data_not_collected",
44
+ "title": "Data not collected",
45
+ "selectable": true,
46
+ "parentCode": "175-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "No attempt was made to collect the enrollment/application status."
49
+ },
50
+ {
51
+ "code": "175-001-000-000-000-000-000",
52
+ "key": "approved",
53
+ "title": "Approved",
54
+ "selectable": true,
55
+ "parentCode": null,
56
+ "childCodes": [],
57
+ "definition": "Application was approved and eligibility was confirmed, but benefits or services may not have started yet. Distinct from `active`, which denotes that benefits are currently being received."
58
+ },
59
+ {
60
+ "code": "175-002-000-000-000-000-000",
61
+ "key": "applied",
62
+ "title": "Applied",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "An application has been submitted to the administering entity and awaits review or decision."
67
+ },
68
+ {
69
+ "code": "175-003-000-000-000-000-000",
70
+ "key": "not_applied",
71
+ "title": "Not applied / not seeking",
72
+ "selectable": true,
73
+ "parentCode": null,
74
+ "childCodes": [],
75
+ "definition": "No application has been submitted and the person is not currently seeking enrollment or assistance."
76
+ },
77
+ {
78
+ "code": "175-004-000-000-000-000-000",
79
+ "key": "pending",
80
+ "title": "Pending / in review",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "The application is under review or awaiting a decision from the administering entity."
85
+ },
86
+ {
87
+ "code": "175-005-000-000-000-000-000",
88
+ "key": "active",
89
+ "title": "Active",
90
+ "selectable": true,
91
+ "parentCode": null,
92
+ "childCodes": [],
93
+ "definition": "Enrollment is active and benefits or services are currently being received."
94
+ },
95
+ {
96
+ "code": "175-006-000-000-000-000-000",
97
+ "key": "denied",
98
+ "title": "Denied",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "Application was denied or eligibility was not granted."
103
+ },
104
+ {
105
+ "code": "175-007-000-000-000-000-000",
106
+ "key": "closed",
107
+ "title": "Terminated / closed",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "Previously active or approved enrollment has ended, been terminated, or the case was closed."
112
+ },
113
+ {
114
+ "code": "175-008-000-000-000-000-000",
115
+ "key": "expired",
116
+ "title": "Expired / needs recertification",
117
+ "selectable": true,
118
+ "parentCode": null,
119
+ "childCodes": [],
120
+ "definition": "Enrollment is not currently active because recertification or renewal is needed, or the prior eligibility period expired."
121
+ }
122
+ ]
123
+ }
@@ -0,0 +1,114 @@
1
+ {
2
+ "domain": "eye_color",
3
+ "name": "Core Eye Color",
4
+ "version": "1.0.0",
5
+ "levels": {
6
+ "0": "Unknown or Missing",
7
+ "1": "Eye color"
8
+ },
9
+ "entries": [
10
+ {
11
+ "code": "150-000-000-000-000-000-000",
12
+ "key": "missingness_root",
13
+ "title": "Unknown, Redacted, or Missing",
14
+ "selectable": false,
15
+ "parentCode": null,
16
+ "childCodes": [
17
+ "150-000-000-000-000-000-001",
18
+ "150-000-000-000-000-000-002",
19
+ "150-000-000-000-000-000-003"
20
+ ],
21
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. No prefer_not_to_answer variant — eye color is typically observed/recorded from CJ or media, not self-reported, so the decline option is not applicable per Notion guidance."
22
+ },
23
+ {
24
+ "code": "150-000-000-000-000-000-001",
25
+ "key": "unknown",
26
+ "title": "Unknown",
27
+ "selectable": true,
28
+ "parentCode": "150-000-000-000-000-000-000",
29
+ "childCodes": [],
30
+ "definition": "Value is unknown at time of entry."
31
+ },
32
+ {
33
+ "code": "150-000-000-000-000-000-002",
34
+ "key": "anonymous",
35
+ "title": "Anonymous",
36
+ "selectable": true,
37
+ "parentCode": "150-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "Value is intentionally withheld or redacted."
40
+ },
41
+ {
42
+ "code": "150-000-000-000-000-000-003",
43
+ "key": "data_not_collected",
44
+ "title": "Data not collected",
45
+ "selectable": true,
46
+ "parentCode": "150-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "No attempt was made to collect the value."
49
+ },
50
+ {
51
+ "code": "150-001-000-000-000-000-000",
52
+ "key": "black",
53
+ "title": "Black",
54
+ "selectable": true,
55
+ "parentCode": null,
56
+ "childCodes": [],
57
+ "definition": "Observed eye color is black."
58
+ },
59
+ {
60
+ "code": "150-002-000-000-000-000-000",
61
+ "key": "blue",
62
+ "title": "Blue",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "Observed eye color is blue."
67
+ },
68
+ {
69
+ "code": "150-003-000-000-000-000-000",
70
+ "key": "brown",
71
+ "title": "Brown",
72
+ "selectable": true,
73
+ "parentCode": null,
74
+ "childCodes": [],
75
+ "definition": "Observed eye color is brown."
76
+ },
77
+ {
78
+ "code": "150-004-000-000-000-000-000",
79
+ "key": "gray",
80
+ "title": "Gray",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "Observed eye color is gray."
85
+ },
86
+ {
87
+ "code": "150-005-000-000-000-000-000",
88
+ "key": "green",
89
+ "title": "Green",
90
+ "selectable": true,
91
+ "parentCode": null,
92
+ "childCodes": [],
93
+ "definition": "Observed eye color is green."
94
+ },
95
+ {
96
+ "code": "150-006-000-000-000-000-000",
97
+ "key": "hazel",
98
+ "title": "Hazel",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "Observed eye color is hazel."
103
+ },
104
+ {
105
+ "code": "150-007-000-000-000-000-000",
106
+ "key": "other",
107
+ "title": "Other",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "Observed eye color does not match any of the canonical categories; preserve the raw source value in the consumer's notes if available. Not a missingness marker."
112
+ }
113
+ ]
114
+ }
@@ -0,0 +1,141 @@
1
+ {
2
+ "domain": "facilitator_entity_type",
3
+ "name": "Core Facilitator Entity Type",
4
+ "version": "1.0.0",
5
+ "levels": {
6
+ "0": "Unknown or Missing",
7
+ "1": "Entity/establishment type"
8
+ },
9
+ "entries": [
10
+ {
11
+ "code": "165-001-000-000-000-000-000",
12
+ "key": "individual_person",
13
+ "title": "Individual person",
14
+ "selectable": true,
15
+ "parentCode": null,
16
+ "childCodes": [],
17
+ "definition": "A single person acting as a facilitator, not described as operating through a specific business/establishment entity type."
18
+ },
19
+ {
20
+ "code": "165-002-000-000-000-000-000",
21
+ "key": "call_service",
22
+ "title": "Call service",
23
+ "selectable": true,
24
+ "parentCode": null,
25
+ "childCodes": [],
26
+ "definition": "A call/text/online booking intermediary that connects buyers to providers and coordinates appointments."
27
+ },
28
+ {
29
+ "code": "165-003-000-000-000-000-000",
30
+ "key": "escort_agency",
31
+ "title": "Escort agency",
32
+ "selectable": true,
33
+ "parentCode": null,
34
+ "childCodes": [],
35
+ "definition": "An agency/brand/roster that markets and coordinates escort services (as described by the source)."
36
+ },
37
+ {
38
+ "code": "165-004-000-000-000-000-000",
39
+ "key": "illicit_massage_business",
40
+ "title": "Illicit massage business (IMB)",
41
+ "selectable": true,
42
+ "parentCode": null,
43
+ "childCodes": [],
44
+ "definition": "A massage parlor/spa or massage-business context described as facilitating commercial sex or exploitation."
45
+ },
46
+ {
47
+ "code": "165-005-000-000-000-000-000",
48
+ "key": "brothel_or_residence_operation",
49
+ "title": "Brothel / residence operation",
50
+ "selectable": true,
51
+ "parentCode": null,
52
+ "childCodes": [],
53
+ "definition": "A residence-based or brothel-like establishment context used to facilitate commercial sex or exploitation."
54
+ },
55
+ {
56
+ "code": "165-006-000-000-000-000-000",
57
+ "key": "strip_club_bar_casino_facilitator",
58
+ "title": "Strip club / bar / casino facilitator",
59
+ "selectable": true,
60
+ "parentCode": null,
61
+ "childCodes": [],
62
+ "definition": "A strip club, bar, casino, or similar venue context that facilitates commercial sex activity (as described by the source)."
63
+ },
64
+ {
65
+ "code": "165-007-000-000-000-000-000",
66
+ "key": "staffing_intermediary_or_labor_broker",
67
+ "title": "Staffing intermediary / labor broker",
68
+ "selectable": true,
69
+ "parentCode": null,
70
+ "childCodes": [],
71
+ "definition": "A staffing intermediary, labor broker, contractor chain, or recruitment/placement entity that supplies or manages labor (as described by the source)."
72
+ },
73
+ {
74
+ "code": "165-008-000-000-000-000-000",
75
+ "key": "employer_or_worksite_operator",
76
+ "title": "Employer / worksite operator",
77
+ "selectable": true,
78
+ "parentCode": null,
79
+ "childCodes": [],
80
+ "definition": "An employer, business, or worksite operator framed by the source as the entity context through which labor exploitation is occurring (e.g., farm, factory, restaurant, construction crew)."
81
+ },
82
+ {
83
+ "code": "165-009-000-000-000-000-000",
84
+ "key": "multi_level_enterprise_or_organization",
85
+ "title": "Multi-level enterprise / organization",
86
+ "selectable": true,
87
+ "parentCode": null,
88
+ "childCodes": [],
89
+ "definition": "A structured organization/enterprise (multiple layers/roles) described as facilitating commercial sex activity (e.g., owner + dispatch + recruiters)."
90
+ },
91
+ {
92
+ "code": "165-010-000-000-000-000-000",
93
+ "key": "other_business_or_establishment",
94
+ "title": "Other business / establishment",
95
+ "selectable": true,
96
+ "parentCode": null,
97
+ "childCodes": [],
98
+ "definition": "A business/establishment context that facilitates commercial sex activity but does not fit existing entity-type categories."
99
+ },
100
+ {
101
+ "code": "165-000-000-000-000-000-000",
102
+ "key": "missingness_root",
103
+ "title": "Unknown, Redacted, or Missing",
104
+ "selectable": false,
105
+ "parentCode": null,
106
+ "childCodes": [
107
+ "165-000-000-000-000-000-001",
108
+ "165-000-000-000-000-000-002",
109
+ "165-000-000-000-000-000-003"
110
+ ],
111
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Notion codebook explicitly lists UNK/ANON/DNC for this domain (no PNA)."
112
+ },
113
+ {
114
+ "code": "165-000-000-000-000-000-001",
115
+ "key": "unknown",
116
+ "title": "Unknown",
117
+ "selectable": true,
118
+ "parentCode": "165-000-000-000-000-000-000",
119
+ "childCodes": [],
120
+ "definition": "In scope, but insufficient information to determine facilitator entity type."
121
+ },
122
+ {
123
+ "code": "165-000-000-000-000-000-002",
124
+ "key": "anonymous",
125
+ "title": "Anonymous",
126
+ "selectable": true,
127
+ "parentCode": "165-000-000-000-000-000-000",
128
+ "childCodes": [],
129
+ "definition": "Identity intentionally withheld or redacted. Do not infer an entity type."
130
+ },
131
+ {
132
+ "code": "165-000-000-000-000-000-003",
133
+ "key": "data_not_collected",
134
+ "title": "Data not collected",
135
+ "selectable": true,
136
+ "parentCode": "165-000-000-000-000-000-000",
137
+ "childCodes": [],
138
+ "definition": "The facilitator entity type was not collected in the workflow/source. Distinguish from unknown (asked but not known) and anonymous (asked but withheld)."
139
+ }
140
+ ]
141
+ }
@@ -0,0 +1,159 @@
1
+ {
2
+ "domain": "facilitator_label_used_in_source",
3
+ "name": "Core Facilitator Label Used in Source",
4
+ "version": "1.0.0",
5
+ "levels": {
6
+ "0": "Unknown or Missing",
7
+ "1": "Label"
8
+ },
9
+ "entries": [
10
+ {
11
+ "code": "166-000-000-000-000-000-000",
12
+ "key": "missingness_root",
13
+ "title": "Unknown, Redacted, or Missing",
14
+ "selectable": false,
15
+ "parentCode": null,
16
+ "childCodes": [
17
+ "166-000-000-000-000-000-001",
18
+ "166-000-000-000-000-000-002",
19
+ "166-000-000-000-000-000-003"
20
+ ],
21
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
22
+ },
23
+ {
24
+ "code": "166-000-000-000-000-000-001",
25
+ "key": "unknown",
26
+ "title": "Unknown",
27
+ "selectable": true,
28
+ "parentCode": "166-000-000-000-000-000-000",
29
+ "childCodes": [],
30
+ "definition": "A facilitator label may exist in the source, but it is not known or cannot be recovered (e.g., legacy or imported records missing the original label)."
31
+ },
32
+ {
33
+ "code": "166-000-000-000-000-000-002",
34
+ "key": "anonymous",
35
+ "title": "Anonymous",
36
+ "selectable": true,
37
+ "parentCode": "166-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "Source intentionally withheld or redacted the label/term used for safety or privacy reasons."
40
+ },
41
+ {
42
+ "code": "166-000-000-000-000-000-003",
43
+ "key": "data_not_collected",
44
+ "title": "Data not collected",
45
+ "selectable": true,
46
+ "parentCode": "166-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "The source label was not asked for or not captured (e.g., out of scope for the source instrument)."
49
+ },
50
+ {
51
+ "code": "166-001-000-000-000-000-000",
52
+ "key": "boss",
53
+ "title": "Boss",
54
+ "selectable": true,
55
+ "parentCode": null,
56
+ "childCodes": [],
57
+ "definition": "Source term indicating the facilitator is described as a boss, supervisor, or authority figure (often workplace-framed). Capture canonical operational function(s) such as management, dispatch, or financial control via facilitator_subrole when the narrative supports them."
58
+ },
59
+ {
60
+ "code": "166-002-000-000-000-000-000",
61
+ "key": "bottom",
62
+ "title": "Bottom",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "Source term for a pimp-appointed subordinate who may perform supervisory or operational tasks (e.g., training, monitoring, enforcing rules, collecting money, recruiting). Preserve as a label; capture the canonical operational function(s) via facilitator_subrole when the source provides enough detail."
67
+ },
68
+ {
69
+ "code": "166-003-000-000-000-000-000",
70
+ "key": "boyfriend_or_intimate_partner",
71
+ "title": "Boyfriend / intimate partner",
72
+ "selectable": true,
73
+ "parentCode": null,
74
+ "childCodes": [],
75
+ "definition": "Source term indicating the facilitator is framed as a romantic or intimate partner (often appearing in Romeo-style recruitment narratives). Preserve the relationship framing; map to operational subroles only when the source supports it."
76
+ },
77
+ {
78
+ "code": "166-004-000-000-000-000-000",
79
+ "key": "coyote",
80
+ "title": "Coyote",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "Source term typically describing a smuggler, transporter, or intermediary involved in cross-border movement; in some narratives may also be involved in coercion or exploitation. Record canonical operational function(s) in facilitator_subrole only when the source provides clear functional details."
85
+ },
86
+ {
87
+ "code": "166-005-000-000-000-000-000",
88
+ "key": "fraudulent_job_recruiter",
89
+ "title": "Fraudulent job recruiter",
90
+ "selectable": true,
91
+ "parentCode": null,
92
+ "childCodes": [],
93
+ "definition": "Source term indicating recruitment via a fraudulent job offer, labor placement, or deceptive employment promise. Capture canonical operational function(s) (Recruiter; Labor broker/contractor when applicable) via facilitator_subrole."
94
+ },
95
+ {
96
+ "code": "166-006-000-000-000-000-000",
97
+ "key": "madame",
98
+ "title": "Madame",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "Source term describing an on-site manager or overseer in a venue-based commercial sex context (e.g., brothel, house, or massage-parlor contexts). Preserve source language; map to canonical subroles that reflect the described function when known. Treated as a label, not a gendered person-type."
103
+ },
104
+ {
105
+ "code": "166-007-000-000-000-000-000",
106
+ "key": "neighbor",
107
+ "title": "Neighbor",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "Source term indicating the facilitator is described as a neighbor or community member. Relationship/context label only; map to a canonical facilitator_subrole only when the narrative supports a specific operational function (e.g., recruiter)."
112
+ },
113
+ {
114
+ "code": "166-008-000-000-000-000-000",
115
+ "key": "parent_or_guardian",
116
+ "title": "Parent / guardian",
117
+ "selectable": true,
118
+ "parentCode": null,
119
+ "childCodes": [],
120
+ "definition": "Source term indicating the facilitator is described as a parent, guardian, or caregiver of the person impacted. Relationship label, not a function; capture any operational role (recruitment, control, financial exploitation) separately via facilitator_subrole."
121
+ },
122
+ {
123
+ "code": "166-009-000-000-000-000-000",
124
+ "key": "peer_recruiter",
125
+ "title": "Peer recruiter",
126
+ "selectable": true,
127
+ "parentCode": null,
128
+ "childCodes": [],
129
+ "definition": "Source term indicating recruitment carried out by a peer or someone perceived as similarly situated (e.g., friend, peer, another worker). Relationship/social-position framing; do not infer coercion or offender determination from the label alone."
130
+ },
131
+ {
132
+ "code": "166-010-000-000-000-000-000",
133
+ "key": "pimp",
134
+ "title": "Pimp",
135
+ "selectable": true,
136
+ "parentCode": null,
137
+ "childCodes": [],
138
+ "definition": "Source term used to describe a facilitator or controller in commercial sex. Treated as a label for traceability, not as a canonical operational function or trafficking determination. Pair with canonical facilitator_subrole and offender determinations as separate assertions as needed."
139
+ },
140
+ {
141
+ "code": "166-011-000-000-000-000-000",
142
+ "key": "romeo_recruiter",
143
+ "title": "Romeo recruiter",
144
+ "selectable": true,
145
+ "parentCode": null,
146
+ "childCodes": [],
147
+ "definition": "Source term for a recruitment pattern where a facilitator uses romantic or relationship tactics to recruit, isolate, or control. Preserve the term; record the operational function via facilitator_subrole (typically recruiter, sometimes close-control) as supported by source detail."
148
+ },
149
+ {
150
+ "code": "166-012-000-000-000-000-000",
151
+ "key": "other_source_term",
152
+ "title": "Other source term",
153
+ "selectable": true,
154
+ "parentCode": null,
155
+ "childCodes": [],
156
+ "definition": "Catch-all label when the source uses a term not yet represented in this codebook. Use only when the exact term used by the source is also recorded in adjacent narrative or free-text; avoid overuse, and add new codes for recurring source terms."
157
+ }
158
+ ]
159
+ }