@crvouga/atlas 1.17.0 → 1.19.0

package/packages/server/openapi.json

@@ -5856,6 +5856,15 @@
               "type": "string"
             }
           },
+          {
+            "required": false,
+            "name": "recordings",
+            "in": "query",
+            "description": "Recording completeness of the run, apart from its outcome: `complete`, `incomplete`, `none-expected` or `unknown` (a run whose layers declared no recording expectations is `unknown`, never `complete`). Repeatable or comma-separated. Answered from the layers' receipts; no recording is read. A server that does not know it ignores it and does not name it in `filters`.",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "required": false,
             "name": "q",
@@ -6076,6 +6085,15 @@
               "type": "string"
             }
           },
+          {
+            "required": false,
+            "name": "recordings",
+            "in": "query",
+            "description": "Recording completeness of the run, apart from its outcome: `complete`, `incomplete`, `none-expected` or `unknown` (a run whose layers declared no recording expectations is `unknown`, never `complete`). Repeatable or comma-separated. Answered from the layers' receipts; no recording is read. A server that does not know it ignores it and does not name it in `filters`.",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "required": false,
             "name": "q",
@@ -10730,6 +10748,19 @@
                                   "type": "boolean",
                                   "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                                 },
+                                "reason": {
+                                  "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                  "type": "string"
+                                },
+                                "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",
@@ -11209,6 +11240,19 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
+                              "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",
@@ -11723,6 +11767,19 @@
                                   "type": "boolean",
                                   "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                                 },
+                                "reason": {
+                                  "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                  "type": "string"
+                                },
+                                "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",
@@ -12202,6 +12259,19 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
+                              "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",
@@ -15610,6 +15680,19 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
+                          "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",
@@ -16104,6 +16187,19 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
+                          "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",
@@ -18714,6 +18810,19 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
+                          "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",
@@ -19196,6 +19305,19 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
+                              "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",
@@ -19838,6 +19960,19 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
+                          "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",
@@ -21093,6 +21228,19 @@
                                   "type": "boolean",
                                   "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                                 },
+                                "reason": {
+                                  "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                  "type": "string"
+                                },
+                                "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",
@@ -22284,6 +22432,19 @@
                                 "type": "boolean",
                                 "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                               },
+                              "reason": {
+                                "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                                "type": "string"
+                              },
+                              "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",
@@ -22955,6 +23116,19 @@
                             "type": "boolean",
                             "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                           },
+                          "reason": {
+                            "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                            "type": "string"
+                          },
+                          "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",
@@ -23984,6 +24158,12 @@
                       "minimum": 0,
                       "maximum": 9007199254740991,
                       "description": "References that name no bytes, or bytes the layer does not hold"
+                    },
+                    "missing": {
+                      "description": "Of `unavailable`, those that name a file the layer's bundle does not hold (stored, then gone). Absent when there are none",
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
                     }
                   },
                   "required": [
@@ -23993,6 +24173,64 @@
                   ],
                   "additionalProperties": {}
                 },
+                "recordings": {
+                  "description": "Whether the recordings its layers expected were published, apart from its outcomes. Absent when no layer declared an expectation: its completeness is unknown, never complete. Matched by the `recordings` filter",
+                  "type": "object",
+                  "properties": {
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "complete",
+                        "incomplete",
+                        "none-expected",
+                        "unknown"
+                      ],
+                      "description": "`incomplete` when an expected recording was skipped or unresolved; else `unknown` when a layer declared no expectations; else `complete` when something was expected and `none-expected` when nothing was"
+                    },
+                    "expected": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "published": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991,
+                      "description": "Of the expected recordings, uploaded or referenced by address"
+                    },
+                    "skipped": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "unresolved": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "notApplicable": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "layersWithoutReceipt": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991,
+                      "description": "Layers of the run that declared no recording expectations: nothing is claimed for them"
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "expected",
+                    "published",
+                    "skipped",
+                    "unresolved",
+                    "notApplicable",
+                    "layersWithoutReceipt"
+                  ],
+                  "additionalProperties": {}
+                },
                 "attachments": {
                   "description": "Files attached to the run itself, in its layers, not to a check. Absent when there are none",
                   "type": "integer",
@@ -24233,6 +24471,28 @@
                   ],
                   "additionalProperties": {}
                 }
