@htilabs/platform-common-models 0.14.0 → 0.17.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 (39) hide show
  1. package/dist/{cvcEntry-0BIB9sen.d.cts → cvcEntry-ctHTp2df.d.cts} +36 -36
  2. package/dist/{cvcEntry-0BIB9sen.d.ts → cvcEntry-ctHTp2df.d.ts} +36 -36
  3. package/dist/cvcs/index.cjs +184 -40
  4. package/dist/cvcs/index.cjs.map +1 -1
  5. package/dist/cvcs/index.d.cts +191 -41
  6. package/dist/cvcs/index.d.ts +191 -41
  7. package/dist/cvcs/index.js +184 -40
  8. package/dist/cvcs/index.js.map +1 -1
  9. package/dist/enums/index.cjs +3 -1
  10. package/dist/enums/index.cjs.map +1 -1
  11. package/dist/enums/index.d.cts +8 -6
  12. package/dist/enums/index.d.ts +8 -6
  13. package/dist/enums/index.js +3 -1
  14. package/dist/enums/index.js.map +1 -1
  15. package/dist/{index-CDoqrfc1.d.ts → index-4DiJrn7y.d.ts} +1 -1
  16. package/dist/{index-Zu_mOJRn.d.cts → index-qreOzXYS.d.cts} +1 -1
  17. package/dist/index.cjs +187 -41
  18. package/dist/index.cjs.map +1 -1
  19. package/dist/index.d.cts +2 -2
  20. package/dist/index.d.ts +2 -2
  21. package/dist/index.js +187 -41
  22. package/dist/index.js.map +1 -1
  23. package/dist/models/index.d.cts +2 -2
  24. package/dist/models/index.d.ts +2 -2
  25. package/dist/schemas/index.d.cts +11 -11
  26. package/dist/schemas/index.d.ts +11 -11
  27. package/package.json +27 -26
  28. package/src/__tests__/__snapshots__/cvc-sot.snap +5 -5
  29. package/src/__tests__/core-functions-canon.test.ts +53 -0
  30. package/src/__tests__/core-information-scope-invariant.test.ts +298 -19
  31. package/src/__tests__/cvc-sot-snapshot.test.ts +19 -12
  32. package/src/__tests__/cvc-status-parser.test.ts +1 -1
  33. package/src/__tests__/cvc-structural.test.ts +3 -3
  34. package/src/__tests__/location-type-routing-invariant.test.ts +1 -1
  35. package/src/cvcs/{coreFunctions.v1.0.0.json → coreFunctions.v1.1.0.json} +11 -2
  36. package/src/cvcs/{coreInformationScope.v1.0.0.json → coreInformationScope.v1.1.0.json} +113 -22
  37. package/src/cvcs/index.ts +3 -3
  38. package/src/cvcs/{roiScope.v1.0.0.json → roiScope.v1.2.0.json} +51 -7
  39. package/src/generated/cvc-enums.ts +8 -6
@@ -1,4 +1,4 @@
1
- import { F as Form, l as buildFormSchema, h as Section, q as buildSectionSchema, Q as Question, o as buildQuestionSchema, f as ScoringRule, p as buildScoringRuleSchema, P as PlatformFunction, m as buildPlatformFunctionSchema, d as PlatformRole, n as buildPlatformRoleSchema, b as CvcRegistry, k as buildCvcRegistrySchema, a as CvcEntry, j as buildCvcEntrySchema } from './cvcEntry-0BIB9sen.js';
1
+ import { F as Form, l as buildFormSchema, h as Section, q as buildSectionSchema, Q as Question, o as buildQuestionSchema, f as ScoringRule, p as buildScoringRuleSchema, P as PlatformFunction, m as buildPlatformFunctionSchema, d as PlatformRole, n as buildPlatformRoleSchema, b as CvcRegistry, k as buildCvcRegistrySchema, a as CvcEntry, j as buildCvcEntrySchema } from './cvcEntry-ctHTp2df.js';
2
2
  import * as mongoose from 'mongoose';
3
3
  import { HydratedDocument, Connection, Model } from 'mongoose';
