@htilabs/platform-common-models 0.12.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/dist/config/index.cjs +0 -81
  2. package/dist/config/index.cjs.map +1 -1
  3. package/dist/config/index.d.cts +4 -79
  4. package/dist/config/index.d.ts +4 -79
  5. package/dist/config/index.js +1 -79
  6. package/dist/config/index.js.map +1 -1
  7. package/dist/constants/index.cjs +18 -2
  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 +18 -2
  12. package/dist/constants/index.js.map +1 -1
  13. package/dist/cvc-Cp4uWnAa.d.cts +298 -0
  14. package/dist/cvc-Cp4uWnAa.d.ts +298 -0
  15. package/dist/cvcs/index.cjs +6678 -221
  16. package/dist/cvcs/index.cjs.map +1 -1
  17. package/dist/cvcs/index.d.cts +15019 -8052
  18. package/dist/cvcs/index.d.ts +15019 -8052
  19. package/dist/cvcs/index.js +6666 -221
  20. package/dist/cvcs/index.js.map +1 -1
  21. package/dist/enums/index.cjs +4557 -0
  22. package/dist/enums/index.cjs.map +1 -0
  23. package/dist/enums/index.d.cts +5257 -0
  24. package/dist/enums/index.d.ts +5257 -0
  25. package/dist/enums/index.js +4354 -0
  26. package/dist/enums/index.js.map +1 -0
  27. package/dist/{index-I-DiX9eQ.d.ts → index-CDoqrfc1.d.ts} +1 -1
  28. package/dist/{index-CoVr1jIV.d.cts → index-Zu_mOJRn.d.cts} +1 -1
  29. package/dist/index.cjs +7219 -232
  30. package/dist/index.cjs.map +1 -1
  31. package/dist/index.d.cts +7 -4700
  32. package/dist/index.d.ts +7 -4700
  33. package/dist/index.js +7195 -232
  34. package/dist/index.js.map +1 -1
  35. package/dist/models/index.d.cts +2 -2
  36. package/dist/models/index.d.ts +2 -2
  37. package/dist/mongo/index.cjs +0 -1
  38. package/dist/mongo/index.cjs.map +1 -1
  39. package/dist/mongo/index.js +1 -2
  40. package/dist/mongo/index.js.map +1 -1
  41. package/dist/{platform-auth-v53r3BhN.d.cts → platform-auth-Dv5fu0Fh.d.cts} +5 -4
  42. package/dist/{platform-auth-v53r3BhN.d.ts → platform-auth-Dv5fu0Fh.d.ts} +5 -4
  43. package/dist/schemas/index.cjs +5 -1
  44. package/dist/schemas/index.cjs.map +1 -1
  45. package/dist/schemas/index.d.cts +25 -25
  46. package/dist/schemas/index.d.ts +25 -25
  47. package/dist/schemas/index.js +5 -1
  48. package/dist/schemas/index.js.map +1 -1
  49. package/dist/types/index.d.cts +2 -2
  50. package/dist/types/index.d.ts +2 -2
  51. package/dist/validation/index.cjs +58 -0
  52. package/dist/validation/index.cjs.map +1 -1
  53. package/dist/validation/index.d.cts +82 -283
  54. package/dist/validation/index.d.ts +82 -283
  55. package/dist/validation/index.js +57 -0
  56. package/dist/validation/index.js.map +1 -1
  57. package/package.json +10 -1
  58. package/src/__sot__/README.md +36 -1
  59. package/src/__sot__/coreIndicatorFields.ts +331 -0
  60. package/src/__sot__/coreIndicators.pin.json +1936 -2
  61. package/src/__sot__/cvcIndex.pin.json +8 -4
  62. package/src/__tests__/__snapshots__/cvc-sot.snap +41 -13
  63. package/src/__tests__/core-information-scope-invariant.test.ts +134 -0
  64. package/src/__tests__/cvc-136-scoring-invariant.test.ts +8 -3
  65. package/src/__tests__/cvc-181-182-country-parity.test.ts +163 -0
  66. package/src/__tests__/cvc-drift-gate.test.ts +445 -12
  67. package/src/__tests__/cvc-sot-snapshot.test.ts +73 -11
  68. package/src/__tests__/cvc-status-parser.test.ts +150 -0
  69. package/src/__tests__/cvc-structural.test.ts +14 -0
  70. package/src/__tests__/runtime-contract-validator.test.ts +1 -325
  71. package/src/config/index.ts +4 -189
  72. package/src/constants/ic.ts +120 -3
  73. package/src/cvcs/assertionDomain.v1.1.0.json +19 -1
  74. package/src/cvcs/assertionStatus.v1.0.0.json +80 -0
  75. package/src/cvcs/carCorrectionReason.v1.0.0.json +89 -0
  76. package/src/cvcs/caseShareState.v1.0.0.json +62 -0
  77. package/src/cvcs/coreIndicators.v1.0.0.json +83 -5
  78. package/src/cvcs/coreInformationScope.v1.0.0.json +1165 -0
  79. package/src/cvcs/countries.v1.0.0.json +3077 -0
  80. package/src/cvcs/createdBySystem.v1.0.0.json +89 -0
  81. package/src/cvcs/criminalOrgCategory.v1.0.0.json +116 -0
  82. package/src/cvcs/determinationHelperCategories.v1.0.0.json +1166 -0
  83. package/src/cvcs/incidentParticipationRoles.v1.0.0.json +11 -1
  84. package/src/cvcs/index.ts +32 -0
  85. package/src/cvcs/minorAdultStatus.v1.0.0.json +80 -0
  86. package/src/cvcs/personRelationships.v1.0.0.json +67 -2
  87. package/src/cvcs/referralOrigin.v1.0.0.json +26 -0
  88. package/src/cvcs/relationshipConcern.v1.0.0.json +28 -19
  89. package/src/cvcs/riskIdentificationMilestone.v1.0.0.json +109 -0
  90. package/src/cvcs/sessionTemplate.v1.0.0.json +22 -0
  91. package/src/cvcs/sharePurpose.v1.0.0.json +80 -12
  92. package/src/cvcs/subjectType.v1.0.0.json +80 -0
  93. package/src/generated/cvc-enums.ts +606 -20
  94. package/src/validation/cvcStatus.ts +209 -0
  95. package/src/validation/index.ts +1 -0
  96. package/dist/{cvcEntry-BCj1OWqL.d.cts → cvcEntry-0BIB9sen.d.cts} +8 -8
  97. package/dist/{cvcEntry-BCj1OWqL.d.ts → cvcEntry-0BIB9sen.d.ts} +8 -8
