@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/slices/rebuild/runtime-export-bed.js

@@ -1,4 +1,6 @@
-import { z } from "zod";
+import { errorText } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
+import { assetPathOrUndefined } from "../revisions/mutation-assets.js";
 import { outputPath } from "../storage/layout.js";
 import { usesAmbientBed } from "../video/ambient-bed.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
@@ -17,25 +19,19 @@ export async function exportBed(deps, context, view) {
     };
     if (bed.source !== "upload")
         return { source: { kind: "noise", preset: bed.source }, ...settings };
-    const fix = "Make the video again from Play with another file under Video and style → Ambient sound, or pick Rain, Fireplace or Wind there instead.";
+    const fix = `Choose another file under Ambient sound in ${editSettings.sound}, or pick Rain, Fireplace or Wind there instead.`;
     const assetId = view.revision.content.ambientBed;
-    const row = z
-        .object({ path: z.string() })
-        .safeParse(assetId === undefined
-        ? undefined
-        : deps.db
-            .prepare("SELECT path FROM project_assets WHERE project_id=? AND id=?")
-            .get(context.work.projectId, assetId));
-    if (!row.success)
+    const saved = assetId === undefined ? undefined : assetPathOrUndefined(deps, context.work.projectId, assetId);
+    if (saved === undefined)
         throw new Error(`The ambient sound's audio file is no longer in the project. ${fix}`);
-    const path = outputPath(deps.paths, context.work.projectId, row.data.path);
+    const path = outputPath(deps.paths, context.work.projectId, saved);
     let durationMs;
     try {
         durationMs = await probeDurationMs(deps.ffmpeg, path, context.signal, deps.log);
     }
     catch (error) {
         context.signal.throwIfAborted();
-        throw new Error(`The ambient sound's audio file couldn't be read as audio (${error instanceof Error ? error.message : String(error)}). ${fix}`);
+        throw new Error(`The ambient sound's audio file couldn't be read as audio (${errorText(error)}). ${fix}`);
     }
     if (durationMs <= 0)
         throw new Error(`The ambient sound's audio file holds no sound. ${fix}`);

package/dist/slices/rebuild/runtime-export-edit.js

@@ -1,16 +1,17 @@
-import { readFileSync } from "node:fs";
 import { extname } from "node:path";
 import { z } from "zod";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { usesFigureCards, usesYoutubeDescription } from "../admission/rules.js";
 import { captionFont, captionFontDeps } from "../fonts/coverage.js";
 import { resolveFont } from "../fonts/index.js";
+import { isReadyOutput, readyOutput } from "../revisions/view.js";
 import { outputPath } from "../storage/layout.js";
 import { headingChapters } from "../video/chapters.js";
 import { sentenceCutPoints } from "../video/cuts.js";
 import { usesChapterCards, usesNarrationCuts, videoEditOf, } from "../video/edit-settings.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
 import { passageSpans } from "../video/figure-spans.js";
