@outerlayer/cli 0.33.0-next.20261023003700 → 0.33.0-next.20261023120437

package/dist/{emit-demo-cmd-6DF2QIAS.js → emit-demo-cmd-IQRS7BP2.js}

@@ -1,19 +1,20 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { runEmitArtifact } from './chunk-6Z4SZHV2.js';
-import './chunk-2N67C6IV.js';
-import './chunk-AU346ENF.js';
+import { readNewestDemo } from './chunk-ER6KQCVJ.js';
+import { runEmitArtifact } from './chunk-QKNFU5GA.js';
+import './chunk-D3EDZPJR.js';
+import './chunk-7UPMYRPS.js';
 import './chunk-ESVW4MJY.js';
 import './chunk-TBT347UY.js';
 import { VoiceDownloadError, downloadPinned, sha256OfFile } from './chunk-2PGI6RDE.js';
 import { VOICE_PACK_FILES, VOICE_PACK_VERSION } from './chunk-NE63JADS.js';
 import { detectActiveSession } from './chunk-IP7BIBXJ.js';
-import { autoConnect } from './chunk-B2JURP6A.js';
-import './chunk-2WMZPJVE.js';
-import './chunk-EWVYQLD3.js';
-import { resolveRepoIdentity } from './chunk-5DNCFOXA.js';
-import './chunk-HJYBWJAS.js';
-import './chunk-NSPRS7WK.js';
+import { autoConnect } from './chunk-HLZMAJJD.js';
+import './chunk-S5CNYXUA.js';
+import './chunk-MPC2UAW2.js';
+import { resolveRepoIdentity } from './chunk-NIY2UBT6.js';
+import './chunk-LYGI3T66.js';
+import './chunk-7V5GUEDU.js';
 import './chunk-G2JWZDFA.js';
 import { C } from './chunk-ANPNT6PM.js';
 import { defaultFetch, resolveGatewayCredentials } from './chunk-6RKD7YZ6.js';
@@ -21,13 +22,13 @@ import './chunk-PJDQPF5N.js';
 import './chunk-SOI6K5DY.js';
 import './chunk-PA6CK6WQ.js';
 import './chunk-BALIE3BA.js';
-import './chunk-QPWFVE3X.js';
+import './chunk-UK4RGH46.js';
 import './chunk-ZJSNLVCE.js';
 import './chunk-2O5KA67H.js';
 import './chunk-BKO6JEZI.js';
 import './chunk-HCVLP7XA.js';
 import './chunk-BJ3KTMDH.js';
-import './chunk-G63KT5I5.js';
+import './chunk-44V5SD4G.js';
 import './chunk-5BHIBJDA.js';
 import './chunk-CDDED64E.js';
 import './chunk-RA3O54FC.js';
@@ -36,16 +37,16 @@ import './chunk-WZBHBH3J.js';
 import './chunk-CRB3POP4.js';
 import './chunk-URIZRCRY.js';
 import './chunk-TUSYOL2O.js';
-import './chunk-LJG6EMLJ.js';
-import { ARTIFACT_MAX_BYTES, ARTIFACT_MAX_CAPTION_LENGTH, DEMO_RECORD_MEDIA_TYPE, DemoManifestSchema } from './chunk-E6CO3MJE.js';
+import './chunk-6CXNWKWD.js';
+import { ARTIFACT_MAX_BYTES, ARTIFACT_MAX_CAPTION_LENGTH, DEMO_RECORD_MEDIA_TYPE, ARTIFACT_MAX_REPLACES_TARGETS, DemoManifestSchema, ARTIFACT_KINDS } from './chunk-F2D5BSXS.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-HACGUL52.js';
 import './chunk-MESOOLF4.js';
 import { __commonJS, __require, __toESM } from './chunk-Z5GEFMRW.js';
 import { createHash } from 'crypto';
-import { mkdtempSync, statSync, readFileSync, writeFileSync, rmSync, mkdirSync, accessSync, constants, realpathSync, existsSync, createReadStream, createWriteStream } from 'fs';
+import { mkdtempSync, writeFileSync, statSync, readFileSync, rmSync, mkdirSync, accessSync, constants, realpathSync, existsSync, createReadStream, createWriteStream } from 'fs';
 import { tmpdir } from 'os';
-import { resolve, dirname, join, delimiter, normalize, sep } from 'path';
+import { resolve, dirname, join, relative, sep, isAbsolute, delimiter, normalize } from 'path';
 import { execFileSync } from 'child_process';
 import { createRequire as createRequire$1 } from 'module';
 import { createGunzip } from 'zlib';
