@htilabs/platform-common-models 0.8.8 → 0.9.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 (78) 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 +5 -432
  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 +5 -429
  13. package/dist/constants/index.js.map +1 -1
  14. package/dist/{cvcEntry-DaDrEuTa.d.cts → cvcEntry-0BIB9sen.d.cts} +44 -44
  15. package/dist/{cvcEntry-DaDrEuTa.d.ts → cvcEntry-0BIB9sen.d.ts} +44 -44
  16. package/dist/cvcs/index.cjs +5863 -7181
  17. package/dist/cvcs/index.cjs.map +1 -1
  18. package/dist/cvcs/index.d.cts +3127 -4581
  19. package/dist/cvcs/index.d.ts +3127 -4581
  20. package/dist/cvcs/index.js +5863 -7173
  21. package/dist/cvcs/index.js.map +1 -1
  22. package/dist/{index-C0J3f169.d.ts → index-CDoqrfc1.d.ts} +1 -1
  23. package/dist/{index-EPjPjR0z.d.cts → index-Zu_mOJRn.d.cts} +1 -1
  24. package/dist/index.cjs +1780 -3613
  25. package/dist/index.cjs.map +1 -1
  26. package/dist/index.d.cts +191 -544
  27. package/dist/index.d.ts +191 -544
  28. package/dist/index.js +5967 -7775
  29. package/dist/index.js.map +1 -1
  30. package/dist/models/index.d.cts +2 -2
  31. package/dist/models/index.d.ts +2 -2
  32. package/dist/{platform-auth-BSKYSDKe.d.cts → platform-auth-XVB9aHqR.d.cts} +3 -19
  33. package/dist/{platform-auth-BSKYSDKe.d.ts → platform-auth-XVB9aHqR.d.ts} +3 -19
  34. package/dist/schemas/index.cjs +9 -26
  35. package/dist/schemas/index.cjs.map +1 -1
  36. package/dist/schemas/index.d.cts +39 -35
  37. package/dist/schemas/index.d.ts +39 -35
  38. package/dist/schemas/index.js +9 -26
  39. package/dist/schemas/index.js.map +1 -1
  40. package/dist/types/index.d.cts +2 -2
  41. package/dist/types/index.d.ts +2 -2
  42. package/package.json +25 -19
  43. package/src/__tests__/__snapshots__/cvc-sot.snap +13 -77
  44. package/src/__tests__/cvc-sot-snapshot.test.ts +11 -62
  45. package/src/__tests__/cvc-structural.test.ts +2 -11
  46. package/src/__tests__/runtime-contract-validator.test.ts +556 -0
  47. package/src/config/fixtures/valid.yaml +90 -0
  48. package/src/config/index.ts +352 -0
  49. package/src/constants/ic.ts +3 -445
  50. package/src/cvcs/highestEducationLevelCompleted.v1.0.0.json +0 -9
  51. package/src/cvcs/hmisSex.v1.0.0.json +89 -0
  52. package/src/cvcs/identificationStatus.v1.0.0.json +0 -18
  53. package/src/cvcs/incomeBenefitsSources.v1.0.0.json +2 -31
  54. package/src/cvcs/index.ts +1 -17
  55. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +96 -0
  56. package/src/cvcs/recencyBand.v1.0.0.json +57 -38
  57. package/src/cvcs/{serviceCategories.v1.1.0.json → serviceCategories.v1.0.0.json} +1091 -1091
  58. package/src/cvcs/serviceStates.v1.0.0.json +1 -23
  59. package/src/cvcs/sourceSubtype.v1.1.0.json +0 -36
  60. package/src/cvcs/verificationMethod.v1.0.0.json +0 -18
  61. package/src/generated/cvc-enums.ts +149 -572
  62. package/src/index.ts +20 -0
  63. package/src/schemas/common.ts +4 -0
  64. package/src/cvcs/activityType.v1.0.0.json +0 -143
  65. package/src/cvcs/assertionDomain.v1.0.0.json +0 -629
  66. package/src/cvcs/contactLinkType.v1.0.0.json +0 -89
  67. package/src/cvcs/hmisRelationshipToHoh.v1.0.0.json +0 -104
  68. package/src/cvcs/housingSubsidyTypes.v1.0.0.json +0 -159
  69. package/src/cvcs/htType.v1.0.0.json +0 -87
  70. package/src/cvcs/livingSituation.v1.0.0.json +0 -213
  71. package/src/cvcs/provenanceSourceId.v1.0.0.json +0 -134
  72. package/src/cvcs/radiusBucket.v1.0.0.json +0 -98
  73. package/src/cvcs/relationshipConcern.v1.0.0.json +0 -114
  74. package/src/cvcs/roiMethod.v1.0.0.json +0 -107
  75. package/src/cvcs/serviceAudience.v1.0.0.json +0 -96
  76. package/src/cvcs/sessionNoteVisibility.v1.0.0.json +0 -80
  77. package/src/cvcs/suggestionSource.v1.0.0.json +0 -71
  78. package/src/cvcs/victimAbuseTypes.v1.0.0.json +0 -276
@@ -701,27 +701,13 @@ 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,
709
704
  } as const;
710
705
 
711
706
  export type IC56Value =
712
707
  (typeof IC_56_SERVICE_DELIVERY_CHANNEL)[keyof typeof IC_56_SERVICE_DELIVERY_CHANNEL];