+              },
+              "recordings": {
+                "description": "Only for runs: `complete`, `incomplete`, `none-expected` and `unknown` with how many runs have each. Absent on servers that predate the filter",
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "value": {
+                      "type": "string"
+                    },
+                    "count": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "required": [
+                    "value",
+                    "count"
+                  ],
+                  "additionalProperties": {}
+                }
               }
             },
             "required": [
@@ -24444,6 +24704,19 @@
                         "type": "boolean",
                         "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                       },
+                      "reason": {
+                        "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                        "type": "string"
+                      },
+                      "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",
@@ -24769,6 +25042,28 @@
                   ],
                   "additionalProperties": {}
                 }
+              },
+              "recordings": {
+                "description": "Only for runs: `complete`, `incomplete`, `none-expected` and `unknown` with how many runs have each. Absent on servers that predate the filter",
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "value": {
+                      "type": "string"
+                    },
+                    "count": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "required": [
+                    "value",
+                    "count"
+                  ],
+                  "additionalProperties": {}
+                }
               }
             },
             "required": [
@@ -25736,6 +26031,12 @@
                     "minimum": 0,
                     "maximum": 9007199254740991,
                     "description": "References that name no bytes, or bytes the layer does not hold"
+                  },
+                  "missing": {
+                    "description": "Of `unavailable`, those that name a file the layer's bundle does not hold (stored, then gone). Absent when there are none",
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991
                   }
                 },
                 "required": [
@@ -25745,6 +26046,64 @@
                 ],
                 "additionalProperties": {}
               },
+              "recordings": {
+                "description": "Whether the recordings its layers expected were published, apart from its outcomes. Absent when no layer declared an expectation: its completeness is unknown, never complete. Matched by the `recordings` filter",
+                "type": "object",
+                "properties": {
+                  "state": {
+                    "type": "string",
+                    "enum": [
+                      "complete",
+                      "incomplete",
+                      "none-expected",
+                      "unknown"
+                    ],
+                    "description": "`incomplete` when an expected recording was skipped or unresolved; else `unknown` when a layer declared no expectations; else `complete` when something was expected and `none-expected` when nothing was"
+                  },
+                  "expected": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "published": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "Of the expected recordings, uploaded or referenced by address"
+                  },
+                  "skipped": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "unresolved": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "notApplicable": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "layersWithoutReceipt": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "Layers of the run that declared no recording expectations: nothing is claimed for them"
+                  }
+                },
+                "required": [
+                  "state",
+                  "expected",
+                  "published",
+                  "skipped",
+                  "unresolved",
+                  "notApplicable",
+                  "layersWithoutReceipt"
+                ],
+                "additionalProperties": {}
+              },
               "attachments": {
                 "description": "Files attached to the run itself, in its layers, not to a check. Absent when there are none",
                 "type": "integer",
@@ -25890,6 +26249,19 @@
                         "type": "boolean",
                         "description": "False when the reference names no bytes: no bundle key, address or inline text, or a bundle key that the layer's own bundle does not hold"
                       },
+                      "reason": {
+                        "description": "Why it is unavailable, when the report can tell: `not-in-bundle` is a file the layer names but does not hold (stored, then gone). An open vocabulary: treat an unknown reason as plain unavailable",
+                        "type": "string"
+                      },
+                      "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",
@@ -26091,6 +26463,12 @@
                       "minimum": 0,
                       "maximum": 9007199254740991,
                       "description": "References that name no bytes, or bytes the layer does not hold"
+                    },
+                    "missing": {
+                      "description": "Of `unavailable`, those that name a file the layer's bundle does not hold (stored, then gone). Absent when there are none",
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
                     }
                   },
                   "required": [

package/packages/visualizer/src/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 });