@actuarial-ts/compliance 0.5.0 → 0.6.1

package/src/errors.ts

@@ -0,0 +1,12 @@
+export const COMPLIANCE_ERROR_CODES = [
+  "BAD_BUNDLE", "BAD_CDF", "MISSING_RATIONALE", "BAD_DIAGNOSTIC_RUN",
+  "DIAGNOSTIC_MISMATCH", "CRYPTO_UNAVAILABLE",
+] as const;
+export type ComplianceErrorCode = (typeof COMPLIANCE_ERROR_CODES)[number];
+export class ComplianceError extends Error {
+  readonly code: ComplianceErrorCode;
+  readonly path?: string;
+  constructor(code: ComplianceErrorCode, message: string, path?: string) {
+    super(message);this.name="ComplianceError";this.code=code;if(path!==undefined)this.path=path;
+  }
+}

package/src/index.ts

@@ -1,7 +1,9 @@
 export * from "./metadata.js";
+export * from "./errors.js";
+export * from "./version.js";
 export * from "./ledger.js";
 export * from "./modelCards.js";
 export * from "./disclosure.js";
-export * from "./diagnostics.js";
+export * from "./diagnosticRun.js";
 export * from "./bundle.js";
 export * from "./ave.js";

package/src/ledger.ts

@@ -30,7 +30,13 @@ import { canonicalJson, ComplianceError } from "./bundle.js";
 export type AssumptionActor = "default" | "actuary" | "agent";
 
 /** JSON-representable assumption value (the ledger stores data, not behavior). */