713
708
 
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
- ]);
709
+ /** Level 1 values only (excludes missingness codes). */
710
+ export type IC56ChannelValue = 1 | 2 | 3 | 4 | 5;
725
711
 
726
712
  export const IC_56_LABELS: Record<IC56Value, string> = {
727
713
  [IC_56_SERVICE_DELIVERY_CHANNEL.DATA_NOT_COLLECTED]: "Data Not Collected",
@@ -732,8 +718,6 @@ export const IC_56_LABELS: Record<IC56Value, string> = {
732
718
  [IC_56_SERVICE_DELIVERY_CHANNEL.PHONE]: "Phone",
733
719
  [IC_56_SERVICE_DELIVERY_CHANNEL.EMAIL_TEXT_CHAT]: "Email / Text / Chat",
734
720
  [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)",
737
721
  };
738
722
 
739
723
  export const IC_56_DESCRIPTIONS: Record<IC56Value, string> = {
@@ -750,10 +734,6 @@ export const IC_56_DESCRIPTIONS: Record<IC56Value, string> = {
750
734
  [IC_56_SERVICE_DELIVERY_CHANNEL.EMAIL_TEXT_CHAT]:
751
735
  "Email, text message, or chat",
752
736
  [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)",
757
737
  };
758
738
 
759
739
  /**
@@ -771,7 +751,7 @@ export function isIC56Missingness(code: number): boolean {
771
751
  * @returns True if the code represents an actual delivery channel
772
752
  */
773
753
  export function isIC56ValidChannel(code: number): code is IC56ChannelValue {
774
- return code >= 1 && code <= 7;
754
+ return code >= 1 && code <= 5;
775
755
  }
776
756
 
777
757
  /** Options array for dropdown/radio components (Level 1 only). */
@@ -796,14 +776,6 @@ export const IC_56_OPTIONS = [
796
776
  value: IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL,
797
777
  label: IC_56_LABELS[IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL],
798
778
  },
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
- },
807
779
  ] as const;
808
780
 
809
781
  // ─── IC-57: Service Audience / Beneficiary ──────────────────────────
@@ -5429,420 +5401,6 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5429
5401
  categoryLabel: CVC_136_CATEGORY_LABELS[category],
5430
5402
  }));
5431
5403
 
