@crvouga/atlas 1.18.0 → 1.19.0

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

@@ -225,6 +225,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/test-catalog.schema.json

@@ -1007,6 +1007,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/test-history.schema.json

@@ -301,6 +301,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",
@@ -976,6 +985,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/server/openapi.json

@@ -10752,6 +10752,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",
@@ -11235,6 +11244,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",
@@ -11753,6 +11771,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",
@@ -12236,6 +12263,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",
@@ -15648,6 +15684,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",
@@ -16146,6 +16191,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",
@@ -18760,6 +18814,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",
@@ -19246,6 +19309,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",
@@ -19892,6 +19964,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",
@@ -21151,6 +21232,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",
@@ -22346,6 +22436,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",
@@ -23021,6 +23120,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",
@@ -24600,6 +24708,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",
@@ -26136,6 +26253,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/visualizer/src/app/AppShell.tsx

@@ -26,7 +26,7 @@ function Index() {
     <UiCatalogFilters />
   ) : kind ? (
     <SpecIndex kind={kind} />
-  ) : pathname.startsWith('/specs/') ? (
+  ) : pathname.startsWith('/specs/') || pathname === '/behaviors' ? (
     <Box component="nav" aria-label="Specs" />
   ) : evidence.ready && !evidence.files.some(isStatechartFile) ? (
     <ProjectIndex />
@@ -39,7 +39,7 @@ function Body() {
   const { view, spec } = useAtlas();
   const { pathname } = useLocation();
   if (pathname === '/' && evidence.ready && !evidence.filesPending && !evidence.files.some(isStatechartFile)) return <Explorer />;
-  if (!pathname.startsWith('/specs/') && pathname !== '/catalog' && !view && spec.error)
+  if (!pathname.startsWith('/specs/') && pathname !== '/catalog' && pathname !== '/behaviors' && !view && spec.error)
     return (
       <Container py="xl">
         <Alert color="red" title="The spec couldn’t be loaded">

package/packages/visualizer/src/app/router.tsx

@@ -12,6 +12,8 @@ import {
 import { z } from 'zod/v4';
 import { CatalogSearchFields } from '../catalog/search';
 import { UiCatalogPage } from '../catalog/UiCatalogPage';
+import { COVERAGE_ORDER } from '../evidence/behavior';
+import { BehaviorsPage } from '../evidence/behaviors-page';
 import { SpecPage } from '../evidence/spec-page';
 import { ExplorerSearchFields } from '../explorer/search';
 import { ProductPage } from '../views/ProductPage';
@@ -44,6 +46,21 @@ const SpecSearch = RootSearch.extend({
   evidence: z.enum(['stale']).optional().catch(undefined)
 });
 export type SpecSearch = z.infer<typeof SpecSearch>;
+/**
+ * The project-wide behavior index and its read-and-watch workspace: the search words, the coverage filter, the open behavior
+ * (`behavior`, an id from `evidence/behavior-index.ts`), whether it is expanded into the workspace, and the run and recorded
+ * moment shown. Scope and selection live here so that a link, a reload and the way back from the workspace all reproduce them.
+ */
+const BehaviorsSearch = RootSearch.extend({
+  q: z.string().min(1).optional().catch(undefined),
+  coverage: z.enum(COVERAGE_ORDER as [(typeof COVERAGE_ORDER)[number], ...(typeof COVERAGE_ORDER)[number][]]).optional().catch(undefined),
+  behavior: z.string().min(1).optional().catch(undefined),
+  workspace: z.preprocess((value) => (value === 'true' ? true : value), z.literal(true)).optional().catch(undefined),
+  layer: z.string().min(1).optional().catch(undefined),
+  clip: z.coerce.string().min(1).optional().catch(undefined),
+  clipAt: z.coerce.number().nonnegative().optional().catch(undefined)
+});
+export type BehaviorsSearch = z.infer<typeof BehaviorsSearch>;
 /** A fresh route tree per router, so a test can run its own viewer beside the page's. */
 function routeTree() {
   const rootRoute = createRootRoute({
@@ -96,7 +113,14 @@ function routeTree() {
     validateSearch: (search) => RootSearch.extend(CatalogSearchFields).parse(search),
     component: UiCatalogPage
   });
-  return rootRoute.addChildren([productRoute, chartRoute, specRoute, catalogRoute]);
+  /** Every behavior of the project in one searchable list, and the dedicated workspace to read and watch one. */
+  const behaviorsRoute = createRoute({
+    getParentRoute: () => rootRoute,
+    path: '/behaviors',
+    validateSearch: (search) => BehaviorsSearch.parse(search),
+    component: BehaviorsPage
+  });
+  return rootRoute.addChildren([productRoute, chartRoute, specRoute, catalogRoute, behaviorsRoute]);
 }
 export function createAtlasRouter(history: RouterHistory) {
   return createRouter({ routeTree: routeTree(), history, defaultPreload: false, scrollRestoration: true });

package/packages/visualizer/src/components/Header.tsx

@@ -1,5 +1,5 @@
 import { SpecLogo } from './SpecLogo';
-import { IconDots, IconLayoutGrid } from '@tabler/icons-react';
+import { IconDots, IconLayoutGrid, IconListSearch } from '@tabler/icons-react';
 import { isUiKind } from '@crvouga/atlas/reports/ui-state';
 import { isStatechartFile } from '@crvouga/atlas/schema';
 import { ActionIcon, Anchor, Badge, Box, Button, Group, Menu, NativeSelect, Popover, Stack, Tooltip } from '@mantine/core';
@@ -139,6 +139,8 @@ export function Header() {
   );
   const project = currentProject();
   const catalogOpen = pathname === '/catalog';
+  const behaviorsOpen = pathname === '/behaviors';
+  const hasFeatures = evidence.files.some(SPEC_KINDS[0]!.accepts);
   // The catalog is offered once the report holds a state or a plan for one.
   const hasCatalog = useMemo(() => evidence.evidence.some((layer) => layer.rows.some((row) => isUiKind(row.kind))), [evidence.evidence]);
   return (
@@ -155,13 +157,13 @@ export function Header() {
               leftSection={kind ? <SpecLogo kind={kind} /> : undefined}
               rightSection={<ChevronDownIcon aria-hidden="true" size={12} />}
             >
-              {catalogOpen ? 'UI catalog' : (kind?.label ?? (hasCharts ? 'Statecharts' : evidence.ready && !tabs.length ? 'Tests' : 'Specs'))}
+              {catalogOpen ? 'UI catalog' : behaviorsOpen ? 'Behaviors' : (kind?.label ?? (hasCharts ? 'Statecharts' : evidence.ready && !tabs.length ? 'Tests' : 'Specs'))}
             </Button>
           </Menu.Target>
           <Menu.Dropdown>
             <Box component="nav" aria-label="Spec type">
               <Menu.Item
-                aria-current={pathname.startsWith('/specs/') || catalogOpen ? undefined : 'page'}
+                aria-current={pathname.startsWith('/specs/') || catalogOpen || behaviorsOpen ? undefined : 'page'}
                 renderRoot={(props) => <Link {...props} to="/" search={(prev) => runOnly(prev)} />}
               >
                 {hasCharts || !evidence.ready ? 'Statecharts' : 'Tests'}
@@ -183,6 +185,15 @@ export function Header() {
                   {tab.kind.label}
                 </Menu.Item>
               ))}
+              {(hasFeatures || behaviorsOpen) && (
+                <Menu.Item
+                  leftSection={<IconListSearch size={16} aria-hidden="true" />}
+                  aria-current={behaviorsOpen ? 'page' : undefined}
+                  renderRoot={(props) => <Link {...props} to="/behaviors" search={{}} />}
+                >
+                  Behaviors
+                </Menu.Item>
+              )}
               {(hasCatalog || catalogOpen) && (
                 <Menu.Item
                   leftSection={<IconLayoutGrid size={16} aria-hidden="true" />}
@@ -263,7 +274,7 @@ function SpecBreadcrumb() {
         name: item.name,
         running: (evidence.view.specs.get(outlinePath(item.file))?.summary.counts.running ?? 0) > 0
       }));
-  if (!options.length || pathname === '/catalog') return null;
+  if (!options.length || pathname === '/catalog' || pathname === '/behaviors') return null;
   return (
     <NativeSelect
       data-running={options.some((option) => option.running) || undefined}

package/packages/visualizer/src/evidence/behavior-index.test.ts

@@ -0,0 +1,119 @@
+import type { LayerHeader, LayerRow } from '@crvouga/atlas/reports/evidence-types';
+import type { CheckSlot, EvidenceView } from '@crvouga/atlas/reports/evidence-view';
+import type { EvidenceResult } from '@crvouga/atlas/reports/layer-merge';
+import { expect, test } from 'bun:test';
+
+import { passesFilters, parseSearch } from '../find/query';
+import { behaviorDoc, indexBehaviors } from './behavior-index';
+
+const PAY = `Feature: Pay an invoice
+  Rule: Cards
+    @smoke
+    Scenario: Pay by card
+      Given an invoice
+      When paying by card
+      Then the invoice is paid
+
+    Scenario Outline: Pay in a currency
+      When paying in "<code>"
+      Examples:
+        | code |
+        | EUR  |
+        | USD  |
+`;
+const LISTS = 'Feature: Share a list\n  Scenario: Add an item\n    When adding tea\n';
+
+const header = (layer: string): LayerHeader => ({
+  id: layer, backend: 'b', producer: 'e2e', packageDir: null, recordedAtMs: 1, sha: null, branch: 'main', environment: 'desktop-web', runUrl: null, parameters: {},
+  recording: null, live: false, counts: { passed: 0, failed: 0, running: 0, 'not-run': 0 }, execution: layer
+});
+const VIDEO = { attachments: 1, steps: 0, annotations: 0, attempts: 0, links: 0, tags: [], labels: {}, roles: ['video'], videos: [{ name: 'a.webm', owner: 'check' as const, recording: 'sha256:1', available: true }] };
+function slot(title: string, layer: string, row: Partial<LayerRow> = {}): CheckSlot {
+  const result: EvidenceResult = {
+    key: layer, slot: title, layer: header(layer), parameters: {}, warning: null,
+    row: { kind: 'behavior', id: title, title, status: 'passed', specPath: 'specs/billing/pay.feature', detail: '', measurements: [], testId: null, variant: {}, durationMs: null, ...row }
+  };
+  return { key: title, id: title, title, specPath: result.row.specPath, status: result.row.status, outcomes: [result], diagnostics: [], latestAtMs: 1, live: false };
+}
+const view = (slots: Record<string, CheckSlot[]>) => ({ specs: new Map(Object.entries(slots).map(([path, list]) => [path, { slots: list }])) }) as unknown as EvidenceView;
+const specs = [
+  { path: 'specs/billing/pay.feature', domain: 'billing', kind: 'gherkin', title: 'Pay', fingerprint: 'now' },
+  { path: 'specs/lists/add.feature', domain: '', kind: 'gherkin', title: 'Lists' }
+];
+
+test('every feature\'s behaviors are listed once, an outline as one per example row and never as its template', () => {
+  const index = indexBehaviors({
+    files: ['billing/pay.feature', 'lists/add.feature'],
+    texts: new Map([['billing/pay.feature', PAY], ['lists/add.feature', LISTS]]),
+    specs,
+    view: view({ 'specs/billing/pay.feature': [slot('Pay an invoice: Pay by card', 'l1', { evidence: VIDEO })] }),
+    evidence: [{ layer: header('l1'), fingerprints: { 'specs/billing/pay.feature': 'now' } }]
+  });
+  expect(index.entries.map((entry) => entry.title)).toEqual(['Pay by card', 'Pay in a currency — EUR', 'Pay in a currency — USD', 'Add an item']);
+  expect(index.entries.map((entry) => entry.behavior.state)).toEqual(['demonstrated', 'unexecuted', 'unexecuted', 'unexecuted']);
+  expect(index.entries[0]).toMatchObject({ file: 'billing/pay.feature', feature: 'Pay an invoice', rule: 'Cards', domain: 'billing' });
+  // A domain nobody declared is not invented.
+  expect(index.entries[3]!.domain).toBe('');
+  expect(new Set(index.entries.map((entry) => entry.id)).size).toBe(4);
+  expect(index).toMatchObject({ features: 2, unread: 0, unreadable: [] });
+});
+
+test('a recording of an older revision is not demonstrated here either', () => {
+  const index = indexBehaviors({
+    files: ['billing/pay.feature'],
+    texts: new Map([['billing/pay.feature', PAY]]),
+    specs,
+    view: view({ 'specs/billing/pay.feature': [slot('Pay an invoice: Pay by card', 'l1', { evidence: VIDEO })] }),
+    evidence: [{ layer: header('l1'), fingerprints: { 'specs/billing/pay.feature': 'earlier' } }]
+  });
+  expect(index.entries[0]!.behavior.state).toBe('outdated-recording');
+  expect(index.entries[0]!.assessment.verdict).toBe('stale');
+});
+
+test('features not read yet or not readable are counted and named, never silently absent', () => {
+  const index = indexBehaviors({
+    files: ['billing/pay.feature', 'lists/add.feature', 'broken.feature', 'gone.feature'],
+    texts: new Map([['billing/pay.feature', PAY], ['broken.feature', 'this is not gherkin'], ['gone.feature', '']]),
+    specs,
+    view: view({}),
+    evidence: []
+  });
+  expect(index.unread).toBe(1);
+  expect(index.unreadable).toEqual(['broken.feature', 'gone.feature']);
+  expect(index.features).toBe(4);
+  expect(index.entries).toHaveLength(3);
+});
+
+test('a result no scenario claims is still a behavior that was checked', () => {
+  const index = indexBehaviors({
+    files: ['lists/add.feature'],
+    texts: new Map([['lists/add.feature', LISTS]]),
+    specs,
+    view: view({ 'specs/lists/add.feature': [slot('Share a list: Renamed since', 'l9', { specPath: 'specs/lists/add.feature' })] }),
+    evidence: []
+  });
+  expect(index.entries.map((entry) => entry.title)).toEqual(['Add an item', 'Renamed since']);
+  expect(index.entries[1]!.behavior.state).toBe('no-recording');
+});
+
+test('the search document carries wording, steps, domain and tags, and its facets feed the typed filters', () => {
+  const index = indexBehaviors({
+    files: ['billing/pay.feature'],
+    texts: new Map([['billing/pay.feature', PAY]]),
+    specs,
+    view: view({ 'specs/billing/pay.feature': [slot('Pay an invoice: Pay by card', 'l1', { evidence: VIDEO })] }),
+    evidence: []
+  });
+  const doc = behaviorDoc(index.entries[0]!);
+  expect(doc.fields.find((field) => field.name === 'steps')!.text).toContain('paying by card');
+  expect(doc.fields.find((field) => field.name === 'metadata')!.text).toContain('billing');
+  expect(doc.target).toMatchObject({ to: '/specs/$kind', kind: 'gherkin', search: { spec: 'billing/pay.feature' } });
+  const passes = (query: string) => passesFilters(doc.facets, parseSearch(query).filters);
+  expect(passes('has:video')).toBe(true);
+  expect(passes('status:passed tag:smoke domain:billing')).toBe(true);
+  expect(passes('status:failed')).toBe(false);
+  // A behavior nothing reported on has no status to match and no video.
+  const unreported = behaviorDoc(index.entries[1]!);
+  expect(passesFilters(unreported.facets, parseSearch('has:video').filters)).toBe(false);
+  expect(unreported.status).toBe('none');
+});