@crvouga/atlas 0.13.0 → 0.14.0

package/packages/server/openapi.json

@@ -7575,6 +7575,36 @@
                         "modified"
                       ]
                     },
+                    "run": {
+                      "description": "The execution the producer named for it (one local or manual invocation). Grouping and display only; never part of the slot",
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 256,
+                          "description": "The execution's identity within a project, chosen by the producer: a UUID, a timestamped name. Layers with the same id are one run; it never changes after it is recorded"
+                        },
+                        "title": {
+                          "description": "A human name for the run. Presentation only: it is not part of the identity and does not hide the commit or `freshness`",
+                          "type": "string"
+                        },
+                        "startedAtMs": {
+                          "description": "When the execution started, epoch milliseconds",
+                          "type": "number",
+                          "minimum": 0
+                        },
+                        "endedAtMs": {
+                          "description": "When the execution ended, epoch milliseconds",
+                          "type": "number",
+                          "minimum": 0
+                        }
+                      },
+                      "required": [
+                        "id"
+                      ],
+                      "additionalProperties": {}
+                    },
                     "recording": {
                       "anyOf": [
                         {},
@@ -8018,6 +8048,36 @@
                         "modified"
                       ]
                     },
+                    "run": {
+                      "description": "The execution the producer named for it (one local or manual invocation). Grouping and display only; never part of the slot",
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 256,
+                          "description": "The execution's identity within a project, chosen by the producer: a UUID, a timestamped name. Layers with the same id are one run; it never changes after it is recorded"
+                        },
+                        "title": {
+                          "description": "A human name for the run. Presentation only: it is not part of the identity and does not hide the commit or `freshness`",
+                          "type": "string"
+                        },
+                        "startedAtMs": {
+                          "description": "When the execution started, epoch milliseconds",
+                          "type": "number",
+                          "minimum": 0
+                        },
+                        "endedAtMs": {
+                          "description": "When the execution ended, epoch milliseconds",
+                          "type": "number",
+                          "minimum": 0
+                        }
+                      },
+                      "required": [
+                        "id"
+                      ],
+                      "additionalProperties": {}
+                    },
                     "recording": {
                       "anyOf": [
                         {},
@@ -9683,6 +9743,36 @@
               "modified"
             ]
           },
+          "run": {
+            "description": "Name the execution these checks belong to, so repeated local runs at one commit stay separate runs and shards of one execution stay together",
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256,
+                "description": "The execution's identity within a project, chosen by the producer: a UUID, a timestamped name. Layers with the same id are one run; it never changes after it is recorded"
+              },
+              "title": {
+                "description": "A human name for the run. Presentation only: it is not part of the identity and does not hide the commit or `freshness`",
+                "type": "string"
+              },
+              "startedAtMs": {
+                "description": "When the execution started, epoch milliseconds",
+                "type": "number",
+                "minimum": 0
+              },
+              "endedAtMs": {
+                "description": "When the execution ended, epoch milliseconds",
+                "type": "number",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "id"
+            ],
+            "additionalProperties": {}
+          },
           "specs": {
             "default": [],
             "type": "array",
@@ -10171,6 +10261,36 @@
                     "modified"
                   ]
                 },