5432
- // ─── CVC-136: full core-indicators value set (SOT-complete, 198 codes) ──
5433
- // The complete CVC-136 'core - indicators' vocabulary per the Notion codebook
5434
- // SOT (ADR-CONTRACT-cvc-136-indicator-structure, 198 codes, Ready-for-dev),
5435
- // sourced verbatim from @htilabs/platform-codebook seed-data/entries.json.
5436
- // CVC_136_ALERT_INDICATOR above is the legacy UI-alert SUBSET; this is the
5437
- // authoritative full set that risk-tree / indicator binders resolve against
5438
- // (D10 — replaces per-app @pave/domain CVC_INDICATORS). Codes + labels are
5439
- // codebook-authoritative; the 6-category UI grouping is NOT in the SOT and
5440
- // stays scoped to CVC_136_ALERT_INDICATOR.
5441
- export const CVC_136_CORE_INDICATOR_VALUES = [
5442
- "abuser_evading_legal_consequences",
5443
- "abuser_has_weapon",
5444
- "abuser_substance_use",
5445
- "abuser_threatened_suicide",
5446
- "abuser_unemployed",
5447
- "acknowledgement_or_report_of_human_trafficking",
5448
- "adverse_childhood_household_challenges",
5449
- "appears_controlling_relationship",
5450
- "appears_turned_out_or_trained_ad_patterns",
5451
- "association_commercial_sex",
5452
- "auto_autonomy_protective_factors",
5453
- "autonomy_access_healthcare_without_fear",
5454
- "autonomy_choice_in_clients",
5455
- "autonomy_choice_in_services",
5456
- "autonomy_controls_own_docs",
5457
- "autonomy_controls_own_finances",
5458
- "autonomy_organizes_own_travel",
5459
- "autonomy_posts_own_ads",
5460
- "autonomy_sets_own_schedule",
5461
- "autonomy_sets_up_own_dates",
5462
- "battered_while_pregnant_history",
5463
- "branding_or_unusual_tattoos_tied_to_control",
5464
- "cannot_stop_working_or_freely_leave",
5465
- "child_not_abusers_in_household",
5466
- "coercive_debt_pressure_youth",
5467
- "coercive_migration_or_forced_travel",
5468
- "cognitive_or_functional_impairment_affecting_consent",
5469
- "commercial_sex_association_words_or_places",
5470
- "concerning_mannerisms_anxious_fearful_depressed",
5471
- "constraints_due_to_legal_status",
5472
- "control_quota_required",
5473
- "csctx_apparent_age_under_18",
5474
- "csctx_commercial_sex_advertisements",
5475
- "csctx_cs_associated_indicators",
5476
- "csctx_dangerous_services_offered",
5477
- "csctx_engagement_in_commercial_sex",
5478
- "csctx_minor_in_commercial_sex",
5479
- "csi_acknowledged_or_reported_trafficking",
5480
- "csi_branding_or_ownership_tattoos",
5481
- "csi_coerced_migration_or_travel",
5482
- "csi_debt_bondage_and_coerced_repayment",
5483
- "csi_denial_of_basic_needs",
5484
- "csi_document_control_and_false_documents",
5485
- "csi_employer_tied_immigration_dependence",
5486
- "csi_financial_control_and_wage_exploitation",
5487
- "csi_forced_to_commit_crimes",
5488
- "csi_lethal_threats_to_victim_or_children",
5489
- "csi_monitoring_and_isolation_by_controller",
5490
- "csi_physical_violence_and_abuse_observed",
5491
- "csi_pressured_or_forced_sex_act",
5492
- "csi_recruited_into_commercial_sex",
5493
- "csi_restricted_movement_and_confinement",
5494
- "csi_restrictive_or_deceptive_contract_terms",
5495
- "csi_third_party_facilitation_of_commercial_sex",
5496
- "csi_threats_and_coercion_for_control",
5497
- "csi_unsafe_or_exploitative_working_conditions",
5498
- "csi_weapon_threat_or_use",
5499
- "csi_work_differs_from_promise",
5500
- "csi_youth_sexually_exploited_imagery",
5501
- "current_injuries_from_abuser",
5502
- "currently_minor_in_commercial_sex",
5503
- "dangerous_services_no_protection",
5504
- "dangerous_services_requires_protection",
5505
- "dangerous_services_willing_anything",
5506
- "debt_terms_deceptive_youth",
5507
- "denied_basic_needs",
5508
- "depends_on_employer_for_immigration_status",
5509
- "does_not_control_finances_or_earnings",
5510
- "does_not_control_identity_documents",
5511
- "dv_abuser_risk_factors",
5512
- "dv_escalating_violence",
5513
- "dv_stalking",
5514
- "employer_keeps_pay_or_pays_less_than_expected",
5515
- "engages_in_commercial_sex_act",
5516
- "entered_commercial_sex_industry_as_minor",
5517
- "entered_cs_due_to_survival_needs",
5518
- "entered_into_network_of_sex_providers_early",
5519
- "exploitative_pricing_tier_low",
5520
- "forced_to_commit_crimes",
5521
- "forced_to_use_false_documents",
5522
- "foreign_born_or_recently_arrived",
5523
- "frequent_changes_in_residence",
5524
- "frequent_travel_or_location_changes",
5525
- "frequently_at_hotels_or_many_hotel_keys",
5526
- "has_ads_on_commercial_sex_site",
5527
- "has_facilitators_involved",
5528
- "has_management_or_representation",
5529
- "has_no_personal_items_or_possessions",
5530
- "head_injury_history",
5531
- "head_injury_loss_of_consciousness",
5532
- "high_risk_sexual_behavior",
5533
- "high_security_measures_at_work_or_living_location",
5534
- "highly_irregular_school_attendance",
5535
- "history_emotional_abuse",
5536
- "history_of_head_injury",
5537
- "history_of_mental_health_issues",
5538
- "history_of_running_away_or_missing_from_care",
5539
- "history_of_strangulation",
5540
- "history_physical_or_sexual_abuse_or_dv",
5541
- "homeless_or_unstably_housed",
5542
- "in_commercial_sex_industry_recorded",
5543
- "inability_to_account_for_self",
5544
- "intimate_partner_violence_reported_to_law_enforcement",
5545
- "juvenile_justice_or_child_welfare_involvement",
5546
- "limited_english_proficiency",
5547
- "lives_or_sleeps_at_place_of_work",
5548
- "living_with_abuser",
5549
- "macro_level_economic_duress_entry_exit",
5550
- "meets_or_has_sex_with_internet_contacts",
5551
- "monitored_or_isolated_by_controlling_party",
5552
- "much_older_intimate_partner",
5553
- "nervous_about_immigration_documentation",
5554
- "net_network_risk_signals",
5555
- "network_aggregate_risk_score_high",
5556
- "network_stable_size_large",
5557
- "network_trafficker_present",
5558
- "network_violent_person_present",
5559
- "new_to_commercial_sex_industry",
5560
- "not_in_control_of_immigration_documentation",
5561
- "owes_money_and_cannot_pay_off",
5562
- "paid_or_owes_fee_to_arrange_travel_to_us",
5563
- "past_phases_prior_trafficking_or_risk",
5564
- "pending_federal_protection",
5565
- "performing_different_work_than_promised",
5566
- "physical_violence_increasing",
5567
- "poverty_or_severe_financial_strain",
5568
- "precarious_immigration_status",
5569
- "pressured_or_forced_sex_act",
5570
- "prior_medical_attention_from_abuse",
5571
- "prior_tvap_disconnection",
5572
- "promise_of_work_different_than_current_work",
5573
- "recent_le_engagement",
5574
- "recruited_by_third_party_into_cs_industry",
5575
- "relies_on_temporary_resources_for_basic_needs",
5576
- "reports_physical_harm_by_employer_or_partner",
5577
- "reports_physical_harm_to_others_by_employer_or_partner",
5578
- "restrictive_or_not_understood_contract",
5579
- "risk_factors_commercial_sex",
5580
- "serious_substance_use_or_introduced_to_drugs",
5581
- "several_cell_phones_or_frequent_number_changes",
5582
- "signs_of_physical_abuse_confinement_or_neglect",
5583
- "social_isolation_or_no_supportive_relationships",
5584
- "stalking_property_intrusion",
5585
- "stalking_surveillance",
5586
- "stalking_unwanted_contact",
5587
- "strangulation_acute_symptoms",
5588
- "strangulation_choking_assault_detail",
5589
- "strangulation_loss_of_consciousness",
5590
- "strangulation_repeated",
5591
- "substance_use_while_working",
5592
- "suicidal_ideation_history",
5593
- "suicidal_ideation_recent",
5594
- "third_party_arranged_commercial_sex_acts",
5595
- "threats_of_harm",
5596
- "threats_of_legal_trouble_or_deportation",
5597
- "threats_related_to_migration_debt",
5598
- "threats_to_family_friends_or_close_associates",
5599
- "threats_to_kill_victim_or_children",
5600
- "trafficking_experience_current",
5601
- "trafficking_experience_past_10plusy",
5602
- "trafficking_experience_past_3to10y",
5603
- "trafficking_experience_past_lt3y",
5604
- "under_18_advertised_age",
5605
- "under_18_appears_underage",
5606
- "under_18_known_age",
5607
- "unexplained_frequent_travel_or_migration",
5608
- "unsafe_working_conditions_long_hours_inadequate_breaks",
5609
- "unusual_cash_or_unexplained_gifts",
5610
- "urgent_medical_referral_needed",
5611
- "vc_adverse_childhood_experiences",
5612
- "vc_age_disparate_partner",
5613
- "vc_cognitive_or_functional_impairment",
5614
- "vc_current_injuries_and_medical_need",
5615
- "vc_economic_hardship_and_survival_exchange",
5616
- "vc_federal_protection_and_le_engagement",
5617
- "vc_geographic_instability_and_travel",
5618
- "vc_head_injury_and_tbi",
5619
- "vc_high_risk_sexual_behavior_youth",
5620
- "vc_housing_instability_and_homelessness",
5621
- "vc_immigration_precarity",
5622
- "vc_mental_health_history",
5623
- "vc_prior_trafficking_high_phase_risk",
5624
- "vc_prior_victimization_and_abuse_history",
5625
- "vc_social_isolation",
5626
- "vc_strangulation_history_and_acute",
5627
- "vc_substance_use_vulnerability",
5628
- "vc_suicidal_ideation",
5629
- "vc_trafficking_experience_recency",
5630
- "vc_violence_during_pregnancy",
5631
- "vc_youth_system_involvement_and_instability",
5632
- "victim_believes_abuser_capable_of_killing",
5633
- "victimization_history_composite",
5634
- "violence_or_threats_at_work_site",
5635
- "weapon_used_or_threatened_against_victim",
5636
- "work_frequency_high_volume",
5637
- "working_while_pregnant",
5638
- "works_for_little_or_no_pay",
5639
- "youth_watched_filmed_or_photographed_sexually_explicit",
5640
- ] as const;
5641
-
5642
- export type CVC136CoreIndicator =
5643
- (typeof CVC_136_CORE_INDICATOR_VALUES)[number];
5644
-
5645
- export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string> = {
5646
- "abuser_evading_legal_consequences": "Abuser has avoided arrest for domestic violence",
5647
- "abuser_has_weapon": "Abuser with weapon",
5648
- "abuser_substance_use": "Abuser has serious substance use (alcohol or illegal drugs)",
5649
- "abuser_threatened_suicide": "Abuser threatened suicide",
5650
- "abuser_unemployed": "Abuser is unemployed",
5651
- "acknowledgement_or_report_of_human_trafficking": "Acknowledgement or report of human trafficking",
5652
- "adverse_childhood_household_challenges": "Adverse childhood household challenges (ACE-like)",
5653
- "appears_controlling_relationship": "Appears controlling relationship (employer/intimate partner/family)",
5654
- "appears_turned_out_or_trained_ad_patterns": "Appears 'turned out' / trained (ad patterns)",
5655
- "association_commercial_sex": "Association with commercial sex",
5656
- "auto_autonomy_protective_factors": "Autonomy / protective indicators",
5657
- "autonomy_access_healthcare_without_fear": "Autonomy: can access healthcare without fear of being hurt",
5658
- "autonomy_choice_in_clients": "Autonomy: choice in clients",
5659
- "autonomy_choice_in_services": "Autonomy: choice in services performed",
5660
- "autonomy_controls_own_docs": "Autonomy: controls own identity/immigration documents",
5661
- "autonomy_controls_own_finances": "Autonomy: controls own finances",
5662
- "autonomy_organizes_own_travel": "Autonomy: organizes own travel",
5663
- "autonomy_posts_own_ads": "Autonomy: posts own ads",
5664
- "autonomy_sets_own_schedule": "Autonomy: sets own schedule",
5665
- "autonomy_sets_up_own_dates": "Autonomy: sets up own dates/appointments",
5666
- "battered_while_pregnant_history": "Battered while pregnant (history)",
5667
- "branding_or_unusual_tattoos_tied_to_control": "Branding marks or unusual tattoos tied to exploitation/control",
5668
- "cannot_stop_working_or_freely_leave": "Cannot stop working or freely leave home/work",
5669
- "child_not_abusers_in_household": "Child in household who is not the abuser's biological child",
5670
- "coercive_debt_pressure_youth": "Pressured to do things to pay off debt (youth missing-from-care)",
5671
- "coercive_migration_or_forced_travel": "Migration or travel under coercion",
5672
- "cognitive_or_functional_impairment_affecting_consent": "Known cognitive or functional impairment / disability affecting consent",
5673
- "commercial_sex_association_words_or_places": "Uses commercial sex-associated words/phrases or spends time with CS-associated people/places",
5674
- "concerning_mannerisms_anxious_fearful_depressed": "Concerning mannerisms (anxious, fearful, depressed, secretive, resistant to help, aggressive)",
5675
- "constraints_due_to_legal_status": "Legal-status constraints prevent earning income / exit options",
5676
- "control_quota_required": "Control: quota required",
5677
- "csctx_apparent_age_under_18": "Apparent age under 18",
5678
- "csctx_commercial_sex_advertisements": "Commercial sex advertisements",
5679
- "csctx_cs_associated_indicators": "Commercial-sex-associated indicators",
5680
- "csctx_dangerous_services_offered": "Dangerous services offered",
5681
- "csctx_engagement_in_commercial_sex": "Engagement in commercial sex",
5682
- "csctx_minor_in_commercial_sex": "Minor in commercial sex",
5683
- "csi_acknowledged_or_reported_trafficking": "Acknowledged or reported trafficking",
5684
- "csi_branding_or_ownership_tattoos": "Branding or ownership tattoos",
5685
- "csi_coerced_migration_or_travel": "Coerced migration or travel",
5686
- "csi_debt_bondage_and_coerced_repayment": "Debt bondage and coerced repayment",
5687
- "csi_denial_of_basic_needs": "Denial of basic needs",
5688
- "csi_document_control_and_false_documents": "Identity-document control and false documents",
5689
- "csi_employer_tied_immigration_dependence": "Employer-tied immigration dependence",
5690
- "csi_financial_control_and_wage_exploitation": "Financial control and wage exploitation",
5691
- "csi_forced_to_commit_crimes": "Forced to commit crimes",
5692
- "csi_lethal_threats_to_victim_or_children": "Lethal threats to victim or children",
5693
- "csi_monitoring_and_isolation_by_controller": "Monitoring and isolation by a controlling party",
5694
- "csi_physical_violence_and_abuse_observed": "Physical violence and abuse (observed/reported)",
5695
- "csi_pressured_or_forced_sex_act": "Pressured or forced sex act",
5696
- "csi_recruited_into_commercial_sex": "Recruited or trained into commercial sex",
5697
- "csi_restricted_movement_and_confinement": "Restricted movement and confinement",
5698
- "csi_restrictive_or_deceptive_contract_terms": "Restrictive or deceptive contract terms",
5699
- "csi_third_party_facilitation_of_commercial_sex": "Third-party facilitation/management of commercial sex",
5700
- "csi_threats_and_coercion_for_control": "Threats and coercion for control",
5701
- "csi_unsafe_or_exploitative_working_conditions": "Unsafe or exploitative working conditions",
5702
- "csi_weapon_threat_or_use": "Weapon threat or use against victim",
5703
- "csi_work_differs_from_promise": "Work differs from what was promised",
5704
- "csi_youth_sexually_exploited_imagery": "Youth filmed/photographed in sexually explicit manner",
5705
- "current_injuries_from_abuser": "Client reports current injuries from abuser",
5706
- "currently_minor_in_commercial_sex": "Currently a minor in commercial sex (federal CSEC)",
5707
- "dangerous_services_no_protection": "Dangerous services: offers sex without protection (no condoms)",
5708
- "dangerous_services_requires_protection": "Dangerous services: requires protection (by provider)",
5709
- "dangerous_services_willing_anything": "Dangerous services: 'willing to do anything' / extreme services",
5710
- "debt_terms_deceptive_youth": "Debt repayment terms differed from what was expected (youth missing-from-care)",
5711
- "denied_basic_needs": "Denied basic needs (food, water, sleep, medical care)",
5712
- "depends_on_employer_for_immigration_status": "Depends on employer for immigration status (tied visa / living with employer)",
5713
- "does_not_control_finances_or_earnings": "Limited independence: does not control finances or earnings",
5714
- "does_not_control_identity_documents": "Limited independence: does not control identity documents",
5715
- "dv_abuser_risk_factors": "Abuser/DV risk factors",
5716
- "dv_escalating_violence": "Escalating physical violence",
5717
- "dv_stalking": "Stalking",
5718
- "employer_keeps_pay_or_pays_less_than_expected": "Employer keeps portion of pay or pays less than expected",
5719
- "engages_in_commercial_sex_act": "Engages in commercial sex act (sex for something of value)",
5720
- "entered_commercial_sex_industry_as_minor": "Entered commercial sex industry as a minor (real-life)",
5721
- "entered_cs_due_to_survival_needs": "Entered commercial sex due to survival needs (housing/food insecurity)",
5722
- "entered_into_network_of_sex_providers_early": "Entered into network of sex providers at start (early-network linkage)",
5723
- "exploitative_pricing_tier_low": "Exploitative pricing tier (very low relative price)",
5724
- "forced_to_commit_crimes": "Forced to commit crimes / illegal activity",
5725
- "forced_to_use_false_documents": "Forced to use false identity documents",
5726
- "foreign_born_or_recently_arrived": "Foreign-born or recently arrived (contextual vulnerability)",
5727
- "frequent_changes_in_residence": "Frequent changes in residence (housing instability)",
5728
- "frequent_travel_or_location_changes": "Frequent travel / location changes (instability signal)",
5729
- "frequently_at_hotels_or_many_hotel_keys": "Frequently found at hotels / many hotel keys",
5730
- "has_ads_on_commercial_sex_site": "Has advertisements on a commercial sex website",
5731
- "has_facilitators_involved": "Has facilitators involved (call service, coyote, intermediaries)",
5732
- "has_management_or_representation": "Has management / representation in commercial sex context",
5733
- "has_no_personal_items_or_possessions": "Has no personal items or possessions",
5734
- "head_injury_history": "Head injury history from abuser",
5735
- "head_injury_loss_of_consciousness": "Possible LOC / disorientation from head injury",
5736
- "high_risk_sexual_behavior": "High-risk sexual behavior",
5737
- "high_security_measures_at_work_or_living_location": "High security measures at work or living location",
5738
- "highly_irregular_school_attendance": "Highly irregular school attendance (youth instability)",
5739
- "history_emotional_abuse": "Victim of emotional abuse (history)",
5740
- "history_of_head_injury": "History of head injury (traumatic brain injury risk)",
5741
- "history_of_mental_health_issues": "History of mental health issues",
5742
- "history_of_running_away_or_missing_from_care": "History of running away or missing from care (youth)",
5743
- "history_of_strangulation": "History of strangulation",
5744
- "history_physical_or_sexual_abuse_or_dv": "Victim of physical abuse / domestic violence or sexual abuse (history)",
5745
- "homeless_or_unstably_housed": "Homelessness or unstable housing",
5746
- "in_commercial_sex_industry_recorded": "In commercial sex industry (self-report or record)",
5747
- "inability_to_account_for_self": "Inability to account for self (scripted, confused, unaware of location/date)",
5748
- "intimate_partner_violence_reported_to_law_enforcement": "IPV reported to law enforcement",
5749
- "juvenile_justice_or_child_welfare_involvement": "Juvenile justice or child welfare involvement (history)",
5750
- "limited_english_proficiency": "Does not speak English / limited English proficiency (contextual vulnerability)",
5751
- "lives_or_sleeps_at_place_of_work": "Lives or sleeps at place of work",
5752
- "living_with_abuser": "Living with abuser",
5753
- "macro_level_economic_duress_entry_exit": "Macro-level economic duress tied to entry/exit (manual)",
5754
- "meets_or_has_sex_with_internet_contacts": "Meets or has sex with contacts developed over the Internet (youth risk)",
5755
- "monitored_or_isolated_by_controlling_party": "Monitored or isolated by controlling party (employer / partner / family)",
5756
- "much_older_intimate_partner": "Much older intimate partner (age-disparate relationship)",
5757
- "nervous_about_immigration_documentation": "Nervous about immigration documentation / paperwork",
5758
- "net_network_risk_signals": "Network-level risk signals",
5759
- "network_aggregate_risk_score_high": "Network signal: aggregate network risk score (connected providers)",
5760
- "network_stable_size_large": "Network signal: larger/stable network size (potential vulnerability)",
5761
- "network_trafficker_present": "Network signal: trafficker present in connected network",
5762
- "network_violent_person_present": "Network signal: violent person present in connected network",
5763
- "new_to_commercial_sex_industry": "New to commercial sex industry (recent entry / early experience)",
5764
- "not_in_control_of_immigration_documentation": "Not in control of immigration documentation",
5765
- "owes_money_and_cannot_pay_off": "Unusual work circumstances: owes money and cannot pay it off (debt pressure)",
5766
- "paid_or_owes_fee_to_arrange_travel_to_us": "Paid or owes fee to arrange travel to U.S. (migration debt)",
5767
- "past_phases_prior_trafficking_or_risk": "Past phases: prior trafficking victimization / high prior-phase risk",
5768
- "pending_federal_protection": "Pending federal protection application",
5769
- "performing_different_work_than_promised": "Performing different work than promised or originally discussed",
5770
- "physical_violence_increasing": "Physical violence has increased in severity/frequency",
5771
- "poverty_or_severe_financial_strain": "Poverty or severe financial strain",
5772
- "precarious_immigration_status": "Undocumented or precarious legal status (immigration vulnerability)",
5773
- "pressured_or_forced_sex_act": "Pressured or forced to engage in sex act",
5774
- "prior_medical_attention_from_abuse": "Received prior medical care for injuries from abuser",
5775
- "prior_tvap_disconnection": "Prior TVAP disconnection (continuity-of-care gap)",
5776
- "promise_of_work_different_than_current_work": "Promise of work differed from current work (migration deception)",
5777
- "recent_le_engagement": "Recent law enforcement engagement",
5778
- "recruited_by_third_party_into_cs_industry": "Recruited by another person/entity into commercial sex industry",
5779
- "relies_on_temporary_resources_for_basic_needs": "Does not consistently meet basic needs / relies on temporary resources",
5780
- "reports_physical_harm_by_employer_or_partner": "Reports being physically harmed by employer/partner",
5781
- "reports_physical_harm_to_others_by_employer_or_partner": "Reports employer/partner physically harmed friend/coworker",
5782
- "restrictive_or_not_understood_contract": "Unusual work circumstances: restrictive contract or contract not understood",
5783
- "risk_factors_commercial_sex": "Risk factors related to commercial sex",
5784
- "serious_substance_use_or_introduced_to_drugs": "Serious substance use disorder or introduced to drugs/medications",
5785
- "several_cell_phones_or_frequent_number_changes": "Several cell phones or frequently changing phone number",
5786
- "signs_of_physical_abuse_confinement_or_neglect": "Signs of physical abuse, confinement, or neglect (observed)",
5787
- "social_isolation_or_no_supportive_relationships": "Absence of supportive relationships / social isolation",
5788
- "stalking_property_intrusion": "Stalking — property intrusion",
5789
- "stalking_surveillance": "Stalking — surveillance",
5790
- "stalking_unwanted_contact": "Stalking — unwanted contact",
5791
- "strangulation_acute_symptoms": "Acute post-strangulation symptoms present",
5792
- "strangulation_choking_assault_detail": "Strangulation / choking (assault detail)",
5793
- "strangulation_loss_of_consciousness": "LOC / couldn't breathe during strangulation",
5794
- "strangulation_repeated": "Strangulation occurred more than once",
5795
- "substance_use_while_working": "Substance use while working (commercial sex context)",
5796
- "suicidal_ideation_history": "Suicidal ideation (past)",
5797
- "suicidal_ideation_recent": "Suicidal ideation (recent)",
5798
- "third_party_arranged_commercial_sex_acts": "Someone else arranged commercial sex acts (posting, scheduling, managing)",
5799
- "threats_of_harm": "Threats of harm by employer/partner/others",
5800
- "threats_of_legal_trouble_or_deportation": "Threats involving law enforcement, deportation, or legal trouble",
5801
- "threats_related_to_migration_debt": "Threats related to migration debt",
5802
- "threats_to_family_friends_or_close_associates": "Threats to family, friends, or close associates",
5803
- "threats_to_kill_victim_or_children": "Threats to kill victim or victim's children",
5804
- "trafficking_experience_current": "Trafficking experience: currently experiencing (recency)",
5805
- "trafficking_experience_past_10plusy": "Trafficking experience recency: 10+ years since last experience",
5806
- "trafficking_experience_past_3to10y": "Trafficking experience recency: 3–10 years since last experience",
5807
- "trafficking_experience_past_lt3y": "Trafficking experience recency: less than 3 years since last experience",
5808
- "under_18_advertised_age": "Under 18 (ad-derived / advertised age)",
5809
- "under_18_appears_underage": "Under 18 (appears underage; investigator assessment)",
5810
- "under_18_known_age": "Under 18 (known age)",
5811
- "unexplained_frequent_travel_or_migration": "Unexplained frequent travel or migration (instability)",
5812
- "unsafe_working_conditions_long_hours_inadequate_breaks": "Unsafe working conditions / long hours / inadequate breaks",
5813
- "unusual_cash_or_unexplained_gifts": "Unusual amount of cash or unexplained gifts/resources",
5814
- "urgent_medical_referral_needed": "Urgent medical referral needed",
5815
- "vc_adverse_childhood_experiences": "Adverse childhood experiences",
5816
- "vc_age_disparate_partner": "Age-disparate intimate partner",
5817
- "vc_cognitive_or_functional_impairment": "Cognitive or functional impairment",
5818
- "vc_current_injuries_and_medical_need": "Current injuries and medical need",
5819
- "vc_economic_hardship_and_survival_exchange": "Economic hardship and survival exchange",
5820
- "vc_federal_protection_and_le_engagement": "Federal protection status and law-enforcement engagement",
5821
- "vc_geographic_instability_and_travel": "Geographic instability and unexplained travel",
5822
- "vc_head_injury_and_tbi": "Head injury and TBI risk",
5823
- "vc_high_risk_sexual_behavior_youth": "High-risk sexual behavior (youth)",
5824
- "vc_housing_instability_and_homelessness": "Housing instability and homelessness",
5825
- "vc_immigration_precarity": "Immigration precarity and language barrier",
5826
- "vc_mental_health_history": "Mental health history and concerning mannerisms",
5827
- "vc_prior_trafficking_high_phase_risk": "Prior trafficking / high prior-phase risk",
5828
- "vc_prior_victimization_and_abuse_history": "Prior victimization and abuse history",
5829
- "vc_social_isolation": "Social isolation / absence of supportive relationships",
5830
- "vc_strangulation_history_and_acute": "Strangulation history and acute symptoms",
5831
- "vc_substance_use_vulnerability": "Substance use vulnerability",
5832
- "vc_suicidal_ideation": "Suicidal ideation",
5833
- "vc_trafficking_experience_recency": "Trafficking experience recency",
5834
- "vc_violence_during_pregnancy": "Violence during pregnancy",
5835
- "vc_youth_system_involvement_and_instability": "Youth system involvement and instability",
5836
- "victim_believes_abuser_capable_of_killing": "Victim believes abuser is capable of killing them",
5837
- "victimization_history_composite": "Victimization history (composite)",
5838
- "violence_or_threats_at_work_site": "Violence or threats at work site",
5839
- "weapon_used_or_threatened_against_victim": "Weapon used or threatened against victim",
5840
- "work_frequency_high_volume": "Work frequency pattern suggests high volume / little rest",
5841
- "working_while_pregnant": "Working while pregnant (commercial sex context)",
5842
- "works_for_little_or_no_pay": "Works for little or no pay",
5843
- "youth_watched_filmed_or_photographed_sexually_explicit": "Watched, filmed, or photographed in sexually explicit manner (youth)",
5844
- };
5845
-
5846
5404
  // ─── CVC-67: HMIS Sex ────────────────────────────────────────────────────────
