@actuarial-ts/compliance 0.6.0 → 0.7.0

package/dist/diagnosticByteSource.js

@@ -0,0 +1,70 @@
+function isObject(value) {
+    return (value !== null && (typeof value === "object" || typeof value === "function"));
+}
+/**
+ * Own one producer iterator through completion, cancellation or read failure.
+ * Unlike a bare for-await loop, a rejected next() also closes the producer.
+ * A cleanup failure never replaces the error that caused cleanup. Hosts should
+ * pass the same cancellation signal to pending I/O; checks cannot interrupt it.
+ */
+export async function* consumeDiagnosticByteSource(source, checkCancellation = () => { }) {
+    if (!isObject(source))
+        throw new TypeError("Diagnostic byte source must be iterable");
+    const iterable = source;
+    const asynchronous = iterable[Symbol.asyncIterator];
+    const method = asynchronous ?? iterable[Symbol.iterator];
+    if (typeof method !== "function")
+        throw new TypeError("Diagnostic byte source must provide an iterator method");
+    const iterator = Reflect.apply(method, source, []);
+    if (!isObject(iterator))
+        throw new TypeError("Diagnostic byte iterator must be an object");
+    const protocol = iterator;
+    let completed = false;
+    let failed = false;
+    try {
+        // Capture next once, as the iterator protocol does; never use a producer's
+        // potentially overwritten Function.call property.
+        const next = protocol.next;
+        if (typeof next !== "function")
+            throw new TypeError("Diagnostic byte iterator must provide next()");
+        for (;;) {
+            checkCancellation();
+            const result = await Reflect.apply(next, iterator, []);
+            if (!isObject(result))
+                throw new TypeError("Diagnostic byte read must return an iterator result");
+            const item = result;
+            completed = Boolean(item.done);
+            checkCancellation();
+            if (completed)
+                return;
+            // An async generator also observes a rejected value from a synchronous
+            // iterator here, so that failure follows the same cleanup path.
+            yield item.value;
+        }
+    }
+    catch (error) {
+        failed = true;
+        throw error;
+    }
+    finally {
+        if (!completed) {
+            try {
+                // Read return only when closing, once, following normal iterator
+                // semantics. The generator's finally executes at most once.
+                const close = protocol.return;
+                if (close !== undefined && close !== null) {
+                    if (typeof close !== "function")
+                        throw new TypeError("Diagnostic byte iterator return must be a function");
+                    const result = await Reflect.apply(close, iterator, []);
+                    if (!isObject(result))
+                        throw new TypeError("Diagnostic byte iterator return must return an iterator result");
+                }
+            }
+            catch (cleanupError) {
+                if (!failed)
+                    throw cleanupError;
+            }
+        }
+    }
+}
+//# sourceMappingURL=diagnosticByteSource.js.map

package/dist/diagnosticByteSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticByteSource.js","sourceRoot":"","sources":["../src/diagnosticByteSource.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CACL,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,2BAA2B,CAChD,MAA4B,EAC5B,oBAAgC,GAAG,EAAE,GAAE,CAAC;IAExC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnB,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,MAEhB,CAAC;IACF,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,YAAY,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,OAAO,MAAM,KAAK,UAAU;QAC9B,MAAM,IAAI,SAAS,CACjB,wDAAwD,CACzD,CAAC;IACJ,MAAM,QAAQ,GAAY,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACrB,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,QAAgD,CAAC;IAClE,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC;QACH,2EAA2E;QAC3E,kDAAkD;QAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,OAAO,IAAI,KAAK,UAAU;YAC5B,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;QACtE,SAAS,CAAC;YACR,iBAAiB,EAAE,CAAC;YACpB,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACnB,MAAM,IAAI,SAAS,CACjB,qDAAqD,CACtD,CAAC;YACJ,MAAM,IAAI,GAAG,MAAoC,CAAC;YAClD,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,iBAAiB,EAAE,CAAC;YACpB,IAAI,SAAS;gBAAE,OAAO;YACtB,uEAAuE;YACvE,gEAAgE;YAChE,MAAM,IAAI,CAAC,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,iEAAiE;gBACjE,4DAA4D;gBAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;gBAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,IAAI,OAAO,KAAK,KAAK,UAAU;wBAC7B,MAAM,IAAI,SAAS,CACjB,oDAAoD,CACrD,CAAC;oBACJ,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACjE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;wBACnB,MAAM,IAAI,SAAS,CACjB,gEAAgE,CACjE,CAAC;gBACN,CAAC;YACH,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM;oBAAE,MAAM,YAAY,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/diagnosticByteView.d.ts

