@actuarial-ts/core 0.7.1 → 0.8.0

package/dist/exposureRevisions.js

@@ -0,0 +1,161 @@
+import { canonicalJson, fnv1a64 } from "./canonical.js";
+import { isRealIsoDate, snapshotDiagnosticJson } from "./diagnosticRuntime.js";
+import { DiagnosticValidationError } from "./types.js";
+function correctedAt(observation) {
+    return observation.revision?.correctedAt;
+}
+function orderValue(observation, precedence) {
+    return precedence === "sequence" ? observation.revision?.sequence : correctedAt(observation);
+}
+function compareOrder(left, right, precedence) {
+    const a = orderValue(left, precedence);
+    const b = orderValue(right, precedence);
+    if (a === undefined || b === undefined)
+        return 0;
+    if (a === b)
+        return left.revisionId.localeCompare(right.revisionId);
+    return a < b ? -1 : 1;
+}
+function economic(observation) {
+    const { source: _source, revisionId: _revisionId, revision: _revision, ...value } = observation;
+    return value;
+}
+/** Selects immutable exposure revisions without allowing later corrections into an as-known run. */
+export function selectExposureRevisions(input) {
+    const issues = [];
+    if (input.selection.revisionView.kind === "as-known" &&
+        !isRealIsoDate(input.selection.revisionView.knowledgeCutoff.slice(0, 10)))
+        issues.push({
+            domain: "configuration",
+            code: "invalid-period",
+            path: "$.selection.revisionView.knowledgeCutoff",
+            message: "Exposure knowledge cutoff must begin with a real Gregorian date",
+        });
+    input.observations.forEach((observation, index) => {
+        const revision = observation.revision;
+        if (input.selection.revisionPrecedence === "sequence" && revision !== undefined && revision.sequence === undefined)
+            issues.push({ domain: "input", code: "missing-required", path: `$.observations[${index}].revision.sequence`, message: "Sequence precedence requires sequence on every revisioned exposure observation" });
+        if (input.selection.revisionPrecedence === "corrected-at" && revision !== undefined && revision.correctedAt === undefined)
+            issues.push({ domain: "input", code: "missing-required", path: `$.observations[${index}].revision.correctedAt`, message: "Corrected-at precedence requires correctedAt on every revisioned exposure observation" });
+    });
+    if (issues.length > 0)
+        throw new DiagnosticValidationError(issues);
+    const groups = new Map();
+    for (const observation of input.observations) {
+        const groupKey = canonicalJson([observation.id, observation.evaluationDate ?? null]);
+        const values = groups.get(groupKey) ?? [];
+        values.push(observation);
+        groups.set(groupKey, values);
+    }
+    const selected = [];
+    const dispositions = [];
+    const findings = [];
+    for (const [, group] of [...groups].sort(([a], [b]) => a.localeCompare(b))) {
+        const observationId = group[0].id;
+        const evaluationDate = group[0].evaluationDate;
+        const disposition = (revisionId, value) => ({
+            observationId,
+            ...(evaluationDate === undefined ? {} : { evaluationDate }),
+            revisionId,
+            disposition: value,
+        });
+        const eligible = group.filter((observation) => {
+            if (input.selection.revisionView.kind !== "as-known")
+                return true;
+            const known = correctedAt(observation);
+            const include = known === undefined || known <= input.selection.revisionView.knowledgeCutoff;
+            if (!include)
+                dispositions.push(disposition(observation.revisionId, "after-knowledge-cutoff"));
+            return include;
+        });
+        if (eligible.length === 0)
+            continue;
+        eligible.sort((a, b) => compareOrder(a, b, input.selection.revisionPrecedence));
+        const winner = eligible.at(-1);
+        const sameOrder = eligible.filter((candidate) => orderValue(candidate, input.selection.revisionPrecedence) === orderValue(winner, input.selection.revisionPrecedence));
+        const distinct = new Set(sameOrder.map((candidate) => canonicalJson(economic(candidate))));
+        if (distinct.size > 1) {
+            sameOrder.forEach((candidate) => dispositions.push(disposition(candidate.revisionId, "conflict")));
+            findings.push({
+                code: "invalid-configuration",
+                capability: "exposure-earning",
+                path: `$.exposures.${observationId}`,
+                message: "Exposure revisions at the selected precedence conflict",
+            });
+            continue;
+        }
+        for (const candidate of eligible) {
+            if (candidate === winner)
+                continue;
+            dispositions.push(disposition(candidate.revisionId, sameOrder.includes(candidate) ? "duplicate" : "superseded"));
+        }
+        if (winner.revision?.action === "delete")
+            dispositions.push(disposition(winner.revisionId, "deleted"));
+        else {
+            dispositions.push(disposition(winner.revisionId, "selected"));
+            selected.push(winner);
+        }
+    }
+    const economicInput = {
+        selection: input.selection,
+        observations: selected.map(economic),
+    };
+    const calculationRevisionId = `fnv1a64-jcs-v1:${fnv1a64(canonicalJson(economicInput))}`;
+    const lineageRevisionId = `fnv1a64-jcs-v1:${fnv1a64(canonicalJson({
+        calculationRevisionId,
+        selected,
+        dispositions,
+    }))}`;
+    return snapshotDiagnosticJson({
+        observations: selected,
+        dispositions,
+        calculationRevisionId,
+        lineageRevisionId,
+        findings,
+    });
+}
+/** Applies the declared origin-static or valuation-specific exposure view. */
+export function selectExposureValuation(input) {
+    const mode = input.scope.valuationSelection ?? "origin-static";
+    const dated = input.observations.filter((observation) => observation.evaluationDate !== undefined);
+    const undated = input.observations.filter((observation) => observation.evaluationDate === undefined);
+    if (mode === "origin-static") {
+        if (dated.length > 0)
+            return snapshotDiagnosticJson({ observations: [], findings: [{
+                        code: "incompatible-semantics", capability: "exposure-earning", path: `$.scopes.${input.scope.id}.valuationSelection`,
+                        message: "Origin-static exposure cannot contain valuation-specific observations",
+                    }] });
+        return snapshotDiagnosticJson({ observations: undated, findings: [] });
+    }
+    if (undated.length > 0)
+        return snapshotDiagnosticJson({ observations: [], findings: [{
+                    code: "missing-prerequisite", capability: "exposure-earning", path: `$.scopes.${input.scope.id}.valuationSelection`,
+                    message: "Valuation-specific exposure requires evaluationDate on every observation", requiredFields: ["evaluationDate"],
+                }] });
+    if (mode === "exact") {
+        const selected = dated.filter((observation) => observation.evaluationDate === input.evaluationDate);
+        return snapshotDiagnosticJson({ observations: selected, findings: selected.length > 0 ? [] : [{
+                    code: "missing-prerequisite", capability: "exposure-earning", path: `$.exposures.${input.evaluationDate}`,
+                    message: "No exact exposure valuation exists for the analysis date",
+                }] });
+    }
+    const bySeries = new Map();
+    for (const observation of dated) {
+        const seriesKey = canonicalJson([observation.id, observation.measureId, observation.startDate ?? null, observation.endDate ?? null, observation.pointDate ?? null, observation.dimensions]);
+        const values = bySeries.get(seriesKey) ?? [];
+        values.push(observation);
+        bySeries.set(seriesKey, values);
+    }
+    const selected = [...bySeries.values()].flatMap((series) => {
+        const eligible = series.filter((observation) => observation.evaluationDate <= input.evaluationDate).sort((a, b) => a.evaluationDate.localeCompare(b.evaluationDate));
+        if (eligible.length === 0)
+            return [];
+        const latest = eligible.at(-1).evaluationDate;
+        return eligible.filter((observation) => observation.evaluationDate === latest);
+    });
+    return snapshotDiagnosticJson({ observations: selected, findings: selected.length > 0 || dated.length === 0 ? [] : [{
+                code: "missing-prerequisite", capability: "exposure-earning", path: `$.exposures.${input.evaluationDate}`,
+                message: "No exposure valuation exists on or before the analysis date",
+            }] });
+}
+//# sourceMappingURL=exposureRevisions.js.map

