@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
@@ -8,7 +8,6 @@
8
8
  * - client_visible filtering in createConfigEndpoint
9
9
  * - secret exclusion in createConfigEndpoint
10
10
  * - Build-phase variable skip at runtime (R3.4)
11
- * - Defaults applied into process.env, and .env.local precedence (co-8w1)
12
11
  *
13
12
  * Uses the fixture at src/config/fixtures/valid.yaml.
14
13
  * Tests call validateAgainstContract with throwOnFailure: true to avoid
@@ -21,15 +20,11 @@ import { tmpdir } from "node:os";
21
20
  import { fileURLToPath } from "node:url";
22
21
  import { dirname } from "node:path";
23
22
 
24
- import { describe, it, expect, beforeEach, afterEach } from "vitest";
23
+ import { describe, it, expect } from "vitest";
25
24
 
26
25
  import {
27
26
  validateAgainstContract,
28
27
  createConfigEndpoint,
29
- applyContractDefaults,
30
- applyEnvLocal,
31
- parseDotenv,
32
- loadContract,
33
28
  } from "../config/index.js";
34
29
 
35
30
  const __filename = fileURLToPath(import.meta.url);
@@ -46,37 +41,6 @@ function writeTempYaml(content: string): string {
46
41
  return p;
47
42
  }
48
43
 
49
- /** Write a temp .env.local-shaped file and return its path. Caller must delete. */
50
- function writeTempEnvFile(content: string): string {
51
- const p = join(tmpdir(), `test-env-local-${Date.now()}-${Math.random()}`);
52
- writeFileSync(p, content, "utf8");
53
- return p;
54
- }
55
-
56
- /**
57
- * A path that is guaranteed not to exist, so tests never pick up a real
58
- * `.env.local` sitting in the developer's working directory.
59
- */
60
- const NO_ENV_LOCAL = join(tmpdir(), "platform-common-absent.env.local");
61
-
62
- /**
63
- * validateAgainstContract now WRITES to process.env, so per-key restore is no
64
- * longer enough — a test can materialize keys it never named. Snapshot and
65
- * restore the whole environment around every test.
66
- */
67
- let envSnapshot: Record<string, string | undefined> = {};
68
-
69
- beforeEach(() => {
70
- envSnapshot = { ...process.env };
71
- });
72
-
73
- afterEach(() => {
74
- for (const key of Object.keys(process.env)) {
75
- delete process.env[key];
76
- }
77
- Object.assign(process.env, envSnapshot);
78
- });
79
-
80
44
  /** Save and restore process.env around a test. */
81
45
  function withEnv(
82
46
  vars: Record<string, string | undefined>,
@@ -582,294 +546,6 @@ describe("module exports — surface check", () => {
582
546
  });
583
547
  });
584
548
 