+                "run": {
+                  "description": "The execution the producer named for it (one local or manual invocation). Grouping and display only; never part of the slot",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 256,
+                      "description": "The execution's identity within a project, chosen by the producer: a UUID, a timestamped name. Layers with the same id are one run; it never changes after it is recorded"
+                    },
+                    "title": {
+                      "description": "A human name for the run. Presentation only: it is not part of the identity and does not hide the commit or `freshness`",
+                      "type": "string"
+                    },
+                    "startedAtMs": {
+                      "description": "When the execution started, epoch milliseconds",
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "endedAtMs": {
+                      "description": "When the execution ended, epoch milliseconds",
+                      "type": "number",
+                      "minimum": 0
+                    }
+                  },
+                  "required": [
+                    "id"
+                  ],
+                  "additionalProperties": {}
+                },
                 "recording": {
                   "anyOf": [
                     {},
@@ -13747,7 +13867,23 @@
               "properties": {
                 "key": {
                   "type": "string",
-                  "description": "The run URL, or `branch@sha`. Pass it to `/api/reports/runs/detail?key=` or `/api/reports/tests?run=`"
+                  "description": "`run:<id>` for an execution a producer named, else the run URL, else `branch@sha`. Pass it to `/api/reports/runs/detail?key=` or `/api/reports/tests?run=`"
+                },
+                "runId": {
+                  "description": "The execution id the producer named, when it did. Layers that share it are one run however many uploads they took",
+                  "type": "string"
+                },
+                "title": {
+                  "description": "The human title of the execution (the newest layer's). Presentation only: the key, commit and `freshness` are unaffected",
+                  "type": "string"
+                },
+                "freshness": {
+                  "description": "`modified` when any layer of the run was recorded from a checkout with uncommitted changes; `unknown` when an origin was not captured; absent when all are clean. Shown beside the commit, never replaced by the title",
+                  "type": "string",
+                  "enum": [
+                    "unknown",
+                    "modified"
+                  ]
                 },
                 "runUrl": {
                   "type": [
@@ -13901,7 +14037,23 @@
             "properties": {
               "key": {
                 "type": "string",
-                "description": "The run URL, or `branch@sha`. Pass it to `/api/reports/runs/detail?key=` or `/api/reports/tests?run=`"
+                "description": "`run:<id>` for an execution a producer named, else the run URL, else `branch@sha`. Pass it to `/api/reports/runs/detail?key=` or `/api/reports/tests?run=`"
+              },
+              "runId": {
+                "description": "The execution id the producer named, when it did. Layers that share it are one run however many uploads they took",
+                "type": "string"
+              },
+              "title": {
+                "description": "The human title of the execution (the newest layer's). Presentation only: the key, commit and `freshness` are unaffected",
+                "type": "string"
+              },
+              "freshness": {
+                "description": "`modified` when any layer of the run was recorded from a checkout with uncommitted changes; `unknown` when an origin was not captured; absent when all are clean. Shown beside the commit, never replaced by the title",
+                "type": "string",
+                "enum": [
+                  "unknown",
+                  "modified"
+                ]
               },
               "runUrl": {
                 "type": [

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

@@ -23,6 +23,19 @@ export function RunsView() {
   const search = useExplorerSearch();
   return search.openRun ? <RunDetailView runKey={search.openRun} /> : <RunTable />;
 }
+/** What a run is called: the title its producer gave it, else its CI run number or `branch@sha`. */
+function runLabel(run: RunSummary): string {
+  return run.title ?? runName(run.key);
+}
+/** Beside a commit: said whenever the run was not recorded from a clean checkout, whatever the run is titled. */
+function Freshness({ run }: { run: RunSummary }) {
+  if (!run.freshness) return null;
+  return (
+    <Text span inherit c="dimmed">
+      {run.freshness === 'modified' ? 'with local changes' : 'origin not captured'}
+    </Text>
+  );
+}
 function Counts({ run }: { run: RunSummary }) {
   return (
     <Text span inherit>
@@ -98,19 +111,24 @@ function RunTable() {
               <Table.Tr key={run.key} data-status={run.counts.failed ? 'failed' : 'passed'}>
                 <Table.Td title={exactTime(run.endedAtMs)}>
                   <Anchor
-                    aria-label={`Open run ${runName(run.key)}`}
+                    aria-label={`Open run ${runLabel(run)}`}
                     renderRoot={(props) => (
                       <Link {...props} to="/" search={patched({ openRun: run.key })} resetScroll={false} activeOptions={{ exact: true }} />
                     )}
                   >
                     {ago(run.endedAtMs, now)}
                   </Anchor>
+                  {run.title && (
+                    <Text c="dimmed" fz="xs">
+                      {run.title}
+                    </Text>
+                  )}
                 </Table.Td>
                 <Table.Td title={run.branch ?? ''} c="dimmed">
                   {run.branch ?? '—'}
                 </Table.Td>
                 <Table.Td>
-                  <Code>{shortSha(run.sha) ?? '—'}</Code>
+                  <Code>{shortSha(run.sha) ?? '—'}</Code> <Freshness run={run} />
                 </Table.Td>
                 <Table.Td>{run.environments.map((env) => environmentLabel(env)).join(', ') || '—'}</Table.Td>
                 <Table.Td>{run.tests}</Table.Td>
@@ -215,10 +233,10 @@ function RunDetailView({ runKey }: { runKey: string }) {
     );
   const { run } = detail.data;
   return (
-    <Box aria-label={`Run ${runName(run.key)}`} component="section" mb="lg">
+    <Box aria-label={`Run ${runLabel(run)}`} component="section" mb="lg">
       {back}
       <Title order={2} mb="sm">
-        Run {runName(run.key)}
+        Run {runLabel(run)}
       </Title>
       <Text component="div">
         {run.branch && (
@@ -227,6 +245,7 @@ function RunDetailView({ runKey }: { runKey: string }) {
           </Text>
         )}
         {run.sha && <Code>{shortSha(run.sha)}</Code>}
+        <Freshness run={run} />
         <Text title={exactTime(run.endedAtMs)} span inherit>
           ended {ago(run.endedAtMs, now)}
         </Text>

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

@@ -21,8 +21,9 @@ export function projectTitle(): string {
       .join(' ') || 'Project reports'
   );
 }
-/** A run key for a person: its CI run number, or `branch@sha` shortened. */
+/** A run key for a person: the execution id a producer named, its CI run number, or `branch@sha` shortened. */
 export function runName(key: string): string {
+  if (key.startsWith('run:')) return key.slice(4);
   const actions = /\/actions\/runs\/(\d+)/.exec(key);
   if (actions) return `#${actions[1]}`;
   if (/^https?:/.test(key)) return key.replace(/^https?:\/\//, '').slice(0, 40);