@crvouga/atlas 0.13.0 → 0.15.0

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

@@ -88,6 +88,7 @@ export declare const EvidenceSummarySchema: z.ZodObject<{
     attempts: z.ZodNumber;
     links: z.ZodNumber;
     tags: z.ZodArray<z.ZodString>;
+    artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     labels: z.ZodRecord<z.ZodString, z.ZodString>;
     roles: z.ZodArray<z.ZodString>;
 }, z.core.$loose>;
@@ -107,6 +108,12 @@ export declare const LayerHeaderSchema: z.ZodObject<{
         unknown: "unknown";
         modified: "modified";
     }>>;
+    run: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        startedAtMs: z.ZodOptional<z.ZodNumber>;
+        endedAtMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
     recording: z.ZodNullable<z.ZodUnknown>;
     live: z.ZodBoolean;
     counts: z.ZodRecord<z.ZodEnum<{
@@ -123,6 +130,7 @@ export declare const LayerHeaderSchema: z.ZodObject<{
         attempts: z.ZodNumber;
         links: z.ZodNumber;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         roles: z.ZodArray<z.ZodString>;
     }, z.core.$loose>>;
@@ -156,6 +164,7 @@ export declare const LayerRowSchema: z.ZodObject<{
         attempts: z.ZodNumber;
         links: z.ZodNumber;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         roles: z.ZodArray<z.ZodString>;
     }, z.core.$loose>>;
@@ -191,6 +200,7 @@ export declare const LayerRowsSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
         }, z.core.$loose>>;
@@ -228,6 +238,7 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
         }, z.core.$loose>>;
@@ -248,6 +259,12 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
             unknown: "unknown";
             modified: "modified";
         }>>;
+        run: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            startedAtMs: z.ZodOptional<z.ZodNumber>;
+            endedAtMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
         recording: z.ZodNullable<z.ZodUnknown>;
         live: z.ZodBoolean;
         counts: z.ZodRecord<z.ZodEnum<{
@@ -264,6 +281,7 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
         }, z.core.$loose>>;
@@ -306,6 +324,7 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
             }, z.core.$loose>>;
@@ -326,6 +345,12 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                 unknown: "unknown";
                 modified: "modified";
             }>>;
+            run: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                startedAtMs: z.ZodOptional<z.ZodNumber>;
+                endedAtMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
             recording: z.ZodNullable<z.ZodUnknown>;
             live: z.ZodBoolean;
             counts: z.ZodRecord<z.ZodEnum<{
@@ -342,6 +367,7 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
             }, z.core.$loose>>;
@@ -405,6 +431,7 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
             }, z.core.$loose>>;
@@ -425,6 +452,12 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                 unknown: "unknown";
                 modified: "modified";
             }>>;
+            run: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                startedAtMs: z.ZodOptional<z.ZodNumber>;
+                endedAtMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
             recording: z.ZodNullable<z.ZodUnknown>;
             live: z.ZodBoolean;
             counts: z.ZodRecord<z.ZodEnum<{
@@ -441,6 +474,7 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
             }, z.core.$loose>>;
@@ -485,6 +519,12 @@ export declare const EvidencePageSchema: z.ZodObject<{
             unknown: "unknown";
             modified: "modified";
         }>>;
+        run: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            startedAtMs: z.ZodOptional<z.ZodNumber>;
+            endedAtMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
         recording: z.ZodNullable<z.ZodUnknown>;
         live: z.ZodBoolean;
         counts: z.ZodRecord<z.ZodEnum<{
@@ -501,6 +541,7 @@ export declare const EvidencePageSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
         }, z.core.$loose>>;
@@ -543,6 +584,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
                     offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -607,6 +649,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
                         offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -651,6 +694,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
                     offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -702,6 +746,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
                 offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -769,6 +814,55 @@ export declare const ChecksResultSchema: z.ZodObject<{
     id: z.ZodString;
     checks: z.ZodNumber;
 }, z.core.$loose>;