@@ -0,0 +1,3 @@
+/** Borrow a synchronous intrinsic-only view; callers copy before yielding. */
+export declare function diagnosticByteView(chunk: unknown): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=diagnosticByteView.d.ts.map

package/dist/diagnosticByteView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticByteView.d.ts","sourceRoot":"","sources":["../src/diagnosticByteView.ts"],"names":[],"mappings":"AAUA,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAe1E"}

package/dist/diagnosticByteView.js

@@ -0,0 +1,27 @@
+import { ComplianceError } from "./errors.js";
+const typedArrayPrototype = Object.getPrototypeOf(Uint8Array.prototype);
+const byteLength = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteLength").get;
+const byteOffset = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteOffset").get;
+const bufferOf = Object.getOwnPropertyDescriptor(typedArrayPrototype, "buffer").get;
+const arrayBufferLength = Object.getOwnPropertyDescriptor(ArrayBuffer.prototype, "byteLength")
+    .get;
+const resizable = Object.getOwnPropertyDescriptor(ArrayBuffer.prototype, "resizable")?.get;
+/** Borrow a synchronous intrinsic-only view; callers copy before yielding. */
+export function diagnosticByteView(chunk) {
+    const fail = (message) => {
+        throw new ComplianceError("BAD_DIAGNOSTIC_RUN", message, "$.chunks");
+    };
+    if (!(chunk instanceof Uint8Array) || !ArrayBuffer.isView(chunk))
+        fail("Artifact chunks must be Uint8Array values");
+    const buffer = bufferOf.call(chunk);
+    try {
+        arrayBufferLength.call(buffer);
+    }
+    catch {
+        fail("Shared artifact buffers cannot provide a stable byte snapshot");
+    }
+    if (resizable?.call(buffer))
+        fail("Resizable artifact buffers cannot provide a stable byte snapshot");
+    return new Uint8Array(buffer, byteOffset.call(chunk), byteLength.call(chunk));
+}
+//# sourceMappingURL=diagnosticByteView.js.map

package/dist/diagnosticByteView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticByteView.js","sourceRoot":"","sources":["../src/diagnosticByteView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,mBAAmB,GAAG,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACxE,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,mBAAmB,EAAE,YAAY,CAAE,CAAC,GAAI,CAAC;AAC5F,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,mBAAmB,EAAE,YAAY,CAAE,CAAC,GAAI,CAAC;AAC5F,MAAM,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,mBAAmB,EAAE,QAAQ,CAAE,CAAC,GAAI,CAAC;AACtF,MAAM,iBAAiB,GAAG,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,SAAS,EAAE,YAAY,CAAE;KAC5F,GAAI,CAAC;AACR,MAAM,SAAS,GAAG,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC;AAE3F,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,IAAI,GAAG,CAAC,OAAe,EAAS,EAAE;QACtC,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC,CAAC;IACF,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAC9D,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAgB,CAAC;IACnD,IAAI,CAAC;QACH,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC3E,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/diagnosticCompactRun.d.ts

