@crvouga/atlas 0.4.0 → 0.5.0

package/dist/schema/src/layer.d.ts

@@ -0,0 +1,2273 @@
+/**
+ * @module Layer document and report status schemas
+ *
+ * The stable evidence format. A layer is the one unit of evidence every producer writes and every reader combines;
+ * this module also holds the input a producer hands to the publisher (`PublishChecksSchema`), the spec set a report is
+ * laid over (`SpecSetSchema`) and the JSON `atlas report status` prints (`ReportStatusSchema`). Reports are never
+ * stored
+ * as a whole; they are computed by layering.
+ *
+ * A layer is one focused recording: the checks one producer ran, on one environment, from one
+ * version and branch. It is immutable and addressed by its content.
+ *
+ * Compatibility, which is the point of this file:
+ * - Within a schema major version a change only adds optional fields. Readers ignore fields they
+ *   do not know (every object here is loose), so an old reader reads a newer minor layer.
+ * - The closed enumerations (`status`, `freshness`) change only with a new major version.
+ * - `schemaVersion` is the major version. A reader that is older than a layer says so; it never
+ *   guesses.
+ *
+ * Extensibility, which is what makes one format fit any test framework (docs/extending.md):
+ * - Evidence is open. Beyond its outcome a check may carry attachments of any media type, timeline
+ *   steps, annotations, retry attempts, tags, labels, links and namespaced `extensions`. Every one of
+ *   them is optional, so a layer without them is as valid as it ever was.
+ * - Vocabularies are open strings (`role`, `kind`, `type`, `level`, a step's `status`). The values
+ *   documented here are conventions, not a list: a reader shows what it does not know in a generic way.
+ * - `extensions` is where a producer or a tool puts structured data of its own, under a key it owns
+ *   (`com.example.coverage`). Readers keep it and never fail on it.
+ * - Evidence never decides a result. A reader that cannot read a piece of evidence drops that piece and
+ *   keeps the check, its status and its place in the report.
+ *
+ * @see docs/report-contract.md
+ * @see docs/extending.md
+ */
+import { z } from 'zod/v4';
+/**
+ * The major version of the layer format, written as `schemaVersion` in every layer. `parseLayerDocument` reads a
+ * layer without the field as this version and refuses any other.
+ */
+export declare const LAYER_SCHEMA_VERSION = 1;
+/** Outcomes of a check. Anything not `passed` is not evidence of success. */
+export declare const CHECK_STATUSES: readonly ["passed", "failed", "running", "not-run"];
+/**
+ * Zod enum over `CHECK_STATUSES`, the closed vocabulary of a check's and an attempt's `status`. It changes only with
+ * a new `schemaVersion`.
+ */
+export declare const CheckStatusSchema: z.ZodEnum<{
+    passed: "passed";
+    failed: "failed";
+    running: "running";
+    "not-run": "not-run";
+}>;
+/**
+ * One of `CHECK_STATUSES`: `passed` and `failed` are completed results; `running` and `not-run` are unfinished and
+ * never count as a pass.
+ */
+export type CheckStatus = z.infer<typeof CheckStatusSchema>;
+/**
+ * Why a layer's origin is advisory: `modified` (recorded from a checkout with uncommitted changes) or `unknown`
+ * (origin not captured). Absent on a layer from a clean commit. It never changes a status. A closed vocabulary: it
+ * changes only with a new `schemaVersion`.
+ */
+export declare const FRESHNESS: readonly ["unknown", "modified"];
+/**
+ * A number a check measured, such as a latency or a size, with its unit and an optional allowance. A measurement over
+ * its `limit` is reported and never changes the check's status.
+ */
+export declare const MeasurementSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodNumber;
+    unit: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+/**
+ * Structured data of a producer's or tool's own, by namespace: `{ "com.example.coverage": { … } }`.
+ * Use a name you own (a reverse domain, or your tool's name). Readers preserve it and never fail on it.
+ */
+export declare const ExtensionsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** A link attached to a layer, part, check or annotation: a URL, an optional name and why it is linked. */
+export declare const LinkSchema: z.ZodObject<{
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    rel: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Where in a check something happened: at a step, and/or this long after the check started. */
+export declare const MomentSchema: z.ZodObject<{
+    step: z.ZodOptional<z.ZodString>;
+    offsetMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+/**
+ * A file or a value that goes with a result: a screenshot, a video, a trace, a log, a DOM or accessibility
+ * snapshot, a HAR, a coverage report, a diff, anything. `contentType` says how to read it; `role` says what
+ * it is for, in an open vocabulary (`screenshot`, `video`, `trace`, `log`, `snapshot`, `har`, `coverage`,
+ * `diff`, `report`…). The bytes are in the layer (`bundleKey`), somewhere else (`uri`), or small enough to
+ * sit inline (`text`).
+ */
+export declare const AttachmentSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodOptional<z.ZodString>;
+    bundleKey: z.ZodOptional<z.ZodString>;
+    uri: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+    sha256: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodObject<{
+        step: z.ZodOptional<z.ZodString>;
+        offsetMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    poster: z.ZodOptional<z.ZodString>;
+    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** An attachment as stored in a layer, parsed from `AttachmentSchema`. */
+export type Attachment = z.output<typeof AttachmentSchema>;
+/** A note about a result: a warning, a deprecation, a coverage figure, an accessibility finding, anything. */
+export declare const AnnotationSchema: z.ZodObject<{
+    type: z.ZodString;
+    message: z.ZodString;
+    level: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodObject<{
+        step: z.ZodOptional<z.ZodString>;
+        offsetMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    source: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** An annotation as stored in a layer, parsed from `AnnotationSchema`. */
+export type Annotation = z.output<typeof AnnotationSchema>;
+/**
+ * One entry on a check's timeline. Steps are a flat list: nest them with `parentId`, order them by
+ * `offsetMs`. Whatever a framework calls its steps (actions, hooks, requests, spans), they fit.
+ */
+export declare const StepSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    offsetMs: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    detail: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        bundleKey: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        description: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        poster: z.ZodOptional<z.ZodString>;
+        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        level: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        source: z.ZodOptional<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** A timeline step as stored in a layer, parsed from `StepSchema`. */
+export type Step = z.output<typeof StepSchema>;
+/** One try of a check that was retried. The check's own status is the last one. */
+export declare const AttemptSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        running: "running";
+        "not-run": "not-run";
+    }>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    startedAtMs: z.ZodOptional<z.ZodNumber>;
+    detail: z.ZodOptional<z.ZodString>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        parentId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        offsetMs: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        detail: z.ZodOptional<z.ZodString>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodOptional<z.ZodString>;
+            bundleKey: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            poster: z.ZodOptional<z.ZodString>;
+            captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            message: z.ZodString;
+            level: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            source: z.ZodOptional<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        bundleKey: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        description: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        poster: z.ZodOptional<z.ZodString>;
+        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        level: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        source: z.ZodOptional<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** A retry attempt as stored in a layer, parsed from `AttemptSchema`. */
+export type Attempt = z.output<typeof AttemptSchema>;
+/**
+ * One check: the unit that has a status, such as a Gherkin scenario, a test case or a lint rule. Its `id` is stable
+ * across layers; with the layer's producer, the part's kind, the spec, the environment and the parameters it names
+ * the slot a result fills, and the newest completed result of a slot wins. It carries the outcome (`status`,
+ * `detail`, `measurements`) and, optionally, evidence (tags, labels, links, attachments, annotations, steps,
+ * attempts, extensions) that never decides the result.
+ */
+export declare const CheckSchema: z.ZodObject<{
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        parentId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        offsetMs: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        detail: z.ZodOptional<z.ZodString>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodOptional<z.ZodString>;
+            bundleKey: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            poster: z.ZodOptional<z.ZodString>;
+            captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            message: z.ZodString;
+            level: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            source: z.ZodOptional<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    attempts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        startedAtMs: z.ZodOptional<z.ZodNumber>;
+        detail: z.ZodOptional<z.ZodString>;
+        steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            parentId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            kind: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            detail: z.ZodOptional<z.ZodString>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                contentType: z.ZodOptional<z.ZodString>;
+                bundleKey: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                poster: z.ZodOptional<z.ZodString>;
+                captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                level: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodOptional<z.ZodString>;
+            bundleKey: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            poster: z.ZodOptional<z.ZodString>;
+            captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            message: z.ZodString;
+            level: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            source: z.ZodOptional<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        bundleKey: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        description: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        poster: z.ZodOptional<z.ZodString>;
+        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        level: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        source: z.ZodOptional<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    id: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        running: "running";
+        "not-run": "not-run";
+    }>;
+    detail: z.ZodDefault<z.ZodString>;
+    specPath: z.ZodOptional<z.ZodString>;
+    measurements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+/** A check as stored in a layer, parsed from `CheckSchema`. */
+export type Check = z.output<typeof CheckSchema>;
+/**
+ * A spec a layer was recorded against: its path, domain, kind and title, and an advisory fingerprint of its text so a
+ * reader can warn when the spec changed since.
+ */
+export declare const SpecEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    domain: z.ZodString;
+    kind: z.ZodString;
+    title: z.ZodString;
+    fingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * A group of checks inside a layer, with an open `kind` (`behavior`, `performance`, `accessibility`…) that is part of
+ * the slot a check fills. `publishChecks` writes a layer with one part. Parts may carry evidence of their own.
+ */
+export declare const ReportPartSchema: z.ZodObject<{
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        bundleKey: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        description: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        poster: z.ZodOptional<z.ZodString>;
+        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        level: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        source: z.ZodOptional<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        modified: "modified";
+    }>>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    sha: z.ZodDefault<z.ZodString>;
+    id: z.ZodString;
+    kind: z.ZodString;
+    title: z.ZodString;
+    recordedAtMs: z.ZodNumber;
+    checks: z.ZodArray<z.ZodObject<{
+        steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            parentId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            kind: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            detail: z.ZodOptional<z.ZodString>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                contentType: z.ZodOptional<z.ZodString>;
+                bundleKey: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                poster: z.ZodOptional<z.ZodString>;
+                captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                level: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        attempts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            startedAtMs: z.ZodOptional<z.ZodNumber>;
+            detail: z.ZodOptional<z.ZodString>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                parentId: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                kind: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                detail: z.ZodOptional<z.ZodString>;
+                attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    role: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    bundleKey: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    description: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    poster: z.ZodOptional<z.ZodString>;
+                    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    level: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    source: z.ZodOptional<z.ZodObject<{
+                        file: z.ZodOptional<z.ZodString>;
+                        line: z.ZodOptional<z.ZodNumber>;
+                        column: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        name: z.ZodOptional<z.ZodString>;
+                        rel: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                contentType: z.ZodOptional<z.ZodString>;
+                bundleKey: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                poster: z.ZodOptional<z.ZodString>;
+                captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                level: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodOptional<z.ZodString>;
+            bundleKey: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            poster: z.ZodOptional<z.ZodString>;
+            captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            message: z.ZodString;
+            level: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            source: z.ZodOptional<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        detail: z.ZodDefault<z.ZodString>;
+        specPath: z.ZodOptional<z.ZodString>;
+        measurements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodNumber;
+            unit: z.ZodString;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A suite that recorded timelines and captured files, beside its checks. Absent for a layer of plain checks. */
+export declare const LayerSourceSchema: z.ZodObject<{
+    source: z.ZodString;
+    packageDir: z.ZodString;
+    bucket: z.ZodString;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        skipped: "skipped";
+    }>;
+    updatedAtMs: z.ZodNumber;
+    environment: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        title: z.ZodString;
+        checks: z.ZodArray<z.ZodObject<{
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                parentId: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                kind: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                detail: z.ZodOptional<z.ZodString>;
+                attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    role: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    bundleKey: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    description: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    poster: z.ZodOptional<z.ZodString>;
+                    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    level: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    source: z.ZodOptional<z.ZodObject<{
+                        file: z.ZodOptional<z.ZodString>;
+                        line: z.ZodOptional<z.ZodNumber>;
+                        column: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        name: z.ZodOptional<z.ZodString>;
+                        rel: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            attempts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                status: z.ZodEnum<{
+                    passed: "passed";
+                    failed: "failed";
+                    running: "running";
+                    "not-run": "not-run";
+                }>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                startedAtMs: z.ZodOptional<z.ZodNumber>;
+                detail: z.ZodOptional<z.ZodString>;
+                steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    parentId: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    kind: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    detail: z.ZodOptional<z.ZodString>;
+                    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        name: z.ZodString;
+                        role: z.ZodOptional<z.ZodString>;
+                        contentType: z.ZodOptional<z.ZodString>;
+                        bundleKey: z.ZodOptional<z.ZodString>;
+                        uri: z.ZodOptional<z.ZodString>;
+                        text: z.ZodOptional<z.ZodString>;
+                        bytes: z.ZodOptional<z.ZodNumber>;
+                        sha256: z.ZodOptional<z.ZodString>;
+                        width: z.ZodOptional<z.ZodNumber>;
+                        height: z.ZodOptional<z.ZodNumber>;
+                        durationMs: z.ZodOptional<z.ZodNumber>;
+                        description: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        poster: z.ZodOptional<z.ZodString>;
+                        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        message: z.ZodString;
+                        level: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        source: z.ZodOptional<z.ZodObject<{
+                            file: z.ZodOptional<z.ZodString>;
+                            line: z.ZodOptional<z.ZodNumber>;
+                            column: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            url: z.ZodString;
+                            name: z.ZodOptional<z.ZodString>;
+                            rel: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    role: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    bundleKey: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    description: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    poster: z.ZodOptional<z.ZodString>;
+                    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    level: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    source: z.ZodOptional<z.ZodObject<{
+                        file: z.ZodOptional<z.ZodString>;
+                        line: z.ZodOptional<z.ZodNumber>;
+                        column: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        name: z.ZodOptional<z.ZodString>;
+                        rel: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                contentType: z.ZodOptional<z.ZodString>;
+                bundleKey: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                poster: z.ZodOptional<z.ZodString>;
+                captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                level: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            id: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            detail: z.ZodDefault<z.ZodString>;
+            specPath: z.ZodOptional<z.ZodString>;
+            measurements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodNumber;
+                unit: z.ZodString;
+                limit: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+    tests: z.ZodArray<z.ZodObject<{
+        testId: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        system: z.ZodDefault<z.ZodString>;
+        runtime: z.ZodDefault<z.ZodString>;
+        seed: z.ZodDefault<z.ZodString>;
+        durationMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/**
+ * Where the recorded tests of a suite live in the store: in the layer's own bundle (`layer`), or at the older address
+ * of a commit and a source name (`commit`).
+ */
+export declare const RecordingAddressSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"layer">;
+}, z.core.$loose>, z.ZodObject<{
+    type: z.ZodLiteral<"commit">;
+    sha: z.ZodString;
+    source: z.ZodString;
+}, z.core.$loose>]>;
+/**
+ * The captured files of a layer by file key (`attachments/<sha256>` for attachments): each file's media type and the
+ * byte ranges (`blob` store key, `offset` and `size` in the decompressed blob) whose concatenation is the file.
+ * Written last when a layer is published.
+ */
+export declare const BundleIndexSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    contentType: z.ZodString;
+    parts: z.ZodArray<z.ZodObject<{
+        blob: z.ZodString;
+        offset: z.ZodNumber;
+        size: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>>;
+/** Pattern of a layer id, a spec-set id or a content digest: 64 lowercase hexadecimal digits (a SHA-256). */
+export declare const LAYER_ID: RegExp;
+/**
+ * `layers/manifests/<id>.json`. The id is the SHA-256 of the document without it, so two producers
+ * that record the same thing write the same layer, and a retried publish changes nothing.
+ */
+export declare const LayerDocumentSchema: z.ZodObject<{
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        bundleKey: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        description: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        poster: z.ZodOptional<z.ZodString>;
+        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        level: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        source: z.ZodOptional<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    producer: z.ZodString;
+    recordedAtMs: z.ZodNumber;
+    sha: z.ZodNullable<z.ZodString>;
+    branch: z.ZodNullable<z.ZodString>;
+    runUrl: z.ZodNullable<z.ZodString>;
+    environment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        modified: "modified";
+    }>>;
+    specs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        domain: z.ZodString;
+        kind: z.ZodString;
+        title: z.ZodString;
+        fingerprint: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    parts: z.ZodArray<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodOptional<z.ZodString>;
+            bundleKey: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            poster: z.ZodOptional<z.ZodString>;
+            captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            message: z.ZodString;
+            level: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            source: z.ZodOptional<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        freshness: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            modified: "modified";
+        }>>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        sha: z.ZodDefault<z.ZodString>;
+        id: z.ZodString;
+        kind: z.ZodString;
+        title: z.ZodString;
+        recordedAtMs: z.ZodNumber;
+        checks: z.ZodArray<z.ZodObject<{
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                parentId: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                kind: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                detail: z.ZodOptional<z.ZodString>;
+                attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    role: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    bundleKey: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    description: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    poster: z.ZodOptional<z.ZodString>;
+                    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    level: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    source: z.ZodOptional<z.ZodObject<{
+                        file: z.ZodOptional<z.ZodString>;
+                        line: z.ZodOptional<z.ZodNumber>;
+                        column: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        name: z.ZodOptional<z.ZodString>;
+                        rel: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            attempts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                status: z.ZodEnum<{
+                    passed: "passed";
+                    failed: "failed";
+                    running: "running";
+                    "not-run": "not-run";
+                }>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                startedAtMs: z.ZodOptional<z.ZodNumber>;
+                detail: z.ZodOptional<z.ZodString>;
+                steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    parentId: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    kind: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    detail: z.ZodOptional<z.ZodString>;
+                    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        name: z.ZodString;
+                        role: z.ZodOptional<z.ZodString>;
+                        contentType: z.ZodOptional<z.ZodString>;
+                        bundleKey: z.ZodOptional<z.ZodString>;
+                        uri: z.ZodOptional<z.ZodString>;
+                        text: z.ZodOptional<z.ZodString>;
+                        bytes: z.ZodOptional<z.ZodNumber>;
+                        sha256: z.ZodOptional<z.ZodString>;
+                        width: z.ZodOptional<z.ZodNumber>;
+                        height: z.ZodOptional<z.ZodNumber>;
+                        durationMs: z.ZodOptional<z.ZodNumber>;
+                        description: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        poster: z.ZodOptional<z.ZodString>;
+                        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        message: z.ZodString;
+                        level: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        source: z.ZodOptional<z.ZodObject<{
+                            file: z.ZodOptional<z.ZodString>;
+                            line: z.ZodOptional<z.ZodNumber>;
+                            column: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            url: z.ZodString;
+                            name: z.ZodOptional<z.ZodString>;
+                            rel: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    role: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    bundleKey: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    description: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    poster: z.ZodOptional<z.ZodString>;
+                    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    level: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    source: z.ZodOptional<z.ZodObject<{
+                        file: z.ZodOptional<z.ZodString>;
+                        line: z.ZodOptional<z.ZodNumber>;
+                        column: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        name: z.ZodOptional<z.ZodString>;
+                        rel: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                contentType: z.ZodOptional<z.ZodString>;
+                bundleKey: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                poster: z.ZodOptional<z.ZodString>;
+                captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                level: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            id: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            detail: z.ZodDefault<z.ZodString>;
+            specPath: z.ZodOptional<z.ZodString>;
+            measurements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodNumber;
+                unit: z.ZodString;
+                limit: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+    source: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        source: z.ZodString;
+        packageDir: z.ZodString;
+        bucket: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        updatedAtMs: z.ZodNumber;
+        environment: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            title: z.ZodString;
+            checks: z.ZodArray<z.ZodObject<{
+                steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    parentId: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    kind: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    detail: z.ZodOptional<z.ZodString>;
+                    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        name: z.ZodString;
+                        role: z.ZodOptional<z.ZodString>;
+                        contentType: z.ZodOptional<z.ZodString>;
+                        bundleKey: z.ZodOptional<z.ZodString>;
+                        uri: z.ZodOptional<z.ZodString>;
+                        text: z.ZodOptional<z.ZodString>;
+                        bytes: z.ZodOptional<z.ZodNumber>;
+                        sha256: z.ZodOptional<z.ZodString>;
+                        width: z.ZodOptional<z.ZodNumber>;
+                        height: z.ZodOptional<z.ZodNumber>;
+                        durationMs: z.ZodOptional<z.ZodNumber>;
+                        description: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        poster: z.ZodOptional<z.ZodString>;
+                        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        message: z.ZodString;
+                        level: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        source: z.ZodOptional<z.ZodObject<{
+                            file: z.ZodOptional<z.ZodString>;
+                            line: z.ZodOptional<z.ZodNumber>;
+                            column: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            url: z.ZodString;
+                            name: z.ZodOptional<z.ZodString>;
+                            rel: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                attempts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    index: z.ZodNumber;
+                    status: z.ZodEnum<{
+                        passed: "passed";
+                        failed: "failed";
+                        running: "running";
+                        "not-run": "not-run";
+                    }>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    startedAtMs: z.ZodOptional<z.ZodNumber>;
+                    detail: z.ZodOptional<z.ZodString>;
+                    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        parentId: z.ZodOptional<z.ZodString>;
+                        name: z.ZodString;
+                        kind: z.ZodOptional<z.ZodString>;
+                        status: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                        durationMs: z.ZodOptional<z.ZodNumber>;
+                        detail: z.ZodOptional<z.ZodString>;
+                        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            id: z.ZodOptional<z.ZodString>;
+                            name: z.ZodString;
+                            role: z.ZodOptional<z.ZodString>;
+                            contentType: z.ZodOptional<z.ZodString>;
+                            bundleKey: z.ZodOptional<z.ZodString>;
+                            uri: z.ZodOptional<z.ZodString>;
+                            text: z.ZodOptional<z.ZodString>;
+                            bytes: z.ZodOptional<z.ZodNumber>;
+                            sha256: z.ZodOptional<z.ZodString>;
+                            width: z.ZodOptional<z.ZodNumber>;
+                            height: z.ZodOptional<z.ZodNumber>;
+                            durationMs: z.ZodOptional<z.ZodNumber>;
+                            description: z.ZodOptional<z.ZodString>;
+                            at: z.ZodOptional<z.ZodObject<{
+                                step: z.ZodOptional<z.ZodString>;
+                                offsetMs: z.ZodOptional<z.ZodNumber>;
+                            }, z.core.$loose>>;
+                            poster: z.ZodOptional<z.ZodString>;
+                            captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        }, z.core.$loose>>>;
+                        annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            type: z.ZodString;
+                            message: z.ZodString;
+                            level: z.ZodOptional<z.ZodString>;
+                            at: z.ZodOptional<z.ZodObject<{
+                                step: z.ZodOptional<z.ZodString>;
+                                offsetMs: z.ZodOptional<z.ZodNumber>;
+                            }, z.core.$loose>>;
+                            source: z.ZodOptional<z.ZodObject<{
+                                file: z.ZodOptional<z.ZodString>;
+                                line: z.ZodOptional<z.ZodNumber>;
+                                column: z.ZodOptional<z.ZodNumber>;
+                            }, z.core.$loose>>;
+                            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                url: z.ZodString;
+                                name: z.ZodOptional<z.ZodString>;
+                                rel: z.ZodOptional<z.ZodString>;
+                            }, z.core.$loose>>>;
+                            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        }, z.core.$loose>>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        name: z.ZodString;
+                        role: z.ZodOptional<z.ZodString>;
+                        contentType: z.ZodOptional<z.ZodString>;
+                        bundleKey: z.ZodOptional<z.ZodString>;
+                        uri: z.ZodOptional<z.ZodString>;
+                        text: z.ZodOptional<z.ZodString>;
+                        bytes: z.ZodOptional<z.ZodNumber>;
+                        sha256: z.ZodOptional<z.ZodString>;
+                        width: z.ZodOptional<z.ZodNumber>;
+                        height: z.ZodOptional<z.ZodNumber>;
+                        durationMs: z.ZodOptional<z.ZodNumber>;
+                        description: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        poster: z.ZodOptional<z.ZodString>;
+                        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        message: z.ZodString;
+                        level: z.ZodOptional<z.ZodString>;
+                        at: z.ZodOptional<z.ZodObject<{
+                            step: z.ZodOptional<z.ZodString>;
+                            offsetMs: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        source: z.ZodOptional<z.ZodObject<{
+                            file: z.ZodOptional<z.ZodString>;
+                            line: z.ZodOptional<z.ZodNumber>;
+                            column: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            url: z.ZodString;
+                            name: z.ZodOptional<z.ZodString>;
+                            rel: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>>;
+                        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    role: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    bundleKey: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    description: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    poster: z.ZodOptional<z.ZodString>;
+                    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    level: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    source: z.ZodOptional<z.ZodObject<{
+                        file: z.ZodOptional<z.ZodString>;
+                        line: z.ZodOptional<z.ZodNumber>;
+                        column: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        name: z.ZodOptional<z.ZodString>;
+                        rel: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                id: z.ZodString;
+                title: z.ZodString;
+                status: z.ZodEnum<{
+                    passed: "passed";
+                    failed: "failed";
+                    running: "running";
+                    "not-run": "not-run";
+                }>;
+                detail: z.ZodDefault<z.ZodString>;
+                specPath: z.ZodOptional<z.ZodString>;
+                measurements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    value: z.ZodNumber;
+                    unit: z.ZodString;
+                    limit: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>>;
+        tests: z.ZodArray<z.ZodObject<{
+            testId: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                skipped: "skipped";
+            }>;
+            system: z.ZodDefault<z.ZodString>;
+            runtime: z.ZodDefault<z.ZodString>;
+            seed: z.ZodDefault<z.ZodString>;
+            durationMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+    recording: z.ZodDefault<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"layer">;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"commit">;
+        sha: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$loose>]>>>;
+    bundle: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        contentType: z.ZodString;
+        parts: z.ZodArray<z.ZodObject<{
+            blob: z.ZodString;
+            offset: z.ZodNumber;
+            size: z.ZodNumber;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/** A layer as a reader holds it: the output of `LayerDocumentSchema`, with defaults applied. */
+export type LayerDocument = z.output<typeof LayerDocumentSchema>;
+/** The outcome of `parseLayerDocument`: the layer, or the reason it could not be read. */
+export type ParsedLayer = {
+    readonly ok: true;
+    readonly layer: LayerDocument;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * Reads a layer manifest of any age and returns it, or the reason it cannot be read; it never throws. Layers written
+ * before `schemaVersion` existed are version 1. A layer of a newer major version is refused by name ("Upgrade
+ * @crvouga/atlas to read it") rather than half understood. Evidence the reader cannot read (a malformed attachment,
+ * step, annotation, link, tag, label or extension) is dropped and the check keeps its status and place; anything
+ * else that fails the schema refuses the whole layer, naming the first problem by its path. Callers treat a refused
+ * layer as unknown, never as passed.
+ *
+ * @see docs/report-contract.md
+ *
+ * @example
+ * ```ts
+ * import { parseLayerDocument } from '@crvouga/atlas/schema';
+ *
+ * const parsed = parseLayerDocument(JSON.parse(text));
+ * if (!parsed.ok) throw new Error(parsed.reason);
+ * for (const part of parsed.layer.parts) console.log(part.kind, part.checks.length);
+ * ```
+ */
+export declare function parseLayerDocument(raw: unknown): ParsedLayer;
+/**
+ * An attachment as a producer hands it over, before the publisher stores its bytes. Give the bytes as
+ * `path` (a file, read by the CLI), `base64`, `data` (from code), or `text`; the publisher stores them in
+ * the layer, fills in `bundleKey`, `bytes` and `sha256`, and removes these four.
+ */
+export declare const AttachmentInputSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodOptional<z.ZodString>;
+    bundleKey: z.ZodOptional<z.ZodString>;
+    uri: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+    sha256: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodObject<{
+        step: z.ZodOptional<z.ZodString>;
+        offsetMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    poster: z.ZodOptional<z.ZodString>;
+    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    path: z.ZodOptional<z.ZodString>;
+    base64: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+}, z.core.$loose>;
+/**
+ * The checks of a layer as a producer hands them to the publisher (`publishChecks`, `atlas report publish --checks`),
+ * before the publisher fills in the rest: `id`, `schemaVersion`, the part around the checks and the bundle of
+ * attachment bytes. It is the whole integration surface of a producer that has no timelines to record. `kind` names
+ * the part and defaults to `checks`. Attachments may carry their bytes (`AttachmentInputSchema`). Emitted as
+ * `publish-checks.schema.json`.
+ */
+export declare const PublishChecksSchema: z.ZodObject<{
+    producer: z.ZodString;
+    checks: z.ZodArray<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            message: z.ZodString;
+            level: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            source: z.ZodOptional<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        detail: z.ZodDefault<z.ZodString>;
+        specPath: z.ZodOptional<z.ZodString>;
+        measurements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodNumber;
+            unit: z.ZodString;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodOptional<z.ZodString>;
+            bundleKey: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodObject<{
+                step: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            poster: z.ZodOptional<z.ZodString>;
+            captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            path: z.ZodOptional<z.ZodString>;
+            base64: z.ZodOptional<z.ZodString>;
+            data: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+        }, z.core.$loose>>>;
+        steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            parentId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            kind: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            detail: z.ZodOptional<z.ZodString>;
+            annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                level: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                contentType: z.ZodOptional<z.ZodString>;
+                bundleKey: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                poster: z.ZodOptional<z.ZodString>;
+                captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                path: z.ZodOptional<z.ZodString>;
+                base64: z.ZodOptional<z.ZodString>;
+                data: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+        attempts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            startedAtMs: z.ZodOptional<z.ZodNumber>;
+            detail: z.ZodOptional<z.ZodString>;
+            annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                level: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    rel: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                parentId: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                kind: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                offsetMs: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                detail: z.ZodOptional<z.ZodString>;
+                annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    level: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    source: z.ZodOptional<z.ZodObject<{
+                        file: z.ZodOptional<z.ZodString>;
+                        line: z.ZodOptional<z.ZodNumber>;
+                        column: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        name: z.ZodOptional<z.ZodString>;
+                        rel: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$loose>>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    role: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    bundleKey: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    description: z.ZodOptional<z.ZodString>;
+                    at: z.ZodOptional<z.ZodObject<{
+                        step: z.ZodOptional<z.ZodString>;
+                        offsetMs: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                    poster: z.ZodOptional<z.ZodString>;
+                    captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    path: z.ZodOptional<z.ZodString>;
+                    base64: z.ZodOptional<z.ZodString>;
+                    data: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                contentType: z.ZodOptional<z.ZodString>;
+                bundleKey: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                at: z.ZodOptional<z.ZodObject<{
+                    step: z.ZodOptional<z.ZodString>;
+                    offsetMs: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+                poster: z.ZodOptional<z.ZodString>;
+                captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                path: z.ZodOptional<z.ZodString>;
+                base64: z.ZodOptional<z.ZodString>;
+                data: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    kind: z.ZodDefault<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    recordedAtMs: z.ZodNumber;
+    sha: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    branch: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    runUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    environment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        modified: "modified";
+    }>>;
+    specs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        domain: z.ZodString;
+        kind: z.ZodString;
+        title: z.ZodString;
+        fingerprint: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        bundleKey: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        description: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        poster: z.ZodOptional<z.ZodString>;
+        captions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        path: z.ZodOptional<z.ZodString>;
+        base64: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+    }, z.core.$loose>>>;
+    annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        level: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodObject<{
+            step: z.ZodOptional<z.ZodString>;
+            offsetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        source: z.ZodOptional<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            rel: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** What a caller passes to `publishChecks`: the input type of `PublishChecksSchema`, before defaults. */
+export type PublishChecksInput = z.input<typeof PublishChecksSchema>;
+/** The `schemaVersion` of the `ReportStatus` JSON, currently 1. */
+export declare const REPORT_STATUS_SCHEMA_VERSION = 1;
+/**
+ * What `atlas report status --format json` prints: the combined report in numbers, and whether it
+ * passes. `ok` is the gate: nothing failed, nothing is still running, nothing could not be read,
+ * and every required environment has results.
+ */
+export declare const ReportStatusSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    ok: z.ZodBoolean;
+    reasons: z.ZodArray<z.ZodString>;
+    checks: z.ZodObject<{
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        running: z.ZodNumber;
+        'not-run': z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+    byEnvironment: z.ZodRecord<z.ZodString, z.ZodObject<{
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        running: z.ZodNumber;
+        'not-run': z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>>;
+    layers: z.ZodNumber;
+    backends: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        available: z.ZodBoolean;
+    }, z.core.$strip>>;
+    notices: z.ZodArray<z.ZodString>;
+    specsWithoutEvidence: z.ZodArray<z.ZodString>;
+    specs: z.ZodArray<z.ZodObject<{
+        path: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodString;
+        checks: z.ZodObject<{
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            running: z.ZodNumber;
+            'not-run': z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+        byEnvironment: z.ZodRecord<z.ZodString, z.ZodObject<{
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            running: z.ZodNumber;
+            'not-run': z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$loose>>;
+    failing: z.ZodArray<z.ZodObject<{
+        spec: z.ZodNullable<z.ZodString>;
+        check: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            running: "running";
+        }>;
+        environment: z.ZodNullable<z.ZodString>;
+        producer: z.ZodString;
+        branch: z.ZodNullable<z.ZodString>;
+        sha: z.ZodNullable<z.ZodString>;
+        layer: z.ZodString;
+        backend: z.ZodString;
+        runUrl: z.ZodNullable<z.ZodString>;
+        detail: z.ZodString;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A parsed `ReportStatusSchema` value. */
+export type ReportStatus = z.output<typeof ReportStatusSchema>;
+/**
+ * The specs of one version of a project, as published: what the report is laid over. Layers of
+ * evidence say what ran; a spec set says what the specs were. Like layers, spec sets are immutable and
+ * never replace each other: the node shows the newest one of the branch you choose.
+ */
+export declare const SpecSetSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    branch: z.ZodNullable<z.ZodString>;
+    sha: z.ZodNullable<z.ZodString>;
+    recordedAtMs: z.ZodNumber;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        modified: "modified";
+    }>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        digest: z.ZodString;
+        fingerprint: z.ZodString;
+        kind: z.ZodString;
+        title: z.ZodString;
+        domain: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A parsed `SpecSetSchema` value. */
+export type SpecSet = z.output<typeof SpecSetSchema>;