package/dist/exposureRevisions.js.map

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

package/dist/financialPipeline.d.ts

@@ -0,0 +1,14 @@
+import type { FinancialPipelineResult, FinancialPipelineStage, PreparedHistoricalObservation } from "./customizationContracts.js";
+/** Applies caller-ordered amount transformations and shared terms with a complete audit trail. */
+export declare function applyFinancialPipeline(input: {
+    readonly observations: readonly PreparedHistoricalObservation[];
+    readonly amountMeasureId: string;
+    readonly inputUnit: string;
+    readonly stages: readonly FinancialPipelineStage[];
+    readonly completeFinancialPopulation: boolean;
+    readonly reportingClaims?: readonly {
+        readonly sourceNamespace: string;
+        readonly claimId: string;
+    }[];
+}): FinancialPipelineResult;
+//# sourceMappingURL=financialPipeline.d.ts.map

package/dist/financialPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financialPipeline.d.ts","sourceRoot":"","sources":["../src/financialPipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,uBAAuB,EACvB,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,6BAA6B,CAAC;AA0BrC,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,YAAY,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAChE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,QAAQ,CAAC,2BAA2B,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtG,GAAG,uBAAuB,CAoD1B"}

package/dist/financialPipeline.js

@@ -0,0 +1,75 @@
+import { canonicalJson, fnv1a64 } from "./canonical.js";
+import { isRealIsoDate, snapshotDiagnosticJson } from "./diagnosticRuntime.js";
+import { applyFinancialTerms } from "./financialTerms.js";
+const PIPELINE_MEASURE = "financial-pipeline-amount";
+function key(observation) {
+    return canonicalJson([observation.sourceNamespace, observation.claimId]);
+}
+function unavailable(input, inputUnit, outputUnit, finding) {
+    return snapshotDiagnosticJson({
+        status: "unavailable",
+        inputUnit,
+        outputUnit,
+        calculationIdentity: `fnv1a64-jcs-v1:${fnv1a64(canonicalJson(input))}`,
+        claims: [],
+        findings: [finding],
+    });
+}
+/** Applies caller-ordered amount transformations and shared terms with a complete audit trail. */
+export function applyFinancialPipeline(input) {
+    const identityInput = { kind: "financial-pipeline", ...input };
+    let outputUnit = input.inputUnit;
+    const working = new Map();
+    for (const observation of input.observations) {
+        const amount = observation.measures[input.amountMeasureId];
+        if (typeof amount !== "number" || !Number.isFinite(amount))
+            return unavailable(identityInput, input.inputUnit, outputUnit, { code: "missing-prerequisite", capability: "shared-financial-terms", path: `$.observations.${observation.claimId}.measures.${input.amountMeasureId}`, message: `Financial pipeline requires finite ${input.amountMeasureId}`, requiredFields: [input.amountMeasureId] });
+        if (working.has(key(observation)))
+            return unavailable(identityInput, input.inputUnit, outputUnit, { code: "incompatible-semantics", capability: "shared-financial-terms", path: "$.observations", message: "Financial pipeline requires one selected observation per claim" });
+        working.set(key(observation), { observation, inputAmount: amount, amount, stages: [] });
+    }
+    for (const stage of input.stages) {
+        if (stage.kind === "adjustment") {
+            const adjustment = stage.adjustment;
+            if ((adjustment.kind === "scale" && (!(adjustment.factor > 0) || !Number.isFinite(adjustment.factor))) ||
+                (adjustment.kind === "currency" && (!(adjustment.rate > 0) || !Number.isFinite(adjustment.rate) || !isRealIsoDate(adjustment.rateDate))))
+                return unavailable(identityInput, input.inputUnit, outputUnit, { code: "invalid-configuration", capability: "shared-financial-terms", path: `$.stages.${adjustment.id}`, message: "Scale/currency adjustments require a positive finite factor and currency requires a real rateDate" });
+            if (adjustment.kind === "currency") {
+                if (outputUnit !== adjustment.fromUnit)
+                    return unavailable(identityInput, input.inputUnit, outputUnit, { code: "incompatible-semantics", capability: "shared-financial-terms", path: `$.stages.${adjustment.id}.fromUnit`, message: `Currency adjustment expected ${adjustment.fromUnit} but current unit is ${outputUnit}` });
+                outputUnit = adjustment.toUnit;
+            }
+            for (const item of working.values()) {
+                const before = item.amount;
+                if (adjustment.kind === "scale")
+                    item.amount *= adjustment.factor;
+                else if (adjustment.kind === "currency")
+                    item.amount *= adjustment.rate;
+                else {
+                    const measureId = adjustment.kind === "net-recovery" ? adjustment.recoveryMeasureId : adjustment.expenseMeasureId;
+                    const component = item.observation.measures[measureId];
+                    if (typeof component !== "number" || !Number.isFinite(component))
+                        return unavailable(identityInput, input.inputUnit, outputUnit, { code: "missing-prerequisite", capability: "shared-financial-terms", path: `$.observations.${item.observation.claimId}.measures.${measureId}`, message: `Adjustment ${adjustment.id} requires finite ${measureId}`, requiredFields: [measureId] });
+                    item.amount += adjustment.kind === "include-expense" ? component : -component;
+                }
+                item.stages.push({ stageId: adjustment.id, stageKind: "adjustment", inputAmount: before, outputAmount: item.amount });
+            }
+        }
+        else {
+            const observations = [...working.values()].map((item) => snapshotDiagnosticJson({ ...item.observation, measures: { ...item.observation.measures, [PIPELINE_MEASURE]: item.amount } }));
+            const terms = stage.terms.map((term) => ({ ...term, measureId: PIPELINE_MEASURE }));
+            const applied = applyFinancialTerms({ observations, terms, completeFinancialPopulation: input.completeFinancialPopulation, reportingClaims: input.reportingClaims });
+            if (applied.status === "unavailable")
+                return snapshotDiagnosticJson({ status: "unavailable", inputUnit: input.inputUnit, outputUnit, calculationIdentity: `fnv1a64-jcs-v1:${fnv1a64(canonicalJson(identityInput))}`, claims: [], findings: applied.findings });
+            for (const claim of applied.claims) {
+                const item = working.get(canonicalJson([claim.sourceNamespace, claim.claimId]));
+                const before = item.amount;
+                item.amount = claim.outputAmount;
+                item.stages.push({ stageId: stage.id, stageKind: "terms", inputAmount: before, outputAmount: item.amount });
+            }
+        }
+    }
+    const claims = [...working.values()].sort((a, b) => key(a.observation).localeCompare(key(b.observation))).map((item) => ({ sourceNamespace: item.observation.sourceNamespace, claimId: item.observation.claimId, inputAmount: item.inputAmount, outputAmount: item.amount, stages: item.stages }));
+    return snapshotDiagnosticJson({ status: "available", inputUnit: input.inputUnit, outputUnit, calculationIdentity: `fnv1a64-jcs-v1:${fnv1a64(canonicalJson(identityInput))}`, claims, findings: [] });
+}
+//# sourceMappingURL=financialPipeline.js.map