@@ -0,0 +1,43 @@
+import { type DiagnosticIdentityDocument } from "@actuarial-ts/core";
+import { type CompletedCompactMetricDiagnosticsRun } from "@actuarial-ts/data";
+import { type ComputedDiagnosticArtifactDigest } from "./diagnosticArtifactStream.js";
+import type { DiagnosticArtifactDigest, DiagnosticPreparationLineage, DiagnosticRunIdentity, DiagnosticRunProvenance } from "./diagnosticRun.js";
+/** Computed digests must be authentic completed byte-stream receipts, not JSON copies. */
+export type CompactDiagnosticArtifactEvidence = ComputedDiagnosticArtifactDigest | Extract<DiagnosticArtifactDigest, {
+    assurance: "caller-declared";
+}>;
+export interface CreateCompactDiagnosticRunIdentityInput {
+    readonly completedRun: CompletedCompactMetricDiagnosticsRun;
+    readonly inputArtifacts: readonly CompactDiagnosticArtifactEvidence[];
+    readonly preparationArtifacts: readonly CompactDiagnosticArtifactEvidence[];
+    readonly preparationLineage: readonly DiagnosticPreparationLineage[];
+}
+declare const verifiedCompactDiagnosticRunProvenanceBrand: unique symbol;
+/**
+ * Verified compact evidence, not a legacy provenance DTO or BundleDoc.
+ * Documents emit the complete legacy normalized manifest/result identity bytes.
+ * They retain immutable owners, not expanded identity arrays or source bytes.
+ * The provenance brand, not a structural document, establishes verification.
+ */
+export interface VerifiedCompactDiagnosticRunProvenance extends DiagnosticRunIdentity {
+    readonly [verifiedCompactDiagnosticRunProvenanceBrand]: true;
+    readonly definition: DiagnosticRunProvenance["definition"];
+    readonly inputArtifacts: readonly DiagnosticArtifactDigest[];
+    readonly preparationArtifacts: readonly DiagnosticArtifactDigest[];
+    readonly preparationLineage: readonly DiagnosticPreparationLineage[];
+    readonly preparationFingerprint: string;
+    readonly reviewFingerprint: string;
+    readonly manifestIdentityDocument: DiagnosticIdentityDocument;
+    readonly resultIdentityDocument: DiagnosticIdentityDocument;
+}
+/**
+ * Verify an authentic compact completed run and bind completed artifact digests.
+ * Synchronous: source bytes were consumed by digestDiagnosticArtifactChunks already.
+ * This deliberately replays review/math and compares every identity code unit.
+ */
+export declare function createCompactDiagnosticRunIdentity(input: CreateCompactDiagnosticRunIdentityInput): VerifiedCompactDiagnosticRunProvenance;
+export declare function assertVerifiedCompactDiagnosticRunProvenance(value: unknown): asserts value is VerifiedCompactDiagnosticRunProvenance;
+/** Internal transport plumbing; deliberately not exported from the package index. */
+export declare function getCompactDiagnosticRunOwner(provenance: VerifiedCompactDiagnosticRunProvenance): CompletedCompactMetricDiagnosticsRun;
+export {};
+//# sourceMappingURL=diagnosticCompactRun.d.ts.map

package/dist/diagnosticCompactRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticCompactRun.d.ts","sourceRoot":"","sources":["../src/diagnosticCompactRun.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAML,KAAK,oCAAoC,EAC1C,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,wBAAwB,EACxB,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAU5B,0FAA0F;AAC1F,MAAM,MAAM,iCAAiC,GACzC,gCAAgC,GAChC,OAAO,CAAC,wBAAwB,EAAE;IAAE,SAAS,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAAC;AAExE,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,YAAY,EAAE,oCAAoC,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,SAAS,iCAAiC,EAAE,CAAC;IACtE,QAAQ,CAAC,oBAAoB,EAAE,SAAS,iCAAiC,EAAE,CAAC;IAC5E,QAAQ,CAAC,kBAAkB,EAAE,SAAS,4BAA4B,EAAE,CAAC;CACtE;AAED,OAAO,CAAC,MAAM,2CAA2C,EAAE,OAAO,MAAM,CAAC;AACzE;;;;;GAKG;AACH,MAAM,WAAW,sCACf,SAAQ,qBAAqB;IAC7B,QAAQ,CAAC,CAAC,2CAA2C,CAAC,EAAE,IAAI,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC7D,QAAQ,CAAC,oBAAoB,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACnE,QAAQ,CAAC,kBAAkB,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACrE,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,wBAAwB,EAAE,0BAA0B,CAAC;IAC9D,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;CAC7D;AAuRD;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,uCAAuC,GAC7C,sCAAsC,CAyFxC;AAED,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,sCAAsC,CAGzD;AAED,qFAAqF;AACrF,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,sCAAsC,GACjD,oCAAoC,CAGtC"}

package/dist/diagnosticCompactRun.js

