@htilabs/platform-common-models 0.13.1 → 0.15.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 (56) hide show
  1. package/dist/constants/index.cjs +33 -0
  2. package/dist/constants/index.cjs.map +1 -1
  3. package/dist/constants/index.d.cts +1 -1
  4. package/dist/constants/index.d.ts +1 -1
  5. package/dist/constants/index.js +29 -0
  6. package/dist/constants/index.js.map +1 -1
  7. package/dist/{cvcEntry-0BIB9sen.d.cts → cvcEntry-DaDrEuTa.d.cts} +44 -44
  8. package/dist/{cvcEntry-0BIB9sen.d.ts → cvcEntry-DaDrEuTa.d.ts} +44 -44
  9. package/dist/cvcs/index.cjs +212 -38
  10. package/dist/cvcs/index.cjs.map +1 -1
  11. package/dist/cvcs/index.d.cts +224 -41
  12. package/dist/cvcs/index.d.ts +224 -41
  13. package/dist/cvcs/index.js +212 -38
  14. package/dist/cvcs/index.js.map +1 -1
  15. package/dist/enums/index.cjs +8 -1
  16. package/dist/enums/index.cjs.map +1 -1
  17. package/dist/enums/index.d.cts +11 -4
  18. package/dist/enums/index.d.ts +11 -4
  19. package/dist/enums/index.js +8 -1
  20. package/dist/enums/index.js.map +1 -1
  21. package/dist/{index-CDoqrfc1.d.ts → index-C0J3f169.d.ts} +1 -1
  22. package/dist/{index-Zu_mOJRn.d.cts → index-EPjPjR0z.d.cts} +1 -1
  23. package/dist/index.cjs +253 -39
  24. package/dist/index.cjs.map +1 -1
  25. package/dist/index.d.cts +3 -3
  26. package/dist/index.d.ts +3 -3
  27. package/dist/index.js +249 -39
  28. package/dist/index.js.map +1 -1
  29. package/dist/models/index.d.cts +2 -2
  30. package/dist/models/index.d.ts +2 -2
  31. package/dist/{platform-auth-64U8jjuw.d.cts → platform-auth-CrF5U_JH.d.cts} +43 -2
  32. package/dist/{platform-auth-64U8jjuw.d.ts → platform-auth-CrF5U_JH.d.ts} +43 -2
  33. package/dist/schemas/index.cjs +234 -0
  34. package/dist/schemas/index.cjs.map +1 -1
  35. package/dist/schemas/index.d.cts +35 -35
  36. package/dist/schemas/index.d.ts +35 -35
  37. package/dist/schemas/index.js +234 -0
  38. package/dist/schemas/index.js.map +1 -1
  39. package/dist/types/index.d.cts +2 -2
  40. package/dist/types/index.d.ts +2 -2
  41. package/package.json +27 -26
  42. package/src/__sot__/coreIndicatorFields.ts +4 -4
  43. package/src/__sot__/coreIndicators.pin.json +62 -2
  44. package/src/__sot__/scoringEmits.pin.json +9 -4
  45. package/src/__tests__/__snapshots__/cvc-sot.snap +4 -4
  46. package/src/__tests__/core-information-scope-invariant.test.ts +204 -15
  47. package/src/__tests__/cvc-136-scoring-invariant.test.ts +89 -28
  48. package/src/__tests__/cvc-drift-gate.test.ts +149 -27
  49. package/src/__tests__/cvc-sot-snapshot.test.ts +14 -8
  50. package/src/__tests__/cvc-structural.test.ts +2 -2
  51. package/src/__tests__/location-type-routing-invariant.test.ts +1 -1
  52. package/src/constants/ic.ts +163 -3
  53. package/src/cvcs/{coreIndicators.v1.0.0.json → coreIndicators.v1.1.0.json} +93 -10
  54. package/src/cvcs/{coreInformationScope.v1.0.0.json → coreInformationScope.v1.1.0.json} +113 -22
  55. package/src/cvcs/index.ts +2 -2
  56. package/src/generated/cvc-enums.ts +11 -4
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "domain": "core_indicators",
3
3
  "name": "Core Indicators (CVC-136)",