@@ -1986,6 +1986,7 @@ export const INCIDENT_PARTICIPATION_ROLE = {
1986
1986
  DATA_ENTRY: "data_entry",
1987
1987
  OTHER_INCIDENT_RESPONDER: "other_incident_responder",
1988
1988
  RESPONDING_OFFICER: "responding_officer",
1989
+ LEGAL_PROFESSIONAL: "legal_professional",
1989
1990
  UNKNOWN: "unknown",
1990
1991
  ANONYMOUS: "anonymous",
1991
1992
  DATA_NOT_COLLECTED: "data_not_collected",
@@ -2006,6 +2007,7 @@ export const INCIDENT_PARTICIPATION_ROLE_VALUES = [
2006
2007
  INCIDENT_PARTICIPATION_ROLE.DATA_ENTRY,
2007
2008
  INCIDENT_PARTICIPATION_ROLE.OTHER_INCIDENT_RESPONDER,
2008
2009
  INCIDENT_PARTICIPATION_ROLE.RESPONDING_OFFICER,
2010
+ INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL,
2009
2011
  INCIDENT_PARTICIPATION_ROLE.UNKNOWN,
2010
2012
  INCIDENT_PARTICIPATION_ROLE.ANONYMOUS,
2011
2013
  INCIDENT_PARTICIPATION_ROLE.DATA_NOT_COLLECTED,
@@ -2030,6 +2032,7 @@ export const INCIDENT_PARTICIPATION_ROLE_LABELS: Record<
2030
2032
  [INCIDENT_PARTICIPATION_ROLE.OTHER_INCIDENT_RESPONDER]:
2031
2033
  "VSP or Other Incident Responder",
2032
2034
  [INCIDENT_PARTICIPATION_ROLE.RESPONDING_OFFICER]: "LE Responding Officer",
2035
+ [INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL]: "Legal Professional",
2033
2036
  [INCIDENT_PARTICIPATION_ROLE.UNKNOWN]: "Unknown",
2034
2037
  [INCIDENT_PARTICIPATION_ROLE.ANONYMOUS]: "Anonymous",
2035
2038
  [INCIDENT_PARTICIPATION_ROLE.DATA_NOT_COLLECTED]: "Not Collected",
@@ -2056,6 +2059,7 @@ export const PARTICIPATION_ROLE_CATEGORIES = {
2056
2059
  SYSTEM_PROFESSIONAL: [
2057
2060
  INCIDENT_PARTICIPATION_ROLE.SERVICE_PROVIDER_STAFF,
2058
2061
  INCIDENT_PARTICIPATION_ROLE.MEDICAL_PROVIDER_STAFF,
2062
+ INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL,
2059
2063
  ],
2060
2064
  } as const;
2061
2065
 
@@ -2632,6 +2636,20 @@ export const CVC_122_LABELS: Record<CVC122Value, string> = {
2632
2636
 
2633
2637
  // ─── CVC-181: Countries (ISO 3166-1 alpha-2) ────────────────────────
2634
2638
  // Full list of countries using ISO 3166-1 alpha-2 codes.
2639
+ //
2640
+ // AS OF 2026-08-26 THE SOT IS `src/cvcs/countries.v1.0.0.json`, authored from the
2641
+ // canonical `core - countries — codebook 2.csv`. These two constants predate it and
2642
+ // are RETAINED for existing consumers; new code should import `CountryKeys` from
2643
+ // `src/generated/cvc-enums.ts` (or `countriesSot`) instead.
2644
+ //
2645
+ // The ISO SET here is exact — all 249 codes, no additions, no omissions, verified
2646
+ // against the codebook. `CVC_181_LABELS`, however, carries SHORT-FORM display labels
2647
+ // that differ from the canonical label on 16 codes: BO, CD, IR, KP, KR, LA, MK, FM,
2648
+ // MD, PS, SH, SY, TW, TZ, VE, VN ("Vietnam" vs "Viet Nam", "Korea, South" vs "Korea,
2649
+ // Republic of", …). The SOT JSON carries the canonical spelling verbatim in both
2650
+ // `title` and `canonicalLabel`. That divergence is display-only — nothing keys off
2651
+ // these strings — but it is real, and collapsing the two surfaces onto one label set
2652
+ // is its own decision (a visible UI change), deliberately not made here.
2635
2653
 
2636
2654
  export const CVC_181_COUNTRIES = {
2637
2655
  US: "US",
@@ -5245,10 +5263,10 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5245
5263
  categoryLabel: CVC_136_CATEGORY_LABELS[category],
5246
5264
  }));
5247
5265
 
5248
- // ─── CVC-136: full core-indicators value set (CANONICAL, 210 codes) ─────
5266
+ // ─── CVC-136: full core-indicators value set (CANONICAL, 216 codes) ─────
5249
5267
  // The complete CVC-136 'core - indicators' vocabulary. As of 0.8.13 the
5250
5268
  // AUTHORITATIVE surface for this domain is the SOT JSON
5251
- // `src/cvcs/coreIndicators.v1.0.0.json` (214 entries = 210 substantive + the
5269
+ // `src/cvcs/coreIndicators.v1.0.0.json` (220 entries = 216 substantive + the
5252
5270
  // missingness quadruplet), which also carries the canonical `family`,
5253
5271
  // `polarity`, `severity`, `isAlert` and `alertWhen` entry attributes. This
5254
5272
  // hand-coded array is kept in lockstep with that JSON as a flat key list for
@@ -5272,6 +5290,93 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5272
5290
  // `emits_by_code` (weights/risk.weights.json @ 9b5d654) is present here.
5273
5291
  // Enforced by `src/__tests__/cvc-136-scoring-invariant.test.ts`.
5274
5292
  //
5293
+ // 0.8.14 — 210 → 215 (catalog refresh, prototype a596eb9 → 84a1b677).
5294
+ // The upstream catalog grew by 5 and withdrew none. All five are minted
5295
+ // upstream with `code_status: canonical` (three carry the 2026-07-17
5296
+ // TRA-vetting provenance), so this is catalog CATCH-UP, not invention —
5297
+ // GATE B in `cvc-drift-gate.test.ts` flagged them only because the pin was
5298
+ // stale. `coreIndicators.pin.json` is refreshed to 84a1b677 (213 codes) in
5299
+ // the same change; the 2 scoring-ahead codes remain absent upstream and
5300
+ // stay on the `SCORING_AHEAD_OF_CATALOG` allowlist, unchanged.
5301
+ // + clients_unaware_of_third_party_coordination (TRA-7-aware)
5302
+ // + depends_on_spouse_or_family_for_immigration_status (TRA-14 × TRA-22)
5303
+ // + sexualized_content_in_person_performance_activity (DH § II 2.2.3)
5304
+ // + sexualized_content_online_performance_activity (DH § II 2.2.2)
5305
+ // + trauma_perpetrator_is_current_manager (engine-derived)
5306
+ // PAVE 2.0 needs the first two to express `trafficking_risk_assessment`
5307
+ // emissions; without them the TRA writes assertions against codes that
5308
+ // resolve to nothing.
5309
+ // New SOT entries are APPENDED at positional codes 136-211…136-215 so
5310
+ // every previously issued code keeps its number.
5311
+ //
5312
+ // Refresh to 622410b — 215 → 216 (catalog refresh, prototype 84a1b67 →
5313
+ // 622410b; the release number is assigned by the standalone chore(release)
5314
+ // commit, not claimed here).
5315
+ // The upstream catalog grew by 1 and withdrew none, so this is again
5316
+ // catalog CATCH-UP rather than net-new authoring: GATE B would have
5317
+ // reported the code as INVENTED only because the pin was stale.
5318
+ // + active_protective_order (AE-3 / q-ar-3)
5319
+ // Minted upstream 2026-08-08 with `code_status: canonical` (prototype
5320
+ // `4b3d40e4`, "Catalogue the protective-order disclosure"), emitted by the
5321
+ // INTAKE_MAP on `q-ar-3 == yes`. Definition, `family`, `polarity`,
5322
+ // `severity` and `is_alert` are carried VERBATIM from the catalog:
5323
+ // `lethality_dv` / `depends` / `caution` / `none`. The `isAlert: "none"`
5324
+ // is load-bearing and deliberate — per the Crysta ruling of 2026-08-08 the
5325
+ // code is catalogued DESCRIPTIVE and is NOT tree-mapped, because an order
5326
+ // is a protective act, not an alert condition; tree-mapping it would score
5327
+ // a survivor higher for having sought court protection. The counterparty-
5328
+ // gated scoring reads live elsewhere (`protection_order_against_trafficker`
5329
+ // on the Severity model; perpetrator leaf P-II-D). The signal reaches the
5330
+ // Severity model through the catalog's `lane_tiers`
5331
+ // (safety_planning: elevated · domestic_family_violence: review), which is
5332
+ // not a platform-common surface.
5333
+ // PAVE 2.0 needs this to express the AE-3 intake emission; without it the
5334
+ // AE instrument writes an assertion against a code that resolves to
5335
+ // nothing. `coreIndicators.pin.json` is refreshed to 622410b (214 codes)
5336
+ // in the same change; the 2 scoring-ahead codes remain absent upstream and
5337
+ // stay on the `SCORING_AHEAD_OF_CATALOG` allowlist, unchanged at exactly 2.
5338
+ // The new SOT entry is APPENDED at positional code 136-216 so every
5339
+ // previously issued code keeps its number.
5340
+ //
5341
+ // NOT ADDED, deliberately: `substance_use_concerns`. It is NOT a code in
5342
+ // the canonical catalog — it is a `legacy_aliases` member of the canonical
5343
+ // `serious_substance_use_or_introduced_to_drugs` (136-142, shipped since
5344
+ // 0.8.13, `vulnerability_context` / `depends` / `elevated` /
5345
+ // `isAlert: "pave"` / `alertWhen: "recency_under_year"`). Adding it as its
5346
+ // own code would be exactly the invention GATE B exists to stop. Consumers
5347
+ // binding a BH-2 substance-use emission must bind the canonical key.
5348
+ //
5349
+ // PROJECTED-FIELD REVISIONS carried in the same refresh. A pin bump is a
5350
+ // promise of FULL conformance to the pinned catalog, not just of its new
5351
+ // codes — the 84a1b67 → 622410b delta also revised two shipping codes, and
5352
+ // both are carried here (SOT JSON + this label map):
5353
+ // • `acknowledgement_or_report_of_human_trafficking` (136-007) — label
5354
+ // "Acknowledgement or report of human trafficking" →
5355
+ // "Human trafficking disclosure or report".
5356
+ // • `juvenile_justice_or_child_welfare_involvement` (136-094) —
5357
+ // definition gained "(system unspecified — deprecated combined code;
5358
+ // see read-time alias policy above)". LOAD-BEARING: the definition is
5359
+ // the only projected field that tells a consumer this code is
5360
+ // DEPRECATED. Upstream split it 2026-06-08 (Ava) into
5361
+ // `juvenile_justice_system_involvement` (136-095) +
5362
+ // `child_welfare_system_involvement` at the Core Profile capture layer,
5363
+ // and the Phase 2C combined→split migration (2026-08-02, Crysta) makes
5364
+ // the read-time alias policy binding: the row is NEVER deleted and
5365
+ // stored CARs are NEVER rewritten — a combined-code CAR resolves at
5366
+ // read/aggregation time as BOTH split codes, so any consumer keyed by a
5367
+ // split code must also key this one. Residual emitters are only the
5368
+ // captures that genuinely cannot name the system (IS-3.2.4 manual Yes;
5369
+ // TRA-34c parent-category-selected with no system subtype). The full
5370
+ // policy text lives in the catalog comment block above the row in
5371
+ // `data/core_indicators.yaml` @ 622410b.
5372
+ // Also reconciled here, INHERITED from the previous refresh: the
5373
+ // `sexualized_content_performance_activity` (136-146) definition. The
5374
+ // a596eb9 → 84a1b67 delta appended the SEXUALIZED-CONTENT-SPLIT-2026-07-15
5375
+ // UMBRELLA NOTE to it, and 0.8.14 shipped the pin bump without it, so the
5376
+ // definition has been stale since. It now carries the catalog text verbatim.
5377
+ // (Two remaining JSON-vs-YAML differences are round-trip artifacts, not
5378
+ // drift: an unescaped `fiancé` and unwrapped hard-wrapped lines.)
5379
+ //
5275
5380
  // CVC_136_ALERT_INDICATOR above is a legacy Thread-only surface with NO
5276
5381
  // canonical basis; it is deliberately left untouched in 0.8.13 (a separate
5277
5382
  // Thread cleanup). The canonical alert axis is the `isAlert` ATTRIBUTE on
@@ -5286,6 +5391,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5286
5391
  "abuser_unemployed",
5287
5392
  "access_to_vulnerable_individuals",
5288
5393
  "acknowledgement_or_report_of_human_trafficking",
5394
+ "active_protective_order",
5289
5395
  "ads_available_247",
5290
5396
  "ads_imply_multiple_workers",
5291
5397
  "ads_prost_slang",
@@ -5309,6 +5415,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5309
5415
  "cannot_stop_working_or_freely_leave",
5310
5416
  "child_not_abusers_in_household",
5311
5417
  "child_welfare_system_involvement",
5418
+ "clients_unaware_of_third_party_coordination",
5312
5419
  "coerced_to_misrepresent_identity_or_activity",
5313
5420
  "coercive_debt_pressure",
5314
5421
  "coercive_debt_pressure_youth",
@@ -5331,6 +5438,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5331
5438
  "debt_terms_deceptive_youth",
5332
5439
  "denied_basic_needs",
5333
5440
  "depends_on_employer_for_immigration_status",
5441
+ "depends_on_spouse_or_family_for_immigration_status",
5334
5442
  "does_not_control_finances_or_earnings",
5335
5443
  "does_not_control_identity_documents",
5336
5444
  "elevated_lethality_risk_signal",
@@ -5424,6 +5532,8 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5424
5532
  "several_cell_phones_or_frequent_number_changes",
5425
5533
  "sex_acts_in_own_residence",
5426
5534
  "sexual_exploitation",
5535
+ "sexualized_content_in_person_performance_activity",
5536
+ "sexualized_content_online_performance_activity",
5427
5537
  "sexualized_content_performance_activity",
5428
5538
  "shared_contact_network",
5429
5539
  "signs_of_physical_abuse_confinement_or_neglect",
@@ -5469,6 +5579,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5469
5579
  "trafficking_experience_past_10plusy",
5470
5580
  "trafficking_experience_past_3to10y",
5471
5581
  "trafficking_experience_past_lt3y",
5582
+ "trauma_perpetrator_is_current_manager",
5472
5583
  "travel_organized_by_third_party",
5473
5584
  "tricked_or_pressured_into_unwanted_acts",
5474
5585
  "under_18_advertised_age",
@@ -5501,7 +5612,8 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5501
5612
  "abuser_threatened_suicide": "Abuser threatened suicide",
5502
5613
  "abuser_unemployed": "Abuser is unemployed",
5503
5614
  "access_to_vulnerable_individuals": "Access to or connections with vulnerable individuals",
5504
- "acknowledgement_or_report_of_human_trafficking": "Acknowledgement or report of human trafficking",
5615
+ "acknowledgement_or_report_of_human_trafficking": "Human trafficking disclosure or report",
5616
+ "active_protective_order": "Active protective order (client-reported)",
5505
5617
  "ads_available_247": "Advertises available anytime / 24-7",
5506
5618
  "ads_imply_multiple_workers": "Ads imply multiple workers",
5507
5619
  "ads_prost_slang": "Ad uses prostitution slang",
@@ -5525,6 +5637,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5525
5637
  "cannot_stop_working_or_freely_leave": "Cannot stop working or freely leave home/work",
5526
5638
  "child_not_abusers_in_household": "Child in household who is not the abuser's biological child",
5527
5639
  "child_welfare_system_involvement": "Child welfare system involvement (history)",
5640
+ "clients_unaware_of_third_party_coordination": "Clients unaware they are coordinating with a third party (concealed dispatch)",
5528
5641
  "coerced_to_misrepresent_identity_or_activity": "Coerced to misrepresent age, identity, or work activity to outsiders",
5529
5642
  "coercive_debt_pressure": "Pressured to do things to pay off debt (coercive debt repayment)",
5530
5643
  "coercive_debt_pressure_youth": "Pressured to do things to pay off debt (youth missing-from-care)",
@@ -5547,6 +5660,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5547
5660
  "debt_terms_deceptive_youth": "Debt repayment terms differed from what was expected (youth missing-from-care)",
5548
5661
  "denied_basic_needs": "Denied basic needs (food, water, sleep, medical care)",
5549
5662
  "depends_on_employer_for_immigration_status": "Depends on employer for immigration status (tied visa / living with employer)",
5663
+ "depends_on_spouse_or_family_for_immigration_status": "Depends on spouse / family member for immigration status (tied family visa)",
5550
5664
  "does_not_control_finances_or_earnings": "Limited independence: does not control finances or earnings",
5551
5665
  "does_not_control_identity_documents": "Limited independence: does not control identity documents",
5552
5666
  "elevated_lethality_risk_signal": "Elevated lethality risk",
@@ -5640,6 +5754,8 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5640
5754
  "several_cell_phones_or_frequent_number_changes": "Several cell phones or frequently changing phone number",
5641
5755
  "sex_acts_in_own_residence": "Sex acts take place in person's own residence",
5642
5756
  "sexual_exploitation": "Sexual exploitation (general)",
5757
+ "sexualized_content_in_person_performance_activity": "In-person sexualized performance / appearance-based activity",
5758
+ "sexualized_content_online_performance_activity": "Online sexual performance / interactive sexual content activity",
5643
5759
  "sexualized_content_performance_activity": "Sexualized content, performance, or communications activity",
5644
5760
  "shared_contact_network": "Shares a contact network (phones/handles)",
5645
5761
  "signs_of_physical_abuse_confinement_or_neglect": "Signs of physical abuse, confinement, or neglect (observed)",
@@ -5685,6 +5801,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5685
5801
  "trafficking_experience_past_10plusy": "Trafficking experience recency: 10+ years since last experience",
5686
5802
  "trafficking_experience_past_3to10y": "Trafficking experience recency: 3–10 years since last experience",
5687
5803
  "trafficking_experience_past_lt3y": "Trafficking experience recency: less than 3 years since last experience",
5804
+ "trauma_perpetrator_is_current_manager": "Trauma perpetrator is a current manager / facilitator (trauma-bonded control)",
5688
5805
  "travel_organized_by_third_party": "Travel organized by a third party (sex provider does not control own movement)",
5689
5806
  "tricked_or_pressured_into_unwanted_acts": "Tricked or pressured into unwanted acts or activities (generic coercion)",
5690
5807
  "under_18_advertised_age": "Under 18 (ad-derived / advertised age)",
@@ -2,7 +2,7 @@
2
2
  "domain": "assertion_domain",
3
3
  "name": "Assertion Domain (CVC-159)",
4
4
  "version": "2.0.0",
5
- "_status": "CANONICAL — RENUMBERED 0.8.13 from provisional CVC-964 to canonical CVC-159. Live prototype HEAD a596eb9: `Final CVCs` -> `core - assertion_domain` = CVC-159 (vocab_status 'Ready for dev', Verification 'Verified'), corroborated by 17 `data/cvcs/core_assertion_domain_extensions_*.yaml` files that all declare `cvc: core - assertion_domain`. CVC-159 was freed by deleting the 100%-unbound hand-coded `CVC_159_RELATIONSHIP_TIES` family from `src/constants/ic.ts`; `relationship_ties` keeps its canonical CVC-158. Consumers persist KEYS, not wire codes, so the renumber is compile-clean (regenerate `cvcKeys.ts`). WITHDRAWN in 0.8.13 (all three have ZERO occurrences at prototype HEAD): `romantic_relationship` (964-066) — upstream the romantic-partner lifecycle routes to `household_relationships`, see `data/cvcs/core_romantic_relationship_change_type.yaml`; `household_tenure` (964-045); `household_composition` (964-067). All three fold into `household_relationships` (554 occurrences at HEAD). NOTE: `romantic_partner` is a relationship-type VALUE code (1,575 occurrences), never an assertion domain — it is correctly not modelled here. `child_profile` (159-065) is KEPT: 353 occurrences at HEAD. Segment-2 ordinals are preserved across the renumber (gaps at 045/066/067 are intentional; no data migration exists, but stable ordinals keep the diff reviewable). The 37 domains PAVE ships that are absent from the Final CVC-159 export all have substantial upstream occurrence counts and are retained as proposed CVC-159 extensions.",
5
+ "_status": "CANONICAL — RENUMBERED 0.8.13 from provisional CVC-964 to canonical CVC-159. Live prototype HEAD a596eb9: `Final CVCs` -> `core - assertion_domain` = CVC-159 (vocab_status 'Ready for dev', Verification 'Verified'), corroborated by 17 `data/cvcs/core_assertion_domain_extensions_*.yaml` files that all declare `cvc: core - assertion_domain`. CVC-159 was freed by deleting the 100%-unbound hand-coded `CVC_159_RELATIONSHIP_TIES` family from `src/constants/ic.ts`; `relationship_ties` keeps its canonical CVC-158. Consumers persist KEYS, not wire codes, so the renumber is compile-clean (regenerate `cvcKeys.ts`). WITHDRAWN in 0.8.13 (all three have ZERO occurrences at prototype HEAD): `romantic_relationship` (964-066) — upstream the romantic-partner lifecycle routes to `household_relationships`, see `data/cvcs/core_romantic_relationship_change_type.yaml`; `household_tenure` (964-045); `household_composition` (964-067). All three fold into `household_relationships` (554 occurrences at HEAD). NOTE: `romantic_partner` is a relationship-type VALUE code (1,575 occurrences), never an assertion domain — it is correctly not modelled here. `child_profile` (159-065) is KEPT: 353 occurrences at HEAD. Segment-2 ordinals are preserved across the renumber (gaps at 045/066/067 are intentional; no data migration exists, but stable ordinals keep the diff reviewable). The 37 domains PAVE ships that are absent from the Final CVC-159 export all have substantial upstream occurrence counts and are retained as proposed CVC-159 extensions. | 0.8.20: ADDED `signal_identification` (159-066) and `investigative_legal` (159-067) -- retroactive homing of the Track-1 identification-rung emitter live since 2026-08-23; both ratified in the CVC-159 codebook 2026-08-29 (prototype PR #519, hti-features PR #34). Ordinals 066/067 were free: the 0.8.13 withdrawals that reserved those slots were under the OLD CVC-964 numbering and the 159 equivalents were never issued -- verified zero references to 159-066/159-067 anywhere in the repo or the published dist before assigning. The 045 gap remains reserved. The rung VALUE set those two domains carry lives in its own vocabulary (`riskIdentificationMilestone`, CVC-267) rather than as Level-2 rows here: `AssertionDomainKeys` is consumed as THE SET OF DOMAINS, and folding values into it breaks that contract for every consumer -- PAVE's `Record<AssertionDomain, DomainValueVocabulary>` totality gate would demand a domain classification for `on_radar`. CVC-159 stays Level-1 only.",
6
6
  "_source": "htilabstech/prototype@a596eb9 Final CVCs/Assertion Contract/core - assertion_domain.md (CVC-159) + 17 core_assertion_domain_extensions_*.yaml",
7
7
  "levels": {
8
8
  "0": "Unknown or Missing",
@@ -624,6 +624,24 @@
624
624
  "parentCode": null,
625
625
  "childCodes": [],
626
626
  "definition": "assertion_domain partition for CARs on a Child profile subject-record entity (Add Child / Edit Child; core_child_change_type verbs). DRAFT-TEMPORARY direct import from prototype, pending Notion ratification."
627
+ },
628
+ {
629
+ "code": "159-066-000-000-000-000-000",
630
+ "key": "signal_identification",
631
+ "title": "Signal / Identification",
632
+ "selectable": true,
633
+ "parentCode": null,
634
+ "childCodes": [],
635
+ "definition": "The identification-funnel pipeline domain: a subject's position on the reach ladder (on_radar -> screened -> at_risk -> assessed), asserted by the `identification_rung_reached` CAR whose `assertion_value_code` is the rung (CVC-267). Ratified 2026-08-29 as retroactive codebook homing of a live emitter that has minted rung CARs since 2026-08-23 (Crysta ruling, milestone-residue R1). A rung CAR asserts that a subject REACHED a rung; it never restates a determination -- it joins the derived milestone row via `pm_ref`, and the derived row remains the derived row (a milestone row never IS the CAR). Distinct from `identification_status` (CVC-241), the identity-CONFIDENCE axis; per the 2026-06-30 naming directive that axis is named `identity_status` and 'identification ladder' is a retired synonym for it -- display copy for THIS domain says 'identification funnel' or 'pipeline rungs', never bare 'identification ladder'. The `determined` rung is filed under BOTH this domain and `investigative_legal` (ruling 2026-08-29); its STORED domain stays `investigative_legal` as built."
636
+ },
637
+ {
638
+ "code": "159-067-000-000-000-000-000",
639
+ "key": "investigative_legal",
640
+ "title": "Investigative / Legal",
641
+ "selectable": true,
642
+ "parentCode": null,
643
+ "childCodes": [],
644
+ "definition": "The investigation-and-legal-process domain. Carries `TRAFFICKING_STATUS` (CVC-267) and is the STORED `assertion_domain` of the `determined` rung of the identification funnel -- the rung measures reaching a conclusion in a safe setting, not which conclusion, so a no-indication determination still counts. Ratified 2026-08-29 alongside `signal_identification`: it is live in the same emitter and was equally unhomed. Filed-under-both (ruling 2026-08-29): data relevant to multiple milestone topics is documented under every topic it is relevant for, while CVC-159's one-assertion-one-domain rule keeps the STORED domain single -- nothing re-mints."
627
645
  }
628
646
  ]
