@crvouga/atlas 1.18.0 → 1.19.0

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Changelog: @crvouga/atlas
 
-## 1.18.0 (2026-10-29)
+## 1.19.0 (2026-10-29)
+
+### Features
+
+- add a project-wide behavior index, a read-and-watch workspace and a scoped summary ([bb2d270](https://github.com/crvouga/atlas/commit/bb2d270fcfc2374c316db804e80af67885bdd8ee))
+- restore the watch playlist from the address and show clip posters and lengths ([2dfc480](https://github.com/crvouga/atlas/commit/2dfc4806a72621f67f304cd9fda7619a9dbbea3f))
+
+## 1.18.0 (2026-10-28)
 
 ### Features
 

package/dist/reports/src/evidence-detail.js

@@ -62,7 +62,7 @@ function summarize(holders, owner, inherited, firstIsParent = false, unstored) {
             for (const tag of normalizeTags(item.tags))
                 artifactTags.add(tag);
             roles.add(item.role ?? roleOfType(item.contentType ?? contentTypeOf(item.name)));
-            const video = videoOf(item, by, where, effectiveScope(item.scope, ...scopes), unstored);
+            const video = videoOf(item, by, where, effectiveScope(item.scope, ...scopes), unstored, list);
             if (video)
                 videos.push(video);
         }
@@ -110,14 +110,24 @@ export function isVideoAttachment(attachment) {
 export function attachmentIdentity(item) {
     return item.sha256 ? `sha256:${item.sha256}` : item.bundleKey ?? item.uri ?? (item.text === undefined ? undefined : `inline:${item.name}`);
 }
-function videoOf(item, owner, where, scope, unstored) {
+/** The bundle key of the image an attachment names as its poster among its siblings, when the layer's bundle holds it. */
+function posterKey(item, siblings, unstored) {
+    if (item.poster === undefined)
+        return undefined;
+    const poster = siblings?.find(other => other !== item && other.id === item.poster);
+    if (!poster?.bundleKey || unstored?.has(poster.bundleKey))
+        return undefined;
+    return (poster.contentType ?? contentTypeOf(poster.name)).toLowerCase().startsWith('image/') ? poster.bundleKey : undefined;
+}
+function videoOf(item, owner, where, scope, unstored, siblings) {
     if (!isVideoAttachment(item))
         return undefined;
     // A bundle key the layer's bundle does not hold names bytes that are not there: only an address or inline text can still carry them, and the digest of lost bytes identifies nothing playable.
     const lost = item.bundleKey !== undefined && unstored?.has(item.bundleKey) === true;
     const recording = lost ? attachmentIdentity({ name: item.name, uri: item.uri, text: item.text }) : attachmentIdentity(item);
     const tags = normalizeTags(item.tags);
-    return { name: item.name, owner, ...where, ...(tags.length ? { tags } : {}), ...(recording === undefined ? {} : { recording }), available: recording !== undefined, ...(lost && recording === undefined ? { reason: 'not-in-bundle' } : {}), ...(scope ? { scope } : {}) };
+    const poster = posterKey(item, siblings, unstored);
+    return { name: item.name, owner, ...where, ...(tags.length ? { tags } : {}), ...(recording === undefined ? {} : { recording }), available: recording !== undefined, ...(lost && recording === undefined ? { reason: 'not-in-bundle' } : {}), ...(item.durationMs !== undefined && Number.isFinite(item.durationMs) ? { durationMs: item.durationMs } : {}), ...(poster === undefined ? {} : { poster }), ...(scope ? { scope } : {}) };
 }
 /**
  * Counts references, distinct playable recordings and unplayable references. Undefined when there is no reference, so

package/dist/reports/src/evidence-types.d.ts

@@ -60,6 +60,10 @@ export type VideoRef = {
     readonly available: boolean;
     /** Why it is unavailable, when the report can tell: `not-in-bundle` names a file the layer should hold (its bundle key) but does not, a recording that was acknowledged and is no longer there. Absent otherwise, and for an available video. An open vocabulary: treat an unknown reason as plain unavailable. */
     readonly reason?: 'not-in-bundle';
+    /** How long the recording is, in milliseconds, as its producer declared (`Attachment.durationMs`): a hint to show before the file is opened, never measured here and never a latency. Absent when none was declared, and in documents of older servers. */
+    readonly durationMs?: number;
+    /** The bundle key, in the same layer, of the image the producer named as this recording's poster (`Attachment.poster`): a hint to show before the file is opened. Only an image the layer's bundle holds; absent when there is none, and in documents of older servers. */
+    readonly poster?: string;
     /** What this recording shows, as declared for it: its own `scope`, else its attempt's, check's, part's or layer's. Absent when none declared one: its scope is unknown, not live, physical or audible. */
     readonly scope?: EvidenceScope;
 };

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

@@ -91,6 +91,8 @@ export declare const VideoRefSchema: z.ZodObject<{
     recording: z.ZodOptional<z.ZodString>;
     available: z.ZodBoolean;
     reason: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodString>;
     scope: z.ZodOptional<z.ZodObject<{
         surface: z.ZodOptional<z.ZodString>;
         deviceKind: z.ZodOptional<z.ZodString>;
@@ -144,6 +146,8 @@ export declare const EvidenceSummarySchema: z.ZodObject<{
         recording: z.ZodOptional<z.ZodString>;
         available: z.ZodBoolean;
         reason: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        poster: z.ZodOptional<z.ZodString>;
         scope: z.ZodOptional<z.ZodObject<{
             surface: z.ZodOptional<z.ZodString>;
             deviceKind: z.ZodOptional<z.ZodString>;
@@ -221,6 +225,8 @@ export declare const LayerHeaderSchema: z.ZodObject<{
             recording: z.ZodOptional<z.ZodString>;
             available: z.ZodBoolean;
             reason: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            poster: z.ZodOptional<z.ZodString>;
             scope: z.ZodOptional<z.ZodObject<{
                 surface: z.ZodOptional<z.ZodString>;
                 deviceKind: z.ZodOptional<z.ZodString>;
@@ -309,6 +315,8 @@ export declare const LayerRowSchema: z.ZodObject<{
             recording: z.ZodOptional<z.ZodString>;
             available: z.ZodBoolean;
             reason: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            poster: z.ZodOptional<z.ZodString>;
             scope: z.ZodOptional<z.ZodObject<{
                 surface: z.ZodOptional<z.ZodString>;
                 deviceKind: z.ZodOptional<z.ZodString>;
@@ -415,6 +423,8 @@ export declare const LayerRowsSchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -523,6 +533,8 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -625,6 +637,8 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -722,6 +736,8 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                     recording: z.ZodOptional<z.ZodString>;
                     available: z.ZodBoolean;
                     reason: z.ZodOptional<z.ZodString>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    poster: z.ZodOptional<z.ZodString>;
                     scope: z.ZodOptional<z.ZodObject<{
                         surface: z.ZodOptional<z.ZodString>;
                         deviceKind: z.ZodOptional<z.ZodString>;
@@ -824,6 +840,8 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                     recording: z.ZodOptional<z.ZodString>;
                     available: z.ZodBoolean;
                     reason: z.ZodOptional<z.ZodString>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    poster: z.ZodOptional<z.ZodString>;
                     scope: z.ZodOptional<z.ZodObject<{
                         surface: z.ZodOptional<z.ZodString>;
                         deviceKind: z.ZodOptional<z.ZodString>;
@@ -942,6 +960,8 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                     recording: z.ZodOptional<z.ZodString>;
                     available: z.ZodBoolean;
                     reason: z.ZodOptional<z.ZodString>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    poster: z.ZodOptional<z.ZodString>;
                     scope: z.ZodOptional<z.ZodObject<{
                         surface: z.ZodOptional<z.ZodString>;
                         deviceKind: z.ZodOptional<z.ZodString>;
@@ -1044,6 +1064,8 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                     recording: z.ZodOptional<z.ZodString>;
                     available: z.ZodBoolean;
                     reason: z.ZodOptional<z.ZodString>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    poster: z.ZodOptional<z.ZodString>;
                     scope: z.ZodOptional<z.ZodObject<{
                         surface: z.ZodOptional<z.ZodString>;
                         deviceKind: z.ZodOptional<z.ZodString>;
@@ -1154,6 +1176,8 @@ export declare const EvidencePageSchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -1735,6 +1759,8 @@ export declare const ReviewSnapshotSchema: z.ZodObject<{
         recording: z.ZodOptional<z.ZodString>;
         available: z.ZodBoolean;
         reason: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        poster: z.ZodOptional<z.ZodString>;
         scope: z.ZodOptional<z.ZodObject<{
             surface: z.ZodOptional<z.ZodString>;
             deviceKind: z.ZodOptional<z.ZodString>;
@@ -1799,6 +1825,8 @@ export declare const ReviewEntrySchema: z.ZodObject<{
             recording: z.ZodOptional<z.ZodString>;
             available: z.ZodBoolean;
             reason: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            poster: z.ZodOptional<z.ZodString>;
             scope: z.ZodOptional<z.ZodObject<{
                 surface: z.ZodOptional<z.ZodString>;
                 deviceKind: z.ZodOptional<z.ZodString>;
@@ -1882,6 +1910,8 @@ export declare const ReviewCollectionSchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -2042,6 +2072,8 @@ export declare const ReviewCollectionDetailSchema: z.ZodObject<{
                     recording: z.ZodOptional<z.ZodString>;
                     available: z.ZodBoolean;
                     reason: z.ZodOptional<z.ZodString>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    poster: z.ZodOptional<z.ZodString>;
                     scope: z.ZodOptional<z.ZodObject<{
                         surface: z.ZodOptional<z.ZodString>;
                         deviceKind: z.ZodOptional<z.ZodString>;
@@ -2174,6 +2206,8 @@ export declare const ReviewManifestSchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -2303,6 +2337,8 @@ export declare const TestResultEntrySchema: z.ZodObject<{
             recording: z.ZodOptional<z.ZodString>;
             available: z.ZodBoolean;
             reason: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            poster: z.ZodOptional<z.ZodString>;
             scope: z.ZodOptional<z.ZodObject<{
                 surface: z.ZodOptional<z.ZodString>;
                 deviceKind: z.ZodOptional<z.ZodString>;
@@ -2414,6 +2450,8 @@ export declare const TestSummarySchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -2721,6 +2759,8 @@ export declare const TestCatalogSchema: z.ZodObject<{
                     recording: z.ZodOptional<z.ZodString>;
                     available: z.ZodBoolean;
                     reason: z.ZodOptional<z.ZodString>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    poster: z.ZodOptional<z.ZodString>;
                     scope: z.ZodOptional<z.ZodObject<{
                         surface: z.ZodOptional<z.ZodString>;
                         deviceKind: z.ZodOptional<z.ZodString>;
@@ -2960,6 +3000,8 @@ export declare const TestHistorySchema: z.ZodObject<{
                     recording: z.ZodOptional<z.ZodString>;
                     available: z.ZodBoolean;
                     reason: z.ZodOptional<z.ZodString>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    poster: z.ZodOptional<z.ZodString>;
                     scope: z.ZodOptional<z.ZodObject<{
                         surface: z.ZodOptional<z.ZodString>;
                         deviceKind: z.ZodOptional<z.ZodString>;
@@ -3089,6 +3131,8 @@ export declare const TestHistorySchema: z.ZodObject<{
                 recording: z.ZodOptional<z.ZodString>;
                 available: z.ZodBoolean;
                 reason: z.ZodOptional<z.ZodString>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                poster: z.ZodOptional<z.ZodString>;
                 scope: z.ZodOptional<z.ZodObject<{
                     surface: z.ZodOptional<z.ZodString>;
                     deviceKind: z.ZodOptional<z.ZodString>;
@@ -3497,6 +3541,8 @@ export declare const ArtifactResultSchema: z.ZodObject<{
         recording: z.ZodOptional<z.ZodString>;
         available: z.ZodBoolean;
         reason: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        poster: z.ZodOptional<z.ZodString>;
         scope: z.ZodOptional<z.ZodObject<{
             surface: z.ZodOptional<z.ZodString>;
             deviceKind: z.ZodOptional<z.ZodString>;
@@ -3568,6 +3614,8 @@ export declare const ArtifactListSchema: z.ZodObject<{
             recording: z.ZodOptional<z.ZodString>;
             available: z.ZodBoolean;
             reason: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            poster: z.ZodOptional<z.ZodString>;
             scope: z.ZodOptional<z.ZodObject<{
                 surface: z.ZodOptional<z.ZodString>;
                 deviceKind: z.ZodOptional<z.ZodString>;
@@ -3722,6 +3770,8 @@ export declare const RunDetailSchema: z.ZodObject<{
             recording: z.ZodOptional<z.ZodString>;
             available: z.ZodBoolean;
             reason: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            poster: z.ZodOptional<z.ZodString>;
             scope: z.ZodOptional<z.ZodObject<{
                 surface: z.ZodOptional<z.ZodString>;
                 deviceKind: z.ZodOptional<z.ZodString>;

package/dist/schema/src/api.js

@@ -72,6 +72,8 @@ export const VideoRefSchema = z.looseObject({
     recording: z.string().optional().describe('What identifies the bytes; references with the same value are one recording. Absent when it cannot be played'),
     available: z.boolean().describe('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: z.string().optional().describe('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'),
+    durationMs: z.number().nonnegative().optional().describe('How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers'),
+    poster: z.string().optional().describe('The bundle key, in the same layer, of the image the producer named as this recording\'s poster: a hint to show before the file is opened. Absent when there is none or the layer\'s bundle does not hold it, and in documents of older servers'),
     scope: EvidenceScopeSchema.optional().describe('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')
 });
 /** Video references as counts: how many are referenced, how many distinct recordings can be played, how many cannot. */

package/docs/reference/reports.md

@@ -2181,6 +2181,10 @@ export type VideoRef = {
   readonly available: boolean;
   /** Why it is unavailable, when the report can tell: `not-in-bundle` names a file the layer should hold (its bundle key) but does not, a recording that was acknowledged and is no longer there. Absent otherwise, and for an available video. An open vocabulary: treat an unknown reason as plain unavailable. */
   readonly reason?: 'not-in-bundle';
+  /** How long the recording is, in milliseconds, as its producer declared (`Attachment.durationMs`): a hint to show before the file is opened, never measured here and never a latency. Absent when none was declared, and in documents of older servers. */
+  readonly durationMs?: number;
+  /** The bundle key, in the same layer, of the image the producer named as this recording's poster (`Attachment.poster`): a hint to show before the file is opened. Only an image the layer's bundle holds; absent when there is none, and in documents of older servers. */
+  readonly poster?: string;
   /** What this recording shows, as declared for it: its own `scope`, else its attempt's, check's, part's or layer's. Absent when none declared one: its scope is unknown, not live, physical or audible. */
   readonly scope?: EvidenceScope;
 };

package/docs/rich-evidence.md

@@ -27,6 +27,7 @@ decided exactly as before ([the report contract](report-contract.md)). Evidence
 | `attempts` | check | Every try of a retried check, with its own status, detail, steps and attachments. A check that passed after failing is flaky. |
 | `tags`, `labels` | check, layer | Filters and groups (`smoke`, `flaky`, an owner, a browser). |
 | `tags` | attachment | Marks one recording or screenshot, for example `demo`: shown as a `#demo` chip, and searchable. See [Tagging artifacts and demos](#tagging-artifacts-and-demos). |
+| `poster` (the `id` of an image in the same list) and `durationMs` | attachment (video) | Shown beside the recording in a watch playlist before anything is opened: the report carries them as the optional `poster` (a bundle key) and `durationMs` of each video reference, so no evidence is read per entry. Neither is ever a latency. |
 | `extensions['atlas.media']` | attachment (video) | Where the check's steps are in the recording, so a click on a step seeks the video. See [Place steps in a recording](#place-steps-in-a-recording). |
 | `scope` | attachment, attempt, check, part, layer | What a recording does and does not show: where it ran, whether data and dependencies were real, whether audio was captured. See [Evidence scope](#evidence-scope). |
 | `annotations`, `links` | check, step, attempt, layer | Notes, warnings and issue links next to the result. |

package/docs/ui.md

@@ -104,6 +104,37 @@ when Watch is on screen.
 - The spec index searches titles, paths and declared domains, and can group by the domain from spec metadata (specs with
   none are listed under "No domain declared"; the Tests view reports domain problems).
 
+## Behaviors across the project
+
+`/behaviors` (`evidence/behaviors-page.tsx`, **Behaviors** in the spec-type menu) lists every behavior of every Gherkin feature in one
+place, so the question "what does this product promise?" needs no knowledge of which file holds the answer. It adds no source of
+truth: `evidence/behavior-index.ts` reads each feature through the same `featureBehaviors` the feature page uses, so a behavior has the
+same coverage state, revisions and recording in both.
+
+- The list is searched with the shared matcher (`find/`: words, quoted phrases, `status:`, `domain:`, `tag:`, `has:video`), grouped by
+  the domain spec metadata declares ("No domain declared" when it declares none), or ranked best match first when words are typed.
+  A coverage state is a filter with its own count; `demonstrated` is always named. A long list is bounded with *Show more*.
+- Features whose text has not arrived are counted ("3 of 12 read"), and features that cannot be parsed are named, so an empty answer is
+  never taken for "no such behavior" while it is still incomplete.
+- The search words (`q`), the coverage filter (`coverage`), the selection (`behavior`) and the expanded state (`workspace`) are in the
+  address. Selecting shows the Read / Watch / Inspect panel beside the list (below it on narrow screens), and *Read and watch* in the
+  selected-behavior bar is reachable before the list in keyboard order.
+- **Read and watch workspace.** Expanding a behavior replaces the index with a page that uses the width: a two-column
+  `SimpleGrid` (one column below `md`) with *What should happen* (the steps, an outline's example filled in) beside *Recording* (the
+  player, status and provenance, promise and evidence revisions, applicability), the scoped summary below, and Inspect behind a
+  disclosure that reads the technical record only when opened. Keyboard focus moves to the behavior's heading on arrival, and
+  *Previous behavior* / *Next behavior* move through the same search. A recording is labelled illustrative.
+- **Returning** from the workspace restores the search words, the filter and the selection from the address, and the scroll position,
+  the number of rows shown and the focused row from `evidence/behavior-return.ts`, which remembers them for the session against the
+  scope they were taken in and gives them back once, only to that scope. Storage that is unavailable means the list opens at its top.
+- **Scoped summary** (`evidence/scoped-summary.ts`, `scoped-summary-view.tsx`, on Watch and in the workspace) answers three questions
+  apart, for the check in the environment of the recording shown (environments are not pooled; with none named it says they are):
+  the **outcome** of the shown result (`outcomeHeadline`), **reliability** (`reports/reliability`: always with the independent
+  executions it rests on, "Insufficient evidence" below the minimum, first-try success only from recorded tries, the library's
+  warnings) and **performance** (`reports/latency`: only measurements named `product-latency`, percentiles withheld with the reason,
+  budget and breaches). Absent evidence is stated as unknown, never as good; the test's duration is not product latency, and the
+  summary says it describes the checks Atlas holds, not production. The full reliability and latency detail is one link away.
+
 ## Catalog health
 
 The **Catalog health** tab (`explorer/HealthView.tsx`, `?tab=health`; `@crvouga/atlas/reports/catalog-health`) explains why the Specs
@@ -209,7 +240,14 @@ over the same filtered set the page lists, in the same order (`explorer/playlist
   demonstrated. A set longer than the page's limit says it is only the newest results.
 - Only the selected clip is read: the list is the metadata the catalog already sent, the selected result's evidence is read
   when it is selected, and the one `<video>` uses `preload="metadata"`. Opening the playlist downloads no recordings in bulk.
-  Posters and durations of unselected entries are not shown for that reason.
+  An unselected entry still shows a poster and a length when the catalog already carries them: the producer's declared
+  `Attachment.durationMs` and `Attachment.poster` (an image of the same list that the layer's bundle holds) travel as the
+  optional `durationMs` and `poster` of the result's video reference. The poster is an `<img loading="lazy">`, fetched when
+  its row nears the screen; an entry whose producer declared neither shows neither, and nothing is read to find out.
+- The open playlist is in the address (`watch=true`, and `watchClip` for the entry playing), so a link restores it over
+  the same filters, run or collection. Opening it adds a history entry (Back closes it); moving between clips and closing
+  it replace the current one. A `watchClip` the set no longer holds opens the first watchable entry and the address then
+  names that one.
 - One player: selecting another clip replaces it, and the position of the clip left is kept for the session so returning
   resumes there. Previous/next and advancing on end move over the watchable entries; a result with nothing to play is
   selected from the list to read why.
@@ -350,6 +388,7 @@ The narrowly scoped exceptions are:
 | Project home | Tests/runs/artifacts/compare/catalog health tabs, a two-run comparison with promise, outcome, recording and figure tabs per behavior, a run's Artifacts (files of its layers, shared recordings, direct links), Watch playlist of a filtered set, metrics, search, status/environment/domain/artifact-tag filters, run and artifact facets with saved views, grouping, sorting, show more | Container, Tabs, SimpleGrid, Paper, TextInput, MultiSelect, Popover, Button, Accordion, Modal, Grid, Switch |
 | Test detail | Current outcomes, statistics, duration graph, product latency with budgets and baselines, history, artifacts, recording; the `layer` address parameter pins it to one run's result, labelled "This run" against "Latest combined evidence" | Drawer, Table, Badge, Alert, Stage |
 | Specs | All six existing kinds, overview/index with title search and folder or declared-domain grouping, Gherkin rules/scenarios/examples with a coverage summary and Read / Watch / Inspect per behavior, Quint declarations/traces, DMN tables, source text | SpecHeader, Accordion, Tabs, Table, CodeHighlightTabs, ResultRow |
+| Behaviors | Project-wide behavior index with search, coverage filters and a selected behavior's Read / Watch / Inspect; an expanded read-and-watch workspace with a scoped outcome, reliability and performance summary that restores scope, scroll, selection and focus on return | Container, Grid, SimpleGrid, NavLink, TextInput, Button, Paper, Accordion, Tabs |
 | Statecharts | Graph, screen/event/journey details, developer metadata, chart test results | Mantine cards/navigation and product compositions; graph exception above |
 | Evidence | Steps, retries, annotations, facts, unknown extensions, safe downloads and previews | List, Badge, Accordion, Code, Image, native media |
 | Recordings | Pictures/video/timeline, actor selection, moments, failure jumps, timing, model-state differences | Tabs, Slider, Button, ScrollArea, Table, Progress |

package/llms-full.txt

@@ -1016,6 +1016,7 @@ decided exactly as before ([the report contract](report-contract.md)). Evidence
 | `attempts` | check | Every try of a retried check, with its own status, detail, steps and attachments. A check that passed after failing is flaky. |
 | `tags`, `labels` | check, layer | Filters and groups (`smoke`, `flaky`, an owner, a browser). |
 | `tags` | attachment | Marks one recording or screenshot, for example `demo`: shown as a `#demo` chip, and searchable. See [Tagging artifacts and demos](#tagging-artifacts-and-demos). |
+| `poster` (the `id` of an image in the same list) and `durationMs` | attachment (video) | Shown beside the recording in a watch playlist before anything is opened: the report carries them as the optional `poster` (a bundle key) and `durationMs` of each video reference, so no evidence is read per entry. Neither is ever a latency. |
 | `extensions['atlas.media']` | attachment (video) | Where the check's steps are in the recording, so a click on a step seeks the video. See [Place steps in a recording](#place-steps-in-a-recording). |
 | `scope` | attachment, attempt, check, part, layer | What a recording does and does not show: where it ran, whether data and dependencies were real, whether audio was captured. See [Evidence scope](#evidence-scope). |
 | `annotations`, `links` | check, step, attempt, layer | Notes, warnings and issue links next to the result. |
@@ -4560,6 +4561,37 @@ when Watch is on screen.
 - The spec index searches titles, paths and declared domains, and can group by the domain from spec metadata (specs with
   none are listed under "No domain declared"; the Tests view reports domain problems).
 
+## Behaviors across the project
+
+`/behaviors` (`evidence/behaviors-page.tsx`, **Behaviors** in the spec-type menu) lists every behavior of every Gherkin feature in one
+place, so the question "what does this product promise?" needs no knowledge of which file holds the answer. It adds no source of
+truth: `evidence/behavior-index.ts` reads each feature through the same `featureBehaviors` the feature page uses, so a behavior has the
+same coverage state, revisions and recording in both.
+
+- The list is searched with the shared matcher (`find/`: words, quoted phrases, `status:`, `domain:`, `tag:`, `has:video`), grouped by
+  the domain spec metadata declares ("No domain declared" when it declares none), or ranked best match first when words are typed.
+  A coverage state is a filter with its own count; `demonstrated` is always named. A long list is bounded with *Show more*.
+- Features whose text has not arrived are counted ("3 of 12 read"), and features that cannot be parsed are named, so an empty answer is
+  never taken for "no such behavior" while it is still incomplete.
+- The search words (`q`), the coverage filter (`coverage`), the selection (`behavior`) and the expanded state (`workspace`) are in the
+  address. Selecting shows the Read / Watch / Inspect panel beside the list (below it on narrow screens), and *Read and watch* in the
+  selected-behavior bar is reachable before the list in keyboard order.
+- **Read and watch workspace.** Expanding a behavior replaces the index with a page that uses the width: a two-column
+  `SimpleGrid` (one column below `md`) with *What should happen* (the steps, an outline's example filled in) beside *Recording* (the
+  player, status and provenance, promise and evidence revisions, applicability), the scoped summary below, and Inspect behind a
+  disclosure that reads the technical record only when opened. Keyboard focus moves to the behavior's heading on arrival, and
+  *Previous behavior* / *Next behavior* move through the same search. A recording is labelled illustrative.
+- **Returning** from the workspace restores the search words, the filter and the selection from the address, and the scroll position,
+  the number of rows shown and the focused row from `evidence/behavior-return.ts`, which remembers them for the session against the
+  scope they were taken in and gives them back once, only to that scope. Storage that is unavailable means the list opens at its top.
+- **Scoped summary** (`evidence/scoped-summary.ts`, `scoped-summary-view.tsx`, on Watch and in the workspace) answers three questions
+  apart, for the check in the environment of the recording shown (environments are not pooled; with none named it says they are):
+  the **outcome** of the shown result (`outcomeHeadline`), **reliability** (`reports/reliability`: always with the independent
+  executions it rests on, "Insufficient evidence" below the minimum, first-try success only from recorded tries, the library's
+  warnings) and **performance** (`reports/latency`: only measurements named `product-latency`, percentiles withheld with the reason,
+  budget and breaches). Absent evidence is stated as unknown, never as good; the test's duration is not product latency, and the
+  summary says it describes the checks Atlas holds, not production. The full reliability and latency detail is one link away.
+
 ## Catalog health
 
 The **Catalog health** tab (`explorer/HealthView.tsx`, `?tab=health`; `@crvouga/atlas/reports/catalog-health`) explains why the Specs
@@ -4665,7 +4697,14 @@ over the same filtered set the page lists, in the same order (`explorer/playlist
   demonstrated. A set longer than the page's limit says it is only the newest results.
 - Only the selected clip is read: the list is the metadata the catalog already sent, the selected result's evidence is read
   when it is selected, and the one `<video>` uses `preload="metadata"`. Opening the playlist downloads no recordings in bulk.
-  Posters and durations of unselected entries are not shown for that reason.
+  An unselected entry still shows a poster and a length when the catalog already carries them: the producer's declared
+  `Attachment.durationMs` and `Attachment.poster` (an image of the same list that the layer's bundle holds) travel as the
+  optional `durationMs` and `poster` of the result's video reference. The poster is an `<img loading="lazy">`, fetched when
+  its row nears the screen; an entry whose producer declared neither shows neither, and nothing is read to find out.
+- The open playlist is in the address (`watch=true`, and `watchClip` for the entry playing), so a link restores it over
+  the same filters, run or collection. Opening it adds a history entry (Back closes it); moving between clips and closing
+  it replace the current one. A `watchClip` the set no longer holds opens the first watchable entry and the address then
+  names that one.
 - One player: selecting another clip replaces it, and the position of the clip left is kept for the session so returning
   resumes there. Previous/next and advancing on end move over the watchable entries; a result with nothing to play is
   selected from the list to read why.
@@ -4806,6 +4845,7 @@ The narrowly scoped exceptions are:
 | Project home | Tests/runs/artifacts/compare/catalog health tabs, a two-run comparison with promise, outcome, recording and figure tabs per behavior, a run's Artifacts (files of its layers, shared recordings, direct links), Watch playlist of a filtered set, metrics, search, status/environment/domain/artifact-tag filters, run and artifact facets with saved views, grouping, sorting, show more | Container, Tabs, SimpleGrid, Paper, TextInput, MultiSelect, Popover, Button, Accordion, Modal, Grid, Switch |
 | Test detail | Current outcomes, statistics, duration graph, product latency with budgets and baselines, history, artifacts, recording; the `layer` address parameter pins it to one run's result, labelled "This run" against "Latest combined evidence" | Drawer, Table, Badge, Alert, Stage |
 | Specs | All six existing kinds, overview/index with title search and folder or declared-domain grouping, Gherkin rules/scenarios/examples with a coverage summary and Read / Watch / Inspect per behavior, Quint declarations/traces, DMN tables, source text | SpecHeader, Accordion, Tabs, Table, CodeHighlightTabs, ResultRow |
+| Behaviors | Project-wide behavior index with search, coverage filters and a selected behavior's Read / Watch / Inspect; an expanded read-and-watch workspace with a scoped outcome, reliability and performance summary that restores scope, scroll, selection and focus on return | Container, Grid, SimpleGrid, NavLink, TextInput, Button, Paper, Accordion, Tabs |
 | Statecharts | Graph, screen/event/journey details, developer metadata, chart test results | Mantine cards/navigation and product compositions; graph exception above |
 | Evidence | Steps, retries, annotations, facts, unknown extensions, safe downloads and previews | List, Badge, Accordion, Code, Image, native media |
 | Recordings | Pictures/video/timeline, actor selection, moments, failure jumps, timing, model-state differences | Tabs, Slider, Button, ScrollArea, Table, Progress |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/atlas",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "Atlas: specs of any kind, reported as layered evidence. Publish checks from any runner (JUnit, CTRF, a script), combine them across nodes, branches, environments and backends, gate CI on the result, and run statecharts against the real app.",
   "license": "MIT",
   "type": "module",

package/packages/schema/schemas/effective-delta.schema.json

@@ -268,6 +268,15 @@
                             "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"
                           },
+                          "durationMs": {
+                            "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          "poster": {
+                            "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                            "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",
@@ -751,6 +760,15 @@
                           "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"
                         },
+                        "durationMs": {
+                          "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                          "type": "number",
+                          "minimum": 0
+                        },
+                        "poster": {
+                          "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                          "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",

package/packages/schema/schemas/effective-evidence.schema.json

@@ -268,6 +268,15 @@
                             "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"
                           },
+                          "durationMs": {
+                            "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          "poster": {
+                            "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                            "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",
@@ -751,6 +760,15 @@
                           "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"
                         },
+                        "durationMs": {
+                          "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                          "type": "number",
+                          "minimum": 0
+                        },
+                        "poster": {
+                          "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                          "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",

package/packages/schema/schemas/evidence-page.schema.json

@@ -255,6 +255,15 @@
                       "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"
                     },
+                    "durationMs": {
+                      "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "poster": {
+                      "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                      "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",

package/packages/schema/schemas/layer-rows.schema.json

@@ -259,6 +259,15 @@
                       "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"
                     },
+                    "durationMs": {
+                      "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "poster": {
+                      "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                      "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",

package/packages/schema/schemas/report-run.schema.json

@@ -384,6 +384,15 @@
                   "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"
                 },
+                "durationMs": {
+                  "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "poster": {
+                  "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                  "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",

package/packages/schema/schemas/review-collection.schema.json

@@ -200,6 +200,15 @@
                       "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"
                     },
+                    "durationMs": {
+                      "description": "How long the recording is, in milliseconds, as its producer declared it: a hint to show before the file is opened, never a latency. Absent when none was declared, and in documents of older servers",
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "poster": {
+                      "description": "The bundle key, in the same layer, of the image the producer named as this recording's poster: a hint to show before the file is opened. Absent when there is none or the layer's bundle does not hold it, and in documents of older servers",
+                      "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",