@actuarial-ts/core 0.6.0 → 0.6.1

package/src/diagnosticIdentity.ts

@@ -24,12 +24,244 @@ import type {
   DiagnosticReviewRule,
   DiagnosticRuleOperand,
   DiagnosticSourceLocation,
+  DiagnosticsFilter,
 } from "./diagnosticDefinitions.js";
 import type {
   DiagnosticClaimExpression,
   DiagnosticMeasureExpression,
   DiagnosticRoleExpression,
 } from "./diagnosticExpressions.js";
+import { normalizeDiagnosticPeriodWithAxis } from "./diagnosticPeriodAxis.js";
+import {
+  diagnosticJsonPreflight,
+  isDiagnosticPlainRecord,
+  isDiagnosticToken,
+  normalizeDiagnosticNumber,
+} from "./diagnosticRuntime.js";
+import {
+  DiagnosticValidationError,
+  type DiagnosticValidationIssue,
+} from "./types.js";
+
+export type DiagnosticIdentityProjection<T> = T extends DiagnosticSourceLocation
+  ? NormalizedDiagnosticSourceLocationIdentity
+  : T extends readonly (infer U)[]
+    ? readonly DiagnosticIdentityProjection<U>[]
+    : T extends object
+      ? { readonly [K in keyof T]: DiagnosticIdentityProjection<T[K]> }
+      : T;
+
+export interface NormalizedDiagnosticsFilterIdentity
+  extends NormalizedDiagnosticReviewFilterIdentity {
+  readonly outputGroups: readonly string[] | null;
+  readonly instanceIds: readonly string[] | null;
+}
+
+/** Validates selector shapes without interpreting periods against a definition. */
+function validateFilterIdentityInput(filter: DiagnosticsFilter): void {
+  const issues: DiagnosticValidationIssue[] = [
+    ...diagnosticJsonPreflight(filter, "configuration"),
+  ];
+  if (issues.length) throw new DiagnosticValidationError(issues);
+  if (!isDiagnosticPlainRecord(filter))
+    throw new DiagnosticValidationError([
+      {
+        domain: "configuration",
+        code: "invalid-type",
+        path: "$",
+        message: "Filter must be a plain object or null",
+      },
+    ]);
+
+  const lists = [
+    "sourceGroups", "outputGroups", "origins", "valuations", "instanceIds",
+  ];
+  const labels = [
+    "originFrom", "originThrough", "valuationFrom", "valuationThrough",
+  ];
+  const bounds = ["minDevelopmentAge", "maxDevelopmentAge"];
+  const checkToken = (value: unknown, path: string) => {
+    if (!isDiagnosticToken(value))
+      issues.push({
+        domain: "configuration",
+        code: "invalid-string",
+        path,
+        message: "Filter selectors must use nonempty token strings",
+      });
+  };
+  for (const key of Object.keys(filter).sort()) {
+    const value: unknown = filter[key];
+    const path = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)
+      ? `$.${key}`
+      : `$[${JSON.stringify(key)}]`;
+    if (lists.includes(key)) {
+      if (!Array.isArray(value))
+        issues.push({
+          domain: "configuration",
+          code: "invalid-type",
+          path,
+          message: "Filter selector must be an array",
+        });
+      else
+        value.forEach((item, index) => checkToken(item, `${path}[${index}]`));
+    } else if (labels.includes(key)) checkToken(value, path);
+    else if (bounds.includes(key)) {
+      if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        issues.push({
+          domain: "configuration",
+          code: "invalid-number",
+          path,
+          message: "Development-age bounds must be nonnegative safe integers",
+        });
+    } else
+      issues.push({
+        domain: "configuration",
+        code: "unknown-key",
+        path,
+        message: `Unknown filter key ${key}`,
+      });
+  }
+  if (
+    typeof filter.minDevelopmentAge === "number" &&
+    typeof filter.maxDevelopmentAge === "number" &&
+    filter.minDevelopmentAge > filter.maxDevelopmentAge
+  )
+    issues.push({
+      domain: "configuration",
+      code: "invalid-configuration",
+      path: "$",
+      message: "Minimum development age exceeds maximum",
+    });
+  if (issues.length) throw new DiagnosticValidationError(issues);
+}
+
+/** Materializes optional selectors; period aliases must already be canonical. */
+export function normalizeDiagnosticsFilterIdentity(
+  filter: DiagnosticsFilter | null,
+): NormalizedDiagnosticsFilterIdentity | null {
+  if (filter === null) return null;
+  validateFilterIdentityInput(filter);
+  return deepFreeze({
+    sourceGroups:
+      filter.sourceGroups === undefined
+        ? null
+        : sortedUnique(filter.sourceGroups),
+    outputGroups:
+      filter.outputGroups === undefined
+        ? null
+        : sortedUnique(filter.outputGroups),
+    origins: filter.origins === undefined ? null : sortedUnique(filter.origins),
+    originFrom: filter.originFrom ?? null,
+    originThrough: filter.originThrough ?? null,
+    valuations:
+      filter.valuations === undefined ? null : sortedUnique(filter.valuations),
+    valuationFrom: filter.valuationFrom ?? null,
+    valuationThrough: filter.valuationThrough ?? null,
+    minDevelopmentAge:
+      filter.minDevelopmentAge === undefined
+        ? null
+        : normalizeDiagnosticNumber(filter.minDevelopmentAge),
+    maxDevelopmentAge:
+      filter.maxDevelopmentAge === undefined
+        ? null
+        : normalizeDiagnosticNumber(filter.maxDevelopmentAge),
+    instanceIds:
+      filter.instanceIds === undefined ? null : sortedUnique(filter.instanceIds),
+  });
+}
+
+/**
+ * Owned identity copy. Source slots are schema-defined; free JSON dimensions
+ * must not be interpreted as source evidence just because a key looks similar.
+ */
+export function projectDiagnosticIdentity<T>(
+  value: T,
+): DiagnosticIdentityProjection<T> {
+  const issues = diagnosticJsonPreflight(value, "input", {
+    maxNodes: Number.MAX_SAFE_INTEGER,
+  });
+  if (issues.length) throw new DiagnosticValidationError(issues);
+  const clone = (
+    item: unknown,
+    sourceSlot = false,
+    freeJson = false,
+    path = "$",
+  ): unknown => {
+    if (item === null || typeof item !== "object")
+      return typeof item === "number" && Object.is(item, -0) ? 0 : item;
+    if (Array.isArray(item))
+      return Object.freeze(
+        item.map((child, index) =>
+          clone(child, sourceSlot, freeJson, `${path}[${index}]`),
+        ),
+      );
+    const record = item as Record<string, unknown>;
+    if (sourceSlot && typeof record.artifactId === "string") {
+      const sourceIssues = [];
+      for (const key of Object.keys(record)) {
+        const fieldPath = `${path}.${key}`;
+        if (
+          ![
+            "artifactId",
+            "sourceFile",
+            "sourceSheet",
+            "sourceRow",
+            "sourceCell",
+          ].includes(key)
+        )
+          sourceIssues.push({
+            domain: "input" as const,
+            code: "unknown-key" as const,
+            path: fieldPath,
+            message: `Unknown source-location key ${key}`,
+          });
+        else if (key === "sourceRow") {
+          if (
+            record[key] !== null &&
+            !(
+              typeof record[key] === "number" &&
+              Number.isSafeInteger(record[key]) &&
+              record[key] >= 0
+            )
+          )
+            sourceIssues.push({
+              domain: "input" as const,
+              code: "invalid-number" as const,
+              path: fieldPath,
+              message: "Source row must be a nonnegative safe integer or null",
+            });
+        } else if (
+          !(key !== "artifactId" && record[key] === null) &&
+          !isDiagnosticToken(record[key])
+        )
+          sourceIssues.push({
+            domain: "input" as const,
+            code: "invalid-string" as const,
+            path: fieldPath,
+            message: "Source location must use nonempty token strings",
+          });
+      }
+      if (sourceIssues.length)
+        throw new DiagnosticValidationError(sourceIssues);
+      return normalizeDiagnosticSourceLocation(
+        record as unknown as DiagnosticSourceLocation,
+      );
+    }
+    const result = Object.create(null) as Record<string, unknown>;
+    for (const key of Object.keys(record).sort()) {
+      const opaque =
+        freeJson || key === "groupDimensions" || key === "dimensions";
+      result[key] = clone(
+        record[key],
+        !opaque && (key === "source" || key === "sources"),
+        opaque,
+        `${path}.${key}`,
+      );
+    }
+    return Object.freeze(result);
+  };
+  return clone(value) as DiagnosticIdentityProjection<T>;
+}
 
 function compareCodeUnits(left: string, right: string): number {
   return left === right ? 0 : left < right ? -1 : 1;
@@ -39,9 +271,13 @@ function sortedUnique(values: readonly string[]): readonly string[] {
   return [...new Set(values)].sort(compareCodeUnits);
 }
 
-function sortedRecord<T>(entries: readonly (readonly [string, T])[]): Readonly<Record<string, T>> {
+function sortedRecord<T>(
+  entries: readonly (readonly [string, T])[],
+): Readonly<Record<string, T>> {
   const result = Object.create(null) as Record<string, T>;
-  for (const [key, value] of [...entries].sort(([left], [right]) => compareCodeUnits(left, right))) {
+  for (const [key, value] of [...entries].sort(([left], [right]) =>
+    compareCodeUnits(left, right),
+  )) {
     result[key] = value;
   }
   return result;
@@ -49,29 +285,39 @@ function sortedRecord<T>(entries: readonly (readonly [string, T])[]): Readonly<R
 
 function normalizeJsonValue<T>(value: T): T {
   if (typeof value === "number" && Object.is(value, -0)) return 0 as T;
-  if (Array.isArray(value)) return value.map((item) => normalizeJsonValue(item)) as T;
+  if (Array.isArray(value))
+    return value.map((item) => normalizeJsonValue(item)) as T;
   if (value !== null && typeof value === "object") {
-    return sortedRecord(Object.entries(value as Record<string, unknown>).map(([key, item]) =>
-      [key, normalizeJsonValue(item)] as const,
-    )) as T;
+    return sortedRecord(
+      Object.entries(value as Record<string, unknown>).map(
+        ([key, item]) => [key, normalizeJsonValue(item)] as const,
+      ),
+    ) as T;
   }
   return value;
 }
 
-function deepFreeze<T>(value: T, seen = new WeakSet<object>()): DiagnosticDeepReadonly<T> {
-  if (value === null || typeof value !== "object") return value as DiagnosticDeepReadonly<T>;
+function deepFreeze<T>(
+  value: T,
+  seen = new WeakSet<object>(),
+): DiagnosticDeepReadonly<T> {
+  if (value === null || typeof value !== "object")
+    return value as DiagnosticDeepReadonly<T>;
   if (seen.has(value)) return value as DiagnosticDeepReadonly<T>;
   seen.add(value);
-  for (const child of Object.values(value as Record<string, unknown>)) deepFreeze(child, seen);
+  for (const child of Object.values(value as Record<string, unknown>))
+    deepFreeze(child, seen);
   return Object.freeze(value) as DiagnosticDeepReadonly<T>;
 }
 
 function attributes(
   value: Readonly<Record<string, string | number | boolean | null>> | undefined,
 ): Readonly<Record<string, string | number | boolean | null>> {
-  return sortedRecord(Object.entries(value ?? {}).map(([key, item]) =>
-    [key, normalizeJsonValue(item)] as const,
-  ));
+  return sortedRecord(
+    Object.entries(value ?? {}).map(
+      ([key, item]) => [key, normalizeJsonValue(item)] as const,
+    ),
+  );
 }
 
 export type NormalizedAmountLimitationIdentity =
@@ -80,7 +326,11 @@ export type NormalizedAmountLimitationIdentity =
       readonly kind: "layer" | "pre-limited";
       readonly attachment: number;
       readonly limit: number | null;
-      readonly application: "claim" | "occurrence" | "policy" | "source-defined";
+      readonly application:
+        | "claim"
+        | "occurrence"
+        | "policy"
+        | "source-defined";
       readonly derivation:
         | { readonly kind: "sdk" }
         | {
@@ -111,7 +361,9 @@ export interface NormalizedDiagnosticReviewFilterIdentity {
 export type NormalizedDiagnosticPeriodAxisIdentity =
   | DiagnosticDeepReadonly<Extract<DiagnosticPeriodAxis, { kind: "calendar" }>>
   | (Omit<
-      DiagnosticDeepReadonly<Extract<DiagnosticPeriodAxis, { kind: "ordered" }>>,
+      DiagnosticDeepReadonly<
+        Extract<DiagnosticPeriodAxis, { kind: "ordered" }>
+      >,
       "origins" | "valuations"
     > & {
       readonly origins: readonly {
@@ -129,11 +381,16 @@ export type NormalizedDiagnosticPeriodAxisIdentity =
 export interface NormalizedDiagnosticFormulaIdentity {
   readonly id: string;
   readonly version: string;
-  readonly roles: Readonly<Record<string, {
-    readonly kind: DiagnosticMeasureKind;
-    readonly compatibilityGroup: string | null;
-    readonly developmentSemantics: DiagnosticDevelopmentSemantics | null;
-  }>>;
+  readonly roles: Readonly<
+    Record<
+      string,
+      {
+        readonly kind: DiagnosticMeasureKind;
+        readonly compatibilityGroup: string | null;
+        readonly developmentSemantics: DiagnosticDevelopmentSemantics | null;
+      }
+    >
+  >;
   readonly numerator: DiagnosticDeepReadonly<DiagnosticRoleExpression>;
   readonly denominator: DiagnosticDeepReadonly<DiagnosticRoleExpression>;
   readonly denominatorPolicy: "positive-or-null";
@@ -205,7 +462,9 @@ export interface NormalizedDiagnosticDefinitionIdentity {
     readonly subject: DiagnosticCountPopulationDefinition["subject"];
     readonly unit: string;
     readonly description: string;
-    readonly attributes: Readonly<Record<string, string | number | boolean | null>>;
+    readonly attributes: Readonly<
+      Record<string, string | number | boolean | null>
+    >;
   }[];
   readonly exposureBases: readonly {
     readonly id: string;
@@ -214,7 +473,9 @@ export interface NormalizedDiagnosticDefinitionIdentity {
     readonly unit: string;
     readonly description: string;
     readonly sourceDescription: string | null;
-    readonly attributes: Readonly<Record<string, string | number | boolean | null>>;
+    readonly attributes: Readonly<
+      Record<string, string | number | boolean | null>
+    >;
   }[];
   readonly amountBases: readonly {
     readonly id: string;
@@ -227,7 +488,9 @@ export interface NormalizedDiagnosticDefinitionIdentity {
       readonly limitation: NormalizedAmountLimitationIdentity;
     }[];
     readonly sourceDescription: string | null;
-    readonly attributes: Readonly<Record<string, string | number | boolean | null>>;
+    readonly attributes: Readonly<
+      Record<string, string | number | boolean | null>
+    >;
   }[];
   readonly derivedMeasures: readonly DiagnosticDeepReadonly<DiagnosticDerivedMeasureDefinition>[];
   readonly formulas: readonly NormalizedDiagnosticFormulaIdentity[];
@@ -235,7 +498,9 @@ export interface NormalizedDiagnosticDefinitionIdentity {
     readonly id: string;
     readonly version: string;
     readonly formulaId: string;
-    readonly bindings: Readonly<Record<string, DiagnosticDeepReadonly<DiagnosticMeasureExpression>>>;
+    readonly bindings: Readonly<
+      Record<string, DiagnosticDeepReadonly<DiagnosticMeasureExpression>>
+    >;
     readonly presentation: DiagnosticDeepReadonly<DiagnosticMetricPresentation>;
     readonly rules: readonly {
       readonly id: string;
@@ -260,7 +525,9 @@ export interface NormalizedDiagnosticCalculationScope {
     readonly id: string;
     readonly version: string;
     readonly formulaId: string;
-    readonly bindings: Readonly<Record<string, DiagnosticDeepReadonly<DiagnosticMeasureExpression>>>;
+    readonly bindings: Readonly<
+      Record<string, DiagnosticDeepReadonly<DiagnosticMeasureExpression>>
+    >;
   };
   readonly lossRowGrain: "claim" | "aggregate";
   readonly measures: readonly {
@@ -280,13 +547,17 @@ export interface NormalizedDiagnosticCalculationScope {
     readonly id: string;
     readonly subject: DiagnosticCountPopulationDefinition["subject"];
     readonly unit: string;
-    readonly attributes: Readonly<Record<string, string | number | boolean | null>>;
+    readonly attributes: Readonly<
+      Record<string, string | number | boolean | null>
+    >;
   }[];
   readonly exposureBases: readonly {
     readonly id: string;
     readonly basis: DiagnosticExposureBasisDefinition["basis"];
     readonly unit: string;
-    readonly attributes: Readonly<Record<string, string | number | boolean | null>>;
+    readonly attributes: Readonly<
+      Record<string, string | number | boolean | null>
+    >;
   }[];
   readonly amountBases: readonly {
     readonly id: string;
@@ -297,7 +568,9 @@ export interface NormalizedDiagnosticCalculationScope {
       readonly treatment: "included" | "excluded" | "unknown";
       readonly limitation: NormalizedAmountLimitationIdentity;
     }[];
-    readonly attributes: Readonly<Record<string, string | number | boolean | null>>;
+    readonly attributes: Readonly<
+      Record<string, string | number | boolean | null>
+    >;
   }[];
   readonly derivedMeasures: readonly DiagnosticDeepReadonly<DiagnosticDerivedMeasureDefinition>[];
 }
@@ -310,36 +583,53 @@ export interface NormalizedDiagnosticSourceLocationIdentity {
   readonly sourceCell: string | null;
 }
 
-function normalizeLimitation(limitation: AmountLimitation): NormalizedAmountLimitationIdentity {
+function normalizeLimitation(
+  limitation: AmountLimitation,
+): NormalizedAmountLimitationIdentity {
   if (limitation.kind === "unlimited") return { kind: "unlimited" };
   if (limitation.kind === "unknown") {
     return { kind: "unknown", description: limitation.description ?? null };
   }
   return {
     kind: limitation.kind,
-    attachment: Object.is(limitation.attachment, -0) ? 0 : limitation.attachment,
-    limit: limitation.limit !== null && Object.is(limitation.limit, -0) ? 0 : limitation.limit,
+    attachment: Object.is(limitation.attachment, -0)
+      ? 0
+      : limitation.attachment,
+    limit:
+      limitation.limit !== null && Object.is(limitation.limit, -0)
+        ? 0
+        : limitation.limit,
     application: limitation.application,
-    derivation: limitation.derivation.kind === "sdk"
-      ? { kind: "sdk" }
-      : {
-          kind: "external",
-          actor: limitation.derivation.actor,
-          transformationRef: limitation.derivation.transformationRef,
-        },
+    derivation:
+      limitation.derivation.kind === "sdk"
+        ? { kind: "sdk" }
+        : {
+            kind: "external",
+            actor: limitation.derivation.actor,
+            transformationRef: limitation.derivation.transformationRef,
+          },
   };
 }
 
-function normalizeMeasureExpression<T extends DiagnosticMeasureExpression | DiagnosticClaimExpression>(
-  expression: T,
-): DiagnosticDeepReadonly<T> {
-  if (expression.op === "measure") return { op: "measure", measureId: expression.measureId } as DiagnosticDeepReadonly<T>;
+function normalizeMeasureExpression<
+  T extends DiagnosticMeasureExpression | DiagnosticClaimExpression,
+>(expression: T): DiagnosticDeepReadonly<T> {
+  if (expression.op === "measure")
+    return {
+      op: "measure",
+      measureId: expression.measureId,
+    } as DiagnosticDeepReadonly<T>;
   if (expression.op === "claim-layer") {
     return {
       op: "claim-layer",
       measureId: expression.measureId,
-      attachment: Object.is(expression.attachment, -0) ? 0 : expression.attachment,
-      limit: expression.limit !== null && Object.is(expression.limit, -0) ? 0 : expression.limit,
+      attachment: Object.is(expression.attachment, -0)
+        ? 0
+        : expression.attachment,
+      limit:
+        expression.limit !== null && Object.is(expression.limit, -0)
+          ? 0
+          : expression.limit,
     } as DiagnosticDeepReadonly<T>;
   }
   if (expression.op === "subtract") {
@@ -355,7 +645,9 @@ function normalizeMeasureExpression<T extends DiagnosticMeasureExpression | Diag
   } as unknown as DiagnosticDeepReadonly<T>;
 }
 
-function normalizeRoleExpression(expression: DiagnosticRoleExpression): DiagnosticDeepReadonly<DiagnosticRoleExpression> {
+function normalizeRoleExpression(
+  expression: DiagnosticRoleExpression,
+): DiagnosticDeepReadonly<DiagnosticRoleExpression> {
   if (expression.op === "role") return { op: "role", role: expression.role };
   if (expression.op === "subtract") {
     return {
@@ -371,43 +663,95 @@ function normalizeTolerance(
   tolerance: { absolute?: number; relative?: number } | undefined,
 ): NormalizedDiagnosticToleranceIdentity {
   return {
-    absolute: Object.is(tolerance?.absolute ?? 0, -0) ? 0 : (tolerance?.absolute ?? 0),
-    relative: Object.is(tolerance?.relative ?? 0, -0) ? 0 : (tolerance?.relative ?? 0),
+    absolute: Object.is(tolerance?.absolute ?? 0, -0)
+      ? 0
+      : (tolerance?.absolute ?? 0),
+    relative: Object.is(tolerance?.relative ?? 0, -0)
+      ? 0
+      : (tolerance?.relative ?? 0),
   };
 }
 
-function normalizeRuleOperand(operand: DiagnosticRuleOperand): DiagnosticDeepReadonly<DiagnosticRuleOperand> {
+function normalizeRuleOperand(
+  operand: DiagnosticRuleOperand,
+): DiagnosticDeepReadonly<DiagnosticRuleOperand> {
   if (operand.source === "measure") {
-    return { source: "measure", expression: normalizeMeasureExpression(operand.expression) };
+    return {
+      source: "measure",
+      expression: normalizeMeasureExpression(operand.expression),
+    };
   }
-  if (operand.source === "calculation") return { source: "calculation", field: operand.field };
-  return { source: "constant", value: Object.is(operand.value, -0) ? 0 : operand.value };
+  if (operand.source === "calculation")
+    return { source: "calculation", field: operand.field };
+  return {
+    source: "constant",
+    value: Object.is(operand.value, -0) ? 0 : operand.value,
+  };
 }
 
-function normalizeReviewOperand(operand: DiagnosticReviewOperand): DiagnosticDeepReadonly<DiagnosticReviewOperand> {
-  if (operand.op === "constant") return { op: "constant", value: Object.is(operand.value, -0) ? 0 : operand.value };
+function normalizeReviewOperand(
+  operand: DiagnosticReviewOperand,
+): DiagnosticDeepReadonly<DiagnosticReviewOperand> {
+  if (operand.op === "constant")
+    return {
+      op: "constant",
+      value: Object.is(operand.value, -0) ? 0 : operand.value,
+    };
   return normalizeMeasureExpression(operand);
 }
 
-function normalizeReviewFilter(filter: DiagnosticReviewFilter): NormalizedDiagnosticReviewFilterIdentity {
-  return {
-    sourceGroups: filter.sourceGroups === undefined ? null : sortedUnique(filter.sourceGroups),
-    origins: filter.origins === undefined ? null : sortedUnique(filter.origins),
-    originFrom: filter.originFrom ?? null,
-    originThrough: filter.originThrough ?? null,
-    valuations: filter.valuations === undefined ? null : sortedUnique(filter.valuations),
-    valuationFrom: filter.valuationFrom ?? null,
-    valuationThrough: filter.valuationThrough ?? null,
-    minDevelopmentAge: filter.minDevelopmentAge === undefined
+function normalizeReviewFilter(
+  filter: DiagnosticReviewFilter,
+  axis: DiagnosticPeriodAxis,
+): NormalizedDiagnosticReviewFilterIdentity {
+  const normalizeMany = (
+    side: "origin" | "valuation",
+    values: readonly string[] | undefined,
+  ) =>
+    values === undefined
       ? null
-      : Object.is(filter.minDevelopmentAge, -0) ? 0 : filter.minDevelopmentAge,
-    maxDevelopmentAge: filter.maxDevelopmentAge === undefined
+      : sortedUnique(
+          values.map(
+            (value) =>
+              normalizeDiagnosticPeriodWithAxis(axis, side, value)!.label,
+          ),
+        );
+  const normalizeOne = (
+    side: "origin" | "valuation",
+    value: string | undefined,
+  ) =>
+    value === undefined
       ? null
-      : Object.is(filter.maxDevelopmentAge, -0) ? 0 : filter.maxDevelopmentAge,
+      : normalizeDiagnosticPeriodWithAxis(axis, side, value)!.label;
+  return {
+    sourceGroups:
+      filter.sourceGroups === undefined
+        ? null
+        : sortedUnique(filter.sourceGroups),
+    origins: normalizeMany("origin", filter.origins),
+    originFrom: normalizeOne("origin", filter.originFrom),
+    originThrough: normalizeOne("origin", filter.originThrough),
+    valuations: normalizeMany("valuation", filter.valuations),
+    valuationFrom: normalizeOne("valuation", filter.valuationFrom),
+    valuationThrough: normalizeOne("valuation", filter.valuationThrough),
+    minDevelopmentAge:
+      filter.minDevelopmentAge === undefined
+        ? null
+        : Object.is(filter.minDevelopmentAge, -0)
+          ? 0
+          : filter.minDevelopmentAge,
+    maxDevelopmentAge:
+      filter.maxDevelopmentAge === undefined
+        ? null
+        : Object.is(filter.maxDevelopmentAge, -0)
+          ? 0
+          : filter.maxDevelopmentAge,
   };
 }
 
-function normalizePeriodAxis(axis: DiagnosticPeriodAxis): NormalizedDiagnosticPeriodAxisIdentity {
+function normalizePeriodAxis(
+  axis: DiagnosticPeriodAxis,
+): NormalizedDiagnosticPeriodAxisIdentity {
   if (axis.kind === "calendar") {
     return {
       kind: "calendar",
@@ -419,11 +763,20 @@ function normalizePeriodAxis(axis: DiagnosticPeriodAxis): NormalizedDiagnosticPe
       ageOffset: Object.is(axis.ageOffset, -0) ? 0 : axis.ageOffset,
     };
   }
-  const coordinates = (values: typeof axis.origins) => values.map((coordinate) => ({
-    label: coordinate.label,
-    aliases: sortedUnique(coordinate.aliases ?? []),
-    coordinate: Object.is(coordinate.coordinate, -0) ? 0 : coordinate.coordinate,
-  })).sort((left, right) => left.coordinate - right.coordinate || compareCodeUnits(left.label, right.label));
+  const coordinates = (values: typeof axis.origins) =>
+    values
+      .map((coordinate) => ({
+        label: coordinate.label,
+        aliases: sortedUnique(coordinate.aliases ?? []),
+        coordinate: Object.is(coordinate.coordinate, -0)
+          ? 0
+          : coordinate.coordinate,
+      }))
+      .sort(
+        (left, right) =>
+          left.coordinate - right.coordinate ||
+          compareCodeUnits(left.label, right.label),
+      );
   return {
     kind: "ordered",
     id: axis.id,
@@ -438,17 +791,26 @@ function normalizePeriodAxis(axis: DiagnosticPeriodAxis): NormalizedDiagnosticPe
 function topologicalDerivations(
   derivations: readonly DiagnosticDerivedMeasureDefinition[],
 ): readonly DiagnosticDerivedMeasureDefinition[] {
-  const byOutput = new Map(derivations.map((derivation) => [derivation.outputMeasureId, derivation]));
-  const remaining = new Map(derivations.map((derivation) => [derivation.id, derivation]));
+  const byOutput = new Map(
+    derivations.map((derivation) => [derivation.outputMeasureId, derivation]),
+  );
+  const remaining = new Map(
+    derivations.map((derivation) => [derivation.id, derivation]),
+  );
   const emittedOutputs = new Set<string>();
   const ordered: DiagnosticDerivedMeasureDefinition[] = [];
   while (remaining.size > 0) {
-    const ready = [...remaining.values()].filter((derivation) =>
-      expressionDependencies(derivation.expression)
-        .filter((id) => byOutput.has(id))
-        .every((id) => emittedOutputs.has(id)),
-    ).sort((left, right) => compareCodeUnits(left.id, right.id));
-    if (ready.length === 0) return [...derivations].sort((left, right) => compareCodeUnits(left.id, right.id));
+    const ready = [...remaining.values()]
+      .filter((derivation) =>
+        expressionDependencies(derivation.expression)
+          .filter((id) => byOutput.has(id))
+          .every((id) => emittedOutputs.has(id)),
+      )
+      .sort((left, right) => compareCodeUnits(left.id, right.id));
+    if (ready.length === 0)
+      return [...derivations].sort((left, right) =>
+        compareCodeUnits(left.id, right.id),
+      );
     for (const derivation of ready) {
       ordered.push(derivation);
       emittedOutputs.add(derivation.outputMeasureId);
@@ -458,7 +820,10 @@ function topologicalDerivations(
   return ordered;
 }
 
-function normalizeReviewRule(rule: DiagnosticReviewRule): NormalizedDiagnosticReviewRuleIdentity {
+function normalizeReviewRule(
+  rule: DiagnosticReviewRule,
+  axis: DiagnosticPeriodAxis,
+): NormalizedDiagnosticReviewRuleIdentity {
   const base: NormalizedDiagnosticReviewRuleBase = {
     id: rule.id,
     code: rule.code,
@@ -508,8 +873,21 @@ function normalizeReviewRule(rule: DiagnosticReviewRule): NormalizedDiagnosticRe
     kind: "control-total",
     expression: normalizeMeasureExpression(rule.expression),
     expected: Object.is(rule.expected, -0) ? 0 : rule.expected,
-    filter: rule.filter === undefined ? null : normalizeReviewFilter(rule.filter),
-    projection: normalizeJsonValue(rule.projection),
+    filter:
+      rule.filter === undefined
+        ? null
+        : normalizeReviewFilter(rule.filter, axis),
+    projection:
+      rule.projection.kind === "valuation"
+        ? {
+            kind: "valuation",
+            valuation: normalizeDiagnosticPeriodWithAxis(
+              axis,
+              "valuation",
+              rule.projection.valuation,
+            )!.label,
+          }
+        : normalizeJsonValue(rule.projection),
   };
 }
 
@@ -521,80 +899,107 @@ export function normalizeDiagnosticDefinition(
     id: definition.id,
     version: definition.version,
     lossRowGrain: definition.lossRowGrain,
-    measures: definition.measures.map((measure) => ({
-      id: measure.id,
-      displayName: measure.displayName,
-      description: measure.description,
-      source: measure.source,
-      kind: measure.kind,
-      unit: measure.unit,
-      developmentSemantics: measure.developmentSemantics,
-      aggregation: "sum" as const,
-      missing: measure.missing,
-      basisId: measure.basisId ?? null,
-      countPopulationId: measure.countPopulationId ?? null,
-      exposureBasisId: measure.exposureBasisId ?? null,
-      exposureTiming: measure.exposureTiming ?? null,
-    })).sort((left, right) => compareCodeUnits(left.id, right.id)),
-    countPopulations: definition.countPopulations.map((population) => ({
-      id: population.id,
-      displayName: population.displayName,
-      subject: population.subject,
-      unit: population.unit,
-      description: population.description,
-      attributes: attributes(population.attributes),
-    })).sort((left, right) => compareCodeUnits(left.id, right.id)),
-    exposureBases: definition.exposureBases.map((basis) => ({
-      id: basis.id,
-      displayName: basis.displayName,
-      basis: basis.basis,
-      unit: basis.unit,
-      description: basis.description,
-      sourceDescription: basis.sourceDescription ?? null,
-      attributes: attributes(basis.attributes),
-    })).sort((left, right) => compareCodeUnits(left.id, right.id)),
-    amountBases: definition.amountBases.map((basis) => ({
-      id: basis.id,
-      displayName: basis.displayName,
-      currency: basis.currency,
-      perspective: basis.perspective,
-      components: basis.components.map((component) => ({
-        id: component.id,
-        treatment: component.treatment,
-        limitation: normalizeLimitation(component.limitation),
-      })).sort((left, right) => compareCodeUnits(left.id, right.id)),
-      sourceDescription: basis.sourceDescription ?? null,
-      attributes: attributes(basis.attributes),
-    })).sort((left, right) => compareCodeUnits(left.id, right.id)),
-    derivedMeasures: topologicalDerivations(definition.derivedMeasures).map((derivation) => ({
-      id: derivation.id,
-      outputMeasureId: derivation.outputMeasureId,
-      expression: normalizeMeasureExpression(derivation.expression),
-    })),
-    formulas: definition.formulas.map((formula) => ({
-      id: formula.id,
-      version: formula.version,
-      roles: sortedRecord(Object.entries(formula.roles).map(([name, role]) => [name, {
-        kind: role.kind,
-        compatibilityGroup: role.compatibilityGroup ?? null,
-        developmentSemantics: role.developmentSemantics ?? null,
-      }] as const)),
-      numerator: normalizeRoleExpression(formula.numerator),
-      denominator: normalizeRoleExpression(formula.denominator),
-      denominatorPolicy: "positive-or-null" as const,
-    })).sort((left, right) => compareCodeUnits(left.id, right.id)),
+    measures: definition.measures
+      .map((measure) => ({
+        id: measure.id,
+        displayName: measure.displayName,
+        description: measure.description,
+        source: measure.source,
+        kind: measure.kind,
+        unit: measure.unit,
+        developmentSemantics: measure.developmentSemantics,
+        aggregation: "sum" as const,
+        missing: measure.missing,
+        basisId: measure.basisId ?? null,
+        countPopulationId: measure.countPopulationId ?? null,
+        exposureBasisId: measure.exposureBasisId ?? null,
+        exposureTiming: measure.exposureTiming ?? null,
+      }))
+      .sort((left, right) => compareCodeUnits(left.id, right.id)),
+    countPopulations: definition.countPopulations
+      .map((population) => ({
+        id: population.id,
+        displayName: population.displayName,
+        subject: population.subject,
+        unit: population.unit,
+        description: population.description,
+        attributes: attributes(population.attributes),
+      }))
+      .sort((left, right) => compareCodeUnits(left.id, right.id)),
+    exposureBases: definition.exposureBases
+      .map((basis) => ({
+        id: basis.id,
+        displayName: basis.displayName,
+        basis: basis.basis,
+        unit: basis.unit,
+        description: basis.description,
+        sourceDescription: basis.sourceDescription ?? null,
+        attributes: attributes(basis.attributes),
+      }))
+      .sort((left, right) => compareCodeUnits(left.id, right.id)),
+    amountBases: definition.amountBases
+      .map((basis) => ({
+        id: basis.id,
+        displayName: basis.displayName,
+        currency: basis.currency,
+        perspective: basis.perspective,
+        components: basis.components
+          .map((component) => ({
+            id: component.id,
+            treatment: component.treatment,
+            limitation: normalizeLimitation(component.limitation),
+          }))
+          .sort((left, right) => compareCodeUnits(left.id, right.id)),
+        sourceDescription: basis.sourceDescription ?? null,
+        attributes: attributes(basis.attributes),
+      }))
+      .sort((left, right) => compareCodeUnits(left.id, right.id)),
+    derivedMeasures: topologicalDerivations(definition.derivedMeasures).map(
+      (derivation) => ({
+        id: derivation.id,
+        outputMeasureId: derivation.outputMeasureId,
+        expression: normalizeMeasureExpression(derivation.expression),
+      }),
+    ),
+    formulas: definition.formulas
+      .map((formula) => ({
+        id: formula.id,
+        version: formula.version,
+        roles: sortedRecord(
+          Object.entries(formula.roles).map(
+            ([name, role]) =>
+              [
+                name,
+                {
+                  kind: role.kind,
+                  compatibilityGroup: role.compatibilityGroup ?? null,
+                  developmentSemantics: role.developmentSemantics ?? null,
+                },
+              ] as const,
+          ),
+        ),
+        numerator: normalizeRoleExpression(formula.numerator),
+        denominator: normalizeRoleExpression(formula.denominator),
+        denominatorPolicy: "positive-or-null" as const,
+      }))
+      .sort((left, right) => compareCodeUnits(left.id, right.id)),
     instances: definition.instances.map((instance) => ({
       id: instance.id,
       version: instance.version,
       formulaId: instance.formulaId,
-      bindings: sortedRecord(Object.entries(instance.bindings).map(([role, expression]) =>
-        [role, normalizeMeasureExpression(expression)] as const,
-      )),
+      bindings: sortedRecord(
+        Object.entries(instance.bindings).map(
+          ([role, expression]) =>
+            [role, normalizeMeasureExpression(expression)] as const,
+        ),
+      ),
       presentation: {
         displayName: instance.presentation.displayName,
         description: instance.presentation.description,
         displayUnit: instance.presentation.displayUnit,
-        scale: Object.is(instance.presentation.scale, -0) ? 0 : instance.presentation.scale,
+        scale: Object.is(instance.presentation.scale, -0)
+          ? 0
+          : instance.presentation.scale,
         numeratorLabel: instance.presentation.numeratorLabel,
         denominatorLabel: instance.presentation.denominatorLabel,
       },
@@ -611,7 +1016,9 @@ export function normalizeDiagnosticDefinition(
         },
       })),
     })),
-    reviewRules: definition.reviewRules.map(normalizeReviewRule),
+    reviewRules: definition.reviewRules.map((rule) =>
+      normalizeReviewRule(rule, definition.periodAxis),
+    ),
     periodAxis: normalizePeriodAxis(definition.periodAxis),
   };
   return deepFreeze(normalized);
@@ -624,60 +1031,116 @@ export function normalizeDiagnosticSourceLocation(
     artifactId: source.artifactId,
     sourceFile: source.sourceFile ?? null,
     sourceSheet: source.sourceSheet ?? null,
-    sourceRow: source.sourceRow === undefined ? null : Object.is(source.sourceRow, -0) ? 0 : source.sourceRow,
+    sourceRow:
+      source.sourceRow === undefined
+        ? null
+        : Object.is(source.sourceRow, -0)
+          ? 0
+          : source.sourceRow,
     sourceCell: source.sourceCell ?? null,
   });
 }
 
-function expressionDependencies(expression: DiagnosticMeasureExpression | DiagnosticClaimExpression): readonly string[] {
-  if (expression.op === "measure" || expression.op === "claim-layer") return [expression.measureId];
-  if (expression.op === "subtract") return sortedUnique([
-    ...expressionDependencies(expression.left),
-    ...expressionDependencies(expression.right),
-  ]);
+function expressionDependencies(
+  expression: DiagnosticMeasureExpression | DiagnosticClaimExpression,
+): readonly string[] {
+  if (expression.op === "measure" || expression.op === "claim-layer")
+    return [expression.measureId];
+  if (expression.op === "subtract")
+    return sortedUnique([
+      ...expressionDependencies(expression.left),
+      ...expressionDependencies(expression.right),
+    ]);
   return sortedUnique(expression.terms.flatMap(expressionDependencies));
 }
 
-function ruleMeasureDependencies(operand: DiagnosticDeepReadonly<DiagnosticRuleOperand>): readonly string[] {
-  return operand.source === "measure" ? expressionDependencies(operand.expression) : [];
+function ruleMeasureDependencies(
+  operand: DiagnosticDeepReadonly<DiagnosticRuleOperand>,
+): readonly string[] {
+  return operand.source === "measure"
+    ? expressionDependencies(operand.expression)
+    : [];
 }
 
 function tag<K extends string, T>(kind: K, property: string, value: T): string {
-  return `fnv1a64-jcs-v1:${fnv1a64(canonicalJson({
-    identityVersion: 1,
-    kind,
-    [property]: value,
-  }))}`;
+  return `fnv1a64-jcs-v1:${fnv1a64(
+    canonicalJson({
+      identityVersion: 1,
+      kind,
+      [property]: value,
+    }),
+  )}`;
 }
 
 export interface BuiltDiagnosticIdentities {
   readonly formulaFingerprints: Readonly<Record<string, string>>;
   readonly calculationFingerprints: Readonly<Record<string, string>>;
   readonly definitionIntegrity: string;
-  readonly calculationScopesByInstanceId: ReadonlyMap<string, NormalizedDiagnosticCalculationScope>;
-  readonly calculationDependenciesByInstanceId: ReadonlyMap<string, readonly string[]>;
-  readonly evaluationDependenciesByInstanceId: ReadonlyMap<string, readonly string[]>;
+  readonly calculationScopesByInstanceId: ReadonlyMap<
+    string,
+    NormalizedDiagnosticCalculationScope
+  >;
+  readonly calculationDependenciesByInstanceId: ReadonlyMap<
+    string,
+    readonly string[]
+  >;
+  readonly evaluationDependenciesByInstanceId: ReadonlyMap<
+    string,
+    readonly string[]
+  >;
 }
 
 export function buildDiagnosticIdentities(
   definition: DiagnosticDeepReadonly<NormalizedDiagnosticDefinitionIdentity>,
 ): BuiltDiagnosticIdentities {
-  const formulas = new Map(definition.formulas.map((formula) => [formula.id, formula]));
-  const measures = new Map(definition.measures.map((measure) => [measure.id, measure]));
-  const derivations = new Map(definition.derivedMeasures.map((derivation) => [derivation.outputMeasureId, derivation]));
-  const populations = new Map(definition.countPopulations.map((population) => [population.id, population]));
-  const exposureBases = new Map(definition.exposureBases.map((basis) => [basis.id, basis]));
-  const amountBases = new Map(definition.amountBases.map((basis) => [basis.id, basis]));
-
-  const formulaFingerprints = sortedRecord(definition.formulas.map((formula) =>
-    [formula.id, tag("diagnostic-formula", "formula", formula)] as const,
-  ));
+  const formulas = new Map(
+    definition.formulas.map((formula) => [formula.id, formula]),
+  );
+  const measures = new Map(
+    definition.measures.map((measure) => [measure.id, measure]),
+  );
+  const derivations = new Map(
+    definition.derivedMeasures.map((derivation) => [
+      derivation.outputMeasureId,
+      derivation,
+    ]),
+  );
+  const populations = new Map(
+    definition.countPopulations.map((population) => [
+      population.id,
+      population,
+    ]),
+  );
+  const exposureBases = new Map(
+    definition.exposureBases.map((basis) => [basis.id, basis]),
+  );
+  const amountBases = new Map(
+    definition.amountBases.map((basis) => [basis.id, basis]),
+  );
+
+  const formulaFingerprints = sortedRecord(
+    definition.formulas.map(
+      (formula) =>
+        [formula.id, tag("diagnostic-formula", "formula", formula)] as const,
+    ),
+  );
   const calculationFingerprints = Object.create(null) as Record<string, string>;
-  const calculationScopesByInstanceId = new Map<string, NormalizedDiagnosticCalculationScope>();
-  const calculationDependenciesByInstanceId = new Map<string, readonly string[]>();
-  const evaluationDependenciesByInstanceId = new Map<string, readonly string[]>();
+  const calculationScopesByInstanceId = new Map<
+    string,
+    NormalizedDiagnosticCalculationScope
+  >();
+  const calculationDependenciesByInstanceId = new Map<
+    string,
+    readonly string[]
+  >();
+  const evaluationDependenciesByInstanceId = new Map<
+    string,
+    readonly string[]
+  >();
 
-  const transitiveDependencies = (roots: readonly string[]): readonly string[] => {
+  const transitiveDependencies = (
+    roots: readonly string[],
+  ): readonly string[] => {
     const found = new Set<string>();
     const stack = [...roots];
     while (stack.length > 0) {
@@ -685,7 +1148,8 @@ export function buildDiagnosticIdentities(
       if (found.has(id)) continue;
       found.add(id);
       const derivation = derivations.get(id);
-      if (derivation) stack.push(...expressionDependencies(derivation.expression));
+      if (derivation)
+        stack.push(...expressionDependencies(derivation.expression));
     }
     return [...found].sort(compareCodeUnits);
   };
@@ -701,14 +1165,34 @@ export function buildDiagnosticIdentities(
         ...ruleMeasureDependencies(rule.when.right),
       ]),
     ]);
-    calculationDependenciesByInstanceId.set(instance.id, calculationDependencies);
+    calculationDependenciesByInstanceId.set(
+      instance.id,
+      calculationDependencies,
+    );
     evaluationDependenciesByInstanceId.set(instance.id, evaluationDependencies);
 
-    const selectedMeasures = calculationDependencies.map((id) => measures.get(id)!).filter(Boolean);
-    const selectedDerivations = definition.derivedMeasures.filter((derivation) => calculationDependencies.includes(derivation.outputMeasureId));
-    const countPopulationIds = sortedUnique(selectedMeasures.flatMap((measure) => measure.countPopulationId === null ? [] : [measure.countPopulationId]));
-    const exposureBasisIds = sortedUnique(selectedMeasures.flatMap((measure) => measure.exposureBasisId === null ? [] : [measure.exposureBasisId]));
-    const amountBasisIds = sortedUnique(selectedMeasures.flatMap((measure) => measure.basisId === null ? [] : [measure.basisId]));
+    const selectedMeasures = calculationDependencies
+      .map((id) => measures.get(id)!)
+      .filter(Boolean);
+    const selectedDerivations = definition.derivedMeasures.filter(
+      (derivation) =>
+        calculationDependencies.includes(derivation.outputMeasureId),
+    );
+    const countPopulationIds = sortedUnique(
+      selectedMeasures.flatMap((measure) =>
+        measure.countPopulationId === null ? [] : [measure.countPopulationId],
+      ),
+    );
+    const exposureBasisIds = sortedUnique(
+      selectedMeasures.flatMap((measure) =>
+        measure.exposureBasisId === null ? [] : [measure.exposureBasisId],
+      ),
+    );
+    const amountBasisIds = sortedUnique(
+      selectedMeasures.flatMap((measure) =>
+        measure.basisId === null ? [] : [measure.basisId],
+      ),
+    );
     const scope: NormalizedDiagnosticCalculationScope = {
       formulaFingerprint: formulaFingerprints[instance.formulaId]!,
       instance: {
@@ -733,11 +1217,21 @@ export function buildDiagnosticIdentities(
       })),
       countPopulations: countPopulationIds.map((id) => {
         const population = populations.get(id)!;
-        return { id, subject: population.subject, unit: population.unit, attributes: population.attributes };
+        return {
+          id,
+          subject: population.subject,
+          unit: population.unit,
+          attributes: population.attributes,
+        };
       }),
       exposureBases: exposureBasisIds.map((id) => {
         const basis = exposureBases.get(id)!;
-        return { id, basis: basis.basis, unit: basis.unit, attributes: basis.attributes };
+        return {
+          id,
+          basis: basis.basis,
+          unit: basis.unit,
+          attributes: basis.attributes,
+        };
       }),
       amountBases: amountBasisIds.map((id) => {
         const basis = amountBases.get(id)!;
@@ -753,12 +1247,18 @@ export function buildDiagnosticIdentities(
     };
     const frozenScope = deepFreeze(scope);
     calculationScopesByInstanceId.set(instance.id, frozenScope);
-    calculationFingerprints[instance.id] = tag("diagnostic-calculation", "calculation", frozenScope);
+    calculationFingerprints[instance.id] = tag(
+      "diagnostic-calculation",
+      "calculation",
+      frozenScope,
+    );
   }
 
   return {
     formulaFingerprints: deepFreeze(formulaFingerprints),
-    calculationFingerprints: deepFreeze(sortedRecord(Object.entries(calculationFingerprints))),
+    calculationFingerprints: deepFreeze(
+      sortedRecord(Object.entries(calculationFingerprints)),
+    ),
     definitionIntegrity: tag("diagnostic-definition", "definition", definition),
     calculationScopesByInstanceId,
     calculationDependenciesByInstanceId,