@@ -0,0 +1,253 @@
+import { CORE_PACKAGE_VERSION, canonicalFnv1a64, compareDiagnosticIdentityDocuments, createDiagnosticIdentityArray, createDiagnosticIdentityObject, createDiagnosticIdentityValue, fingerprintDiagnosticIdentity, getCompactMetricDiagnosticsResultIdentityDocument, getCompactPreparedDiagnosticDataFingerprint, normalizeDiagnosticsFilterIdentity, runMetricDiagnosticsCompact, } from "@actuarial-ts/core";
+import { DATA_PACKAGE_VERSION, assertCompletedCompactMetricDiagnosticsRun, getCompactDiagnosticReviewReceiptFingerprint, getCompactDiagnosticReviewReceiptIdentityDocument, reviewPreparedDiagnosticDataCompact, } from "@actuarial-ts/data";
+import { assertComputedDiagnosticArtifactDigest, } from "./diagnosticArtifactStream.js";
+import { plain, snapshotLineage, token, validateArtifactGraph, } from "./diagnosticRunEvidence.js";
+import { ComplianceError } from "./errors.js";
+import { COMPLIANCE_PACKAGE_VERSION } from "./version.js";
+const verified = new WeakMap();
+function bad(message, path) {
+    throw new ComplianceError("BAD_DIAGNOSTIC_RUN", message, path);
+}
+/** Snapshot boundary metadata without invoking getters or caller array methods. */
+function record(value, allowed, path) {
+    if (!plain(value))
+        bad("Expected a plain metadata object", path);
+    const copy = Object.create(null);
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== "string" || !allowed.includes(key))
+            bad("Unknown metadata field", `${path}.${String(key)}`);
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor || !descriptor.enumerable || !("value" in descriptor))
+            bad("Metadata fields must be enumerable data properties", `${path}.${key}`);
+        copy[key] = descriptor.value;
+    }
+    return copy;
+}
+function array(value, path) {
+    if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype)
+        bad("Expected a plain metadata array", path);
+    const length = Object.getOwnPropertyDescriptor(value, "length")?.value;
+    if (!Number.isSafeInteger(length) || length < 0)
+        bad("Invalid array length", path);
+    for (const key of Reflect.ownKeys(value)) {
+        if (key === "length")
+            continue;
+        if (typeof key !== "string" ||
+            !/^(0|[1-9][0-9]*)$/.test(key) ||
+            Number(key) >= length)
+            bad("Unexpected array property", `${path}.${String(key)}`);
+    }
+    const copy = [];
+    for (let index = 0; index < length; index++) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+        if (!descriptor || !descriptor.enumerable || !("value" in descriptor))
+            bad("Array items must be present data properties", `${path}[${index}]`);
+        copy.push(descriptor.value);
+    }
+    return copy;
+}
+function artifacts(value, scope, path) {
+    const seen = new Set();
+    const result = array(value, path).map((raw, index) => {
+        const itemPath = `${path}[${index}]`;
+        const item = record(raw, ["id", "scope", "assurance", "algorithm", "value", "byteLength"], itemPath);
+        if (typeof item.id !== "string")
+            bad("Artifact id must be a string", `${itemPath}.id`);
+        token(item.id, `${itemPath}.id`);
+        if (seen.has(item.id))
+            bad("Artifact IDs must be unique", `${itemPath}.id`);
+        seen.add(item.id);
+        if (item.scope !== scope)
+            bad(`Artifact must have ${scope} scope`, `${itemPath}.scope`);
+        if (item.assurance === "sdk-computed") {
+            assertComputedDiagnosticArtifactDigest(raw);
+            return raw;
+        }
+        if (item.assurance !== "caller-declared")
+            bad("Unknown artifact assurance", `${itemPath}.assurance`);
+        if (Object.hasOwn(item, "byteLength"))
+            bad("Caller-declared evidence cannot claim a computed byte length", `${itemPath}.byteLength`);
+        if (typeof item.algorithm !== "string" || typeof item.value !== "string")
+            bad("Declared algorithm and value must be strings", itemPath);
+        token(item.algorithm, `${itemPath}.algorithm`);
+        token(item.value, `${itemPath}.value`);
+        return Object.freeze({
+            id: item.id,
+            scope,
+            assurance: "caller-declared",
+            algorithm: item.algorithm,
+            value: item.value,
+        });
+    });
+    return Object.freeze(result.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)));
+}
+function lineage(value) {
+    const copied = array(value, "$.preparationLineage").map((raw, index) => {
+        const path = `$.preparationLineage[${index}]`;
+        const item = record(raw, ["outputArtifactId", "inputArtifactIds", "transformationArtifactIds"], path);
+        return {
+            outputArtifactId: item.outputArtifactId,
+            inputArtifactIds: array(item.inputArtifactIds, `${path}.inputArtifactIds`),
+            transformationArtifactIds: array(item.transformationArtifactIds, `${path}.transformationArtifactIds`),
+        };
+    });
+    return Object.freeze(snapshotLineage(copied).map((edge) => Object.freeze({
+        outputArtifactId: edge.outputArtifactId,
+        inputArtifactIds: Object.freeze([...edge.inputArtifactIds]),
+        transformationArtifactIds: Object.freeze([
+            ...edge.transformationArtifactIds,
+        ]),
+    })));
+}
+function requireEqual(actual, expected, path) {
+    const comparison = compareDiagnosticIdentityDocuments(actual, expected);
+    if (!comparison.equal)
+        throw new ComplianceError("DIAGNOSTIC_MISMATCH", `Deterministic replay differs at canonical code-unit offset ${comparison.codeUnitOffset}`, path);
+}
+/** Replay before issuing authority; hashes never replace complete identity comparison. */
+function rerunAndVerify(run) {
+    const review = reviewPreparedDiagnosticDataCompact({
+        prepared: run.prepared,
+        evidence: run.review.evidence,
+    });
+    requireEqual(getCompactDiagnosticReviewReceiptIdentityDocument(review), getCompactDiagnosticReviewReceiptIdentityDocument(run.review), "$.review");
+    const rerun = runMetricDiagnosticsCompact({
+        prepared: run.prepared,
+        groupMap: run.groupMap,
+        groupDimensions: run.groupDimensions,
+    });
+    requireEqual(getCompactMetricDiagnosticsResultIdentityDocument(rerun), getCompactMetricDiagnosticsResultIdentityDocument(run.result), "$.result");
+    const counts = review.evaluations.summary;
+    const effectiveCounts = {
+        pass: counts.pass,
+        warning: counts.warning,
+        fail: counts.fail,
+        "not-evaluated": counts.notEvaluated,
+    };
+    const statuses = ["pass", "warning", "fail", "not-evaluated"];
+    const reviewBlocked = review.report.checks.some((check) => !run.gate.allowedReviewStatuses.includes(check.status)) ||
+        statuses.some((status) => effectiveCounts[status] > 0 &&
+            !run.gate.allowedReviewStatuses.includes(status));
+    const metricBlocked = rerun.findings.some((finding) => finding.category !== "structural" &&
+        !run.gate.allowedMetricFindingSeverities.includes(finding.severity));
+    if (reviewBlocked ||
+        metricBlocked ||
+        run.gate.reviewGate !== "passed" ||
+        run.gate.metricGate !== "passed")
+        throw new ComplianceError("DIAGNOSTIC_MISMATCH", "Diagnostic execution gates do not recompute as passed", "$.gate");
+}
+function manifestDocument(run, inputArtifacts, preparationArtifacts, preparationLineage, preparationFingerprint, reviewFingerprint) {
+    const prepared = run.prepared;
+    const expectedCells = createDiagnosticIdentityArray(prepared.expectedCells.length, (index) => {
+        const cell = prepared.expectedCells[index];
+        return createDiagnosticIdentityObject({
+            sourceGroup: createDiagnosticIdentityValue(cell.sourceGroup),
+            origin: createDiagnosticIdentityValue(cell.origin),
+            valuation: createDiagnosticIdentityValue(cell.valuation),
+            source: createDiagnosticIdentityValue(cell.source ?? null),
+        });
+    });
+    return createDiagnosticIdentityObject({
+        definitionIntegrity: createDiagnosticIdentityValue(prepared.definition.definitionIntegrity),
+        preparationFingerprint: createDiagnosticIdentityValue(preparationFingerprint),
+        runPresetId: createDiagnosticIdentityValue(run.runPresetId),
+        datasetArtifactId: createDiagnosticIdentityValue(run.datasetArtifactId),
+        inputArtifacts: createDiagnosticIdentityValue(inputArtifacts),
+        preparationArtifacts: createDiagnosticIdentityValue(preparationArtifacts),
+        preparationLineage: createDiagnosticIdentityValue(preparationLineage),
+        inputAudit: createDiagnosticIdentityValue(prepared.inputAudit),
+        filter: createDiagnosticIdentityValue(normalizeDiagnosticsFilterIdentity(prepared.filter)),
+        groupMap: createDiagnosticIdentityValue(run.groupMap),
+        groupDimensions: createDiagnosticIdentityValue(run.groupDimensions),
+        completePeriodCutoffs: createDiagnosticIdentityValue(prepared.completePeriodCutoffs),
+        expectedCellGridFingerprint: createDiagnosticIdentityValue(prepared.expectedCellsProvided
+            ? fingerprintDiagnosticIdentity(expectedCells, {
+                kind: "diagnostic-expected-cell-grid",
+                property: "expectedCells",
+            })
+            : null),
+        executionPolicy: createDiagnosticIdentityObject({
+            gate: createDiagnosticIdentityValue(run.gate),
+            review: createDiagnosticIdentityObject({
+                body: getCompactDiagnosticReviewReceiptIdentityDocument(run.review),
+                reportFingerprint: createDiagnosticIdentityValue(reviewFingerprint),
+            }),
+        }),
+        engine: createDiagnosticIdentityValue(Object.freeze({
+            packages: Object.freeze({
+                core: CORE_PACKAGE_VERSION,
+                data: DATA_PACKAGE_VERSION,
+                compliance: COMPLIANCE_PACKAGE_VERSION,
+            }),
+            algorithmVersion: "diagnostics-1",
+        })),
+    });
+}
+/**
+ * Verify an authentic compact completed run and bind completed artifact digests.
+ * Synchronous: source bytes were consumed by digestDiagnosticArtifactChunks already.
+ * This deliberately replays review/math and compares every identity code unit.
+ */
+export function createCompactDiagnosticRunIdentity(input) {
+    const snapshot = record(input, [
+        "completedRun",
+        "inputArtifacts",
+        "preparationArtifacts",
+        "preparationLineage",
+    ], "$");
+    const run = snapshot.completedRun;
+    try {
+        assertCompletedCompactMetricDiagnosticsRun(run);
+    }
+    catch {
+        bad("completedRun must be an authentic completed compact diagnostic run", "$.completedRun");
+    }
+    const inputArtifacts = artifacts(snapshot.inputArtifacts, "input", "$.inputArtifacts");
+    const preparationArtifacts = artifacts(snapshot.preparationArtifacts, "preparation", "$.preparationArtifacts");
+    const preparationLineage = lineage(snapshot.preparationLineage);
+    validateArtifactGraph(run, inputArtifacts, preparationArtifacts, preparationLineage);
+    rerunAndVerify(run);
+    const preparationFingerprint = getCompactPreparedDiagnosticDataFingerprint(run.prepared);
+    const reviewFingerprint = getCompactDiagnosticReviewReceiptFingerprint(run.review);
+    const manifestIdentityDocument = manifestDocument(run, inputArtifacts, preparationArtifacts, preparationLineage, preparationFingerprint, reviewFingerprint);
+    const resultIdentityDocument = getCompactMetricDiagnosticsResultIdentityDocument(run.result);
+    const runFingerprint = fingerprintDiagnosticIdentity(manifestIdentityDocument, { kind: "diagnostic-run", property: "manifest" });
+    const resultFingerprint = fingerprintDiagnosticIdentity(resultIdentityDocument, { kind: "diagnostic-result", property: "result" });
+    const runResultFingerprint = `fnv1a64-jcs-v1:${canonicalFnv1a64({ identityVersion: 1, kind: "diagnostic-run-result", runFingerprint, resultFingerprint })}`;
+    const definition = run.prepared.definition;
+    const provenance = Object.freeze({
+        definition: Object.freeze({
+            definition: definition.definition,
+            identities: Object.freeze({
+                algorithm: "fnv1a64-jcs-v1",
+                formulaById: Object.freeze({ ...definition.formulaFingerprints }),
+                calculationByInstanceId: Object.freeze({
+                    ...definition.calculationFingerprints,
+                }),
+                definition: definition.definitionIntegrity,
+            }),
+        }),
+        inputArtifacts,
+        preparationArtifacts,
+        preparationLineage,
+        preparationFingerprint,
+        reviewFingerprint,
+        manifestIdentityDocument,
+        resultIdentityDocument,
+        runFingerprint,
+        resultFingerprint,
+        runResultFingerprint,
+    });
+    verified.set(provenance, run);
+    return provenance;
+}
+export function assertVerifiedCompactDiagnosticRunProvenance(value) {
+    if (value === null || typeof value !== "object" || !verified.has(value))
+        bad("Value is not authentic verified compact diagnostic provenance", "$");
+}
+/** Internal transport plumbing; deliberately not exported from the package index. */
+export function getCompactDiagnosticRunOwner(provenance) {
+    assertVerifiedCompactDiagnosticRunProvenance(provenance);
+    return verified.get(provenance);
+}
+//# sourceMappingURL=diagnosticCompactRun.js.map