@@ -2155,16 +2156,16 @@ function checkManifest(params) {
 var import_pngjs = __toESM(require_png(), 1);
 var StillError = class extends Error {
 };
-function readStill(dir, file, sha256) {
+function readStill(dir, file, sha256, what = "still") {
   const path = resolve(dir, file);
   let bytes;
   try {
     bytes = readFileSync(path);
   } catch (err) {
-    throw new StillError(`cannot read the still "${file}" (${path}): ${err instanceof Error ? err.message : String(err)}`);
+    throw new StillError(`cannot read the ${what} "${file}" (${path}): ${err instanceof Error ? err.message : String(err)}`);
   }
   if (createHash("sha256").update(bytes).digest("hex") !== sha256) {
-    throw new StillError(`the still "${file}" does not match the SHA-256 in its manifest \u2014 the file changed after the run`);
+    throw new StillError(`the ${what} "${file}" does not match the SHA-256 in its manifest \u2014 the file changed after the run`);
   }
   return bytes;
 }
@@ -2258,7 +2259,7 @@ function compareChapters(params) {
 }
 
 // src/demo/criteria.ts
-async function readRecordedCriteriaIds(params) {
+async function readRecordedCriteria(params) {
   const endpoint = new URL(`/v1/work-items/${params.item}`, params.url).toString();
   const response = await params.fetchImpl(endpoint, {
     method: "GET",
@@ -2268,7 +2269,12 @@ async function readRecordedCriteriaIds(params) {
   const body = await response.json();
   const items = body.data?.criteria?.items;
   if (!Array.isArray(items)) return void 0;
-  return new Set(items.flatMap((entry) => typeof entry.id === "string" ? [entry.id] : []));
+  const kinds = ARTIFACT_KINDS;
+  return new Map(
+    items.flatMap(
+      (entry) => typeof entry.id === "string" ? [[entry.id, kinds.includes(entry.proof) ? entry.proof : null]] : []
+    )
+  );
 }
 
 // src/demo/fit.ts
@@ -2432,6 +2438,36 @@ function createMediaTools(env, exec = execFileSync) {
   };
 }
 
+// src/demo/screenshots.ts
+function frameOf(chapter) {
+  return "screenshot" in chapter ? chapter.screenshot : void 0;
+}
+function planScreenshots(params) {
+  const { manifest, proofs } = params;
+  return manifest.chapters.map((chapter) => {
+    const id = chapter.criterionId;
+    if (id === null) return void 0;
+    const frame = frameOf(chapter);
+    const declared = proofs?.get(id) ?? null;
+    if (frame === void 0 && declared !== "screenshot") return void 0;
+    if (proofs === void 0) return { skip: "the item's criteria could not be read, so no screenshot is bound" };
+    if (frame === void 0) return { skip: `calls no demo.screenshot(), so no screenshot is bound to ${id}` };
+    if (declared !== "screenshot") {
+      return { skip: `${id} declares ${declared === null ? "no proof" : declared}, not screenshot, so the frame is not stored` };
+    }
+    if (chapter.checks.length === 0) return { skip: "ran no checks, so the frame is not stored" };
+    if (chapter.checks.some((check) => !check.passed)) return { skip: "a check failed, so the frame is not stored" };
+    return { bind: frame };
+  });
+}
+function screenshotCaption(index, chapter, frame) {
+  const head = `Demo chapter ${index + 1} screenshot: ${chapter.title}, after "`;
+  const tail = `"${frame.masked ? ", with masks" : ""}`;
+  const room = Math.max(1, ARTIFACT_MAX_CAPTION_LENGTH - head.length - tail.length);
+  const text = chapter.checks[frame.check].text;
+  return `${head}${text.length <= room ? text : `${text.slice(0, room - 1)}\u2026`}${tail}`;
+}
+
 // src/demo/record.ts
 function chapterPassed(checks) {
   return checks.length > 0 && checks.every((check) => check.passed);
@@ -2445,6 +2481,8 @@ function buildDemoRecord(manifest, video, stored, comparisons) {
   }
   return {
     schemaVersion: 3,
+    // Only a manifest of version 3 or later names its test. An older one stores a record with no test.
+    ..."test" in manifest ? { test: manifest.test } : {},
     video,
     chapters: manifest.chapters.map((chapter, index) => {
       const comparison = comparisons[index];
@@ -2460,11 +2498,17 @@ function buildDemoRecord(manifest, video, stored, comparisons) {
         bound: stored[index].bound,
         comparable: comparison.comparable,
         stills: comparison.stills,
-        ...comparison.difference === void 0 ? {} : { difference: comparison.difference }
+        ...comparison.difference === void 0 ? {} : { difference: comparison.difference },
+        ...recordedFrame(chapter, stored[index])
       };
     })
   };
 }
+function recordedFrame(chapter, stored) {
+  const frame = frameOf(chapter);
+  if (frame === void 0 || stored.screenshot === void 0) return {};
+  return { screenshot: { artifactId: stored.screenshot.artifactId, check: frame.check, sha256: frame.sha256, fullPage: frame.fullPage, masked: frame.masked } };
+}
 var PUNCTUATION = ';:,.!?\xA1\xBF\u2014\u2026"\xAB\xBB\u201C\u201D(){}[]';
 var PUNCTUATION_RUN = new RegExp(`(\\s*[${PUNCTUATION.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}]+\\s*)+`, "g");
 function splitYear(text) {
@@ -2647,9 +2691,9 @@ async function extractNpmTarball(tarball, destDir, keep = () => true) {
     padding = (BLOCK - entry.size % BLOCK) % BLOCK;
     collected = [];
     if (entry.type !== "0" && entry.type !== "\0") return;
-    const relative = entry.path.split("/").slice(1).join("/");
-    if (relative === "" || !keep(relative)) return;
-    const target = normalize(join(destDir, relative));
+    const relative2 = entry.path.split("/").slice(1).join("/");
+    if (relative2 === "" || !keep(relative2)) return;
+    const target = normalize(join(destDir, relative2));
     if (!target.startsWith(normalize(destDir) + sep)) throw new Error(`the archive has a path outside its folder: ${entry.path}`);
     mkdirSync(dirname(target), { recursive: true });
     sink = createWriteStream(target, { mode: 493 });
@@ -2843,7 +2887,10 @@ async function runEmitDemo(opts) {
   }
   const fetchImpl = opts.fetchImpl ?? defaultFetch;
   const media = opts.media ?? createMediaTools(env);
-  const recordedIds = await recordedCriteria({ opts, env, cwd, home, fetchImpl, say });
+  const item = resolveItem({ opts, env, cwd, home });
+  const retiring = opts.replaces === void 0 ? void 0 : await readRetiring({ opts, item, env, cwd, home, fetchImpl });
+  const proofs = await recordedCriteria({ opts, item, env, cwd, home, fetchImpl, say });
+  const recordedIds = proofs === void 0 ? void 0 : new Set(proofs.keys());
   let videoSeconds;
   try {
     videoSeconds = media.probe(videoPath);
@@ -2852,8 +2899,16 @@ async function runEmitDemo(opts) {
   }
   const problem = checkManifest({ manifest, videoSeconds, recordedIds });
   if (problem !== void 0) throw new EmitDemoError(problem);
+  const manifestDir = dirname(manifestPath);
+  const frames = decideFrames({ manifest, proofs, dir: manifestDir, say });
   const work = mkdtempSync(join(tmpdir(), "outerlayer-demo-"));
   try {
+    const framePaths = frames.map((frame, index) => {
+      if (frame.kind !== "bind") return void 0;
+      const path = join(work, `screenshot-${index + 1}.png`);
+      writeFileSync(path, frame.bytes);
+      return path;
+    });
     const speaker = narrated ? opts.speaker ?? await realSpeaker({ env, home, work, say, installedRoot: opts.installedVoiceRoot }) : void 0;
     const spoken = [];
     for (const [index, chapter] of manifest.chapters.entries()) {
@@ -2944,7 +2999,15 @@ async function runEmitDemo(opts) {
         bound: bound[index]
       }));
     }
-    const plannedRecord = JSON.stringify(buildDemoRecord(manifest, video, stored, comparisons));
+    const frameIds = frames.map((frame) => frame.kind === "bind" ? idFor(`screenshot-${frame.index + 1}`, framePaths[frame.index]) : void 0);
+    const plannedRecord = JSON.stringify(
+      buildDemoRecord(
+        manifest,
+        video,
+        withFrames(stored, frameIds),
+        comparisons
+      )
+    );
     const recordBytes = Buffer.byteLength(plannedRecord);
     if (recordBytes > ARTIFACT_MAX_BYTES) {
       throw new EmitDemoError(
@@ -2964,7 +3027,8 @@ async function runEmitDemo(opts) {
       env,
       fetchImpl: opts.fetchImpl
     };
-    const total = manifest.chapters.length + (wholeFits ? 1 : 0) + 1;
+    const replacing = retiring === void 0 ? void 0 : planReplaces(retiring, manifest, wholeFits, frames.map((frame) => frame.kind === "bind"));
+    const total = manifest.chapters.length + (wholeFits ? 1 : 0) + 1 + frameIds.filter((id) => id !== void 0).length;
     const unit = "artifacts";
     let emitted = 0;
     const emitStep = async (params) => {
@@ -2977,12 +3041,15 @@ async function runEmitDemo(opts) {
         file: wholePlan.output,
         artifactId: video.artifactId,
         caption: `Demo: ${manifest.chapters.length} chapter${manifest.chapters.length === 1 ? "" : "s"}, ${(wholePlan.end - wholePlan.start).toFixed(1)} s`,
-        blobOptional: true
+        blobOptional: true,
+        ...replaceOption(replacing?.video)
       });
       video = { artifactId: artifactIdOf(wholeResult) };
     }
     const failures = [];
     const clips = [];
+    const screenshots = [];
+    const storedFrames = [];
     for (const [index, chapter] of manifest.chapters.entries()) {
       const failed = chapter.checks.filter((check) => !check.passed);
       if (failed.length > 0) {
@@ -2999,8 +3066,27 @@ async function runEmitDemo(opts) {
         caption: caption.slice(0, ARTIFACT_MAX_CAPTION_LENGTH),
         ...bound[index] ? { criterionId: chapter.criterionId } : {},
         ...wholeFits ? { range: stored[index].range } : {},
-        blobOptional: true
+        blobOptional: true,
+        ...replaceOption(replacing?.chapters[index])
       });
+      const frame = frames[index];
+      if (frame.kind === "bind") {
+        const shot = await emitStep({
+          file: framePaths[index],
+          filename: `screenshot-${String(index + 1).padStart(2, "0")}.png`,
+          mediaType: "image/png",
+          artifactId: frameIds[index],
+          caption: screenshotCaption(index, chapter, frame.frame),
+          criterionId: chapter.criterionId,
+          blobOptional: true,
+          ...replaceOption(replacing?.screenshots[index])
+        });
+        storedFrames.push({ artifactId: artifactIdOf(shot) });
+        screenshots.push({ chapter: index + 1, criterionId: chapter.criterionId, artifactId: artifactIdOf(shot) });
+      } else {
+        storedFrames.push(void 0);
+        if (frame.kind === "skip") screenshots.push({ chapter: index + 1, criterionId: chapter.criterionId, reason: frame.reason });
+      }
       clips.push({
         clipArtifactId: artifactIdOf(result),
         bound: bound[index],
@@ -3012,7 +3098,10 @@ async function runEmitDemo(opts) {
     const record = buildDemoRecord(
       manifest,
       video,
-      clips.map((clip) => ({ artifactId: clip.clipArtifactId, range: clip.range, bound: clip.bound })),
+      withFrames(
+        clips.map((clip) => ({ artifactId: clip.clipArtifactId, range: clip.range, bound: clip.bound })),
+        storedFrames.map((stored2) => stored2?.artifactId)
+      ),
       comparisons
     );
     const recordPath = join(work, "demo.json");
@@ -3022,7 +3111,8 @@ async function runEmitDemo(opts) {
       artifactId: idFor("record", recordPath),
       caption: `Demo record: ${clips.length} chapter${clips.length === 1 ? "" : "s"}, ${clips.filter((clip) => clip.bound).length} bound to a criterion`,
       mediaType: DEMO_RECORD_MEDIA_TYPE,
-      blobOptional: true
+      blobOptional: true,
+      ...replaceOption(replacing?.record)
     });
     const recordArtifactId = artifactIdOf(recorded);
     const exitCode = failures.length > 0 ? 1 : 0;
@@ -3034,14 +3124,16 @@ async function runEmitDemo(opts) {
     });
     const compared = comparisons.filter((comparison) => comparison.comparable !== "not checked").length;
     const boundCount = clips.filter((clip) => clip.bound).length;
-    const what = wholeFits ? `1 video, ${clips.length} chapter${clips.length === 1 ? "" : "s"}, ${boundCount} bound to a criterion` : `whole video left out for its size (${wholeBytes} bytes) ${C.dim}\xB7${C.reset} ${clips.length} clip${clips.length === 1 ? "" : "s"}, ${boundCount} bound to a criterion`;
+    const frameCount = screenshots.filter((entry) => entry.artifactId !== void 0).length;
+    const frameNote = frameCount === 0 ? "" : `, ${frameCount} screenshot${frameCount === 1 ? "" : "s"}`;
+    const what = wholeFits ? `1 video, ${clips.length} chapter${clips.length === 1 ? "" : "s"}, ${boundCount} bound to a criterion${frameNote}` : `whole video left out for its size (${wholeBytes} bytes) ${C.dim}\xB7${C.reset} ${clips.length} clip${clips.length === 1 ? "" : "s"}, ${boundCount} bound to a criterion${frameNote}`;
     const summary = `${C.green}\u2713${C.reset} demo emitted ${C.dim}\xB7${C.reset} ${what} ${C.dim}\xB7${C.reset} record ${recordArtifactId}`;
-    const output = opts.json ? JSON.stringify({ recordArtifactId, video, clips, failures, differences, exitCode }) : [
+    const output = opts.json ? JSON.stringify({ recordArtifactId, video, clips, screenshots, failures, differences, exitCode }) : [
       ...differences.map((line) => `${C.yellow}!${C.reset} ${line}`),
       summary + (opts.compare === void 0 ? "" : ` ${C.dim}\xB7${C.reset} ${compared} of ${clips.length} chapter${clips.length === 1 ? "" : "s"} compared, ${comparisons.filter((comparison) => comparison.comparable === "yes").length} comparable`)
     ].join("\n");
     if (!opts.quiet) process.stdout.write(output + "\n");
-    return { exitCode, output, failures, recordArtifactId, video, clips, differences };
+    return { exitCode, output, failures, recordArtifactId, video, clips, screenshots, differences };
   } finally {
     rmSync(work, { recursive: true, force: true });
   }
@@ -3087,29 +3179,35 @@ async function emitOrExplain(emit, opts, emitted, total, unit) {
     );
   }
 }
+function resolveItem(params) {
+  const { opts, env, cwd, home } = params;
+  if (opts.item !== void 0) return opts.item;
+  const identity = resolveRepoIdentity(cwd);
+  const sessionId = detectActiveSession({
+    env,
+    home,
+    cwds: identity.repoRoot !== void 0 ? [identity.repoRoot, cwd] : [cwd],
+    nowMs: Date.now()
+  });
+  return sessionId === void 0 ? void 0 : launchedItemForSession(sessionId, home);
+}
+async function gatewayFor(params) {
+  const { opts, env, cwd, home } = params;
+  const refusal = await autoConnect({ url: opts.url, apiKey: opts.apiKey, appId: opts.appId, cwd, home, env, fetchImpl: opts.fetchImpl });
+  if (refusal !== void 0) throw new Error(refusal);
+  const resolved = resolveGatewayCredentials({ url: opts.url, apiKey: opts.apiKey, appId: opts.appId, cwd, home, env });
+  if (!resolved.ok) throw new Error(resolved.message);
+  return { url: resolved.url, apiKey: resolved.credential, appId: resolved.appId };
+}
 async function recordedCriteria(params) {
-  const { opts, env, cwd, home, fetchImpl, say } = params;
-  let item = opts.item;
-  if (item === void 0) {
-    const identity = resolveRepoIdentity(cwd);
-    const sessionId = detectActiveSession({
-      env,
-      home,
-      cwds: identity.repoRoot !== void 0 ? [identity.repoRoot, cwd] : [cwd],
-      nowMs: Date.now()
-    });
-    item = sessionId === void 0 ? void 0 : launchedItemForSession(sessionId, home);
-  }
+  const { opts, item, env, cwd, home, fetchImpl, say } = params;
   if (item === void 0) {
     say(`${C.yellow}!${C.reset} no work item, so the chapters' criterion ids are not checked against the recorded criteria (pass --item <number>)`);
     return void 0;
   }
   try {
-    const refusal = await autoConnect({ url: opts.url, apiKey: opts.apiKey, appId: opts.appId, cwd, home, env, fetchImpl: opts.fetchImpl });
-    if (refusal !== void 0) throw new Error(refusal);
-    const resolved = resolveGatewayCredentials({ url: opts.url, apiKey: opts.apiKey, appId: opts.appId, cwd, home, env });
-    if (!resolved.ok) throw new Error(resolved.message);
-    const ids = await readRecordedCriteriaIds({ url: resolved.url, apiKey: resolved.credential, appId: resolved.appId, item, fetchImpl });
+    const gateway = await gatewayFor({ opts, env, cwd, home });
+    const ids = await readRecordedCriteria({ url: gateway.url, apiKey: gateway.apiKey, appId: gateway.appId, item, fetchImpl });
     if (ids === void 0) say(`${C.yellow}!${C.reset} item ${item} has no recorded criteria, so the chapters' criterion ids are not checked`);
     return ids;
   } catch (err) {
@@ -3117,6 +3215,69 @@ async function recordedCriteria(params) {
     return void 0;
   }
 }
+async function readRetiring(params) {
+  const { opts, item, env, cwd, home, fetchImpl } = params;
+  const replaces = opts.replaces;
+  if (item === void 0) throw new EmitDemoError("--replaces needs the work item whose demo it replaces; run in a recorded session or pass --item <number>");
+  let newest;
+  try {
+    const gateway = await gatewayFor({ opts, env, cwd, home });
+    newest = await readNewestDemo({ ...gateway, item, fetchImpl });
+  } catch (err) {
+    throw new EmitDemoError(`could not read the demo of item ${item} to replace it: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (newest === null) throw new EmitDemoError(`item ${item} has no demo to replace; leave out --replaces`);
+  if (newest.artifactId !== replaces) {
+    throw new EmitDemoError(`--replaces ${replaces} is not the newest demo record of item ${item}; the newest is ${newest.artifactId}`);
+  }
+  const record = newest.record;
+  if (record === null) {
+    throw new EmitDemoError(
+      `the stored record ${newest.artifactId} of item ${item} cannot be read, so the artifacts it names cannot be replaced; retire them with emit artifact --replaces, or leave out --replaces`
+    );
+  }
+  const live = newest.liveArtifactIds === void 0 ? void 0 : new Set(newest.liveArtifactIds);
+  const isLive = (id) => live === void 0 || live.has(id);
+  const videoId = record.schemaVersion === 3 && "artifactId" in record.video ? record.video.artifactId : void 0;
+  return {
+    recordId: newest.artifactId,
+    videoId: videoId !== void 0 && isLive(videoId) ? videoId : void 0,
+    chapters: record.chapters.map((chapter) => {
+      const clipId = "artifactId" in chapter ? chapter.artifactId : chapter.clipArtifactId;
+      const frameId = "screenshot" in chapter ? chapter.screenshot.artifactId : void 0;
+      return {
+        criterionId: chapter.criterionId,
+        ...isLive(clipId) ? { artifactId: clipId } : {},
+        ...frameId !== void 0 && isLive(frameId) ? { screenshotId: frameId } : {}
+      };
+    }).filter((chapter) => chapter.artifactId !== void 0 || chapter.screenshotId !== void 0)
+  };
+}
+function planReplaces(old, manifest, wholeFits, storesFrame) {
+  const taken = /* @__PURE__ */ new Set();
+  const take = (ids) => {
+    for (const id of ids) taken.add(id);
+    return ids;
+  };
+  const video = wholeFits && old.videoId !== void 0 ? take([old.videoId]) : [];
+  const named = (pick) => (chapter) => chapter.criterionId === null ? [] : take(old.chapters.filter((entry) => entry.criterionId === chapter.criterionId).flatMap((entry) => pick(entry) ?? []));
+  const chapters = manifest.chapters.map(named((entry) => entry.artifactId));
+  const screenshots = manifest.chapters.map((chapter, index) => storesFrame[index] === true ? named((entry) => entry.screenshotId)(chapter) : []);
+  const left = [
+    ...old.videoId === void 0 ? [] : [old.videoId],
+    ...old.chapters.flatMap((entry) => [entry.artifactId, entry.screenshotId].filter((id) => id !== void 0))
+  ];
+  const record = [old.recordId, ...new Set(left.filter((id) => !taken.has(id)))];
+  for (const targets of [video, ...chapters, ...screenshots, record]) {
+    if (targets.length > ARTIFACT_MAX_REPLACES_TARGETS) {
+      throw new EmitDemoError(
+        `the old demo leaves ${targets.length} artifacts to retire in one emit, over the limit of ${ARTIFACT_MAX_REPLACES_TARGETS} \u2014 record the demo with fewer chapters, or retire the old artifacts with emit artifact --replaces`
+      );
+    }
+  }
+  return { video, chapters, screenshots, record };
+}
+var replaceOption = (targets) => targets === void 0 || targets.length === 0 ? {} : { replaces: targets.join(",") };
 async function realSpeaker(params) {
   const { env, home, work, say, installedRoot } = params;
   try {
@@ -3129,5 +3290,36 @@ async function realSpeaker(params) {
     throw err;
   }
 }
+function withFrames(entries, frameIds) {
+  return entries.map((entry, index) => frameIds[index] === void 0 ? entry : { ...entry, screenshot: { artifactId: frameIds[index] } });
+}
+function decideFrames(params) {
+  const { manifest, proofs, dir, say } = params;
+  const decisions = planScreenshots({ manifest, proofs });
+  return decisions.map((decision, index) => {
+    if (decision === void 0) return { kind: "none" };
+    const chapter = manifest.chapters[index];
+    const skip = (reason) => {
+      say(`${C.yellow}!${C.reset} ${chapterLabel(index, chapter.title)}: ${reason}`);
+      return { kind: "skip", reason };
+    };
+    if ("skip" in decision) return skip(decision.skip);
+    const inside = relative(dir, resolve(dir, decision.bind.file));
+    if (inside === ".." || inside.startsWith(`..${sep}`) || isAbsolute(inside)) {
+      throw new EmitDemoError(`${chapterLabel(index, chapter.title)}: the frame "${decision.bind.file}" is outside the manifest's folder`);
+    }
+    let bytes;
+    try {
+      bytes = readStill(dir, decision.bind.file, decision.bind.sha256, "frame");
+    } catch (err) {
+      if (err instanceof StillError) throw new EmitDemoError(`${chapterLabel(index, chapter.title)}: ${err.message}`);
+      throw err;
+    }
+    if (bytes.length > ARTIFACT_MAX_BYTES) {
+      return skip(`the frame is ${(bytes.length / MIB).toFixed(1)} MiB, over the ${ARTIFACT_MAX_BYTES / MIB} MiB limit, so it is not stored`);
+    }
+    return { kind: "bind", index, frame: decision.bind, bytes };
+  });
+}
 
 export { EmitDemoError, runEmitDemo };

package/dist/{emit-finding-cmd-TLJWBGQE.js → emit-finding-cmd-TXDPJFVT.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { EmitFindingError, detectUploadSessionId, refuseRemovedFindingFlags, resolveUploadTarget, runEmitFinding, runEmitFindings } from './chunk-BKADJZ7F.js';
+export { EmitFindingError, detectUploadSessionId, refuseRemovedFindingFlags, resolveUploadTarget, runEmitFinding, runEmitFindings } from './chunk-6SPD266O.js';
 import './chunk-ESVW4MJY.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-B2JURP6A.js';
-import './chunk-2WMZPJVE.js';
-import './chunk-EWVYQLD3.js';
-import './chunk-5DNCFOXA.js';
-import './chunk-HJYBWJAS.js';
-import './chunk-NSPRS7WK.js';
+import './chunk-HLZMAJJD.js';
+import './chunk-S5CNYXUA.js';
+import './chunk-MPC2UAW2.js';
+import './chunk-NIY2UBT6.js';
+import './chunk-LYGI3T66.js';
+import './chunk-7V5GUEDU.js';
 import './chunk-G2JWZDFA.js';
 import './chunk-ANPNT6PM.js';
 import './chunk-6RKD7YZ6.js';
@@ -18,15 +18,15 @@ import './chunk-PA6CK6WQ.js';
 import './chunk-BALIE3BA.js';
 import './chunk-ZJSNLVCE.js';
 import './chunk-BJ3KTMDH.js';
-import './chunk-G63KT5I5.js';
+import './chunk-44V5SD4G.js';
 import './chunk-5BHIBJDA.js';
 import './chunk-CDDED64E.js';
 import './chunk-RA3O54FC.js';
 import './chunk-T2Q7ISPE.js';
 import './chunk-WZBHBH3J.js';
 import './chunk-CRB3POP4.js';
-import './chunk-LJG6EMLJ.js';
-import './chunk-E6CO3MJE.js';
+import './chunk-6CXNWKWD.js';
+import './chunk-F2D5BSXS.js';
 import './chunk-VNVZDWO3.js';
 import './chunk-HACGUL52.js';
 import './chunk-MESOOLF4.js';

package/dist/{emit-result-cmd-CJNVDV5V.js → emit-result-cmd-QHJDUC7J.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { zodProblem } from './chunk-I3LTIAOR.js';
-import { detectCi } from './chunk-2N67C6IV.js';
-import './chunk-AU346ENF.js';
+import { detectCi } from './chunk-D3EDZPJR.js';
+import './chunk-7UPMYRPS.js';
 import { launchRefusalForSession } from './chunk-ESVW4MJY.js';
 import './chunk-TBT347UY.js';
 import { detectActiveSession } from './chunk-IP7BIBXJ.js';
-import { autoConnect } from './chunk-B2JURP6A.js';
-import './chunk-2WMZPJVE.js';
-import './chunk-EWVYQLD3.js';
-import { resolveRepoIdentity } from './chunk-5DNCFOXA.js';
-import './chunk-HJYBWJAS.js';
-import './chunk-NSPRS7WK.js';
+import { autoConnect } from './chunk-HLZMAJJD.js';
+import './chunk-S5CNYXUA.js';
+import './chunk-MPC2UAW2.js';
+import { resolveRepoIdentity } from './chunk-NIY2UBT6.js';
+import './chunk-LYGI3T66.js';
+import './chunk-7V5GUEDU.js';
 import './chunk-G2JWZDFA.js';
 import { C } from './chunk-ANPNT6PM.js';
 import { resolveGatewayCredentials, defaultFetch, unauthorizedMessage } from './chunk-6RKD7YZ6.js';
@@ -19,13 +19,13 @@ import './chunk-PJDQPF5N.js';
 import './chunk-SOI6K5DY.js';
 import './chunk-PA6CK6WQ.js';
 import './chunk-BALIE3BA.js';
-import './chunk-QPWFVE3X.js';
+import './chunk-UK4RGH46.js';
 import './chunk-ZJSNLVCE.js';
 import './chunk-2O5KA67H.js';
 import './chunk-BKO6JEZI.js';
 import './chunk-HCVLP7XA.js';
 import './chunk-BJ3KTMDH.js';
-import './chunk-G63KT5I5.js';
+import './chunk-44V5SD4G.js';
 import './chunk-5BHIBJDA.js';
 import './chunk-CDDED64E.js';
 import './chunk-RA3O54FC.js';
@@ -34,8 +34,8 @@ import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
 import './chunk-CRB3POP4.js';
 import './chunk-URIZRCRY.js';
 import './chunk-TUSYOL2O.js';
-import './chunk-LJG6EMLJ.js';
-import { EmittedNameSchema, EMITTED_RESULT_MAX_LINK_LENGTH, EMITTED_RESULTS, itemsAllowResult, EMITTED_RESULT_MAX_BODY_LENGTH, CheckItemsSchema } from './chunk-E6CO3MJE.js';
+import './chunk-6CXNWKWD.js';
+import { EmittedNameSchema, EMITTED_RESULT_MAX_LINK_LENGTH, EMITTED_RESULTS, itemsAllowResult, EMITTED_RESULT_MAX_BODY_LENGTH, CheckItemsSchema } from './chunk-F2D5BSXS.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-HACGUL52.js';
 import './chunk-MESOOLF4.js';

package/dist/{emit-step-cmd-347CZO7Y.js → emit-step-cmd-TQCOLXAA.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { EmitStepError, runEmitStep, uploadSpooledSteps } from './chunk-AU346ENF.js';
+export { EmitStepError, runEmitStep, uploadSpooledSteps } from './chunk-7UPMYRPS.js';
 import './chunk-ESVW4MJY.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-B2JURP6A.js';
-import './chunk-2WMZPJVE.js';
-import './chunk-EWVYQLD3.js';
-import './chunk-5DNCFOXA.js';
-import './chunk-HJYBWJAS.js';
-import './chunk-NSPRS7WK.js';
+import './chunk-HLZMAJJD.js';
+import './chunk-S5CNYXUA.js';
+import './chunk-MPC2UAW2.js';
+import './chunk-NIY2UBT6.js';
+import './chunk-LYGI3T66.js';
+import './chunk-7V5GUEDU.js';
 import './chunk-G2JWZDFA.js';
 import './chunk-ANPNT6PM.js';
 import './chunk-6RKD7YZ6.js';
@@ -17,15 +17,15 @@ import './chunk-SOI6K5DY.js';
 import './chunk-PA6CK6WQ.js';
 import './chunk-BALIE3BA.js';
 import './chunk-BJ3KTMDH.js';
-import './chunk-G63KT5I5.js';
+import './chunk-44V5SD4G.js';
 import './chunk-5BHIBJDA.js';
 import './chunk-CDDED64E.js';
 import './chunk-RA3O54FC.js';
 import './chunk-T2Q7ISPE.js';
 import './chunk-WZBHBH3J.js';
 import './chunk-CRB3POP4.js';
-import './chunk-LJG6EMLJ.js';
-import './chunk-E6CO3MJE.js';
+import './chunk-6CXNWKWD.js';
+import './chunk-F2D5BSXS.js';
 import './chunk-VNVZDWO3.js';
 import './chunk-HACGUL52.js';
 import './chunk-MESOOLF4.js';