585
- // ─── Defaults applied into process.env (co-8w1) ──────────────────────────────
586
-
587
- describe("validateAgainstContract — applies defaults into process.env (co-8w1)", () => {
588
- it("boots with no .env.generated and no .env.local: every tier default lands in process.env", () => {
589
- withEnv(
590
- {
591
- NODE_ENV: undefined,
592
- HOST: undefined,
593
- PORT: undefined,
594
- API_URL: undefined,
595
- ENABLED: undefined,
596
- DB_SECRET: undefined,
597
- PUBLIC_API_URL: undefined,
598
- },
599
- () => {
600
- validateAgainstContract(FIXTURE_PATH, {
601
- throwOnFailure: true,
602
- env: "local",
603
- envLocalPath: NO_ENV_LOCAL,
604
- });
605
-
606
- expect(process.env["HOST"]).toBe("0.0.0.0");
607
- expect(process.env["PORT"]).toBe("3000");
608
- expect(process.env["API_URL"]).toBe("http://localhost:4000");
609
- expect(process.env["ENABLED"]).toBe("true");
610
- expect(process.env["PUBLIC_API_URL"]).toBe("http://localhost:4000");
611
- expect(process.env["NODE_ENV"]).toBe("development");
612
- },
613
- );
614
- });
615
-
616
- it("never overwrites a value already present in process.env", () => {
617
- withEnv(
618
- {
619
- HOST: "deployed-host",
620
- PORT: "9999",
621
- DB_SECRET: "from-task-def",
622
- },
623
- () => {
624
- validateAgainstContract(FIXTURE_PATH, {
625
- throwOnFailure: true,
626
- env: "local",
627
- envLocalPath: NO_ENV_LOCAL,
628
- });
629
-
630
- expect(process.env["HOST"]).toBe("deployed-host");
631
- expect(process.env["PORT"]).toBe("9999");
632
- expect(process.env["DB_SECRET"]).toBe("from-task-def");
633
- },
634
- );
635
- });
636
-
637
- it("leaves an explicitly empty value alone", () => {
638
- withEnv({ HOST: "", DB_SECRET: "mongodb://localhost" }, () => {
639
- expect(() =>
640
- validateAgainstContract(FIXTURE_PATH, {
641
- throwOnFailure: true,
642
- env: "local",
643
- envLocalPath: NO_ENV_LOCAL,
644
- }),
645
- ).toThrow(/HOST.*required but not set/);
646
- expect(process.env["HOST"]).toBe("");
647
- });
648
- });
649
-
650
- it("does not apply build-phase defaults (R3.4)", () => {
651
- withEnv({ HOST: "0.0.0.0", DB_SECRET: "s", BUILD_ARG: undefined }, () => {
652
- validateAgainstContract(FIXTURE_PATH, {
653
- throwOnFailure: true,
654
- env: "local",
655
- envLocalPath: NO_ENV_LOCAL,
656
- });
657
- expect(process.env["BUILD_ARG"]).toBeUndefined();
658
- });
659
- });
660
-
661
- it("does not bleed a default across tiers", () => {
662
- withEnv(
663
- { HOST: "0.0.0.0", DB_SECRET: "s", PORT: undefined, NODE_ENV: undefined },
664
- () => {
665
- validateAgainstContract(FIXTURE_PATH, {
666
- throwOnFailure: true,
667
- env: "test",
668
- envLocalPath: NO_ENV_LOCAL,
669
- });
670
- // PORT only has a `local` default; the `test` tier must not inherit it.
671
- expect(process.env["PORT"]).toBeUndefined();
672
- expect(process.env["NODE_ENV"]).toBe("test");
673
- },
674
- );
675
- });
676
-
677
- it("can be turned off with applyDefaults: false", () => {
678
- withEnv({ HOST: "0.0.0.0", DB_SECRET: "s", PORT: undefined }, () => {
679
- const cfg = validateAgainstContract(FIXTURE_PATH, {
680
- throwOnFailure: true,
681
- env: "local",
682
- applyDefaults: false,
683
- envLocalPath: NO_ENV_LOCAL,
684
- });
685
- // Still resolved for validation, just not written back to process.env.
686
- expect(cfg["PORT"]).toBe(3000);
687
- expect(process.env["PORT"]).toBeUndefined();
688
- });
689
- });
690
-
691
- it("applyContractDefaults reports the variables it applied", () => {
692
- withEnv({ HOST: "already-set", PORT: undefined }, () => {
693
- const contract = loadContract(FIXTURE_PATH);
694
- const applied = applyContractDefaults(contract, "local");
695
- expect(applied).toContain("PORT");
696
- expect(applied).not.toContain("HOST");
697
- expect(applied).not.toContain("BUILD_ARG");
698
- });
699
- });
700
- });
701
-
702
- // ─── .env.local precedence (co-8w1) ──────────────────────────────────────────
703
-
704
- describe("validateAgainstContract — .env.local precedence (co-8w1)", () => {
705
- it("beats a same-named process.env value", () => {
706
- const p = writeTempEnvFile("HOST=from-env-local\n");
707
- try {
708
- withEnv({ HOST: "deployed-host", DB_SECRET: "s" }, () => {
709
- const cfg = validateAgainstContract(FIXTURE_PATH, {
710
- throwOnFailure: true,
711
- env: "local",
712
- envLocalPath: p,
713
- });
714
- expect(process.env["HOST"]).toBe("from-env-local");
715
- expect(cfg["HOST"]).toBe("from-env-local");
716
- });
717
- } finally {
718
- unlinkSync(p);
719
- }
720
- });
721
-
722
- it("beats a contract default", () => {
723
- const p = writeTempEnvFile("PORT=4321\n");
724
- try {
725
- withEnv({ HOST: "0.0.0.0", DB_SECRET: "s", PORT: undefined }, () => {
726
- const cfg = validateAgainstContract(FIXTURE_PATH, {
727
- throwOnFailure: true,
728
- env: "local",
729
- envLocalPath: p,
730
- });
731
- expect(process.env["PORT"]).toBe("4321");
732
- expect(cfg["PORT"]).toBe(4321);
733
- });
734
- } finally {
735
- unlinkSync(p);
736
- }
737
- });
738
-
739
- it("can introduce variables the contract does not declare", () => {
740
- const p = writeTempEnvFile("MY_LOCAL_TOOL=on\n");
741
- try {
742
- withEnv(
743
- { HOST: "0.0.0.0", DB_SECRET: "s", MY_LOCAL_TOOL: undefined },
744
- () => {
745
- const cfg = validateAgainstContract(FIXTURE_PATH, {
746
- throwOnFailure: true,
747
- env: "local",
748
- envLocalPath: p,
749
- });
750
- expect(process.env["MY_LOCAL_TOOL"]).toBe("on");
751
- // Undeclared vars are not part of the typed config surface.
752
- expect(cfg["MY_LOCAL_TOOL"]).toBeUndefined();
753
- },
754
- );
755
- } finally {
756
- unlinkSync(p);
757
- }
758
- });
759
-
760
- it("selects the tier whose defaults get applied", () => {
761
- const p = writeTempEnvFile("NODE_ENV=test\n");
762
- try {
763
- withEnv({ HOST: "0.0.0.0", DB_SECRET: "s", PORT: undefined }, () => {
764
- validateAgainstContract(FIXTURE_PATH, {
765
- throwOnFailure: true,
766
- envLocalPath: p,
767
- });
768
- expect(process.env["NODE_ENV"]).toBe("test");
769
- // `test` tier: PORT's local-only default must not be applied.
770
- expect(process.env["PORT"]).toBeUndefined();
771
- });
772
- } finally {
773
- unlinkSync(p);
774
- }
775
- });
776
-
777
- it("treats a missing .env.local as a no-op", () => {
778
- withEnv({ HOST: "0.0.0.0", DB_SECRET: "s" }, () => {
779
- expect(applyEnvLocal(NO_ENV_LOCAL)).toEqual([]);
780
- expect(() =>
781
- validateAgainstContract(FIXTURE_PATH, {
782
- throwOnFailure: true,
783
- env: "local",
784
- envLocalPath: NO_ENV_LOCAL,
785
- }),
786
- ).not.toThrow();
787
- });
788
- });
789
-
790
- it("can be turned off with applyEnvLocal: false", () => {
791
- const p = writeTempEnvFile("HOST=from-env-local\n");
792
- try {
793
- withEnv({ HOST: "deployed-host", DB_SECRET: "s" }, () => {
794
- validateAgainstContract(FIXTURE_PATH, {
795
- throwOnFailure: true,
796
- env: "local",
797
- applyEnvLocal: false,
798
- envLocalPath: p,
799
- });
800
- expect(process.env["HOST"]).toBe("deployed-host");
801
- });
802
- } finally {
803
- unlinkSync(p);
804
- }
805
- });
806
-
807
- it("applyEnvLocal reports the variables it applied", () => {
808
- const p = writeTempEnvFile("ALPHA=1\nBETA=2\n");
809
- try {
810
- withEnv({ ALPHA: undefined, BETA: undefined }, () => {
811
- expect(applyEnvLocal(p).sort()).toEqual(["ALPHA", "BETA"]);
812
- expect(process.env["ALPHA"]).toBe("1");
813
- });
814
- } finally {
815
- unlinkSync(p);
816
- }
817
- });
818
- });
819
-
820
- // ─── parseDotenv ─────────────────────────────────────────────────────────────
821
-
822
- describe("parseDotenv", () => {
823
- it("skips blanks and comment lines", () => {
824
- expect(parseDotenv("\n# a comment\n\nA=1\n")).toEqual({ A: "1" });
825
- });
826
-
827
- it("accepts an export prefix and whitespace around =", () => {
828
- expect(parseDotenv("export A = 1\n")).toEqual({ A: "1" });
829
- });
830
-
831
- it("keeps everything after the first = in the value", () => {
832
- expect(parseDotenv("URI=mongodb://u:p@h/db?a=b\n")).toEqual({
833
- URI: "mongodb://u:p@h/db?a=b",
834
- });
835
- });
836
-
837
- it("strips an inline comment from an unquoted value", () => {
838
- expect(parseDotenv("A=1 # trailing\n")).toEqual({ A: "1" });
839
- });
840
-
841
- it("keeps a # that is part of an unquoted value", () => {
842
- expect(parseDotenv("PASS=abc#def\n")).toEqual({ PASS: "abc#def" });
843
- });
844
-
845
- it("unwraps double quotes and expands escapes", () => {
846
- expect(parseDotenv('A="line1\\nline2 # not a comment"\n')).toEqual({
847
- A: "line1\nline2 # not a comment",
848
- });
849
- });
850
-
851
- it("treats single-quoted values as literal", () => {
852
- expect(parseDotenv("A='no \\n expansion'\n")).toEqual({
853
- A: "no \\n expansion",
854
- });
855
- });
856
-
857
- it("supports a quoted value spanning multiple lines", () => {
858
- expect(parseDotenv('KEY="first\nsecond"\nB=2\n')).toEqual({
859
- KEY: "first\nsecond",
860
- B: "2",
861
- });
862
- });
863
-
864
- it("skips malformed lines instead of throwing", () => {
865
- expect(parseDotenv("not a pair\n1BAD=x\nGOOD=y\n")).toEqual({ GOOD: "y" });
866
- });
867
-
868
- it("skips an unterminated quoted value", () => {
869
- expect(parseDotenv('A="never closed\n')).toEqual({});
870
- });
871
- });
872
-
873
549
  // ─── Fixture file readable ───────────────────────────────────────────────────
