@crvouga/atlas 1.17.0 → 1.18.0

package/packages/server/openapi.json

@@ -5856,6 +5856,15 @@
               "type": "string"
             }
           },
+          {
+            "required": false,
+            "name": "recordings",
+            "in": "query",
+            "description": "Recording completeness of the run, apart from its outcome: `complete`, `incomplete`, `none-expected` or `unknown` (a run whose layers declared no recording expectations is `unknown`, never `complete`). Repeatable or comma-separated. Answered from the layers' receipts; no recording is read. A server that does not know it ignores it and does not name it in `filters`.",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "required": false,
             "name": "q",
@@ -6076,6 +6085,15 @@
               "type": "string"
             }
           },
+          {
+            "required": false,
+            "name": "recordings",
+            "in": "query",
+            "description": "Recording completeness of the run, apart from its outcome: `complete`, `incomplete`, `none-expected` or `unknown` (a run whose layers declared no recording expectations is `unknown`, never `complete`). Repeatable or comma-separated. Answered from the layers' receipts; no recording is read. A server that does not know it ignores it and does not name it in `filters`.",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "required": false,
             "name": "q",
@@ -10730,6 +10748,10 @@
                                   "type": "boolean",
                                   "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                                 },
+                                "reason": {
+                                  "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                  "type": "string"
+                                },
                                 "scope": {
                                   "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                                   "type": "object",
@@ -11209,6 +11231,10 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
                               "scope": {
                                 "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                                 "type": "object",
@@ -11723,6 +11749,10 @@
                                   "type": "boolean",
                                   "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                                 },
+                                "reason": {
+                                  "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                  "type": "string"
+                                },
                                 "scope": {
                                   "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                                   "type": "object",
@@ -12202,6 +12232,10 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
                               "scope": {
                                 "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                                 "type": "object",
@@ -15610,6 +15644,10 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
                           "scope": {
                             "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                             "type": "object",
@@ -16104,6 +16142,10 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
                           "scope": {
                             "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                             "type": "object",
@@ -18714,6 +18756,10 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
                           "scope": {
                             "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                             "type": "object",
@@ -19196,6 +19242,10 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
                               "scope": {
                                 "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                                 "type": "object",
@@ -19838,6 +19888,10 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
                           "scope": {
                             "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                             "type": "object",
@@ -21093,6 +21147,10 @@
                                   "type": "boolean",
                                   "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                                 },
+                                "reason": {
+                                  "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                  "type": "string"
+                                },
                                 "scope": {
                                   "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                                   "type": "object",
@@ -22284,6 +22342,10 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
                               "scope": {
                                 "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                                 "type": "object",
@@ -22955,6 +23017,10 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
                           "scope": {
                             "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                             "type": "object",
@@ -23984,6 +24050,12 @@
                       "minimum": 0,
                       "maximum": 9007199254740991,
                       "description": "References that name no bytes, or bytes the layer does not hold"
+                    },
+                    "missing": {
+                      "description": "Of `unavailable`, those that name a file the layer's bundle does not hold (stored, then gone). Absent when there are none",
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
                     }
                   },
                   "required": [
@@ -23993,6 +24065,64 @@
                   ],
                   "additionalProperties": {}
                 },
+                "recordings": {
+                  "description": "Whether the recordings its layers expected were published, apart from its outcomes. Absent when no layer declared an expectation: its completeness is unknown, never complete. Matched by the `recordings` filter",
+                  "type": "object",
+                  "properties": {
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "complete",
+                        "incomplete",
+                        "none-expected",
+                        "unknown"
+                      ],
+                      "description": "`incomplete` when an expected recording was skipped or unresolved; else `unknown` when a layer declared no expectations; else `complete` when something was expected and `none-expected` when nothing was"
+                    },
+                    "expected": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "published": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991,
+                      "description": "Of the expected recordings, uploaded or referenced by address"
+                    },
+                    "skipped": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "unresolved": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "notApplicable": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "layersWithoutReceipt": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991,
+                      "description": "Layers of the run that declared no recording expectations: nothing is claimed for them"
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "expected",
+                    "published",
+                    "skipped",
+                    "unresolved",
+                    "notApplicable",
+                    "layersWithoutReceipt"
+                  ],
+                  "additionalProperties": {}
+                },
                 "attachments": {
                   "description": "Files attached to the run itself, in its layers, not to a check. Absent when there are none",
                   "type": "integer",
@@ -24233,6 +24363,28 @@
                   ],
                   "additionalProperties": {}
                 }
+              },
+              "recordings": {
+                "description": "Only for runs: `complete`, `incomplete`, `none-expected` and `unknown` with how many runs have each. Absent on servers that predate the filter",
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "value": {
+                      "type": "string"
+                    },
+                    "count": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "required": [
+                    "value",
+                    "count"
+                  ],
+                  "additionalProperties": {}
+                }
               }
             },
             "required": [
@@ -24444,6 +24596,10 @@
                         "type": "boolean",
                         "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                       },
+                      "reason": {
+                        "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                        "type": "string"
+                      },
                       "scope": {
                         "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                         "type": "object",
@@ -24769,6 +24925,28 @@
                   ],
                   "additionalProperties": {}
                 }
+              },
+              "recordings": {
+                "description": "Only for runs: `complete`, `incomplete`, `none-expected` and `unknown` with how many runs have each. Absent on servers that predate the filter",
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "value": {
+                      "type": "string"
+                    },
+                    "count": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "required": [
+                    "value",
+                    "count"
+                  ],
+                  "additionalProperties": {}
+                }
               }
             },
             "required": [
@@ -25736,6 +25914,12 @@
                     "minimum": 0,
                     "maximum": 9007199254740991,
                     "description": "References that name no bytes, or bytes the layer does not hold"
+                  },
+                  "missing": {
+                    "description": "Of `unavailable`, those that name a file the layer's bundle does not hold (stored, then gone). Absent when there are none",
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991
                   }
                 },
                 "required": [
@@ -25745,6 +25929,64 @@
                 ],
                 "additionalProperties": {}
               },