package/dist/diagnosticCompactRun.js.map

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

package/dist/diagnosticReplayFrames.d.ts

@@ -0,0 +1,10 @@
+export declare const MAX_REPLAY_FRAME_BYTES = 131072;
+export declare const MAX_REPLAY_READ_BYTES = 131072;
+export declare const REPLAY_TEXT_UNITS = 16384;
+export type ReplayAtom = string | number | boolean | null;
+export type ReplayFrame = readonly ReplayAtom[];
+/** Private transport codec; construction does not grant diagnostic authority. */
+export declare function encodeReplayFrames(frames: AsyncIterable<ReplayFrame> | Iterable<ReplayFrame>): AsyncGenerator<Uint8Array>;
+/** Parse bounded flat frames, never a complete candidate audit/identity. */
+export declare function decodeReplayFrames(chunks: AsyncIterable<Uint8Array> | Iterable<Uint8Array>): AsyncGenerator<ReplayFrame>;
+//# sourceMappingURL=diagnosticReplayFrames.d.ts.map

package/dist/diagnosticReplayFrames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticReplayFrames.d.ts","sourceRoot":"","sources":["../src/diagnosticReplayFrames.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAC9C,eAAO,MAAM,qBAAqB,SAAU,CAAC;AAC7C,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,SAAS,UAAU,EAAE,CAAC;AAkChD,iFAAiF;AACjF,wBAAuB,kBAAkB,CACvC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,GACzD,cAAc,CAAC,UAAU,CAAC,CAc5B;AAED,4EAA4E;AAC5E,wBAAuB,kBAAkB,CACvC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,GACvD,cAAc,CAAC,WAAW,CAAC,CAiC7B"}