package/dist/financialPipeline.js.map

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

package/dist/financialTerms.d.ts

@@ -0,0 +1,20 @@
+import type { FinancialTermApplicationResult, FinancialTermDefinition, FinancialTermScheduleEntry, FinancialTermScheduleResolution, AnalysisMeasureDefinitionV1, PreparedHistoricalObservation } from "./customizationContracts.js";
+/** Resolves the highest-priority applicable term schedule entry at a coverage date. */
+export declare function resolveFinancialTermSchedule(input: {
+    readonly entries: readonly FinancialTermScheduleEntry[];
+    readonly coverageDate: string;
+    readonly policyIds: readonly string[];
+    readonly coverageIds: readonly string[];
+}): FinancialTermScheduleResolution;
+/** Applies ordered shared financial terms to the complete population, then marks the reporting view. */
+export declare function applyFinancialTerms(input: {
+    readonly observations: readonly PreparedHistoricalObservation[];
+    readonly terms: readonly FinancialTermDefinition[];
+    readonly completeFinancialPopulation: boolean;
+    readonly measureDefinitions?: readonly AnalysisMeasureDefinitionV1[];
+    readonly reportingClaims?: readonly {
+        readonly sourceNamespace: string;
+        readonly claimId: string;
+    }[];
+}): FinancialTermApplicationResult;
+//# sourceMappingURL=financialTerms.d.ts.map

