@htilabs/platform-common-models 0.9.0 → 0.12.0

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 (149) hide show
  1. package/dist/config/index.cjs +85 -0
  2. package/dist/config/index.cjs.map +1 -1
  3. package/dist/config/index.d.cts +94 -4
  4. package/dist/config/index.d.ts +94 -4
  5. package/dist/config/index.js +81 -1
  6. package/dist/config/index.js.map +1 -1
  7. package/dist/constants/index.cjs +456 -181
  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 +453 -169
  12. package/dist/constants/index.js.map +1 -1
  13. package/dist/cvcs/index.cjs +15331 -801
  14. package/dist/cvcs/index.cjs.map +1 -1
  15. package/dist/cvcs/index.d.cts +18167 -2208
  16. package/dist/cvcs/index.d.ts +18167 -2208
  17. package/dist/cvcs/index.js +15282 -801
  18. package/dist/cvcs/index.js.map +1 -1
  19. package/dist/{index-Zu_mOJRn.d.cts → index-CoVr1jIV.d.cts} +1 -1
  20. package/dist/{index-CDoqrfc1.d.ts → index-I-DiX9eQ.d.ts} +1 -1
  21. package/dist/index.cjs +17070 -1056
  22. package/dist/index.cjs.map +1 -1
  23. package/dist/index.d.cts +1638 -12
  24. package/dist/index.d.ts +1638 -12
  25. package/dist/index.js +16969 -1043
  26. package/dist/index.js.map +1 -1
  27. package/dist/models/index.d.cts +2 -2
  28. package/dist/models/index.d.ts +2 -2
  29. package/dist/mongo/index.cjs +384 -0
  30. package/dist/mongo/index.cjs.map +1 -0
  31. package/dist/mongo/index.d.cts +221 -0
  32. package/dist/mongo/index.d.ts +221 -0
  33. package/dist/mongo/index.js +352 -0
  34. package/dist/mongo/index.js.map +1 -0
  35. package/dist/{platform-auth-XVB9aHqR.d.cts → platform-auth-v53r3BhN.d.cts} +19 -75
  36. package/dist/{platform-auth-XVB9aHqR.d.ts → platform-auth-v53r3BhN.d.ts} +19 -75
  37. package/dist/schemas/index.cjs +25 -156
  38. package/dist/schemas/index.cjs.map +1 -1
  39. package/dist/schemas/index.d.cts +25 -25
  40. package/dist/schemas/index.d.ts +25 -25
  41. package/dist/schemas/index.js +25 -156
  42. package/dist/schemas/index.js.map +1 -1
  43. package/dist/services/index.cjs +0 -3
  44. package/dist/services/index.cjs.map +1 -1
  45. package/dist/services/index.js +0 -3
  46. package/dist/services/index.js.map +1 -1
  47. package/dist/types/index.d.cts +2 -2
  48. package/dist/types/index.d.ts +2 -2
  49. package/package.json +9 -1
  50. package/src/__sot__/README.md +56 -0
  51. package/src/__sot__/coreIndicators.pin.json +215 -0
  52. package/src/__sot__/cvcIndex.pin.json +268 -0
  53. package/src/__sot__/scoringEmits.pin.json +176 -0
  54. package/src/__tests__/__snapshots__/cvc-sot.snap +227 -35
  55. package/src/__tests__/cvc-136-scoring-invariant.test.ts +323 -0
  56. package/src/__tests__/cvc-drift-gate.test.ts +603 -0
  57. package/src/__tests__/cvc-sot-snapshot.test.ts +122 -11
  58. package/src/__tests__/cvc-structural.test.ts +56 -1
  59. package/src/__tests__/mongo-verifier.test.ts +502 -0
  60. package/src/__tests__/runtime-contract-validator.test.ts +325 -1
  61. package/src/config/index.ts +197 -6
  62. package/src/constants/ic.ts +512 -206
  63. package/src/constants/service-catalog.ts +4 -2
  64. package/src/cvcs/activityType.v1.0.0.json +143 -0
  65. package/src/cvcs/adminRoles.v1.0.0.json +153 -0
  66. package/src/cvcs/administeringJurisdiction.v1.0.0.json +40 -40
  67. package/src/cvcs/ageBinReporting.v1.0.0.json +40 -40
  68. package/src/cvcs/assertionDomain.v1.1.0.json +629 -0
  69. package/src/cvcs/{checkInPhase.v1.0.0.json → checkInPhase.v1.1.0.json} +20 -2
  70. package/src/cvcs/childChangeType.v1.0.0.json +152 -0
  71. package/src/cvcs/citizenship.v1.0.0.json +3062 -0
  72. package/src/cvcs/contactInfoTypes.v1.0.0.json +40 -40
  73. package/src/cvcs/contactLinkType.v1.0.0.json +89 -0
  74. package/src/cvcs/coreDhState.v1.0.0.json +113 -0
  75. package/src/cvcs/coreFunctions.v1.0.0.json +746 -0
  76. package/src/cvcs/coreIndicators.v1.0.0.json +2840 -0
  77. package/src/cvcs/coreReferralOutcome.v1.0.0.json +71 -0
  78. package/src/cvcs/employmentStatus.v1.0.0.json +60 -60
  79. package/src/cvcs/exploitationType.v1.0.0.json +106 -0
  80. package/src/cvcs/facilitatorEntityType.v1.0.0.json +40 -40
  81. package/src/cvcs/highestEducationLevelCompleted.v1.0.0.json +55 -46
  82. package/src/cvcs/hivStatus.v1.0.0.json +71 -0
  83. package/src/cvcs/hmisCurrentLivingSituation.v1.0.0.json +409 -0
  84. package/src/cvcs/hmisRelationshipToHoh.v1.0.0.json +104 -0
  85. package/src/cvcs/homelessStatus.v1.0.0.json +27 -27
  86. package/src/cvcs/housingSubsidyTypes.v1.0.0.json +161 -0
  87. package/src/cvcs/htType.v1.0.0.json +87 -0
  88. package/src/cvcs/identificationStatus.v1.0.0.json +18 -0
  89. package/src/cvcs/immigrationLegalStatusChangeType.v1.0.0.json +143 -0
  90. package/src/cvcs/incarcerationEpisodeType.v1.0.0.json +106 -0
  91. package/src/cvcs/incidentInvolvementRoles.v1.0.0.json +40 -40
  92. package/src/cvcs/incidentParticipationRoles.v1.0.0.json +40 -40
  93. package/src/cvcs/incomeBenefitsSources.v1.0.0.json +31 -2
  94. package/src/cvcs/index.ts +106 -1
  95. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +28 -18
  96. package/src/cvcs/juvenileJusticeInvolvementStatus.v1.0.0.json +32 -32
  97. package/src/cvcs/livingSituation.v1.0.0.json +213 -0
  98. package/src/cvcs/mentalHealthStatus.v1.0.0.json +71 -0
  99. package/src/cvcs/militaryBranch.v1.0.0.json +20 -20
  100. package/src/cvcs/militaryStatus.v1.0.0.json +20 -20
  101. package/src/cvcs/nameType.v1.0.0.json +40 -40
  102. package/src/cvcs/needsAssessmentChangeType.v1.0.0.json +134 -0
  103. package/src/cvcs/offenderStatus.v1.0.0.json +40 -40
  104. package/src/cvcs/offenderStatusFamily.v1.0.0.json +36 -36
  105. package/src/cvcs/poPetitionBasis.v1.0.0.json +96 -0
  106. package/src/cvcs/poStatus.v1.0.0.json +144 -0
  107. package/src/cvcs/poViolationStatus.v1.0.0.json +76 -0
  108. package/src/cvcs/programEnrollmentChangeType.v1.0.0.json +134 -0
  109. package/src/cvcs/provenanceSourceId.v1.0.0.json +134 -0
  110. package/src/cvcs/radiusBucket.v1.0.0.json +110 -0
  111. package/src/cvcs/recencyBand.v1.0.0.json +104 -39
  112. package/src/cvcs/referralEntityCategory.v1.0.0.json +40 -40
  113. package/src/cvcs/relationshipConcern.v1.0.0.json +114 -0
  114. package/src/cvcs/riskCategory.v1.0.0.json +134 -0
  115. package/src/cvcs/riskSeverityBand.v1.0.0.json +139 -0
  116. package/src/cvcs/roiMethod.v1.0.0.json +107 -0
  117. package/src/cvcs/roiScope.v1.0.0.json +296 -0
  118. package/src/cvcs/roiStatus.v1.0.0.json +106 -0
  119. package/src/cvcs/romanticRelationshipChangeType.v1.0.0.json +162 -0
  120. package/src/cvcs/serviceAudience.v1.0.0.json +96 -0
  121. package/src/cvcs/serviceCategories.v1.0.0.json +44 -44
  122. package/src/cvcs/serviceDeliveryChannel.v1.0.0.json +147 -0
  123. package/src/cvcs/serviceMechanisms.v1.0.0.json +36 -36
  124. package/src/cvcs/serviceStates.v1.0.0.json +55 -33
  125. package/src/cvcs/sessionNoteVisibility.v1.0.0.json +80 -0
  126. package/src/cvcs/sessionTemplate.v1.0.0.json +261 -0
  127. package/src/cvcs/sexProviderSubrole.v1.0.0.json +35 -28
  128. package/src/cvcs/smtType.v1.0.0.json +40 -40
  129. package/src/cvcs/sourceCategory.v1.1.0.json +8 -1
  130. package/src/cvcs/sourceInstrument.v1.0.0.json +458 -0
  131. package/src/cvcs/sourceSubtype.v1.1.0.json +36 -0
  132. package/src/cvcs/sourceSystem.v1.0.0.json +203 -0
  133. package/src/cvcs/specialNeedsDisabilities.v1.0.0.json +143 -0
  134. package/src/cvcs/suggestionSource.v1.0.0.json +71 -0
  135. package/src/cvcs/traffickingRelevantRole.v1.0.0.json +104 -0
  136. package/src/cvcs/userRoles.v1.0.0.json +203 -0
  137. package/src/cvcs/verificationMethod.v1.0.0.json +18 -0
  138. package/src/cvcs/victimAbuseTypes.v1.0.0.json +276 -0
  139. package/src/cvcs/victimStatusFamily.v1.0.0.json +40 -40
  140. package/src/cvcs/whyNots.v1.0.0.json +385 -0
  141. package/src/generated/cvc-enums.ts +1729 -7
  142. package/src/mongo/catalog.ts +65 -0
  143. package/src/mongo/contract.ts +157 -0
  144. package/src/mongo/index.ts +343 -0
  145. package/src/mongo/similarity.ts +133 -0
  146. package/src/mongo/uri.ts +53 -0
  147. package/src/services/cvcRegistryService.ts +1 -1
  148. package/dist/{cvcEntry-0BIB9sen.d.cts → cvcEntry-BCj1OWqL.d.cts} +8 -8
  149. package/dist/{cvcEntry-0BIB9sen.d.ts → cvcEntry-BCj1OWqL.d.ts} +8 -8