package/dist/diagnosticReplayFrames.js

@@ -0,0 +1,99 @@
+import { ComplianceError } from "./errors.js";
+import { diagnosticByteView } from "./diagnosticByteView.js";
+import { consumeDiagnosticByteSource } from "./diagnosticByteSource.js";
+// Transport granularity only: not a limit on total evidence or dataset size.
+export const MAX_REPLAY_FRAME_BYTES = 131_072;
+export const MAX_REPLAY_READ_BYTES = 131_072;
+export const REPLAY_TEXT_UNITS = 16_384;
+function invalid(message) {
+    throw new ComplianceError("BAD_DIAGNOSTIC_RUN", message, "$.replayFrames");
+}
+function snapshotFrame(value) {
+    if (!Array.isArray(value))
+        invalid("Replay frame must be an array");
+    const length = Object.getOwnPropertyDescriptor(value, "length")?.value;
+    if (!Number.isInteger(length) || length < 1 || length > 16)
+        invalid("Replay frame must be a nonempty flat array with at most 16 items");
+    const owned = [];
+    for (let index = 0; index < length; index++) {
+        const field = Object.getOwnPropertyDescriptor(value, String(index));
+        if (!field || !("value" in field))
+            invalid("Replay frames must contain indexed data properties");
+        const item = field.value;
+        if (item === null || typeof item === "boolean") {
+            owned.push(item);
+            continue;
+        }
+        if (typeof item === "number" && Number.isFinite(item)) {
+            owned.push(item);
+            continue;
+        }
+        // Enough for a base64-encoded 64 KiB artifact chunk. Higher-level protocol
+        // validates each event's arity, sequencing, and narrower field limits.
+        if (typeof item === "string" && item.length <= 87_384) {
+            owned.push(item);
+            continue;
+        }
+        invalid("Replay frames contain only bounded JSON primitives");
+    }
+    return Object.freeze(owned);
+}
+/** Private transport codec; construction does not grant diagnostic authority. */
+export async function* encodeReplayFrames(frames) {
+    const encoder = new TextEncoder();
+    for await (const frame of frames) {
+        const owned = snapshotFrame(frame);
+        const atoms = [];
+        let bytes = 3;
+        for (const item of owned) {
+            const text = JSON.stringify(item);
+            bytes += encoder.encode(text).byteLength + (atoms.length ? 1 : 0);
+            if (bytes > MAX_REPLAY_FRAME_BYTES)
+                invalid("Replay frame exceeds its byte limit");
+            atoms.push(text);
+        }
+        yield encoder.encode(`[${atoms.join(",")}]\n`);
+    }
+}
+/** Parse bounded flat frames, never a complete candidate audit/identity. */
+export async function* decodeReplayFrames(chunks) {
+    const line = new Uint8Array(MAX_REPLAY_FRAME_BYTES);
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let used = 0;
+    try {
+        for await (const chunk of consumeDiagnosticByteSource(chunks)) {
+            const view = diagnosticByteView(chunk);
+            if (view.byteLength > MAX_REPLAY_READ_BYTES)
+                invalid("Replay read chunk exceeds its transport limit; split input reads");
+            // Snapshot before yielding any frame: reused buffers cannot alter later
+            // frames in the same delivered chunk. This copy is always bounded.
+            const owned = new Uint8Array(view);
+            for (const byte of owned) {
+                if (byte === 10) {
+                    if (used === 0)
+                        invalid("Empty replay frame");
+                    let parsed;
+                    try {
+                        parsed = JSON.parse(decoder.decode(line.subarray(0, used)));
+                    }
+                    catch {
+                        invalid("Replay frame is not valid UTF-8 JSON");
+                    }
+                    used = 0;
+                    yield snapshotFrame(parsed);
+                }
+                else {
+                    if (used >= MAX_REPLAY_FRAME_BYTES - 1)
+                        invalid("Replay frame exceeds its byte limit");
+                    line[used++] = byte;
+                }
+            }
+        }
+        if (used !== 0)
+            invalid("Replay stream ended inside a frame");
+    }
+    finally {
+        line.fill(0);
+    }
+}
+//# sourceMappingURL=diagnosticReplayFrames.js.map