-import { wordsSchema } from "./runtime-subtitles.js";
+import { readTimingWords } from "./runtime-subtitles.js";
 // The containers an uploaded clip may come in; anything else in the images is a still.
 const clipExtensions = new Set([".mp4", ".mov", ".m4v", ".webm", ".mkv"]);
 export function isClipPath(path) {
@@ -19,7 +20,7 @@ export function isClipPath(path) {
 export async function exportEdit(deps, context, view, images) {
     const config = view.revision.config;
     const order = view.revision.content.imageOrder;
-    const ready = (key) => view.outputs.find((row) => row.workKey === key && row.selected && row.available && row.state === "ready");
+    const ready = (key) => readyOutput(view, { workKey: key });
     // Clips: an animated image's clip first, then an uploaded clip in the image's own place.
     const clips = [];
     for (const [index, key] of order.entries()) {
@@ -109,15 +110,8 @@ async function titleFont(deps, config) {
         ...(config.titleStyle?.color === undefined ? {} : { color: config.titleStyle.color }),
     };
 }
-export function timingWords(deps, context, view) {
-    const timing = view.outputs.find((row) => row.selected &&
-        row.available &&
-        row.state === "ready" &&
-        row.workKey === "subtitles:timing" &&
-        row.output.role === "subtitle_words");
-    if (timing === undefined)
-        throw new Error("The narration's word timing, which the video's cuts and chapter cards follow, is missing. Use More → Render the video again in the Video section, then Try again.");
-    return wordsSchema.parse(JSON.parse(readFileSync(outputPath(deps.paths, context.work.projectId, timing.output.path), "utf8"))).words;
+function timingWords(deps, context, view) {
+    return readTimingWords(deps, context, view, "the video's cuts and chapter cards follow").words;
 }
 // The YouTube description's chapters when that step runs, the article's headings otherwise.
 function chaptersOf(view, config, words) {
@@ -142,7 +136,7 @@ async function clipSeconds(deps, context, path, place) {
         ms = 0;
     }
     if (!(ms > 0))
-        throw new Error(`Image ${String(place)} is a video clip Slopify can't read, so the video can't show it. Replace it with another clip or an image in Edit project → Images, then Try again.`);
+        throw new Error(`Image ${String(place)} is a video clip Slopify can't read, so the video can't show it. Replace it with another clip or an image in ${editSettings.images}, then Try again.`);
     return ms / 1000;
 }
 // Each card in the video's frame, shown where its description is spoken: the description's
@@ -150,9 +144,7 @@ async function clipSeconds(deps, context, path, place) {
 // found in the timing is left out rather than shown at the wrong moment.
 export function figureShots(deps, context, view, format = view.revision.config.format, words = timingWords(deps, context, view)) {
     const cards = view.outputs
-        .filter((row) => row.selected &&
-        row.available &&
-        row.state === "ready" &&
+        .filter((row) => isReadyOutput(row) &&
         row.output.role === "figure_card" &&
         row.workKey.startsWith("figure:card:") &&
         (row.output.meta.format ?? view.revision.config.format) === format)

package/dist/slices/rebuild/runtime-export-inputs.js

@@ -1,9 +1,12 @@
 import { readFileSync } from "node:fs";
 import { z } from "zod";
+import { internalError } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { narrationAliasesOf, usesNarrationPreparation, usesPronunciationGlossary, } from "../admission/rules.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
 import { usesLoudness } from "../loudness/model.js";
+import { donePiece, isReadyOutput, readyOutput } from "../revisions/view.js";
 import { outputPath } from "../storage/layout.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
 import { audioTimeline } from "../video/plan.js";
@@ -17,11 +20,11 @@ export function exportSnapshot(deps, context, piece) {
         .prepare("SELECT recipe_context FROM revision_work WHERE id=?")
         .get(context.work.workId);
     if (view === undefined || row === undefined)
-        throw new Error("Slopify hit an internal error (the project version being exported is missing). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the project version being exported is missing"));
     const plan = executionPlan(deps, view, savedCatalogue(row.recipe_context));
     const recipe = plan.recipes.find((one) => one.key === piece.key && one.fingerprint === piece.fingerprint);
     if (recipe === undefined || recipe.deferred || recipe.unresolved)
-        throw new Error("Slopify hit an internal error (the export no longer matches the project's saved inputs). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the export no longer matches the project's saved inputs"));
     return { view, plan };
 }
 export async function revisionAudio(deps, context, view, 
@@ -45,25 +48,23 @@ export async function narrationAudio(deps, view, options = {}) {
     const levelled = options.levelled === true && usesLoudness(config) && config.sources.audio === "generate";
     const input = async (role) => {
         const segment = role === "audio_body" ? "body" : role === "audio_intro" ? "intro" : "outro";
-        const row = view.outputs.find((one) => one.selected &&
-            one.available &&
-            one.state === "ready" &&
+        const row = view.outputs.find((one) => isReadyOutput(one) &&
             (levelled
                 ? one.output.role === "audio_levelled" && one.workKey === levelKey(segment)
                 : one.output.role === role));
         if (row === undefined && levelled)
-            throw new Error(`The levelled ${segment === "body" ? "narration" : segment} isn't finished yet, so the sound can't be exported at an even volume. Let the Narration stage finish (Resume, or Try again on it), then retry this stage; or turn off Level the volume in Edit project → Pauses and volume.`);
+            throw new Error(`The levelled ${segment === "body" ? "narration" : segment} isn't finished yet, so the sound can't be exported at an even volume. Let the Narration stage finish (Continue the run, or Try again on Narration), then try this stage again; or turn off Level the volume in ${editSettings.sound}.`);
         if (row === undefined)
             return undefined;
         const path = outputPath(deps.paths, view.revision.projectId, row.output.path);
         const duration = row.output.durationMs ?? (await deps.measure(path));
         if (!Number.isFinite(duration) || duration <= 0)
-            throw new Error("Slopify couldn't read the length of the narration audio, so the file may be damaged or empty. Regenerate the narration (or upload your audio file again in Edit project → Narration), then Try again.");
+            throw new Error(`Slopify couldn't read the length of the narration audio, so the file may be damaged or empty. Press Make the narration again in the project's Narration section (or upload your audio file again in ${editSettings.narration}), then Try again.`);
         return { path, seconds: duration / 1000 };
     };
     const body = await input("audio_body");
     if (body === undefined)
-        throw new Error("The narration audio isn't finished yet. Let the Narration stage finish (Resume, or Try again on it), then retry this stage.");
+        throw new Error("The narration audio isn't finished yet. Let the Narration stage finish (Continue the run, or Try again on Narration), then try this stage again.");
     return narrationTimeline(config, {
         body,
         intro: speaksPart(config, "intro") ? await input("audio_intro") : undefined,
@@ -95,7 +96,7 @@ export function revisionTranscript(deps, snapshot, kind) {
     const concat = plan.recipes.find((one) => one.key === (kind === "body" ? "audio:body:concat" : `audio:${kind}`));
     if (concat !== undefined) {
         const texts = concat.dependsOn.map((key) => {
-            const row = view.pieces.find((one) => one.key === key && one.selected && one.available && one.piece.state === "done");
+            const row = donePiece(view, key);
             const payload = row?.piece.payload === null || row?.piece.payload === undefined
                 ? undefined
                 : z.object({ text: z.string().optional() }).parse(JSON.parse(row.piece.payload));
@@ -108,13 +109,13 @@ export function revisionTranscript(deps, snapshot, kind) {
                 Array.isArray(recipe.input.semantic) &&
                 typeof recipe.input.semantic[0] === "string")
                 return recipe.input.semantic[0];
-            throw new Error("Some narration chunks aren't finished, so the full narration text isn't available. Let the Narration stage finish (Resume, or Try again on it), or regenerate the missing chunk in Edit project → Narration.");
+            throw new Error(`Some narration chunks aren't finished, so the full narration text isn't available. Let the Narration stage finish (Continue the run, or Try again on Narration), or make the missing chunk again in ${editSettings.narration}.`);
         });
         if (texts.length > 0)
             return texts.join("\n");
     }
     if (kind === "body") {
-        const row = view.outputs.find((one) => one.selected && one.available && one.state === "ready" && one.output.role === "article_txt");
+        const row = readyOutput(view, { role: "article_txt" });
         if (row !== undefined)
             return readFileSync(outputPath(deps.paths, view.revision.projectId, row.output.path), "utf8");
         if (view.articleMarkdown !== null)

package/dist/slices/rebuild/runtime-export-short.js

@@ -5,9 +5,9 @@ import { renderShort, shortFrame } from "../shorts/render.js";
 import { allocateAsset, discardPreparedAssets, sealAsset } from "../storage/assets.js";
 import { projectDir } from "../storage/layout.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
-import { slideshowImages } from "./runtime-export.js";
+import { exportMachine, slideshowImages, warningsOf, } from "./runtime-export.js";
 import { preparedResult, preparedText, publishResult } from "./runtime-publication.js";
-import { timingWords } from "./runtime-shorts.js";
+import { readTimingWords } from "./runtime-subtitles.js";
 // A short-mode project's video (`admission/short-mode.ts`): the whole narration timeline as
 // one clip through the Shorts renderer, so it looks like every short Slopify cuts from a long
 // video - the images moving as the project says, the title on top and big word-by-word
@@ -16,10 +16,10 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
     const { view } = snapshot;
     const config = view.revision.config;
     const images = slideshowImages(deps, context, view);
-    const words = timingWords(deps, context, view);
+    const words = readTimingWords(deps, context, view, "the shorts are cut and captioned from").words;
     const seconds = timeline.reduce((sum, segment) => sum + segment.seconds, 0);
     if (seconds <= 0)
-        throw new Error("The short has no narration to play, so there is nothing to render. Let the Narration stage finish (Resume, or Try again on it), then retry this stage.");
+        throw new Error("The short has no narration to play, so there is nothing to render. Let the Narration stage finish (Continue the run, or Try again on Narration), then try this stage again.");
     const font = await resolveBoldFont(deps.paths, config.subtitles?.fontId ?? "default");
     if (!context.maySubmit(piece.id))
         return "held";
@@ -28,8 +28,11 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
     const directory = projectDir(deps.paths, context.work.projectId);
     const relativePath = (path) => relative(directory, path).split(sep).join("/");
     try {
+        const machine = await exportMachine(deps, context.work.projectId);
         const master = await renderShort({
             bin: deps.ffmpeg,
+            machine: machine.machine,
+            notice: machine.notice,
             master: masterGoal(config, "video"),
             timeline,
             start: 0,
@@ -58,6 +61,7 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
         const asset = sealAsset(deps, pending);
         prepared.push(preparedResult(deps, context, piece, "video", asset, durationMs, {
             subtitlesMode: "off",
+            ...warningsOf(machine.notices),
             ...(master === undefined ? {} : { master }),
         }));
         prepared.push(preparedText(deps, context, piece, "render_params", "render.json", JSON.stringify({
@@ -76,7 +80,7 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
             output: pending.path,
         })));
         await publishResult(deps, context, piece, prepared, { totalSeconds: seconds }, asset);
-        deps.count?.("stage.completed", { stage: "video" });
+        deps.count?.("stage.completed", { stage: "video" }, context.work.projectId);
         return "done";
     }
     finally {

package/dist/slices/rebuild/runtime-export.js

@@ -1,8 +1,11 @@
 import { copyFileSync, mkdirSync, mkdtempSync, rmSync } from "node:fs";
 import { extname, join, relative, sep } from "node:path";
+import { internalError } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { usesShortMode } from "../admission/short-mode.js";
 import { masterFile, masterReport } from "../loudness/loudnorm.js";
 import { masterGoal } from "../loudness/model.js";
+import { isReadyOutput, readyOutput } from "../revisions/view.js";
 import { allocateAsset, discardPreparedAssets, sealAsset } from "../storage/assets.js";
 import { outputPath, projectDir, renderCacheDir } from "../storage/layout.js";
 import { audioExportArgs } from "../video/audio-export.js";
@@ -18,10 +21,21 @@ import { exportSnapshot, retainedOutput, revisionAudio, } from "./runtime-export
 import { executeShortExport } from "./runtime-export-short.js";
 import { lineLevelledAudio } from "./runtime-lines.js";
 import { preparedResult, preparedText, publishResult } from "./runtime-publication.js";
+import { pieceAlreadyDone } from "./work-records.js";
+// The machine settings for one render, and the notices it gathers for the project page.
+export async function exportMachine(deps, projectId) {
+    const chosen = await deps.renderMachine?.(projectId);
+    const notices = chosen?.notice === undefined ? [] : [chosen.notice];
+    return {
+        machine: chosen?.machine,
+        notices,
+        notice: (sentence) => {
+            notices.push(sentence);
+        },
+    };
+}
 export async function executeExportRecipe(deps, context, piece) {
-    if (deps.db
-        .prepare("SELECT state FROM revision_work_pieces WHERE id=? AND work_id=?")
-        .get(piece.id, context.work.workId)?.state === "done")
+    if (pieceAlreadyDone(deps.db, context.work.workId, piece.id))
         return "done";
     if (!context.maySubmit(piece.id))
         return "held";
@@ -31,9 +45,9 @@ export async function executeExportRecipe(deps, context, piece) {
     const audio = await revisionAudio(deps, context, view, { levelled: true });
     const wav = piece.key === "export:wav";
     if (!wav && piece.key !== "export:video")
-        throw new Error("Slopify hit an internal error (unknown kind of export). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("unknown kind of export"));
     if (wav && audio.length === 0)
-        throw new Error("The audio export has nothing to export because narration is turned off for this project. Turn narration on in Edit project, then Try again.");
+        throw new Error(`The audio export has nothing to export because narration is turned off for this project. Turn narration on (Narration source in ${editSettings.narration}), then Try again.`);
     if (!wav && usesShortMode(view.revision.config))
         return executeShortExport(deps, context, piece, snapshot, audio);
     const filename = wav ? "audio.wav" : "video.mp4";
@@ -49,7 +63,7 @@ export async function executeExportRecipe(deps, context, piece) {
         const sound = linesDirectory === undefined
             ? audio
             : await lineLevelledAudio(deps, context, view, audio, linesDirectory);
-        const captions = snapshot.view.outputs.filter((row) => row.selected && row.available && row.state === "ready" && row.workKey === "subtitles:files");
+        const captions = snapshot.view.outputs.filter((row) => isReadyOutput(row) && row.workKey === "subtitles:files");
         const burn = !wav && view.revision.config.subtitles?.mode === "burn-in";
         if (burn)
             directory = captionDirectory(deps, context, snapshot);
@@ -119,6 +133,8 @@ export async function executeExportRecipe(deps, context, piece) {
             };
         if (!context.maySubmit(piece.id))
             return "held";
+        const machine = await exportMachine(deps, context.work.projectId);
+        const priority = machine.machine?.priority;
         const onProgress = (elapsedMs) => context.emit({
             type: "stage.progress",
             projectId: context.work.projectId,
@@ -139,10 +155,11 @@ export async function executeExportRecipe(deps, context, piece) {
                     args: audioExportArgs(sound, mixed),
                     signal: context.signal,
                     log: deps.log,
+                    priority,
                     onProgress,
                 });
                 if (goal !== undefined) {
-                    const run = { bin: deps.ffmpeg, log: deps.log, signal: context.signal };
+                    const run = { bin: deps.ffmpeg, log: deps.log, signal: context.signal, priority };
                     await masterFile(run, mixed, `${pending.absolutePath}.master.wav`, goal, {
                         sampleRate: 48000,
                         channels: 2,
@@ -167,6 +184,7 @@ export async function executeExportRecipe(deps, context, piece) {
                         ],
                         signal: context.signal,
                         log: deps.log,
+                        priority,
                         onProgress: () => { },
                     });
                     master = await masterReport(run, pending.absolutePath, goal);
@@ -193,20 +211,21 @@ export async function executeExportRecipe(deps, context, piece) {
                 log: deps.log,
                 onProgress,
                 ...(goal === undefined ? {} : { master: goal }),
+                machine: machine.machine,
+                notice: machine.notice,
             });
         context.signal.throwIfAborted();
         const asset = sealAsset(deps, pending);
         prepared.push(preparedResult(deps, context, piece, wav ? "audio_export" : "video", asset, Math.round(totalSeconds * 1000), {
             subtitlesMode: mode,
-            ...(edited === undefined || edited.warnings.length === 0
-                ? {}
-                : { warnings: edited.warnings }),
+            // An audio export encodes no picture, so the encoder's notice is not its to show.
+            ...warningsOf([...(edited?.warnings ?? []), ...(wav ? [] : machine.notices)]),
             ...(master === undefined ? {} : { master }),
         }));
         prepared.push(preparedText(deps, context, piece, "render_params", "render.json", JSON.stringify(record)));
         prepared.push(...captions.map((row) => retainedOutput(deps, view, row)));
         await publishResult(deps, context, piece, prepared, { totalSeconds }, asset);
-        deps.count?.("stage.completed", { stage: "video" });
+        deps.count?.("stage.completed", { stage: "video" }, context.work.projectId);
         return "done";
     }
     finally {
@@ -220,18 +239,18 @@ export async function executeExportRecipe(deps, context, piece) {
 // The project's images in slideshow order, as files.
 export function slideshowImages(deps, context, view) {
     return view.revision.content.imageOrder.map((key) => {
-        const row = view.outputs.find((one) => one.workKey === `image:${key}` && one.selected && one.available && one.state === "ready");
+        const row = readyOutput(view, { workKey: `image:${key}` });
         if (row === undefined)
-            throw new Error("The video export can't find one of the slideshow images. Use More → make it again in its section on Images (or regenerate that image in Edit project → Images), then Try again.");
+            throw new Error(`The video export can't find one of the slideshow images. Press Make this image again on it in the project's Images section (or replace it in ${editSettings.images}), then Try again.`);
         return outputPath(deps.paths, context.work.projectId, row.output.path);
     });
 }
 function captionDirectory(deps, context, snapshot) {
-    const find = (role) => snapshot.view.outputs.find((row) => row.selected && row.available && row.state === "ready" && row.output.role === role);
+    const find = (role) => readyOutput(snapshot.view, { role });
     const ass = find("subtitle_ass");
     const font = find("subtitle_font");
     if (ass === undefined || font === undefined)
-        throw new Error("Burned-in captions are missing their caption file or font. Use More → Render the video again in the Video section (or choose the caption font again in Edit project → Subtitles), then Try again.");
+        throw new Error(`Burned-in captions are missing their caption file or font. Press Make the video again in the project's Video section (or choose the caption font again in ${editSettings.captions}), then Try again.`);
     const directory = mkdtempSync(join(projectDir(deps.paths, context.work.projectId), "render-"));
     try {
         mkdirSync(join(directory, "fonts"), { mode: 0o700 });
@@ -244,3 +263,7 @@ function captionDirectory(deps, context, snapshot) {
         throw error;
     }
 }
+// What the video could not do as asked, for the project page; nothing when it did it all.
+export function warningsOf(warnings) {
+    return warnings.length === 0 ? {} : { warnings };
+}

package/dist/slices/rebuild/runtime-figure-card.js

@@ -1,6 +1,7 @@
 import { copyFileSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { z } from "zod";
+import { internalError } from "../../kernel/errors.js";
 import { captionFont, captionFontDeps } from "../fonts/coverage.js";
 import { describedKinds } from "../narration/blocks.js";
 import { allocateAsset, discardPreparedAssets, sealAsset } from "../storage/assets.js";
@@ -25,7 +26,7 @@ const values = z.object({
 const frames = { "16:9": [1920, 1080], "9:16": [1080, 1920], "1:1": [1080, 1080] };
 export async function executeFigureCard(deps, context, piece) {
     if (piece.input.kind !== "local")
-        throw new Error("Slopify hit an internal error (a figure card step was set up wrongly). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("a figure card step was set up wrongly"));
     const card = values.parse(piece.input.values);
     const view = executionView(deps, context.work.projectId, context.work.revisionId);
     // The article's own picture for a figure, when the project has it as an upload.

package/dist/slices/rebuild/runtime-image.js

@@ -1,6 +1,7 @@
 import { readFileSync } from "node:fs";
-import { z } from "zod";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { imageBlob } from "../channels/repo.js";
+import { assetPathOrUndefined } from "../revisions/mutation-assets.js";
 import { outputPath } from "../storage/layout.js";
 // The provider call an image step makes: its request, the effort when one is chosen and, while
 // the project's Establishing image is on, that image's bytes as the visual reference.
@@ -22,27 +23,22 @@ function referenceImage(deps, projectId, input) {
     if (input.reference === undefined)
         return undefined;
     // The step waits for the establishing image, so a missing one went away since.
-    const missing = "The establishing image this image is drawn from is missing. Use Regenerate on the establishing image in the Images section (or upload it again in Edit project → Images), then use Try again.";
+    const missing = `The establishing image this image is drawn from is missing. Press Make the establishing image again in the project's Images section (or upload it again in ${editSettings.images}), then use Try again.`;
     if (input.reference.assetId === null)
         throw new Error(missing);
-    const row = z
-        .object({ path: z.string() })
-        .optional()
-        .parse(deps.db
-        .prepare("SELECT path FROM project_assets WHERE id=? AND project_id=?")
-        .get(input.reference.assetId, projectId));
-    if (row === undefined)
+    const saved = assetPathOrUndefined(deps, projectId, input.reference.assetId);
+    if (saved === undefined)
         throw new Error(missing);
     let bytes;
     try {
-        bytes = new Uint8Array(readFileSync(outputPath(deps.paths, projectId, row.path)));
+        bytes = new Uint8Array(readFileSync(outputPath(deps.paths, projectId, saved)));
     }
     catch {
         throw new Error(missing);
     }
     const mime = imageMime(bytes);
     if (mime === undefined)
-        throw new Error("The establishing image is not a PNG or JPEG file, so it can't be sent as a reference. Upload a PNG or JPEG in Edit project → Images → Establishing image, then use Try again.");
+        throw new Error(`The establishing image is not a PNG or JPEG file, so it can't be sent as a reference. Upload a PNG or JPEG under Establishing image in ${editSettings.images}, then use Try again.`);
     return { bytes, mime };
 }
 // The cast pictures the request names, read by hash from the database. They are never removed
@@ -56,7 +52,7 @@ function castImages(deps, input) {
         images: member.images.map((sha256) => {
             const blob = imageBlob(deps.db, sha256);
             if (blob === undefined)
-                throw new Error(`A picture of ${member.name} that this project was started with is not in this Slopify's database, so it can't be sent as a reference. Add the picture again in Channels → Cast, then start the video again from Play.`);
+                throw new Error(`A picture of ${member.name} that this project was started with is not in this Slopify's database, so it can't be sent as a reference. Add the picture again in Channels → Cast, then start the video again from Create.`);
             return blob;
         }),
     }));

package/dist/slices/rebuild/runtime-instructions.js

@@ -49,5 +49,7 @@ function label(key) {
         return "Intro";
     if (key === "entry:outro:text")
         return "Outro";
+    if (key === "article:digest")
+        return "Keyword digest";
     return "Thumbnail instructions";
 }

package/dist/slices/rebuild/runtime-keywords.js

@@ -0,0 +1,59 @@
+import { errorText } from "../../kernel/errors.js";
+import { fillLateKeywords, mentionsLateKeyword } from "../keywords/fill.js";
+import { durationText, releaseDateText } from "../keywords/values.js";
+import { releasesOf } from "../studio/releases.js";
+import { revisionAudio } from "./runtime-export-inputs.js";
+import { executionView } from "./runtime-plan.js";
+// The release date and the video's length are filled into a request only as it is sent: the
+// planned request keeps `{{Slopify_Release_Date}}` and `{{Slopify_Duration}}`, so moving the
+// date later, or a new length, never makes anything outdated. Every other call goes through as
+// it was.
+export function lateKeywordProviders(providers, values) {
+    let once;
+    const late = () => {
+        once ??= values();
+        return once;
+    };
+    const wrap = (inner) => ({
+        ...inner,
+        llm: async (call, onEvent) => {
+            if (!call.messages.some((message) => mentionsLateKeyword(message.content)))
+                return inner.llm(call, onEvent);
+            const filled = await late();
+            return inner.llm({
+                ...call,
+                messages: call.messages.map((message) => ({
+                    ...message,
+                    content: fillLateKeywords(message.content, filled),
+                })),
+            }, onEvent);
+        },
+        image: async (call) => mentionsLateKeyword(call.prompt)
+            ? inner.image({ ...call, prompt: fillLateKeywords(call.prompt, await late()) })
+            : inner.image(call),
+        forPiece: (pieceId) => wrap(inner.forPiece(pieceId)),
+    });
+    return wrap(providers);
+}
+// The long video's release time from the posting plan, and the narration's length once it is
+// there. A length that can't be read yet (an article review runs before the narration) is
+// blank, so its line is left out, and the reason is logged.
+export async function lateValuesOf(deps, context) {
+    const releaseDate = releaseDateText(releasesOf(deps.db, context.work.projectId).find((release) => release.short === 0)?.at);
+    const view = executionView(deps, context.work.projectId, context.work.revisionId);
+    let duration;
+    if (view !== undefined && view.revision.config.sources.audio !== "off")
+        try {
+            const audio = await revisionAudio(deps, context, view);
+            const seconds = audio.reduce((sum, segment) => sum + segment.seconds, 0);
+            duration = seconds > 0 ? durationText(seconds) : undefined;
+        }
+        catch (error) {
+            deps.log.write("warn", "keywords.duration", {
+                projectId: context.work.projectId,
+                stage: context.work.kind,
+                detail: errorText(error),
+            });
+        }
+    return { releaseDate, duration };
+}

package/dist/slices/rebuild/runtime-lines.js

@@ -1,9 +1,7 @@
-import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { levelLines } from "../loudness/line-level.js";
-import { outputPath } from "../storage/layout.js";
 import { linesLevelled } from "./recipe-lines.js";
-import { wordsSchema } from "./runtime-subtitles.js";
+import { readTimingWords } from "./runtime-subtitles.js";
 // The sound a multi-voice run plays, with its body narration levelled line by line
 // (`loudness/line-level.ts`) into `directory`, for the video, the audio export and the audio
 // files alike. The words are timed on the timeline these segments lay out, so the body starts
@@ -11,14 +9,7 @@ import { wordsSchema } from "./runtime-subtitles.js";
 export async function lineLevelledAudio(deps, context, view, audio, directory) {
     if (!linesLevelled(view.revision.config))
         return audio;
-    const timing = view.outputs.find((row) => row.selected &&
-        row.available &&
-        row.state === "ready" &&
-        row.workKey === "subtitles:timing" &&
-        row.output.role === "subtitle_words");
-    if (timing === undefined)
-        throw new Error("The narration's word timing, which evens out the speakers' volume, is missing. Use More → Render the video again in the Video section, then Try again.");
-    const { words } = wordsSchema.parse(JSON.parse(readFileSync(outputPath(deps.paths, context.work.projectId, timing.output.path), "utf8")));
+    const { words } = readTimingWords(deps, context, view, "evens out the speakers' volume");
     const run = { bin: deps.ffmpeg, log: deps.log, signal: context.signal };
     const levelled = [];
     let offset = 0;