package/dist/financialTerms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financialTerms.d.ts","sourceRoot":"","sources":["../src/financialTerms.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,6BAA6B,CAAC;AAqBrC,uFAAuF;AACvF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,GAAG,+BAA+B,CAmDlC;AAqCD,wGAAwG;AACxG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAChE,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,QAAQ,CAAC,2BAA2B,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtG,GAAG,8BAA8B,CAkIjC"}

package/dist/financialTerms.js

@@ -0,0 +1,205 @@
+import { canonicalJson, fnv1a64 } from "./canonical.js";
+import { isRealIsoDate, snapshotDiagnosticJson } from "./diagnosticRuntime.js";
+function claimKey(sourceNamespace, claimId) {
+    return canonicalJson([sourceNamespace, claimId]);
+}
+function finding(code, message, requiredFields) {
+    return {
+        code,
+        capability: "shared-financial-terms",
+        path: "$.financialTerms",
+        message,
+        ...(requiredFields === undefined ? {} : { requiredFields }),
+    };
+}
+/** Resolves the highest-priority applicable term schedule entry at a coverage date. */
+export function resolveFinancialTermSchedule(input) {
+    if (!isRealIsoDate(input.coverageDate))
+        return snapshotDiagnosticJson({
+            status: "unavailable",
+            entryId: null,
+            termIds: [],
+            finding: finding("missing-prerequisite", "A valid coverage date is required", ["coverageDate"]),
+        });
+    if (input.entries.some((entry) => !isRealIsoDate(entry.effectiveStart) ||
+        !isRealIsoDate(entry.effectiveEnd) ||
+        entry.effectiveStart >= entry.effectiveEnd ||
+        !Number.isSafeInteger(entry.priority)))
+        return snapshotDiagnosticJson({
+            status: "unavailable",
+            entryId: null,
+            termIds: [],
+            finding: finding("invalid-configuration", "Term schedule entries require valid intervals and safe-integer priorities"),
+        });
+    const applicable = input.entries.filter((entry) => {
+        const dateMatches = entry.effectiveStart <= input.coverageDate && input.coverageDate < entry.effectiveEnd;
+        const policyMatches = entry.policyIds === undefined || entry.policyIds.some((id) => input.policyIds.includes(id));
+        const coverageMatches = entry.coverageIds === undefined || entry.coverageIds.some((id) => input.coverageIds.includes(id));
+        return dateMatches && policyMatches && coverageMatches;
+    });
+    if (applicable.length === 0)
+        return snapshotDiagnosticJson({
+            status: "unavailable",
+            entryId: null,
+            termIds: [],
+            finding: finding("missing-prerequisite", "No financial term schedule entry applies"),
+        });
+    const priority = Math.max(...applicable.map((entry) => entry.priority));
+    const selected = applicable.filter((entry) => entry.priority === priority);
+    if (selected.length !== 1)
+        return snapshotDiagnosticJson({
+            status: "ambiguous",
+            entryId: null,
+            termIds: [],
+            finding: finding("ambiguous-attribution", `Multiple financial term schedule entries share priority ${priority}`),
+        });
+    return snapshotDiagnosticJson({
+        status: "resolved",
+        entryId: selected[0].id,
+        termIds: selected[0].termIds,
+        finding: null,
+    });
+}
+function limitedAmount(total, attachment, limit) {
+    const excess = Math.max(total - attachment, 0);
+    return limit === null ? excess : Math.min(excess, limit);
+}
+function unavailable(observations, terms, issues) {
+    const identity = `fnv1a64-jcs-v1:${fnv1a64(canonicalJson({ kind: "financial-terms", observations, terms }))}`;
+    return snapshotDiagnosticJson({
+        status: "unavailable",
+        calculationIdentity: identity,
+        inputTotal: null,
+        outputTotal: null,
+        claims: [],
+        findings: issues,
+    });
+}
+/** Applies ordered shared financial terms to the complete population, then marks the reporting view. */
+export function applyFinancialTerms(input) {
+    if (!input.completeFinancialPopulation)
+        return unavailable(input.observations, input.terms, [
+            finding("incomplete-financial-population", "Shared financial terms require the complete related population"),
+        ]);
+    if (input.terms.some((term) => term.kind === "policy-aggregate" && term.allocation === "chronological"))
+        return unavailable(input.observations, input.terms, [
+            finding("unsupported-operation", "Chronological aggregate allocation requires ordered transaction input", ["ordered transactions"]),
+        ]);
+    const sourceMeasure = (id) => {
+        const definition = input.measureDefinitions?.find((measure) => measure.id === id);
+        if (definition === undefined)
+            return input.measureDefinitions === undefined ? id : undefined;
+        return definition.statistic.kind === "sum" ? definition.statistic.measureId : undefined;
+    };
+    const measureIds = [...new Set(input.terms.map((term) => sourceMeasure(term.measureId)))];
+    if (measureIds.includes(undefined))
+        return unavailable(input.observations, input.terms, [
+            finding("incompatible-semantics", "Financial terms require a referenced sum measure"),
+        ]);
+    if (measureIds.length > 1)
+        return unavailable(input.observations, input.terms, [
+            finding("incompatible-semantics", "One ordered financial term application must use a single amount measure"),
+        ]);
+    const measureId = measureIds[0];
+    if (measureId === undefined)
+        return unavailable(input.observations, input.terms, [
+            finding("invalid-configuration", "At least one financial term is required"),
+        ]);
+    const seen = new Set();
+    const working = [];
+    for (const observation of input.observations) {
+        const key = claimKey(observation.sourceNamespace, observation.claimId);
+        if (seen.has(key))
+            return unavailable(input.observations, input.terms, [
+                finding("incompatible-semantics", "Financial input must contain one selected observation per claim"),
+            ]);
+        seen.add(key);
+        const amount = observation.measures[measureId];
+        if (typeof amount !== "number" || !Number.isFinite(amount))
+            return unavailable(input.observations, input.terms, [
+                finding("missing-prerequisite", `Claim ${observation.claimId} lacks finite measure ${measureId}`, [measureId]),
+            ]);
+        if (amount < 0)
+            return unavailable(input.observations, input.terms, [
+                finding("unsupported-operation", "Negative amounts and recoveries require a separately declared financial convention"),
+            ]);
+        working.push({ observation, key, inputAmount: amount, amount, stages: [] });
+    }
+    working.sort((left, right) => left.key.localeCompare(right.key));
+    for (const term of input.terms) {
+        const groups = new Map();
+        for (const claim of working) {
+            let groupId;
+            if (term.kind === "claim-layer")
+                groupId = claim.key;
+            else if (term.kind === "occurrence-layer") {
+                const occurrenceId = claim.observation.relationships.occurrenceId;
+                if (occurrenceId !== undefined)
+                    groupId = canonicalJson([claim.observation.sourceNamespace, occurrenceId]);
+            }
+            else {
+                const policyIds = claim.observation.relationships.policyIds;
+                if (policyIds?.length === 1)
+                    groupId = canonicalJson([claim.observation.sourceNamespace, policyIds[0]]);
+            }
+            if (groupId === undefined)
+                return unavailable(input.observations, input.terms, [
+                    finding("missing-prerequisite", `${term.kind} requires one unambiguous grouping identifier for claim ${claim.observation.claimId}`, [term.kind === "occurrence-layer" ? "occurrenceId" : "policyId"]),
+                ]);
+            const group = groups.get(groupId);
+            if (group === undefined)
+                groups.set(groupId, [claim]);
+            else
+                group.push(claim);
+        }
+        for (const [groupId, group] of groups) {
+            const total = group.reduce((sum, claim) => sum + claim.amount, 0);
+            const output = term.kind === "policy-aggregate"
+                ? limitedAmount(total, term.deductible, term.limit)
+                : limitedAmount(total, term.attachment, term.limit);
+            let allocated = 0;
+            group.forEach((claim, index) => {
+                const before = claim.amount;
+                const after = index === group.length - 1
+                    ? output - allocated
+                    : total === 0
+                        ? 0
+                        : output * (before / total);
+                allocated += after;
+                claim.amount = Object.is(after, -0) ? 0 : after;
+                claim.stages.push({
+                    termId: term.id,
+                    groupId,
+                    inputAmount: before,
+                    outputAmount: claim.amount,
+                    removedAmount: before - claim.amount,
+                });
+            });
+        }
+    }
+    const reported = new Set(input.reportingClaims?.map((claim) => claimKey(claim.sourceNamespace, claim.claimId)) ?? working.map((claim) => claim.key));
+    const claims = working
+        .sort((left, right) => left.key.localeCompare(right.key))
+        .map((claim) => ({
+        sourceNamespace: claim.observation.sourceNamespace,
+        claimId: claim.observation.claimId,
+        reported: reported.has(claim.key),
+        inputAmount: claim.inputAmount,
+        outputAmount: claim.amount,
+        stages: claim.stages,
+    }));
+    const identityValue = {
+        kind: "financial-terms",
+        population: [...input.observations].sort((left, right) => claimKey(left.sourceNamespace, left.claimId).localeCompare(claimKey(right.sourceNamespace, right.claimId))),
+        terms: input.terms,
+    };
+    return snapshotDiagnosticJson({
+        status: "available",
+        calculationIdentity: `fnv1a64-jcs-v1:${fnv1a64(canonicalJson(identityValue))}`,
+        inputTotal: claims.reduce((total, claim) => total + claim.inputAmount, 0),
+        outputTotal: claims.reduce((total, claim) => total + claim.outputAmount, 0),
+        claims,
+        findings: [],
+    });
+}
+//# sourceMappingURL=financialTerms.js.map

