@crvouga/atlas 0.16.0 → 0.17.0

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

@@ -121,6 +121,7 @@ export declare const AttachmentSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
+    omitted: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     at: z.ZodOptional<z.ZodObject<{
         step: z.ZodOptional<z.ZodString>;
@@ -132,6 +133,59 @@ export declare const AttachmentSchema: z.ZodObject<{
 }, z.core.$loose>;
 /** An attachment as stored in a layer, parsed from `AttachmentSchema`. */
 export type Attachment = z.output<typeof AttachmentSchema>;
+/**
+ * Whether a check is expected to have a screen recording (a video). `required`: the producer expects one, and the layer's
+ * recording receipt says whether it arrived. `not-applicable`: the check is intentionally unrecorded (an API-only check),
+ * so it counts as neither a recorded pass nor a missing video. An open string: a reader treats any other value, and its
+ * absence, as no expectation.
+ */
+export declare const RECORDING_EXPECTATIONS: readonly ["required", "not-applicable"];
+/**
+ * The state of one check's recording in a receipt, in an open vocabulary. Conventions: `uploaded` (the video's bytes are in
+ * the layer, with a checksum), `referenced` (only a `uri` was given: Atlas cannot vouch for it), `skipped` (the video was
+ * captured but its bytes were left out, with a reason), `unresolved` (no video was attached at all), `not-applicable`
+ * (intentionally unrecorded). A reader shows a state it does not know as it is and never counts it as uploaded.
+ */
+export declare const RecordingItemSchema: z.ZodObject<{
+    check: z.ZodString;
+    state: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        state: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/**
+ * What a layer's producer published about the recordings it expected: counts and one item per check that expected a
+ * recording (or declared itself not applicable). Written by `publishChecks` when any check declares a
+ * `recordingExpectation`; a layer without it says nothing, which a reader reports as Unknown, never Complete. It only
+ * describes publication: it never changes a check's status, its slot or which result wins.
+ */
+export declare const RecordingReceiptSchema: z.ZodObject<{
+    expected: z.ZodNumber;
+    uploaded: z.ZodNumber;
+    referenced: z.ZodNumber;
+    skipped: z.ZodNumber;
+    unresolved: z.ZodNumber;
+    notApplicable: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        check: z.ZodString;
+        state: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            state: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A recording receipt as stored in a layer, parsed from `RecordingReceiptSchema`. */
+export type RecordingReceipt = z.output<typeof RecordingReceiptSchema>;
 /** 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;
@@ -182,6 +236,7 @@ export declare const StepSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -250,6 +305,7 @@ export declare const AttemptSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -295,6 +351,7 @@ export declare const AttemptSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -359,6 +416,7 @@ export declare const CheckSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -424,6 +482,7 @@ export declare const CheckSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -469,6 +528,7 @@ export declare const CheckSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -521,6 +581,7 @@ export declare const CheckSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -568,6 +629,7 @@ export declare const CheckSchema: z.ZodObject<{
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$loose>>>;
     durationMs: z.ZodOptional<z.ZodNumber>;
+    recordingExpectation: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 /** A check as stored in a layer, parsed from `CheckSchema`. */
 export type Check = z.output<typeof CheckSchema>;
@@ -608,6 +670,7 @@ export declare const ReportPartSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -672,6 +735,7 @@ export declare const ReportPartSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -737,6 +801,7 @@ export declare const ReportPartSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -782,6 +847,7 @@ export declare const ReportPartSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -834,6 +900,7 @@ export declare const ReportPartSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -881,6 +948,7 @@ export declare const ReportPartSchema: z.ZodObject<{
             limit: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>>>;
         durationMs: z.ZodOptional<z.ZodNumber>;
+        recordingExpectation: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 /** A suite that recorded timelines and captured files, beside its checks. Absent for a layer of plain checks. */
@@ -923,6 +991,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -988,6 +1057,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1033,6 +1103,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1085,6 +1156,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -1132,6 +1204,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                 limit: z.ZodOptional<z.ZodNumber>;
             }, z.core.$loose>>>;
             durationMs: z.ZodOptional<z.ZodNumber>;
+            recordingExpectation: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
     }, z.core.$loose>>>;
     tests: z.ZodArray<z.ZodObject<{
@@ -1200,6 +1273,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -1278,6 +1352,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -1342,6 +1417,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1407,6 +1483,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1452,6 +1529,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1504,6 +1582,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -1551,6 +1630,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                 limit: z.ZodOptional<z.ZodNumber>;
             }, z.core.$loose>>>;
             durationMs: z.ZodOptional<z.ZodNumber>;
+            recordingExpectation: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     source: z.ZodDefault<z.ZodNullable<z.ZodObject<{
@@ -1592,6 +1672,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1657,6 +1738,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                             height: z.ZodOptional<z.ZodNumber>;
                             durationMs: z.ZodOptional<z.ZodNumber>;
                             description: z.ZodOptional<z.ZodString>;
+                            omitted: z.ZodOptional<z.ZodString>;
                             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                             at: z.ZodOptional<z.ZodObject<{
                                 step: z.ZodOptional<z.ZodString>;
@@ -1702,6 +1784,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1754,6 +1837,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1801,6 +1885,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     limit: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$loose>>>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
+                recordingExpectation: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>;
         }, z.core.$loose>>>;
         tests: z.ZodArray<z.ZodObject<{
@@ -1832,6 +1917,26 @@ export declare const LayerDocumentSchema: z.ZodObject<{
             size: z.ZodNumber;
         }, z.core.$loose>>;
     }, z.core.$loose>>>;
+    recordings: z.ZodOptional<z.ZodObject<{
+        expected: z.ZodNumber;
+        uploaded: z.ZodNumber;
+        referenced: z.ZodNumber;
+        skipped: z.ZodNumber;
+        unresolved: z.ZodNumber;
+        notApplicable: z.ZodNumber;
+        items: z.ZodArray<z.ZodObject<{
+            check: z.ZodString;
+            state: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+        }, 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>;
@@ -1882,6 +1987,7 @@ export declare const AttachmentInputSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
+    omitted: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     at: z.ZodOptional<z.ZodObject<{
         step: z.ZodOptional<z.ZodString>;
@@ -1949,6 +2055,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
             limit: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>>>;
         durationMs: z.ZodOptional<z.ZodNumber>;
+        recordingExpectation: z.ZodOptional<z.ZodString>;
         attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             name: z.ZodString;
@@ -1963,6 +2070,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -2019,6 +2127,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -2108,6 +2217,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -2135,6 +2245,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -2195,6 +2306,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -2231,6 +2343,36 @@ export declare const PublishChecksSchema: z.ZodObject<{
 }, z.core.$loose>;
 /** What a caller passes to `publishChecks`: the input type of `PublishChecksSchema`, before defaults. */
 export type PublishChecksInput = z.input<typeof PublishChecksSchema>;
+/**
+ * Recording completeness across the winning results of a report: `complete` (every expected recording was published),
+ * `incomplete` (at least one is skipped or unresolved), `none-expected` (every layer declared its expectations, and none
+ * required a recording) or `unknown` (a layer has no receipt, so nothing is claimed). Independent of the checks' outcomes.
+ */
+export declare const RecordingCompletenessSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        complete: "complete";
+        incomplete: "incomplete";
+        "none-expected": "none-expected";
+    }>;
+    expected: z.ZodNumber;
+    uploaded: z.ZodNumber;
+    referenced: z.ZodNumber;
+    skipped: z.ZodNumber;
+    unresolved: z.ZodNumber;
+    notApplicable: z.ZodNumber;
+    layersWithoutReceipt: z.ZodNumber;
+    gaps: z.ZodArray<z.ZodObject<{
+        spec: z.ZodNullable<z.ZodString>;
+        check: z.ZodString;
+        layer: z.ZodString;
+        environment: z.ZodNullable<z.ZodString>;
+        state: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A parsed `RecordingCompletenessSchema` value. */
+export type RecordingCompleteness = z.output<typeof RecordingCompletenessSchema>;
 /** The `schemaVersion` of the `ReportStatus` JSON, currently 1. */
 export declare const REPORT_STATUS_SCHEMA_VERSION = 1;
 /**
@@ -2300,6 +2442,29 @@ export declare const ReportStatusSchema: z.ZodObject<{
         runUrl: z.ZodNullable<z.ZodString>;
         detail: z.ZodString;
     }, z.core.$loose>>;
+    recordings: z.ZodOptional<z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            complete: "complete";
+            incomplete: "incomplete";
+            "none-expected": "none-expected";
+        }>;
+        expected: z.ZodNumber;
+        uploaded: z.ZodNumber;
+        referenced: z.ZodNumber;
+        skipped: z.ZodNumber;
+        unresolved: z.ZodNumber;
+        notApplicable: z.ZodNumber;
+        layersWithoutReceipt: z.ZodNumber;
+        gaps: z.ZodArray<z.ZodObject<{
+            spec: z.ZodNullable<z.ZodString>;
+            check: z.ZodString;
+            layer: z.ZodString;
+            environment: z.ZodNullable<z.ZodString>;
+            state: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 /** A parsed `ReportStatusSchema` value. */
 export type ReportStatus = z.output<typeof ReportStatusSchema>;

package/dist/schema/src/layer.js

@@ -109,12 +109,53 @@ export const AttachmentSchema = z.looseObject({
     height: z.number().nonnegative().optional(),
     durationMs: z.number().nonnegative().optional().describe('For video and audio'),
     description: z.string().optional(),
+    omitted: z.string().optional().describe('Why the producer did not include its bytes, in an open vocabulary: too-large, not-found, not-allowed, over-budget, policy… Present on a metadata-only attachment, so a reader can tell "left out" from "never recorded"'),
     tags: z.array(z.string()).optional().describe('Free labels of this one attachment, such as `demo`: shown as `#demo`, searchable, and normalized by `normalizeTag` (a leading `#` and letter case never matter). Unlike the tags of a check they say nothing about its result'),
     at: MomentSchema.optional(),
     poster: z.string().optional().describe('The `id` of an attachment that stands for this one before it is opened'),
     captions: z.array(z.string()).optional().describe('The `id`s of attachments (WebVTT, SRT) that caption this one'),
     extensions: ExtensionsSchema.optional()
 });
+/**
+ * Whether a check is expected to have a screen recording (a video). `required`: the producer expects one, and the layer's
+ * recording receipt says whether it arrived. `not-applicable`: the check is intentionally unrecorded (an API-only check),
+ * so it counts as neither a recorded pass nor a missing video. An open string: a reader treats any other value, and its
+ * absence, as no expectation.
+ */
+export const RECORDING_EXPECTATIONS = ['required', 'not-applicable'];
+/**
+ * The state of one check's recording in a receipt, in an open vocabulary. Conventions: `uploaded` (the video's bytes are in
+ * the layer, with a checksum), `referenced` (only a `uri` was given: Atlas cannot vouch for it), `skipped` (the video was
+ * captured but its bytes were left out, with a reason), `unresolved` (no video was attached at all), `not-applicable`
+ * (intentionally unrecorded). A reader shows a state it does not know as it is and never counts it as uploaded.
+ */
+export const RecordingItemSchema = z.looseObject({
+    check: z.string().min(1).describe('The id of the check'),
+    state: z.string().min(1),
+    reason: z.string().optional().describe('Why the recording is not uploaded. Never contains a path, a token or payload data'),
+    files: z.array(z.looseObject({
+        name: z.string(),
+        state: z.string().optional(),
+        bytes: z.number().int().nonnegative().optional(),
+        sha256: z.string().optional().describe('The checksum of the stored bytes: proof the layer holds this exact file'),
+        reason: z.string().optional()
+    })).optional().describe('Every video attachment of the check, at any level')
+});
+/**
+ * What a layer's producer published about the recordings it expected: counts and one item per check that expected a
+ * recording (or declared itself not applicable). Written by `publishChecks` when any check declares a
+ * `recordingExpectation`; a layer without it says nothing, which a reader reports as Unknown, never Complete. It only
+ * describes publication: it never changes a check's status, its slot or which result wins.
+ */
+export const RecordingReceiptSchema = z.looseObject({
+    expected: z.number().int().nonnegative().describe('Checks that required a recording: uploaded + referenced + skipped + unresolved'),
+    uploaded: z.number().int().nonnegative(),
+    referenced: z.number().int().nonnegative(),
+    skipped: z.number().int().nonnegative(),
+    unresolved: z.number().int().nonnegative(),
+    notApplicable: z.number().int().nonnegative().describe('Checks intentionally unrecorded. They are not expected and not missing'),
+    items: z.array(RecordingItemSchema)
+});
 /** A note about a result: a warning, a deprecation, a coverage figure, an accessibility finding, anything. */
 export const AnnotationSchema = z.looseObject({
     type: z.string().min(1).describe('An open vocabulary: note, warning, deprecation, issue, accessibility, coverage…'),
@@ -178,6 +219,7 @@ export const CheckSchema = z.looseObject({
     specPath: z.string().optional().describe('The spec this check belongs to, relative to the repository, such as specs/join.feature'),
     measurements: z.array(MeasurementSchema).default([]),
     durationMs: z.number().nonnegative().optional().describe('How long the check took, when the producer measured it'),
+    recordingExpectation: z.string().optional().describe('`required`: expect a video of this check, and report whether it was published. `not-applicable`: intentionally unrecorded. Absent: no expectation. Never changes the check\'s status'),
     ...evidenceShape,
     steps: z.array(StepSchema).optional().describe("The check's timeline"),
     attempts: z.array(AttemptSchema).optional().describe('Every try, when the check was retried')
@@ -269,6 +311,7 @@ export const LayerDocumentSchema = z.looseObject({
     source: LayerSourceSchema.nullable().default(null),
     recording: RecordingAddressSchema.nullable().default(null),
     bundle: BundleIndexSchema.default({}),
+    recordings: RecordingReceiptSchema.optional().describe('Which expected recordings were published. Absent: the producer expected none, or predates this field; a reader reports Unknown'),
     ...evidenceShape
 });
 /**
@@ -321,6 +364,14 @@ function lenientEvidence(holder, nested = []) {
 }
 function lenientLayer(raw) {
     const layer = lenientEvidence(raw);
+    // A receipt a reader cannot read is no receipt: recording completeness is then Unknown, and the layer is kept.
+    if ('recordings' in layer) {
+        const receipt = RecordingReceiptSchema.safeParse(layer.recordings);
+        if (receipt.success)
+            layer.recordings = receipt.data;
+        else
+            delete layer.recordings;
+    }
     // The execution only groups and labels: one that cannot be read leaves the layer to the documented grouping, never refuses it.
     if ('run' in layer && !LayerRunSchema.safeParse(layer.run).success)
         delete layer.run;
@@ -426,6 +477,25 @@ const CountsSchema = z.object({
     'not-run': z.number().int().nonnegative(),
     total: z.number().int().nonnegative()
 });
+/**
+ * Recording completeness across the winning results of a report: `complete` (every expected recording was published),
+ * `incomplete` (at least one is skipped or unresolved), `none-expected` (every layer declared its expectations, and none
+ * required a recording) or `unknown` (a layer has no receipt, so nothing is claimed). Independent of the checks' outcomes.
+ */
+export const RecordingCompletenessSchema = z.looseObject({
+    state: z.enum(['complete', 'incomplete', 'none-expected', 'unknown']),
+    expected: z.number().int().nonnegative(),
+    uploaded: z.number().int().nonnegative(),
+    referenced: z.number().int().nonnegative(),
+    skipped: z.number().int().nonnegative(),
+    unresolved: z.number().int().nonnegative(),
+    notApplicable: z.number().int().nonnegative(),
+    layersWithoutReceipt: z.number().int().nonnegative().describe('Layers that contribute results but declared no recording expectations: their completeness is unknown'),
+    gaps: z.array(z.looseObject({
+        spec: z.string().nullable(), check: z.string(), layer: z.string(), environment: z.string().nullable(),
+        state: z.string(), reason: z.string().optional()
+    })).describe('Each expected recording that is skipped or unresolved')
+});
 /** The `schemaVersion` of the `ReportStatus` JSON, currently 1. */
 export const REPORT_STATUS_SCHEMA_VERSION = 1;
 /**
@@ -463,7 +533,8 @@ export const ReportStatusSchema = z.looseObject({
         backend: z.string(),
         runUrl: z.string().nullable(),
         detail: z.string()
-    })).describe('Each slot whose newest completed result failed, or that is still running')
+    })).describe('Each slot whose newest completed result failed, or that is still running'),
+    recordings: RecordingCompletenessSchema.optional().describe('Whether the recordings the producers expected were published, separately from `ok`. It never changes `ok`')
 });
 /**
  * The specs of one version of a project, as published: what the report is laid over. Layers of

package/docs/reference/cli.md

@@ -91,6 +91,7 @@ atlas report — layered evidence for any kind of spec
                        [--param key=value]... [--kind <k>] [--title <t>] [--recorded-at <iso|ms>]
                        [--attach [role=]<file>]... [--label key=value]... [--link [name=]<url>]...
                        [--attach-root <dir>]... [--max-attachment-mb <n>] [--max-total-attachment-mb <n>]
+                       [--require-recordings]
   atlas report stream  [--store <dir|s3://…|https://atlas.example.com>] --producer <name> [--environment <name>]
                        [--branch <b>] [--sha <s>] [--run-url <u>] [--kind <k>] [--param key=value]...
                        [--run-id <id>] [--run-title <t>]
@@ -127,6 +128,10 @@ atlas report — layered evidence for any kind of spec
             Files a report names (CTRF attachments, JUnit [[ATTACHMENT|path]] lines) come from the report's own
             folder and each --attach-root, and never from a hidden file or a link out: a report is data from a
             test run, not instructions. One that is missing or not allowed is skipped with a warning.
+            --require-recordings   exit 1 when a check that declared recordingExpectation "required" has no
+                              uploaded video (absent, left out as too large or not allowed, or refused). The layer is
+                              still written and the checks keep their results; only this command fails. The receipt of
+                              what was uploaded (counts, sizes, checksums) is in the JSON result under layer.recordings.
             From a checkout with uncommitted changes the layer is marked "modified".
   stream    Send checks as they finish: one JSON object per line on standard input (the fields of one
             check: id, title, status, and any evidence). Each second's worth becomes one layer, so a server