874
550
 
875
551
  describe("fixture", () => {
@@ -0,0 +1,167 @@
1
+ /**
2
+ * SHARE RESPONSE REASON (CVC-306) — the per-context picker contract
3
+ * ==================================================================
4
+ *
5
+ * CVC-306 is ONE codebook whose rows are selectable per CONTEXT — `field_review`
6
+ * (a delivered field not brought in), `decline_share` (refusing a share before
7
+ * engaging it) and `reject_share` (refusing it after review). A consumer builds
8
+ * each context's picker by filtering on `entry.contexts`, so the context lists
9
+ * ARE the product contract: a reason that leaks into the wrong picker changes
10
+ * what a recipient can claim about a share.
11
+ *
12
+ * The canon rulings this pins (Crysta 2026-08-23, recorded in the prototype's
13
+ * `data/cvcs/core_share_response_reason.yaml` and the Notion codebook export):
14
+ *
15
+ * - The per-context columns, row for row, as canon publishes them.
16
+ * - Missingness is canon v1.1's shape (SHARING-FAMILY-AUDIT 2026-09-14): ONE
17
+ * ingestion-only sentinel, UNK, NEVER a picker chip (Selectable NO in every
18
+ * context), so it is `selectable: false` and belongs to no context. The
19
+ * codebook's DNC row is [ARCHIVED] ("Not a value; never emit") and must not
20
+ * be minted here — the first export did exactly that from stale canon.
21
+ * - The turned-away guard rail (R15): a person who was reached and chose no
22
+ * services is an ACCEPT + CVC-219 why-nots, never a decline — so
23
+ * `not_our_client` stays decline-only and no field-review or reject reason
24
+ * can stand in for it.
25
+ *
26
+ * The expected table below is transcribed from canon, NOT derived from the JSON,
27
+ * so a regenerated JSON that drifts from canon fails here rather than silently
28
+ * updating its own expectation.
29
+ */
30
+
31
+ import { readFileSync } from "node:fs";
32
+ import path from "node:path";
33
+ import { fileURLToPath } from "node:url";
34
+
35
+ import { describe, it, expect } from "vitest";
36
+
37
+ const here = path.dirname(fileURLToPath(import.meta.url));
38
+ const FILE = path.join(here, "..", "cvcs", "shareResponseReason.v1.0.0.json");
39
+
40
+ interface Entry {
41
+ code: string;
42
+ key: string;
43
+ selectable: boolean;
44
+ parentCode: string | null;
45
+ canonicalCode?: string;
46
+ contexts?: string[];
47
+ tobyRetention?: { class: string };
48
+ }
49
+ interface Envelope {
50
+ domain: string;
51
+ contexts: Record<string, string>;
52
+ entries: Entry[];
53
+ }
54
+
55
+ const env = JSON.parse(readFileSync(FILE, "utf8")) as Envelope;
56
+ const substantive = env.entries.filter((e) => e.code.split("-")[1] !== "000");
57
+ const missingness = env.entries.filter((e) => e.code.split("-")[1] === "000");
58
+
59
+ const CONTEXTS = ["field_review", "decline_share", "reject_share"] as const;
60
+
61
+ /** Canon's per-context selectability, in codebook row order. */
62
+ const CANON: Record<string, readonly string[]> = {
63
+ information_incorrect: ["field_review"],
64
+ not_relevant_for_client: ["field_review"],
65
+ duplicate_already_have: ["field_review", "decline_share"],
66
+ client_declined_recording: ["field_review"],
67
+ wrong_agency_service_area: ["decline_share"],
68
+ not_our_client: ["decline_share"],
69
+ sent_in_error: ["decline_share", "reject_share"],
70
+ no_capacity: ["decline_share"],
71
+ cannot_verify_conflicts: ["reject_share"],
72
+ wrong_person: ["reject_share"],
73
+ };
74
+
75
+ /** Canon's retention class vocabulary (yaml § TOBY RETENTION COLUMN). */
76
+ const RETENTION_CLASSES = new Set([
77
+ "supersede",
78
+ "tombstone_retain",
79
+ "purge_with_flags",
80
+ "inclusion_register",
81
+ "negative_constraint",
82
+ "retain_event",
83
+ ]);
84
+
85
+ describe("CVC-306 share_response_reason — per-context picker contract", () => {
86
+ it("declares exactly canon's three contexts", () => {
87
+ expect(env.domain).toBe("share_response_reason");
88
+ expect(Object.keys(env.contexts)).toEqual([...CONTEXTS]);
89
+ });
90
+
91
+ it("published codes are FROZEN: each key keeps its exact code (append-only)", () => {
92
+ // Enforced here independently of the generator's FROZEN list. Once published,
93
+ // a code's meaning is stored on live shares: a key may never move to another
94
+ // code, and a code may never be reused for another key. New reasons append at
95
+ // 306-011+, so this table only ever grows.
96
+ const FROZEN_CODES: Record<string, string> = {
97
+ information_incorrect: "306-001-000-000-000-000-000",
98
+ not_relevant_for_client: "306-002-000-000-000-000-000",
99
+ duplicate_already_have: "306-003-000-000-000-000-000",
100
+ client_declined_recording: "306-004-000-000-000-000-000",
101
+ wrong_agency_service_area: "306-005-000-000-000-000-000",
102
+ not_our_client: "306-006-000-000-000-000-000",
103
+ sent_in_error: "306-007-000-000-000-000-000",
104
+ no_capacity: "306-008-000-000-000-000-000",
105
+ cannot_verify_conflicts: "306-009-000-000-000-000-000",
106
+ wrong_person: "306-010-000-000-000-000-000",
107
+ };
108
+ const byKey = new Map(env.entries.map((e) => [e.key, e.code]));
109
+ for (const [key, code] of Object.entries(FROZEN_CODES)) {
110
+ expect(byKey.get(key), `${key} must keep ${code}`).toBe(code);
111
+ }
112
+ const frozen = new Set(Object.values(FROZEN_CODES));
113
+ for (const e of substantive) {
114
+ if (frozen.has(e.code)) expect(FROZEN_CODES[e.key], `${e.code} reused`).toBe(e.code);
115
+ else expect(Number(e.code.split("-")[1]), `${e.key} must append`).toBeGreaterThan(10);
116
+ }
117
+ });
118
+
119
+ it("carries exactly canon's 10 reasons, in codebook row order, all selectable", () => {
120
+ expect(substantive.map((e) => e.key)).toEqual(Object.keys(CANON));
121
+ for (const e of substantive) expect(e.selectable, e.key).toBe(true);
122
+ });
123
+
124
+ it("each reason is selectable in exactly the contexts canon gives it", () => {
125
+ for (const e of substantive) expect(e.contexts, e.key).toEqual(CANON[e.key]);
126
+ });
127
+
128
+ it("every context's picker is non-empty and matches canon", () => {
129
+ for (const ctx of CONTEXTS) {
130
+ const picker = substantive.filter((e) => e.contexts?.includes(ctx)).map((e) => e.key);
131
+ const want = Object.keys(CANON).filter((k) => CANON[k]!.includes(ctx));
132
+ expect(picker.length, ctx).toBeGreaterThan(0);
133
+ expect(picker, ctx).toEqual(want);
134
+ }
135
+ });
136
+
137
+ it("missingness is canon v1.1's single UNK sentinel, never a picker chip", () => {
138
+ expect(missingness.map((e) => e.key)).toEqual(["missingness_root", "unknown"]);
139
+ const unk = missingness.find((e) => e.key === "unknown")!;
140
+ expect(unk.code).toBe("306-000-000-000-000-000-001");
141
+ expect(unk.canonicalCode).toBe("UNK");
142
+ for (const e of missingness) {
143
+ expect(e.selectable, e.key).toBe(false);
144
+ expect(e.contexts ?? [], e.key).toEqual([]);
145
+ }
146
+ });
147
+
148
+ it("the archived DNC sentinel is not minted", () => {
149
+ const keys = env.entries.map((e) => e.key);
150
+ expect(keys).not.toContain("data_not_collected");
151
+ expect(env.entries.map((e) => e.canonicalCode)).not.toContain("DNC");
152
+ expect(env.entries.map((e) => e.code)).not.toContain("306-000-000-000-000-000-003");
153
+ });
154
+
155
+ it("R15 turned-away guard rail: not_our_client is decline-only", () => {
156
+ const e = substantive.find((x) => x.key === "not_our_client")!;
157
+ expect(e.contexts).toEqual(["decline_share"]);
158
+ });
159
+
160
+ it("every entry's tobyRetention class is in canon's class vocabulary", () => {
161
+ for (const e of env.entries) {
162
+ if (e.key === "missingness_root") continue;
163
+ expect(e.tobyRetention, e.key).toBeDefined();
164
+ expect(RETENTION_CLASSES.has(e.tobyRetention!.class), e.key).toBe(true);
165
+ }
166
+ });
167
+ });