@htilabs/platform-common-models 0.13.0 → 0.14.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 (63) hide show
  1. package/dist/constants/index.cjs +106 -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 +98 -0
  6. package/dist/constants/index.js.map +1 -1
  7. package/dist/{cvcEntry-ctHTp2df.d.cts → cvcEntry-0BIB9sen.d.cts} +36 -36
  8. package/dist/{cvcEntry-ctHTp2df.d.ts → cvcEntry-0BIB9sen.d.ts} +36 -36
  9. package/dist/cvcs/index.cjs +562 -120
  10. package/dist/cvcs/index.cjs.map +1 -1
  11. package/dist/cvcs/index.d.cts +589 -121
  12. package/dist/cvcs/index.d.ts +589 -121
  13. package/dist/cvcs/index.js +562 -120
  14. package/dist/cvcs/index.js.map +1 -1
  15. package/dist/enums/index.cjs +22 -2
  16. package/dist/enums/index.cjs.map +1 -1
  17. package/dist/enums/index.d.cts +29 -9
  18. package/dist/enums/index.d.ts +29 -9
  19. package/dist/enums/index.js +22 -2
  20. package/dist/enums/index.js.map +1 -1
  21. package/dist/{index-4DiJrn7y.d.ts → index-CDoqrfc1.d.ts} +1 -1
  22. package/dist/{index-qreOzXYS.d.cts → index-Zu_mOJRn.d.cts} +1 -1
  23. package/dist/index.cjs +690 -122
  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 +682 -122
  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-Dv5fu0Fh.d.cts → platform-auth-CrF5U_JH.d.cts} +113 -3
  32. package/dist/{platform-auth-Dv5fu0Fh.d.ts → platform-auth-CrF5U_JH.d.ts} +113 -3
  33. package/dist/schemas/index.cjs +296 -0
  34. package/dist/schemas/index.cjs.map +1 -1
  35. package/dist/schemas/index.d.cts +11 -11
  36. package/dist/schemas/index.d.ts +11 -11
  37. package/dist/schemas/index.js +296 -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 +26 -27
  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 +11 -11
  46. package/src/__tests__/cvc-136-scoring-invariant.test.ts +89 -28
  47. package/src/__tests__/cvc-drift-gate.test.ts +165 -32
  48. package/src/__tests__/cvc-sot-snapshot.test.ts +21 -12
  49. package/src/__tests__/cvc-structural.test.ts +8 -8
  50. package/src/__tests__/incident-participation-roles-canon.test.ts +424 -0
  51. package/src/__tests__/referral-entity-category-canon.test.ts +383 -0
  52. package/src/constants/ic.ts +321 -3
  53. package/src/cvcs/{coreIndicators.v1.0.0.json → coreIndicators.v1.1.0.json} +93 -10
  54. package/src/cvcs/{highestEducationLevelCompleted.v1.0.0.json → highestEducationLevelCompleted.v1.1.0.json} +1 -1
  55. package/src/cvcs/incidentParticipationRoles.v1.1.0.json +433 -0
  56. package/src/cvcs/{incomeBenefitsSources.v1.0.0.json → incomeBenefitsSources.v1.1.0.json} +1 -1
  57. package/src/cvcs/index.ts +8 -8
  58. package/src/cvcs/{referralEntityCategory.v1.0.0.json → referralEntityCategory.v1.1.0.json} +192 -54
  59. package/src/cvcs/{serviceStates.v1.0.0.json → serviceStates.v1.1.0.json} +1 -1
  60. package/src/cvcs/{sourceSubtype.v1.1.0.json → sourceSubtype.v1.2.0.json} +1 -1
  61. package/src/cvcs/{verificationMethod.v1.0.0.json → verificationMethod.v1.1.0.json} +1 -1
  62. package/src/generated/cvc-enums.ts +29 -9
  63. package/src/cvcs/incidentParticipationRoles.v1.0.0.json +0 -212
