@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.
- package/dist/constants/index.cjs +106 -0
- package/dist/constants/index.cjs.map +1 -1
- package/dist/constants/index.d.cts +1 -1
- package/dist/constants/index.d.ts +1 -1
- package/dist/constants/index.js +98 -0
- package/dist/constants/index.js.map +1 -1
- package/dist/{cvcEntry-ctHTp2df.d.cts → cvcEntry-0BIB9sen.d.cts} +36 -36
- package/dist/{cvcEntry-ctHTp2df.d.ts → cvcEntry-0BIB9sen.d.ts} +36 -36
- package/dist/cvcs/index.cjs +562 -120
- package/dist/cvcs/index.cjs.map +1 -1
- package/dist/cvcs/index.d.cts +589 -121
- package/dist/cvcs/index.d.ts +589 -121
- package/dist/cvcs/index.js +562 -120
- package/dist/cvcs/index.js.map +1 -1
- package/dist/enums/index.cjs +22 -2
- package/dist/enums/index.cjs.map +1 -1
- package/dist/enums/index.d.cts +29 -9
- package/dist/enums/index.d.ts +29 -9
- package/dist/enums/index.js +22 -2
- package/dist/enums/index.js.map +1 -1
- package/dist/{index-4DiJrn7y.d.ts → index-CDoqrfc1.d.ts} +1 -1
- package/dist/{index-qreOzXYS.d.cts → index-Zu_mOJRn.d.cts} +1 -1
- package/dist/index.cjs +690 -122
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.js +682 -122
- package/dist/index.js.map +1 -1
- package/dist/models/index.d.cts +2 -2
- package/dist/models/index.d.ts +2 -2
- package/dist/{platform-auth-Dv5fu0Fh.d.cts → platform-auth-CrF5U_JH.d.cts} +113 -3
- package/dist/{platform-auth-Dv5fu0Fh.d.ts → platform-auth-CrF5U_JH.d.ts} +113 -3
- package/dist/schemas/index.cjs +296 -0
- package/dist/schemas/index.cjs.map +1 -1
- package/dist/schemas/index.d.cts +11 -11
- package/dist/schemas/index.d.ts +11 -11
- package/dist/schemas/index.js +296 -0
- package/dist/schemas/index.js.map +1 -1
- package/dist/types/index.d.cts +2 -2
- package/dist/types/index.d.ts +2 -2
- package/package.json +26 -27
- package/src/__sot__/coreIndicatorFields.ts +4 -4
- package/src/__sot__/coreIndicators.pin.json +62 -2
- package/src/__sot__/scoringEmits.pin.json +9 -4
- package/src/__tests__/__snapshots__/cvc-sot.snap +11 -11
- package/src/__tests__/cvc-136-scoring-invariant.test.ts +89 -28
- package/src/__tests__/cvc-drift-gate.test.ts +165 -32
- package/src/__tests__/cvc-sot-snapshot.test.ts +21 -12
- package/src/__tests__/cvc-structural.test.ts +8 -8
- package/src/__tests__/incident-participation-roles-canon.test.ts +424 -0
- package/src/__tests__/referral-entity-category-canon.test.ts +383 -0
- package/src/constants/ic.ts +321 -3
- package/src/cvcs/{coreIndicators.v1.0.0.json → coreIndicators.v1.1.0.json} +93 -10
- package/src/cvcs/{highestEducationLevelCompleted.v1.0.0.json → highestEducationLevelCompleted.v1.1.0.json} +1 -1
- package/src/cvcs/incidentParticipationRoles.v1.1.0.json +433 -0
- package/src/cvcs/{incomeBenefitsSources.v1.0.0.json → incomeBenefitsSources.v1.1.0.json} +1 -1
- package/src/cvcs/index.ts +8 -8
- package/src/cvcs/{referralEntityCategory.v1.0.0.json → referralEntityCategory.v1.1.0.json} +192 -54
- package/src/cvcs/{serviceStates.v1.0.0.json → serviceStates.v1.1.0.json} +1 -1
- package/src/cvcs/{sourceSubtype.v1.1.0.json → sourceSubtype.v1.2.0.json} +1 -1
- package/src/cvcs/{verificationMethod.v1.0.0.json → verificationMethod.v1.1.0.json} +1 -1
- package/src/generated/cvc-enums.ts +29 -9
- package/src/cvcs/incidentParticipationRoles.v1.0.0.json +0 -212
package/src/constants/ic.ts
CHANGED
|
@@ -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,
|
|
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.
|
|
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.
|
|
5
|
-
"_status": "CANONICAL — re-sourced from the live canonical catalog `data/core_indicators.yaml` @ prototype HEAD
|
|
6
|
-
"_source": "htilabstech/prototype@
|
|
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":
|
|
483
|
+
"selectable": false,
|
|
484
484
|
"parentCode": null,
|
|
485
485
|
"childCodes": [],
|
|
486
|
-
"definition": "
|
|
487
|
-
"
|
|
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":
|
|
706
|
+
"selectable": false,
|
|
706
707
|
"parentCode": null,
|
|
707
708
|
"childCodes": [],
|
|
708
|
-
"definition": "
|
|
709
|
-
"
|
|
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
|
|
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
|
}
|