@htilabs/platform-common-models 0.12.0 → 0.12.2

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 (99) hide show
  1. package/dist/config/index.cjs +0 -81
  2. package/dist/config/index.cjs.map +1 -1
  3. package/dist/config/index.d.cts +4 -79
  4. package/dist/config/index.d.ts +4 -79
  5. package/dist/config/index.js +1 -79
  6. package/dist/config/index.js.map +1 -1
  7. package/dist/constants/index.cjs +18 -2
  8. package/dist/constants/index.cjs.map +1 -1
  9. package/dist/constants/index.d.cts +1 -1
  10. package/dist/constants/index.d.ts +1 -1
  11. package/dist/constants/index.js +18 -2
  12. package/dist/constants/index.js.map +1 -1
  13. package/dist/cvc-Cp4uWnAa.d.cts +298 -0
  14. package/dist/cvc-Cp4uWnAa.d.ts +298 -0
  15. package/dist/{cvcEntry-BCj1OWqL.d.cts → cvcEntry-ctHTp2df.d.cts} +44 -44
  16. package/dist/{cvcEntry-BCj1OWqL.d.ts → cvcEntry-ctHTp2df.d.ts} +44 -44
  17. package/dist/cvcs/index.cjs +8065 -1384
  18. package/dist/cvcs/index.cjs.map +1 -1
  19. package/dist/cvcs/index.d.cts +15287 -8079
  20. package/dist/cvcs/index.d.ts +15287 -8079
  21. package/dist/cvcs/index.js +8052 -1384
  22. package/dist/cvcs/index.js.map +1 -1
  23. package/dist/enums/index.cjs +4573 -0
  24. package/dist/enums/index.cjs.map +1 -0
  25. package/dist/enums/index.d.cts +5277 -0
  26. package/dist/enums/index.d.ts +5277 -0
  27. package/dist/enums/index.js +4369 -0
  28. package/dist/enums/index.js.map +1 -0
  29. package/dist/{index-I-DiX9eQ.d.ts → index-4DiJrn7y.d.ts} +1 -1
  30. package/dist/{index-CoVr1jIV.d.cts → index-qreOzXYS.d.cts} +1 -1
  31. package/dist/index.cjs +8616 -1389
  32. package/dist/index.cjs.map +1 -1
  33. package/dist/index.d.cts +7 -4700
  34. package/dist/index.d.ts +7 -4700
  35. package/dist/index.js +8590 -1389
  36. package/dist/index.js.map +1 -1
  37. package/dist/models/index.d.cts +2 -2
  38. package/dist/models/index.d.ts +2 -2
  39. package/dist/mongo/index.cjs +0 -1
  40. package/dist/mongo/index.cjs.map +1 -1
  41. package/dist/mongo/index.js +1 -2
  42. package/dist/mongo/index.js.map +1 -1
  43. package/dist/{platform-auth-v53r3BhN.d.cts → platform-auth-Dv5fu0Fh.d.cts} +5 -4
  44. package/dist/{platform-auth-v53r3BhN.d.ts → platform-auth-Dv5fu0Fh.d.ts} +5 -4
  45. package/dist/schemas/index.cjs +5 -1
  46. package/dist/schemas/index.cjs.map +1 -1
  47. package/dist/schemas/index.d.cts +35 -35
  48. package/dist/schemas/index.d.ts +35 -35
  49. package/dist/schemas/index.js +5 -1
  50. package/dist/schemas/index.js.map +1 -1
  51. package/dist/types/index.d.cts +2 -2
  52. package/dist/types/index.d.ts +2 -2
  53. package/dist/validation/index.cjs +58 -0
  54. package/dist/validation/index.cjs.map +1 -1
  55. package/dist/validation/index.d.cts +82 -283
  56. package/dist/validation/index.d.ts +82 -283
  57. package/dist/validation/index.js +57 -0
  58. package/dist/validation/index.js.map +1 -1
  59. package/package.json +32 -22
  60. package/src/__sot__/README.md +36 -1
  61. package/src/__sot__/coreIndicatorFields.ts +331 -0
  62. package/src/__sot__/coreIndicators.pin.json +1936 -2
  63. package/src/__sot__/cvcIndex.pin.json +8 -4
  64. package/src/__tests__/__snapshots__/cvc-sot.snap +45 -13
  65. package/src/__tests__/core-information-scope-invariant.test.ts +134 -0
  66. package/src/__tests__/cvc-136-scoring-invariant.test.ts +8 -3
  67. package/src/__tests__/cvc-181-182-country-parity.test.ts +163 -0
  68. package/src/__tests__/cvc-drift-gate.test.ts +463 -12
  69. package/src/__tests__/cvc-sot-snapshot.test.ts +81 -11
  70. package/src/__tests__/cvc-status-parser.test.ts +150 -0
  71. package/src/__tests__/cvc-structural.test.ts +16 -0
  72. package/src/__tests__/runtime-contract-validator.test.ts +1 -325
  73. package/src/__tests__/share-response-reason-invariant.test.ts +167 -0
  74. package/src/config/index.ts +4 -189
  75. package/src/constants/ic.ts +120 -3
  76. package/src/cvcs/assertionDomain.v1.1.0.json +19 -1
  77. package/src/cvcs/assertionStatus.v1.0.0.json +80 -0
  78. package/src/cvcs/carCorrectionReason.v1.0.0.json +89 -0
  79. package/src/cvcs/caseShareState.v1.0.0.json +62 -0
  80. package/src/cvcs/coreIndicators.v1.0.0.json +83 -5
  81. package/src/cvcs/coreInformationScope.v1.0.0.json +1165 -0
  82. package/src/cvcs/countries.v1.0.0.json +3077 -0
  83. package/src/cvcs/createdBySystem.v1.0.0.json +89 -0
  84. package/src/cvcs/criminalOrgCategory.v1.0.0.json +116 -0
  85. package/src/cvcs/determinationHelperCategories.v1.0.0.json +1166 -0
  86. package/src/cvcs/incidentParticipationRoles.v1.0.0.json +11 -1
  87. package/src/cvcs/index.ts +36 -0
  88. package/src/cvcs/minorAdultStatus.v1.0.0.json +80 -0
  89. package/src/cvcs/personRelationships.v1.0.0.json +67 -2
  90. package/src/cvcs/referralOrigin.v1.0.0.json +26 -0
  91. package/src/cvcs/relationshipConcern.v1.0.0.json +28 -19
  92. package/src/cvcs/riskIdentificationMilestone.v1.0.0.json +109 -0
  93. package/src/cvcs/sessionTemplate.v1.0.0.json +22 -0
  94. package/src/cvcs/sharePurpose.v1.0.0.json +80 -12
  95. package/src/cvcs/shareResponseReason.v1.0.0.json +220 -0
  96. package/src/cvcs/subjectType.v1.0.0.json +80 -0
  97. package/src/generated/cvc-enums.ts +628 -20
  98. package/src/validation/cvcStatus.ts +209 -0
  99. package/src/validation/index.ts +1 -0