@@ -1973,6 +1973,13 @@ export const USER_STATUS_LABELS: Record<UserStatusValue, string> = {
1973
1973
 
1974
1974
  // ─── CVC-69: Incident Participation Role ────────────────────────────
1975
1975
  // Multi-valued: 0+ per person per session. Describes session participation.
1976
+ //
1977
+ // Legacy view of the SOT `src/cvcs/incidentParticipationRoles.v1.1.0.json`
1978
+ // (canon CVC-69 v1.0, audited 2026-09-10). Canon renamed five keys on
1979
+ // 2026-08-13; the old keys are KEPT here (marked `@deprecated`) because
1980
+ // consumers persist these keys on documents — a stored old key still validates
1981
+ // and still has a label. New writes should use the successor: see
1982
+ // `INCIDENT_PARTICIPATION_ROLE_SUPERSEDED_BY` below.
1976
1983
 
1977
1984
  export const INCIDENT_PARTICIPATION_ROLE = {
1978
1985
  CLIENT_SUBJECT: "client_subject", // Exactly 1 per session
@@ -1981,12 +1988,32 @@ export const INCIDENT_PARTICIPATION_ROLE = {
1981
1988
  REPORTER: "reporter",
1982
1989
  FAMILY_MEMBER_OR_GUARDIAN: "family_member_or_guardian",
1983
1990
  FRIEND_OR_PEER: "friend_or_peer",
1991
+ /** @deprecated Superseded by `VSP_STAFF` (canon CVC-69, 2026-08-13). Read-only. */
1984
1992
  SERVICE_PROVIDER_STAFF: "service_provider_staff",
1993
+ /** @deprecated Superseded by `HEALTHCARE_PROVIDER_STAFF` (canon CVC-69, 2026-08-13). Read-only. */
1985
1994
  MEDICAL_PROVIDER_STAFF: "medical_provider_staff",
1995
+ /** @deprecated Superseded by `DATA_ENTRY_STAFF` (canon CVC-69, 2026-08-13). Read-only. */
1986
1996
  DATA_ENTRY: "data_entry",
1997
+ /** @deprecated Superseded by `OTHER_RESPONSE_PERSONNEL` (canon CVC-69, 2026-08-13). Read-only. */
1987
1998
  OTHER_INCIDENT_RESPONDER: "other_incident_responder",
1999
+ /** @deprecated Superseded by `LAW_ENFORCEMENT_PERSONNEL` (canon CVC-69, 2026-08-13). Read-only. */
1988
2000
  RESPONDING_OFFICER: "responding_officer",
1989
2001
  LEGAL_PROFESSIONAL: "legal_professional",
2002
+ // Canon CVC-69 v1.0 — the five renamed codes + task_force.
2003
+ VSP_STAFF: "vsp_staff",
2004
+ HEALTHCARE_PROVIDER_STAFF: "healthcare_provider_staff",
2005
+ LAW_ENFORCEMENT_PERSONNEL: "law_enforcement_personnel",
2006
+ OTHER_RESPONSE_PERSONNEL: "other_response_personnel",
2007
+ DATA_ENTRY_STAFF: "data_entry_staff",
2008
+ TASK_FORCE: "task_force",
2009
+ // Canon Level-2 sub-items (LEADS investigative wing). A sub-item implies its
2010
+ // parent: the first four sit under LAW_ENFORCEMENT_PERSONNEL, PROSECUTOR
2011
+ // under LEGAL_PROFESSIONAL.
2012
+ LEAD_INVESTIGATOR: "lead_investigator",
2013
+ INVESTIGATOR: "investigator",
2014
+ ANALYST: "analyst",
2015
+ LE_OFFICER: "le_officer",
2016
+ PROSECUTOR: "prosecutor",
1990
2017
  UNKNOWN: "unknown",
1991
2018
  ANONYMOUS: "anonymous",
1992
2019
  DATA_NOT_COLLECTED: "data_not_collected",
@@ -2008,11 +2035,29 @@ export const INCIDENT_PARTICIPATION_ROLE_VALUES = [
2008
2035
  INCIDENT_PARTICIPATION_ROLE.OTHER_INCIDENT_RESPONDER,
2009
2036
  INCIDENT_PARTICIPATION_ROLE.RESPONDING_OFFICER,
2010
2037
  INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL,
2038
+ INCIDENT_PARTICIPATION_ROLE.VSP_STAFF,
2039
+ INCIDENT_PARTICIPATION_ROLE.HEALTHCARE_PROVIDER_STAFF,
2040
+ INCIDENT_PARTICIPATION_ROLE.LAW_ENFORCEMENT_PERSONNEL,
2041
+ INCIDENT_PARTICIPATION_ROLE.OTHER_RESPONSE_PERSONNEL,
2042
+ INCIDENT_PARTICIPATION_ROLE.DATA_ENTRY_STAFF,
2043
+ INCIDENT_PARTICIPATION_ROLE.TASK_FORCE,
2044
+ INCIDENT_PARTICIPATION_ROLE.LEAD_INVESTIGATOR,
2045
+ INCIDENT_PARTICIPATION_ROLE.INVESTIGATOR,
2046
+ INCIDENT_PARTICIPATION_ROLE.ANALYST,
2047
+ INCIDENT_PARTICIPATION_ROLE.LE_OFFICER,
2048
+ INCIDENT_PARTICIPATION_ROLE.PROSECUTOR,
2011
2049
  INCIDENT_PARTICIPATION_ROLE.UNKNOWN,
2012
2050
  INCIDENT_PARTICIPATION_ROLE.ANONYMOUS,
2013
2051
  INCIDENT_PARTICIPATION_ROLE.DATA_NOT_COLLECTED,
2014
2052
  ] as const;
2015
2053
 
2054
+ // Labels for the fifteen keys 0.13.0 shipped are kept exactly as shipped: they
2055
+ // are title-cased and several differ from the SOT titles and canon (e.g.
2056
+ // "Legal Professional" vs canon "Legal professional", "Not Collected" vs
2057
+ // "Data not collected"). Consumers display these strings, so re-casing them is a
2058
+ // visible change on repin and belongs in its own announced change, not in this
2059
+ // additive re-mirror. Labels for the eleven keys added in v1.1.0 are the canon
2060
+ // codebook `Acceptable name`, verbatim.
2016
2061
  export const INCIDENT_PARTICIPATION_ROLE_LABELS: Record<
2017
2062
  IncidentParticipationRoleValue,
2018
2063
  string
@@ -2033,6 +2078,22 @@ export const INCIDENT_PARTICIPATION_ROLE_LABELS: Record<
2033
2078
  "VSP or Other Incident Responder",
2034
2079
  [INCIDENT_PARTICIPATION_ROLE.RESPONDING_OFFICER]: "LE Responding Officer",
2035
2080
  [INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL]: "Legal Professional",
2081
+ // Added in v1.1.0: the canon codebook `Acceptable name`, verbatim.
2082
+ [INCIDENT_PARTICIPATION_ROLE.VSP_STAFF]: "Victim Service provider staff",
2083
+ [INCIDENT_PARTICIPATION_ROLE.HEALTHCARE_PROVIDER_STAFF]:
2084
+ "Healthcare provider staff",
2085
+ [INCIDENT_PARTICIPATION_ROLE.LAW_ENFORCEMENT_PERSONNEL]:
2086
+ "Law enforcement personnel",
2087
+ [INCIDENT_PARTICIPATION_ROLE.OTHER_RESPONSE_PERSONNEL]:
2088
+ "Other Response Personnel",
2089
+ [INCIDENT_PARTICIPATION_ROLE.DATA_ENTRY_STAFF]: "Data Entry / Editor",
2090
+ [INCIDENT_PARTICIPATION_ROLE.TASK_FORCE]: "Task Force Partner",
2091
+ [INCIDENT_PARTICIPATION_ROLE.LEAD_INVESTIGATOR]: "Lead Investigator",
2092
+ [INCIDENT_PARTICIPATION_ROLE.INVESTIGATOR]: "Investigator / Detective",
2093
+ [INCIDENT_PARTICIPATION_ROLE.ANALYST]: "Analyst",
2094
+ [INCIDENT_PARTICIPATION_ROLE.LE_OFFICER]: "LE Officer",
2095
+ [INCIDENT_PARTICIPATION_ROLE.PROSECUTOR]: "Prosecutor",
2096
+ // Level 0, as 0.13.0 shipped them (canon: Unknown / Anonymous / Data not collected).
2036
2097
  [INCIDENT_PARTICIPATION_ROLE.UNKNOWN]: "Unknown",
2037
2098
  [INCIDENT_PARTICIPATION_ROLE.ANONYMOUS]: "Anonymous",
2038
2099
  [INCIDENT_PARTICIPATION_ROLE.DATA_NOT_COLLECTED]: "Not Collected",
@@ -2041,6 +2102,12 @@ export const INCIDENT_PARTICIPATION_ROLE_LABELS: Record<
2041
2102
  /**
2042
2103
  * Participation role category groupings for UI organization.
2043
2104
  *
2105
+ * NOT YET RE-KEYED: `SYSTEM_PROFESSIONAL` (and
2106
+ * `DEFAULT_PARTICIPATION_ROLE_BY_CATEGORY.PERSONNEL` below) still name the
2107
+ * superseded `SERVICE_PROVIDER_STAFF` / `MEDICAL_PROVIDER_STAFF` keys. They are
2108
+ * deliberately left as-is: flipping them changes what a consumer WRITES on a
2109
+ * version bump, so that switch belongs to each consumer's own migration.
2110
+ *
2044
2111
  * Note: UNKNOWN, ANONYMOUS, and DATA_NOT_COLLECTED are intentionally excluded.
2045
2112
  * These are data quality states, not selectable participation roles.
2046
2113
  * Handle them via separate UI controls (e.g., "Unknown" / "Anonymous" buttons).
@@ -2070,6 +2137,91 @@ export const CALLER_IS_VICTIM_ROLES: IncidentParticipationRoleValue[] = [
2070
2137
  INCIDENT_PARTICIPATION_ROLE.REPORTER,
2071
2138
  ];
2072
2139
 
2140
+ /**
2141
+ * The five CVC-69 keys canon superseded on 2026-08-13, each mapped to its
2142
+ * canonical successor (SOT `incidentParticipationRoles.v1.1.0.json`:
2143
+ * `deprecated: true` + `supersededBy`).
2144
+ *
2145
+ * A superseded key is still a VALID STORED VALUE: it stays in
2146
+ * `INCIDENT_PARTICIPATION_ROLE_VALUES`, keeps its label, and still resolves in
2147
+ * the seeded registry — nothing persisted has to be rewritten. It is only no
2148
+ * longer offered for NEW writes (`selectable: false` in the SOT;
2149
+ * `ACTIVE_INCIDENT_PARTICIPATION_ROLE_VALUES` below).
2150
+ *
2151
+ * The mapping is canon's rename ruling, not a guarantee of identical meaning:
2152
+ * `other_incident_responder` was labelled "VSP or Other Incident Responder",
2153
+ * while `other_response_personnel` excludes VSP staff. Normalising for display
2154
+ * or grouping is safe; a one-way data migration should review that key.
2155
+ */
2156
+ export const INCIDENT_PARTICIPATION_ROLE_SUPERSEDED_BY = {
2157
+ [INCIDENT_PARTICIPATION_ROLE.SERVICE_PROVIDER_STAFF]:
2158
+ INCIDENT_PARTICIPATION_ROLE.VSP_STAFF,
2159
+ [INCIDENT_PARTICIPATION_ROLE.MEDICAL_PROVIDER_STAFF]:
2160
+ INCIDENT_PARTICIPATION_ROLE.HEALTHCARE_PROVIDER_STAFF,
2161
+ [INCIDENT_PARTICIPATION_ROLE.DATA_ENTRY]:
2162
+ INCIDENT_PARTICIPATION_ROLE.DATA_ENTRY_STAFF,
2163
+ [INCIDENT_PARTICIPATION_ROLE.OTHER_INCIDENT_RESPONDER]:
2164
+ INCIDENT_PARTICIPATION_ROLE.OTHER_RESPONSE_PERSONNEL,
2165
+ [INCIDENT_PARTICIPATION_ROLE.RESPONDING_OFFICER]:
2166
+ INCIDENT_PARTICIPATION_ROLE.LAW_ENFORCEMENT_PERSONNEL,
2167
+ } as const satisfies Partial<
2168
+ Record<IncidentParticipationRoleValue, IncidentParticipationRoleValue>
2169
+ >;
2170
+
2171
+ export type DeprecatedIncidentParticipationRoleValue =
2172
+ keyof typeof INCIDENT_PARTICIPATION_ROLE_SUPERSEDED_BY;
2173
+
2174
+ /** `true` iff `role` is a superseded (read-only) CVC-69 key. */
2175
+ export function isDeprecatedIncidentParticipationRole(
2176
+ role: unknown,
2177
+ ): role is DeprecatedIncidentParticipationRoleValue {
2178
+ return (
2179
+ typeof role === "string" &&
2180
+ Object.prototype.hasOwnProperty.call(
2181
+ INCIDENT_PARTICIPATION_ROLE_SUPERSEDED_BY,
2182
+ role,
2183
+ )
2184
+ );
2185
+ }
2186
+
2187
+ /**
2188
+ * The canonical CVC-69 key for a stored value: the successor of a superseded
2189
+ * key, otherwise the value unchanged. Pure; never validates — an unknown
2190
+ * string is returned as-is.
2191
+ */
2192
+ export function canonicalIncidentParticipationRole<T extends string>(
2193
+ role: T,
2194
+ ): T | IncidentParticipationRoleValue {
2195
+ return isDeprecatedIncidentParticipationRole(role)
2196
+ ? INCIDENT_PARTICIPATION_ROLE_SUPERSEDED_BY[role]
2197
+ : role;
2198
+ }
2199
+
2200
+ /** A CVC-69 value that may be written fresh: any value except the five superseded keys. */
2201
+ export type ActiveIncidentParticipationRoleValue = Exclude<
2202
+ IncidentParticipationRoleValue,
2203
+ DeprecatedIncidentParticipationRoleValue
2204
+ >;
2205
+
2206
+ /**
2207
+ * Every CVC-69 value that may be WRITTEN fresh:
2208
+ * `INCIDENT_PARTICIPATION_ROLE_VALUES` minus the five superseded keys. Use
2209
+ * `INCIDENT_PARTICIPATION_ROLE_VALUES` to VALIDATE stored values.
2210
+ *
2211
+ * This is not a picker list as it stands. It still contains ANONYMOUS and
2212
+ * DATA_NOT_COLLECTED, which canon never offers in a picker: ANONYMOUS is set
2213
+ * by a decline affordance and DATA_NOT_COLLECTED only by the system. The SOT
2214
+ * marks both `neverPickable`, but that flag lives in the JSON only (the
2215
+ * `cvc_entities` schema does not persist it), so a picker built from this
2216
+ * list must drop the two itself.
2217
+ */
2218
+ export const ACTIVE_INCIDENT_PARTICIPATION_ROLE_VALUES = Object.freeze(
2219
+ INCIDENT_PARTICIPATION_ROLE_VALUES.filter(
2220
+ (role): role is ActiveIncidentParticipationRoleValue =>
2221
+ !isDeprecatedIncidentParticipationRole(role),
2222
+ ),
2223
+ );
2224
+
2073
2225
  // ─── Person Display Category ────────────────────────────────────────
2074
2226
  // 5 UI groupings for displaying persons based on involvement role.
2075
2227
 
@@ -2206,6 +2358,12 @@ export function getDisplayCategoryForRole(
2206
2358
 
2207
2359
  // ─── Default Participation Roles by Display Category ───────────────
2208
2360
  // When toggling "Involved" on, these are the default participation roles.
2361
+ //
2362
+ // NOT YET RE-KEYED: PERSONNEL still defaults to the superseded
2363
+ // `SERVICE_PROVIDER_STAFF` (canonical successor `VSP_STAFF`). Deliberate: a
2364
+ // default decides what a consumer WRITES, so changing it here would change
2365
+ // consumer writes on a version bump. Each consumer switches to `VSP_STAFF` in
2366
+ // its own repin. Same for `PARTICIPATION_ROLE_CATEGORIES.SYSTEM_PROFESSIONAL`.
2209
2367
 
2210
2368
  export const DEFAULT_PARTICIPATION_ROLE_BY_CATEGORY: Record<
2211
2369
  PersonDisplayCategoryValue,
@@ -5263,11 +5421,11 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5263
5421
  categoryLabel: CVC_136_CATEGORY_LABELS[category],
5264
5422
  }));
5265
5423
 
5266
- // ─── CVC-136: full core-indicators value set (CANONICAL, 216 codes) ─────
5424
+ // ─── CVC-136: full core-indicators value set (CANONICAL, 220 codes) ─────
5267
5425
  // The complete CVC-136 'core - indicators' vocabulary. As of 0.8.13 the
5268
5426
  // AUTHORITATIVE surface for this domain is the SOT JSON
5269
- // `src/cvcs/coreIndicators.v1.0.0.json` (220 entries = 216 substantive + the
5270
- // missingness quadruplet), which also carries the canonical `family`,
5427
+ // `src/cvcs/coreIndicators.v1.1.0.json` (226 entries = 220 live + 2 deprecated
5428
+ // + the missingness quadruplet), which also carries the canonical `family`,
5271
5429
  // `polarity`, `severity`, `isAlert` and `alertWhen` entry attributes. This
5272
5430
  // hand-coded array is kept in lockstep with that JSON as a flat key list for
5273
5431
  // existing importers; it is generated FROM it and must not diverge.
@@ -5377,6 +5535,88 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5377
5535
  // (Two remaining JSON-vs-YAML differences are round-trip artifacts, not
5378
5536
  // drift: an unescaped `fiancé` and unwrapped hard-wrapped lines.)
5379
5537
  //
5538
+ // Refresh to c53378f — 216 → 220 (catalog refresh, prototype 622410b →
5539
+ // c53378f, +6 upstream mints, 0 withdrawn upstream; @hti/scoring 9b5d654 →
5540
+ // 9c209cf, `emits_by_code` 169 → 174 (+8 / −3); the release number is
5541
+ // assigned by the standalone chore(release) commit, not claimed here).
5542
+ // Six catalog codes were missing from CVC-136 (GATE H) and three of them
5543
+ // are now EMITTED by @hti/scoring 9c209cf (GATE A). All six are carried
5544
+ // VERBATIM from the catalog's projected fields (`label` / `definition` /
5545
+ // `family` / `polarity` / `severity` / `is_alert` / `alert_when`) and
5546
+ // APPENDED at positional codes 136-217…136-222 (alphabetical by key) so
5547
+ // every previously issued code keeps its number.
5548
+ // + disclosed_fear_at_intake (CVC136-SEED-DECANON 2026-08-28,
5549
+ // Crysta R6) — "Disclosed fear of a specific person";
5550
+ // `lethality_dv` / `increases_risk` / `elevated` /
5551
+ // `isAlert: "thread_pave"` / `alertWhen: "current_only"`. Catalog-only;
5552
+ // not in `emits_by_code`.
5553
+ // + does_not_control_housing (INDICATORS-HOUSING-HOME-LIFE-2026-10-06,
5554
+ // Crysta ruling 2026-10-06: the OCAT HT-9 concept; IS-2.5.3 Tier 2
5555
+ // adults / Tier 3 minors; tree IV-B-3e) — "Limited independence: does
5556
+ // not control where they live"; `mechanism_control` / `increases_risk`
5557
+ // / `elevated` / `isAlert: "none"`. Emitted by @hti/scoring 9c209cf.
5558
+ // + oppressive_home_life (same ship; the Initial Screen's former
5559
+ // orphan, IS-2.8.1, VIII-D-1) — "Oppressive, unsafe, or unstable home
5560
+ // life"; `vulnerability_context` / `increases_risk` / `elevated` /
5561
+ // `isAlert: "none"`. Emitted by @hti/scoring 9c209cf.
5562
+ // + recent_separation (upstream mint between 622410b and
5563
+ // c53378f) — "Recent separation from abusive partner"; the catalog
5564
+ // definition grounds it in Campbell's Danger Assessment (the period
5565
+ // after separation is the highest-risk window for intimate-partner
5566
+ // homicide — the signal is about having got out, not current
5567
+ // cohabitation); `lethality_dv` / `depends` / `elevated` /
5568
+ // `isAlert: "thread_pave"` / `alertWhen: "recency_under_year"`.
5569
+ // Emitted by @hti/scoring 9c209cf.
5570
+ // + survival_sex (upstream mint between 622410b and
5571
+ // c53378f) — "Survival sex (sex exchanged to meet basic needs)"; per
5572
+ // the catalog a standalone activity signal that asserts the
5573
+ // circumstance of the exchange, never a trafficking determination;
5574
+ // `cs_industry_context` / `depends` / `elevated` / `isAlert: "none"`.
5575
+ // Catalog-only; not in `emits_by_code`.
5576
+ // + unable_to_speak_freely (upstream mint between 622410b and
5577
+ // c53378f) — "Unable to speak freely"; per the catalog, a third party
5578
+ // controls the conversation (insists on being present, answers or
5579
+ // interprets for the person, or the person is never encountered
5580
+ // alone), distinct from `inability_to_account_for_self`;
5581
+ // `mechanism_control` / `depends` / `elevated` /
5582
+ // `isAlert: "thread_pave"` / `alertWhen: "current_only"`. Catalog-only;
5583
+ // not in `emits_by_code`.
5584
+ //
5585
+ // DEPRECATED — the 2 former scoring-ahead codes. `coercive_debt_pressure_youth`
5586
+ // (136-033) and `debt_terms_deceptive_youth` (136-050) were carried since
5587
+ // 0.8.13 ONLY because @hti/scoring emitted them ahead of the catalog
5588
+ // (`pendingUpstreamAdoption: true`; `SCORING_AHEAD_OF_CATALOG` allowlist
5589
+ // in `cvc-drift-gate.test.ts`). hti-scoring 9c209cf retired both emits in
5590
+ // favour of the canonical `coercive_debt_pressure` (136-032) /
5591
+ // `debt_terms_deceptive` (136-049), whose upstream rows carry the `_youth`
5592
+ // names as `legacy_aliases`; the catalog never adopted them, so they leave
5593
+ // the allowlist (now EMPTY — the guard stays). They are NOT removed: PAVE
5594
+ // 2.0 `develop` @ 07f3ccd still WRITES both from the In-Depth Assessment
5595
+ // (`IDA-syn-missing_care-4i` / `-4ii`, `rules/assessments/ida/emits.ts`)
5596
+ // and scores them from its 2026-07-17 vendored weights, so an assertion
5597
+ // already stored under either key must keep resolving here. Both rows
5598
+ // become `selectable: false` + `deprecated: true` + `supersededBy` their
5599
+ // canonical sibling — the CVC-69 v1.1.0 shape — and stay in this array
5600
+ // and label map as VALID STORED VALUES (validate with
5601
+ // `CVC_136_CORE_INDICATOR_VALUES`; offer only
5602
+ // `ACTIVE_CVC_136_CORE_INDICATOR_VALUES`; normalise with
5603
+ // `canonicalCoreIndicator()`). Positional codes 136-033 / 136-050 are
5604
+ // HELD by the deprecated rows and never reissued. Because this refresh is
5605
+ // non-additive (two rows lose `selectable`, one definition changes) the
5606
+ // SOT file moves 1.0.0 -> 1.1.0 (seeder §9.1.2; the #188/#190 precedent).
5607
+ // Thread `develop` @ 28580ab has no writer of either key.
5608
+ //
5609
+ // PROJECTED-FIELD REVISION carried in the same refresh:
5610
+ // • `exploitative_pricing_tier_low` (136-061) — definition revised from
5611
+ // "unusually low hourly price relative to local median" to the pooled
5612
+ // ad-population baseline (parsed hourly rates under $50/hr; CVC-277
5613
+ // core-CS_price_tier_band; Sarah 2026-07-22, about the bottom
5614
+ // quartile), with the SRS "relative to the local median" framing kept
5615
+ // on record as the unbuilt per-market refinement. Catalog text verbatim.
5616
+ // `coreIndicators.pin.json` is refreshed to c53378f (220 codes) and
5617
+ // `scoringEmits.pin.json` to 9c209cf (174 codes) in the same change;
5618
+ // `cvcIndex.pin.json` stays at 622410b.
5619
+ //
5380
5620
  // CVC_136_ALERT_INDICATOR above is a legacy Thread-only surface with NO
5381
5621
  // canonical basis; it is deliberately left untouched in 0.8.13 (a separate
5382
5622
  // Thread cleanup). The canonical alert axis is the `isAlert` ATTRIBUTE on
@@ -5439,7 +5679,9 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5439
5679
  "denied_basic_needs",
5440
5680
  "depends_on_employer_for_immigration_status",
5441
5681
  "depends_on_spouse_or_family_for_immigration_status",
5682
+ "disclosed_fear_at_intake",
5442
5683
  "does_not_control_finances_or_earnings",
5684
+ "does_not_control_housing",
5443
5685
  "does_not_control_identity_documents",
5444
5686
  "elevated_lethality_risk_signal",
5445
5687
  "employer_keeps_pay_or_pays_less_than_expected",
@@ -5501,6 +5743,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5501
5743
  "new_to_commercial_sex_industry",
5502
5744
  "non_consensual_photography_or_recording",
5503
5745
  "not_in_control_of_immigration_documentation",
5746
+ "oppressive_home_life",
5504
5747
  "other_instability_or_vulnerability_factors",
5505
5748
  "owes_money_and_cannot_pay_off",
5506
5749
  "paid_or_owes_fee_to_arrange_travel_to_us",
@@ -5520,6 +5763,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5520
5763
  "promise_of_work_different_than_current_work",
5521
5764
  "received_things_of_value_while_missing_from_care",
5522
5765
  "recent_le_engagement",
5766
+ "recent_separation",
5523
5767
  "recruited_by_third_party_into_cs_industry",
5524
5768
  "regular_alcohol_use",
5525
5769
  "relies_on_temporary_resources_for_basic_needs",
@@ -5567,6 +5811,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5567
5811
  "suicidal_ideation_history",
5568
5812
  "suicidal_ideation_recent",
5569
5813
  "suicide_attempt_history",
5814
+ "survival_sex",
5570
5815
  "third_party_advertises_or_posts_for_person",
5571
5816
  "third_party_arranged_commercial_sex_acts",
5572
5817
  "threats_by_employer_or_partner",
@@ -5582,6 +5827,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5582
5827
  "trauma_perpetrator_is_current_manager",
5583
5828
  "travel_organized_by_third_party",
5584
5829
  "tricked_or_pressured_into_unwanted_acts",
5830
+ "unable_to_speak_freely",
5585
5831
  "under_18_advertised_age",
5586
5832
  "under_18_appears_underage",
5587
5833
  "under_18_known_age",
@@ -5661,7 +5907,9 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5661
5907
  "denied_basic_needs": "Denied basic needs (food, water, sleep, medical care)",
5662
5908
  "depends_on_employer_for_immigration_status": "Depends on employer for immigration status (tied visa / living with employer)",
5663
5909
  "depends_on_spouse_or_family_for_immigration_status": "Depends on spouse / family member for immigration status (tied family visa)",
5910
+ "disclosed_fear_at_intake": "Disclosed fear of a specific person",
5664
5911
  "does_not_control_finances_or_earnings": "Limited independence: does not control finances or earnings",
5912
+ "does_not_control_housing": "Limited independence: does not control where they live",
5665
5913
  "does_not_control_identity_documents": "Limited independence: does not control identity documents",
5666
5914
  "elevated_lethality_risk_signal": "Elevated lethality risk",
5667
5915
  "employer_keeps_pay_or_pays_less_than_expected": "Employer keeps portion of pay or pays less than expected",
@@ -5723,6 +5971,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5723
5971
  "new_to_commercial_sex_industry": "New to commercial sex industry (recent entry / early experience)",
5724
5972
  "non_consensual_photography_or_recording": "Non-consensual photography or recording",
5725
5973
  "not_in_control_of_immigration_documentation": "Not in control of immigration documentation",
5974
+ "oppressive_home_life": "Oppressive, unsafe, or unstable home life",
5726
5975
  "other_instability_or_vulnerability_factors": "Other instability/vulnerability factors (general)",
5727
5976
  "owes_money_and_cannot_pay_off": "Unusual work circumstances: owes money and cannot pay it off (debt pressure)",
5728
5977
  "paid_or_owes_fee_to_arrange_travel_to_us": "Paid or owes fee to arrange travel to U.S. (migration debt)",
@@ -5742,6 +5991,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5742
5991
  "promise_of_work_different_than_current_work": "Promise of work differed from current work (migration deception)",
5743
5992
  "received_things_of_value_while_missing_from_care": "Received money, drugs, or other things of value from someone while missing from care (youth)",
5744
5993
  "recent_le_engagement": "Recent law enforcement engagement",
5994
+ "recent_separation": "Recent separation from abusive partner",
5745
5995
  "recruited_by_third_party_into_cs_industry": "Recruited by another person/entity into commercial sex industry",
5746
5996
  "regular_alcohol_use": "Regular alcohol use",
5747
5997
  "relies_on_temporary_resources_for_basic_needs": "Does not consistently meet basic needs / relies on temporary resources",
@@ -5789,6 +6039,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5789
6039
  "suicidal_ideation_history": "Suicidal ideation (past)",
5790
6040
  "suicidal_ideation_recent": "Suicidal ideation (recent)",
5791
6041
  "suicide_attempt_history": "Past suicide attempt disclosed",
6042
+ "survival_sex": "Survival sex (sex exchanged to meet basic needs)",
5792
6043
  "third_party_advertises_or_posts_for_person": "Third party posts or manages the person's commercial-sex ads",
5793
6044
  "third_party_arranged_commercial_sex_acts": "Someone else arranged commercial sex acts (posting, scheduling, managing)",
5794
6045
  "threats_by_employer_or_partner": "Threats by employer/partner (general)",
@@ -5804,6 +6055,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5804
6055
  "trauma_perpetrator_is_current_manager": "Trauma perpetrator is a current manager / facilitator (trauma-bonded control)",
5805
6056
  "travel_organized_by_third_party": "Travel organized by a third party (sex provider does not control own movement)",
5806
6057
  "tricked_or_pressured_into_unwanted_acts": "Tricked or pressured into unwanted acts or activities (generic coercion)",
6058
+ "unable_to_speak_freely": "Unable to speak freely",
5807
6059
  "under_18_advertised_age": "Under 18 (ad-derived / advertised age)",
5808
6060
  "under_18_appears_underage": "Under 18 (appears underage; investigator assessment)",
5809
6061
  "under_18_known_age": "Under 18 (known age)",
@@ -5824,6 +6076,72 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5824
6076
  "youth_watched_filmed_or_photographed_sexually_explicit": "Watched, filmed, or photographed in sexually explicit manner (youth)",
5825
6077
  };
