versioncam 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -6,6 +6,87 @@ and versions follow [semantic versioning](https://semver.org/). While the
 major version is 0, a minor version may change the config or the clip DSL,
 and its entry here says how.
 
+## 0.4.0 (2026-10-05)
+
+A minor version: clips whose app uses CSS transitions record differently.
+
+### Changed
+
+- **CSS transitions play.** Until now the recorder set every transition to
+  zero, so a change landed in the frame after it, and the only motion was
+  the renderer's crossfade at a settle. A change made inside a hold, such as
+  a map zooming on a wheel notch, jumped. Now each transition runs at its
+  authored duration and easing, on the page's own clock, from the frame the
+  recorder first sees it, the same on every run: menus, dialogs and
+  popovers open the way the app wrote them, and a map zooms over its
+  frames. `transitionend` fires on the frame the transition's time runs out,
+  so code that waits for it runs there.
+- **A settle waits for running transitions** to finish, as it waits for
+  requests, so the frame after a settle shows them finished. A settle held up
+  by them names them in `settles.json`: `transitions(1)`.
+- To record as before, set `capture: { transitions: "zero" }` in the config,
+  or in one clip's options. Transitions in an iframe stay zeroed either way,
+  since nothing drives an iframe's clock.
+
+### Security
+
+- The page that renders a recording or a scene now reaches nothing but its
+  own routes. Every request it makes for another origin is refused before
+  it leaves the browser, and every WebSocket is closed before it connects;
+  until now, a WebSocket from the page could reach a port on the machine
+  doing the rendering. A scene that loaded something from elsewhere, such
+  as a web font, renders without it: put what a scene draws in its module.
+
+## 0.3.0 (2026-09-29)
+
+A minor version: a new command, a new config field, and new files beside a
+recording. Clips record exactly what they did before. `versioncam publish`
+is for version.cam's hosted service, which opens with its beta; everything
+else in this version works without it.
+
+### Added
+
+- `versioncam publish` sends the recordings and what their last run said to
+  version.cam, which renders them and keeps them at a living address. It
+  records and renders nothing itself: for each clip the config defines, it
+  sends the recording if the clip's last run passed, or the failure if it
+  did not. Only the screens the service has not seen are uploaded. The
+  credential comes from the environment (`VERSIONCAM_OIDC_TOKEN`, which the
+  versioncam GitHub Action requests, or a project token in
+  `VERSIONCAM_TOKEN`), never from a flag. `--dry-run` prints what would be
+  sent.
+- `--report <file>` on `check`, `render` and `publish` writes what happened
+  as JSON, for a CI step to read instead of parsing what the command
+  printed: each clip's result and the step a failure stopped at, the files a
+  render made, the living URLs a publish made.
+- A recording keeps `targets.json` beside its timeline: where each step's
+  target was when the step began, by the step's index in `steps`. It is
+  what lets a screenshot be cropped to the control a step used.
+- `failure.json` names the step that was running: its index in `steps` and
+  its call, such as `click`.
+- `output.threads` in the config, and `VERSIONCAM_FFMPEG_THREADS` for one
+  run, fix how many threads each encoder uses, so a render made on another
+  machine is the same file.
+- `versioncam/publish`, an entry point with the publish protocol's types and
+  `validateTimeline`, which pulls in nothing that needs Node.
+- `versioncam --version` prints which versioncam this is, for a script that
+  must know before it drives it. The reports of `render` and `publish` carry
+  the version too, and `publish --report` is written when a publish fails,
+  with the error, so a CI step can say why without the log.
+
+### Changed
+
+- A clip that fails before its first step (a saved session the browser
+  refuses, say) now leaves `failure.json` too, with its message and no step,
+  frame or picture, so `check --report` and `publish` say why it failed.
+
+### Fixed
+
+- A render is now the same bytes every time it is made from one recording.
+  The WebM muxer wrote a random id into every file, so two renders of the
+  same recording always differed, and both muxers stamped each file with
+  the ffmpeg build that wrote it.
+
 ## 0.2.0 (2026-09-29)
 
 A minor version: new config fields and new camera methods. A clip whose

package/README.md

@@ -105,10 +105,10 @@ cannot say, that is a missing field. It is not a reason to fork.
 | `viewport` | `{ width: 1440, height: 900 }` | The page's size. The video has the same shape. |
 | `dpr` | `2` | Device pixel ratio, from 1 to 3. At 2, a zoom shows real pixels. |
 | `fps` | `60` | Frames per second, from 10 to 120. |
-| `output` | `{ width: 1920 }` | The video's width. Its height follows the viewport. |
+| `output` | `{ width: 1920 }` | The video's width. Its height follows the viewport. `threads` fixes how many threads each encoder uses: an encoder's bytes depend on it, so a fixed number renders the same recording to the same file on any machine. `VERSIONCAM_FFMPEG_THREADS` sets it for one run. |
 | `auth` | none | How the app signs in: a saved session, `{ storageState }`, or a hook, `{ login }`. |
 | `settle` | `quietMs: 150`, `timeoutMs: 15000`, `yieldMs: 20` | When a page counts as done. `ready` adds a condition of your own. |
-| `capture` | `gate: true`, `forceCaptureEvery: 30` | Which frames get a screenshot. See *Speed*. |
+| `capture` | `gate: true`, `forceCaptureEvery: 30`, `transitions: "play"` | Which frames get a screenshot (see *Speed*), and whether the app's CSS transitions play on its clock or take no time, `"zero"` (see *Determinism*). |
 | `review` | `minSeconds: 9`, `maxSeconds: 11` | How long a clip should run. `versioncam review` holds clips to it. |
 | `cursorStart` | `{ x: 0.72, y: 0.28 }` | Where the cursor rests in the first frame, as fractions of the viewport. |
 | `clock` | `time: "2026-09-01T09:00:00Z"`, `timezoneId: "UTC"`, `locale: "en-GB"` | The instant, time zone and locale the app sees. |
@@ -224,7 +224,7 @@ test holds that list to the session's code. The same reference is
 | `title` | required | The clip's name, kept in its timeline. It is not drawn: write a caption with `s.caption`. |
 | `seed` | `1` | Seeds the jitter in cursor paths, dwells and typing. A new seed is a new take of the same script. |
 | `viewport`, `dpr`, `fps` | the config's | For a clip that needs a different shape. |
-| `capture` | the config's | A clip that films a canvas sets `{ forceCaptureEvery: 1 }` here. |
+| `capture` | the config's | A clip that films a canvas sets `{ forceCaptureEvery: 1 }` here, and one whose app animates in ways better left out sets `{ transitions: "zero" }`. |
 
 ### The camera
 
@@ -320,6 +320,7 @@ the wreckage would help nobody.
 versioncam record [id…]            drive the app and capture frames
     --draft                        15fps at CSS scale: cheap, for writing clips
 versioncam check [id…]             record every clip; exit 1 if any breaks
+    --report <file>                and write each clip's result there, as JSON
 versioncam stability [id…]         record each clip twice the same way; stable or not
     --runs <n>                     how many times (default 2)
     --full                         at full quality rather than draft
@@ -362,6 +363,31 @@ versioncam render [id…]            composite and encode recordings and scenes
                                    no ids: every one, stale recordings included
     --scene <id>                   and this scene, whatever the ids say (repeatable)
     --sequence                     stitch the results into one piece
+    --report <file>                and write what it made there, as JSON
+```
+
+### Publish
+
+Send what the last run recorded to [version.cam](https://version.cam), which
+renders it and keeps it at a living address. `publish` records nothing and
+renders nothing: for each clip the config defines, it sends the recording if
+the clip's last run passed, or the failure if it did not, so a clip that
+broke says so on every page that embeds it. Only the states the service has
+not seen are uploaded, so a version that changed one screen sends one
+screen.
+
+It needs a credential in the environment, never on the command line:
+`VERSIONCAM_OIDC_TOKEN`, which the versioncam GitHub Action requests from
+GitHub for the run (no secret to store), or `VERSIONCAM_TOKEN`, a project
+token from version.cam for any other CI. `VERSIONCAM_API` points it
+somewhere other than `https://api.version.cam`. Outside GitHub Actions it
+reads the commit and branch from git; `VERSIONCAM_COMMIT` and
+`VERSIONCAM_BRANCH` set them outright.
+
+```
+versioncam publish [id…]           send the recordings and their checks to version.cam
+    --dry-run                      print what would be sent, and send nothing
+    --report <file>                and write the living URLs there, as JSON
 ```
 
 ### From another directory
@@ -380,6 +406,7 @@ running, and says to `cd` into it instead.
 
 ```
 versioncam <command> --cwd <dir>   as if run in <dir>, which holds versioncam.config.ts
+versioncam --version               which versioncam this is
 ```
 
 ## What a recording leaves behind
@@ -391,8 +418,9 @@ versioncam <command> --cwd <dir>   as if run in <dir>, which holds versioncam.co
 | `timeline.json` | Everything the renderer needs, and everything a reviewer can check. |
 | `states/` | The page states the timeline indexes, one image each. |
 | `settles.json` | Every wait: what it was still blocked on, and how long it really took. |
+| `targets.json` | Where each step's target was when the step began, by the step's index in `steps`: the box of the control it used. New in 0.3.0. |
 | `failure.png` | Only after a failure: the page at the moment the clip gave up. |
-| `failure.json` | Only after a failure: the message, the frame and the authored second. |
+| `failure.json` | Only after a failure: the message, the frame, the authored second, and the step that was running (its index in `steps` and its call; new in 0.3.0). |
 
 The timeline's `frames` say which state each frame shows. Beside them are the
 tracks the renderer draws: `cursor`, `pointer`, `camera`, `highlights` and
@@ -470,8 +498,8 @@ how long that loop takes.
 moved. The screenshot is by far the most expensive thing a frame does: 25 ms,
 against half a millisecond for everything else. So the driver takes one only
 when the page can have changed. That is when the DOM mutated, the element
-under the cursor changed, an animation is running, input was just sent, or
-`forceCaptureEvery` frames have gone by. On the example app that skips 81% to
+under the cursor changed, an animation or a transition is running, input was
+just sent, or `forceCaptureEvery` frames have gone by. On the example app that skips 81% to
 95% of frames, and the recording is identical either way. A test records every
 clip both ways on every push and compares the bytes. The failure it guards
 against is not a crash but a video that is quietly wrong.
@@ -586,6 +614,12 @@ package's own tests assert it for capture and for rendering on every change,
 on macOS and on Linux. A golden recording pins the capture path against
 changes nobody meant to make.
 
+A render is the same bytes every time it is made from one recording, on one
+ffmpeg build, with one encoder thread count. The thread count otherwise
+follows the machine's cores, so a render that must match another machine's
+fixes it with `output.threads` or `VERSIONCAM_FFMPEG_THREADS`. Before 0.3.0
+every WebM carried a random id and no two were the same file.
+
 Across machines the claim is narrower. The **timeline** is identical: it is
 what the driver decided, and nothing in it depends on the host. The captured
 **pixels** are identical only where the rendering environment is. macOS and
@@ -598,6 +632,30 @@ If two recordings of your clip on one machine differ, something outside the
 authored clock reached a frame: an unwarmed resource, a real timer, a font
 that had not finished loading. Find the cause. The next section is how.
 
+### The app's own motion
+
+The page runs on a fake clock that moves only when the recorder moves it: a
+frame's worth at a time while frames are made, and in small ticks while a
+settle waits. The app's timers and animation frames run on it, and so does
+its CSS motion:
+
+- **Transitions play** at their authored duration and easing, on the page's
+  clock, from the frame the recorder first sees each one. A menu fades in, a
+  drawer slides, a map zooms over its frames, and `transitionend` fires on
+  the frame its time runs out. A settle waits until none is running, so the
+  frame after it shows them finished. `capture: { transitions: "zero" }`
+  makes them take no time instead, as before 0.4.0, in the config or in one
+  clip.
+- **Animations are scrubbed** by the clip's time: a spinner turns at the rate
+  the video plays, whatever the machine is doing. The scrub counts from the
+  clip's start, not the animation's, so a one-off animation that starts
+  partway through a clip shows its end.
+- **Not on the clock:** animations a script makes with `element.animate()`,
+  Chromium's smooth scrolling of a mouse wheel, and transitions inside an
+  iframe, which stay zeroed since nothing drives an iframe's clock. A clip
+  that films one of the first two may differ between runs: `stability` says
+  so.
+
 ### When a clip will not reproduce
 
 The recorder can only be as deterministic as the app it films. An app that is

package/dist/cli/commands/check.js

@@ -1,8 +1,13 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { launchBrowser } from "../../driver/launch.js";
-import { runClip } from "../../driver/clip.js";
+import { RECORDER_VERSION, runClip } from "../../driver/clip.js";
 import { loadClips, loadConfig } from "../../loader.js";
 import { drivingApp } from "../app.js";
+import { ensureFailure } from "../../driver/reports.js";
+import { FAILURE_JSON, FAILURE_PNG, } from "../../driver/reports.js";
+import { writeReport } from "./publish.js";
 /**
  * Record every clip and report which still work.
  *
@@ -11,20 +16,22 @@ import { drivingApp } from "../app.js";
  * longer exists, and encoding a video of the wreckage helps nobody.
  */
 export async function check(argv) {
-    const { positionals } = parseArgs({
+    const { positionals, values } = parseArgs({
         args: argv,
+        options: { report: { type: "string" } },
         strict: false,
         allowPositionals: true,
     });
+    const reportPath = typeof values.report === "string" ? resolve(values.report) : null;
     const config = await loadConfig(process.cwd());
     const clips = await loadClips(config, positionals);
     if (clips.length === 0) {
         process.stderr.write("No clips to check.\n");
         return 1;
     }
-    return drivingApp(config, () => checkAll(config, clips));
+    return drivingApp(config, () => checkAll(config, clips, reportPath));
 }
-async function checkAll(config, clips) {
+async function checkAll(config, clips, reportPath) {
     const browser = await launchBrowser();
     const failures = [];
     try {
@@ -35,6 +42,7 @@ async function checkAll(config, clips) {
             }
             catch (error) {
                 failures.push({ id: clip.id, error: error });
+                ensureFailure(join(config.recordingsDir, clip.id), error);
                 process.stdout.write(`FAIL  ${clip.id}\n`);
             }
         }
@@ -46,6 +54,39 @@ async function checkAll(config, clips) {
     for (const { id, error } of failures) {
         process.stderr.write(`\n${id}\n  ${error.message}\n`);
     }
+    if (reportPath) {
+        writeReport(reportPath, checkReport(config, clips, failures));
+    }
     return failures.length > 0 ? 1 : 0;
 }
+/**
+ * What `--report` writes: each clip's result, the step a failure stopped at,
+ * and where its picture is, for a machine to read. The Action builds its pull
+ * request comment from this, so it never has to parse what `check` prints or
+ * guess where the recordings directory is.
+ */
+function checkReport(config, clips, failures) {
+    return {
+        recorder: RECORDER_VERSION,
+        clips: clips.map((clip) => {
+            const failed = failures.find((f) => f.id === clip.id);
+            if (!failed)
+                return { id: clip.id, status: "pass" };
+            const dir = join(config.recordingsDir, clip.id);
+            const written = join(dir, FAILURE_JSON);
+            const failure = existsSync(written)
+                ? JSON.parse(readFileSync(written, "utf8"))
+                : null;
+            const picture = join(dir, FAILURE_PNG);
+            return {
+                id: clip.id,
+                status: "fail",
+                message: failed.error.message,
+                step: failure?.step ?? null,
+                t: failure?.t ?? null,
+                picture: existsSync(picture) ? picture : null,
+            };
+        }),
+    };
+}
 //# sourceMappingURL=check.js.map

package/dist/cli/commands/check.js.map

@@ -1 +1 @@
-{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc;IACxC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QAChC,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,WAAuB,CAAC,CAAC;IAE/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,MAAsB,EACtB,KAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAmC,EAAE,CAAC;IAEpD,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;gBACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC,CAAC;gBACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,+BAA+B,CACnF,CAAC;IACF,KAAK,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/publish.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Send the recordings, and what their last run said, to version.cam.
+ *
+ * It records nothing and renders nothing. It reads what `check`, `record` or
+ * `stability` left in the recordings directory, for the clips the config
+ * defines today (a recording of a clip since renamed or deleted is left
+ * behind), and publishes each one's latest word: a complete recording that
+ * passed, or the failure that stopped it. The service renders the rest.
+ *
+ * The credential comes from the environment, never from a flag, so it
+ * cannot end up in a shell history or a CI log line:
+ * `VERSIONCAM_OIDC_TOKEN` is the GitHub token the Action requests, and
+ * `VERSIONCAM_TOKEN` is a project token for any other CI.
+ */
+export declare function publish(argv: string[]): Promise<number>;
+/** Written for a machine: the Action reads it for the job summary. */
+export declare function writeReport(path: string, report: unknown): void;

package/dist/cli/commands/publish.js

@@ -0,0 +1,203 @@
+import { execFileSync } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { RECORDER_VERSION } from "../../driver/clip.js";
+import { loadClips, loadConfig } from "../../loader.js";
+import { publishRecordings, PublishRefused, } from "../../publish/client.js";
+import { publishedRenderConfig, readClip, } from "../../publish/manifest.js";
+import { DEFAULT_API, PUBLISH_PROTOCOL, } from "../../publish/protocol.js";
+/**
+ * Send the recordings, and what their last run said, to version.cam.
+ *
+ * It records nothing and renders nothing. It reads what `check`, `record` or
+ * `stability` left in the recordings directory, for the clips the config
+ * defines today (a recording of a clip since renamed or deleted is left
+ * behind), and publishes each one's latest word: a complete recording that
+ * passed, or the failure that stopped it. The service renders the rest.
+ *
+ * The credential comes from the environment, never from a flag, so it
+ * cannot end up in a shell history or a CI log line:
+ * `VERSIONCAM_OIDC_TOKEN` is the GitHub token the Action requests, and
+ * `VERSIONCAM_TOKEN` is a project token for any other CI.
+ */
+export async function publish(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            "dry-run": { type: "boolean", default: false },
+            report: { type: "string" },
+        },
+        strict: false,
+        allowPositionals: true,
+    });
+    const ids = positionals;
+    const dryRun = values["dry-run"] === true;
+    const reportPath = typeof values.report === "string" ? resolve(values.report) : null;
+    const config = await loadConfig(process.cwd());
+    const clips = await loadClips(config);
+    const unknown = ids.filter((id) => !clips.some((clip) => clip.id === id));
+    if (unknown.length > 0) {
+        process.stderr.write(`No clip is called ${unknown.join(", ")}. The clips are: ${clips.map((c) => c.id).join(", ") || "none"}.\n`);
+        return 1;
+    }
+    const renderConfig = publishedRenderConfig(config);
+    const manifests = [];
+    const files = new Map();
+    const unrecorded = [];
+    for (const clip of clips) {
+        if (ids.length > 0 && !ids.includes(clip.id))
+            continue;
+        const read = readClip(join(config.recordingsDir, clip.id), { id: clip.id, title: clip.options.title ?? "" }, renderConfig);
+        if (!read) {
+            unrecorded.push(clip.id);
+            continue;
+        }
+        manifests.push(read.manifest);
+        files.set(clip.id, read.files);
+    }
+    if (unrecorded.length > 0) {
+        process.stderr.write(`Not recorded here, so not published: ${unrecorded.join(", ")}. ` +
+            "Run `versioncam check` or `versioncam record` first.\n");
+    }
+    if (manifests.length === 0) {
+        process.stderr.write("Nothing to publish.\n");
+        return 1;
+    }
+    const where = provenance(config.root);
+    const begin = {
+        protocol: PUBLISH_PROTOCOL,
+        recorder: RECORDER_VERSION,
+        project: process.env.GITHUB_REPOSITORY ?? null,
+        ...where,
+        clips: manifests,
+    };
+    if (dryRun) {
+        process.stdout.write(`${JSON.stringify(begin, null, 2)}\n`);
+        return 0;
+    }
+    const credential = process.env.VERSIONCAM_OIDC_TOKEN || process.env.VERSIONCAM_TOKEN;
+    if (!credential) {
+        process.stderr.write("publish needs a credential in the environment: VERSIONCAM_OIDC_TOKEN, " +
+            "which the versioncam Action requests from GitHub, or VERSIONCAM_TOKEN, " +
+            "a project token from version.cam for any other CI.\n");
+        return 1;
+    }
+    const api = process.env.VERSIONCAM_API || DEFAULT_API;
+    try {
+        const { begun, committed } = await publishRecordings(begin, filesFor(files), {
+            api,
+            credential,
+            log: (line) => process.stdout.write(`${line}\n`),
+        });
+        process.stdout.write(`Published to ${api} as ${committed.project}:\n`);
+        for (const version of committed.versions) {
+            process.stdout.write(`  ${describe(version)}\n`);
+        }
+        for (const refusal of begun.refused) {
+            process.stderr.write(`  ${refusal.clip}: ${refusal.reason}\n`);
+        }
+        if (reportPath) {
+            writeReport(reportPath, {
+                recorder: RECORDER_VERSION,
+                api,
+                project: committed.project,
+                versions: committed.versions,
+                refused: begun.refused,
+                error: null,
+            });
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof PublishRefused
+            ? `version.cam refused the publish: ${error.message}`
+            : `publish failed: ${error.message}`;
+        process.stderr.write(`${message}\n`);
+        // A CI step reading the report learns what went wrong without the log.
+        if (reportPath) {
+            writeReport(reportPath, {
+                recorder: RECORDER_VERSION,
+                api,
+                project: null,
+                versions: [],
+                refused: [],
+                error: message,
+            });
+        }
+        return 1;
+    }
+}
+function describe(version) {
+    if (version.check === "fail") {
+        return `${version.clip}: failed its check, ${version.stale ? "stale" : "recorded"} at ${version.versionUrl}`;
+    }
+    const unchanged = version.unchanged ? " (unchanged)" : "";
+    const refused = version.refused ? ` (not stored: ${version.refused})` : "";
+    return `${version.clip}: ${version.url}${unchanged}${refused}`;
+}
+/**
+ * Which commit and branch these recordings are of. In GitHub Actions the
+ * service reads all of this from its own token and only checks these; for
+ * any other CI they are the whole story, so they can be set outright.
+ */
+function provenance(root) {
+    const env = process.env;
+    const git = (...args) => {
+        try {
+            return execFileSync("git", args, {
+                cwd: root,
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+            }).trim();
+        }
+        catch {
+            return "";
+        }
+    };
+    const commit = env.VERSIONCAM_COMMIT || env.GITHUB_SHA || git("rev-parse", "HEAD");
+    const branch = env.VERSIONCAM_BRANCH ||
+        env.GITHUB_HEAD_REF ||
+        env.GITHUB_REF_NAME ||
+        git("rev-parse", "--abbrev-ref", "HEAD");
+    const ref = env.GITHUB_REF || (branch ? `refs/heads/${branch}` : "");
+    if (!commit || !branch) {
+        throw new Error("publish could not tell which commit and branch these recordings are of. " +
+            "Run it in a git checkout, or set VERSIONCAM_COMMIT and VERSIONCAM_BRANCH.");
+    }
+    return { commit, branch, ref, runId: env.GITHUB_RUN_ID || null };
+}
+function filesFor(files) {
+    const statePath = (hash) => {
+        for (const recording of files.values()) {
+            const path = recording.states.get(hash);
+            if (path)
+                return path;
+        }
+        throw new Error(`the service asked for a state no recording has: ${hash}`);
+    };
+    const of = (clip) => {
+        const recording = files.get(clip);
+        if (!recording)
+            throw new Error(`the service asked about an unknown clip: ${clip}`);
+        return recording;
+    };
+    const required = (bytes, what) => {
+        if (!bytes)
+            throw new Error(`the service asked for ${what}, which is not there`);
+        return bytes;
+    };
+    return {
+        state: async (hash) => readFile(statePath(hash)),
+        timeline: async (clip) => of(clip).timeline,
+        targets: async (clip) => required(of(clip).targets, `${clip}'s targets`),
+        failure: async (clip) => required(of(clip).failure, `${clip}'s failure picture`),
+    };
+}
+/** Written for a machine: the Action reads it for the job summary. */
+export function writeReport(path, report) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(report, null, 2)}\n`);
+}
+//# sourceMappingURL=publish.js.map

package/dist/cli/commands/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/cli/commands/publish.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/record.js

@@ -6,6 +6,7 @@ import { runClip } from "../../driver/clip.js";
 import { formatTiming } from "../../core/timing.js";
 import { loadClips, loadConfig } from "../../loader.js";
 import { drivingApp } from "../app.js";
+import { ensureFailure } from "../../driver/reports.js";
 /**
  * Record every clip the config points at, serially.
  *
@@ -57,6 +58,7 @@ async function recordAll(config, clips, draft) {
             }
             catch (error) {
                 failures.push({ id: clip.id, error: error });
+                ensureFailure(join(config.recordingsDir, clip.id), error);
                 process.stdout.write(`  ${clip.id}: FAILED\n`);
             }
         }

package/dist/cli/commands/record.js.map

@@ -1 +1 @@
-{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/cli/commands/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvD,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,WAAuB,CAAC,CAAC;IAE/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,WAAW,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,mBAAmB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YAChD,CAAC,CAAC,wCAAwC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,IAAI,KAAK,CAC9F,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,MAAsB,EACtB,KAAuB,EACvB,KAAc;IAEd,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAmC,EAAE,CAAC;IAEpD,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;oBAC9D,KAAK;iBACN,CAAC,CAAC;gBACH,uEAAuE;gBACvE,kEAAkE;gBAClE,sEAAsE;gBACtE,kEAAkE;gBAClE,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAClE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxD,MAAM,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;gBACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,cAAc,WAAW;oBAC3E,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,YAAY,IAAI,GAAG;oBAC5C,WAAW,KAAK,YAAY,IAAI,KAAK;oBACrC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAChC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC,CAAC;gBACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;YACrC,wEAAwE;YACxE,qEAAqE;YACrE,uEAAuE;YACvE,oEAAoE;YACpE,yEAAyE;YACzE,yEAAyE;YACzE,0DAA0D;YAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC;gBAC9B,CAAC,CAAC,iCAAiC,IAAI,EAAE;gBACzC,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,OAAO,GAAG,OAAO,MAAM,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/cli/commands/record.ts"],"names":[],"mappings":"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"}