@htilabs/platform-common-models 0.8.13 → 0.8.15

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 (75) hide show
  1. package/README.md +44 -0
  2. package/dist/config/index.cjs +4 -0
  3. package/dist/config/index.cjs.map +1 -1
  4. package/dist/config/index.d.cts +16 -1
  5. package/dist/config/index.d.ts +16 -1
  6. package/dist/config/index.js +2 -0
  7. package/dist/config/index.js.map +1 -1
  8. package/dist/constants/index.cjs +10 -0
  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 +10 -0
  13. package/dist/constants/index.js.map +1 -1
  14. package/dist/cvcs/index.cjs +601 -2
  15. package/dist/cvcs/index.cjs.map +1 -1
  16. package/dist/cvcs/index.d.cts +2754 -2084
  17. package/dist/cvcs/index.d.ts +2754 -2084
  18. package/dist/cvcs/index.js +594 -2
  19. package/dist/cvcs/index.js.map +1 -1
  20. package/dist/{index-I-DiX9eQ.d.ts → index-CDoqrfc1.d.ts} +1 -1
  21. package/dist/{index-CoVr1jIV.d.cts → index-Zu_mOJRn.d.cts} +1 -1
  22. package/dist/index.cjs +709 -4
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.d.cts +154 -7
  25. package/dist/index.d.ts +154 -7
  26. package/dist/index.js +693 -4
  27. package/dist/index.js.map +1 -1
  28. package/dist/models/index.d.cts +2 -2
  29. package/dist/models/index.d.ts +2 -2
  30. package/dist/mongo/index.cjs +383 -0
  31. package/dist/mongo/index.cjs.map +1 -0
  32. package/dist/mongo/index.d.cts +221 -0
  33. package/dist/mongo/index.d.ts +221 -0
  34. package/dist/mongo/index.js +351 -0
  35. package/dist/mongo/index.js.map +1 -0
  36. package/dist/{platform-auth-BfCMuAlC.d.cts → platform-auth-AsfnIXfK.d.cts} +2 -2
  37. package/dist/{platform-auth-BfCMuAlC.d.ts → platform-auth-AsfnIXfK.d.ts} +2 -2
  38. package/dist/schemas/index.cjs +5 -1
  39. package/dist/schemas/index.cjs.map +1 -1
  40. package/dist/schemas/index.d.cts +29 -25
  41. package/dist/schemas/index.d.ts +29 -25
  42. package/dist/schemas/index.js +5 -1
  43. package/dist/schemas/index.js.map +1 -1
  44. package/dist/types/index.d.cts +2 -2
  45. package/dist/types/index.d.ts +2 -2
  46. package/package.json +10 -1
  47. package/src/__sot__/coreIndicators.pin.json +6 -1
  48. package/src/__tests__/__snapshots__/cvc-sot.snap +18 -2
  49. package/src/__tests__/cvc-136-scoring-invariant.test.ts +6 -3
  50. package/src/__tests__/cvc-drift-gate.test.ts +14 -3
  51. package/src/__tests__/cvc-sot-snapshot.test.ts +13 -1
  52. package/src/__tests__/cvc-structural.test.ts +6 -0
  53. package/src/__tests__/mongo-verifier.test.ts +502 -0
  54. package/src/config/index.ts +8 -2
  55. package/src/constants/ic.ts +31 -2
  56. package/src/cvcs/assertionStatus.v1.0.0.json +80 -0
  57. package/src/cvcs/caseShareState.v1.0.0.json +62 -0
  58. package/src/cvcs/coreIndicators.v1.0.0.json +67 -2
  59. package/src/cvcs/createdBySystem.v1.0.0.json +89 -0
  60. package/src/cvcs/criminalOrgCategory.v1.0.0.json +116 -0
  61. package/src/cvcs/hmisSex.v1.0.0.json +89 -0
  62. package/src/cvcs/index.ts +22 -0
  63. package/src/cvcs/minorAdultStatus.v1.0.0.json +80 -0
  64. package/src/cvcs/referralOrigin.v1.0.0.json +26 -0
  65. package/src/cvcs/subjectType.v1.0.0.json +80 -0
  66. package/src/generated/cvc-enums.ts +125 -2
  67. package/src/index.ts +20 -0
  68. package/src/mongo/catalog.ts +65 -0
  69. package/src/mongo/contract.ts +157 -0
  70. package/src/mongo/index.ts +343 -0
  71. package/src/mongo/similarity.ts +133 -0
  72. package/src/mongo/uri.ts +53 -0
  73. package/src/schemas/common.ts +4 -0
  74. package/dist/{cvcEntry-BCj1OWqL.d.cts → cvcEntry-0BIB9sen.d.cts} +8 -8
  75. package/dist/{cvcEntry-BCj1OWqL.d.ts → cvcEntry-0BIB9sen.d.ts} +8 -8