+              "recordings": {
+                "description": "Whether the recordings its layers expected were published, apart from its outcomes. Absent when no layer declared an expectation: its completeness is unknown, never complete. Matched by the `recordings` filter",
+                "type": "object",
+                "properties": {
+                  "state": {
+                    "type": "string",
+                    "enum": [
+                      "complete",
+                      "incomplete",
+                      "none-expected",
+                      "unknown"
+                    ],
+                    "description": "`incomplete` when an expected recording was skipped or unresolved; else `unknown` when a layer declared no expectations; else `complete` when something was expected and `none-expected` when nothing was"
+                  },
+                  "expected": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "published": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "Of the expected recordings, uploaded or referenced by address"
+                  },
+                  "skipped": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "unresolved": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "notApplicable": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "layersWithoutReceipt": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "Layers of the run that declared no recording expectations: nothing is claimed for them"
+                  }
+                },
+                "required": [
+                  "state",
+                  "expected",
+                  "published",
+                  "skipped",
+                  "unresolved",
+                  "notApplicable",
+                  "layersWithoutReceipt"
+                ],
+                "additionalProperties": {}
+              },
               "attachments": {
                 "description": "Files attached to the run itself, in its layers, not to a check. Absent when there are none",
                 "type": "integer",
@@ -25890,6 +26132,10 @@
                         "type": "boolean",
                         "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                       },
+                      "reason": {
+                        "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                        "type": "string"
+                      },
                       "scope": {
                         "description": "What this recording shows as its producer declared it: its own `scope`, else its attempt's, check's, part's or layer's. Absent: the scope is unknown, never live, physical or audible",
                         "type": "object",
@@ -26091,6 +26337,12 @@
                       "minimum": 0,
                       "maximum": 9007199254740991,
                       "description": "References that name no bytes, or bytes the layer does not hold"
+                    },
+                    "missing": {
+                      "description": "Of `unavailable`, those that name a file the layer's bundle does not hold (stored, then gone). Absent when there are none",
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
                     }
                   },
                   "required": [

package/packages/visualizer/src/explorer/ArtifactsView.tsx

@@ -26,7 +26,7 @@ import { entriesFromArtifacts } from './playlist-entries';
 import { WatchPlaylist } from './playlist';
 import { RecordingTextSearch } from './RecordingTextSearch';
 import { filtered, filterOf, NO_FILTERS } from './search';
-import { filterParams } from '@crvouga/atlas/reports/artifact-query';
+import { filterParams, forArtifacts } from '@crvouga/atlas/reports/artifact-query';
 
 const ARTIFACT_ROWS = 50;
 
@@ -34,7 +34,8 @@ const ARTIFACT_ROWS = 50;
 export function ArtifactsView() {
   const search = useExplorerSearch();
   const go = useExplorerNavigate();
-  const filter = useMemo(() => filterOf(search), [search]);
+  // Recording completeness belongs to a run, not to a recorded result: the Artifacts tab never asks for it.
+  const filter = useMemo(() => forArtifacts(filterOf(search)), [search]);
   const narrow = filtered(search);
   const answer = useArtifactList(filter);
   const now = useNow();

package/packages/visualizer/src/explorer/RunsView.tsx

@@ -93,15 +93,39 @@ function ownerText(video: VideoRef): string {
   return 'the test';
 }
 const UNAVAILABLE = 'Listed in the report, but its file was never stored, so it cannot be played.';
-/** The unavailable references of a video summary and why they cannot be watched. */
+const MISSING = 'The run says it stored this file, but its bundle no longer holds it, so it cannot be played.';
+/** The unavailable references of a video summary and why they cannot be watched: never stored, or stored and then gone. */
 function Unavailable({ videos }: { videos: VideoCounts }) {
   if (!videos.unavailable) return null;
+  const missing = Math.min(videos.missing ?? 0, videos.unavailable);
   return (
     <Text component="div" size="xs" c="dimmed" data-video-unavailable>
-      <IconAlertTriangle size={16} aria-hidden="true" /> {plural(videos.unavailable, 'video', 'videos')} unavailable. {UNAVAILABLE}
+      <IconAlertTriangle size={16} aria-hidden="true" /> {plural(videos.unavailable, 'video', 'videos')} unavailable.{' '}
+      {missing > 0 && <Text span inherit data-video-missing>{missing === videos.unavailable ? MISSING : `${plural(missing, 'video', 'videos')}: ${MISSING}`}{' '}</Text>}
+      {missing < videos.unavailable && UNAVAILABLE}
     </Text>
   );
 }
+/** Words for a run's recording completeness, apart from how its tests went. */
+const COMPLETENESS_WORDS: Record<string, string> = { complete: 'complete', incomplete: 'incomplete', 'none-expected': 'none expected', unknown: 'unknown' };
+/** A run's recording completeness in its row: how many expected recordings were published, said in words and independent of its outcomes. Nothing when its layers declared no expectations (unknown is not shown as complete). */
+function RunRecordings({ run }: { run: RunSummary }) {
+  const recordings = run.recordings;
+  if (!recordings) return null;
+  const word = COMPLETENESS_WORDS[recordings.state] ?? 'unknown';
+  const text = recordings.expected > 0 ? `Recordings ${recordings.published} of ${recordings.expected}: ${word}` : `Recordings: ${word}`;
+  return (
+    <Badge
+      size="sm"
+      variant="light"
+      color={recordings.state === 'incomplete' ? 'orange' : 'gray'}
+      data-recordings={recordings.state}
+      title={recordings.state === 'incomplete' ? 'Some expected recordings were not published. The test outcomes are unaffected.' : undefined}
+    >
+      {text}
+    </Badge>
+  );
+}
 /** A run's videos in its row: a link to the recordings, how many references they come from, and what cannot be played. */
 function RunVideos({ run }: { run: RunSummary }) {
   const videos = run.videos;
@@ -210,7 +234,7 @@ const RUN_SORTS = [
   { id: 'relevance', label: 'Best match' }
 ] as const;
 /** What a filter is called when a page says a server could not apply it. */
-const FILTER_WORDS: Partial<Record<FilterName, string>> = { artifactTag: 'tag', type: 'media type', label: 'label', domain: 'domain', spec: 'spec' };
+const FILTER_WORDS: Partial<Record<FilterName, string>> = { artifactTag: 'tag', type: 'media type', label: 'label', domain: 'domain', spec: 'spec', recordings: 'recording completeness' };
 /** Says which filters the list is not narrowed by, because the server that answered ignored them. */
 export function NotApplied({ names, noun }: { names: readonly FilterName[]; noun: string }) {
   if (!names.length) return null;
@@ -383,6 +407,7 @@ function RunTable() {
                 <Table.Td>{formatMs(run.spanMs)}</Table.Td>
                 <Table.Td>
                   <RunVideos run={run} />
+                  <RunRecordings run={run} />
                 </Table.Td>
                 <Table.Td data-tags>{run.artifactTags?.map((tag) => `#${tag}`).join(' ') || '—'}</Table.Td>
                 <Table.Td>

package/packages/visualizer/src/explorer/filters.tsx

@@ -2,7 +2,7 @@
  * @module Run and artifact filters
  *
  * The filter bar of the Runs and Artifacts tabs: words, artifact tag, media type, label, environment, branch, outcome,
- * feature domain and a time range, each offering the values the report has with counts in the scope of the list. What is
+ * feature domain and a time range (and, for runs, the completeness of their recordings, apart from their outcome), each offering the values the report has with counts in the scope of the list. What is
  * chosen shows as removable chips and is the address, so copying it or reloading restores the same view; named views keep
  * a query to open again. Choices combine with AND across the controls and OR within one.
  */
@@ -18,7 +18,7 @@ import { patched, useExplorerNavigate } from './navigate';
 import { filtered, joined, NO_FILTERS, toggled, values, type ExplorerSearch } from './search';
 import { filtersOf, isView, readViews, writeViews, type SavedView } from './views';
 
-type Param = 'artifactTag' | 'type' | 'label' | 'env' | 'branch' | 'outcome' | 'domain' | 'producer';
+type Param = 'artifactTag' | 'type' | 'label' | 'env' | 'branch' | 'outcome' | 'recordings' | 'domain' | 'producer';
 
 const NOUN: Record<Param, string> = {
   artifactTag: 'Tag',
@@ -27,13 +27,18 @@ const NOUN: Record<Param, string> = {
   env: 'Environment',
   branch: 'Branch',
   outcome: 'Outcome',
+  recordings: 'Recordings',
   domain: 'Domain',
   producer: 'Producer'
 };
 
+/** How the completeness of a run's recordings reads. */
+const COMPLETENESS: Record<string, string> = { complete: 'Complete', incomplete: 'Incomplete', 'none-expected': 'None expected', unknown: 'Unknown' };
+
 /** How a chosen value reads: tags with their hash, environments by name. */
 function shown(param: Param, value: string): string {
   if (param === 'artifactTag') return `#${value}`;
+  if (param === 'recordings') return COMPLETENESS[value] ?? value;
   if (param === 'env') return environmentLabel(value);
   if (param === 'domain' && value === '(no spec)') return 'No spec';
   return value;
@@ -178,7 +183,7 @@ export function FilterBar({
   const [draft, setDraft] = useState(search.q ?? '');
   // The address may change from elsewhere (a link, a saved view, back): follow it.
   useEffect(() => setDraft((current) => (current.trim() === (search.q ?? '').trim() ? current : (search.q ?? ''))), [search.q]);
-  const params: Param[] = ['artifactTag', 'type', 'label', 'env', 'branch', 'outcome', ...(tab === 'artifacts' ? (['domain'] as const) : []), 'producer'];
+  const params: Param[] = ['artifactTag', 'type', 'label', 'env', 'branch', 'outcome', ...(tab === 'runs' ? (['recordings'] as const) : []), ...(tab === 'artifacts' ? (['domain'] as const) : []), 'producer'];
   const chips = [
     ...params.flatMap((param) =>
       values(search[param]).map((value) => ({ label: `${NOUN[param]}: ${shown(param, value)}`, clear: { [param]: toggled(search[param], value) } as never }))
@@ -233,6 +238,9 @@ export function FilterBar({
           <Facet param="env" facets={facets.environments} search={search} />
           <Facet param="branch" facets={facets.branches} search={search} />
           <Facet param="outcome" facets={facets.outcomes} search={search} />
+          {tab === 'runs' && (facets.recordings || values(search.recordings).length > 0) && (
+            <Facet param="recordings" facets={facets.recordings ?? []} search={search} />
+          )}
           {tab === 'artifacts' && facets.domains && <Facet param="domain" facets={facets.domains} search={search} />}
           {facets.producers.length > 1 && <Facet param="producer" facets={facets.producers} search={search} />}
           <TextInput type="date" label="From" value={search.since ?? ''} onChange={(event) => go({ since: event.target.value || undefined })} />

package/packages/visualizer/src/explorer/search.ts

@@ -7,7 +7,7 @@
  * or `\\`, and the router encodes `#` and spaces. Anything unreadable is dropped, never an error.
  *
  * The Runs and Artifacts tabs share the tests' `q`, `env`, `producer`, `domain` and `spec` and add `artifactTag`,
- * `type`, `label`, `branch`, `outcome`, `since` and `until`, so a link to one tab's filters opens the same query on another.
+ * `type`, `label`, `branch`, `outcome`, `since` and `until` (and the Runs tab alone `recordings`, the completeness of its recordings), so a link to one tab's filters opens the same query on another.
  */
 import { joinList, splitList, type ArtifactFilter } from '@crvouga/atlas/reports/artifact-query';
 import type { ReliabilityScope } from '@crvouga/atlas/reports/reliability';
@@ -55,6 +55,8 @@ export const ExplorerSearchFields = {
   branch: text,
   /** Outcomes of a run or recorded result (`passed`, `failed`…). */
   outcome: text,
+  /** Recording completeness of a run (`complete`, `incomplete`, `none-expected`, `unknown`): runs only, apart from the outcome. */
+  recordings: text,
   /** Only records from this day (`YYYY-MM-DD`, the viewer's local time). */
   since: text,
   /** Only records until the end of this day (`YYYY-MM-DD`, local time). */
@@ -130,6 +132,7 @@ export type ExplorerSearch = {
   readonly label?: string;
   readonly branch?: string;
   readonly outcome?: string;
+  readonly recordings?: string;
   readonly since?: string;
   readonly until?: string;
   readonly inRun?: string;
@@ -229,7 +232,7 @@ export function reliabilityScopeOf(search: ExplorerSearch): ReliabilityScope {
 }
 
 /** The filters of the Runs and Artifacts tabs, in the address. */
-export const FILTER_FIELDS = ['q', 'artifactTag', 'inherited', 'type', 'label', 'env', 'producer', 'branch', 'outcome', 'domain', 'spec', 'since', 'until', 'video'] as const;
+export const FILTER_FIELDS = ['q', 'artifactTag', 'inherited', 'type', 'label', 'env', 'producer', 'branch', 'outcome', 'recordings', 'domain', 'spec', 'since', 'until', 'video'] as const;
 
 /** A patch that removes every filter of the Runs and Artifacts tabs. */
 export const NO_FILTERS = Object.fromEntries(FILTER_FIELDS.map((field) => [field, undefined])) as { [K in (typeof FILTER_FIELDS)[number]]?: undefined };
@@ -263,6 +266,7 @@ export function filterOf(search: ExplorerSearch): ArtifactFilter {
     producer: list(search.producer),
     branch: list(search.branch),
     outcome: list(search.outcome),
+    recordings: list(search.recordings),
     domain: list(search.domain),
     spec: list(search.spec),
     since,