@actuarial-ts/compliance 0.1.0

package/dist/ledger.js

@@ -0,0 +1,85 @@
+/**
+ * Assumption ledger: an append-only record of every assumption an analysis
+ * used, separating machine defaults from actuarial/agent judgment, feeding
+ * the ASOP 41 assumptions-and-judgments and changes-from-prior disclosures.
+ *
+ * Ground truth:
+ * - The ledger is IMMUTABLE: `recordAssumption` returns a NEW frozen ledger;
+ *   the input ledger, its entries array, and every recorded entry are frozen.
+ *   Nothing is ever edited or deleted — a corrected assumption is a new entry
+ *   for the same field, and the LATEST entry per field is the live value.
+ * - `seq` is assigned by the ledger (entries.length + 1), never by the caller.
+ * - `rationale` is REQUIRED (throws MISSING_RATIONALE) whenever
+ *   actor !== "default": undocumented judgment is exactly what the ledger
+ *   exists to prevent. Machine defaults need no rationale — the method's
+ *   model card documents them.
+ * - `changedAssumptions` diffs the LATEST entry per field on each side and
+ *   compares values by canonical JSON, so key insertion order never causes a
+ *   false "changed". Output field lists are lexicographically sorted for
+ *   deterministic disclosure rendering.
+ * - Timestamps are caller-supplied ISO strings (purity: no clock reads).
+ *
+ * These utilities are designed to support the actuary's compliance with
+ * ASOP No. 41; responsibility for compliance remains with the credentialed
+ * actuary.
+ */
+import { canonicalJson, ComplianceError } from "./bundle.js";
+/** An empty, frozen ledger. */
+export function createLedger() {
+    return Object.freeze({ entries: Object.freeze([]) });
+}
+/**
+ * Appends an entry, returning a NEW frozen ledger; the input ledger is
+ * untouched. Assigns seq = entries.length + 1. Throws
+ * ComplianceError("MISSING_RATIONALE") when actor !== "default" and rationale
+ * is missing or blank.
+ */
+export function recordAssumption(ledger, entry) {
+    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 = Object.freeze({ ...entry, seq: ledger.entries.length + 1 });
+    return Object.freeze({ entries: Object.freeze([...ledger.entries, recorded]) });
+}
+/** Entries that represent judgment (actor !== "default"), in ledger order. */
+export function judgmentEntries(ledger) {
+    return ledger.entries.filter((e) => e.actor !== "default");
+}
+/** Latest entry per field; ledger order is seq order, so the last write wins. */
+function latestByField(ledger) {
+    const latest = new Map();
+    for (const entry of ledger.entries)
+        latest.set(entry.field, entry);
+    return latest;
+}
+/**
+ * Diffs the LATEST entry per field between a prior analysis's ledger and the
+ * current one. Values compare by canonical JSON (key order never matters).
+ * All output lists are sorted by field for deterministic rendering.
+ */
+export function changedAssumptions(prior, current) {
+    const priorLatest = latestByField(prior);
+    const currentLatest = latestByField(current);
+    const added = [];
+    const removed = [];
+    const changed = [];
+    const fields = [...new Set([...priorLatest.keys(), ...currentLatest.keys()])].sort();
+    for (const field of fields) {
+        const before = priorLatest.get(field);
+        const after = currentLatest.get(field);
+        if (before === undefined) {
+            if (after !== undefined)
+                added.push(field);
+            continue;
+        }
+        if (after === undefined) {
+            removed.push(field);
+            continue;
+        }
+        if (canonicalJson(before.value) !== canonicalJson(after.value)) {
+            changed.push({ field, priorValue: before.value, currentValue: after.value });
+        }
+    }
+    return { added, removed, changed };
+}
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

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