4
- "version": "1.0.0",
5
- "_status": "CANONICAL — re-sourced from the live canonical catalog `data/core_indicators.yaml` @ prototype HEAD 622410b (214 codes; +1 vs the 0.8.14 pin 84a1b67, 0 withdrawn, plus the projected-field revisions on 136-007 / 136-094 the same delta carried), 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`. 216 substantive + the missingness quadruplet = 220 entries. New codes are APPENDED at 216 so every previously issued positional code stays stable.",
6
- "_source": "htilabstech/prototype@622410b data/core_indicators.yaml + htilabstech/hti-scoring@9b5d654 weights/risk.weights.json (emits_by_code)",
4
+ "version": "1.1.0",
5
+ "_status": "CANONICAL — re-sourced from the live canonical catalog `data/core_indicators.yaml` @ prototype HEAD c53378f (220 codes; +6 vs the 0.8.17 pin 622410b, 0 withdrawn upstream, plus the projected-field revision on 136-061 `exploitative_pricing_tier_low` the same delta carried), reconciled against @hti/scoring (`weights/risk.weights.json` @ 9c209cf, `emits_by_code`, 174 codes). VERSION 1.0.0 -> 1.1.0 (2026-10-06): this refresh removes `selectable` from two rows and redefines a third, so it is NOT additive and cannot reuse the published 1.0.0 content hash — the seeder's §9.1.2 ContentDriftError guard (scripts/seed-cvc.ts) would refuse to re-seed 1.0.0 with different content (the #188/#190 precedent; `incidentParticipationRoles` 1.1.0 is the shape). The 2 former scoring-ahead codes (`coercive_debt_pressure_youth` 136-033, `debt_terms_deceptive_youth` 136-050, formerly `pendingUpstreamAdoption: true`) are DEPRECATED, NOT REMOVED: `selectable: false`, `deprecated: true`, `supersededBy` their canonical rows `coercive_debt_pressure` (136-032) / `debt_terms_deceptive` (136-049), which upstream carries as `legacy_aliases`. hti-scoring 9c209cf no longer emits them, but PAVE 2.0 `develop` @ 07f3ccd still WRITES both from the IDA (`IDA-syn-missing_care-4i`/`4ii`, packages/api-core/src/rules/assessments/ida/emits.ts) and scores them from its 2026-07-17 vendored weights, so a stored assertion under either key must keep resolving in this SOT. Thread `develop` @ 28580ab has no writer. Their positional codes are HELD by the deprecated rows and are never reissued to another key. 220 selectable + 2 deprecated + the missingness quadruplet = 226 entries. New codes are APPENDED at 217–222 so every previously issued positional code stays stable.",
6
+ "_source": "htilabstech/prototype@c53378f data/core_indicators.yaml + htilabstech/hti-scoring@9c209cf weights/risk.weights.json (emits_by_code)",
7
7
  "levels": {
8
8
  "0": "Unknown or Missing",
9
9
  "1": "Indicator"
@@ -480,11 +480,12 @@
480
480
  "code": "136-033-000-000-000-000-000",
481
481
  "key": "coercive_debt_pressure_youth",
482
482
  "title": "Pressured to do things to pay off debt (youth missing-from-care)",
483
- "selectable": true,
483
+ "selectable": false,
484
484
  "parentCode": null,
485
485
  "childCodes": [],
486
- "definition": "Indication that a youth who is missing from care was pressured or coerced into doing things in order to pay off a debt. Youth-specific sibling of `coercive_debt_pressure`. PENDING UPSTREAM ADOPTION: this code is NOT yet present in the canonical `data/core_indicators.yaml` at prototype HEAD a596eb9. It is retained because @hti/scoring (the declared scoring SOT, weights/risk.weights.json @ 9b5d654) EMITS it via `emits_by_code` — scoring is ahead of the codebook here. Withdrawing it would break the scoring contract. File upstream for adoption into core_indicators.yaml.",
487
- "pendingUpstreamAdoption": true
486
+ "definition": "DEPRECATED 2026-10-06 — superseded by `coercive_debt_pressure` (136-032); the canonical catalog carries this key as a `legacy_alias` of that row and @hti/scoring 9c209cf no longer emits it. Retained read-only because PAVE 2.0 `develop` (IDA `IDA-syn-missing_care-4i`, emits.ts) still writes it and assertions stored under this key must keep resolving. Original meaning: indication that a youth who is missing from care was pressured or coerced into doing things in order to pay off a debt. Youth-specific sibling of `coercive_debt_pressure`. Do not offer for new writes; bind the canonical key.",
487
+ "deprecated": true,
488
+ "supersededBy": "coercive_debt_pressure"
488
489
  },
489
490
  {
490
491
  "code": "136-034-000-000-000-000-000",
@@ -702,11 +703,12 @@
702
703
  "code": "136-050-000-000-000-000-000",
703
704
  "key": "debt_terms_deceptive_youth",
704
705
  "title": "Debt repayment terms differed from what was expected (youth missing-from-care)",
705
- "selectable": true,
706
+ "selectable": false,
706
707
  "parentCode": null,
707
708
  "childCodes": [],
708
- "definition": "Indication that, for a youth missing from care, the terms of a debt or its repayment differed from what was represented or expected. Youth-specific sibling of `debt_terms_deceptive`. PENDING UPSTREAM ADOPTION: this code is NOT yet present in the canonical `data/core_indicators.yaml` at prototype HEAD a596eb9. It is retained because @hti/scoring (the declared scoring SOT, weights/risk.weights.json @ 9b5d654) EMITS it via `emits_by_code` — scoring is ahead of the codebook here. Withdrawing it would break the scoring contract. File upstream for adoption into core_indicators.yaml.",
709
- "pendingUpstreamAdoption": true
709
+ "definition": "DEPRECATED 2026-10-06 — superseded by `debt_terms_deceptive` (136-049); the canonical catalog carries this key as a `legacy_alias` of that row and @hti/scoring 9c209cf no longer emits it. Retained read-only because PAVE 2.0 `develop` (IDA `IDA-syn-missing_care-4ii`, emits.ts) still writes it and assertions stored under this key must keep resolving. Original meaning: indication that, for a youth missing from care, the terms of a debt or its repayment differed from what was represented or expected. Youth-specific sibling of `debt_terms_deceptive`. Do not offer for new writes; bind the canonical key.",
710
+ "deprecated": true,
711
+ "supersededBy": "debt_terms_deceptive"
710
712
  },
