@crvouga/atlas 1.2.0 → 1.4.0

package/dist/reports/src/reports-route.d.ts

@@ -105,6 +105,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                 } | null;
                 parts: readonly {
                     tags?: string[] | undefined;
+                    scope?: {
+                        [x: string]: import("hono/utils/types").JSONValue;
+                        surface?: string | undefined;
+                        deviceKind?: string | undefined;
+                        syntheticData?: boolean | undefined;
+                        dependencies?: string | undefined;
+                        audioCaptured?: boolean | undefined;
+                        pacing?: string | undefined;
+                        asserted?: string[] | undefined;
+                        limitations?: string[] | undefined;
+                        declaredBy?: string | undefined;
+                        verified?: string[] | undefined;
+                        verifiedBy?: string | undefined;
+                        provenance?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            url: string;
+                            name?: string | undefined;
+                            rel?: string | undefined;
+                        }[] | undefined;
+                        extensions?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                        } | undefined;
+                    } | undefined;
                     attachments?: {
                         [x: string]: import("hono/utils/types").JSONValue;
                         name: string;
@@ -121,6 +144,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                         durationMs?: number | undefined;
                         description?: string | undefined;
                         omitted?: string | undefined;
+                        scope?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            surface?: string | undefined;
+                            deviceKind?: string | undefined;
+                            syntheticData?: boolean | undefined;
+                            dependencies?: string | undefined;
+                            audioCaptured?: boolean | undefined;
+                            pacing?: string | undefined;
+                            asserted?: string[] | undefined;
+                            limitations?: string[] | undefined;
+                            declaredBy?: string | undefined;
+                            verified?: string[] | undefined;
+                            verifiedBy?: string | undefined;
+                            provenance?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                url: string;
+                                name?: string | undefined;
+                                rel?: string | undefined;
+                            }[] | undefined;
+                            extensions?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                            } | undefined;
+                        } | undefined;
                         tags?: string[] | undefined;
                         at?: {
                             [x: string]: import("hono/utils/types").JSONValue;
@@ -140,6 +186,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                         durationMs?: number | undefined;
                         startedAtMs?: number | undefined;
                         detail?: string | undefined;
+                        scope?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            surface?: string | undefined;
+                            deviceKind?: string | undefined;
+                            syntheticData?: boolean | undefined;
+                            dependencies?: string | undefined;
+                            audioCaptured?: boolean | undefined;
+                            pacing?: string | undefined;
+                            asserted?: string[] | undefined;
+                            limitations?: string[] | undefined;
+                            declaredBy?: string | undefined;
+                            verified?: string[] | undefined;
+                            verifiedBy?: string | undefined;
+                            provenance?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                url: string;
+                                name?: string | undefined;
+                                rel?: string | undefined;
+                            }[] | undefined;
+                            extensions?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                            } | undefined;
+                        } | undefined;
                         steps?: {
                             [x: string]: import("hono/utils/types").JSONValue;
                             name: string;
@@ -166,6 +235,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                 durationMs?: number | undefined;
                                 description?: string | undefined;
                                 omitted?: string | undefined;
+                                scope?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    surface?: string | undefined;
+                                    deviceKind?: string | undefined;
+                                    syntheticData?: boolean | undefined;
+                                    dependencies?: string | undefined;
+                                    audioCaptured?: boolean | undefined;
+                                    pacing?: string | undefined;
+                                    asserted?: string[] | undefined;
+                                    limitations?: string[] | undefined;
+                                    declaredBy?: string | undefined;
+                                    verified?: string[] | undefined;
+                                    verifiedBy?: string | undefined;
+                                    provenance?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        url: string;
+                                        name?: string | undefined;
+                                        rel?: string | undefined;
+                                    }[] | undefined;
+                                    extensions?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                    } | undefined;
+                                } | undefined;
                                 tags?: string[] | undefined;
                                 at?: {
                                     [x: string]: import("hono/utils/types").JSONValue;
@@ -224,6 +316,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             description?: string | undefined;
                             omitted?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             tags?: string[] | undefined;
                             at?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
@@ -292,6 +407,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             description?: string | undefined;
                             omitted?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             tags?: string[] | undefined;
                             at?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
@@ -383,6 +521,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                     readonly recordedAtMs: number;
                     readonly checks: readonly {
                         tags?: string[] | undefined;
+                        scope?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            surface?: string | undefined;
+                            deviceKind?: string | undefined;
+                            syntheticData?: boolean | undefined;
+                            dependencies?: string | undefined;
+                            audioCaptured?: boolean | undefined;
+                            pacing?: string | undefined;
+                            asserted?: string[] | undefined;
+                            limitations?: string[] | undefined;
+                            declaredBy?: string | undefined;
+                            verified?: string[] | undefined;
+                            verifiedBy?: string | undefined;
+                            provenance?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                url: string;
+                                name?: string | undefined;
+                                rel?: string | undefined;
+                            }[] | undefined;
+                            extensions?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                            } | undefined;
+                        } | undefined;
                         attachments?: {
                             [x: string]: import("hono/utils/types").JSONValue;
                             name: string;
@@ -399,6 +560,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             description?: string | undefined;
                             omitted?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             tags?: string[] | undefined;
                             at?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
@@ -418,6 +602,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             startedAtMs?: number | undefined;
                             detail?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             steps?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
                                 name: string;
@@ -444,6 +651,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                     durationMs?: number | undefined;
                                     description?: string | undefined;
                                     omitted?: string | undefined;
+                                    scope?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        surface?: string | undefined;
+                                        deviceKind?: string | undefined;
+                                        syntheticData?: boolean | undefined;
+                                        dependencies?: string | undefined;
+                                        audioCaptured?: boolean | undefined;
+                                        pacing?: string | undefined;
+                                        asserted?: string[] | undefined;
+                                        limitations?: string[] | undefined;
+                                        declaredBy?: string | undefined;
+                                        verified?: string[] | undefined;
+                                        verifiedBy?: string | undefined;
+                                        provenance?: {
+                                            [x: string]: import("hono/utils/types").JSONValue;
+                                            url: string;
+                                            name?: string | undefined;
+                                            rel?: string | undefined;
+                                        }[] | undefined;
+                                        extensions?: {
+                                            [x: string]: import("hono/utils/types").JSONValue;
+                                        } | undefined;
+                                    } | undefined;
                                     tags?: string[] | undefined;
                                     at?: {
                                         [x: string]: import("hono/utils/types").JSONValue;
@@ -502,6 +732,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                 durationMs?: number | undefined;
                                 description?: string | undefined;
                                 omitted?: string | undefined;
+                                scope?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    surface?: string | undefined;
+                                    deviceKind?: string | undefined;
+                                    syntheticData?: boolean | undefined;
+                                    dependencies?: string | undefined;
+                                    audioCaptured?: boolean | undefined;
+                                    pacing?: string | undefined;
+                                    asserted?: string[] | undefined;
+                                    limitations?: string[] | undefined;
+                                    declaredBy?: string | undefined;
+                                    verified?: string[] | undefined;
+                                    verifiedBy?: string | undefined;
+                                    provenance?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        url: string;
+                                        name?: string | undefined;
+                                        rel?: string | undefined;
+                                    }[] | undefined;
+                                    extensions?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                    } | undefined;
+                                } | undefined;
                                 tags?: string[] | undefined;
                                 at?: {
                                     [x: string]: import("hono/utils/types").JSONValue;
@@ -570,6 +823,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                 durationMs?: number | undefined;
                                 description?: string | undefined;
                                 omitted?: string | undefined;
+                                scope?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    surface?: string | undefined;
+                                    deviceKind?: string | undefined;
+                                    syntheticData?: boolean | undefined;
+                                    dependencies?: string | undefined;
+                                    audioCaptured?: boolean | undefined;
+                                    pacing?: string | undefined;
+                                    asserted?: string[] | undefined;
+                                    limitations?: string[] | undefined;
+                                    declaredBy?: string | undefined;
+                                    verified?: string[] | undefined;
+                                    verifiedBy?: string | undefined;
+                                    provenance?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        url: string;
+                                        name?: string | undefined;
+                                        rel?: string | undefined;
+                                    }[] | undefined;
+                                    extensions?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                    } | undefined;
+                                } | undefined;
                                 tags?: string[] | undefined;
                                 at?: {
                                     [x: string]: import("hono/utils/types").JSONValue;

package/dist/reports/src/test-catalog.d.ts

@@ -99,6 +99,8 @@ export type TestSummary = {
     readonly artifactTags?: readonly string[];
     /** The normalized tags its attachments inherit from their check and run (those of the results that have attachments), apart from `artifactTags`. What an inherited artifact query also matches. */
     readonly inheritedArtifactTags?: readonly string[];
+    /** What each distinct playable recording of its current results declares it shows, as filter tokens (`device:physical`, `audio:silent`; see `scopeTokens`). A recording that declared nothing is `['unknown']`. Absent when it has no playable recording. A query's `scope` must hold for one recording, so evidence from two different devices never combines. */
+    readonly scopeProfiles?: readonly (readonly string[])[];
     readonly labels: Readonly<Record<string, string>>;
     /** What its current results carry: attachments, steps, retries, and the kinds of attachment. */
     readonly evidence: {
@@ -172,6 +174,8 @@ export type CatalogFacets = {
     readonly tags: readonly FacetValue[];
     /** The tags of attachments, normalized. Absent in documents of older servers. */
     readonly artifactTags?: readonly FacetValue[];
+    /** The scope tokens of its recordings (`device:simulator`, `audio:recorded`, `unknown`), with how many tests have a recording that states each. Absent in documents of older servers. */
+    readonly scopes?: readonly FacetValue[];
     readonly branches: readonly FacetValue[];
     readonly labels: Readonly<Record<string, readonly FacetValue[]>>;
 };
@@ -195,6 +199,8 @@ export type TestQuery = {
     readonly artifactTag?: readonly string[];
     /** With `artifactTag`: also match the tags an attachment inherits from its check and run (a recording without a tag of its own under a run tagged `demo`). Default false: the exact query. */
     readonly inherited?: boolean;
+    /** Only tests with one playable recording that states every one of these (`device:physical`, `audio:recorded`, `data:synthetic`, `dependencies:live`, `surface:browser`, `pacing:paced`; see `scopeTokens`). Evidence that did not declare a value never matches it; `unknown` matches only a recording that declared no scope. */
+    readonly scope?: readonly string[];
     /** Only tests recorded in this run (a key from `runList`). */
     readonly run?: string;
     readonly sort?: TestSort;
@@ -264,6 +270,11 @@ export type RunSummary = {
      * and references that cannot be played. Absent when it has none, and in a report that carries no video information.
      */
     readonly videos?: VideoCounts;
+    /**
+     * Files attached to the run itself, in its layers (and their parts), not to any one check: review movies, archives,
+     * summaries. All kinds, videos included. Absent when none, and in a report that carries no such information.
+     */
+    readonly attachments?: number;
     /** The normalized tags of the attachments of its results and layers, sorted and distinct. Absent when none is tagged. */
     readonly artifactTags?: readonly string[];
     /** The tags of its checks and layers, which its attachments inherit (what `inherited=1` also matches), sorted and distinct. Absent when none. */
@@ -308,12 +319,33 @@ export type RunResult = {
     /** Every video its evidence references, with who holds it (check, retry attempt or step). Absent when there is none. */
     readonly videos?: readonly VideoRef[];
 };
+/**
+ * One layer of a run, as the run's artifact hub names it: who recorded it, how many checks it holds (zero is possible
+ * and is not a pass) and the files it carries as a whole. Read the files with `GET /evidence/detail/{backend}/{id}`.
+ */
+export type RunLayer = {
+    /** The layer's id: 64 hex digits for an archived layer. */
+    readonly id: string;
+    /** The backend it was read from, for `GET /evidence/detail/{backend}/{id}`. */
+    readonly backend: string;
+    readonly producer: string;
+    readonly environment: string | null;
+    readonly recordedAtMs: number;
+    /** How many checks the layer recorded. A layer of zero checks is evidence only: it is not a passing test. */
+    readonly checks: number;
+    /** Files the layer carries as a whole (not those of its checks). */
+    readonly attachments: number;
+    /** Its videos, when it has any. */
+    readonly videos?: VideoCounts;
+};
 /** `GET /api/reports/runs/detail`: one run and every result it recorded. */
 export type RunDetail = {
     readonly schemaVersion: typeof TEST_CATALOG_VERSION;
     readonly version: string;
     readonly run: RunSummary;
     readonly results: readonly RunResult[];
+    /** Every layer of the run, oldest first, so its run-level files can be found even in a layer with no checks. Absent from an older server. */
+    readonly layers?: readonly RunLayer[];
 };
 /**
  * One recorded result that carries evidence (an attachment: a recording, a screenshot, a trace), with where and when it
@@ -417,6 +449,7 @@ export declare class TestHistory {
     run(key: string): {
         readonly run: RunSummary;
         readonly results: RunResult[];
+        readonly layers: RunLayer[];
     } | null;
     /**
      * Every recorded result that carries an attachment, newest first, with the values a query looks at. Built once per
@@ -499,7 +532,7 @@ export declare function artifactList(history: TestHistory, version: string, quer
 }): ArtifactList;
 /** One run with every result it recorded, or null when no run has that key. */
 export declare function runDetail(history: TestHistory, version: string, key: string): RunDetail | null;
-/** Reads a `TestQuery` from URL search parameters: `q`, `sort`, `offset`, `limit`, `run`, and repeatable or comma-separated `status`, `environment`, `producer`, `domain`, `spec`, `tag`, `artifactTag`, and `inherited=1`. */
+/** Reads a `TestQuery` from URL search parameters: `q`, `sort`, `offset`, `limit`, `run`, and repeatable or comma-separated `status`, `environment`, `producer`, `domain`, `spec`, `tag`, `artifactTag`, `scope` (every token must hold for one recording), and `inherited=1`. */
 export declare function parseTestQuery(params: URLSearchParams): TestQuery;
 /** A duration for a person: `850 ms`, `12.3 s`, `4m 05s`. */
 export declare function formatMs(ms: number | null | undefined): string;

package/dist/reports/src/test-catalog.js

@@ -25,6 +25,7 @@
 import { displayTag, normalizeTag, normalizeTags } from './artifact-tags.js';
 import { facetsOf, forRuns, labelList, matchesFilter, outcomeOfCounts, splitList, usedFilters } from './artifact-query.js';
 import { videoCounts } from './evidence-detail.js';
+import { matchesScope, scopeTokens, UNKNOWN_SCOPE } from './evidence-scope.js';
 import { checkSlots } from './evidence-view.js';
 import { combineEvidence, emptyCounts, slotKey, specPath as normalSpecPath } from './layer-merge.js';
 import { RecordedSpecs } from './recorded-specs.js';
@@ -131,7 +132,7 @@ export class TestHistory {
         const key = runKey(layer);
         let run = this.#runs.get(key);
         if (!run) {
-            run = { key, runUrl: layer.runUrl, branch: layer.branch, sha: layer.sha, start: layer.recordedAtMs, end: layer.recordedAtMs, firstAt: layer.recordedAtMs, first: layer.id, producers: new Set(), environments: new Set(), layers: 0, runId: layer.run?.id, title: undefined, titledAt: 0, titledBy: '', freshness: undefined, videos: [], evidence: { tags: new Set(), artifactTags: new Set(), roles: new Set(), labels: new Set() } };
+            run = { key, runUrl: layer.runUrl, branch: layer.branch, sha: layer.sha, start: layer.recordedAtMs, end: layer.recordedAtMs, firstAt: layer.recordedAtMs, first: layer.id, producers: new Set(), environments: new Set(), layers: 0, runId: layer.run?.id, title: undefined, titledAt: 0, titledBy: '', freshness: undefined, videos: [], attachments: 0, members: [], evidence: { tags: new Set(), artifactTags: new Set(), roles: new Set(), labels: new Set() } };
             this.#runs.set(key, run);
         }
         // A run is told by its first layer (by time, then id), whatever order its layers arrive in.
@@ -160,6 +161,10 @@ export class TestHistory {
         run.layers += 1;
         if (layer.evidence?.videos)
             run.videos.push(...layer.evidence.videos);
+        const held = layer.evidence?.attachments ?? 0;
+        run.attachments += held;
+        const layerVideos = videoCounts(layer.evidence?.videos);
+        run.members.push({ id: layer.id, backend, producer: layer.producer, environment: layer.environment, recordedAtMs: layer.recordedAtMs, checks: rows.length, attachments: held, ...(layerVideos ? { videos: layerVideos } : {}) });
         if (layer.evidence)
             takeEvidence(run.evidence, layer.evidence);
         const origin = originOf(layer, backend);
@@ -252,7 +257,8 @@ export class TestHistory {
             ...(r.e?.videos ? { videos: r.e.videos } : {}),
         }));
         results.sort((a, b) => FAILURE_RANK[b.status] - FAILURE_RANK[a.status] || compareText(a.specPath ?? '', b.specPath ?? '') || compareText(a.title, b.title) || compareText(a.environment ?? '', b.environment ?? '') || compareText(a.producer, b.producer) || compareText(a.key, b.key));
-        return { run: runSummary(run, cells), results };
+        const layers = [...run.members].sort((a, b) => a.recordedAtMs - b.recordedAtMs || compareText(a.id, b.id));
+        return { run: runSummary(run, cells), results, layers };
     }
     /**
      * Every recorded result that carries an attachment, newest first, with the values a query looks at. Built once per
@@ -351,6 +357,7 @@ function runSummary(run, cells) {
         producers: [...run.producers].sort(), environments: [...run.environments].sort(),
         layers: run.layers, tests: tests.size, counts, totalDurationMs: measured ? total : null, failing,
         ...(video ? { videos: video } : {}),
+        ...(run.attachments ? { attachments: run.attachments } : {}),
         ...(carried.artifactTags.size ? { artifactTags: [...carried.artifactTags].sort() } : {}),
         ...(carried.roles.size ? { types: typesOf(carried.roles, (video?.recordings ?? 0) > 0) } : {}),
         ...(carried.labels.size ? { labels: [...carried.labels].sort() } : {}),
@@ -448,10 +455,16 @@ function summaryOf(slot, history, known) {
     const labels = {};
     let attachments = 0, steps = 0, attempts = 0;
     const roles = new Set();
+    const profiles = new Map();
     for (const [at, outcome] of outcomes.entries()) {
         const evidence = outcome.evidence;
         if (!evidence)
             continue;
+        for (const video of evidence.videos ?? [])
+            if (video.available) {
+                const tokens = scopeTokens(video.scope);
+                profiles.set(tokens.join('\n'), tokens);
+            }
         if (evidence.attachments > 0)
             for (const tag of normalizeTags([...evidence.tags, ...(slot.outcomes[at]?.layer.evidence?.tags ?? [])]))
                 inheritedTags.add(tag);
@@ -481,6 +494,7 @@ function summaryOf(slot, history, known) {
         tags: tagList,
         ...(artifactTags.size ? { artifactTags: [...artifactTags].sort() } : {}),
         ...([...inheritedTags].some(tag => !artifactTags.has(tag)) ? { inheritedArtifactTags: [...inheritedTags].filter(tag => !artifactTags.has(tag)).sort() } : {}),
+        ...(profiles.size ? { scopeProfiles: [...profiles.values()] } : {}),
         labels,
         evidence: { attachments, steps, attempts, roles: [...roles].sort() },
         lastRecordedAtMs: slot.latestAtMs,
@@ -490,7 +504,7 @@ function summaryOf(slot, history, known) {
 /** The lowercase text a search matches a test against: title, id, spec, domain, tags, labels, environments and producers. */
 export function haystackOf(test) {
     return [
-        test.title, test.id, test.specPath ?? '', test.spec?.title ?? '', test.spec?.domain ?? '', ...test.tags, ...(test.artifactTags ?? []).map(displayTag),
+        test.title, test.id, test.specPath ?? '', test.spec?.title ?? '', test.spec?.domain ?? '', ...test.tags, ...(test.artifactTags ?? []).map(displayTag), ...(test.scopeProfiles ?? []).flat().filter(token => token !== UNKNOWN_SCOPE),
         ...Object.entries(test.labels).flatMap(([key, value]) => [key, value]), ...test.environments, ...test.producers,
     ].join('\n').toLowerCase();
 }
@@ -597,6 +611,7 @@ export function catalogModel(layers, sources = {}) {
         specs: [...specGroups].map(([, list]) => { const g = group(list[0].spec.path, list); return { ...list[0].spec, tests: g.tests, counts: g.counts }; }).sort((a, b) => compareText(a.domain, b.domain) || compareText(a.title, b.title)),
         tags: facet(tests, test => test.tags),
         artifactTags: facet(tests, test => test.artifactTags ?? []),
+        scopes: facet(tests, test => (test.scopeProfiles ?? []).flat()),
         branches: facet(tests, test => test.stats.branches),
         labels: Object.fromEntries([...labelKeys].sort().map(key => [key, facet(tests, test => (test.labels[key] === undefined ? [] : [test.labels[key]]))])),
     };
@@ -633,6 +648,8 @@ export function matchesQuery(model, test, query, inRun) {
         return false;
     if (query.artifactTag?.length && !query.artifactTag.some(tag => { const wanted = normalizeTag(tag); return wanted !== null && ((test.artifactTags?.includes(wanted) ?? false) || (query.inherited === true && (test.inheritedArtifactTags?.includes(wanted) ?? false))); }))
         return false;
+    if (query.scope?.length && !(test.scopeProfiles ?? []).some(tokens => matchesScope(tokens, query.scope)))
+        return false;
     if (inRun && !inRun.has(test.key))
         return false;
     return true;
@@ -725,7 +742,7 @@ export function runDetail(history, version, key) {
     const found = history.run(key);
     return found ? { schemaVersion: TEST_CATALOG_VERSION, version, ...found } : null;
 }
-/** Reads a `TestQuery` from URL search parameters: `q`, `sort`, `offset`, `limit`, `run`, and repeatable or comma-separated `status`, `environment`, `producer`, `domain`, `spec`, `tag`, `artifactTag`, and `inherited=1`. */
+/** Reads a `TestQuery` from URL search parameters: `q`, `sort`, `offset`, `limit`, `run`, and repeatable or comma-separated `status`, `environment`, `producer`, `domain`, `spec`, `tag`, `artifactTag`, `scope` (every token must hold for one recording), and `inherited=1`. */
 export function parseTestQuery(params) {
     const many = (name) => params.getAll(name).flatMap(splitList);
     const number = (name) => { const value = params.get(name); return value !== null && /^\d+$/.test(value) ? Number(value) : undefined; };
@@ -734,7 +751,7 @@ export function parseTestQuery(params) {
     const q = params.get('q');
     if (q)
         query.q = q;
-    for (const name of ['status', 'environment', 'producer', 'domain', 'spec', 'tag', 'artifactTag']) {
+    for (const name of ['status', 'environment', 'producer', 'domain', 'spec', 'tag', 'artifactTag', 'scope']) {
         const values = many(name);
         if (values.length)
             query[name] = values;
@@ -815,6 +832,7 @@ export function historyMarkdown(document) {
         `- Duration: ${d ? `avg ${formatMs(d.avgMs)}, p50 ${formatMs(d.p50Ms)}, p95 ${formatMs(d.p95Ms)}, min ${formatMs(d.minMs)}, max ${formatMs(d.maxMs)}, last ${formatMs(d.lastMs)}` : 'not measured'}`,
         ...(test.tags.length ? [`- Tags: ${test.tags.join(', ')}`] : []),
         ...(test.artifactTags?.length ? [`- Artifact tags: ${test.artifactTags.map(displayTag).join(', ')}`] : []),
+        ...(test.scopeProfiles?.length ? [`- Recording scope: ${test.scopeProfiles.map(tokens => tokens.join(' ')).join('; ')}`] : []),
         ...(Object.keys(test.labels).length ? [`- Labels: ${Object.entries(test.labels).map(([k, v]) => `${k}=${v}`).join(', ')}`] : []),
         `- Evidence: ${test.evidence.attachments} attachments${test.evidence.roles.length ? ` (${test.evidence.roles.join(', ')})` : ''}, ${test.evidence.steps} steps`,
         '',