629
647
  }
@@ -0,0 +1,80 @@
1
+ {
2
+ "domain": "assertion_status",
3
+ "name": "Assertion Status",
4
+ "version": "1.0.0",
5
+ "_status": "PROVISIONAL — GDR §10.1 confirmed-CVC name is `core - status`, but Final CVCs/CVC_INDEX.md @ a596eb9 carries no number for it, so it parks in the provisional 900-block pending canonical Notion authoring + steward ratification. Substantive values sourced verbatim from the PAVE @pave/domain `ASSERTION_STATUSES` enum (D10 GDR §10.1 bulk publish, bead pv-pgdr-cvc-source-gdr-10-1-bulk-publish). The PAVE enum enumerates only the substantive lifecycle states, so the missingness quadruplet is added per SOT convention.",
6
+ "_source": "pave-2.0/packages/domain/src/enums.ts ASSERTION_STATUSES",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Assertion lifecycle status"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "985-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "985-000-000-000-000-000-001",
20
+ "985-000-000-000-000-000-002",
21
+ "985-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "985-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "985-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "The assertion status is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "985-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "985-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld, declined, or redacted."
42
+ },
43
+ {
44
+ "code": "985-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "985-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "985-001-000-000-000-000-000",
54
+ "key": "active",
55
+ "title": "Active",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "In force — the current, non-superseded row for its spine partition. Emitting systems typically default new assertions to this status (e.g. PAVE's assertion factory defaults `status: \"active\"`)."
60
+ },
61
+ {
62
+ "code": "985-002-000-000-000-000-000",
63
+ "key": "superseded",
64
+ "title": "Superseded",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Replaced by a later assertion row in the same spine partition. When status === \"superseded\", `supersedes_assertion_id` is required per GLOBAL_DESIGN_RULES §5.5."
69
+ },
70
+ {
71
+ "code": "985-003-000-000-000-000-000",
72
+ "key": "retracted",
73
+ "title": "Retracted",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Withdrawn or invalidated without a replacement row — the claim is no longer asserted. Distinct from superseded (which points at a successor)."
78
+ }
79
+ ]
80
+ }
@@ -0,0 +1,89 @@
1
+ {
2
+ "domain": "car_correction_reason",
3
+ "name": "CAR Correction Reason",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering (992). Non-clinical bookkeeping/provenance vocabulary — the coded KIND of a CAR (Contextual Assertion Record) correction or retraction, engineer-direct-authored per the PAVE CVC-authoring governance steer (structural, provisional/ratify-later; FYI to Crysta, NOT Crysta-gated). The first three tokens are sourced verbatim from PAVE `@pave/domain` CAR_CORRECTION_REASONS / RETRACTION_TYPES (packages/domain/src/carGovernance.ts), themselves hoisted from packages/db/src/services/assertionRetraction.ts's documented `retractionType` set; publishing them here retires that PAVE-local const in favour of the SOT it always wanted (carGovernance.ts §'Where these labels are DERIVED' notes 'the day a CVC publishes these three the swap is one deriveLabels call'). The fourth, removed_by_recipient_curation, is added for the PAVE CaseShare received-content curation lane (bead pv-p6share-curation-retract-reason-vocab, 2026-09-18). CASING: lower_snake per the CVC key regex. PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "pave-2.0/packages/domain/src/carGovernance.ts CAR_CORRECTION_REASONS; pave-2.0/packages/db/src/services/assertionRetraction.ts RetractAssertionInput.retractionType; removed_by_recipient_curation net-new for the received-content curation lane (pv-p6share-curation-retract-reason-vocab)",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "CAR correction / retraction reason (single-select per correction event)"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "992-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "992-000-000-000-000-000-001",
20
+ "992-000-000-000-000-000-002",
21
+ "992-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data. Variant: 3-value (unknown, anonymous, data_not_collected). No prefer_not_to_answer — workspace standard ANON semantic rolls 'declined to answer' into the anonymous sentinel. A correction reason is always explicitly chosen in practice; the quadruplet is present per SOT convention, not because a correction is expected to be missing."
24
+ },
25
+ {
26
+ "code": "992-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "992-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Value is unknown at time of entry."
33
+ },
34
+ {
35
+ "code": "992-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "992-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld or redacted. Combines declined-to-answer and redacted/anonymous semantics under the workspace standard ANON sentinel."
42
+ },
43
+ {
44
+ "code": "992-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "992-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "992-001-000-000-000-000-000",
54
+ "key": "entered_in_error",
55
+ "title": "Entered in error",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "The assertion should never have been recorded — it was captured by mistake (wrong subject, wrong field, an advocate mis-click, or a claim the conversation did not actually support). The row is RETRACTED, not hard-deleted: a retraction retains the row it retracts so the log of record stays forensic. The canonical 'this is not true and never was' correction."
60
+ },
61
+ {
62
+ "code": "992-002-000-000-000-000-000",
63
+ "key": "duplicate",
64
+ "title": "Duplicate of another assertion",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "The same claim was asserted twice in the same spine partition (e.g. captured from two surfaces, or re-emitted by an ingest path that did not de-duplicate). The duplicate copy is retracted; the canonical copy remains active. Distinct from entered_in_error: the claim IS true, it is merely recorded more than once."
69
+ },
70
+ {
71
+ "code": "992-003-000-000-000-000-000",
72
+ "key": "superseded_externally",
73
+ "title": "Superseded externally",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "The assertion is retired because a truer or more current value arrived from OUTSIDE the ordinary in-partition supersession chain (e.g. a corrected value from another system or a later disclosure that a normal supersede row could not express). Use when the successor is not itself a spine row that carries `supersedes_assertion_id`; where an in-partition successor exists, status 'superseded' with `supersedes_assertion_id` is the right shape instead."
78
+ },
79
+ {
80
+ "code": "992-004-000-000-000-000-000",
81
+ "key": "removed_by_recipient_curation",
82
+ "title": "Removed by recipient curation",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Recipient-side curation removal of a received (re-emitted) assertion; added for PAVE CaseShare received-content curation, 2026-09-18. A recipient agency curates a cleanly-attributed foreign re-emitted CAR (indicator / victimization / involvement) out of their own record — the claim is not asserted as false, it is simply not one this recipient chooses to carry. The row is RETRACTED with this coded, honest reason rather than silently dropped, so the received-then-removed sequence stays on the log of record and the origin's assertion is untouched. Distinct from entered_in_error (a mistaken capture) and from duplicate (a redundant copy): the assertion was validly received and validly removed by the receiving side's curation decision."
87
+ }
88
+ ]
89
+ }
@@ -0,0 +1,62 @@
1
+ {
2
+ "domain": "case_share_state",
3
+ "name": "Core Case Share State",
4
+ "version": "1.0.0",
5
+ "levels": { "1": "State" },
6
+ "entries": [
7
+ {
8
+ "code": "925-001-000-000-000-000-000",
9
+ "key": "pending",
10
+ "title": "Pending",
11
+ "selectable": true,
12
+ "parentCode": null,
13
+ "childCodes": [],
14
+ "definition": "The share has been delivered to the receiving party and is awaiting a claim. No one on the receiving side has taken responsibility for it yet, and no client content has been disclosed."
15
+ },
16
+ {
17
+ "code": "925-002-000-000-000-000-000",
18
+ "key": "claimed",
19
+ "title": "Claimed",
20
+ "selectable": true,
21
+ "parentCode": null,
22
+ "childCodes": [],
23
+ "definition": "A team on the receiving side has taken custody of the share but has not yet accepted it. Claiming assigns responsibility only; it discloses no client content, so a claimed share is still outstanding work rather than a completed exchange."
24
+ },
25
+ {
26
+ "code": "925-003-000-000-000-000-000",
27
+ "key": "accepted_awaiting_review",
28
+ "title": "Accepted — awaiting review",
29
+ "selectable": true,
30
+ "parentCode": null,
31
+ "childCodes": [],
32
+ "definition": "The share has been accepted and its content disclosed, but one or more delivered persons matched an existing record ambiguously and are held for a human decision before the receiving record is linked."
33
+ },
34
+ {
35
+ "code": "925-004-000-000-000-000-000",
36
+ "key": "accepted",
37
+ "title": "Accepted",
38
+ "selectable": true,
39
+ "parentCode": null,
40
+ "childCodes": [],
41
+ "definition": "The share has been accepted, its content disclosed, and the link to the receiving party's record written. Terminal."
42
+ },
43
+ {
44
+ "code": "925-005-000-000-000-000-000",
45
+ "key": "declined",
46
+ "title": "Declined",
47
+ "selectable": true,
48
+ "parentCode": null,
49
+ "childCodes": [],
50
+ "definition": "The receiving party refused the share at the claim decision point, BEFORE its content was disclosed. Distinct from rejected: no client information was released, so the refusal carries no disclosure to account for. Terminal."
51
+ },
52
+ {
53
+ "code": "925-006-000-000-000-000-000",
54
+ "key": "rejected",
55
+ "title": "Rejected",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "The receiving party refused the share AFTER accepting it and reviewing its content. Distinct from declined: the disclosure already occurred and remains subject to the receiving party's retention and audit obligations. Terminal."
60
+ }
61
+ ]
62
+ }