@crvouga/atlas 0.9.0 → 0.10.1

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

@@ -798,3 +798,588 @@ export declare const ReportEventSchema: z.ZodObject<{
 }, z.core.$loose>;
 /** The data of the `ping` event: sent every `heartbeatSeconds`, so a quiet server is told apart from a dead connection. */
 export declare const PingEventSchema: z.ZodObject<{}, z.core.$loose>;
+/** One recorded result of a test in the test catalog: when, where, how it went and how long it took, and where it came from. */
+export declare const TestResultEntrySchema: z.ZodObject<{
+    at: z.ZodNumber;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        running: "running";
+        "not-run": "not-run";
+    }>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    environment: z.ZodNullable<z.ZodString>;
+    producer: z.ZodString;
+    kind: z.ZodString;
+    parameters: z.ZodRecord<z.ZodString, z.ZodString>;
+    branch: z.ZodNullable<z.ZodString>;
+    sha: z.ZodNullable<z.ZodString>;
+    runUrl: z.ZodNullable<z.ZodString>;
+    run: z.ZodString;
+    layer: z.ZodString;
+    backend: z.ZodString;
+    detail: z.ZodString;
+    evidence: z.ZodOptional<z.ZodObject<{
+        attachments: z.ZodNumber;
+        steps: z.ZodNumber;
+        annotations: z.ZodNumber;
+        attempts: z.ZodNumber;
+        links: z.ZodNumber;
+        tags: z.ZodArray<z.ZodString>;
+        labels: z.ZodRecord<z.ZodString, z.ZodString>;
+        roles: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** One test of the catalog: what it is, its current result per environment, and how it has gone over its recorded history. */
+export declare const TestSummarySchema: z.ZodObject<{
+    key: z.ZodString;
+    id: z.ZodString;
+    title: z.ZodString;
+    specPath: z.ZodNullable<z.ZodString>;
+    spec: z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodString;
+        domain: z.ZodString;
+        kind: z.ZodString;
+    }, z.core.$loose>>;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        running: "running";
+        "not-run": "not-run";
+    }>;
+    environments: z.ZodArray<z.ZodString>;
+    producers: z.ZodArray<z.ZodString>;
+    outcomes: z.ZodArray<z.ZodObject<{
+        at: z.ZodNumber;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        environment: z.ZodNullable<z.ZodString>;
+        producer: z.ZodString;
+        kind: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        sha: z.ZodNullable<z.ZodString>;
+        runUrl: z.ZodNullable<z.ZodString>;
+        run: z.ZodString;
+        layer: z.ZodString;
+        backend: z.ZodString;
+        detail: z.ZodString;
+        evidence: z.ZodOptional<z.ZodObject<{
+            attachments: z.ZodNumber;
+            steps: z.ZodNumber;
+            annotations: z.ZodNumber;
+            attempts: z.ZodNumber;
+            links: z.ZodNumber;
+            tags: z.ZodArray<z.ZodString>;
+            labels: z.ZodRecord<z.ZodString, z.ZodString>;
+            roles: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+    stats: z.ZodObject<{
+        results: z.ZodNumber;
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        passRate: z.ZodNullable<z.ZodNumber>;
+        flaky: z.ZodBoolean;
+        flakyReason: z.ZodString;
+        flips: z.ZodNumber;
+        durations: z.ZodNullable<z.ZodObject<{
+            count: z.ZodNumber;
+            totalMs: z.ZodNumber;
+            avgMs: z.ZodNumber;
+            p50Ms: z.ZodNumber;
+            p95Ms: z.ZodNumber;
+            minMs: z.ZodNumber;
+            maxMs: z.ZodNumber;
+            lastMs: z.ZodNumber;
+        }, z.core.$loose>>;
+        firstSeenMs: z.ZodNullable<z.ZodNumber>;
+        lastSeenMs: z.ZodNullable<z.ZodNumber>;
+        lastPassedAtMs: z.ZodNullable<z.ZodNumber>;
+        lastFailedAtMs: z.ZodNullable<z.ZodNumber>;
+        runs: z.ZodNumber;
+        branches: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>;
+    tags: z.ZodArray<z.ZodString>;
+    labels: z.ZodRecord<z.ZodString, z.ZodString>;
+    evidence: z.ZodObject<{
+        attachments: z.ZodNumber;
+        steps: z.ZodNumber;
+        attempts: z.ZodNumber;
+        roles: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>;
+    lastRecordedAtMs: z.ZodNumber;
+    live: z.ZodBoolean;
+}, z.core.$loose>;
+/**
+ * `GET /api/reports/tests`: every test of the report with a summary, insights and facets. The summary and facets cover
+ * every test; `tests` is the page of those the query matched.
+ */
+export declare const TestCatalogSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    version: z.ZodString;
+    generatedAtMs: z.ZodNumber;
+    summary: z.ZodObject<{
+        tests: z.ZodNumber;
+        counts: z.ZodRecord<z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>, z.ZodNumber>;
+        outcomes: z.ZodNumber;
+        flaky: z.ZodNumber;
+        durations: z.ZodNullable<z.ZodObject<{
+            count: z.ZodNumber;
+            totalMs: z.ZodNumber;
+            avgMs: z.ZodNumber;
+            p50Ms: z.ZodNumber;
+            p95Ms: z.ZodNumber;
+            minMs: z.ZodNumber;
+            maxMs: z.ZodNumber;
+            lastMs: z.ZodNumber;
+        }, z.core.$loose>>;
+        measured: z.ZodNumber;
+        withAttachments: z.ZodNumber;
+        environments: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            tests: z.ZodNumber;
+            counts: z.ZodRecord<z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>, z.ZodNumber>;
+            avgMs: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$loose>>;
+        producers: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            tests: z.ZodNumber;
+            counts: z.ZodRecord<z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>, z.ZodNumber>;
+            avgMs: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$loose>>;
+        domains: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            tests: z.ZodNumber;
+            counts: z.ZodRecord<z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>, z.ZodNumber>;
+            avgMs: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$loose>>;
+        slowest: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            title: z.ZodString;
+            specPath: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            value: z.ZodNumber;
+        }, z.core.$loose>>;
+        flakiest: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            title: z.ZodString;
+            specPath: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            value: z.ZodNumber;
+        }, z.core.$loose>>;
+        failing: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            title: z.ZodString;
+            specPath: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            value: z.ZodNumber;
+        }, z.core.$loose>>;
+        runs: z.ZodNumber;
+        lastRecordedAtMs: z.ZodNullable<z.ZodNumber>;
+        history: z.ZodBoolean;
+    }, z.core.$loose>;
+    facets: z.ZodObject<{
+        statuses: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>;
+        environments: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>;
+        producers: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>;
+        domains: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>;
+        specs: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            title: z.ZodString;
+            domain: z.ZodString;
+            kind: z.ZodString;
+            tests: z.ZodNumber;
+            counts: z.ZodRecord<z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>, z.ZodNumber>;
+        }, z.core.$loose>>;
+        tags: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>;
+        branches: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>;
+        labels: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>;
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+    tests: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        id: z.ZodString;
+        title: z.ZodString;
+        specPath: z.ZodNullable<z.ZodString>;
+        spec: z.ZodNullable<z.ZodObject<{
+            path: z.ZodString;
+            title: z.ZodString;
+            domain: z.ZodString;
+            kind: z.ZodString;
+        }, z.core.$loose>>;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        environments: z.ZodArray<z.ZodString>;
+        producers: z.ZodArray<z.ZodString>;
+        outcomes: z.ZodArray<z.ZodObject<{
+            at: z.ZodNumber;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            durationMs: z.ZodNullable<z.ZodNumber>;
+            environment: z.ZodNullable<z.ZodString>;
+            producer: z.ZodString;
+            kind: z.ZodString;
+            parameters: z.ZodRecord<z.ZodString, z.ZodString>;
+            branch: z.ZodNullable<z.ZodString>;
+            sha: z.ZodNullable<z.ZodString>;
+            runUrl: z.ZodNullable<z.ZodString>;
+            run: z.ZodString;
+            layer: z.ZodString;
+            backend: z.ZodString;
+            detail: z.ZodString;
+            evidence: z.ZodOptional<z.ZodObject<{
+                attachments: z.ZodNumber;
+                steps: z.ZodNumber;
+                annotations: z.ZodNumber;
+                attempts: z.ZodNumber;
+                links: z.ZodNumber;
+                tags: z.ZodArray<z.ZodString>;
+                labels: z.ZodRecord<z.ZodString, z.ZodString>;
+                roles: z.ZodArray<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+        stats: z.ZodObject<{
+            results: z.ZodNumber;
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            passRate: z.ZodNullable<z.ZodNumber>;
+            flaky: z.ZodBoolean;
+            flakyReason: z.ZodString;
+            flips: z.ZodNumber;
+            durations: z.ZodNullable<z.ZodObject<{
+                count: z.ZodNumber;
+                totalMs: z.ZodNumber;
+                avgMs: z.ZodNumber;
+                p50Ms: z.ZodNumber;
+                p95Ms: z.ZodNumber;
+                minMs: z.ZodNumber;
+                maxMs: z.ZodNumber;
+                lastMs: z.ZodNumber;
+            }, z.core.$loose>>;
+            firstSeenMs: z.ZodNullable<z.ZodNumber>;
+            lastSeenMs: z.ZodNullable<z.ZodNumber>;
+            lastPassedAtMs: z.ZodNullable<z.ZodNumber>;
+            lastFailedAtMs: z.ZodNullable<z.ZodNumber>;
+            runs: z.ZodNumber;
+            branches: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+        tags: z.ZodArray<z.ZodString>;
+        labels: z.ZodRecord<z.ZodString, z.ZodString>;
+        evidence: z.ZodObject<{
+            attachments: z.ZodNumber;
+            steps: z.ZodNumber;
+            attempts: z.ZodNumber;
+            roles: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+        lastRecordedAtMs: z.ZodNumber;
+        live: z.ZodBoolean;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** `GET /api/reports/tests/history`: one test and every result recorded for it (at most 100), newest first. */
+export declare const TestHistorySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    version: z.ZodString;
+    test: z.ZodObject<{
+        key: z.ZodString;
+        id: z.ZodString;
+        title: z.ZodString;
+        specPath: z.ZodNullable<z.ZodString>;
+        spec: z.ZodNullable<z.ZodObject<{
+            path: z.ZodString;
+            title: z.ZodString;
+            domain: z.ZodString;
+            kind: z.ZodString;
+        }, z.core.$loose>>;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        environments: z.ZodArray<z.ZodString>;
+        producers: z.ZodArray<z.ZodString>;
+        outcomes: z.ZodArray<z.ZodObject<{
+            at: z.ZodNumber;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            durationMs: z.ZodNullable<z.ZodNumber>;
+            environment: z.ZodNullable<z.ZodString>;
+            producer: z.ZodString;
+            kind: z.ZodString;
+            parameters: z.ZodRecord<z.ZodString, z.ZodString>;
+            branch: z.ZodNullable<z.ZodString>;
+            sha: z.ZodNullable<z.ZodString>;
+            runUrl: z.ZodNullable<z.ZodString>;
+            run: z.ZodString;
+            layer: z.ZodString;
+            backend: z.ZodString;
+            detail: z.ZodString;
+            evidence: z.ZodOptional<z.ZodObject<{
+                attachments: z.ZodNumber;
+                steps: z.ZodNumber;
+                annotations: z.ZodNumber;
+                attempts: z.ZodNumber;
+                links: z.ZodNumber;
+                tags: z.ZodArray<z.ZodString>;
+                labels: z.ZodRecord<z.ZodString, z.ZodString>;
+                roles: z.ZodArray<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+        stats: z.ZodObject<{
+            results: z.ZodNumber;
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            passRate: z.ZodNullable<z.ZodNumber>;
+            flaky: z.ZodBoolean;
+            flakyReason: z.ZodString;
+            flips: z.ZodNumber;
+            durations: z.ZodNullable<z.ZodObject<{
+                count: z.ZodNumber;
+                totalMs: z.ZodNumber;
+                avgMs: z.ZodNumber;
+                p50Ms: z.ZodNumber;
+                p95Ms: z.ZodNumber;
+                minMs: z.ZodNumber;
+                maxMs: z.ZodNumber;
+                lastMs: z.ZodNumber;
+            }, z.core.$loose>>;
+            firstSeenMs: z.ZodNullable<z.ZodNumber>;
+            lastSeenMs: z.ZodNullable<z.ZodNumber>;
+            lastPassedAtMs: z.ZodNullable<z.ZodNumber>;
+            lastFailedAtMs: z.ZodNullable<z.ZodNumber>;
+            runs: z.ZodNumber;
+            branches: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+        tags: z.ZodArray<z.ZodString>;
+        labels: z.ZodRecord<z.ZodString, z.ZodString>;
+        evidence: z.ZodObject<{
+            attachments: z.ZodNumber;
+            steps: z.ZodNumber;
+            attempts: z.ZodNumber;
+            roles: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+        lastRecordedAtMs: z.ZodNumber;
+        live: z.ZodBoolean;
+    }, z.core.$loose>;
+    history: z.ZodArray<z.ZodObject<{
+        at: z.ZodNumber;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        environment: z.ZodNullable<z.ZodString>;
+        producer: z.ZodString;
+        kind: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        sha: z.ZodNullable<z.ZodString>;
+        runUrl: z.ZodNullable<z.ZodString>;
+        run: z.ZodString;
+        layer: z.ZodString;
+        backend: z.ZodString;
+        detail: z.ZodString;
+        evidence: z.ZodOptional<z.ZodObject<{
+            attachments: z.ZodNumber;
+            steps: z.ZodNumber;
+            annotations: z.ZodNumber;
+            attempts: z.ZodNumber;
+            links: z.ZodNumber;
+            tags: z.ZodArray<z.ZodString>;
+            labels: z.ZodRecord<z.ZodString, z.ZodString>;
+            roles: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A run: the layers that share a run URL (else a branch and commit), with what they recorded. */
+export declare const ReportRunSchema: z.ZodObject<{
+    key: z.ZodString;
+    runUrl: z.ZodNullable<z.ZodString>;
+    branch: z.ZodNullable<z.ZodString>;
+    sha: z.ZodNullable<z.ZodString>;
+    startedAtMs: z.ZodNumber;
+    endedAtMs: z.ZodNumber;
+    spanMs: z.ZodNumber;
+    producers: z.ZodArray<z.ZodString>;
+    environments: z.ZodArray<z.ZodString>;
+    layers: z.ZodNumber;
+    tests: z.ZodNumber;
+    counts: z.ZodRecord<z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        running: "running";
+        "not-run": "not-run";
+    }>, z.ZodNumber>;
+    totalDurationMs: z.ZodNullable<z.ZodNumber>;
+    failing: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        title: z.ZodString;
+        environment: z.ZodNullable<z.ZodString>;
+        detail: z.ZodString;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** `GET /api/reports/runs`: runs, newest first. */
+export declare const RunListSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    version: z.ZodString;
+    total: z.ZodNumber;
+    runs: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        runUrl: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        sha: z.ZodNullable<z.ZodString>;
+        startedAtMs: z.ZodNumber;
+        endedAtMs: z.ZodNumber;
+        spanMs: z.ZodNumber;
+        producers: z.ZodArray<z.ZodString>;
+        environments: z.ZodArray<z.ZodString>;
+        layers: z.ZodNumber;
+        tests: z.ZodNumber;
+        counts: z.ZodRecord<z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>, z.ZodNumber>;
+        totalDurationMs: z.ZodNullable<z.ZodNumber>;
+        failing: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            title: z.ZodString;
+            environment: z.ZodNullable<z.ZodString>;
+            detail: z.ZodString;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** `GET /api/reports/runs/detail`: one run and its last result for every test, environment and producer it recorded. */
+export declare const RunDetailSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    version: z.ZodString;
+    run: z.ZodObject<{
+        key: z.ZodString;
+        runUrl: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        sha: z.ZodNullable<z.ZodString>;
+        startedAtMs: z.ZodNumber;
+        endedAtMs: z.ZodNumber;
+        spanMs: z.ZodNumber;
+        producers: z.ZodArray<z.ZodString>;
+        environments: z.ZodArray<z.ZodString>;
+        layers: z.ZodNumber;
+        tests: z.ZodNumber;
+        counts: z.ZodRecord<z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>, z.ZodNumber>;
+        totalDurationMs: z.ZodNullable<z.ZodNumber>;
+        failing: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            title: z.ZodString;
+            environment: z.ZodNullable<z.ZodString>;
+            detail: z.ZodString;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+    results: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        id: z.ZodString;
+        title: z.ZodString;
+        specPath: z.ZodNullable<z.ZodString>;
+        environment: z.ZodNullable<z.ZodString>;
+        producer: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        at: z.ZodNumber;
+        layer: z.ZodString;
+        detail: z.ZodString;
+    }, z.core.$loose>>;
+}, z.core.$loose>;

package/dist/schema/src/api.js

@@ -199,3 +199,108 @@ export const ReportEventSchema = z.looseObject({
 });
 /** The data of the `ping` event: sent every `heartbeatSeconds`, so a quiet server is told apart from a dead connection. */
 export const PingEventSchema = z.looseObject({});
+const StatusCountsSchema = z.record(EvidenceStatusSchema, z.number().int().nonnegative());
+/** One recorded result of a test in the test catalog: when, where, how it went and how long it took, and where it came from. */
+export const TestResultEntrySchema = z.looseObject({
+    at: z.number().describe('When it was recorded, epoch milliseconds'),
+    status: EvidenceStatusSchema,
+    durationMs: z.number().nullable().describe('How long it took, or null when the producer did not measure it'),
+    environment: z.string().nullable().describe('The client it checked, such as `desktop-web` or `ios`'),
+    producer: z.string(),
+    kind: z.string(),
+    parameters: z.record(z.string(), z.string()),
+    branch: z.string().nullable(),
+    sha: z.string().nullable(),
+    runUrl: z.string().nullable(),
+    run: z.string().describe('The key of the run it belongs to, as `GET /api/reports/runs` lists it'),
+    layer: z.string().describe('The id of the layer that recorded it'),
+    backend: z.string(),
+    detail: z.string().describe('Why it has its status, at most 500 characters'),
+    evidence: EvidenceSummarySchema.optional()
+});
+const DurationStatsSchema = z.looseObject({
+    count: z.number().int().nonnegative(), totalMs: z.number(), avgMs: z.number(), p50Ms: z.number(), p95Ms: z.number(), minMs: z.number(), maxMs: z.number(), lastMs: z.number()
+});
+const CatalogSpecSchema = z.looseObject({ path: z.string(), title: z.string(), domain: z.string(), kind: z.string() });
+/** One test of the catalog: what it is, its current result per environment, and how it has gone over its recorded history. */
+export const TestSummarySchema = z.looseObject({
+    key: z.string().describe('The test\'s identity, `JSON.stringify([specPath, id])`. Pass it to `/api/reports/tests/history?key=`'),
+    id: z.string(),
+    title: z.string(),
+    specPath: z.string().nullable(),
+    spec: CatalogSpecSchema.nullable().describe('The spec it belongs to: recorded by its layers, published in a spec set, or derived from the path'),
+    status: EvidenceStatusSchema.describe('The worst current result across environments: failed, then running, then not-run, then passed'),
+    environments: z.array(z.string()),
+    producers: z.array(z.string()),
+    outcomes: z.array(TestResultEntrySchema).describe('The current result per producer, environment and parameter set, newest first'),
+    stats: z.looseObject({
+        results: z.number().int().nonnegative(), passed: z.number().int().nonnegative(), failed: z.number().int().nonnegative(),
+        passRate: z.number().nullable().describe('passed / (passed + failed), or null with no completed result'),
+        flaky: z.boolean(), flakyReason: z.string(), flips: z.number().int().nonnegative(),
+        durations: DurationStatsSchema.nullable(),
+        firstSeenMs: z.number().nullable(), lastSeenMs: z.number().nullable(), lastPassedAtMs: z.number().nullable(), lastFailedAtMs: z.number().nullable(),
+        runs: z.number().int().nonnegative(), branches: z.array(z.string())
+    }),
+    tags: z.array(z.string()),
+    labels: z.record(z.string(), z.string()),
+    evidence: z.looseObject({ attachments: z.number().int().nonnegative(), steps: z.number().int().nonnegative(), attempts: z.number().int().nonnegative(), roles: z.array(z.string()) }),
+    lastRecordedAtMs: z.number(),
+    live: z.boolean()
+});
+const TestRefSchema = z.looseObject({ key: z.string(), title: z.string(), specPath: z.string().nullable(), status: EvidenceStatusSchema, value: z.number() });
+const CatalogGroupSchema = z.looseObject({ name: z.string(), tests: z.number().int().nonnegative(), counts: StatusCountsSchema, avgMs: z.number().nullable() });
+const FacetValueSchema = z.looseObject({ value: z.string(), count: z.number().int().nonnegative() });
+/**
+ * `GET /api/reports/tests`: every test of the report with a summary, insights and facets. The summary and facets cover
+ * every test; `tests` is the page of those the query matched.
+ */
+export const TestCatalogSchema = z.looseObject({
+    schemaVersion: z.literal(1),
+    version: z.string().describe('Changes whenever the report or its history does'),
+    generatedAtMs: z.number(),
+    summary: z.looseObject({
+        tests: z.number().int().nonnegative(), counts: StatusCountsSchema, outcomes: z.number().int().nonnegative(), flaky: z.number().int().nonnegative(),
+        durations: DurationStatsSchema.nullable(), measured: z.number().int().nonnegative(), withAttachments: z.number().int().nonnegative(),
+        environments: z.array(CatalogGroupSchema), producers: z.array(CatalogGroupSchema), domains: z.array(CatalogGroupSchema),
+        slowest: z.array(TestRefSchema), flakiest: z.array(TestRefSchema), failing: z.array(TestRefSchema),
+        runs: z.number().int().nonnegative(), lastRecordedAtMs: z.number().nullable(), history: z.boolean()
+    }),
+    facets: z.looseObject({
+        statuses: z.array(FacetValueSchema), environments: z.array(FacetValueSchema), producers: z.array(FacetValueSchema), domains: z.array(FacetValueSchema),
+        specs: z.array(CatalogSpecSchema.extend({ tests: z.number().int().nonnegative(), counts: StatusCountsSchema })),
+        tags: z.array(FacetValueSchema), branches: z.array(FacetValueSchema), labels: z.record(z.string(), z.array(FacetValueSchema))
+    }),
+    total: z.number().int().nonnegative().describe('Tests the query matched, before offset and limit'),
+    offset: z.number().int().nonnegative(),
+    limit: z.number().int().nonnegative(),
+    tests: z.array(TestSummarySchema)
+});
+/** `GET /api/reports/tests/history`: one test and every result recorded for it (at most 100), newest first. */
+export const TestHistorySchema = z.looseObject({
+    schemaVersion: z.literal(1),
+    version: z.string(),
+    test: TestSummarySchema,
+    history: z.array(TestResultEntrySchema)
+});
+/** A run: the layers that share a run URL (else a branch and commit), with what they recorded. */
+export const ReportRunSchema = z.looseObject({
+    key: z.string().describe('The run URL, or `branch@sha`. Pass it to `/api/reports/runs/detail?key=` or `/api/reports/tests?run=`'),
+    runUrl: z.string().nullable(), branch: z.string().nullable(), sha: z.string().nullable(),
+    startedAtMs: z.number(), endedAtMs: z.number(), spanMs: z.number(),
+    producers: z.array(z.string()), environments: z.array(z.string()),
+    layers: z.number().int().nonnegative(), tests: z.number().int().nonnegative(), counts: StatusCountsSchema,
+    totalDurationMs: z.number().nullable(),
+    failing: z.array(z.looseObject({ key: z.string(), title: z.string(), environment: z.string().nullable(), detail: z.string() }))
+});
+/** `GET /api/reports/runs`: runs, newest first. */
+export const RunListSchema = z.looseObject({ schemaVersion: z.literal(1), version: z.string(), total: z.number().int().nonnegative(), runs: z.array(ReportRunSchema) });
+/** `GET /api/reports/runs/detail`: one run and its last result for every test, environment and producer it recorded. */
+export const RunDetailSchema = z.looseObject({
+    schemaVersion: z.literal(1),
+    version: z.string(),
+    run: ReportRunSchema,
+    results: z.array(z.looseObject({
+        key: z.string(), id: z.string(), title: z.string(), specPath: z.string().nullable(), environment: z.string().nullable(), producer: z.string(),
+        status: EvidenceStatusSchema, durationMs: z.number().nullable(), at: z.number(), layer: z.string(), detail: z.string()
+    }))
+});