5826
6078
 
6079
+ /**
6080
+ * The CVC-136 keys deprecated on 2026-10-06, each mapped to its canonical
6081
+ * successor (SOT `coreIndicators.v1.1.0.json`: `deprecated: true` +
6082
+ * `supersededBy`). The CVC-69 `INCIDENT_PARTICIPATION_ROLE_SUPERSEDED_BY`
6083
+ * shape.
6084
+ *
6085
+ * A deprecated key is still a VALID STORED VALUE: it stays in
6086
+ * `CVC_136_CORE_INDICATOR_VALUES`, keeps its label, and still resolves in the
6087
+ * seeded registry — nothing persisted has to be rewritten. It is only no
6088
+ * longer offered for NEW writes (`selectable: false` in the SOT;
6089
+ * `ACTIVE_CVC_136_CORE_INDICATOR_VALUES` below). PAVE 2.0 `develop` still
6090
+ * emits both from the IDA; until that emitter binds the canonical key, a
6091
+ * reader that groups or scores by indicator should pass stored values
6092
+ * through `canonicalCoreIndicator()`.
6093
+ *
6094
+ * The mapping follows the canonical catalog, which carries each `_youth` name
6095
+ * as a `legacy_alias` of the successor row: the meaning is the same pattern
6096
+ * (coercive debt repayment / deceptive debt terms) with the youth
6097
+ * missing-from-care context moved off the code and onto the instrument.
6098
+ */
6099
+ export const CVC_136_CORE_INDICATOR_SUPERSEDED_BY = {
6100
+ coercive_debt_pressure_youth: "coercive_debt_pressure",
6101
+ debt_terms_deceptive_youth: "debt_terms_deceptive",
6102
+ } as const satisfies Partial<Record<CVC136CoreIndicator, CVC136CoreIndicator>>;
6103
+
6104
+ export type DeprecatedCVC136CoreIndicator =
6105
+ keyof typeof CVC_136_CORE_INDICATOR_SUPERSEDED_BY;
6106
+
6107
+ /** `true` iff `code` is a deprecated (read-only, superseded) CVC-136 key. */
6108
+ export function isDeprecatedCoreIndicator(
6109
+ code: unknown,
6110
+ ): code is DeprecatedCVC136CoreIndicator {
6111
+ return (
6112
+ typeof code === "string" &&
6113
+ Object.prototype.hasOwnProperty.call(CVC_136_CORE_INDICATOR_SUPERSEDED_BY, code)
6114
+ );
6115
+ }
6116
+
6117
+ /**
6118
+ * The canonical CVC-136 key for a stored value: the successor of a deprecated
6119
+ * key, otherwise the value unchanged. Pure; never validates — an unknown
6120
+ * string is returned as-is.
6121
+ */
6122
+ export function canonicalCoreIndicator<T extends string>(
6123
+ code: T,
6124
+ ): T | CVC136CoreIndicator {
6125
+ return isDeprecatedCoreIndicator(code)
6126
+ ? CVC_136_CORE_INDICATOR_SUPERSEDED_BY[code]
6127
+ : code;
6128
+ }
6129
+
6130
+ /** A CVC-136 key that may be written fresh: any value except the deprecated keys. */
6131
+ export type ActiveCVC136CoreIndicator = Exclude<
6132
+ CVC136CoreIndicator,
6133
+ DeprecatedCVC136CoreIndicator
6134
+ >;
6135
+
6136
+ /**
6137
+ * Every CVC-136 key that may be WRITTEN fresh: `CVC_136_CORE_INDICATOR_VALUES`
6138
+ * minus the deprecated keys. Use `CVC_136_CORE_INDICATOR_VALUES` to VALIDATE
6139
+ * stored values.
6140
+ */
6141
+ export const ACTIVE_CVC_136_CORE_INDICATOR_VALUES = CVC_136_CORE_INDICATOR_VALUES.filter(
6142
+ (v): v is ActiveCVC136CoreIndicator => !isDeprecatedCoreIndicator(v),
6143
+ );
6144
+
5827
6145
  // ─── CVC-67: HMIS Sex ────────────────────────────────────────────────────────
5828
6146
  // Biological sex for HMIS (Homeless Management Information System) reporting.
5829
6147
  // HUD 4.21 mapping - single select. Effective Oct 1, 2025.
@@ -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,7 +1,7 @@
1
1
  {
2
2
  "domain": "highest_education_level_completed",
3
3
  "name": "Core Highest Education Level Completed",
4
- "version": "1.0.0",
4
+ "version": "1.1.0",
5
5
  "levels": {
6
6
  "0": "Unknown or Missing",
7
7
  "1": "Education level"