package/dist/diagnosticReplayFrames.js.map

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

package/dist/diagnosticReplayProtocol.d.ts

@@ -0,0 +1,17 @@
+import { type ReplayFrame } from "./diagnosticReplayFrames.js";
+export declare const REPLAY_FORMAT = "diagnostic-replay";
+export declare const REPLAY_VERSION = 1;
+export declare const ARTIFACT_CHUNK_BYTES = 65536;
+export declare function badReplay(message: string): never;
+export declare function mismatch(message: string): never;
+/** Snapshot host metadata once, without invoking accessors or caller methods. */
+export declare function replayRecord(value: unknown, keys: readonly string[]): Record<string, unknown>;
+export declare function replayArray(value: unknown): unknown[];
+export declare function replayToken(value: unknown): string;
+export declare function replayLimit(value: unknown, label: string): number;
+export declare function replayCancellation(signal: unknown): () => void;
+/** Exactly the writer's bounded canonical flat-frame bytes, including newline. */
+export declare function replayFrameBytes(frame: ReplayFrame): Uint8Array;
+export declare function encodeArtifactChunk(bytes: Uint8Array): string;
+export declare function decodeArtifactChunk(value: unknown): Uint8Array;
+//# sourceMappingURL=diagnosticReplayProtocol.d.ts.map

package/dist/diagnosticReplayProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticReplayProtocol.d.ts","sourceRoot":"","sources":["../src/diagnosticReplayProtocol.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAEvF,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAEhD;AACD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAE/C;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW7F;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAoBrD;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGlD;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjE;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,CAQ9D;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAI/D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI7D;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAe9D"}