711
713
  {
712
714
  "code": "136-051-000-000-000-000-000",
@@ -849,7 +851,7 @@
849
851
  "selectable": true,
850
852
  "parentCode": null,
851
853
  "childCodes": [],
852
- "definition": "Ad-derived pricing tier indicates unusually low hourly price relative to local median, potentially signaling economic duress and vulnerability.",
854
+ "definition": "Ad-derived pricing tier is LOW-dominant — the person's parsed hourly rates fall under $50/hr against the pooled ad population (CVC-277 core-CS_price_tier_band; Sarah 2026-07-22 pooled baseline, about the bottom quartile) — potentially signaling economic duress and vulnerability. The SRS design framed this as \"relative to the local median\"; a per-market baseline is the refinement on record, not built.",
853
855
  "family": "unfamilied",
854
856
  "polarity": "depends",
855
857
  "severity": "informational",
@@ -2913,6 +2915,87 @@
2913
2915
  "polarity": "depends",
2914
2916
  "severity": "caution",
2915
2917
  "isAlert": "none"
2918
+ },
2919
+ {
2920
+ "code": "136-217-000-000-000-000-000",
2921
+ "key": "disclosed_fear_at_intake",
2922
+ "title": "Disclosed fear of a specific person",
2923
+ "selectable": true,
2924
+ "parentCode": null,
2925
+ "childCodes": [],
2926
+ "definition": "The person has told a worker they are afraid of a named or identifiable individual — commonly a former or current partner. Distinct from concerning_mannerisms_anxious_fearful_depressed, which is affect a worker observes rather than something the person said, and from threats_of_harm, which requires a threat to have been made; fear can be current and well-founded with no fresh threat.",
2927
+ "family": "lethality_dv",
2928
+ "polarity": "increases_risk",
2929
+ "severity": "elevated",
2930
+ "isAlert": "thread_pave",
2931
+ "alertWhen": "current_only"
2932
+ },
2933
+ {
2934
+ "code": "136-218-000-000-000-000-000",
2935
+ "key": "does_not_control_housing",
2936
+ "title": "Limited independence: does not control where they live",
2937
+ "selectable": true,
2938
+ "parentCode": null,
2939
+ "childCodes": [],
2940
+ "definition": "Indication that an employer, partner, or other person decides where the person lives — housing is assigned or controlled by someone else, rather than chosen by the person.",
2941
+ "family": "mechanism_control",
2942
+ "polarity": "increases_risk",
2943
+ "severity": "elevated",
2944
+ "isAlert": "none"
2945
+ },
2946
+ {
2947
+ "code": "136-219-000-000-000-000-000",
2948
+ "key": "oppressive_home_life",
2949
+ "title": "Oppressive, unsafe, or unstable home life",
2950
+ "selectable": true,
2951
+ "parentCode": null,
2952
+ "childCodes": [],
2953
+ "definition": "Indication that the person's current home life is oppressive, unsafe, or unstable — a present-condition vulnerability, distinct from the childhood household challenges history (VIII-B).",
2954
+ "family": "vulnerability_context",
2955
+ "polarity": "increases_risk",
2956
+ "severity": "elevated",
2957
+ "isAlert": "none"
2958
+ },
2959
+ {
2960
+ "code": "136-220-000-000-000-000-000",
2961
+ "key": "recent_separation",
2962
+ "title": "Recent separation from abusive partner",
2963
+ "selectable": true,
2964
+ "parentCode": null,
2965
+ "childCodes": [],
2966
+ "definition": "Indication that the person has recently left or separated from an abusive partner. Campbell's Danger Assessment treats the period following separation as the highest-risk window for intimate-partner homicide — the signal is about having got out, not about current cohabitation.",
2967
+ "family": "lethality_dv",
2968
+ "polarity": "depends",
2969
+ "severity": "elevated",
2970
+ "isAlert": "thread_pave",
2971
+ "alertWhen": "recency_under_year"
2972
+ },
2973
+ {
2974
+ "code": "136-221-000-000-000-000-000",
2975
+ "key": "survival_sex",
2976
+ "title": "Survival sex (sex exchanged to meet basic needs)",
2977
+ "selectable": true,
2978
+ "parentCode": null,
2979
+ "childCodes": [],
2980
+ "definition": "Indication that the person exchanges sex acts to meet basic survival needs — housing, food, drugs, protection, or money for essentials — rather than as an income choice. A standalone activity signal that can coexist with, or exist entirely without, a trafficking determination; it asserts the circumstance of the exchange, never the determination.",
2981
+ "family": "cs_industry_context",
2982
+ "polarity": "depends",
2983
+ "severity": "elevated",
2984
+ "isAlert": "none"
2985
+ },
2986
+ {
2987
+ "code": "136-222-000-000-000-000-000",
2988
+ "key": "unable_to_speak_freely",
2989
+ "title": "Unable to speak freely",
2990
+ "selectable": true,
2991
+ "parentCode": null,
2992
+ "childCodes": [],
2993
+ "definition": "Indication that the person is not able to speak for themselves — a third party insists on being present, answers on their behalf, or interprets for them, or the person is never encountered alone. Distinct from inability_to_account_for_self, which is about the person's own account being scripted or confused; this is about another party controlling the conversation.",
2994
+ "family": "mechanism_control",
2995
+ "polarity": "depends",
2996
+ "severity": "elevated",
2997
+ "isAlert": "thread_pave",
2998
+ "alertWhen": "current_only"
2916
2999
  }