package/dist/financialTerms.js.map

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

package/dist/fnvAccumulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fnvAccumulator.d.ts","sourceRoot":"","sources":["../src/fnvAccumulator.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAgB,oBAAoB;kBAIlB,UAAU;;EAc3B"}
+{"version":3,"file":"fnvAccumulator.d.ts","sourceRoot":"","sources":["../src/fnvAccumulator.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAgB,oBAAoB;kBAIlB,UAAU;;EAoB3B"}

package/dist/fnvAccumulator.js

@@ -4,14 +4,20 @@ export function createFnvAccumulator() {
     let low = 0x84222325;
     return {
         update(bytes) {
-            for (const byte of bytes) {
-                low = (low ^ byte) >>> 0;
+            // Keep the hot byte loop's words local rather than writing captured
+            // accumulator state on every byte. Chunk boundaries do not affect FNV.
+            let nextHigh = high;
+            let nextLow = low;
+            for (let index = 0; index < bytes.length; index++) {
+                nextLow = (nextLow ^ bytes[index]) >>> 0;
                 // FNV_PRIME = 2^40 + 435. Every intermediate stays below 2^42,
                 // preserving the exact modular multiplication of the BigInt form.
-                const product = low * 0x1b3;
-                high = (high * 0x1b3 + Math.floor(product / 0x100000000) + (low << 8)) >>> 0;
-                low = product >>> 0;
+                const product = nextLow * 0x1b3;
+                nextHigh = (nextHigh * 0x1b3 + Math.floor(product / 0x100000000) + (nextLow << 8)) >>> 0;
+                nextLow = product >>> 0;
             }
+            high = nextHigh;
+            low = nextLow;
         },
         digest() {
             return high.toString(16).padStart(8, "0") + low.toString(16).padStart(8, "0");

package/dist/fnvAccumulator.js.map

@@ -1 +1 @@
-{"version":3,"file":"fnvAccumulator.js","sourceRoot":"","sources":["../src/fnvAccumulator.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB;IAClC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,IAAI,GAAG,GAAG,UAAU,CAAC;IACrB,OAAO;QACL,MAAM,CAAC,KAAiB;YACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzB,+DAA+D;gBAC/D,kEAAkE;gBAClE,MAAM,OAAO,GAAG,GAAG,GAAG,KAAK,CAAC;gBAC5B,IAAI,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC7E,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,MAAM;YACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChF,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"fnvAccumulator.js","sourceRoot":"","sources":["../src/fnvAccumulator.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB;IAClC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,IAAI,GAAG,GAAG,UAAU,CAAC;IACrB,OAAO;QACL,MAAM,CAAC,KAAiB;YACtB,oEAAoE;YACpE,uEAAuE;YACvE,IAAI,QAAQ,GAAG,IAAI,CAAC;YACpB,IAAI,OAAO,GAAG,GAAG,CAAC;YAClB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBAClD,OAAO,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC,KAAK,CAAC,CAAC;gBAC1C,+DAA+D;gBAC/D,kEAAkE;gBAClE,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;gBAChC,QAAQ,GAAG,CAAC,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACzF,OAAO,GAAG,OAAO,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC;YAChB,GAAG,GAAG,OAAO,CAAC;QAChB,CAAC;QACD,MAAM;YACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/historyPreparation.d.ts

@@ -0,0 +1,8 @@
+import { type HistoricalDatasetInput, type PreparedHistoricalDataset } from "./customizationContracts.js";
+/**
+ * Selects immutable source revisions and assembles claim observations without
+ * using arrival order. Unknown input should first pass the data-package Zod
+ * boundary; this pure core boundary independently protects its typed contract.
+ */
+export declare function prepareHistoricalDataset(input: HistoricalDatasetInput): PreparedHistoricalDataset;
+//# sourceMappingURL=historyPreparation.d.ts.map

package/dist/historyPreparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyPreparation.d.ts","sourceRoot":"","sources":["../src/historyPreparation.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,sBAAsB,EAI3B,KAAK,yBAAyB,EAE/B,MAAM,6BAA6B,CAAC;AA0drC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,sBAAsB,GAAG,yBAAyB,CA0JjG"}