+/** Which attachment a reviewer's tags belong to: one attachment of one check of one archived layer. */
+export declare const ArtifactTargetSchema: z.ZodObject<{
+    layer: z.ZodString;
+    check: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+    artifact: z.ZodString;
+}, z.core.$loose>;
+/** The body of `POST /api/reports/artifact-tags`: tags to add to and to remove from one attachment. At least one tag overall. */
+export declare const ArtifactTagEditSchema: z.ZodObject<{
+    target: z.ZodObject<{
+        layer: z.ZodString;
+        check: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        artifact: z.ZodString;
+    }, z.core.$loose>;
+    add: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+/** One recorded edit of an attachment's reviewer tags. Entries are never changed or removed: they are the audit trail. */
+export declare const ArtifactTagEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    target: z.ZodObject<{
+        layer: z.ZodString;
+        check: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        artifact: z.ZodString;
+    }, z.core.$loose>;
+    add: z.ZodArray<z.ZodString>;
+    remove: z.ZodArray<z.ZodString>;
+    by: z.ZodString;
+    atMs: z.ZodNumber;
+}, z.core.$loose>;
+/** `GET /api/reports/artifact-tags`: every recorded edit, oldest first. Fold them with `foldArtifactTags`. */
+export declare const ArtifactTagsSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        target: z.ZodObject<{
+            layer: z.ZodString;
+            check: z.ZodString;
+            kind: z.ZodOptional<z.ZodString>;
+            artifact: z.ZodString;
+        }, z.core.$loose>;
+        add: z.ZodArray<z.ZodString>;
+        remove: z.ZodArray<z.ZodString>;
+        by: z.ZodString;
+        atMs: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
 /** The data of the `hello` event: sent first on `/api/events`. */
 export declare const HelloEventSchema: z.ZodObject<{
     version: z.ZodString;
@@ -826,6 +920,7 @@ export declare const TestResultEntrySchema: z.ZodObject<{
         attempts: z.ZodNumber;
         links: z.ZodNumber;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         roles: z.ZodArray<z.ZodString>;
     }, z.core.$loose>>;
@@ -877,6 +972,7 @@ export declare const TestSummarySchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
         }, z.core.$loose>>;
@@ -907,6 +1003,8 @@ export declare const TestSummarySchema: z.ZodObject<{
         branches: z.ZodArray<z.ZodString>;
     }, z.core.$loose>;
     tags: z.ZodArray<z.ZodString>;