@@ -9,16 +9,6 @@
9
9
  * any other initialization that reads env vars. Build-phase variables
10
10
  * (phase: build) are NOT checked at runtime per R3.4.
11
11
  *
12
- * validateAgainstContract also LOADS config, not just validates it: it applies
13
- * the contract's per-tier defaults into process.env so that code reading
14
- * process.env.FOO directly sees the same value the validator resolved. This is
15
- * what removes the need for a materialized `.env.generated` file in local dev.
16
- *
17
- * Precedence, highest first:
18
- * 1. .env.local — local developer overrides; beat everything
19
- * 2. process.env — real deployed / materialized task-def values
20
- * 3. contract default — spec.default[<tier>]
21
- *
22
12
  * No secret VALUES are read, stored, or returned here. Secret env vars are
23
13
  * validated for presence but their values are never logged or exposed.
24
14
  *
@@ -26,9 +16,7 @@
26
16
  * const { validateAgainstContract } = require('@htilabs/platform-common-models/config');
27
17
  */
28
18
 
29
- import { existsSync, readFileSync } from "node:fs";
30
- import { join } from "node:path";
31
-
19
+ import { readFileSync } from "node:fs";
32
20
  import { parse } from "yaml";
33
21
 
34
22
  // ─── Schema types (mirrors thread's runtime-config-lib.ts VariableSpec) ──────
@@ -77,22 +65,6 @@ export interface ValidateOptions {
77
65
  * Useful for tests. Defaults to false (production mode exits).
78
66
  */
79
67
  throwOnFailure?: boolean;
80
- /**
81
- * Apply the contract's defaults for the resolved env into process.env for
82
- * every runtime variable that is not already set. Defaults to true.
83
- * An existing process.env value is never overwritten.
84
- */
85
- applyDefaults?: boolean;
86
- /**
87
- * Load `.env.local` and apply it over process.env before anything else.
88
- * Defaults to true; the file is optional, so a missing file is a no-op.
89
- */
90
- applyEnvLocal?: boolean;
91
- /**
92
- * Explicit path to the `.env.local` override file.
93
- * Defaults to `<process.cwd()>/.env.local`.
94
- */
95
- envLocalPath?: string;
96
68
  }
97
69
 