@@ -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,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
+ }
@@ -2,8 +2,8 @@
2
2
  "domain": "core_indicators",
3
3
  "name": "Core Indicators (CVC-136)",
4
4
  "version": "1.0.0",
5
- "_status": "CANONICAL — re-sourced 0.8.13 from the live canonical catalog `data/core_indicators.yaml` @ prototype HEAD a596eb9 (208 codes), plus 2 codes that @hti/scoring (`weights/risk.weights.json` @ 9b5d654, `emits_by_code`) emits but the codebook has not yet adopted (`coercive_debt_pressure_youth`, `debt_terms_deceptive_youth`) = 210 substantive codes. 0.8.12 shipped 199 hand-coded codes in `src/constants/ic.ts` (`CVC_136_CORE_INDICATOR_VALUES`); 54 of those were invented rollup prefixes (`vc_*`, `csi_*`, `csctx_*`, `dv_*`, `net_*`, `auto_*`) with zero occurrences upstream and zero consumers in @hti/scoring, and 1 (`unusual_work_circumstances_general`) was coined from a label's parenthetical; all 55 are WITHDRAWN. 66 canonical codes that were missing are ADDED. Math: 199 - 1 - 54 + 66 = 210. HARD INVARIANT (enforced by `src/__tests__/cvc-136-scoring-invariant.test.ts`): every one of the 169 codes in @hti/scoring's `emits_by_code` is present in this domain. Entry attributes `family` / `polarity` / `severity` / `isAlert` / `alertWhen` are carried verbatim from the canonical catalog. `isAlert` is the ALERT AXIS: the alert list is a DERIVED VIEW over this domain (isAlert in {thread_pave, platform, pave}), not a separate taxonomy.",
6
- "_source": "htilabstech/prototype@a596eb9 data/core_indicators.yaml + htilabstech/hti-scoring@9b5d654 weights/risk.weights.json (emits_by_code)",
5
+ "_status": "CANONICAL — re-sourced 0.11.1 from the live canonical catalog `data/core_indicators.yaml` @ prototype HEAD 84a1b677 (213 codes; +5 vs the 0.8.13 pin a596eb9, 0 withdrawn), plus 2 codes that @hti/scoring (`weights/risk.weights.json` @ 9b5d654, `emits_by_code`) emits but the codebook has not yet adopted (`coercive_debt_pressure_youth`, `debt_terms_deceptive_youth`), each flagged `pendingUpstreamAdoption: true`. 215 substantive + the missingness quadruplet = 219 entries. New codes are APPENDED at 211-215 so every previously issued positional code stays stable.",
6
+ "_source": "htilabstech/prototype@84a1b677 data/core_indicators.yaml + htilabstech/hti-scoring@9b5d654 weights/risk.weights.json (emits_by_code)",
7
7
  "levels": {
8
8
  "0": "Unknown or Missing",
9
9
  "1": "Indicator"
@@ -2835,6 +2835,71 @@
2835
2835
  "polarity": "increases_risk",
2836
2836
  "severity": "elevated",
2837
2837
  "isAlert": "none"
2838
+ },
2839
+ {
2840
+ "code": "136-211-000-000-000-000-000",
2841
+ "key": "clients_unaware_of_third_party_coordination",
2842
+ "title": "Clients unaware they are coordinating with a third party (concealed dispatch)",
2843
+ "selectable": true,
2844
+ "parentCode": null,
2845
+ "childCodes": [],
2846
+ "definition": "LEADS TRA-7-aware captured that sex buyers reaching out to \"the person\" are in fact coordinating with a third party (dispatcher / manager / call service) WITHOUT knowing it — a concealed-intermediary booking pattern. Concealment of the coordinating third party from buyers is a control + facilitation marker over and above third-party coordination itself (which TRA-7 sometimes/never + TRA-7-who already capture): the operation is actively passing as the provider. Authored 2026-07-17 (TRA-VETTING, Crysta: \"let's author one\") for the restored production follow-up question.",
2847
+ "family": "mechanism_control",
2848
+ "polarity": "increases_risk",
2849
+ "severity": "elevated",
2850
+ "isAlert": "none"
2851
+ },
2852
+ {
2853
+ "code": "136-212-000-000-000-000-000",
2854
+ "key": "depends_on_spouse_or_family_for_immigration_status",
2855
+ "title": "Depends on spouse / family member for immigration status (tied family visa)",
2856
+ "selectable": true,
2857
+ "parentCode": null,
2858
+ "childCodes": [],
2859
+ "definition": "Indication the person's legal ability to remain in the U.S. depends on a spouse, fiancé(e), or family member (family/fiancé-based immigrant visa or derivative status) while their current status is a valid or overstayed visa. The family twin of depends_on_employer_for_immigration_status: a visa tied to a potentially abusive relationship is a major dependence vulnerability and a coercion lever (\"stay / comply or lose your status\"). Authored 2026-07-17 (TRA-VETTING open-items round, Crysta: dependence \"whether it is via your husband or your employer is a MAJOR vulnerability\").",
2860
+ "family": "mechanism_control",
2861
+ "polarity": "depends",
2862
+ "severity": "elevated",
2863
+ "isAlert": "none"
2864
+ },
2865
+ {
2866
+ "code": "136-213-000-000-000-000-000",
2867
+ "key": "sexualized_content_in_person_performance_activity",
2868
+ "title": "In-person sexualized performance / appearance-based activity",
2869
+ "selectable": true,
2870
+ "parentCode": null,
2871
+ "childCodes": [],
2872
+ "definition": "Canonical activity evidence (DH § II Activity 2.2.3) that the person engages in in-person sexualized, erotic, appearance-based, or entertainment activity with sexualized expectations — stripping, dancing, posing, hostess or venue work, escort/companionship without an established sex act — sex-market-adjacent, recorded descriptively; not necessarily a sex act for value.",
2873
+ "family": "cs_industry_context",
2874
+ "polarity": "increases_risk",
2875
+ "severity": "elevated",
2876
+ "isAlert": "none"
2877
+ },
2878
+ {
2879
+ "code": "136-214-000-000-000-000-000",
2880
+ "key": "sexualized_content_online_performance_activity",
2881
+ "title": "Online sexual performance / interactive sexual content activity",
2882
+ "selectable": true,
2883
+ "parentCode": null,
2884
+ "childCodes": [],
2885
+ "definition": "Canonical activity evidence (DH § II Activity 2.2.2) that the person engages in sexualized or sexually explicit activity performed, streamed, recorded, messaged, or displayed through online or digital platforms — webcamming, livestreams, paid chats, content-platform work — recorded descriptively whether or not a commercial sex act is established.",
2886
+ "family": "cs_industry_context",
2887
+ "polarity": "increases_risk",
2888
+ "severity": "elevated",
2889
+ "isAlert": "none"
2890
+ },
2891
+ {
2892
+ "code": "136-215-000-000-000-000-000",
2893
+ "key": "trauma_perpetrator_is_current_manager",
2894
+ "title": "Trauma perpetrator is a current manager / facilitator (trauma-bonded control)",
2895
+ "selectable": true,
2896
+ "parentCode": null,
2897
+ "childCodes": [],
2898
+ "definition": "ENGINE-DERIVED conjunction: the same person the subject named as a trauma perpetrator (TRA-35 sexual violence / physical abuse / emotional-verbal-stalking capture) ALSO holds an operational-control edge over the subject (a TRA facilitation who-answer — posts ads / arranges dates / controls or keeps earnings / receives payments / organizes travel / holds documentation / above in the operation — or a relationship pair with a facilitator/offender role signal of their own). Two independently-captured facts joined on person identity — never an assumption (Crysta 2026-07-17: \"these are two different questions\"). The conjunction is the classic trauma-bonded, difficult-to-leave control situation.",
2899
+ "family": "mechanism_control",
2900
+ "polarity": "increases_risk",
2901
+ "severity": "severe",
2902
+ "isAlert": "none"
2838
2903
  }