-export type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };
+export type JsonValue =
+  | string
+  | number
+  | boolean
+  | null
+  | JsonValue[]
+  | { [key: string]: JsonValue };
 
 export interface AssumptionEntry {
   /** 1-based position in the ledger; assigned by recordAssumption, never by the caller. */
@@ -58,7 +64,31 @@ export interface AssumptionLedger {
 
 /** An empty, frozen ledger. */
 export function createLedger(): AssumptionLedger {
-  return Object.freeze({ entries: Object.freeze([]) as readonly AssumptionEntry[] });
+  return Object.freeze({
+    entries: Object.freeze([]) as readonly AssumptionEntry[],
+  });
+}
+
+function snapshotJson(value: JsonValue): JsonValue {
+  let cloned: JsonValue;
+  try {
+    cloned = JSON.parse(canonicalJson(value)) as JsonValue;
+  } catch {
+    throw new ComplianceError(
+      "BAD_BUNDLE",
+      "Assumption values must be finite, acyclic JSON data",
+    );
+  }
+  const freeze = (item: JsonValue): JsonValue => {
+    if (item === null || typeof item !== "object") return item;
+    if (Array.isArray(item)) {
+      for (const child of item) freeze(child);
+    } else {
+      for (const child of Object.values(item)) freeze(child);
+    }
+    return Object.freeze(item) as JsonValue;
+  };
+  return freeze(cloned);
 }
 
 /**
@@ -67,15 +97,30 @@ export function createLedger(): AssumptionLedger {
  * ComplianceError("MISSING_RATIONALE") when actor !== "default" and rationale
  * is missing or blank.
  */
-export function recordAssumption(ledger: AssumptionLedger, entry: NewAssumptionEntry): AssumptionLedger {
-  if (entry.actor !== "default" && (entry.rationale === undefined || entry.rationale.trim() === "")) {
+export function recordAssumption(
+  ledger: AssumptionLedger,
+  entry: NewAssumptionEntry,
+): AssumptionLedger {
+  if (
+    entry.actor !== "default" &&
+    (entry.rationale === undefined || entry.rationale.trim() === "")
+  ) {
     throw new ComplianceError(
       "MISSING_RATIONALE",
       `assumption "${entry.field}" set by actor "${entry.actor}" requires a rationale; only actor "default" may omit one`,
     );
   }
-  const recorded: AssumptionEntry = Object.freeze({ ...entry, seq: ledger.entries.length + 1 });
-  return Object.freeze({ entries: Object.freeze([...ledger.entries, recorded]) });
+  const recorded: AssumptionEntry = Object.freeze({
+    ...entry,
+    value: snapshotJson(entry.value),
+    ...(entry.previousValue === undefined
+      ? {}
+      : { previousValue: snapshotJson(entry.previousValue) }),
+    seq: ledger.entries.length + 1,
+  });
+  return Object.freeze({
+    entries: Object.freeze([...ledger.entries, recorded]),
+  });
 }
 
 /** Entries that represent judgment (actor !== "default"), in ledger order. */
@@ -120,7 +165,9 @@ export function changedAssumptions(
   const added: string[] = [];
   const removed: string[] = [];
   const changed: AssumptionValueChange[] = [];
-  const fields = [...new Set([...priorLatest.keys(), ...currentLatest.keys()])].sort();
+  const fields = [
+    ...new Set([...priorLatest.keys(), ...currentLatest.keys()]),
+  ].sort();
   for (const field of fields) {
     const before = priorLatest.get(field);
     const after = currentLatest.get(field);
@@ -133,7 +180,11 @@ export function changedAssumptions(
       continue;
     }
     if (canonicalJson(before.value) !== canonicalJson(after.value)) {
-      changed.push({ field, priorValue: before.value, currentValue: after.value });
+      changed.push({
+        field,
+        priorValue: before.value,
+        currentValue: after.value,
+      });
     }
   }
   return { added, removed, changed };

package/src/metadata.ts

@@ -92,7 +92,20 @@ function isIsoDate(value: string): boolean {
   const day = Number(match[3]);
   if (month < 1 || month > 12) return false;
   const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
-  const daysInMonth = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1]!;
+  const daysInMonth = [
+    31,
+    leap ? 29 : 28,
+    31,
+    30,
+    31,
+    30,
+    31,
+    31,
+    30,
+    31,
+    30,
+    31,
+  ][month - 1]!;
   return day >= 1 && day <= daysInMonth;
 }
 
@@ -100,13 +113,20 @@ function isNonEmptyString(value: unknown): value is string {
   return typeof value === "string" && value.trim() !== "";
 }
 
-function checkDate(problems: string[], name: string, value: unknown, required: boolean): void {
+function checkDate(
+  problems: string[],
+  name: string,
+  value: unknown,
+  required: boolean,
+): void {
   if (value === undefined) {
     if (required) problems.push(`${name} is required (ISO yyyy-mm-dd)`);
     return;
   }
   if (typeof value !== "string" || !isIsoDate(value)) {
-    problems.push(`${name} must be a valid ISO date (yyyy-mm-dd); got ${JSON.stringify(value)}`);
+    problems.push(
+      `${name} must be a valid ISO date (yyyy-mm-dd); got ${JSON.stringify(value)}`,
+    );
   }
 }
 
@@ -123,7 +143,9 @@ export function validateMetadata(metadata: EstimateMetadata): string[] {
 
   if (metadata.intendedUsers !== undefined) {
     if (!Array.isArray(metadata.intendedUsers)) {
-      problems.push("intendedUsers, when provided, must be an array of non-empty strings");
+      problems.push(
+        "intendedUsers, when provided, must be an array of non-empty strings",
+      );
     } else {
       metadata.intendedUsers.forEach((user, index) => {
         if (!isNonEmptyString(user)) {
@@ -145,8 +167,15 @@ export function validateMetadata(metadata: EstimateMetadata): string[] {
     if (measure.kind === "specified-percentile") {
       const p = measure.percentile;
       if (p === undefined) {
-        problems.push('intendedMeasure.percentile is required when kind is "specified-percentile"');
-      } else if (typeof p !== "number" || !Number.isFinite(p) || p <= 0 || p >= 1) {
+        problems.push(
+          'intendedMeasure.percentile is required when kind is "specified-percentile"',
+        );
+      } else if (
+        typeof p !== "number" ||
+        !Number.isFinite(p) ||
+        p <= 0 ||
+        p >= 1
+      ) {
         problems.push(
           `intendedMeasure.percentile must be a fraction strictly between 0 and 1 (e.g. 0.75); got ${JSON.stringify(p)}`,
         );
@@ -177,8 +206,20 @@ export function validateMetadata(metadata: EstimateMetadata): string[] {
   checkDate(problems, "accountingDate", metadata.accountingDate, true);
   checkDate(problems, "valuationDate", metadata.valuationDate, true);
   checkDate(problems, "reviewDate", metadata.reviewDate, false);
+  if (
+    typeof metadata.reviewDate === "string" &&
+    isIsoDate(metadata.reviewDate) &&
+    typeof metadata.valuationDate === "string" &&
+    isIsoDate(metadata.valuationDate) &&
+    metadata.reviewDate < metadata.valuationDate
+  ) {
+    problems.push("reviewDate cannot precede valuationDate");
+  }
 
-  if (metadata.scopeNotes !== undefined && !isNonEmptyString(metadata.scopeNotes)) {
+  if (
+    metadata.scopeNotes !== undefined &&
+    !isNonEmptyString(metadata.scopeNotes)
+  ) {
     problems.push("scopeNotes, when provided, must be a non-empty string");
   }
   if (metadata.currency !== undefined && !isNonEmptyString(metadata.currency)) {

package/src/version.ts

@@ -0,0 +1 @@
+export const COMPLIANCE_PACKAGE_VERSION = "0.6.1";

package/dist/diagnostics.d.ts

@@ -1,75 +0,0 @@
-import type { AmountLayerDefinition, MeasureExpression, MetricDefinition, SparseValuePolicy } from "@actuarial-ts/core";
-/** Serializable metric metadata: executable warning callbacks are deliberately excluded. */
-export interface DiagnosticMetricProvenance {
-    id: string;
-    definitionVersion: string;
-    displayName: string;
-    unit: string;
-    scale: number;
-    numerator: MeasureExpression;
-    denominator: MeasureExpression;
-    numeratorLabel: string;
-    denominatorLabel: string;
-    basis: string;
-    requiredComponents: string[];
-}
-export interface DiagnosticLayerProvenance {
-    id: string;
-    displayName: string;
-    paidMeasure: string;
-    incurredMeasure: string;
-    paid: AmountLayerDefinition["paid"];
-    incurred: AmountLayerDefinition["incurred"];
-    basis: AmountLayerDefinition["basis"];
-}
-export interface CreateDiagnosticsProvenanceInput {
-    packageVersions: Readonly<Record<string, string>>;
-    formulaPack: {
-        id: string;
-        version: string;
-    };
-    metrics: readonly MetricDefinition[];
-    layers?: readonly AmountLayerDefinition[];
-    exposure: {
-        basis: string;
-        frequencyScale: number;
-    };
-    sparsePolicy: SparseValuePolicy;
-    ageConvention: string;
-    completePeriodCutoffs: Readonly<Record<string, string | number | boolean | null>>;
-    appliedFilters?: Readonly<Record<string, unknown>>;
-    groupingSelections?: Readonly<Record<string, unknown>>;
-    inputReferences: readonly {
-        id: string;
-        hash?: string;
-    }[];
-}
-/**
- * Audit metadata for a diagnostic run. This helper lives in compliance so
- * core numeric results stay deterministic and free of application filter or
- * persistence state. The returned record can be placed directly in
- * `createBundle(...).parameters` or an interchange `extensions` object.
- */
-export declare function createDiagnosticsProvenance(input: CreateDiagnosticsProvenanceInput): {
-    packageVersions: Record<string, string>;
-    formulaPack: {
-        id: string;
-        version: string;
-    };
-    metrics: DiagnosticMetricProvenance[];
-    layers: DiagnosticLayerProvenance[];
-    exposure: {
-        basis: string;
-        frequencyScale: number;
-    };
-    sparsePolicy: SparseValuePolicy;
-    ageConvention: string;
-    completePeriodCutoffs: Record<string, string | number | boolean | null>;
-    appliedFilters?: Record<string, unknown>;
-    groupingSelections?: Record<string, unknown>;
-    inputReferences: {
-        id: string;
-        hash?: string;
-    }[];
-};
-//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics.js

@@ -1,44 +0,0 @@
-/**
- * Audit metadata for a diagnostic run. This helper lives in compliance so
- * core numeric results stay deterministic and free of application filter or
- * persistence state. The returned record can be placed directly in
- * `createBundle(...).parameters` or an interchange `extensions` object.
- */
-export function createDiagnosticsProvenance(input) {
-    const metrics = input.metrics.map((metric) => ({
-        id: metric.id,
-        definitionVersion: metric.version,
-        displayName: metric.displayName,
-        unit: metric.unit,
-        scale: metric.scale,
-        numerator: metric.numerator,
-        denominator: metric.denominator,
-        numeratorLabel: metric.numeratorLabel,
-        denominatorLabel: metric.denominatorLabel,
-        basis: metric.basis,
-        requiredComponents: [...metric.requiredComponents],
-    }));
-    const layers = (input.layers ?? []).map((layer) => ({
-        id: layer.id,
-        displayName: layer.displayName,
-        paidMeasure: layer.paidMeasure,
-        incurredMeasure: layer.incurredMeasure,
-        paid: layer.paid,
-        incurred: layer.incurred,
-        basis: layer.basis,
-    }));
-    return {
-        packageVersions: { ...input.packageVersions },
-        formulaPack: { ...input.formulaPack },
-        metrics,
-        layers,
-        exposure: { ...input.exposure },
-        sparsePolicy: input.sparsePolicy,
-        ageConvention: input.ageConvention,
-        completePeriodCutoffs: { ...input.completePeriodCutoffs },
-        ...(input.appliedFilters ? { appliedFilters: { ...input.appliedFilters } } : {}),
-        ...(input.groupingSelections ? { groupingSelections: { ...input.groupingSelections } } : {}),
-        inputReferences: input.inputReferences.map((reference) => ({ ...reference })),
-    };
-}
-//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AA8CA;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAuC;IAcvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7C,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,iBAAiB,EAAE,MAAM,CAAC,OAAO;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,kBAAkB,EAAE,CAAC,GAAG,MAAM,CAAC,kBAAkB,CAAC;KACnD,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,eAAe,EAAE,EAAE,GAAG,KAAK,CAAC,eAAe,EAAE;QAC7C,WAAW,EAAE,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE;QACrC,OAAO;QACP,MAAM;QACN,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE;QAC/B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,qBAAqB,EAAE,EAAE,GAAG,KAAK,CAAC,qBAAqB,EAAE;QACzD,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,EAAE,GAAG,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;KAC9E,CAAC;AACJ,CAAC"}

package/src/diagnostics.ts

@@ -1,104 +0,0 @@
-import type {
-  AmountLayerDefinition,
-  MeasureExpression,
-  MetricDefinition,
-  SparseValuePolicy,
-} from "@actuarial-ts/core";
-
-/** Serializable metric metadata: executable warning callbacks are deliberately excluded. */
-export interface DiagnosticMetricProvenance {
-  id: string;
-  definitionVersion: string;
-  displayName: string;
-  unit: string;
-  scale: number;
-  numerator: MeasureExpression;
-  denominator: MeasureExpression;
-  numeratorLabel: string;
-  denominatorLabel: string;
-  basis: string;
-  requiredComponents: string[];
-}
-
-export interface DiagnosticLayerProvenance {
-  id: string;
-  displayName: string;
-  paidMeasure: string;
-  incurredMeasure: string;
-  paid: AmountLayerDefinition["paid"];
-  incurred: AmountLayerDefinition["incurred"];
-  basis: AmountLayerDefinition["basis"];
-}
-
-export interface CreateDiagnosticsProvenanceInput {
-  packageVersions: Readonly<Record<string, string>>;
-  formulaPack: { id: string; version: string };
-  metrics: readonly MetricDefinition[];
-  layers?: readonly AmountLayerDefinition[];
-  exposure: { basis: string; frequencyScale: number };
-  sparsePolicy: SparseValuePolicy;
-  ageConvention: string;
-  completePeriodCutoffs: Readonly<Record<string, string | number | boolean | null>>;
-  appliedFilters?: Readonly<Record<string, unknown>>;
-  groupingSelections?: Readonly<Record<string, unknown>>;
-  inputReferences: readonly { id: string; hash?: string }[];
-}
-
-/**
- * Audit metadata for a diagnostic run. This helper lives in compliance so
- * core numeric results stay deterministic and free of application filter or
- * persistence state. The returned record can be placed directly in
- * `createBundle(...).parameters` or an interchange `extensions` object.
- */
-export function createDiagnosticsProvenance(
-  input: CreateDiagnosticsProvenanceInput,
-): {
-  packageVersions: Record<string, string>;
-  formulaPack: { id: string; version: string };
-  metrics: DiagnosticMetricProvenance[];
-  layers: DiagnosticLayerProvenance[];
-  exposure: { basis: string; frequencyScale: number };
-  sparsePolicy: SparseValuePolicy;
-  ageConvention: string;
-  completePeriodCutoffs: Record<string, string | number | boolean | null>;
-  appliedFilters?: Record<string, unknown>;
-  groupingSelections?: Record<string, unknown>;
-  inputReferences: { id: string; hash?: string }[];
-} {
-  const metrics = input.metrics.map((metric) => ({
-    id: metric.id,
-    definitionVersion: metric.version,
-    displayName: metric.displayName,
-    unit: metric.unit,
-    scale: metric.scale,
-    numerator: metric.numerator,
-    denominator: metric.denominator,
-    numeratorLabel: metric.numeratorLabel,
-    denominatorLabel: metric.denominatorLabel,
-    basis: metric.basis,
-    requiredComponents: [...metric.requiredComponents],
-  }));
-  const layers = (input.layers ?? []).map((layer) => ({
-    id: layer.id,
-    displayName: layer.displayName,
-    paidMeasure: layer.paidMeasure,
-    incurredMeasure: layer.incurredMeasure,
-    paid: layer.paid,
-    incurred: layer.incurred,
-    basis: layer.basis,
-  }));
-  return {
-    packageVersions: { ...input.packageVersions },
-    formulaPack: { ...input.formulaPack },
-    metrics,
-    layers,
-    exposure: { ...input.exposure },
-    sparsePolicy: input.sparsePolicy,
-    ageConvention: input.ageConvention,
-    completePeriodCutoffs: { ...input.completePeriodCutoffs },
-    ...(input.appliedFilters ? { appliedFilters: { ...input.appliedFilters } } : {}),
-    ...(input.groupingSelections ? { groupingSelections: { ...input.groupingSelections } } : {}),
-    inputReferences: input.inputReferences.map((reference) => ({ ...reference })),
-  };
-}
-