2917
3000
  ]
2918
3001
  }
@@ -1,13 +1,97 @@
1
1
  {
2
2
  "domain": "core_information_scope",
3
3
  "name": "Core Information Scope",
4
- "version": "1.0.0",
5
- "_status": "DRAFT: canonical number 236, self-declared by the source YAML (`cvc_id: CVC-236`); CVC_INDEX.md carries no row for it yet, so the drift gate classifies it INDEX_ABSENT. Sourced from canonical CVC-236 `core_information_scope` v2 (authored 2026-08-13, restructured 2026-08-14): 12 categories / 56 units. TWO GRAINS, deliberately modelled as hierarchy: L1 categories are the POLICY grain and are NOT selectable; L2 units are the AUTHORIZATION grain and are what an ROI or a share actually authorizes. This is the axis the sibling `roi_scope` domain deliberately omits — `roi_scope` is the flat item vocabulary, and its 27 substantive keys are a strict SUBSET of the 56 units here, with no renames and no collisions. That subset relationship is what makes adopting this domain additive: every stored ROI keeps its exact recorded meaning. `safe_locations` is CANON since CVC236-AUDIT R1 (Crysta, 2026-09-08): id and label ratified and minted in the Notion codebook; the former PROVISIONAL marker is retired. PENDING canonical Notion authoring + steward ratification.",
6
- "_source": "htilabstech/prototype/data/cvcs/core_information_scope.yaml @ 55088d44 (CVC-236 v2, restructured 2026-08-14, amended 2026-10-01; read from 46a60114; structural columns cross-checked against htilabstech/prototype/Final CVCs/System Roles, Permissions, & Account Management (IC-66)/core-information_scope — codebook.csv @ 55088d44)",
4
+ "version": "1.1.0",
5
+ "_status": "DRAFT: canonical number 236, self-declared by the source YAML (`cvc_id: CVC-236`); CVC_INDEX.md carries no row for it yet, so the drift gate classifies it INDEX_ABSENT. Sourced from canonical CVC-236 `core_information_scope` v2 (authored 2026-08-13, restructured 2026-08-14): 12 categories / 55 live units + 2 retired tombstones. TWO GRAINS, deliberately modelled as hierarchy: L1 categories are the POLICY grain and are NOT selectable; L2 units are the AUTHORIZATION grain and are what an ROI or a share actually authorizes. This is the axis the sibling `roi_scope` domain deliberately omits — `roi_scope` is the flat item vocabulary, and every one of its 27 substantive keys resolves here, spelled identically, with no renames and no collisions. That is what makes adopting this domain a migration rather than a re-consent: a stored ROI never WIDENS. RETIRED TOMBSTONES: `screen_notes` (236-005-001, retired 2026-10-05, Narrative notes, signed Spec v2 rule 5); `background` (236-005-003, retired 2026-10-05, Narrative notes, signed Spec v2 rule 5). Each keeps its published code (never reused), is `selectable: false` + `retired: true`, and includes nothing: a stored ROI or share that names one resolves to \"retired\", not \"unknown\". Unit codes follow the generator's frozen ledger, not canon's display order: a new unit APPENDS inside its category. VERSION 1.1.0 supersedes 1.0.0 because the change is not additive (see `_supersedes`); neither version was seeded in platform-prod or platform-dev when it was minted (checked 2026-10-06), so the bump is the convention (ADR-CVC-0.8.13 Addendum 2026-10-05), not a guard-driven fix. `safe_locations` is CANON since CVC236-AUDIT R1 (Crysta, 2026-09-08): id and label ratified and minted in the Notion codebook; the former PROVISIONAL marker is retired. The Notion codebook is AHEAD of the yaml mirror on `instruments` (31 rows, acknowledged via --allow-codebook-ahead and not exported here), pending its own absorb lane. PENDING canonical Notion authoring + steward ratification.",
6
+ "_source": "htilabstech/prototype/data/cvcs/core_information_scope.yaml @ 9ef79748 (CVC-236 v2, restructured 2026-08-14, amended 2026-10-01; read from origin/main; structural columns cross-checked against htilabstech/prototype/Final CVCs/System Roles, Permissions, & Account Management (IC-66)/core-information_scope — codebook.csv @ 9ef79748; 2 retired codebook rows matched to the yaml's retired_units; 31 codebook-ahead rows under instruments acknowledged, not exported)",
7
+ "_supersedes": {
8
+ "version": "1.0.0",
9
+ "keyMap": {
10
+ "missingness_root": "missingness_root",
11
+ "unknown": "unknown",
12
+ "anonymous": "anonymous",
13
+ "data_not_collected": "data_not_collected",
14
+ "identifying": "identifying",
15
+ "names": "names",
16
+ "dob": "dob",
17
+ "addresses": "addresses",
18
+ "additional_ids": "additional_ids",
19
+ "demographics": "demographics",
20
+ "risk": "risk",
21
+ "screen_indicators": "screen_indicators",
22
+ "victimization": "victimization",
23
+ "ida_full": "ida_full",
24
+ "ida_consid": "ida_consid",
25
+ "initial_screen": "initial_screen",
26
+ "tra": "tra",
27
+ "lap": "lap",
28
+ "danger_assessment": "danger_assessment",
29
+ "injury_and_strangulation": "injury_and_strangulation",
30
+ "stalking_assessment": "stalking_assessment",
31
+ "ae_intake": "ae_intake",
32
+ "hope_scale": "hope_scale",
33
+ "assessment_records": "assessment_records",
34
+ "determinations": "determinations",
35
+ "offender_facilitator": "offender_facilitator",
36
+ "system_involvement": "system_involvement",
37
+ "derived_risk_signals": "derived_risk_signals",
38
+ "contact": "contact",
39
+ "contact_info": "contact_info",
40
+ "safe_locations": "safe_locations",
41
+ "priorities_safety": "priorities_safety",
42
+ "encounter_location": "encounter_location",
43
+ "services": "services",
44
+ "contact_history": "contact_history",
45
+ "service_history": "service_history",
46
+ "plans_goals": "plans_goals",
47
+ "notes": "notes",
48
+ "screen_notes": "screen_notes",
49
+ "case_notes": "case_notes",
50
+ "background": "background",
51
+ "health_accommodation": "health_accommodation",
52
+ "accommodation_needs": "accommodation_needs",
53
+ "disability_subtypes": "disability_subtypes",
54
+ "mental_health_status": "mental_health_status",
55
+ "substance_use_status": "substance_use_status",
56
+ "chronic_health_status": "chronic_health_status",
57
+ "hiv_status": "hiv_status",
58
+ "mental_health_screen": "mental_health_screen",
59
+ "trauma_and_coping_screen": "trauma_and_coping_screen",
60
+ "behavioral_health_intake": "behavioral_health_intake",
61
+ "immigration_legal_status": "immigration_legal_status",
62
+ "immigration_status": "immigration_status",
63
+ "uscis_alien_number": "uscis_alien_number",
64
+ "federal_protection_applications": "federal_protection_applications",
65
+ "tvap_enrollment": "tvap_enrollment",
66
+ "le_report_status": "le_report_status",
67
+ "system": "system",
68
+ "system_info": "system_info",
69
+ "network_associations": "network_associations",
70
+ "network_membership": "network_membership",
71
+ "persona_links": "persona_links",
72
+ "commercial_activity": "commercial_activity",
73
+ "ad_content": "ad_content",
74
+ "commercial_patterns": "commercial_patterns",
75
+ "investigative_work_product": "investigative_work_product",
76
+ "case_determinations": "case_determinations",
77
+ "case_lifecycle": "case_lifecycle",
78
+ "case_attachments": "case_attachments",
79
+ "object_identifiers": "object_identifiers",
80
+ "phone_identifiers": "phone_identifiers",
81
+ "object_identity_attributes": "object_identity_attributes"
82
+ },
83
+ "retiredCodes": [],
84
+ "notes": {
85
+ "summary": "Every v1.0.0 key is still an entry in v1.1.0, at its v1.0.0 code, so `keyMap` is the identity and `retiredCodes` is empty: no code was withdrawn. Non-additive because 2 published unit(s) are now RETIRED tombstones and 1 unit(s) read narrower (notes below). Added: `session_summary` (236-005-004).",
86
+ "screen_notes": "v1.0.0 `screen_notes` was a selectable unit. Retired 2026-10-05 (Narrative notes, signed Spec v2 rule 5): The Initial Screen's notes box is an instrument note and belongs to the Initial Screen. It stays at 236-005-001 as a tombstone (`selectable: false`, `retired: true`) with NO successor key, and includes nothing — a stored ROI or share that names it narrows, never widens. Canon records that only demo data named it (Crysta 2026-10-04); the demo presets were rewritten by hand.",
87
+ "background": "v1.0.0 `background` was a selectable unit. Retired 2026-10-05 (Narrative notes, signed Spec v2 rule 5): Nothing ever captured it. It stays at 236-005-003 as a tombstone (`selectable: false`, `retired: true`) with NO successor key, and includes nothing — a stored ROI or share that names it narrows, never widens. Canon records that only demo data named it (Crysta 2026-10-04); the demo presets were rewritten by hand.",
88
+ "case_notes": "v1.0.0 `case_notes` ('Detailed case notes') keeps 236-005-002 but reads NARROWER under its new label 'Session & case notes' (renamed + narrowed 2026-10-02, Crysta; signed 2026-10-05, Narrative notes Spec v2 rule 5): every note whose home is a session of the case or the case itself, OTHER THAN the session summary, with its files. The session summary (the typed summary and each note marked 'Include in session summary') now rides the new `session_summary` unit (236-005-004), and a note written inside an instrument, in the Determination notes box, or in a notes box on another record belongs to that record. A stored ROI or share that authorized `case_notes` therefore no longer includes the session summary; whether it should also gain `session_summary` is a consent question for the consumer, not a mapping."
89
+ }
90
+ },
7
91
  "levels": {
8
92
  "0": "Unknown or Missing",
9
93
  "1": "Category (policy grain, not selectable)",
10
- "2": "Information unit (authorization grain, selectable)"
94
+ "2": "Information unit (authorization grain; selectable unless retired)"
11
95
  },
12
96
  "entries": [
13
97
  {
@@ -423,10 +507,11 @@
423
507
  "selectable": true,
424
508
  "parentCode": "236-002-000-000-000-000-000",
425
509
  "childCodes": [],
426
- "definition": "Offender + facilitator records. Category `risk`. Carries TRA perpetrator records (ruled 2026-08-14): content wins — third-party identity never rides a subject-instrument disclosure silently.",
510
+ "definition": "Offender + facilitator records. Category `risk`. Carries TRA perpetrator records (ruled 2026-08-14): content wins — third-party identity never rides a subject-instrument disclosure silently. | THREAD ADDED 2026-10-01 (OFFENDER-SYSTEM-UNITS-THREAD, Crysta R1 — Nate Luginbill's Question set 2 item 4): app_relevance follows where the unit's content is captured, and Thread captures perpetrator records (identity · description · vehicle · violence history in PAVE 2.0's Thread; in the prototype a relevant person with the offender role-in-case + the Priorities Q1 source of the danger). The 2026-08-14 rule was never Thread-exempt — Thread had no box, so perpetrator identity rode under the victim's `names`; with the box it rides HERE and comes out of names (R2). The offender PROFILE never rides under system_involvement because a protection order names them (R3).",
427
511
  "levelFloor": 3,
428
512
  "appRelevance": [
429
513
  "PAVE",
514
+ "Thread",
430
515
  "LEADS"
431
516
  ],
432
517
  "shareableDefault": true,
@@ -439,10 +524,11 @@
439
524
  "selectable": true,
440
525
  "parentCode": "236-002-000-000-000-000-000",
441
526
  "childCodes": [],
442
- "definition": "System involvement. Category `risk`.",
527
+ "definition": "System involvement. Category `risk`. THREAD ADDED 2026-10-01 (OFFENDER-SYSTEM-UNITS-THREAD, Crysta R1): Thread captures protection orders and system-involvement answers in PAVE 2.0; the [PAVE] flag was the record as of 2026-08-14. R3 (protection orders — canon holds, no split): a protection order is ONE record under this unit, whole — the survivor's legal protection (petitioner · court · status · expiry · violations) with the respondent's name as it appears on the order, a court document; an offender profile may REFERENCE the order (the ADR's 'offender-bundle extension' is a presentation), but the order is delivered only when this unit is granted — a reference carries no content, the referenced record rides its own unit (the 2026-10-01 safety-plan reference rule).",
443
528
  "levelFloor": 3,
444
529
  "appRelevance": [
445
- "PAVE"
530
+ "PAVE",
531
+ "Thread"
446
532
  ],
447
533
  "shareableDefault": true,
448
534
  "specialDataType": "survivor_confidential"
@@ -575,7 +661,7 @@
575
661
  "selectable": true,
576
662
  "parentCode": "236-004-000-000-000-000-000",
577
663
  "childCodes": [],
578
- "definition": "Contact history with this agency. Category `services`. Honest-empty (§ 5.4): no canonical UDD field carries the interaction register yet.",
664
+ "definition": "Contact history with this agency. Category `services`. DELIVERS since 2026-10-01 (CONTACT-HISTORY-REGISTER, Crysta R1–R3 — Nate Luginbill's Question set 2 item 3; honest-empty from 2026-08-14 to that date): the register of this agency's own contacts with the person — one row per session, date · channel (CVC-47) · kind of sitting (CVC-217) · the agency/program as recorded, plus a count line — computed from the SENDING agency's session records at send time by the one as-delivered builder, never stored (UDD person.contact_history, derived · accumulating_log · IC-76; source fields capture.session_started_at · capture.service_delivery_channel [its session-record store `contact_method`] · capture.session_template). The fact of contact, not content: no notes, answers, outcomes or services — service_history carries the service instances (the Thread session-as-service row is the same session's other view). Which sessions: closed plus the sending one; drafts from other days, discarded sessions, inbound-share reviews (origin claimed_share), other agencies' sessions (knowing is not telling) and LEADS sessions never ride. No domain_map row — sessions are no-CAR facts; the coverage gate reads the crosswalk derived_units entry (field + store + builder marker). Presets: Thread risk_only_handoff (carried it throughout) · ROI full_collab gains it 2026-10-01 (derivation for veto). Smoke FLOW-381.",
579
665
  "levelFloor": 3,
580
666
  "appRelevance": [
581
667
  "PAVE",
@@ -625,9 +711,10 @@
625
711
  "childCodes": [
626
712
  "236-005-001-000-000-000-000",
627
713
  "236-005-002-000-000-000-000",
628
- "236-005-003-000-000-000-000"
714
+ "236-005-003-000-000-000-000",
715
+ "236-005-004-000-000-000-000"
629
716
  ],
630
- "definition": "Narrative notes — policy-grain category. Units under it are the authorization grain. LEADS flag dropped 2026-08-14 (all units PAVE/Thread — was an empty shell for LEADS-only agencies).",
717
+ "definition": "Narrative notes — policy-grain category. Units under it are the authorization grain. LEADS flag dropped 2026-08-14 (all units PAVE/Thread — was an empty shell for LEADS-only agencies). | NARRATIVE-NOTES 2026-10-05 (signed Spec v2, rule 5 — Crysta: 'Narrative notes - I've signed off on this spec.'): two sub-categories, Session summary and Session & case notes. It holds only the notes whose home is a session of the case or the case itself; a note written inside an instrument, in the Determination notes box, or in a notes box on another record belongs to that record.",
631
718
  "levelFloor": 3,
632
719
  "appRelevance": [
633
720
  "PAVE",
@@ -640,26 +727,20 @@
640
727
  "code": "236-005-001-000-000-000-000",
641
728
  "key": "screen_notes",
642
729
  "title": "Screen notes",
643
- "selectable": true,
730
+ "selectable": false,
644
731
  "parentCode": "236-005-000-000-000-000-000",
645
732
  "childCodes": [],
646
- "definition": "Screen notes. Category `notes`.",
647
- "levelFloor": 3,
648
- "appRelevance": [
649
- "PAVE",
650
- "Thread"
651
- ],
652
- "shareableDefault": true,
653
- "specialDataType": "survivor_confidential"
733
+ "definition": "RETIRED 2026-10-05 (Narrative notes, signed Spec v2 rule 5). The Initial Screen's notes box is an instrument note and belongs to the Initial Screen. No longer offered in share policy, internal viewing settings or a release; a stored code resolves here so a reader can tell retired from unknown, and includes nothing.",
734
+ "retired": true
654
735
  },
655
736
  {
656
737
  "code": "236-005-002-000-000-000-000",
657
738
  "key": "case_notes",
658
- "title": "Detailed case notes",
739
+ "title": "Session & case notes",
659
740
  "selectable": true,
660
741
  "parentCode": "236-005-000-000-000-000-000",
661
742
  "childCodes": [],
662
- "definition": "Detailed case notes. Category `notes`.",
743
+ "definition": "Session & case notes. Category `notes`. RENAMED + NARROWED 2026-10-02 (Crysta; was 'Detailed case notes'; the code is unchanged). Every note whose home is a session of the case or the case itself, other than the session summary, with its files. Read from the notes store, one row per note, through the note's own visibility; the session_note / log_entry claims keep their viewing rows in domain_map and are never share content.",
663
744
  "levelFloor": 3,
664
745
  "appRelevance": [
665
746
  "PAVE",
@@ -672,10 +753,20 @@
672
753
  "code": "236-005-003-000-000-000-000",
673
754
  "key": "background",
674
755
  "title": "Background information",
756
+ "selectable": false,
757
+ "parentCode": "236-005-000-000-000-000-000",
758
+ "childCodes": [],
759
+ "definition": "RETIRED 2026-10-05 (Narrative notes, signed Spec v2 rule 5). Nothing ever captured it. No longer offered in share policy, internal viewing settings or a release; a stored code resolves here so a reader can tell retired from unknown, and includes nothing.",
760
+ "retired": true
761
+ },
762
+ {
763
+ "code": "236-005-004-000-000-000-000",
764
+ "key": "session_summary",
765
+ "title": "Session summary",
675
766
  "selectable": true,
676
767
  "parentCode": "236-005-000-000-000-000-000",
677
768
  "childCodes": [],
678
- "definition": "Background information. Category `notes`.",
769
+ "definition": "Session summary. Category `notes`. MINTED 2026-10-02 (Crysta: two sub-categories — 'Agree'); in the apps since 2026-10-05 (NARRATIVE-NOTES). Includes the typed session summary (one note marked as the summary — it has no visibility of its own and freezes when the session is submitted) and each note whose home is that session and that the advocate marked 'Include in session summary'. A marked note from another home shows in the on-screen summary and is included in a share only with its own home, never here.",
679
770
  "levelFloor": 3,
680
771
  "appRelevance": [
681
772
  "PAVE",
package/src/cvcs/index.ts CHANGED
@@ -164,11 +164,11 @@ import romanticRelationshipChangeTypeSot from "./romanticRelationshipChangeType.
164
164
  import riskCategorySot from "./riskCategory.v1.0.0.json" with { type: "json" };
165
165
  import coreFunctionsSot from "./coreFunctions.v1.0.0.json" with { type: "json" };
166
166
  import needsAssessmentChangeTypeSot from "./needsAssessmentChangeType.v1.0.0.json" with { type: "json" };
167
- import coreInformationScopeSot from "./coreInformationScope.v1.0.0.json" with { type: "json" };
167
+ import coreInformationScopeSot from "./coreInformationScope.v1.1.0.json" with { type: "json" };
168
168
  import roiScopeSot from "./roiScope.v1.0.0.json" with { type: "json" };
169
169
  import roiStatusSot from "./roiStatus.v1.0.0.json" with { type: "json" };
170
170
  import coreReferralOutcomeSot from "./coreReferralOutcome.v1.0.0.json" with { type: "json" };
171
- import coreIndicatorsSot from "./coreIndicators.v1.0.0.json" with { type: "json" };
171
+ import coreIndicatorsSot from "./coreIndicators.v1.1.0.json" with { type: "json" };
172
172
  import coreDhStateSot from "./coreDhState.v1.0.0.json" with { type: "json" };
173
173
  import riskSeverityBandSot from "./riskSeverityBand.v1.0.0.json" with { type: "json" };
174
174
  import riskIdentificationMilestoneSot from "./riskIdentificationMilestone.v1.0.0.json" with { type: "json" };
@@ -4100,9 +4100,9 @@ export const NeedsAssessmentChangeTypeKeys = {
4100
4100
  export type NeedsAssessmentChangeTypeKey = keyof typeof NeedsAssessmentChangeTypeKeys;
4101
4101
 
4102
4102
  /**
4103
- * Key → positional code map for the `core_information_scope` CVC domain (DRAFT-TEMPORARY; canonical CVC-236, 12 policy-grain CATEGORIES + 56 authorization-grain UNITS. Categories are level 1 and NOT selectable; units are level 2 and are what an ROI or a share authorizes. Distinct from the sibling `roi_scope` domain, which is the FLAT item vocabulary and deliberately omits the category axis — roi_scope's 27 substantive keys are a strict SUBSET of these 56 units, with no renames, so adoption is additive and no stored ROI changes meaning).
4103
+ * Key → positional code map for the `core_information_scope` CVC domain (DRAFT-TEMPORARY; canonical CVC-236, 12 policy-grain CATEGORIES + 55 authorization-grain UNITS + 2 RETIRED tombstones. Categories are level 1 and NOT selectable; units are level 2 and are what an ROI or a share authorizes. Tombstones (`screen_notes`, `background`; retired 2026-10-05) keep their codes so a stored value resolves, but are `selectable: false` + `retired: true` and include nothing — offer only selectable children. Distinct from the sibling `roi_scope` domain, which is the FLAT item vocabulary and deliberately omits the category axis — every one of roi_scope's 27 substantive keys resolves here with no renames (25 live units, 2 tombstones), so a stored ROI never widens).
4104
4104
  *
4105
- * Domain: `core_information_scope` · Version: 1.0.0 · Entries: 72
4105
+ * Domain: `core_information_scope` · Version: 1.1.0 · Entries: 73
4106
4106
  */
4107
4107
  export const CoreInformationScopeKeys = {
4108
4108
  missingness_root: "236-000-000-000-000-000-000",
@@ -4146,6 +4146,7 @@ export const CoreInformationScopeKeys = {
4146
4146
  screen_notes: "236-005-001-000-000-000-000",
4147
4147
  case_notes: "236-005-002-000-000-000-000",
4148
4148
  background: "236-005-003-000-000-000-000",
4149
+ session_summary: "236-005-004-000-000-000-000",
4149
4150
  health_accommodation: "236-006-000-000-000-000-000",
4150
4151
  accommodation_needs: "236-006-001-000-000-000-000",
4151
4152
  disability_subtypes: "236-006-002-000-000-000-000",
@@ -4277,9 +4278,9 @@ export const DhStateKeys = {
4277
4278
  export type DhStateKey = keyof typeof DhStateKeys;
4278
4279
 
4279
4280
  /**
4280
- * Key → positional code map for the `core_indicators` CVC domain (CVC-136; 214 canonical indicator codes re-sourced from prototype `data/core_indicators.yaml` @ 622410b + 2 scoring-ahead codes @hti/scoring emits before the codebook adopted them = 216 substantive). Entries carry `family` / `polarity` / `severity` / `isAlert` / `alertWhen`; the alert list is a DERIVED VIEW over `isAlert`, not a rival taxonomy.
4281
+ * Key → positional code map for the `core_indicators` CVC domain (CVC-136; 220 canonical indicator codes re-sourced from prototype `data/core_indicators.yaml` @ c53378f, reconciled against @hti/scoring `emits_by_code` @ 9c209cf; the 2 former scoring-ahead `_youth` codes are DEPRECATED read-only rows — `selectable: false`, `supersededBy` their canonical siblings — kept because PAVE 2.0 still writes them = 222 substantive; SOT v1.1.0). Entries carry `family` / `polarity` / `severity` / `isAlert` / `alertWhen`; the alert list is a DERIVED VIEW over `isAlert`, not a rival taxonomy.
4281
4282
  *
4282
- * Domain: `core_indicators` · Version: 1.0.0 · Entries: 220
4283
+ * Domain: `core_indicators` · Version: 1.1.0 · Entries: 226
4283
4284
  */
4284
4285
  export const CoreIndicatorKeys = {
4285
4286
  missingness_root: "136-000-000-000-000-000-000",
@@ -4502,6 +4503,12 @@ export const CoreIndicatorKeys = {
4502
4503
  sexualized_content_online_performance_activity: "136-214-000-000-000-000-000",
4503
4504
  trauma_perpetrator_is_current_manager: "136-215-000-000-000-000-000",
4504
4505
  active_protective_order: "136-216-000-000-000-000-000",
4506
+ disclosed_fear_at_intake: "136-217-000-000-000-000-000",
4507
+ does_not_control_housing: "136-218-000-000-000-000-000",
4508
+ oppressive_home_life: "136-219-000-000-000-000-000",
4509
+ recent_separation: "136-220-000-000-000-000-000",
4510
+ survival_sex: "136-221-000-000-000-000-000",
4511
+ unable_to_speak_freely: "136-222-000-000-000-000-000",
4505
4512
  } as const;
4506
4513
 
4507
4514
  export type CoreIndicatorKey = keyof typeof CoreIndicatorKeys;