2839
2904
  ]
2840
2905
  }
@@ -0,0 +1,89 @@
1
+ {
2
+ "domain": "created_by_system",
3
+ "name": "Created By System",
4
+ "version": "1.0.0",
5
+ "_status": "PROVISIONAL — GDR §10.1 confirmed-CVC name is `core - created_by_system`, 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 `CREATED_BY_SYSTEMS` enum (D10 GDR §10.1 bulk publish, bead pv-pgdr-cvc-source-gdr-10-1-bulk-publish). The PAVE enum enumerates only the substantive actor classes, so the missingness quadruplet is added per SOT convention.",
6
+ "_source": "pave-2.0/packages/domain/src/enums.ts CREATED_BY_SYSTEMS",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Creating actor class"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "986-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
+ "986-000-000-000-000-000-001",
20
+ "986-000-000-000-000-000-002",
21
+ "986-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "986-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "986-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "The creating actor class is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "986-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "986-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld, declined, or redacted."
42
+ },
43
+ {
44
+ "code": "986-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "986-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "986-001-000-000-000-000-000",
54
+ "key": "human",
55
+ "title": "Human",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "A person created the assertion row directly. Emitting systems typically default to this value (e.g. PAVE's assertion factory defaults `createdBySystem: \"human\"`)."
60
+ },
61
+ {
62
+ "code": "986-002-000-000-000-000-000",
63
+ "key": "integration",
64
+ "title": "Integration",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "An external-system integration created the row (cross-app ingest, imports, connected systems). Pair with source/provenance fields for the originating system."
69
+ },
70
+ {
71
+ "code": "986-003-000-000-000-000-000",
72
+ "key": "rules_engine",
73
+ "title": "Rules engine",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Deterministic business logic or a rules engine created the row. `inference_type` is required when created_by_system ∈ {rules_engine, model} per GLOBAL_DESIGN_RULES §5.5."
78
+ },
79
+ {
80
+ "code": "986-004-000-000-000-000-000",
81
+ "key": "model",
82
+ "title": "Model",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "An ML model or statistical scoring process created the row. `inference_type` is required when created_by_system ∈ {rules_engine, model} per GLOBAL_DESIGN_RULES §5.5."
87
+ }
88
+ ]
89
+ }
@@ -0,0 +1,116 @@
1
+ {
2
+ "domain": "criminal_org_category",
3
+ "name": "Criminal Organization Category",
4
+ "version": "1.0.0",
5
+ "_status": "DRAFT — TEMPORARY: net-new value-CVC not yet in Notion; provisional 990 numbering; codes from prototype/data/cvcs/core_criminal_org_category.yaml (WIKI 7-type taxonomy, name signed off Crysta-proxy 2026-06-06); PENDING canonical Notion authoring. Categorizes each criminal-organization registry record; the registry (org records) is reference data seeded separately, keyed by this category code.",
6
+ "_source": "prototype/data/cvcs/core_criminal_org_category.yaml",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Criminal organization category"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "990-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
+ "990-000-000-000-000-000-001",
20
+ "990-000-000-000-000-000-002",
21
+ "990-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) under the workspace standard ANON semantic. The prototype YAML's single UNK sentinel (organization category cannot be determined) maps to the unknown child."
24
+ },
25
+ {
26
+ "code": "990-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "990-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "Organization category cannot be determined at time of entry. Carries the prototype's UNK case."
33
+ },
34
+ {
35
+ "code": "990-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "990-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": "990-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "990-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "990-001-000-000-000-000-000",
54
+ "key": "street_gang",
55
+ "title": "Street gang / neighborhood-based gang",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "Territorial, often city/neighborhood-based; multi-generational. Examples: Bloods, Crips, Latin Kings, Gangster Disciples. WIKI subtypes: African-American, Latino/Hispanic, hybrid/multiracial, Asian street gangs. A trafficking street gang stays street_gang (structure, not activity)."
60
+ },
61
+ {
62
+ "code": "990-002-000-000-000-000-000",
63
+ "key": "prison_gang",
64
+ "title": "Prison gang",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Originate and operate primarily inside prisons; influence street gangs. Often racialized; can be linked with cartels or domestic groups. Examples: Aryan Brotherhood, Mexican Mafia (La Eme), Black Guerrilla Family."
69
+ },
70
+ {
71
+ "code": "990-003-000-000-000-000-000",
72
+ "key": "outlaw_motorcycle_gang",
73
+ "title": "Outlaw motorcycle gang (OMG)",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Highly structured; emphasize brotherhood and loyalty. Often involved in drug and weapons trafficking, extortion, and FBI/DOJ-documented prostitution rackets. Examples: Hells Angels, Mongols, Bandidos, Outlaws."
78
+ },
79
+ {
80
+ "code": "990-004-000-000-000-000-000",
81
+ "key": "tco_cartel",
82
+ "title": "Transnational criminal organization (TCO) / cartel",
83
+ "selectable": true,
84
+ "parentCode": null,
85
+ "childCodes": [],
86
+ "definition": "Operate across borders; organized hierarchies; high levels of violence and corruption. Examples: Sinaloa Cartel, CJNG, Gulf Cartel (CDG), MS-13 (hybrid). WIKI subtypes: Mexican cartels, Central American groups, Colombian cartels, Asian cartels (e.g. Triads, Yakuza). A trafficking cartel stays tco_cartel (structure, not activity)."
87
+ },
88
+ {
89
+ "code": "990-005-000-000-000-000-000",
90
+ "key": "white_supremacist_extremist",
91
+ "title": "White supremacist / extremist gang",
92
+ "selectable": true,
93
+ "parentCode": null,
94
+ "childCodes": [],
95
+ "definition": "Blend gang culture with hate ideology; often recruit in prisons. Some are considered both prison and extremist gangs. Examples: Peckerwoods, Aryan Circle, Nazi Low Riders."
96
+ },
97
+ {
98
+ "code": "990-006-000-000-000-000-000",
99
+ "key": "organized_crime_family",
100
+ "title": "Organized crime family (traditional mafia)",
101
+ "selectable": true,
102
+ "parentCode": null,
103
+ "childCodes": [],
104
+ "definition": "Focus on racketeering, gambling, extortion; more secretive and hierarchical. Tends to be older, less visible but still active. Examples: Italian-American Mafia (e.g. Gambino family), Russian Mafia."
105
+ },
106
+ {
107
+ "code": "990-007-000-000-000-000-000",
108
+ "key": "familial_or_independent_trafficking_network",
109
+ "title": "Familial or independent trafficking network",
110
+ "selectable": true,
111
+ "parentCode": null,
112
+ "childCodes": [],
113
+ "definition": "STRUCTURAL category (renamed 2026-06-08 from human_trafficking_smuggling_network to restore mutual exclusivity): a family-based or standalone trafficking/smuggling network that is NOT a street/prison gang, cartel/TCO, outlaw motorcycle gang, organized crime family, or extremist organization. Examples: Tenancingo-style familial sex-trafficking networks (e.g. Rendon-Reyes, Granados); ethnic standalone networks (e.g. Thai/Intarathong). This category — or documented trafficking/prostitution activity on any org — is the load-bearing signal for the facilitator model's stronger trafficking-affiliation leaf."
114
+ }
115
+ ]
116
+ }
@@ -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
+ }
package/src/cvcs/index.ts CHANGED
@@ -44,6 +44,8 @@ import contactSafetyStatusSot from "./contactSafetyStatus.v1.0.0.json" with { ty
44
44
  import highestEducationLevelCompletedSot from "./highestEducationLevelCompleted.v1.0.0.json" with { type: "json" };
45
45
  import preferredContactMethodSot from "./preferredContactMethod.v1.0.0.json" with { type: "json" };
46
46
  import sharePurposeSot from "./sharePurpose.v1.0.0.json" with { type: "json" };
47
+ import referralOriginSot from "./referralOrigin.v1.0.0.json" with { type: "json" };
48
+ import caseShareStateSot from "./caseShareState.v1.0.0.json" with { type: "json" };
47
49
  import facilitatorEntityTypeSot from "./facilitatorEntityType.v1.0.0.json" with { type: "json" };
48
50
  import facilitatorSubroleSot from "./facilitatorSubrole.v1.0.0.json" with { type: "json" };
49
51
  import maritalStatusLegalSot from "./maritalStatusLegal.v1.0.0.json" with { type: "json" };
@@ -187,6 +189,19 @@ import radiusBucketSot from "./radiusBucket.v1.0.0.json" with { type: "json" };
187
189
  import roiMethodSot from "./roiMethod.v1.0.0.json" with { type: "json" };
188
190
  import sessionNoteVisibilitySot from "./sessionNoteVisibility.v1.0.0.json" with { type: "json" };
189
191
  import suggestionSourceSot from "./suggestionSource.v1.0.0.json" with { type: "json" };
192
+ // GDR §10.1 CAR-contract vocabularies (provisional 900-block; PAVE @pave/domain
193
+ // verbatim; bead pv-pgdr-cvc-source-gdr-10-1-bulk-publish).
194
+ import assertionStatusSot from "./assertionStatus.v1.0.0.json" with { type: "json" };
195
+ import createdBySystemSot from "./createdBySystem.v1.0.0.json" with { type: "json" };
196
+ import subjectTypeSot from "./subjectType.v1.0.0.json" with { type: "json" };
197
+ import minorAdultStatusSot from "./minorAdultStatus.v1.0.0.json" with { type: "json" };
198
+ // Trunk-only domain (CVC-67) authored on `kl-develop` and never seen by the
199
+ // canonical 0.8.13 line. It shipped as an orphan JSON — the file existed but
200
+ // was never wired into this barrel, so nothing could import it. Wired in here
201
+ // so the drift gate's "every SOT JSON is exported + validated" assertion holds
202
+ // across the merged tree. Coexists with the `CVC_67_HMIS_SEX` constants in
203
+ // `../constants/ic.ts`; the JSON is the SOT, the constants are the legacy view.
204
+ import hmisSexSot from "./hmisSex.v1.0.0.json" with { type: "json" };
190
205
 
191
206
  export {
192
207
  serviceCategoriesSot,
@@ -214,6 +229,8 @@ export {
214
229
  highestEducationLevelCompletedSot,
215
230
  preferredContactMethodSot,
216
231
  sharePurposeSot,
232
+ referralOriginSot,
233
+ caseShareStateSot,
217
234
  facilitatorEntityTypeSot,
218
235
  facilitatorSubroleSot,
219
236
  maritalStatusLegalSot,
@@ -356,4 +373,9 @@ export {
356
373
  roiMethodSot,
357
374
  sessionNoteVisibilitySot,
358
375
  suggestionSourceSot,
376
+ assertionStatusSot,
377
+ createdBySystemSot,
378
+ subjectTypeSot,
379
+ minorAdultStatusSot,
380
+ hmisSexSot,
359
381
  };
@@ -0,0 +1,80 @@
1
+ {
2
+ "domain": "minor_adult_status",
3
+ "name": "Minor / Adult Status (age band at event)",
4
+ "version": "1.0.0",
5
+ "_status": "PROVISIONAL — GDR §10.1 confirmed-CVC name is `core - minor_adult_status`, and the canonical index DOES number this concept (Final CVCs/CVC_INDEX.md @ a596eb9: CVC-61 `minor_adult_status`) — but the CVC-61 Notion codebook has 0 entries anywhere, and ADR-CVC-0.8.13-canonical-alignment §Deliberately-NOT-authored (NARRATIVE_ONLY) deliberately declined to author at 61 to avoid manufacturing canonical drift. This vocabulary therefore parks in the provisional 900-block; RENUMBER 988 → 61 when the CVC-61 Notion codebook gains substantive entries (and reconcile membership at that point). Substantive values sourced verbatim from the PAVE @pave/domain `AGE_BANDS_AT_EVENT` enum (D10 GDR §10.1 bulk publish, bead pv-pgdr-cvc-source-gdr-10-1-bulk-publish): PAVE's `minor` / `adult` / `indeterminate` stay substantive; PAVE's fourth member `unknown` maps to the canonical missingness `unknown` sentinel (same realignment shape as the ROLE_CONTEXTS 0.7.0 bind), so every PAVE member remains expressible. Distinct from the numeric IC constant MINOR_ADULT_STATUS in constants/ic.ts (IC layer, 1/2/99) — that is a different encoding layer, not a parallel CVC.",
6
+ "_source": "pave-2.0/packages/domain/src/enums.ts AGE_BANDS_AT_EVENT",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Minor / adult status at event"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "988-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
+ "988-000-000-000-000-000-001",
20
+ "988-000-000-000-000-000-002",
21
+ "988-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "988-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "988-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "The age band is unknown — not assessed or not recorded (missingness sentinel). Carries PAVE's `unknown` member of AGE_BANDS_AT_EVENT."
33
+ },
34
+ {
35
+ "code": "988-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "988-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld, declined, or redacted."
42
+ },
43
+ {
44
+ "code": "988-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "988-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "988-001-000-000-000-000-000",
54
+ "key": "minor",
55
+ "title": "Minor (under 18)",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "The subject was under 18 when the asserted event occurred."
60
+ },
61
+ {
62
+ "code": "988-002-000-000-000-000-000",
63
+ "key": "adult",
64
+ "title": "Adult (18+)",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "The subject was 18 or older when the asserted event occurred."
69
+ },
70
+ {
71
+ "code": "988-003-000-000-000-000-000",
72
+ "key": "indeterminate",
73
+ "title": "Indeterminate",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "The age band cannot be determined from the available evidence — a positive determination of indeterminacy (e.g. conflicting or insufficient evidence), distinct from the `unknown` missingness sentinel (not assessed / not recorded)."
78
+ }
79
+ ]
80
+ }