4
4
 
@@ -1,4 +1,4 @@
1
- import { F as Form, l as buildFormSchema, h as Section, q as buildSectionSchema, Q as Question, o as buildQuestionSchema, f as ScoringRule, p as buildScoringRuleSchema, P as PlatformFunction, m as buildPlatformFunctionSchema, d as PlatformRole, n as buildPlatformRoleSchema, b as CvcRegistry, k as buildCvcRegistrySchema, a as CvcEntry, j as buildCvcEntrySchema } from './cvcEntry-0BIB9sen.cjs';
1
+ import { F as Form, l as buildFormSchema, h as Section, q as buildSectionSchema, Q as Question, o as buildQuestionSchema, f as ScoringRule, p as buildScoringRuleSchema, P as PlatformFunction, m as buildPlatformFunctionSchema, d as PlatformRole, n as buildPlatformRoleSchema, b as CvcRegistry, k as buildCvcRegistrySchema, a as CvcEntry, j as buildCvcEntrySchema } from './cvcEntry-ctHTp2df.cjs';
2
2
  import * as mongoose from 'mongoose';
3
3
  import { HydratedDocument, Connection, Model } from 'mongoose';
4
4
 
package/dist/index.cjs CHANGED
@@ -524,9 +524,9 @@ __export(src_exports, {
524
524
  contactLinkTypeSot: () => contactLinkType_v1_0_0_default,
525
525
  contactSafetyStatusSot: () => contactSafetyStatus_v1_0_0_default,
526
526
  coreDhStateSot: () => coreDhState_v1_0_0_default,
527
- coreFunctionsSot: () => coreFunctions_v1_0_0_default,
527
+ coreFunctionsSot: () => coreFunctions_v1_1_0_default,
528
528
  coreIndicatorsSot: () => coreIndicators_v1_1_0_default,
529
- coreInformationScopeSot: () => coreInformationScope_v1_0_0_default,
529
+ coreInformationScopeSot: () => coreInformationScope_v1_1_0_default,
530
530
  coreReferralOutcomeSot: () => coreReferralOutcome_v1_0_0_default,
531
531
  countriesSot: () => countries_v1_0_0_default,
532
532
  createPlatformModels: () => createPlatformModels,
@@ -680,7 +680,7 @@ __export(src_exports, {
680
680
  riskIdentificationMilestoneSot: () => riskIdentificationMilestone_v1_0_0_default,
681
681
  riskSeverityBandSot: () => riskSeverityBand_v1_0_0_default,
682
682
  roiMethodSot: () => roiMethod_v1_0_0_default,
683
- roiScopeSot: () => roiScope_v1_0_0_default,
683
+ roiScopeSot: () => roiScope_v1_2_0_default,
684
684
  roiStatusSot: () => roiStatus_v1_0_0_default,
685
685
  roleContextSot: () => roleContext_v1_0_0_default,
686
686
  romanticRelationshipChangeTypeSot: () => romanticRelationshipChangeType_v1_0_0_default,
@@ -10739,7 +10739,8 @@ var CoreFunctionsKeys = {
10739
10739
  thread_share_send: "133-074-000-000-000-000-000",
10740
10740
  training_content_upload: "133-075-000-000-000-000-000",
10741
10741
  training_gate_manage: "133-076-000-000-000-000-000",
10742
- usr_manage: "133-077-000-000-000-000-000"
10742
+ usr_manage: "133-077-000-000-000-000-000",
10743
+ note_open_departed_author: "133-078-000-000-000-000-000"
10743
10744
  };
10744
10745
  var NeedsAssessmentChangeTypeKeys = {
10745
10746
  missingness_root: "982-000-000-000-000-000-000",
@@ -10798,6 +10799,7 @@ var CoreInformationScopeKeys = {
10798
10799
  screen_notes: "236-005-001-000-000-000-000",
10799
10800
  case_notes: "236-005-002-000-000-000-000",
10800
10801
  background: "236-005-003-000-000-000-000",
10802
+ session_summary: "236-005-004-000-000-000-000",
10801
10803
  health_accommodation: "236-006-000-000-000-000-000",
10802
10804
  accommodation_needs: "236-006-001-000-000-000-000",
10803
10805
  disability_subtypes: "236-006-002-000-000-000-000",
@@ -38844,12 +38846,12 @@ var riskCategory_v1_0_0_default = {
38844
38846
  ]
38845
38847
  };
38846
38848
 
38847
- // src/cvcs/coreFunctions.v1.0.0.json
38848
- var coreFunctions_v1_0_0_default = {
38849
+ // src/cvcs/coreFunctions.v1.1.0.json
38850
+ var coreFunctions_v1_1_0_default = {
38849
38851
  domain: "core_functions",
38850
38852
  name: "Core Functions",
38851
- version: "1.0.0",
38852
- _status: "DRAFTED \u2014 NEEDS REVIEW: canonical Notion CVC-133 (core - functions), verified v1.0, ported verbatim from the Notion codebook. Canonical numbering (133), NOT provisional. Per-entry lifecycle Status (v1 / future / not-started) is carried in each definition.",
38853
+ version: "1.1.0",
38854
+ _status: "DRAFTED \u2014 NEEDS REVIEW: canonical Notion CVC-133 (core - functions), verified v1.0, ported verbatim from the Notion codebook. Canonical numbering (133), NOT provisional. Per-entry lifecycle Status (v1 / future / not-started) is carried in each definition. VERSION 1.1.0 (additive; ADR-CVC-0.8.13 Addendum 2026-10-05): APPENDS `note_open_departed_author` at 133-078 (added 2026-10-05 while building the Narrative notes Spec v2, rule 10; canon's own logic_notes mark the row as awaiting steward review (Crysta); canon `data/cvcs/core_functions.yaml` L68-93 @ prototype 9ef79748, unchanged at fed744f3, and the codebook_all.csv export). Default Off for Account Admin (MEM-ADM) only; bounds are not carried by this entry schema. Every 1.0.0 code and key is unchanged. Canon carries 112 functions; this SOT carries 78 \u2014 the other 34 canon rows are a separate absorb, not taken here.",
38853
38855
  _source: "Notion CVC-133 core - functions (collection://3211ef14-abcd-8024-867d-000be4b35a79)",
38854
38856
  levels: {
38855
38857
  "0": "Unknown or Missing",
@@ -39588,6 +39590,15 @@ var coreFunctions_v1_0_0_default = {
39588
39590
  parentCode: null,
39589
39591
  childCodes: [],
39590
39592
  definition: "Create, invite, deactivate, and manage user accounts within a member account or platform context. [Status: Defined; existing PAVE function. Platform: PLATFORM. User-relevant: no. Admin-relevant: yes. Category: Identity & access administration, Platform administration (HTI-only).]"
39593
+ },
39594
+ {
39595
+ code: "133-078-000-000-000-000-000",
39596
+ key: "note_open_departed_author",
39597
+ title: "Open a deactivated author's private notes",
39598
+ selectable: true,
39599
+ parentCode: null,
39600
+ childCodes: [],
39601
+ definition: `Move a deactivated author's "Private to me" notes to "Our account only", so the account can read notes whose author no longer has an account. The admin cannot read a note before opening it and cannot move it any further. [Status: Defined; new function. Platform: PAVE, THREAD. User-relevant: no. Admin-relevant: yes. Category: Account administration (member admin).]`
39591
39602
  }
39592
39603
  ]
39593
39604
  };
@@ -39728,17 +39739,101 @@ var needsAssessmentChangeType_v1_0_0_default = {
39728
39739
  ]
39729
39740
  };
39730
39741
 
39731
- // src/cvcs/coreInformationScope.v1.0.0.json
39732
- var coreInformationScope_v1_0_0_default = {
39742
+ // src/cvcs/coreInformationScope.v1.1.0.json
39743
+ var coreInformationScope_v1_1_0_default = {
39733
39744
  domain: "core_information_scope",
39734
39745
  name: "Core Information Scope",
39735
- version: "1.0.0",
39736
- _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 \u2014 `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.",
39737
- _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 \u2014 codebook.csv @ 55088d44)",
39746
+ version: "1.1.0",
39747
+ _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 \u2014 `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.',
39748
+ _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 \u2014 codebook.csv @ 9ef79748; 2 retired codebook rows matched to the yaml's retired_units; 31 codebook-ahead rows under instruments acknowledged, not exported)",
39749
+ _supersedes: {
39750
+ version: "1.0.0",
39751
+ keyMap: {
39752
+ missingness_root: "missingness_root",
39753
+ unknown: "unknown",
39754
+ anonymous: "anonymous",
39755
+ data_not_collected: "data_not_collected",
39756
+ identifying: "identifying",
39757
+ names: "names",
39758
+ dob: "dob",
39759
+ addresses: "addresses",
39760
+ additional_ids: "additional_ids",
39761
+ demographics: "demographics",
39762
+ risk: "risk",
39763
+ screen_indicators: "screen_indicators",
39764
+ victimization: "victimization",
39765
+ ida_full: "ida_full",
39766
+ ida_consid: "ida_consid",
39767
+ initial_screen: "initial_screen",
39768
+ tra: "tra",
39769
+ lap: "lap",
39770
+ danger_assessment: "danger_assessment",
39771
+ injury_and_strangulation: "injury_and_strangulation",
39772
+ stalking_assessment: "stalking_assessment",
39773
+ ae_intake: "ae_intake",
39774
+ hope_scale: "hope_scale",
39775
+ assessment_records: "assessment_records",
39776
+ determinations: "determinations",
39777
+ offender_facilitator: "offender_facilitator",
39778
+ system_involvement: "system_involvement",
39779
+ derived_risk_signals: "derived_risk_signals",
39780
+ contact: "contact",
39781
+ contact_info: "contact_info",
39782
+ safe_locations: "safe_locations",
39783
+ priorities_safety: "priorities_safety",
39784
+ encounter_location: "encounter_location",
39785
+ services: "services",
39786
+ contact_history: "contact_history",
39787
+ service_history: "service_history",
39788
+ plans_goals: "plans_goals",
39789
+ notes: "notes",
39790
+ screen_notes: "screen_notes",
39791
+ case_notes: "case_notes",
39792
+ background: "background",
39793
+ health_accommodation: "health_accommodation",
39794
+ accommodation_needs: "accommodation_needs",
39795
+ disability_subtypes: "disability_subtypes",
39796
+ mental_health_status: "mental_health_status",
39797
+ substance_use_status: "substance_use_status",
39798
+ chronic_health_status: "chronic_health_status",
39799
+ hiv_status: "hiv_status",
39800
+ mental_health_screen: "mental_health_screen",
39801
+ trauma_and_coping_screen: "trauma_and_coping_screen",
39802
+ behavioral_health_intake: "behavioral_health_intake",
39803
+ immigration_legal_status: "immigration_legal_status",
39804
+ immigration_status: "immigration_status",
39805
+ uscis_alien_number: "uscis_alien_number",
39806
+ federal_protection_applications: "federal_protection_applications",
39807
+ tvap_enrollment: "tvap_enrollment",
39808
+ le_report_status: "le_report_status",
39809
+ system: "system",
39810
+ system_info: "system_info",
39811
+ network_associations: "network_associations",
39812
+ network_membership: "network_membership",
39813
+ persona_links: "persona_links",
39814
+ commercial_activity: "commercial_activity",
39815
+ ad_content: "ad_content",
39816
+ commercial_patterns: "commercial_patterns",
39817
+ investigative_work_product: "investigative_work_product",
39818
+ case_determinations: "case_determinations",
39819
+ case_lifecycle: "case_lifecycle",
39820
+ case_attachments: "case_attachments",
39821
+ object_identifiers: "object_identifiers",
39822
+ phone_identifiers: "phone_identifiers",
39823
+ object_identity_attributes: "object_identity_attributes"
39824
+ },
39825
+ retiredCodes: [],
39826
+ notes: {
39827
+ 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).",
39828
+ 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 \u2014 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.",
39829
+ 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 \u2014 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.",
39830
+ 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."
39831
+ }
39832
+ },
39738
39833
  levels: {
39739
39834
  "0": "Unknown or Missing",
39740
39835
  "1": "Category (policy grain, not selectable)",
39741
- "2": "Information unit (authorization grain, selectable)"
39836
+ "2": "Information unit (authorization grain; selectable unless retired)"
39742
39837
  },
39743
39838
  entries: [
39744
39839
  {
@@ -40154,10 +40249,11 @@ var coreInformationScope_v1_0_0_default = {
40154
40249
  selectable: true,
40155
40250
  parentCode: "236-002-000-000-000-000-000",
40156
40251
  childCodes: [],
40157
- definition: "Offender + facilitator records. Category `risk`. Carries TRA perpetrator records (ruled 2026-08-14): content wins \u2014 third-party identity never rides a subject-instrument disclosure silently.",
40252
+ definition: "Offender + facilitator records. Category `risk`. Carries TRA perpetrator records (ruled 2026-08-14): content wins \u2014 third-party identity never rides a subject-instrument disclosure silently. | THREAD ADDED 2026-10-01 (OFFENDER-SYSTEM-UNITS-THREAD, Crysta R1 \u2014 Nate Luginbill's Question set 2 item 4): app_relevance follows where the unit's content is captured, and Thread captures perpetrator records (identity \xB7 description \xB7 vehicle \xB7 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 \u2014 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).",
40158
40253
  levelFloor: 3,
40159
40254
  appRelevance: [
40160
40255
  "PAVE",
40256
+ "Thread",
40161
40257
  "LEADS"
40162
40258
  ],
40163
40259
  shareableDefault: true,
@@ -40170,10 +40266,11 @@ var coreInformationScope_v1_0_0_default = {
40170
40266
  selectable: true,
40171
40267
  parentCode: "236-002-000-000-000-000-000",
40172
40268
  childCodes: [],
40173
- definition: "System involvement. Category `risk`.",
40269
+ 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 \u2014 canon holds, no split): a protection order is ONE record under this unit, whole \u2014 the survivor's legal protection (petitioner \xB7 court \xB7 status \xB7 expiry \xB7 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 \u2014 a reference carries no content, the referenced record rides its own unit (the 2026-10-01 safety-plan reference rule).",
40174
40270
  levelFloor: 3,
40175
40271
  appRelevance: [
40176
- "PAVE"
40272
+ "PAVE",
40273
+ "Thread"
40177
40274
  ],
40178
40275
  shareableDefault: true,
40179
40276
  specialDataType: "survivor_confidential"
@@ -40306,7 +40403,7 @@ var coreInformationScope_v1_0_0_default = {
40306
40403
  selectable: true,
40307
40404
  parentCode: "236-004-000-000-000-000-000",
40308
40405
  childCodes: [],
40309
- definition: "Contact history with this agency. Category `services`. Honest-empty (\xA7 5.4): no canonical UDD field carries the interaction register yet.",
40406
+ definition: "Contact history with this agency. Category `services`. DELIVERS since 2026-10-01 (CONTACT-HISTORY-REGISTER, Crysta R1\u2013R3 \u2014 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 \u2014 one row per session, date \xB7 channel (CVC-47) \xB7 kind of sitting (CVC-217) \xB7 the agency/program as recorded, plus a count line \u2014 computed from the SENDING agency's session records at send time by the one as-delivered builder, never stored (UDD person.contact_history, derived \xB7 accumulating_log \xB7 IC-76; source fields capture.session_started_at \xB7 capture.service_delivery_channel [its session-record store `contact_method`] \xB7 capture.session_template). The fact of contact, not content: no notes, answers, outcomes or services \u2014 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 \u2014 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) \xB7 ROI full_collab gains it 2026-10-01 (derivation for veto). Smoke FLOW-381.",
40310
40407
  levelFloor: 3,
40311
40408
  appRelevance: [
40312
40409
  "PAVE",
@@ -40356,9 +40453,10 @@ var coreInformationScope_v1_0_0_default = {
40356
40453
  childCodes: [
40357
40454
  "236-005-001-000-000-000-000",
40358
40455
  "236-005-002-000-000-000-000",
40359
- "236-005-003-000-000-000-000"
40456
+ "236-005-003-000-000-000-000",
40457
+ "236-005-004-000-000-000-000"
40360
40458
  ],
40361
- definition: "Narrative notes \u2014 policy-grain category. Units under it are the authorization grain. LEADS flag dropped 2026-08-14 (all units PAVE/Thread \u2014 was an empty shell for LEADS-only agencies).",
40459
+ definition: "Narrative notes \u2014 policy-grain category. Units under it are the authorization grain. LEADS flag dropped 2026-08-14 (all units PAVE/Thread \u2014 was an empty shell for LEADS-only agencies). | NARRATIVE-NOTES 2026-10-05 (signed Spec v2, rule 5 \u2014 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.",
40362
40460
  levelFloor: 3,
40363
40461
  appRelevance: [
40364
40462
  "PAVE",
@@ -40371,26 +40469,20 @@ var coreInformationScope_v1_0_0_default = {
40371
40469
  code: "236-005-001-000-000-000-000",
40372
40470
  key: "screen_notes",
40373
40471
  title: "Screen notes",
40374
- selectable: true,
40472
+ selectable: false,
40375
40473
  parentCode: "236-005-000-000-000-000-000",
40376
40474
  childCodes: [],
40377
- definition: "Screen notes. Category `notes`.",
40378
- levelFloor: 3,
40379
- appRelevance: [
40380
- "PAVE",
40381
- "Thread"
40382
- ],
40383
- shareableDefault: true,
40384
- specialDataType: "survivor_confidential"
40475
+ 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.",
40476
+ retired: true
40385
40477
  },
40386
40478
  {
40387
40479
  code: "236-005-002-000-000-000-000",
40388
40480
  key: "case_notes",
40389
- title: "Detailed case notes",
40481
+ title: "Session & case notes",
40390
40482
  selectable: true,
40391
40483
  parentCode: "236-005-000-000-000-000-000",
40392
40484
  childCodes: [],
40393
- definition: "Detailed case notes. Category `notes`.",
40485
+ 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.",
40394
40486
  levelFloor: 3,
40395
40487
  appRelevance: [
40396
40488
  "PAVE",
@@ -40403,10 +40495,20 @@ var coreInformationScope_v1_0_0_default = {
40403
40495
  code: "236-005-003-000-000-000-000",
40404
40496
  key: "background",
40405
40497
  title: "Background information",
40498
+ selectable: false,
40499
+ parentCode: "236-005-000-000-000-000-000",
40500
+ childCodes: [],
40501
+ 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.",
40502
+ retired: true
40503
+ },
40504
+ {
40505
+ code: "236-005-004-000-000-000-000",
40506
+ key: "session_summary",
40507
+ title: "Session summary",
40406
40508
  selectable: true,
40407
40509
  parentCode: "236-005-000-000-000-000-000",
40408
40510
  childCodes: [],
40409
- definition: "Background information. Category `notes`.",
40511
+ definition: "Session summary. Category `notes`. MINTED 2026-10-02 (Crysta: two sub-categories \u2014 'Agree'); in the apps since 2026-10-05 (NARRATIVE-NOTES). Includes the typed session summary (one note marked as the summary \u2014 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.",
40410
40512
  levelFloor: 3,
40411
40513
  appRelevance: [
40412
40514
  "PAVE",
@@ -40929,13 +41031,55 @@ var coreInformationScope_v1_0_0_default = {
40929
41031
  ]
40930
41032
  };
40931
41033
 
40932
- // src/cvcs/roiScope.v1.0.0.json
40933
- var roiScope_v1_0_0_default = {
41034
+ // src/cvcs/roiScope.v1.2.0.json
41035
+ var roiScope_v1_2_0_default = {
40934
41036
  domain: "roi_scope",
40935
41037
  name: "ROI Scope",
40936
- version: "1.1.0",
40937
- _status: "DRAFT \u2014 TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering. 0.8.13: COMPLETED against the canonical 27-item source. 0.8.12 shipped 15 of the canonical 27; the missing 12 are added here. Nothing PAVE shipped was invented \u2014 this was purely a gap. Canonical source: `HTI_SHARE_SCOPE_GROUPS` in HTI-LEADS-PAVE-Thread-prototype.html @ HEAD a596eb9 (7 groups x items = 27): identifying (5) + risk (4) + contact (3) + notes (3) + health_accommodation (6) + immigration_legal_status (5) + system (1). The GROUP axis (identifying / risk / contact / notes / health_accommodation / immigration_legal_status / system) is a separate presentation concern and is deliberately NOT modelled as hierarchy rows here \u2014 this CVC is the flat item vocabulary that an ROI authorizes. PENDING canonical Notion authoring + steward ratification.",
40938
- _source: "htilabstech/prototype@a596eb9 HTI-LEADS-PAVE-Thread-prototype.html HTI_SHARE_SCOPE_GROUPS",
41038
+ version: "1.2.0",
41039
+ _status: 'DRAFT \u2014 TEMPORARY: net-new value-CVC not yet in Notion; provisional 900+ numbering. 0.8.13: COMPLETED against the canonical 27-item source. 0.8.12 shipped 15 of the canonical 27; the missing 12 are added here. Nothing PAVE shipped was invented \u2014 this was purely a gap. Canonical source: `HTI_SHARE_SCOPE_GROUPS` in HTI-LEADS-PAVE-Thread-prototype.html @ HEAD a596eb9 (7 groups x items = 27): identifying (5) + risk (4) + contact (3) + notes (3) + health_accommodation (6) + immigration_legal_status (5) + system (1). The GROUP axis (identifying / risk / contact / notes / health_accommodation / immigration_legal_status / system) is a separate presentation concern and is deliberately NOT modelled as hierarchy rows here \u2014 this CVC is the flat item vocabulary that an ROI authorizes. PENDING canonical Notion authoring + steward ratification. VERSION 1.2.0 supersedes 1.1.0 (co-bwc): `screen_notes` (983-012) and `background` (983-014) are RETIRED TOMBSTONES, matching CVC-236 `core_information_scope` v1.1.0 (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 that names one resolves to "retired", not "unknown". Not additive, hence the version (ADR-CVC-0.8.13 Addendum 2026-10-05; see `_supersedes`). This flat vocabulary is LEGACY: new units (e.g. `session_summary`, 236-005-004) are minted in CVC-236 only and are not mirrored here.',
41040
+ _source: "htilabstech/prototype@a596eb9 HTI-LEADS-PAVE-Thread-prototype.html HTI_SHARE_SCOPE_GROUPS; v1.2.0 retirements: htilabstech/prototype/data/cvcs/core_information_scope.yaml @ 9ef79748 retired_units (L467)",
41041
+ _supersedes: {
41042
+ version: "1.1.0",
41043
+ keyMap: {
41044
+ missingness_root: "missingness_root",
41045
+ unknown: "unknown",
41046
+ anonymous: "anonymous",
41047
+ data_not_collected: "data_not_collected",
41048
+ names: "names",
41049
+ dob: "dob",
41050
+ addresses: "addresses",
41051
+ additional_ids: "additional_ids",
41052
+ demographics: "demographics",
41053
+ screen_indicators: "screen_indicators",
41054
+ victimization: "victimization",
41055
+ ida_full: "ida_full",
41056
+ ida_consid: "ida_consid",
41057
+ contact_info: "contact_info",
41058
+ service_history: "service_history",
41059
+ screen_notes: "screen_notes",
41060
+ case_notes: "case_notes",
41061
+ background: "background",
41062
+ system_info: "system_info",
41063
+ contact_history: "contact_history",
41064
+ accommodation_needs: "accommodation_needs",
41065
+ disability_subtypes: "disability_subtypes",
41066
+ mental_health_status: "mental_health_status",
41067
+ substance_use_status: "substance_use_status",
41068
+ chronic_health_status: "chronic_health_status",
41069
+ hiv_status: "hiv_status",
41070
+ immigration_status: "immigration_status",
41071
+ uscis_alien_number: "uscis_alien_number",
41072
+ federal_protection_applications: "federal_protection_applications",
41073
+ tvap_enrollment: "tvap_enrollment",
41074
+ le_report_status: "le_report_status"
41075
+ },
41076
+ retiredCodes: [],
41077
+ notes: {
41078
+ summary: 'Every v1.1.0 key is still an entry in v1.2.0, at its v1.1.0 code, so `keyMap` is the identity and `retiredCodes` is empty: no code was withdrawn. Non-additive because 2 published items are now RETIRED tombstones (notes below), matching CVC-236 `core_information_scope` v1.1.0, which retired the same two keys; nothing was added. Before this version the package gave two answers to "is screen_notes offerable" (co-bwc). The file was named `roiScope.v1.0.0.json` while declaring version 1.1.0 (the 0.8.13 completion); the published version superseded here is the declared 1.1.0.',
41079
+ screen_notes: "v1.1.0 `screen_notes` was a selectable item. 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 983-012 as a tombstone (`selectable: false`, `retired: true`) with NO successor key, and includes nothing \u2014 a stored ROI that names it narrows, never widens. CVC-236 v1.1.0 retired the same key (canon `data/cvcs/core_information_scope.yaml` `retired_units` L467 @ prototype 9ef79748); canon records that only demo data named it (Crysta 2026-10-04).",
41080
+ background: "v1.1.0 `background` was a selectable item. Retired 2026-10-05 (Narrative notes, signed Spec v2 rule 5): Nothing ever captured it. It stays at 983-014 as a tombstone (`selectable: false`, `retired: true`) with NO successor key, and includes nothing \u2014 a stored ROI that names it narrows, never widens. CVC-236 v1.1.0 retired the same key (canon `data/cvcs/core_information_scope.yaml` `retired_units` L467 @ prototype 9ef79748); canon records that only demo data named it (Crysta 2026-10-04)."
41081
+ }
41082
+ },
40939
41083
  levels: {
40940
41084
  "0": "Unknown or Missing",
40941
41085
  "1": "ROI scope item"
@@ -41084,10 +41228,11 @@ var roiScope_v1_0_0_default = {
41084
41228
  code: "983-012-000-000-000-000-000",
41085
41229
  key: "screen_notes",
41086
41230
  title: "Screen notes",
41087
- selectable: true,
41231
+ selectable: false,
41088
41232
  parentCode: null,
41089
41233
  childCodes: [],
41090
- definition: "Narrative notes captured during screening. Narrative-notes scope group."
41234
+ definition: "RETIRED 2026-10-05 (Narrative notes, signed Spec v2 rule 5), matching its CVC-236 `core_information_scope` v1.1.0 twin. The Initial Screen's notes box is an instrument note and belongs to the Initial Screen. No longer offered in an ROI; a stored code resolves here so a reader can tell retired from unknown, and includes nothing.",
41235
+ retired: true
41091
41236
  },
41092
41237
  {
41093
41238
  code: "983-013-000-000-000-000-000",
@@ -41102,10 +41247,11 @@ var roiScope_v1_0_0_default = {
41102
41247
  code: "983-014-000-000-000-000-000",
41103
41248
  key: "background",
41104
41249
  title: "Background information",
41105
- selectable: true,
41250
+ selectable: false,
41106
41251
  parentCode: null,
41107
41252
  childCodes: [],
41108
- definition: "Background/narrative context about the subject. Narrative-notes scope group."
41253
+ definition: "RETIRED 2026-10-05 (Narrative notes, signed Spec v2 rule 5), matching its CVC-236 `core_information_scope` v1.1.0 twin. Nothing ever captured it. No longer offered in an ROI; a stored code resolves here so a reader can tell retired from unknown, and includes nothing.",
41254
+ retired: true
41109
41255
  },
41110
41256
  {
41111
41257
  code: "983-015-000-000-000-000-000",