@@ -701,13 +701,27 @@ export const IC_56_SERVICE_DELIVERY_CHANNEL = {
701
701
  PHONE: 3,
702
702
  EMAIL_TEXT_CHAT: 4,
703
703
  VIRTUAL: 5,
704
+ // PROVISIONAL — group delivery channels surfaced by the Thread canonical
705
+ // "How was the service delivered?" picker. Authored ahead of codebook /
706
+ // Notion ratification; flagged provisional pending SOT sign-off.
707
+ GROUP_IN_PERSON: 6,
708
+ GROUP_REMOTE: 7,
704
709
  } as const;
705
710
 
706
711
  export type IC56Value =
707
712
  (typeof IC_56_SERVICE_DELIVERY_CHANNEL)[keyof typeof IC_56_SERVICE_DELIVERY_CHANNEL];
708
713
 
709
- /** Level 1 values only (excludes missingness codes). */
710
- export type IC56ChannelValue = 1 | 2 | 3 | 4 | 5;
714
+ /** Level 1 values only (excludes missingness codes). 6/7 are PROVISIONAL. */
715
+ export type IC56ChannelValue = 1 | 2 | 3 | 4 | 5 | 6 | 7;
716
+
717
+ /**
718
+ * PROVISIONAL IC-56 channel values pending codebook ratification.
719
+ * Consumers may gate on this set to surface a "draft" affordance.
720
+ */
721
+ export const IC_56_PROVISIONAL_CHANNELS: ReadonlySet<number> = new Set([
722
+ IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON,
723
+ IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE,
724
+ ]);
711
725
 
712
726
  export const IC_56_LABELS: Record<IC56Value, string> = {
713
727
  [IC_56_SERVICE_DELIVERY_CHANNEL.DATA_NOT_COLLECTED]: "Data Not Collected",
@@ -718,6 +732,8 @@ export const IC_56_LABELS: Record<IC56Value, string> = {
718
732
  [IC_56_SERVICE_DELIVERY_CHANNEL.PHONE]: "Phone",
719
733
  [IC_56_SERVICE_DELIVERY_CHANNEL.EMAIL_TEXT_CHAT]: "Email / Text / Chat",
720
734
  [IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL]: "Virtual",
735
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON]: "Group (in-person)",
736
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE]: "Group (remote)",
721
737
  };
722
738
 
723
739
  export const IC_56_DESCRIPTIONS: Record<IC56Value, string> = {
@@ -734,6 +750,10 @@ export const IC_56_DESCRIPTIONS: Record<IC56Value, string> = {
734
750
  [IC_56_SERVICE_DELIVERY_CHANNEL.EMAIL_TEXT_CHAT]:
735
751
  "Email, text message, or chat",
736
752
  [IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL]: "Virtual / video call",
753
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON]:
754
+ "Group session delivered in person (support group, class, workshop)",
755
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE]:
756
+ "Group session delivered remotely (virtual support group, webinar)",
737
757
  };
738
758
 
739
759
  /**
@@ -751,7 +771,7 @@ export function isIC56Missingness(code: number): boolean {
751
771
  * @returns True if the code represents an actual delivery channel
752
772
  */
753
773
  export function isIC56ValidChannel(code: number): code is IC56ChannelValue {
754
- return code >= 1 && code <= 5;
774
+ return code >= 1 && code <= 7;
755
775
  }
756
776
 
757
777
  /** Options array for dropdown/radio components (Level 1 only). */
@@ -776,6 +796,14 @@ export const IC_56_OPTIONS = [
776
796
  value: IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL,
777
797
  label: IC_56_LABELS[IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL],
778
798
  },
799
+ {
800
+ value: IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON,
801
+ label: IC_56_LABELS[IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON],
802
+ },
803
+ {
804
+ value: IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE,
805
+ label: IC_56_LABELS[IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE],
806
+ },
779
807
  ] as const;
780
808
 
781
809
  // ─── IC-57: Service Audience / Beneficiary ──────────────────────────
@@ -4611,209 +4639,25 @@ export const CVC_157_LABELS: Record<CVC157Value, string> = {
4611
4639
  [CVC_157_RELATIONSHIP_STATUS.ANON]: "Anonymous/Not collected",
4612
4640
  };
4613
4641
 