5847
5405
  // Biological sex for HMIS (Homeless Management Information System) reporting.
5848
5406
  // HUD 4.21 mapping - single select. Effective Oct 1, 2025.
@@ -70,15 +70,6 @@
70
70
  "childCodes": [],
71
71
  "definition": "Completed a master's, doctoral, or professional degree (MA, MS, MBA, JD, MD, PhD, or equivalent). Aligns with Census/ACS 'Graduate or professional degree'."
72
72
  },
73
- {
74
- "code": "180-008-000-000-000-000-000",
75
- "key": "trade_vocational",
76
- "title": "Trade or vocational credential",
77
- "selectable": true,
78
- "parentCode": null,
79
- "childCodes": [],
80
- "definition": "Completed a trade, vocational, or technical credential (apprenticeship, licensure, or postsecondary non-degree award) rather than an academic degree."
81
- },
82
73
  {
83
74
  "code": "180-000-000-000-000-000-000",
84
75
  "key": "missingness_root",
@@ -0,0 +1,89 @@
1
+ {
2
+ "domain": "hmis_sex",
3
+ "name": "Core HMIS Sex",
4
+ "version": "1.0.0",
5
+ "levels": {
6
+ "0": "Unknown or Missing",
7
+ "1": "Sex"
8
+ },
9
+ "entries": [
10
+ {
11
+ "code": "067-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
+ "067-000-000-000-000-000-001",
18
+ "067-000-000-000-000-000-002",
19
+ "067-000-000-000-000-000-003",
20
+ "067-000-000-000-000-000-004",
21
+ "067-000-000-000-000-000-005"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "067-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "067-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Value is unknown at time of entry."
33
+ },
34
+ {
35
+ "code": "067-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous",
38
+ "selectable": true,
39
+ "parentCode": "067-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld or redacted."
42
+ },
43
+ {
44
+ "code": "067-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "067-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "Use this response if the staff does not ask the person to provide their sex."
51
+ },
52
+ {
53
+ "code": "067-000-000-000-000-000-004",
54
+ "key": "client_doesn_t_know",
55
+ "title": "Client doesn't know",
56
+ "selectable": true,
57
+ "parentCode": "067-000-000-000-000-000-000",
58
+ "childCodes": [],
59
+ "definition": "\"Client doesn't know\" should only be selected when a person does not know their sex from among the responses."
60
+ },
61
+ {
62
+ "code": "067-000-000-000-000-000-005",
63
+ "key": "client_prefers_not_to_answer",
64
+ "title": "Client prefers not to answer",
65
+ "selectable": true,
66
+ "parentCode": "067-000-000-000-000-000-000",
67
+ "childCodes": [],
68
+ "definition": "\"Client prefers not to answer\" should only be selected when a person chooses not to identify their sex from among the responses."
69
+ },
70
+ {
71
+ "code": "067-001-000-000-000-000-000",
72
+ "key": "female",
73
+ "title": "Female",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "A person of the sex characterized by a reproductive system with the biological function of producing eggs (ova)."
78
+ },
79
+ {
80
+ "code": "067-002-000-000-000-000-000",
81
+ "key": "male",
82
+ "title": "Male",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "A person of the sex characterized by a reproductive system with the biological function of producing sperm."
87
+ }
88
+ ]
89
+ }
@@ -75,24 +75,6 @@
75
75
  "parentCode": null,
76
76
  "childCodes": [],
77
77
  "definition": "Advocate's deliberate choice to keep the person's name off the subject's record even when known (privacy / safety / legal-strategy reasons), or when documenting the name would risk the survivor or third party. Pairs with Name kind 'Anonymous'. This is a capture-intent posture, distinct from the missingness 'anonymous' sentinel."
78
- },
79
- {
80
- "code": "929-004-000-000-000-000-000",
81
- "key": "estimated_persona",
82
- "title": "Estimated persona",
83
- "selectable": true,
84
- "parentCode": null,
85
- "childCodes": [],
86
- "definition": "A persona that exists in data/systems (resolved _id with linked source records) but has NOT been confirmed to represent a real person. Typically inferred (entity resolution / algorithm-clustered ads); maps 1:1 to the LEADS IDB 'not verified' icon. An estimated_persona record must never render as an identified person. Added 2026-06-12 per ruling M3 (Terry) so the platform-milestone IDENTIFICATION value maps exactly; RENAMED that day from the prototype's working code SYSTEM_ENTITY to avoid collision with facilitator_entity_type. Previously approximated as unidentified."
87
- },
88
- {
89
- "code": "929-005-000-000-000-000-000",
90
- "key": "confirmed",
91
- "title": "Confirmed (identity unknown)",
92
- "selectable": true,
93
- "parentCode": null,
94
- "childCodes": [],
95
- "definition": "Confirmed to be a real person, but the specific identity is unknown — the 'real person, identity unknown' degree that sat between unidentified and identified with no code before 2026-06-12 (ruling M3). Distinct from unidentified (capture intent: known-of via relationship, no name) in that confirmation is an explicit analyst/advocate determination that the entity is real."
96
78
  }
97
79
  ]
98
80
  }