package/dist/metadata.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Estimate metadata: the typed identification of what an unpaid-claim
+ * estimate IS — its intended purpose and users, the intended measure, the
+ * gross/net and LAE basis, and the accounting/valuation/review dates
+ * (ASOP 43 terminology; the disclosure generator renders these under
+ * ASOP 41).
+ *
+ * Ground truth:
+ * - `validateMetadata` VALIDATES, it does not construct: metadata is often
+ *   built up field-by-field over the course of an analysis, so callers keep
+ *   plain objects and ask for the problem list whenever they need to know
+ *   whether the metadata is disclosure-ready. Empty array = valid.
+ * - Validation is defensive at runtime (built-up metadata may have been cast
+ *   from a partial), so required-field presence and enum membership are
+ *   checked even though the types already say so.
+ * - Dates are caller-supplied ISO strings (yyyy-mm-dd), checked for real
+ *   calendar validity (leap years included); the module never reads a clock.
+ * - `percentile` is a fraction strictly between 0 and 1 (e.g. 0.75 for the
+ *   75th percentile) and is only meaningful — and only allowed — when
+ *   intendedMeasure.kind === "specified-percentile".
+ *
+ * These utilities are designed to support the actuary's compliance with
+ * ASOP Nos. 41 and 43; responsibility for compliance remains with the
+ * credentialed actuary.
+ */
+export declare const INTENDED_MEASURE_KINDS: readonly ["central-estimate", "high-estimate", "low-estimate", "specified-percentile", "range"];
+export type IntendedMeasureKind = (typeof INTENDED_MEASURE_KINDS)[number];
+export interface IntendedMeasure {
+    kind: IntendedMeasureKind;
+    /** Fraction in (0, 1), e.g. 0.75; required iff kind === "specified-percentile". */
+    percentile?: number;
+}
+export declare const GROSS_NET_BASES: readonly ["gross", "net-of-reinsurance", "net-of-salvage-subro", "net-all"];
+export type GrossNetBasis = (typeof GROSS_NET_BASES)[number];
+export declare const LAE_TREATMENTS: readonly ["excluding-lae", "including-all-lae", "dcc-only", "aao-only"];
+export type LaeTreatment = (typeof LAE_TREATMENTS)[number];
+export interface EstimateBasis {
+    grossNet: GrossNetBasis;
+    laeTreatment: LaeTreatment;
+}
+export interface EstimateMetadata {
+    /** Why the estimate exists (e.g. "unpaid claim estimate for the 2025 annual statement"). */
+    intendedPurpose: string;
+    /** Who may rely on the estimate. */
+    intendedUsers?: string[];
+    intendedMeasure: IntendedMeasure;
+    basis: EstimateBasis;
+    /** ISO date (yyyy-mm-dd) used to separate paid from unpaid (ASOP 43 accounting date). */
+    accountingDate: string;
+    /** ISO date through which transactions are reflected in the data (ASOP 43 valuation date). */
+    valuationDate: string;
+    /** ISO cutoff for information reflected in the analysis (ASOP 41 review date), when later than the valuation date. */
+    reviewDate?: string;
+    scopeNotes?: string;
+    /** ISO 4217-style currency label (e.g. "USD"); informational, not validated against a table. */
+    currency?: string;
+}
+/**
+ * Returns the list of problems keeping `metadata` from being disclosure-ready;
+ * an empty array means valid. Never throws — validation, not construction.
+ */
+export declare function validateMetadata(metadata: EstimateMetadata): string[];
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,sBAAsB,iGAMzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,6EAKlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,cAAc,yEAKjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,yFAAyF;IACzF,cAAc,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC;IACtB,sHAAsH;IACtH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAwErE"}

package/dist/metadata.js