4614
- // ─── CVC-158: Custody Status ────────────────────────────────────────
4615
- // Status of parental/legal custody for a child.
4616
-
4617
- export const CVC_158_CUSTODY_STATUS = {
4618
- FULL: "full",
4619
- SHARED: "shared",
4620
- NONE: "none",
4621
- PENDING: "pending",
4622
- UNKNOWN: "unknown",
4623
- } as const;
4624
-
4625
- export type CVC158Value =
4626
- (typeof CVC_158_CUSTODY_STATUS)[keyof typeof CVC_158_CUSTODY_STATUS];
4627
-
4628
- export const CVC_158_VALUES = [
4629
- CVC_158_CUSTODY_STATUS.FULL,
4630
- CVC_158_CUSTODY_STATUS.SHARED,
4631
- CVC_158_CUSTODY_STATUS.NONE,
4632
- CVC_158_CUSTODY_STATUS.PENDING,
4633
- CVC_158_CUSTODY_STATUS.UNKNOWN,
4634
- ] as const;
4635
-
4636
- export const CVC_158_LABELS: Record<CVC158Value, string> = {
4637
- [CVC_158_CUSTODY_STATUS.FULL]: "Full custody",
4638
- [CVC_158_CUSTODY_STATUS.SHARED]: "Shared custody",
4639
- [CVC_158_CUSTODY_STATUS.NONE]: "No custody",
4640
- [CVC_158_CUSTODY_STATUS.PENDING]: "Custody pending",
4641
- [CVC_158_CUSTODY_STATUS.UNKNOWN]: "Unknown",
4642
- };
4643
-
4644
- // ─── CVC-159: Relationship Ties ─────────────────────────────────────
4645
- // Structural constraints that bind two people and affect access, obligations,
4646
- // safety planning, and service eligibility. Distinct from relationship dynamics
4647
- // (CVC-145) which captures behavior patterns.
4648
- // Multi-select attribute on a PersonRelationship record.
4649
-
4650
- /**
4651
- * CVC-159 Level 1 Categories
4652
- * High-level groupings of relationship ties.
4653
- */
4654
- export const CVC_159_CATEGORY = {
4655
- HOUSEHOLD_LIVING: "1.1_HOUSEHOLD_LIVING",
4656
- CHILD_FAMILY: "1.2_CHILD_FAMILY",
4657
- LEGAL_FORMAL: "1.3_LEGAL_FORMAL",
4658
- FINANCIAL_RESOURCE: "1.4_FINANCIAL_RESOURCE",
4659
- ACCESS_LOGISTICS: "1.5_ACCESS_LOGISTICS",
4660
- OTHER_FALLBACK: "1.6_OTHER_FALLBACK",
4661
- MISSINGNESS: "0_MISSINGNESS",
4662
- } as const;
4663
-
4664
- export type CVC159Category =
4665
- (typeof CVC_159_CATEGORY)[keyof typeof CVC_159_CATEGORY];
4666
-
4667
- export const CVC_159_CATEGORY_LABELS: Record<CVC159Category, string> = {
4668
- [CVC_159_CATEGORY.HOUSEHOLD_LIVING]: "Household / Living Ties",
4669
- [CVC_159_CATEGORY.CHILD_FAMILY]: "Child / Family Ties",
4670
- [CVC_159_CATEGORY.LEGAL_FORMAL]: "Legal / Formal Ties",
4671
- [CVC_159_CATEGORY.FINANCIAL_RESOURCE]: "Financial / Resource Ties",
4672
- [CVC_159_CATEGORY.ACCESS_LOGISTICS]: "Access / Logistics Ties",
4673
- [CVC_159_CATEGORY.OTHER_FALLBACK]: "Other",
4674
- [CVC_159_CATEGORY.MISSINGNESS]: "Missingness",
4675
- };
4676
-
4677
- /**
4678
- * CVC-159 Relationship Ties codes
4679
- */
4680
- export const CVC_159_RELATIONSHIP_TIES = {
4681
- // Missingness (Level 0)
4682
- DNC: "DNC",
4683
- ANON: "ANON",
4684
- UNK: "UNK",
4685
- // Household / Living (1.1)
4686
- COHABITATING: "COHABITATING",
4687
- SHARED_CARE_ENVIRONMENT: "SHARED_CARE_ENVIRONMENT",
4688
- // Child / Family (1.2)
4689
- HAS_CHILDREN_TOGETHER: "HAS_CHILDREN_TOGETHER",
4690
- CO_PARENTING: "CO_PARENTING",
4691
- FAMILY_CARE_OBLIGATION: "FAMILY_CARE_OBLIGATION",
4692
- // Legal / Formal (1.3)
4693
- LEGALLY_MARRIED: "LEGALLY_MARRIED",
4694
- SHARED_LEGAL_CASE_OR_ORDER: "SHARED_LEGAL_CASE_OR_ORDER",
4695
- CUSTODY_OR_VISITATION_LINK: "CUSTODY_OR_VISITATION_LINK",
4696
- PROTECTIVE_ORDER_LINK: "PROTECTIVE_ORDER_LINK",
4697
- LEGAL_GUARDIANSHIP: "LEGAL_GUARDIANSHIP",
4698
- // Financial / Resource (1.4)
4699
- FINANCIAL_DEPENDENCE: "FINANCIAL_DEPENDENCE",
4700
- SHARED_EMPLOYMENT_OR_INCOME_LINK: "SHARED_EMPLOYMENT_OR_INCOME_LINK",
4701
- SHARED_PROPERTY_OR_LEASE: "SHARED_PROPERTY_OR_LEASE",
4702
- SHARED_FINANCES: "SHARED_FINANCES",
4703
- // Access / Logistics (1.5)
4704
- DOCUMENT_OR_ID_LINK: "DOCUMENT_OR_ID_LINK",
4705
- TRANSPORTATION_DEPENDENCE: "TRANSPORTATION_DEPENDENCE",
4706
- REGULAR_UNAVOIDABLE_CONTACT: "REGULAR_UNAVOIDABLE_CONTACT",
4707
- COMMUNICATION_ACCESS_LINK: "COMMUNICATION_ACCESS_LINK",
4708
- // Other Fallback (1.6)
4709
- OTHER: "OTHER",
4710
- } as const;
4711
-
4712
- export type CVC159Value =
4713
- (typeof CVC_159_RELATIONSHIP_TIES)[keyof typeof CVC_159_RELATIONSHIP_TIES];
4714
-
4715
- export const CVC_159_VALUES = Object.values(
4716
- CVC_159_RELATIONSHIP_TIES,
4717
- ) as readonly CVC159Value[];
4718
-
4719
- export const CVC_159_LABELS: Record<CVC159Value, string> = {
4720
- // Missingness
4721
- [CVC_159_RELATIONSHIP_TIES.DNC]: "Data not collected",
4722
- [CVC_159_RELATIONSHIP_TIES.ANON]: "Anonymous / declined to answer",
4723
- [CVC_159_RELATIONSHIP_TIES.UNK]: "Unknown",
4724
- // Household / Living
4725
- [CVC_159_RELATIONSHIP_TIES.COHABITATING]: "Cohabitating",
4726
- [CVC_159_RELATIONSHIP_TIES.SHARED_CARE_ENVIRONMENT]: "Shared care / supervision environment",
4727
- // Child / Family
4728
- [CVC_159_RELATIONSHIP_TIES.HAS_CHILDREN_TOGETHER]: "Has children together",
4729
- [CVC_159_RELATIONSHIP_TIES.CO_PARENTING]: "Co-parenting",
4730
- [CVC_159_RELATIONSHIP_TIES.FAMILY_CARE_OBLIGATION]: "Family-based care obligation",
4731
- // Legal / Formal
4732
- [CVC_159_RELATIONSHIP_TIES.LEGALLY_MARRIED]: "Legally married",
4733
- [CVC_159_RELATIONSHIP_TIES.SHARED_LEGAL_CASE_OR_ORDER]: "Shared legal case or order",
4734
- [CVC_159_RELATIONSHIP_TIES.CUSTODY_OR_VISITATION_LINK]: "Custody / visitation link",
4735
- [CVC_159_RELATIONSHIP_TIES.PROTECTIVE_ORDER_LINK]: "Protective order link",
4736
- [CVC_159_RELATIONSHIP_TIES.LEGAL_GUARDIANSHIP]: "Legal guardianship",
4737
- // Financial / Resource
4738
- [CVC_159_RELATIONSHIP_TIES.FINANCIAL_DEPENDENCE]: "Financial dependence",
4739
- [CVC_159_RELATIONSHIP_TIES.SHARED_EMPLOYMENT_OR_INCOME_LINK]: "Shared economic activity link",
4740
- [CVC_159_RELATIONSHIP_TIES.SHARED_PROPERTY_OR_LEASE]: "Shared property / lease",
4741
- [CVC_159_RELATIONSHIP_TIES.SHARED_FINANCES]: "Shared finances",
4742
- // Access / Logistics
4743
- [CVC_159_RELATIONSHIP_TIES.DOCUMENT_OR_ID_LINK]: "Document / ID link",
4744
- [CVC_159_RELATIONSHIP_TIES.TRANSPORTATION_DEPENDENCE]: "Transportation dependence",
4745
- [CVC_159_RELATIONSHIP_TIES.REGULAR_UNAVOIDABLE_CONTACT]: "Regular unavoidable contact",
4746
- [CVC_159_RELATIONSHIP_TIES.COMMUNICATION_ACCESS_LINK]: "Communication access link",
4747
- // Other
4748
- [CVC_159_RELATIONSHIP_TIES.OTHER]: "Other",
4749
- };
4750
-
4751
- /**
4752
- * Maps each tie code to its L1 category.
4753
- */
4754
- export const CVC_159_TYPE_TO_CATEGORY: Record<CVC159Value, CVC159Category> = {
4755
- // Missingness
4756
- [CVC_159_RELATIONSHIP_TIES.DNC]: CVC_159_CATEGORY.MISSINGNESS,
4757
- [CVC_159_RELATIONSHIP_TIES.ANON]: CVC_159_CATEGORY.MISSINGNESS,
4758
- [CVC_159_RELATIONSHIP_TIES.UNK]: CVC_159_CATEGORY.MISSINGNESS,
4759
- // Household / Living
4760
- [CVC_159_RELATIONSHIP_TIES.COHABITATING]: CVC_159_CATEGORY.HOUSEHOLD_LIVING,
4761
- [CVC_159_RELATIONSHIP_TIES.SHARED_CARE_ENVIRONMENT]: CVC_159_CATEGORY.HOUSEHOLD_LIVING,
4762
- // Child / Family
4763
- [CVC_159_RELATIONSHIP_TIES.HAS_CHILDREN_TOGETHER]: CVC_159_CATEGORY.CHILD_FAMILY,
4764
- [CVC_159_RELATIONSHIP_TIES.CO_PARENTING]: CVC_159_CATEGORY.CHILD_FAMILY,
4765
- [CVC_159_RELATIONSHIP_TIES.FAMILY_CARE_OBLIGATION]: CVC_159_CATEGORY.CHILD_FAMILY,
4766
- // Legal / Formal
4767
- [CVC_159_RELATIONSHIP_TIES.LEGALLY_MARRIED]: CVC_159_CATEGORY.LEGAL_FORMAL,
4768
- [CVC_159_RELATIONSHIP_TIES.SHARED_LEGAL_CASE_OR_ORDER]: CVC_159_CATEGORY.LEGAL_FORMAL,
4769
- [CVC_159_RELATIONSHIP_TIES.CUSTODY_OR_VISITATION_LINK]: CVC_159_CATEGORY.LEGAL_FORMAL,
4770
- [CVC_159_RELATIONSHIP_TIES.PROTECTIVE_ORDER_LINK]: CVC_159_CATEGORY.LEGAL_FORMAL,
4771
- [CVC_159_RELATIONSHIP_TIES.LEGAL_GUARDIANSHIP]: CVC_159_CATEGORY.LEGAL_FORMAL,
4772
- // Financial / Resource
4773
- [CVC_159_RELATIONSHIP_TIES.FINANCIAL_DEPENDENCE]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4774
- [CVC_159_RELATIONSHIP_TIES.SHARED_EMPLOYMENT_OR_INCOME_LINK]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4775
- [CVC_159_RELATIONSHIP_TIES.SHARED_PROPERTY_OR_LEASE]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4776
- [CVC_159_RELATIONSHIP_TIES.SHARED_FINANCES]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4777
- // Access / Logistics
4778
- [CVC_159_RELATIONSHIP_TIES.DOCUMENT_OR_ID_LINK]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4779
- [CVC_159_RELATIONSHIP_TIES.TRANSPORTATION_DEPENDENCE]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4780
- [CVC_159_RELATIONSHIP_TIES.REGULAR_UNAVOIDABLE_CONTACT]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4781
- [CVC_159_RELATIONSHIP_TIES.COMMUNICATION_ACCESS_LINK]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4782
- // Other
4783
- [CVC_159_RELATIONSHIP_TIES.OTHER]: CVC_159_CATEGORY.OTHER_FALLBACK,
4784
- };
4785
-
4786
- /** UI option type for grouped dropdowns */
4787
- export interface CVC159Option {
4788
- value: CVC159Value;
4789
- label: string;
4790
- category: CVC159Category;
4791
- categoryLabel: string;
4792
- }
4793
-
4794
- /** Generate options array grouped by category */
4795
- export const CVC_159_OPTIONS: readonly CVC159Option[] = Object.entries(
4796
- CVC_159_TYPE_TO_CATEGORY,
4797
- ).map(([value, category]) => ({
4798
- value: value as CVC159Value,
4799
- label: CVC_159_LABELS[value as CVC159Value],
4800
- category,
4801
- categoryLabel: CVC_159_CATEGORY_LABELS[category],
4802
- }));
4803
-
4804
- /** Get selectable options (excludes missingness for most UIs) */
4805
- export const CVC_159_SELECTABLE_OPTIONS: readonly CVC159Option[] =
4806
- CVC_159_OPTIONS.filter((opt) => opt.category !== CVC_159_CATEGORY.MISSINGNESS);
4807
-
4808
- /** Category display order for UI */
4809
- export const CVC_159_CATEGORY_ORDER: readonly CVC159Category[] = [
4810
- CVC_159_CATEGORY.HOUSEHOLD_LIVING,
4811
- CVC_159_CATEGORY.CHILD_FAMILY,
4812
- CVC_159_CATEGORY.LEGAL_FORMAL,
4813
- CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4814
- CVC_159_CATEGORY.ACCESS_LOGISTICS,
4815
- CVC_159_CATEGORY.OTHER_FALLBACK,
4816
- ];
4642
+ // ─── CVC-158 / CVC-159: hand-coded exports REMOVED in 0.8.13 ────────
4643
+ // `CVC_158_CUSTODY_STATUS` (+ CVC_158_VALUES / _LABELS / CVC158Value) and the
4644
+ // `CVC_159_RELATIONSHIP_TIES` family (+ CVC_159_CATEGORY / _CATEGORY_LABELS /
4645
+ // _CATEGORY_ORDER / _VALUES / _LABELS / _TYPE_TO_CATEGORY / _OPTIONS /
4646
+ // _SELECTABLE_OPTIONS / CVC159Value / CVC159Category / CVC159Option) were
4647
+ // deleted here. Every one was verified to have ZERO importers across the repo
4648
+ // and all consumer trees before removal.
4649
+ //
4650
+ // WHY: they held the WRONG numbers and blocked the canonical ones.
4651
+ // - The only BOUND relationship-ties surface is the SOT JSON
4652
+ // `RelationshipTiesKeys` at CVC-158 (`src/cvcs/relationshipTies.v1.0.0.json`),
4653
+ // bound by PAVE and Thread - and live's Final CVC-158 is
4654
+ // `core - relationship ties` (Ready for dev, Verified). 158 is correct there.
4655
+ // - Live's Final CVC-159 is `core - assertion_domain` (Ready for dev, Verified,
4656
+ // corroborated by 17 `core_assertion_domain_extensions_*.yaml`). Deleting the
4657
+ // hand-coded CVC_159_* family FREES 159, and `assertion_domain` is renumbered
4658
+ // 964 -> 159 in this release (`src/cvcs/assertionDomain.v1.1.0.json`).
4659
+ // - Custody has no canonical number upstream; it survives as the provisional
4660
+ // `child_custody_arrangement` (CVC-910).
4817
4661
 