98
70
  export interface EndpointOptions {
@@ -216,160 +188,12 @@ export function resolveDefault(
216
188
  return String(v);
217
189
  }
218
190
 
219
- /**
220
- * Write the contract's defaults for `env` into process.env for every
221
- * runtime-phase variable that is not already set.
222
- *
223
- * A value already present in process.env — a real deployed env var, or one
224
- * materialized into a task definition — always wins and is left untouched.
225
- * An explicitly empty value ("") counts as present: it is a deliberate
226
- * choice by whoever set it, and the required-variable check still rejects it.
227
- *
228
- * Build-phase variables are skipped (R3.4); secret variables are NOT skipped,
229
- * so process.env agrees with the value the validator itself resolved. Secret
230
- * values are never logged.
231
- *
232
- * Returns the names of the variables that were applied.
233
- */
234
- export function applyContractDefaults(
235
- contract: ServiceContract,
236
- env: string,
237
- ): string[] {
238
- const applied: string[] = [];
239
-
240
- for (const [key, spec] of Object.entries(contract.variables)) {
241
- if (spec.phase === "build") continue;
242
- if (process.env[key] !== undefined) continue;
243
-
244
- const value = resolveDefault(spec, env);
245
- if (value === undefined) continue;
246
-
247
- process.env[key] = value;
248
- applied.push(key);
249
- }
250
-
251
- return applied;
252
- }
253
-
254
- // ─── .env.local overrides ────────────────────────────────────────────────────
255
-
256
- /** `KEY=`, `export KEY=`; everything after the first `=` is the raw value. */
257
- const DOTENV_LINE = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=(.*)$/;
258
-
259
- /** Index of the next `quote` not preceded by a backslash, or -1. */
260
- function indexOfUnescaped(s: string, quote: string): number {
261
- for (let i = 0; i < s.length; i += 1) {
262
- if (s[i] === "\\") {
263
- i += 1;
264
- continue;
265
- }
266
- if (s[i] === quote) return i;
267
- }
268
- return -1;
269
- }
270
-
271
- /**
272
- * Parse `.env` file content into a plain object.
273
- *
274
- * Supported: blank lines, `#` comments, an optional `export ` prefix,
275
- * single-quoted / double-quoted / backtick-quoted values (which may span
276
- * multiple lines), and `\n` `\r` `\t` `\\` escapes inside double quotes.
277
- * An unquoted value ends at a ` #` inline comment, so `#` may still be used
278
- * freely inside a quoted value or in the middle of a bare word.
279
- *
280
- * Malformed lines are skipped rather than thrown on: a typo in a developer's
281
- * local override file should not take down the whole process.
282
- */
283
- export function parseDotenv(content: string): Record<string, string> {
284
- const out: Record<string, string> = {};
285
- const lines = content.split(/\r?\n/);
286
-
287
- for (let i = 0; i < lines.length; i += 1) {
288
- const trimmed = lines[i].trim();
289
- if (trimmed === "" || trimmed.startsWith("#")) continue;
290
-
291
- const match = DOTENV_LINE.exec(trimmed);
292
- if (!match) continue;
293
-
294
- const key = match[1];
295
- const rest = match[2].trim();
296
- const quote = rest.charAt(0);
297
-
298
- if (quote === '"' || quote === "'" || quote === "`") {
299
- // Quoted value — keep consuming lines until the closing quote.
300
- let body = rest.slice(1);
301
- let end = indexOfUnescaped(body, quote);
302
- while (end === -1 && i + 1 < lines.length) {
303
- i += 1;
304
- body += `\n${lines[i]}`;
305
- end = indexOfUnescaped(body, quote);
306
- }
307
- if (end === -1) continue; // unterminated quote — skip the entry
308
-
309
- const value = body.slice(0, end);
310
- out[key] =
311
- quote === '"'
312
- ? value
313
- .replace(/\\n/g, "\n")
314
- .replace(/\\r/g, "\r")
315
- .replace(/\\t/g, "\t")
316
- .replace(/\\"/g, '"')
317
- .replace(/\\\\/g, "\\")
318
- : value;
319
- continue;
320
- }
321
-
322
- out[key] = rest.split(/\s+#/)[0].trimEnd();
323
- }
324
-
325
- return out;
326
- }
327
-
328
- /**
329
- * Apply `.env.local` over process.env.
330
- *
331
- * `.env.local` has the last word in local development: it overwrites values
332
- * already present in process.env, and it runs before defaults are applied, so
333
- * it also beats every contract default. It may declare variables the contract
334
- * does not know about — a developer can add config without editing the
335
- * contract. The file is optional; a missing file is a no-op.
336
- *
337
- * Returns the names of the variables that were applied.
338
- */
339
- export function applyEnvLocal(path?: string): string[] {
340
- const file = path ?? join(process.cwd(), ".env.local");
341
- if (!existsSync(file)) return [];
342
-
343
- let raw: string;
344
- try {
345
- raw = readFileSync(file, "utf8");
346
- } catch (err) {
347
- const msg = err instanceof Error ? err.message : String(err);
348
- throw new Error(`[platform-common/config] Cannot read ${file}: ${msg}`);
349
- }
350
-
351
- const parsed = parseDotenv(raw);
352
- for (const [key, value] of Object.entries(parsed)) {
353
- process.env[key] = value;
354
- }
355
-
356
- return Object.keys(parsed);
357
- }
358
-
359
191
  // ─── validateAgainstContract ─────────────────────────────────────────────────
360
192
 
361
193
  /**
362
- * Parse `runtimeYamlPath`, load config into `process.env`, coerce every
363
- * runtime-phase variable, and fail fast on any missing or invalid required
364
- * variable (R3.2).
365
- *
366
- * Loading happens before validation, in precedence order:
367
- * 1. `.env.local` is applied over process.env (opts.applyEnvLocal)
368
- * 2. contract defaults for the resolved env fill anything still unset
369
- * (opts.applyDefaults)
370
- *
371
- * `.env.local` is applied first so a developer can set NODE_ENV there and
372
- * have it select the tier whose defaults are applied.
194
+ * Parse `runtimeYamlPath`, coerce every runtime-phase variable from
195
+ * `process.env` (with per-env defaults applied), and fail fast on any
196
+ * missing or invalid required variable (R3.2).
373
197
  *
374
198
  * Build-phase variables (phase: build) are skipped per R3.4.
375
199
  *
@@ -380,20 +204,11 @@ export function validateAgainstContract(
380
204
  opts: ValidateOptions = {},
381
205
  ): TypedConfig {
382
206
  const contract = loadContract(runtimeYamlPath);
383
-
384
- if (opts.applyEnvLocal !== false) {
385
- applyEnvLocal(opts.envLocalPath);
386
- }
387
-
388
207
  const env =
389
208
  opts.env ??
390
209
  (process.env.NODE_ENV as string | undefined) ??
391
210
  "local";
392
211
 
393
- if (opts.applyDefaults !== false) {
394
- applyContractDefaults(contract, env);
395
- }
396
-
397
212
  const errors: string[] = [];
398
213
  const result: TypedConfig = {};
399
214
 
@@ -1986,6 +1986,7 @@ export const INCIDENT_PARTICIPATION_ROLE = {
1986
1986
  DATA_ENTRY: "data_entry",
1987
1987
  OTHER_INCIDENT_RESPONDER: "other_incident_responder",
1988
1988
  RESPONDING_OFFICER: "responding_officer",
1989
+ LEGAL_PROFESSIONAL: "legal_professional",
1989
1990
  UNKNOWN: "unknown",
1990
1991
  ANONYMOUS: "anonymous",
1991
1992
  DATA_NOT_COLLECTED: "data_not_collected",
@@ -2006,6 +2007,7 @@ export const INCIDENT_PARTICIPATION_ROLE_VALUES = [
2006
2007
  INCIDENT_PARTICIPATION_ROLE.DATA_ENTRY,
2007
2008
  INCIDENT_PARTICIPATION_ROLE.OTHER_INCIDENT_RESPONDER,
2008
2009
  INCIDENT_PARTICIPATION_ROLE.RESPONDING_OFFICER,
2010
+ INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL,
2009
2011
  INCIDENT_PARTICIPATION_ROLE.UNKNOWN,
2010
2012
  INCIDENT_PARTICIPATION_ROLE.ANONYMOUS,
2011
2013
  INCIDENT_PARTICIPATION_ROLE.DATA_NOT_COLLECTED,
@@ -2030,6 +2032,7 @@ export const INCIDENT_PARTICIPATION_ROLE_LABELS: Record<
2030
2032
  [INCIDENT_PARTICIPATION_ROLE.OTHER_INCIDENT_RESPONDER]:
2031
2033
  "VSP or Other Incident Responder",
2032
2034
  [INCIDENT_PARTICIPATION_ROLE.RESPONDING_OFFICER]: "LE Responding Officer",
2035
+ [INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL]: "Legal Professional",
2033
2036
  [INCIDENT_PARTICIPATION_ROLE.UNKNOWN]: "Unknown",
2034
2037
  [INCIDENT_PARTICIPATION_ROLE.ANONYMOUS]: "Anonymous",
2035
2038
  [INCIDENT_PARTICIPATION_ROLE.DATA_NOT_COLLECTED]: "Not Collected",
@@ -2056,6 +2059,7 @@ export const PARTICIPATION_ROLE_CATEGORIES = {
2056
2059
  SYSTEM_PROFESSIONAL: [
2057
2060
  INCIDENT_PARTICIPATION_ROLE.SERVICE_PROVIDER_STAFF,
2058
2061
  INCIDENT_PARTICIPATION_ROLE.MEDICAL_PROVIDER_STAFF,
2062
+ INCIDENT_PARTICIPATION_ROLE.LEGAL_PROFESSIONAL,
2059
2063
  ],
2060
2064
  } as const;
2061
2065
 
@@ -2632,6 +2636,20 @@ export const CVC_122_LABELS: Record<CVC122Value, string> = {
2632
2636
 
2633
2637
  // ─── CVC-181: Countries (ISO 3166-1 alpha-2) ────────────────────────
2634
2638
  // Full list of countries using ISO 3166-1 alpha-2 codes.
2639
+ //
2640
+ // AS OF 2026-08-26 THE SOT IS `src/cvcs/countries.v1.0.0.json`, authored from the
2641
+ // canonical `core - countries — codebook 2.csv`. These two constants predate it and
2642
+ // are RETAINED for existing consumers; new code should import `CountryKeys` from
2643
+ // `src/generated/cvc-enums.ts` (or `countriesSot`) instead.
2644
+ //
2645
+ // The ISO SET here is exact — all 249 codes, no additions, no omissions, verified
2646
+ // against the codebook. `CVC_181_LABELS`, however, carries SHORT-FORM display labels
2647
+ // that differ from the canonical label on 16 codes: BO, CD, IR, KP, KR, LA, MK, FM,
2648
+ // MD, PS, SH, SY, TW, TZ, VE, VN ("Vietnam" vs "Viet Nam", "Korea, South" vs "Korea,
2649
+ // Republic of", …). The SOT JSON carries the canonical spelling verbatim in both
2650
+ // `title` and `canonicalLabel`. That divergence is display-only — nothing keys off
2651
+ // these strings — but it is real, and collapsing the two surfaces onto one label set
2652
+ // is its own decision (a visible UI change), deliberately not made here.
2635
2653
 
2636
2654
  export const CVC_181_COUNTRIES = {
2637
2655
  US: "US",
@@ -5245,10 +5263,10 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5245
5263
  categoryLabel: CVC_136_CATEGORY_LABELS[category],
5246
5264
  }));
5247
5265
 
5248
- // ─── CVC-136: full core-indicators value set (CANONICAL, 210 codes) ─────
5266
+ // ─── CVC-136: full core-indicators value set (CANONICAL, 216 codes) ─────
5249
5267
  // The complete CVC-136 'core - indicators' vocabulary. As of 0.8.13 the
5250
5268
  // AUTHORITATIVE surface for this domain is the SOT JSON
5251
- // `src/cvcs/coreIndicators.v1.0.0.json` (214 entries = 210 substantive + the
5269
+ // `src/cvcs/coreIndicators.v1.0.0.json` (220 entries = 216 substantive + the
5252
5270
  // missingness quadruplet), which also carries the canonical `family`,
5253
5271
  // `polarity`, `severity`, `isAlert` and `alertWhen` entry attributes. This
5254
5272
  // hand-coded array is kept in lockstep with that JSON as a flat key list for
@@ -5272,6 +5290,93 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5272
5290
  // `emits_by_code` (weights/risk.weights.json @ 9b5d654) is present here.
5273
5291
  // Enforced by `src/__tests__/cvc-136-scoring-invariant.test.ts`.
5274
5292
  //
5293
+ // 0.8.14 — 210 → 215 (catalog refresh, prototype a596eb9 → 84a1b677).
5294
+ // The upstream catalog grew by 5 and withdrew none. All five are minted
5295
+ // upstream with `code_status: canonical` (three carry the 2026-07-17
5296
+ // TRA-vetting provenance), so this is catalog CATCH-UP, not invention —
5297
+ // GATE B in `cvc-drift-gate.test.ts` flagged them only because the pin was
5298
+ // stale. `coreIndicators.pin.json` is refreshed to 84a1b677 (213 codes) in
5299
+ // the same change; the 2 scoring-ahead codes remain absent upstream and
5300
+ // stay on the `SCORING_AHEAD_OF_CATALOG` allowlist, unchanged.
5301
+ // + clients_unaware_of_third_party_coordination (TRA-7-aware)
5302
+ // + depends_on_spouse_or_family_for_immigration_status (TRA-14 × TRA-22)
5303
+ // + sexualized_content_in_person_performance_activity (DH § II 2.2.3)
5304
+ // + sexualized_content_online_performance_activity (DH § II 2.2.2)
5305
+ // + trauma_perpetrator_is_current_manager (engine-derived)
5306
+ // PAVE 2.0 needs the first two to express `trafficking_risk_assessment`
5307
+ // emissions; without them the TRA writes assertions against codes that
5308
+ // resolve to nothing.
5309
+ // New SOT entries are APPENDED at positional codes 136-211…136-215 so
5310
+ // every previously issued code keeps its number.
5311
+ //
5312
+ // Refresh to 622410b — 215 → 216 (catalog refresh, prototype 84a1b67 →
5313
+ // 622410b; the release number is assigned by the standalone chore(release)
5314
+ // commit, not claimed here).
5315
+ // The upstream catalog grew by 1 and withdrew none, so this is again
5316
+ // catalog CATCH-UP rather than net-new authoring: GATE B would have
5317
+ // reported the code as INVENTED only because the pin was stale.
5318
+ // + active_protective_order (AE-3 / q-ar-3)
5319
+ // Minted upstream 2026-08-08 with `code_status: canonical` (prototype
5320
+ // `4b3d40e4`, "Catalogue the protective-order disclosure"), emitted by the
5321
+ // INTAKE_MAP on `q-ar-3 == yes`. Definition, `family`, `polarity`,
5322
+ // `severity` and `is_alert` are carried VERBATIM from the catalog:
5323
+ // `lethality_dv` / `depends` / `caution` / `none`. The `isAlert: "none"`
5324
+ // is load-bearing and deliberate — per the Crysta ruling of 2026-08-08 the
5325
+ // code is catalogued DESCRIPTIVE and is NOT tree-mapped, because an order
5326
+ // is a protective act, not an alert condition; tree-mapping it would score
5327
+ // a survivor higher for having sought court protection. The counterparty-
5328
+ // gated scoring reads live elsewhere (`protection_order_against_trafficker`
5329
+ // on the Severity model; perpetrator leaf P-II-D). The signal reaches the
5330
+ // Severity model through the catalog's `lane_tiers`
5331
+ // (safety_planning: elevated · domestic_family_violence: review), which is
5332
+ // not a platform-common surface.
5333
+ // PAVE 2.0 needs this to express the AE-3 intake emission; without it the
5334
+ // AE instrument writes an assertion against a code that resolves to
5335
+ // nothing. `coreIndicators.pin.json` is refreshed to 622410b (214 codes)
5336
+ // in the same change; the 2 scoring-ahead codes remain absent upstream and
5337
+ // stay on the `SCORING_AHEAD_OF_CATALOG` allowlist, unchanged at exactly 2.
5338
+ // The new SOT entry is APPENDED at positional code 136-216 so every
5339
+ // previously issued code keeps its number.
5340
+ //
5341
+ // NOT ADDED, deliberately: `substance_use_concerns`. It is NOT a code in
5342
+ // the canonical catalog — it is a `legacy_aliases` member of the canonical
5343
+ // `serious_substance_use_or_introduced_to_drugs` (136-142, shipped since
5344
+ // 0.8.13, `vulnerability_context` / `depends` / `elevated` /
5345
+ // `isAlert: "pave"` / `alertWhen: "recency_under_year"`). Adding it as its
5346
+ // own code would be exactly the invention GATE B exists to stop. Consumers
5347
+ // binding a BH-2 substance-use emission must bind the canonical key.
5348
+ //
5349
+ // PROJECTED-FIELD REVISIONS carried in the same refresh. A pin bump is a
5350
+ // promise of FULL conformance to the pinned catalog, not just of its new
5351
+ // codes — the 84a1b67 → 622410b delta also revised two shipping codes, and
5352
+ // both are carried here (SOT JSON + this label map):
5353
+ // • `acknowledgement_or_report_of_human_trafficking` (136-007) — label
5354
+ // "Acknowledgement or report of human trafficking" →
5355
+ // "Human trafficking disclosure or report".
5356
+ // • `juvenile_justice_or_child_welfare_involvement` (136-094) —
5357
+ // definition gained "(system unspecified — deprecated combined code;
5358
+ // see read-time alias policy above)". LOAD-BEARING: the definition is
5359
+ // the only projected field that tells a consumer this code is
5360
+ // DEPRECATED. Upstream split it 2026-06-08 (Ava) into
5361
+ // `juvenile_justice_system_involvement` (136-095) +
5362
+ // `child_welfare_system_involvement` at the Core Profile capture layer,
5363
+ // and the Phase 2C combined→split migration (2026-08-02, Crysta) makes
5364
+ // the read-time alias policy binding: the row is NEVER deleted and
5365
+ // stored CARs are NEVER rewritten — a combined-code CAR resolves at
5366
+ // read/aggregation time as BOTH split codes, so any consumer keyed by a
5367
+ // split code must also key this one. Residual emitters are only the
5368
+ // captures that genuinely cannot name the system (IS-3.2.4 manual Yes;
5369
+ // TRA-34c parent-category-selected with no system subtype). The full
5370
+ // policy text lives in the catalog comment block above the row in
5371
+ // `data/core_indicators.yaml` @ 622410b.
5372
+ // Also reconciled here, INHERITED from the previous refresh: the
5373
+ // `sexualized_content_performance_activity` (136-146) definition. The
5374
+ // a596eb9 → 84a1b67 delta appended the SEXUALIZED-CONTENT-SPLIT-2026-07-15
5375
+ // UMBRELLA NOTE to it, and 0.8.14 shipped the pin bump without it, so the
5376
+ // definition has been stale since. It now carries the catalog text verbatim.
5377
+ // (Two remaining JSON-vs-YAML differences are round-trip artifacts, not
5378
+ // drift: an unescaped `fiancé` and unwrapped hard-wrapped lines.)
5379
+ //
5275
5380
  // CVC_136_ALERT_INDICATOR above is a legacy Thread-only surface with NO
5276
5381
  // canonical basis; it is deliberately left untouched in 0.8.13 (a separate
5277
5382
  // Thread cleanup). The canonical alert axis is the `isAlert` ATTRIBUTE on
@@ -5286,6 +5391,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5286
5391
  "abuser_unemployed",
5287
5392
  "access_to_vulnerable_individuals",
5288
5393
  "acknowledgement_or_report_of_human_trafficking",
5394
+ "active_protective_order",
5289
5395
  "ads_available_247",
5290
5396
  "ads_imply_multiple_workers",
5291
5397
  "ads_prost_slang",
@@ -5309,6 +5415,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5309
5415
  "cannot_stop_working_or_freely_leave",
5310
5416
  "child_not_abusers_in_household",
5311
5417
  "child_welfare_system_involvement",
5418
+ "clients_unaware_of_third_party_coordination",
5312
5419
  "coerced_to_misrepresent_identity_or_activity",
5313
5420
  "coercive_debt_pressure",
5314
5421
  "coercive_debt_pressure_youth",
@@ -5331,6 +5438,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5331
5438
  "debt_terms_deceptive_youth",
5332
5439
  "denied_basic_needs",
5333
5440
  "depends_on_employer_for_immigration_status",
5441
+ "depends_on_spouse_or_family_for_immigration_status",
5334
5442
  "does_not_control_finances_or_earnings",
5335
5443
  "does_not_control_identity_documents",
5336
5444
  "elevated_lethality_risk_signal",
@@ -5424,6 +5532,8 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5424
5532
  "several_cell_phones_or_frequent_number_changes",
5425
5533
  "sex_acts_in_own_residence",
5426
5534
  "sexual_exploitation",
5535
+ "sexualized_content_in_person_performance_activity",
5536
+ "sexualized_content_online_performance_activity",
5427
5537
  "sexualized_content_performance_activity",
5428
5538
  "shared_contact_network",
5429
5539
  "signs_of_physical_abuse_confinement_or_neglect",
@@ -5469,6 +5579,7 @@ export const CVC_136_CORE_INDICATOR_VALUES = [
5469
5579
  "trafficking_experience_past_10plusy",
5470
5580
  "trafficking_experience_past_3to10y",
5471
5581
  "trafficking_experience_past_lt3y",
5582
+ "trauma_perpetrator_is_current_manager",
5472
5583
  "travel_organized_by_third_party",
5473
5584
  "tricked_or_pressured_into_unwanted_acts",
5474
5585
  "under_18_advertised_age",
@@ -5501,7 +5612,8 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5501
5612
  "abuser_threatened_suicide": "Abuser threatened suicide",
5502
5613
  "abuser_unemployed": "Abuser is unemployed",
5503
5614
  "access_to_vulnerable_individuals": "Access to or connections with vulnerable individuals",
5504
- "acknowledgement_or_report_of_human_trafficking": "Acknowledgement or report of human trafficking",
5615
+ "acknowledgement_or_report_of_human_trafficking": "Human trafficking disclosure or report",
5616
+ "active_protective_order": "Active protective order (client-reported)",
5505
5617
  "ads_available_247": "Advertises available anytime / 24-7",
5506
5618
  "ads_imply_multiple_workers": "Ads imply multiple workers",
5507
5619
  "ads_prost_slang": "Ad uses prostitution slang",
@@ -5525,6 +5637,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5525
5637
  "cannot_stop_working_or_freely_leave": "Cannot stop working or freely leave home/work",
5526
5638
  "child_not_abusers_in_household": "Child in household who is not the abuser's biological child",
5527
5639
  "child_welfare_system_involvement": "Child welfare system involvement (history)",
5640
+ "clients_unaware_of_third_party_coordination": "Clients unaware they are coordinating with a third party (concealed dispatch)",
5528
5641
  "coerced_to_misrepresent_identity_or_activity": "Coerced to misrepresent age, identity, or work activity to outsiders",
5529
5642
  "coercive_debt_pressure": "Pressured to do things to pay off debt (coercive debt repayment)",
5530
5643
  "coercive_debt_pressure_youth": "Pressured to do things to pay off debt (youth missing-from-care)",
@@ -5547,6 +5660,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5547
5660
  "debt_terms_deceptive_youth": "Debt repayment terms differed from what was expected (youth missing-from-care)",
5548
5661
  "denied_basic_needs": "Denied basic needs (food, water, sleep, medical care)",
5549
5662
  "depends_on_employer_for_immigration_status": "Depends on employer for immigration status (tied visa / living with employer)",
5663
+ "depends_on_spouse_or_family_for_immigration_status": "Depends on spouse / family member for immigration status (tied family visa)",
5550
5664
  "does_not_control_finances_or_earnings": "Limited independence: does not control finances or earnings",
5551
5665
  "does_not_control_identity_documents": "Limited independence: does not control identity documents",
5552
5666
  "elevated_lethality_risk_signal": "Elevated lethality risk",
@@ -5640,6 +5754,8 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5640
5754
  "several_cell_phones_or_frequent_number_changes": "Several cell phones or frequently changing phone number",
5641
5755
  "sex_acts_in_own_residence": "Sex acts take place in person's own residence",
5642
5756
  "sexual_exploitation": "Sexual exploitation (general)",
5757
+ "sexualized_content_in_person_performance_activity": "In-person sexualized performance / appearance-based activity",
5758
+ "sexualized_content_online_performance_activity": "Online sexual performance / interactive sexual content activity",
5643
5759
  "sexualized_content_performance_activity": "Sexualized content, performance, or communications activity",
5644
5760
  "shared_contact_network": "Shares a contact network (phones/handles)",
5645
5761
  "signs_of_physical_abuse_confinement_or_neglect": "Signs of physical abuse, confinement, or neglect (observed)",
@@ -5685,6 +5801,7 @@ export const CVC_136_CORE_INDICATOR_LABELS: Record<CVC136CoreIndicator, string>
5685
5801
  "trafficking_experience_past_10plusy": "Trafficking experience recency: 10+ years since last experience",
5686
5802
  "trafficking_experience_past_3to10y": "Trafficking experience recency: 3–10 years since last experience",
5687
5803
  "trafficking_experience_past_lt3y": "Trafficking experience recency: less than 3 years since last experience",
5804
+ "trauma_perpetrator_is_current_manager": "Trauma perpetrator is a current manager / facilitator (trauma-bonded control)",
5688
5805
  "travel_organized_by_third_party": "Travel organized by a third party (sex provider does not control own movement)",
5689
5806
  "tricked_or_pressured_into_unwanted_acts": "Tricked or pressured into unwanted acts or activities (generic coercion)",
5690
5807
  "under_18_advertised_age": "Under 18 (ad-derived / advertised age)",
@@ -2,7 +2,7 @@
2
2
  "domain": "assertion_domain",
3
3
  "name": "Assertion Domain (CVC-159)",
4
4
  "version": "2.0.0",
5
- "_status": "CANONICAL — RENUMBERED 0.8.13 from provisional CVC-964 to canonical CVC-159. Live prototype HEAD a596eb9: `Final CVCs` -> `core - assertion_domain` = CVC-159 (vocab_status 'Ready for dev', Verification 'Verified'), corroborated by 17 `data/cvcs/core_assertion_domain_extensions_*.yaml` files that all declare `cvc: core - assertion_domain`. CVC-159 was freed by deleting the 100%-unbound hand-coded `CVC_159_RELATIONSHIP_TIES` family from `src/constants/ic.ts`; `relationship_ties` keeps its canonical CVC-158. Consumers persist KEYS, not wire codes, so the renumber is compile-clean (regenerate `cvcKeys.ts`). WITHDRAWN in 0.8.13 (all three have ZERO occurrences at prototype HEAD): `romantic_relationship` (964-066) — upstream the romantic-partner lifecycle routes to `household_relationships`, see `data/cvcs/core_romantic_relationship_change_type.yaml`; `household_tenure` (964-045); `household_composition` (964-067). All three fold into `household_relationships` (554 occurrences at HEAD). NOTE: `romantic_partner` is a relationship-type VALUE code (1,575 occurrences), never an assertion domain — it is correctly not modelled here. `child_profile` (159-065) is KEPT: 353 occurrences at HEAD. Segment-2 ordinals are preserved across the renumber (gaps at 045/066/067 are intentional; no data migration exists, but stable ordinals keep the diff reviewable). The 37 domains PAVE ships that are absent from the Final CVC-159 export all have substantial upstream occurrence counts and are retained as proposed CVC-159 extensions.",
5
+ "_status": "CANONICAL — RENUMBERED 0.8.13 from provisional CVC-964 to canonical CVC-159. Live prototype HEAD a596eb9: `Final CVCs` -> `core - assertion_domain` = CVC-159 (vocab_status 'Ready for dev', Verification 'Verified'), corroborated by 17 `data/cvcs/core_assertion_domain_extensions_*.yaml` files that all declare `cvc: core - assertion_domain`. CVC-159 was freed by deleting the 100%-unbound hand-coded `CVC_159_RELATIONSHIP_TIES` family from `src/constants/ic.ts`; `relationship_ties` keeps its canonical CVC-158. Consumers persist KEYS, not wire codes, so the renumber is compile-clean (regenerate `cvcKeys.ts`). WITHDRAWN in 0.8.13 (all three have ZERO occurrences at prototype HEAD): `romantic_relationship` (964-066) — upstream the romantic-partner lifecycle routes to `household_relationships`, see `data/cvcs/core_romantic_relationship_change_type.yaml`; `household_tenure` (964-045); `household_composition` (964-067). All three fold into `household_relationships` (554 occurrences at HEAD). NOTE: `romantic_partner` is a relationship-type VALUE code (1,575 occurrences), never an assertion domain — it is correctly not modelled here. `child_profile` (159-065) is KEPT: 353 occurrences at HEAD. Segment-2 ordinals are preserved across the renumber (gaps at 045/066/067 are intentional; no data migration exists, but stable ordinals keep the diff reviewable). The 37 domains PAVE ships that are absent from the Final CVC-159 export all have substantial upstream occurrence counts and are retained as proposed CVC-159 extensions. | 0.8.20: ADDED `signal_identification` (159-066) and `investigative_legal` (159-067) -- retroactive homing of the Track-1 identification-rung emitter live since 2026-08-23; both ratified in the CVC-159 codebook 2026-08-29 (prototype PR #519, hti-features PR #34). Ordinals 066/067 were free: the 0.8.13 withdrawals that reserved those slots were under the OLD CVC-964 numbering and the 159 equivalents were never issued -- verified zero references to 159-066/159-067 anywhere in the repo or the published dist before assigning. The 045 gap remains reserved. The rung VALUE set those two domains carry lives in its own vocabulary (`riskIdentificationMilestone`, CVC-267) rather than as Level-2 rows here: `AssertionDomainKeys` is consumed as THE SET OF DOMAINS, and folding values into it breaks that contract for every consumer -- PAVE's `Record<AssertionDomain, DomainValueVocabulary>` totality gate would demand a domain classification for `on_radar`. CVC-159 stays Level-1 only.",
6
6
  "_source": "htilabstech/prototype@a596eb9 Final CVCs/Assertion Contract/core - assertion_domain.md (CVC-159) + 17 core_assertion_domain_extensions_*.yaml",
7
7
  "levels": {
8
8
  "0": "Unknown or Missing",
@@ -624,6 +624,24 @@
624
624
  "parentCode": null,
625
625
  "childCodes": [],
626
626
  "definition": "assertion_domain partition for CARs on a Child profile subject-record entity (Add Child / Edit Child; core_child_change_type verbs). DRAFT-TEMPORARY direct import from prototype, pending Notion ratification."
627
+ },
628
+ {
629
+ "code": "159-066-000-000-000-000-000",
630
+ "key": "signal_identification",
631
+ "title": "Signal / Identification",
632
+ "selectable": true,
633
+ "parentCode": null,
634
+ "childCodes": [],
635
+ "definition": "The identification-funnel pipeline domain: a subject's position on the reach ladder (on_radar -> screened -> at_risk -> assessed), asserted by the `identification_rung_reached` CAR whose `assertion_value_code` is the rung (CVC-267). Ratified 2026-08-29 as retroactive codebook homing of a live emitter that has minted rung CARs since 2026-08-23 (Crysta ruling, milestone-residue R1). A rung CAR asserts that a subject REACHED a rung; it never restates a determination -- it joins the derived milestone row via `pm_ref`, and the derived row remains the derived row (a milestone row never IS the CAR). Distinct from `identification_status` (CVC-241), the identity-CONFIDENCE axis; per the 2026-06-30 naming directive that axis is named `identity_status` and 'identification ladder' is a retired synonym for it -- display copy for THIS domain says 'identification funnel' or 'pipeline rungs', never bare 'identification ladder'. The `determined` rung is filed under BOTH this domain and `investigative_legal` (ruling 2026-08-29); its STORED domain stays `investigative_legal` as built."
636
+ },
637
+ {
638
+ "code": "159-067-000-000-000-000-000",
639
+ "key": "investigative_legal",
640
+ "title": "Investigative / Legal",
641
+ "selectable": true,
642
+ "parentCode": null,
643
+ "childCodes": [],
644
+ "definition": "The investigation-and-legal-process domain. Carries `TRAFFICKING_STATUS` (CVC-267) and is the STORED `assertion_domain` of the `determined` rung of the identification funnel -- the rung measures reaching a conclusion in a safe setting, not which conclusion, so a no-indication determination still counts. Ratified 2026-08-29 alongside `signal_identification`: it is live in the same emitter and was equally unhomed. Filed-under-both (ruling 2026-08-29): data relevant to multiple milestone topics is documented under every topic it is relevant for, while CVC-159's one-assertion-one-domain rule keeps the STORED domain single -- nothing re-mints."
627
645
  }
628
646
  ]
629
647
  }
@@ -0,0 +1,80 @@
1
+ {
2
+ "domain": "assertion_status",
3
+ "name": "Assertion Status",
4
+ "version": "1.0.0",
5
+ "_status": "PROVISIONAL — GDR §10.1 confirmed-CVC name is `core - status`, but Final CVCs/CVC_INDEX.md @ a596eb9 carries no number for it, so it parks in the provisional 900-block pending canonical Notion authoring + steward ratification. Substantive values sourced verbatim from the PAVE @pave/domain `ASSERTION_STATUSES` enum (D10 GDR §10.1 bulk publish, bead pv-pgdr-cvc-source-gdr-10-1-bulk-publish). The PAVE enum enumerates only the substantive lifecycle states, so the missingness quadruplet is added per SOT convention.",
6
+ "_source": "pave-2.0/packages/domain/src/enums.ts ASSERTION_STATUSES",
7
+ "levels": {
8
+ "0": "Unknown or Missing",
9
+ "1": "Assertion lifecycle status"
10
+ },
11
+ "entries": [
12
+ {
13
+ "code": "985-000-000-000-000-000-000",
14
+ "key": "missingness_root",
15
+ "title": "Unknown, Redacted, or Missing",
16
+ "selectable": false,
17
+ "parentCode": null,
18
+ "childCodes": [
19
+ "985-000-000-000-000-000-001",
20
+ "985-000-000-000-000-000-002",
21
+ "985-000-000-000-000-000-003"
22
+ ],
23
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
24
+ },
25
+ {
26
+ "code": "985-000-000-000-000-000-001",
27
+ "key": "unknown",
28
+ "title": "Unknown",
29
+ "selectable": true,
30
+ "parentCode": "985-000-000-000-000-000-000",
31
+ "childCodes": [],
32
+ "definition": "The assertion status is unknown at time of entry (missingness sentinel)."
33
+ },
34
+ {
35
+ "code": "985-000-000-000-000-000-002",
36
+ "key": "anonymous",
37
+ "title": "Anonymous / declined to answer",
38
+ "selectable": true,
39
+ "parentCode": "985-000-000-000-000-000-000",
40
+ "childCodes": [],
41
+ "definition": "Value is intentionally withheld, declined, or redacted."
42
+ },
43
+ {
44
+ "code": "985-000-000-000-000-000-003",
45
+ "key": "data_not_collected",
46
+ "title": "Data not collected",
47
+ "selectable": true,
48
+ "parentCode": "985-000-000-000-000-000-000",
49
+ "childCodes": [],
50
+ "definition": "No attempt was made to collect the value."
51
+ },
52
+ {
53
+ "code": "985-001-000-000-000-000-000",
54
+ "key": "active",
55
+ "title": "Active",
56
+ "selectable": true,
57
+ "parentCode": null,
58
+ "childCodes": [],
59
+ "definition": "In force — the current, non-superseded row for its spine partition. Emitting systems typically default new assertions to this status (e.g. PAVE's assertion factory defaults `status: \"active\"`)."
60
+ },
61
+ {
62
+ "code": "985-002-000-000-000-000-000",
63
+ "key": "superseded",
64
+ "title": "Superseded",
65
+ "selectable": true,
66
+ "parentCode": null,
67
+ "childCodes": [],
68
+ "definition": "Replaced by a later assertion row in the same spine partition. When status === \"superseded\", `supersedes_assertion_id` is required per GLOBAL_DESIGN_RULES §5.5."
69
+ },
70
+ {
71
+ "code": "985-003-000-000-000-000-000",
72
+ "key": "retracted",
73
+ "title": "Retracted",
74
+ "selectable": true,
75
+ "parentCode": null,
76
+ "childCodes": [],
77
+ "definition": "Withdrawn or invalidated without a replacement row — the claim is no longer asserted. Distinct from superseded (which points at a successor)."
78
+ }
79
+ ]
80
+ }