@@ -0,0 +1,138 @@
+/**
+ * Estimate metadata: the typed identification of what an unpaid-claim
+ * estimate IS — its intended purpose and users, the intended measure, the
+ * gross/net and LAE basis, and the accounting/valuation/review dates
+ * (ASOP 43 terminology; the disclosure generator renders these under
+ * ASOP 41).
+ *
+ * Ground truth:
+ * - `validateMetadata` VALIDATES, it does not construct: metadata is often
+ *   built up field-by-field over the course of an analysis, so callers keep
+ *   plain objects and ask for the problem list whenever they need to know
+ *   whether the metadata is disclosure-ready. Empty array = valid.
+ * - Validation is defensive at runtime (built-up metadata may have been cast
+ *   from a partial), so required-field presence and enum membership are
+ *   checked even though the types already say so.
+ * - Dates are caller-supplied ISO strings (yyyy-mm-dd), checked for real
+ *   calendar validity (leap years included); the module never reads a clock.
+ * - `percentile` is a fraction strictly between 0 and 1 (e.g. 0.75 for the
+ *   75th percentile) and is only meaningful — and only allowed — when
+ *   intendedMeasure.kind === "specified-percentile".
+ *
+ * These utilities are designed to support the actuary's compliance with
+ * ASOP Nos. 41 and 43; responsibility for compliance remains with the
+ * credentialed actuary.
+ */
+export const INTENDED_MEASURE_KINDS = [
+    "central-estimate",
+    "high-estimate",
+    "low-estimate",
+    "specified-percentile",
+    "range",
+];
+export const GROSS_NET_BASES = [
+    "gross",
+    "net-of-reinsurance",
+    "net-of-salvage-subro",
+    "net-all",
+];
+export const LAE_TREATMENTS = [
+    "excluding-lae",
+    "including-all-lae",
+    "dcc-only",
+    "aao-only",
+];
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+/** True for a well-formed yyyy-mm-dd string naming a real calendar date. */
+function isIsoDate(value) {
+    const match = ISO_DATE.exec(value);
+    if (!match)
+        return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    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];
+    return day >= 1 && day <= daysInMonth;
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+function checkDate(problems, name, value, required) {
+    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)}`);
+    }
+}
+/**
+ * Returns the list of problems keeping `metadata` from being disclosure-ready;
+ * an empty array means valid. Never throws — validation, not construction.
+ */
+export function validateMetadata(metadata) {
+    const problems = [];
+    if (!isNonEmptyString(metadata.intendedPurpose)) {
+        problems.push("intendedPurpose is required and must be a non-empty string");
+    }
+    if (metadata.intendedUsers !== undefined) {
+        if (!Array.isArray(metadata.intendedUsers)) {
+            problems.push("intendedUsers, when provided, must be an array of non-empty strings");
+        }
+        else {
+            metadata.intendedUsers.forEach((user, index) => {
+                if (!isNonEmptyString(user)) {
+                    problems.push(`intendedUsers[${index}] must be a non-empty string`);
+                }
+            });
+        }
+    }
+    const measure = metadata.intendedMeasure;
+    if (measure === undefined) {
+        problems.push("intendedMeasure is required");
+    }
+    else {
+        if (!INTENDED_MEASURE_KINDS.includes(measure.kind)) {
+            problems.push(`intendedMeasure.kind must be one of ${INTENDED_MEASURE_KINDS.join(", ")}; got ${JSON.stringify(measure.kind)}`);
+        }
+        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 must be a fraction strictly between 0 and 1 (e.g. 0.75); got ${JSON.stringify(p)}`);
+            }
+        }
+        else if (measure.percentile !== undefined) {
+            problems.push(`intendedMeasure.percentile is only meaningful when kind is "specified-percentile"; got kind ${JSON.stringify(measure.kind)}`);
+        }
+    }
+    const basis = metadata.basis;
+    if (basis === undefined) {
+        problems.push("basis is required");
+    }
+    else {
+        if (!GROSS_NET_BASES.includes(basis.grossNet)) {
+            problems.push(`basis.grossNet must be one of ${GROSS_NET_BASES.join(", ")}; got ${JSON.stringify(basis.grossNet)}`);
+        }
+        if (!LAE_TREATMENTS.includes(basis.laeTreatment)) {
+            problems.push(`basis.laeTreatment must be one of ${LAE_TREATMENTS.join(", ")}; got ${JSON.stringify(basis.laeTreatment)}`);
+        }
+    }
+    checkDate(problems, "accountingDate", metadata.accountingDate, true);
+    checkDate(problems, "valuationDate", metadata.valuationDate, true);
+    checkDate(problems, "reviewDate", metadata.reviewDate, false);
+    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)) {
+        problems.push("currency, when provided, must be a non-empty string");
+    }
+    return problems;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/modelCards.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ASOP No. 56 (Modeling) model cards.
+ *
+ * ASOP 56 asks an actuary who relies on models designed by others to
+ * disclose the extent of reliance and to maintain a basic understanding of
+ * the model: its basic operations, dependencies, sensitivities, and known
+ * weaknesses. These cards ARE that content for every method the SDK ships —
+ * ready to drop into workpapers or the generated disclosure.
+ *
+ * The cards describe the implementations in @actuarial-ts/core as built and
+ * tested (each specification matches the code and its published-value test
+ * pins), not idealized textbook variants. They are designed to support the
+ * actuary's compliance with ASOP No. 56; responsibility for compliance
+ * remains with the credentialed actuary.
+ */
+export type MethodId = "chainLadder" | "mack" | "bornhuetterFerguson" | "benktander" | "capeCod" | "expectedClaims" | "frequencySeverity" | "berquistCaseAdequacy" | "berquistSettlement" | "tailFitting" | "cappingIlf" | "trend" | "onLevel" | "munichChainLadder" | "odpBootstrap" | "merzWuthrich" | "clarkLdf" | "clarkCapeCod" | "ulae" | "discountUnpaid" | "caseOutstanding" | "fisherLange" | "salvageSubro" | "netOfRecoveries";
+export interface ModelCard {
+    method: MethodId;
+    title: string;
+    intendedUse: string;
+    specification: string;
+    keyAssumptions: string[];
+    weaknesses: string[];
+    sensitivities: string[];
+    literature: string[];
+}
+export declare const MODEL_CARDS: Record<MethodId, ModelCard>;
+/** Every method id the disclosure generator recognizes. */
+export declare const MODEL_CARD_IDS: MethodId[];
+//# sourceMappingURL=modelCards.d.ts.map

package/dist/modelCards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCards.d.ts","sourceRoot":"","sources":["../src/modelCards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,MAAM,GACN,qBAAqB,GACrB,YAAY,GACZ,SAAS,GACT,gBAAgB,GAChB,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,aAAa,GACb,YAAY,GACZ,OAAO,GACP,SAAS,GACT,mBAAmB,GACnB,cAAc,GACd,cAAc,GACd,UAAU,GACV,cAAc,GACd,MAAM,GACN,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CA0dnD,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,cAAc,EAA+B,QAAQ,EAAE,CAAC"}