4818
4662
  // ─── CVC-126: Person Relationships ─────────────────────────────────
4819
4663
  // Standard person-to-person relationship types with L1 category groupings.
@@ -5401,6 +5245,468 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5401
5245
  categoryLabel: CVC_136_CATEGORY_LABELS[category],
5402
5246
  }));
5403
5247
 
5248
+ // ─── CVC-136: full core-indicators value set (CANONICAL, 210 codes) ─────
5249
+ // The complete CVC-136 'core - indicators' vocabulary. As of 0.8.13 the
5250
+ // AUTHORITATIVE surface for this domain is the SOT JSON
5251
+ // `src/cvcs/coreIndicators.v1.0.0.json` (214 entries = 210 substantive + the
5252
+ // missingness quadruplet), which also carries the canonical `family`,
5253
+ // `polarity`, `severity`, `isAlert` and `alertWhen` entry attributes. This
5254
+ // hand-coded array is kept in lockstep with that JSON as a flat key list for
5255
+ // existing importers; it is generated FROM it and must not diverge.
5256
+ //
5257
+ // 0.8.13 — 199 → 210 (canonical realignment).
5258
+ // Source: `data/core_indicators.yaml` @ prototype HEAD a596eb9 (208 codes)
5259
+ // + 2 codes @hti/scoring emits but the codebook has not yet adopted
5260
+ // (`coercive_debt_pressure_youth`, `debt_terms_deceptive_youth`).
5261
+ // • WITHDRAWN 54 invented rollup codes (`vc_*` ×21, `csi_*` ×20,
5262
+ // `csctx_*` ×6, `dv_*` ×3, `net_*`, `auto_*`): zero occurrences at
5263
+ // prototype HEAD, zero consumers in @hti/scoring's `emits_by_code`.
5264
+ // The rollup axis they were groping toward already exists upstream as
5265
+ // the `family` attribute (9 values), now carried on every entry.
5266
+ // • WITHDRAWN `unusual_work_circumstances_general`: coined from a label's
5267
+ // parenthetical. The canonical `unusual_work_circumstances` exists and
5268
+ // is consumed by @hti/scoring; it is now shipped.
5269
+ // • ADDED the 66 canonical codes that were missing.
5270
+ // Math: 199 − 1 − 54 + 66 = 210.
5271
+ // HARD INVARIANT: every one of the 169 codes in @hti/scoring's
5272
+ // `emits_by_code` (weights/risk.weights.json @ 9b5d654) is present here.
5273
+ // Enforced by `src/__tests__/cvc-136-scoring-invariant.test.ts`.
5274
+ //
5275
+ // CVC_136_ALERT_INDICATOR above is a legacy Thread-only surface with NO
5276
+ // canonical basis; it is deliberately left untouched in 0.8.13 (a separate
5277
+ // Thread cleanup). The canonical alert axis is the `isAlert` ATTRIBUTE on
5278
+ // the CVC-136 JSON entries — the alert list is a DERIVED VIEW, not a rival
5279
+ // taxonomy. The 6-category UI grouping is likewise not in the SOT and stays
5280
+ // scoped to CVC_136_ALERT_INDICATOR.
5281
+ export const CVC_136_CORE_INDICATOR_VALUES = [
5282
+ "abuser_evading_legal_consequences",
5283
+ "abuser_has_weapon",
5284
+ "abuser_substance_use",
5285
+ "abuser_threatened_suicide",
5286
+ "abuser_unemployed",
5287
+ "access_to_vulnerable_individuals",
5288
+ "acknowledgement_or_report_of_human_trafficking",
5289
+ "ads_available_247",
5290
+ "ads_imply_multiple_workers",
5291
+ "ads_prost_slang",
5292
+ "adverse_childhood_household_challenges",
5293
+ "advertised_new_to_area",
5294
+ "appears_controlling_relationship",
5295
+ "appears_turned_out_or_trained_ad_patterns",
5296
+ "association_commercial_sex",
5297
+ "atypical_or_high_risk_payment_method",
5298
+ "autonomy_access_healthcare_without_fear",
5299
+ "autonomy_choice_in_clients",
5300
+ "autonomy_choice_in_services",
5301
+ "autonomy_controls_own_docs",
5302
+ "autonomy_controls_own_finances",
5303
+ "autonomy_organizes_own_travel",
5304
+ "autonomy_posts_own_ads",
5305
+ "autonomy_sets_own_schedule",
5306
+ "autonomy_sets_up_own_dates",
5307
+ "battered_while_pregnant_history",
5308
+ "branding_or_unusual_tattoos_tied_to_control",
5309
+ "cannot_stop_working_or_freely_leave",
5310
+ "child_not_abusers_in_household",
5311
+ "child_welfare_system_involvement",
5312
+ "coerced_to_misrepresent_identity_or_activity",
5313
+ "coercive_debt_pressure",
5314
+ "coercive_debt_pressure_youth",
5315
+ "coercive_migration_or_forced_travel",
5316
+ "cognitive_or_functional_impairment_affecting_consent",
5317
+ "commercial_sex_association_words_or_places",
5318
+ "concerning_mannerisms_anxious_fearful_depressed",
5319
+ "concerning_sexual_behavior_pattern",
5320
+ "constraints_due_to_legal_status",
5321
+ "control_quota_required",
5322
+ "cs_activity_criminal_org_connection",
5323
+ "cs_industry_related_criminal_history",
5324
+ "current_injuries_from_abuser",
5325
+ "current_mental_health_services",
5326
+ "currently_minor_in_commercial_sex",
5327
+ "dangerous_services_no_protection",
5328
+ "dangerous_services_requires_protection",
5329
+ "dangerous_services_willing_anything",
5330
+ "debt_terms_deceptive",
5331
+ "debt_terms_deceptive_youth",
5332
+ "denied_basic_needs",
5333
+ "depends_on_employer_for_immigration_status",
5334
+ "does_not_control_finances_or_earnings",
5335
+ "does_not_control_identity_documents",
5336
+ "elevated_lethality_risk_signal",
5337
+ "employer_keeps_pay_or_pays_less_than_expected",
5338
+ "engages_in_commercial_sex_act",
5339
+ "entered_commercial_sex_industry_as_minor",
5340
+ "entered_cs_due_to_survival_needs",
5341
+ "entered_into_network_of_sex_providers_early",
5342
+ "exploitative_pricing_tier_low",
5343
+ "exploitative_working_conditions",
5344
+ "fled_conflict_violence_or_persecution",
5345
+ "forced_to_commit_crimes",
5346
+ "forced_to_use_false_documents",
5347
+ "foreign_born_or_recently_arrived",
5348
+ "foreign_born_risk_factors",
5349
+ "frequent_changes_in_residence",
5350
+ "frequent_travel_or_location_changes",
5351
+ "frequently_at_hotels_or_many_hotel_keys",
5352
+ "harmful_coping_behaviors",
5353
+ "has_ads_on_commercial_sex_site",
5354
+ "has_facilitators_involved",
5355
+ "has_management_or_representation",
5356
+ "has_no_personal_items_or_possessions",
5357
+ "head_injury_history",
5358
+ "head_injury_loss_of_consciousness",
5359
+ "health_related_vulnerability",
5360
+ "hierarchical_management_structure_identified",
5361
+ "high_risk_sexual_behavior",
5362
+ "high_security_measures_at_work_or_living_location",
5363
+ "highly_irregular_school_attendance",
5364
+ "history_emotional_abuse",
5365
+ "history_of_head_injury",
5366
+ "history_of_mental_health_issues",
5367
+ "history_of_running_away_or_missing_from_care",
5368
+ "history_of_strangulation",
5369
+ "history_physical_or_sexual_abuse_or_dv",
5370
+ "homeless_or_unstably_housed",
5371
+ "immigration_related_exploitation_risk",
5372
+ "in_commercial_sex_industry_recorded",
5373
+ "inability_to_account_for_self",
5374
+ "intimate_partner_violence_reported_to_law_enforcement",
5375
+ "juvenile_justice_or_child_welfare_involvement",
5376
+ "juvenile_justice_system_involvement",
5377
+ "labor_services_activity_recorded",
5378
+ "lgbtq_individual",
5379
+ "limited_english_proficiency",
5380
+ "limited_independence",
5381
+ "lives_or_sleeps_at_place_of_work",
5382
+ "living_with_abuser",
5383
+ "macro_level_economic_duress_entry_exit",
5384
+ "meets_or_has_sex_with_internet_contacts",
5385
+ "monitored_or_isolated_by_controlling_party",
5386
+ "much_older_intimate_partner",
5387
+ "nervous_about_immigration_documentation",
5388
+ "network_aggregate_risk_score_high",
5389
+ "network_multiple_sex_providers_named",
5390
+ "network_stable_size_large",
5391
+ "network_trafficker_present",
5392
+ "network_violent_person_present",
5393
+ "new_to_commercial_sex_industry",
5394
+ "non_consensual_photography_or_recording",
5395
+ "not_in_control_of_immigration_documentation",
5396
+ "other_instability_or_vulnerability_factors",
5397
+ "owes_money_and_cannot_pay_off",
5398
+ "paid_or_owes_fee_to_arrange_travel_to_us",
5399
+ "paid_or_owes_recruitment_fee_to_employer",
5400
+ "parent_or_guardian_of_minor_subject_named",
5401
+ "past_phases_prior_trafficking_or_risk",
5402
+ "payment_routed_through_third_party",
5403
+ "pending_federal_protection",
5404
+ "performing_different_work_than_promised",
5405
+ "physical_violence_increasing",
5406
+ "poverty_or_severe_financial_strain",
5407
+ "precarious_immigration_status",
5408
+ "pressured_or_forced_sex_act",
5409
+ "prior_medical_attention_from_abuse",
5410
+ "prior_tvap_disconnection",
5411
+ "prior_victimization_or_abuse_history",
5412
+ "promise_of_work_different_than_current_work",
5413
+ "received_things_of_value_while_missing_from_care",
5414
+ "recent_le_engagement",
5415
+ "recruited_by_third_party_into_cs_industry",
5416
+ "regular_alcohol_use",
5417
+ "relies_on_temporary_resources_for_basic_needs",
5418
+ "reports_physical_harm_by_employer_or_partner",
5419
+ "reports_physical_harm_to_others_by_employer_or_partner",
5420
+ "restrictive_living_or_working_conditions",
5421
+ "restrictive_or_not_understood_contract",
5422
+ "risk_factors_commercial_sex",
5423
+ "serious_substance_use_or_introduced_to_drugs",
5424
+ "several_cell_phones_or_frequent_number_changes",
5425
+ "sex_acts_in_own_residence",
5426
+ "sexual_exploitation",
5427
+ "sexualized_content_performance_activity",
5428
+ "shared_contact_network",
5429
+ "signs_of_physical_abuse_confinement_or_neglect",
5430
+ "signs_of_physical_harm_or_abuse",
5431
+ "sleep_disturbance",
5432
+ "social_isolation_or_no_supportive_relationships",
5433
+ "stalking_property_intrusion",
5434
+ "stalking_surveillance",
5435
+ "stalking_unwanted_contact",
5436
+ "strangulation_acute_symptoms",
5437
+ "strangulation_choking_assault_detail",
5438
+ "strangulation_loss_of_consciousness",
5439
+ "strangulation_repeated",
5440
+ "subject_affiliated_org_trafficking_activity",
5441
+ "subject_arrested_dv_sv_cs",
5442
+ "subject_gang_org_affiliation",
5443
+ "subject_has_illegal_weapons",
5444
+ "subject_is_sex_offender",
5445
+ "subject_legally_barred_weapons",
5446
+ "subject_perpetrated_abuse_history",
5447
+ "subject_perpetrated_emotional_stalking_current",
5448
+ "subject_perpetrated_emotional_stalking_past",
5449
+ "subject_perpetrated_ipv_current",
5450
+ "subject_perpetrated_ipv_past",
5451
+ "subject_perpetrated_physical_abuse_current",
5452
+ "subject_perpetrated_physical_abuse_past",
5453
+ "subject_perpetrated_sexual_abuse_current",
5454
+ "subject_perpetrated_sexual_abuse_past",
5455
+ "subject_violent_felony",
5456
+ "substance_use_while_working",
5457
+ "suicidal_ideation_history",
5458
+ "suicidal_ideation_recent",
5459
+ "suicide_attempt_history",
5460
+ "third_party_advertises_or_posts_for_person",
5461
+ "third_party_arranged_commercial_sex_acts",
5462
+ "threats_by_employer_or_partner",
5463
+ "threats_of_harm",
5464
+ "threats_of_legal_trouble_or_deportation",
5465
+ "threats_related_to_migration_debt",
5466
+ "threats_to_family_friends_or_close_associates",
5467
+ "threats_to_kill_victim_or_children",
5468
+ "trafficking_experience_current",
5469
+ "trafficking_experience_past_10plusy",
5470
+ "trafficking_experience_past_3to10y",
5471
+ "trafficking_experience_past_lt3y",
5472
+ "travel_organized_by_third_party",
5473
+ "tricked_or_pressured_into_unwanted_acts",
5474
+ "under_18_advertised_age",
5475
+ "under_18_appears_underage",
5476
+ "under_18_known_age",
5477
+ "unexplained_frequent_travel_or_migration",
5478
+ "unsafe_working_conditions_long_hours_inadequate_breaks",
5479
+ "unusual_cash_or_unexplained_gifts",
5480
+ "unusual_work_circumstances",
5481
+ "urgent_medical_referral_needed",
5482
+ "victim_believes_abuser_capable_of_killing",
5483
+ "victimization_history_composite",
5484
+ "violence_or_threats_at_work_site",
5485
+ "weapon_used_or_threatened_against_victim",
5486
+ "work_frequency_high_volume",
5487
+ "working_while_pregnant",
5488
+ "workplace_emotional_climate_of_fear",
5489
+ "works_across_multiple_cities_or_locations",
5490
+ "works_for_little_or_no_pay",
5491
+ "youth_watched_filmed_or_photographed_sexually_explicit",
5492
+ ] as const;
5493
+
5494
+ export type CVC136CoreIndicator =
5495
+ (typeof CVC_136_CORE_INDICATOR_VALUES)[number];
5496
+
5497
+ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string> = {
5498
+ "abuser_evading_legal_consequences": "Abuser has avoided arrest for domestic violence",
5499
+ "abuser_has_weapon": "Abuser with weapon",
5500
+ "abuser_substance_use": "Abuser has serious substance use (alcohol or illegal drugs)",
5501
+ "abuser_threatened_suicide": "Abuser threatened suicide",
5502
+ "abuser_unemployed": "Abuser is unemployed",
5503
+ "access_to_vulnerable_individuals": "Access to or connections with vulnerable individuals",
5504
+ "acknowledgement_or_report_of_human_trafficking": "Acknowledgement or report of human trafficking",
5505
+ "ads_available_247": "Advertises available anytime / 24-7",
5506
+ "ads_imply_multiple_workers": "Ads imply multiple workers",
5507
+ "ads_prost_slang": "Ad uses prostitution slang",
5508
+ "adverse_childhood_household_challenges": "Adverse childhood household challenges (ACE-like)",
5509
+ "advertised_new_to_area": "Ad says new to area",
5510
+ "appears_controlling_relationship": "Appears controlling relationship (employer/intimate partner/family)",
5511
+ "appears_turned_out_or_trained_ad_patterns": "Appears 'turned out' / trained (ad patterns)",
5512
+ "association_commercial_sex": "Association with commercial sex",
5513
+ "atypical_or_high_risk_payment_method": "Atypical or high-risk payment method (cryptocurrency / in-kind)",
5514
+ "autonomy_access_healthcare_without_fear": "Autonomy: can access healthcare without fear of being hurt",
5515
+ "autonomy_choice_in_clients": "Autonomy: choice in clients",
5516
+ "autonomy_choice_in_services": "Autonomy: choice in services performed",
5517
+ "autonomy_controls_own_docs": "Autonomy: controls own identity/immigration documents",
5518
+ "autonomy_controls_own_finances": "Autonomy: controls own finances",
5519
+ "autonomy_organizes_own_travel": "Autonomy: organizes own travel",
5520
+ "autonomy_posts_own_ads": "Autonomy: posts own ads",
5521
+ "autonomy_sets_own_schedule": "Autonomy: sets own schedule",
5522
+ "autonomy_sets_up_own_dates": "Autonomy: sets up own dates/appointments",
5523
+ "battered_while_pregnant_history": "Battered while pregnant (history)",
5524
+ "branding_or_unusual_tattoos_tied_to_control": "Branding marks or unusual tattoos tied to exploitation/control",
5525
+ "cannot_stop_working_or_freely_leave": "Cannot stop working or freely leave home/work",
5526
+ "child_not_abusers_in_household": "Child in household who is not the abuser's biological child",
5527
+ "child_welfare_system_involvement": "Child welfare system involvement (history)",
5528
+ "coerced_to_misrepresent_identity_or_activity": "Coerced to misrepresent age, identity, or work activity to outsiders",
5529
+ "coercive_debt_pressure": "Pressured to do things to pay off debt (coercive debt repayment)",
5530
+ "coercive_debt_pressure_youth": "Pressured to do things to pay off debt (youth missing-from-care)",
5531
+ "coercive_migration_or_forced_travel": "Migration or travel under coercion",
5532
+ "cognitive_or_functional_impairment_affecting_consent": "Known cognitive or functional impairment / disability affecting consent",
5533
+ "commercial_sex_association_words_or_places": "Uses commercial sex-associated words/phrases or spends time with CS-associated people/places",
5534
+ "concerning_mannerisms_anxious_fearful_depressed": "Concerning mannerisms (anxious, fearful, depressed, secretive, resistant to help, aggressive)",
5535
+ "concerning_sexual_behavior_pattern": "Concerning sexual behavior pattern (general)",
5536
+ "constraints_due_to_legal_status": "Legal-status constraints prevent earning income / exit options",
5537
+ "control_quota_required": "Control: quota required",
5538
+ "cs_activity_criminal_org_connection": "Commercial sex activity connected to a known criminal organization",
5539
+ "cs_industry_related_criminal_history": "CS industry-related criminal history (constrained ability to exit)",
5540
+ "current_injuries_from_abuser": "Client reports current injuries from abuser",
5541
+ "current_mental_health_services": "Currently participating in mental-health services",
5542
+ "currently_minor_in_commercial_sex": "Currently a minor in commercial sex (federal CSEC)",
5543
+ "dangerous_services_no_protection": "Dangerous services: offers sex without protection (no condoms)",
5544
+ "dangerous_services_requires_protection": "Dangerous services: requires protection (by provider)",
5545
+ "dangerous_services_willing_anything": "Dangerous services: 'willing to do anything' / extreme services",
5546
+ "debt_terms_deceptive": "Debt repayment terms differed from what was expected",
5547
+ "debt_terms_deceptive_youth": "Debt repayment terms differed from what was expected (youth missing-from-care)",
5548
+ "denied_basic_needs": "Denied basic needs (food, water, sleep, medical care)",
5549
+ "depends_on_employer_for_immigration_status": "Depends on employer for immigration status (tied visa / living with employer)",
5550
+ "does_not_control_finances_or_earnings": "Limited independence: does not control finances or earnings",
5551
+ "does_not_control_identity_documents": "Limited independence: does not control identity documents",
5552
+ "elevated_lethality_risk_signal": "Elevated lethality risk",
5553
+ "employer_keeps_pay_or_pays_less_than_expected": "Employer keeps portion of pay or pays less than expected",
5554
+ "engages_in_commercial_sex_act": "Engages in commercial sex act (sex for something of value)",
5555
+ "entered_commercial_sex_industry_as_minor": "Entered commercial sex industry as a minor (real-life)",
5556
+ "entered_cs_due_to_survival_needs": "Entered commercial sex due to survival needs (housing/food insecurity)",
5557
+ "entered_into_network_of_sex_providers_early": "Entered into network of sex providers at start (early-network linkage)",
5558
+ "exploitative_pricing_tier_low": "Exploitative pricing tier (very low relative price)",
5559
+ "exploitative_working_conditions": "Exploitative working conditions (general)",
5560
+ "fled_conflict_violence_or_persecution": "Fled conflict, violence, or persecution in country of origin",
5561
+ "forced_to_commit_crimes": "Forced to commit crimes / illegal activity",
5562
+ "forced_to_use_false_documents": "Forced to use false identity documents",
5563
+ "foreign_born_or_recently_arrived": "Foreign-born or recently arrived (contextual vulnerability)",
5564
+ "foreign_born_risk_factors": "Foreign-born risk factors (general)",
5565
+ "frequent_changes_in_residence": "Frequent changes in residence (housing instability)",
5566
+ "frequent_travel_or_location_changes": "Frequent travel / location changes (instability signal)",
5567
+ "frequently_at_hotels_or_many_hotel_keys": "Frequently found at hotels / many hotel keys",
5568
+ "harmful_coping_behaviors": "Harmful coping behaviors disclosed",
5569
+ "has_ads_on_commercial_sex_site": "Has advertisements on a commercial sex website",
5570
+ "has_facilitators_involved": "Has facilitators involved (call service, coyote, intermediaries)",
5571
+ "has_management_or_representation": "Has management / representation in commercial sex context",
5572
+ "has_no_personal_items_or_possessions": "Has no personal items or possessions",
5573
+ "head_injury_history": "Head injury history from abuser",
5574
+ "head_injury_loss_of_consciousness": "Possible LOC / disorientation from head injury",
5575
+ "health_related_vulnerability": "Health-related vulnerability (general)",
5576
+ "hierarchical_management_structure_identified": "Hierarchical management structure identified among network sex providers",
5577
+ "high_risk_sexual_behavior": "High-risk sexual behavior",
5578
+ "high_security_measures_at_work_or_living_location": "High security measures at work or living location",
5579
+ "highly_irregular_school_attendance": "Highly irregular school attendance (youth instability)",
5580
+ "history_emotional_abuse": "Victim of emotional abuse (history)",
5581
+ "history_of_head_injury": "History of head injury (traumatic brain injury risk)",
5582
+ "history_of_mental_health_issues": "History of mental health issues",
5583
+ "history_of_running_away_or_missing_from_care": "History of running away or missing from care (youth)",
5584
+ "history_of_strangulation": "History of strangulation",
5585
+ "history_physical_or_sexual_abuse_or_dv": "Victim of physical abuse / domestic violence or sexual abuse (history)",
5586
+ "homeless_or_unstably_housed": "Homelessness or unstable housing",
5587
+ "immigration_related_exploitation_risk": "Immigration-related exploitation risk (general)",
5588
+ "in_commercial_sex_industry_recorded": "In commercial sex industry (self-report or record)",
5589
+ "inability_to_account_for_self": "Inability to account for self (scripted, confused, unaware of location/date)",
5590
+ "intimate_partner_violence_reported_to_law_enforcement": "IPV reported to law enforcement",
5591
+ "juvenile_justice_or_child_welfare_involvement": "Juvenile justice or child welfare involvement (history)",
5592
+ "juvenile_justice_system_involvement": "Juvenile justice system involvement (history)",
5593
+ "labor_services_activity_recorded": "Labor or services activity recorded",
5594
+ "lgbtq_individual": "LGBTQ individual",
5595
+ "limited_english_proficiency": "Does not speak English / limited English proficiency (contextual vulnerability)",
5596
+ "limited_independence": "Limited independence (general)",
5597
+ "lives_or_sleeps_at_place_of_work": "Lives or sleeps at place of work",
5598
+ "living_with_abuser": "Living with abuser",
5599
+ "macro_level_economic_duress_entry_exit": "Macro-level economic duress tied to entry/exit (manual)",
5600
+ "meets_or_has_sex_with_internet_contacts": "Meets or has sex with contacts developed over the Internet (youth risk)",
5601
+ "monitored_or_isolated_by_controlling_party": "Monitored or isolated by controlling party (employer / partner / family)",
5602
+ "much_older_intimate_partner": "Much older intimate partner (age-disparate relationship)",
5603
+ "nervous_about_immigration_documentation": "Nervous about immigration documentation / paperwork",
5604
+ "network_aggregate_risk_score_high": "Network signal: aggregate network risk score (connected providers)",
5605
+ "network_multiple_sex_providers_named": "Named multiple other sex providers in the same network",
5606
+ "network_stable_size_large": "Network signal: larger/stable network size (potential vulnerability)",
5607
+ "network_trafficker_present": "Network signal: trafficker present in connected network",
5608
+ "network_violent_person_present": "Network signal: violent person present in connected network",
5609
+ "new_to_commercial_sex_industry": "New to commercial sex industry (recent entry / early experience)",
5610
+ "non_consensual_photography_or_recording": "Non-consensual photography or recording",
5611
+ "not_in_control_of_immigration_documentation": "Not in control of immigration documentation",
5612
+ "other_instability_or_vulnerability_factors": "Other instability/vulnerability factors (general)",
5613
+ "owes_money_and_cannot_pay_off": "Unusual work circumstances: owes money and cannot pay it off (debt pressure)",
5614
+ "paid_or_owes_fee_to_arrange_travel_to_us": "Paid or owes fee to arrange travel to U.S. (migration debt)",
5615
+ "paid_or_owes_recruitment_fee_to_employer": "Paid or owes a recruitment fee for the work",
5616
+ "parent_or_guardian_of_minor_subject_named": "Parent or guardian named for a minor subject",
5617
+ "past_phases_prior_trafficking_or_risk": "Past phases: prior trafficking victimization / high prior-phase risk",
5618
+ "payment_routed_through_third_party": "Payment for sex services routed through a third party",
5619
+ "pending_federal_protection": "Pending federal protection application",
5620
+ "performing_different_work_than_promised": "Performing different work than promised or originally discussed",
5621
+ "physical_violence_increasing": "Physical violence has increased in severity/frequency",
5622
+ "poverty_or_severe_financial_strain": "Poverty or severe financial strain",
5623
+ "precarious_immigration_status": "Undocumented or precarious legal status (immigration vulnerability)",
5624
+ "pressured_or_forced_sex_act": "Pressured or forced to engage in sex act",
5625
+ "prior_medical_attention_from_abuse": "Received prior medical care for injuries from abuser",
5626
+ "prior_tvap_disconnection": "Prior TVAP disconnection (continuity-of-care gap)",
5627
+ "prior_victimization_or_abuse_history": "Prior victimization / abuse history (general)",
5628
+ "promise_of_work_different_than_current_work": "Promise of work differed from current work (migration deception)",
5629
+ "received_things_of_value_while_missing_from_care": "Received money, drugs, or other things of value from someone while missing from care (youth)",
5630
+ "recent_le_engagement": "Recent law enforcement engagement",
5631
+ "recruited_by_third_party_into_cs_industry": "Recruited by another person/entity into commercial sex industry",
5632
+ "regular_alcohol_use": "Regular alcohol use",
5633
+ "relies_on_temporary_resources_for_basic_needs": "Does not consistently meet basic needs / relies on temporary resources",
5634
+ "reports_physical_harm_by_employer_or_partner": "Reports being physically harmed by employer/partner",
5635
+ "reports_physical_harm_to_others_by_employer_or_partner": "Reports employer/partner physically harmed friend/coworker",
5636
+ "restrictive_living_or_working_conditions": "Restrictive living/working conditions (general)",
5637
+ "restrictive_or_not_understood_contract": "Unusual work circumstances: restrictive contract or contract not understood",
5638
+ "risk_factors_commercial_sex": "Risk factors related to commercial sex",
5639
+ "serious_substance_use_or_introduced_to_drugs": "Serious substance use disorder or introduced to drugs/medications",
5640
+ "several_cell_phones_or_frequent_number_changes": "Several cell phones or frequently changing phone number",
5641
+ "sex_acts_in_own_residence": "Sex acts take place in person's own residence",
5642
+ "sexual_exploitation": "Sexual exploitation (general)",
5643
+ "sexualized_content_performance_activity": "Sexualized content, performance, or communications activity",
5644
+ "shared_contact_network": "Shares a contact network (phones/handles)",
5645
+ "signs_of_physical_abuse_confinement_or_neglect": "Signs of physical abuse, confinement, or neglect (observed)",
5646
+ "signs_of_physical_harm_or_abuse": "Signs of physical harm or abuse (general)",
5647
+ "sleep_disturbance": "Sleep disturbance",
5648
+ "social_isolation_or_no_supportive_relationships": "Absence of supportive relationships / social isolation",
5649
+ "stalking_property_intrusion": "Stalking — property intrusion",
5650
+ "stalking_surveillance": "Stalking — surveillance",
5651
+ "stalking_unwanted_contact": "Stalking — unwanted contact",
5652
+ "strangulation_acute_symptoms": "Acute post-strangulation symptoms present",
5653
+ "strangulation_choking_assault_detail": "Strangulation / choking (assault detail)",
5654
+ "strangulation_loss_of_consciousness": "LOC / couldn’t breathe during strangulation",
5655
+ "strangulation_repeated": "Strangulation occurred more than once",
5656
+ "subject_affiliated_org_trafficking_activity": "Offender flag: subject affiliated with an org that has documented trafficking/CS lines of business",
5657
+ "subject_arrested_dv_sv_cs": "Offender flag: subject arrested for DV/SV/CS-related offenses",
5658
+ "subject_gang_org_affiliation": "Offender flag: subject is affiliated with a gang or criminal organization",
5659
+ "subject_has_illegal_weapons": "Offender flag: subject has illegal weapons",
5660
+ "subject_is_sex_offender": "Offender flag: subject is a registered sex offender",
5661
+ "subject_legally_barred_weapons": "Offender flag: subject is legally unable to own a weapon",
5662
+ "subject_perpetrated_abuse_history": "Offender flag: subject has a history of perpetrating abuse / IPV",
5663
+ "subject_perpetrated_emotional_stalking_current": "Offender flag: subject is a current perpetrator of emotional abuse / stalking / harassment",
5664
+ "subject_perpetrated_emotional_stalking_past": "Offender flag: subject is a past perpetrator of emotional abuse / stalking / harassment",
5665
+ "subject_perpetrated_ipv_current": "Offender flag: subject is a current perpetrator of intimate-partner violence",
5666
+ "subject_perpetrated_ipv_past": "Offender flag: subject is a past perpetrator of intimate-partner violence",
5667
+ "subject_perpetrated_physical_abuse_current": "Offender flag: subject is a current perpetrator of physical abuse",
5668
+ "subject_perpetrated_physical_abuse_past": "Offender flag: subject is a past perpetrator of physical abuse",
5669
+ "subject_perpetrated_sexual_abuse_current": "Offender flag: subject is a current perpetrator of sexual abuse",
5670
+ "subject_perpetrated_sexual_abuse_past": "Offender flag: subject is a past perpetrator of sexual abuse",
5671
+ "subject_violent_felony": "Offender flag: subject is a felon of a violent crime",
5672
+ "substance_use_while_working": "Substance use while working (commercial sex context)",
5673
+ "suicidal_ideation_history": "Suicidal ideation (past)",
5674
+ "suicidal_ideation_recent": "Suicidal ideation (recent)",
5675
+ "suicide_attempt_history": "Past suicide attempt disclosed",
5676
+ "third_party_advertises_or_posts_for_person": "Third party posts or manages the person's commercial-sex ads",
5677
+ "third_party_arranged_commercial_sex_acts": "Someone else arranged commercial sex acts (posting, scheduling, managing)",
5678
+ "threats_by_employer_or_partner": "Threats by employer/partner (general)",
5679
+ "threats_of_harm": "Threats of harm by employer/partner/others",
5680
+ "threats_of_legal_trouble_or_deportation": "Threats involving law enforcement, deportation, or legal trouble",
5681
+ "threats_related_to_migration_debt": "Threats related to migration debt",
5682
+ "threats_to_family_friends_or_close_associates": "Threats to family, friends, or close associates",
5683
+ "threats_to_kill_victim_or_children": "Threats to kill victim or victim's children",
5684
+ "trafficking_experience_current": "Trafficking experience: currently experiencing (recency)",
5685
+ "trafficking_experience_past_10plusy": "Trafficking experience recency: 10+ years since last experience",
5686
+ "trafficking_experience_past_3to10y": "Trafficking experience recency: 3–10 years since last experience",
5687
+ "trafficking_experience_past_lt3y": "Trafficking experience recency: less than 3 years since last experience",
5688
+ "travel_organized_by_third_party": "Travel organized by a third party (sex provider does not control own movement)",
5689
+ "tricked_or_pressured_into_unwanted_acts": "Tricked or pressured into unwanted acts or activities (generic coercion)",
5690
+ "under_18_advertised_age": "Under 18 (ad-derived / advertised age)",
5691
+ "under_18_appears_underage": "Under 18 (appears underage; investigator assessment)",
5692
+ "under_18_known_age": "Under 18 (known age)",
5693
+ "unexplained_frequent_travel_or_migration": "Unexplained frequent travel or migration (instability)",
5694
+ "unsafe_working_conditions_long_hours_inadequate_breaks": "Unsafe working conditions / long hours / inadequate breaks",
5695
+ "unusual_cash_or_unexplained_gifts": "Unusual amount of cash or unexplained gifts/resources",
5696
+ "unusual_work_circumstances": "Unusual work circumstances (general)",
5697
+ "urgent_medical_referral_needed": "Urgent medical referral needed",
5698
+ "victim_believes_abuser_capable_of_killing": "Victim believes abuser is capable of killing them",
5699
+ "victimization_history_composite": "Victimization history (composite)",
5700
+ "violence_or_threats_at_work_site": "Violence or threats at work site",
5701
+ "weapon_used_or_threatened_against_victim": "Weapon used or threatened against victim",
5702
+ "work_frequency_high_volume": "Work frequency pattern suggests high volume / little rest",
5703
+ "working_while_pregnant": "Working while pregnant (commercial sex context)",
5704
+ "workplace_emotional_climate_of_fear": "Subjective fear or unsafety at workplace (climate of fear)",
5705
+ "works_across_multiple_cities_or_locations": "Works across multiple cities or locations (geographic instability / trafficking mobility)",
5706
+ "works_for_little_or_no_pay": "Works for little or no pay",
5707
+ "youth_watched_filmed_or_photographed_sexually_explicit": "Watched, filmed, or photographed in sexually explicit manner (youth)",
5708
+ };
5709
+
5404
5710
  // ─── CVC-67: HMIS Sex ────────────────────────────────────────────────────────
5405
5711
  // Biological sex for HMIS (Homeless Management Information System) reporting.
5406
5712
  // HUD 4.21 mapping - single select. Effective Oct 1, 2025.