+    artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    inheritedArtifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     labels: z.ZodRecord<z.ZodString, z.ZodString>;
     evidence: z.ZodObject<{
         attachments: z.ZodNumber;
@@ -1054,6 +1152,10 @@ export declare const TestCatalogSchema: z.ZodObject<{
             value: z.ZodString;
             count: z.ZodNumber;
         }, z.core.$loose>>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>>;
         branches: z.ZodArray<z.ZodObject<{
             value: z.ZodString;
             count: z.ZodNumber;
@@ -1112,6 +1214,7 @@ export declare const TestCatalogSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
             }, z.core.$loose>>;
@@ -1142,6 +1245,8 @@ export declare const TestCatalogSchema: z.ZodObject<{
             branches: z.ZodArray<z.ZodString>;
         }, z.core.$loose>;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inheritedArtifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         evidence: z.ZodObject<{
             attachments: z.ZodNumber;
@@ -1282,6 +1387,7 @@ export declare const TestHistorySchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
             }, z.core.$loose>>;
@@ -1312,6 +1418,8 @@ export declare const TestHistorySchema: z.ZodObject<{
             branches: z.ZodArray<z.ZodString>;
         }, z.core.$loose>;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inheritedArtifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         evidence: z.ZodObject<{
             attachments: z.ZodNumber;
@@ -1349,14 +1457,21 @@ export declare const TestHistorySchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<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. */
+/** A run: the layers that name the same execution (else share a run URL, else a branch and commit), with what they recorded. */
 export declare const ReportRunSchema: z.ZodObject<{
     key: z.ZodString;
+    runId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        modified: "modified";
+    }>>;
     runUrl: z.ZodNullable<z.ZodString>;
     branch: z.ZodNullable<z.ZodString>;
     sha: z.ZodNullable<z.ZodString>;
@@ -1388,6 +1503,12 @@ export declare const RunListSchema: z.ZodObject<{
     total: z.ZodNumber;
     runs: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        freshness: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            modified: "modified";
+        }>>;
         runUrl: z.ZodNullable<z.ZodString>;
         branch: z.ZodNullable<z.ZodString>;
         sha: z.ZodNullable<z.ZodString>;
@@ -1419,6 +1540,12 @@ export declare const RunDetailSchema: z.ZodObject<{
     version: z.ZodString;
     run: z.ZodObject<{
         key: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        freshness: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            modified: "modified";
+        }>>;
         runUrl: z.ZodNullable<z.ZodString>;
         branch: z.ZodNullable<z.ZodString>;
         sha: z.ZodNullable<z.ZodString>;

package/dist/schema/src/api.js

@@ -14,7 +14,7 @@
  * @see docs/server.md
  */
 import { z } from 'zod/v4';
-import { CheckSchema } from './layer.js';
+import { CheckSchema, LayerRunSchema } from './layer.js';
 /** One of the statuses a check has in a report: `passed`, `failed`, `running` (not finished) or `not-run`. Closed. */
 export const EvidenceStatusSchema = z.enum(['passed', 'failed', 'running', 'not-run']);
 /**
@@ -70,6 +70,7 @@ export const EvidenceSummarySchema = z.looseObject({
     attempts: z.number().int().nonnegative(),
     links: z.number().int().nonnegative(),
     tags: z.array(z.string()),
+    artifactTags: z.array(z.string()).optional().describe('Normalized tags of the attachments themselves, sorted and distinct. Absent when no attachment is tagged; never inherited from a check or run'),
     labels: z.record(z.string(), z.string()),
     roles: z.array(z.string())
 });
@@ -86,6 +87,7 @@ export const LayerHeaderSchema = z.looseObject({
     runUrl: z.string().nullable(),
     parameters: z.record(z.string(), z.string()).describe('Other choices that make a result its own slot'),
     freshness: z.enum(['unknown', 'modified']).optional().describe('`modified`: recorded from a checkout with uncommitted changes. `unknown`: origin not captured. Absent: clean'),
+    run: LayerRunSchema.optional().describe('The execution the producer named for it (one local or manual invocation). Grouping and display only; never part of the slot'),
     recording: z.unknown().nullable().describe('Where recorded timelines are read from, or null'),
     live: z.boolean(),
     counts: z.record(EvidenceStatusSchema, z.number().int().nonnegative()),
@@ -185,6 +187,33 @@ export const ChecksResultSchema = z.looseObject({
     id: z.string().describe('The layer id'),
     checks: z.number().int().nonnegative()
 });
+/** Which attachment a reviewer's tags belong to: one attachment of one check of one archived layer. */
+export const ArtifactTargetSchema = z.looseObject({
+    layer: z.string().regex(/^[0-9a-f]{64}$/).describe('The id of the archived layer that holds the check'),
+    check: z.string().min(1).describe('The check\'s id'),
+    kind: z.string().min(1).optional().describe('The kind of the part holding the check, when the same id exists in several parts'),
+    artifact: z.string().min(1).max(1024).describe('The attachment: `id:<id>` when it has an id, else `key:<bundleKey>`, else `name:<name>` (see `artifactRef`)')
+});
+/** The body of `POST /api/reports/artifact-tags`: tags to add to and to remove from one attachment. At least one tag overall. */
+export const ArtifactTagEditSchema = z.looseObject({
+    target: ArtifactTargetSchema,
+    add: z.array(z.string()).max(20).optional().describe('Tags to add. `demo` and `#demo` are the same tag'),
+    remove: z.array(z.string()).max(20).optional().describe('Reviewer tags to remove. Tags the producer wrote are part of the immutable layer and stay')
+});
+/** One recorded edit of an attachment's reviewer tags. Entries are never changed or removed: they are the audit trail. */
+export const ArtifactTagEntrySchema = z.looseObject({
+    id: z.string().describe('Unique and time-ordered'),
+    target: ArtifactTargetSchema,
+    add: z.array(z.string()).describe('Normalized tags added'),
+    remove: z.array(z.string()).describe('Normalized tags removed'),
+    by: z.string().describe('The name of the token that made the edit (never the token)'),
+    atMs: z.number().describe('When the server recorded it, epoch milliseconds')
+});
+/** `GET /api/reports/artifact-tags`: every recorded edit, oldest first. Fold them with `foldArtifactTags`. */
+export const ArtifactTagsSchema = z.looseObject({
+    schemaVersion: z.literal(1),
+    entries: z.array(ArtifactTagEntrySchema)
+});
 /** The data of the `hello` event: sent first on `/api/events`. */
 export const HelloEventSchema = z.looseObject({ version: z.string(), ready: z.boolean(), time: z.number(), heartbeatMs: z.number().positive().optional() });
 /** The data of the `report` event: layers arrived. Enough to say who sent what, without asking. */
@@ -242,6 +271,8 @@ export const TestSummarySchema = z.looseObject({
         runs: z.number().int().nonnegative(), branches: z.array(z.string())
     }),
     tags: z.array(z.string()),
+    artifactTags: z.array(z.string()).optional().describe('Normalized tags of the attachments of its current results, such as `demo` (shown `#demo`). Not inherited from a check or run, unlike `tags`'),
+    inheritedArtifactTags: z.array(z.string()).optional().describe('Normalized tags its attachments inherit from their check and run, apart from `artifactTags`: what `?artifactTag=…&inherited=1` also matches'),
     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(),
@@ -268,7 +299,7 @@ export const TestCatalogSchema = z.looseObject({
     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))
+        tags: z.array(FacetValueSchema), artifactTags: z.array(FacetValueSchema).optional(), 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(),
@@ -332,9 +363,12 @@ export const TestHistorySchema = z.looseObject({
     test: TestSummarySchema,
     history: z.array(TestResultEntrySchema)
 });
-/** A run: the layers that share a run URL (else a branch and commit), with what they recorded. */
+/** A run: the layers that name the same execution (else 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=`'),
+    key: z.string().describe('`run:<id>` for an execution a producer named, else the run URL, else `branch@sha`. Pass it to `/api/reports/runs/detail?key=` or `/api/reports/tests?run=`'),
+    runId: z.string().optional().describe('The execution id the producer named, when it did. Layers that share it are one run however many uploads they took'),
+    title: z.string().optional().describe('The human title of the execution (the newest layer\'s). Presentation only: the key, commit and `freshness` are unaffected'),
+    freshness: z.enum(['unknown', 'modified']).optional().describe('`modified` when any layer of the run was recorded from a checkout with uncommitted changes; `unknown` when an origin was not captured; absent when all are clean. Shown beside the commit, never replaced by the title'),
     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()),