@gentbajko/slopify 2.4.0 → 3.0.0

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

@@ -0,0 +1,237 @@
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+import { thinkingModes } from "../../kernel/ports/llm.js";
+import { plainText } from "../article/plain.js";
+import { defaultReviewPrompts, narrationItemKey, reviewStages, } from "../reviews/model.js";
+import { nextAttempt, reviewOutcome } from "../reviews/outcome.js";
+import { latestVerdict, saveVerdict } from "../reviews/repo.js";
+import { parseVerdict, reviewMessages } from "../reviews/verdict.js";
+import { pickedShortsOf } from "../shorts/clips.js";
+import { outputPath } from "../storage/layout.js";
+import { exportSnapshot } from "./runtime-export-inputs.js";
+import { savedCatalogue } from "./runtime-plan.js";
+import { publishResult } from "./runtime-publication.js";
+import { wordsSchema } from "./runtime-subtitles.js";
+// What `recipe-reviews.ts` saves in the step's values, by position.
+const valuesSchema = z.tuple([
+    z.enum(reviewStages),
+    z.string(),
+    z.array(z.tuple([z.string(), z.unknown()])),
+    z.string(),
+    z.string(),
+    z.string().nullable(),
+    z.string(),
+    z.enum(["flag", "redo"]),
+    z.number().int().nonnegative(),
+]);
+// ceiling: enough of a long article or research for a reviewer to judge it, and well inside
+// every supported model's context.
+const textMax = 60_000;
+// Asks the reviewer about one finished item and saves its verdict. A malformed answer is a
+// failed attempt the provider wrapper asks again; a verdict that sends the item back is
+// saved as a pending redo, which `review-redo.ts` starts once this step has finished, and
+// until then the item's dependents are held (`reviewHold`).
+export async function executeReviewRecipe(deps, context, providers, piece) {
+    if (deps.db
+        .prepare("SELECT state FROM revision_work_pieces WHERE id=? AND work_id=?")
+        .get(piece.id, context.work.workId)?.state === "done")
+        return "done";
+    if (!context.maySubmit(piece.id))
+        return "held";
+    context.signal.throwIfAborted();
+    const input = piece.input;
+    const values = input.kind === "local" && input.operation === "review-v1"
+        ? valuesSchema.safeParse(input.values)
+        : undefined;
+    if (values === undefined || !values.success)
+        throw new Error("Slopify hit an internal error (a review step was set up wrongly). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+    const [stage, itemKey, , provider, model, thinking, prompt, mode, retries] = values.data;
+    const { view, plan } = exportSnapshot(deps, context, piece);
+    const material = reviewMaterial(deps, context, view, plan.recipes, stage, itemKey, prompt);
+    const previous = latestVerdict(deps.db, context.work.projectId, itemKey);
+    const attempt = nextAttempt(previous, material.itemFingerprint);
+    const row = deps.db
+        .prepare("SELECT recipe_context FROM revision_work WHERE id=?")
+        .get(context.work.workId);
+    const catalogued = savedCatalogue(row?.recipe_context).llm.find((one) => one.provider === provider && one.id === model);
+    const level = thinking === null ? undefined : z.enum(thinkingModes).parse(thinking);
+    if (!context.maySubmit(piece.id))
+        return "held";
+    const answer = await providers.forPiece(piece.id).llm({
+        provider,
+        model,
+        ...(level === undefined ? {} : { thinking: level }),
+        thinkingConfig: level === undefined ? null : (catalogued?.llm.thinking?.[level] ?? null),
+        messages: reviewMessages(material.request),
+        webSearch: false,
+        ...(material.images.length === 0 ? {} : { images: material.images }),
+        previewLabel: piece.key,
+        check: (value) => {
+            const parsed = parseVerdict(value.text);
+            return parsed.ok ? undefined : parsed.reason;
+        },
+    });
+    if (!answer.ok)
+        return "held";
+    const verdict = parseVerdict(answer.value.text);
+    if (!verdict.ok)
+        throw new Error(verdict.reason);
+    const outcome = reviewOutcome({ passed: verdict.value.passed, mode, attempt, retries });
+    const saved = saveVerdict(deps.db, {
+        id: deps.ids.next(),
+        projectId: context.work.projectId,
+        revisionId: context.work.revisionId,
+        itemKey,
+        stage,
+        itemFingerprint: material.itemFingerprint,
+        reviewFingerprint: piece.fingerprint,
+        passed: verdict.value.passed,
+        reasons: verdict.value.reasons,
+        outcome,
+        attempt,
+        action: null,
+        actionAt: null,
+        redoState: outcome === "redo" ? "pending" : null,
+        redoError: null,
+        createdAt: deps.clock.now().toISOString(),
+    });
+    await publishResult(deps, context, piece, [], {
+        verdictId: saved.id,
+        passed: saved.passed,
+        reasons: saved.reasons,
+        outcome: saved.outcome,
+        attempt: saved.attempt,
+    });
+    deps.count?.("stage.completed", {
+        provider,
+        model,
+        tokensIn: answer.value.usage?.inputTokens ?? 0,
+        tokensOut: answer.value.usage?.outputTokens ?? 0,
+    });
+    return "done";
+}
+function reviewMaterial(deps, context, view, recipes, stage, itemKey, prompt) {
+    const config = view.revision.config;
+    const output = (workKey, role) => view.outputs.find((row) => row.workKey === workKey &&
+        row.selected &&
+        row.available &&
+        row.state === "ready" &&
+        (role === undefined || row.output.role === role));
+    const path = (row) => outputPath(deps.paths, context.work.projectId, row.output.path);
+    const text = (row) => clip(readFileSync(path(row), "utf8"));
+    const missing = (what, fix) => new Error(`The ${what} this review looks at is missing, so it could not be reviewed. ${fix}, then use Try again.`);
+    const request = (sections, images = []) => ({
+        stage,
+        instruction: prompt.trim() === "" ? defaultReviewPrompts[stage] : prompt,
+        sections,
+        images,
+    });
+    switch (stage) {
+        case "article": {
+            const article = output(itemKey, "article_md");
+            if (article === undefined)
+                throw missing("article", "Use More → Write the article again in the Article section");
+            const notes = output("research:notes", "notes");
+            const research = notes !== undefined ? text(notes) : clip(config.provided.research?.trim() ?? "");
+            return {
+                request: request([
+                    {
+                        label: "Article prompt the article was written from",
+                        text: clip(config.rendered.article ?? ""),
+                    },
+                    ...(research === "" ? [] : [{ label: "Research notes", text: research }]),
+                    { label: "Article", text: text(article) },
+                ]),
+                images: [],
+                itemFingerprint: article.fingerprint,
+            };
+        }
+        case "images":
+        case "thumbnail": {
+            const image = output(itemKey);
+            if (image === undefined)
+                throw missing(stage === "images" ? "image" : "thumbnail", stage === "images"
+                    ? "Use More → make it again in its section on Images"
+                    : "Use More → make it again in its section on Thumbnail");
+            const recipe = recipes.find((one) => one.key === itemKey);
+            const brief = recipe?.input.kind === "image" ? recipe.input.prompt : "";
+            const reference = stage === "images" ? output("reference:image") : undefined;
+            return {
+                request: request([
+                    ...(stage === "thumbnail" ? [{ label: "Video title", text: config.title }] : []),
+                    ...(brief === "" ? [] : [{ label: "Brief the image was drawn from", text: brief }]),
+                ], [
+                    stage === "images" ? "the image to review" : "the thumbnail to review",
+                    ...(reference === undefined ? [] : ["the establishing image it must match"]),
+                ]),
+                images: [
+                    {
+                        path: path(image),
+                        name: stage === "images" ? "the image to review" : "the thumbnail to review",
+                    },
+                    ...(reference === undefined
+                        ? []
+                        : [{ path: path(reference), name: "the establishing image it must match" }]),
+                ],
+                itemFingerprint: image.fingerprint,
+            };
+        }
+        case "narration": {
+            const timing = output("subtitles:timing", "subtitle_words");
+            if (timing === undefined || itemKey !== narrationItemKey)
+                throw missing("narration's word timing", "Use More → Render the video again in the Video section");
+            const { words, omissions } = wordsSchema.parse(JSON.parse(readFileSync(path(timing), "utf8")));
+            const unsure = words.filter((word) => (word.confidence ?? 1) < 0.3).length;
+            return {
+                request: request([
+                    {
+                        label: "Text the narration was read from",
+                        text: clip(plainText(view.articleMarkdown ?? "")),
+                    },
+                    { label: "What the timing heard", text: clip(words.map((word) => word.text).join(" ")) },
+                    {
+                        label: "Stretches of text the timing could not hear",
+                        text: omissions.length === 0
+                            ? "None."
+                            : omissions.map((gap) => `At ${gap.start.toFixed(1)} s: ${gap.text}`).join("\n"),
+                    },
+                    {
+                        label: "Words heard with low confidence",
+                        text: `${String(unsure)} of ${String(words.length)}.`,
+                    },
+                ]),
+                images: [],
+                itemFingerprint: timing.fingerprint,
+            };
+        }
+        case "shorts": {
+            const render = output(`${itemKey}:render`);
+            if (render === undefined)
+                throw missing("short", "Use Make this short again in Edit project → Shorts");
+            const number = Number(itemKey.slice("shorts:".length));
+            const pick = view.pieces.find((row) => row.key === "shorts:pick" && row.selected && row.piece.state === "done");
+            const title = pickedShortsOf(pick?.piece.payload)?.shorts.find((clip) => clip.number === number)?.title ??
+                "";
+            const stills = view.outputs
+                .filter((row) => row.workKey.startsWith(`${itemKey}:image:`) &&
+                row.selected &&
+                row.available &&
+                row.state === "ready")
+                .slice(0, 6);
+            if (stills.length === 0)
+                throw missing("short's images", "Use Make this short again in Edit project → Shorts");
+            const names = stills.map((_, index) => `image ${String(index + 1)} of the short`);
+            return {
+                request: request([{ label: "Title of the short", text: title }], names),
+                images: stills.map((row, index) => ({
+                    path: path(row),
+                    name: names[index] ?? "an image of the short",
+                })),
+                itemFingerprint: render.fingerprint,
+            };
+        }
+    }
+}
+function clip(value) {
+    return value.length <= textMax ? value : `${value.slice(0, textMax)}\n[... cut for length]`;
+}

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

@@ -4,8 +4,10 @@ import { executeExportRecipe } from "./runtime-export.js";
 import { executeLocalRecipe } from "./runtime-local.js";
 import { pieceLabel } from "./runtime-piece-label.js";
 import { executeProviderRecipe } from "./runtime-provider.js";
+import { executeReviewRecipe } from "./runtime-review.js";
 import { executeShortsRecipe } from "./runtime-shorts.js";
 import { executeSubtitleRecipe } from "./runtime-subtitles.js";
+import { executeVoicesRecipe } from "./runtime-voices.js";
 import { executeYoutubeRecipe } from "./runtime-youtube.js";
 import { workPieces } from "./work-records.js";
 export async function runRevisionInvocation(deps, context, providers) {
@@ -22,17 +24,21 @@ export async function runRevisionInvocation(deps, context, providers) {
                     ? await executeExportRecipe(deps, context, piece)
                     : piece.key.startsWith("document:")
                         ? await executeDocumentRecipe(deps, context, piece)
-                        : piece.key.startsWith("youtube:")
-                            ? await executeYoutubeRecipe(deps, context, providers, piece)
-                            : piece.key.startsWith("shorts:")
-                                ? await executeShortsRecipe(deps, context, providers, piece)
-                                : piece.key.startsWith("animate:")
-                                    ? await executeAnimateRecipe(deps, context, providers, piece)
-                                    : piece.input.kind === "llm" ||
-                                        piece.input.kind === "tts" ||
-                                        piece.input.kind === "image"
-                                        ? await executeProviderRecipe(deps, context, providers, piece)
-                                        : await executeLocalRecipe(deps, context, piece);
+                        : piece.key.startsWith("review:")
+                            ? await executeReviewRecipe(deps, context, providers, piece)
+                            : piece.key.startsWith("voices:")
+                                ? await executeVoicesRecipe(deps, context, piece)
+                                : piece.key.startsWith("youtube:")
+                                    ? await executeYoutubeRecipe(deps, context, providers, piece)
+                                    : piece.key.startsWith("shorts:")
+                                        ? await executeShortsRecipe(deps, context, providers, piece)
+                                        : piece.key.startsWith("animate:")
+                                            ? await executeAnimateRecipe(deps, context, providers, piece)
+                                            : piece.input.kind === "llm" ||
+                                                piece.input.kind === "tts" ||
+                                                piece.input.kind === "image"
+                                                ? await executeProviderRecipe(deps, context, providers, piece)
+                                                : await executeLocalRecipe(deps, context, piece);
             if (outcome === "held")
                 return outcome;
         }

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

@@ -1,7 +1,10 @@
 import { readFileSync } from "node:fs";
 import { z } from "zod";
-import { usesShorts } from "../admission/rules.js";
+import { withLanguage, wordTimingUnavailable } from "../../kernel/ports/languages.js";
+import { usesFigureCards, usesShorts } from "../admission/rules.js";
+import { captionBoldFont } from "../fonts/coverage.js";
 import { resolveBoldFont } from "../fonts/index.js";
+import { masterGoal } from "../loudness/model.js";
 import { clipWords } from "../shorts/captions.js";
 import { effectiveClips, pickedShortsOf } from "../shorts/clips.js";
 import { defaultShortsPrompt, musicVolumeOf, shortImageCount, shortsSpeedOf, } from "../shorts/model.js";
@@ -11,15 +14,18 @@ import { renderShort } from "../shorts/render.js";
 import { allocateAsset, discardPreparedAssets, sealAsset, writeAsset } from "../storage/assets.js";
 import { outputPath, projectDir } from "../storage/layout.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
+import { usesVoices } from "../voices/model.js";
 import { sentencesText, transcriptSentences } from "../youtube/transcript.js";
 import { shortsPickKey } from "./recipe-shorts.js";
+import { figureShots } from "./runtime-export-edit.js";
 import { exportSnapshot, revisionAudio } from "./runtime-export-inputs.js";
+import { imageCall } from "./runtime-image.js";
 import { savedCatalogue } from "./runtime-plan.js";
 import { preparedResult, preparedTexts, publishResult } from "./runtime-publication.js";
 import { wordsSchema } from "./runtime-subtitles.js";
 // The Shorts step's four kinds of work (`recipe-shorts.ts`): the pick, each clip's image
 // prompts, each image, and each clip's render. Each is one piece of its own, so a failure
-// names the clip it belongs to and Retry stage redoes only what did not finish.
+// names the clip it belongs to and Try again redoes only what did not finish.
 export async function executeShortsRecipe(deps, context, providers, piece) {
     if (deps.db
         .prepare("SELECT state FROM revision_work_pieces WHERE id=? AND work_id=?")
@@ -39,7 +45,7 @@ export async function executeShortsRecipe(deps, context, providers, piece) {
         throw setupError();
     const clip = savedClips(snapshot).find((one) => one.number === number);
     if (clip === undefined)
-        throw new Error("The clip this short was cut from is no longer among the picked shorts. Use Pick different moments in Edit project → Shorts, then Retry stage.");
+        throw new Error("The clip this short was cut from is no longer among the picked shorts. Use Pick different moments in Edit project → Shorts, then Try again.");
     if (matched[2] === "prompts")
         return prompts(deps, context, providers, piece, snapshot, clip);
     if (matched[2] === "render")
@@ -57,10 +63,10 @@ async function pick(deps, context, providers, piece, snapshot) {
         throw setupError();
     const llm = config.llm;
     if (llm === undefined || llm.provider.trim() === "" || llm.model.trim() === "")
-        throw new Error("Shorts need an AI text model to pick the clips, and none is chosen. Choose one in Edit project → Providers, then Retry stage.");
+        throw new Error("Shorts need an AI text model to pick the clips, and none is chosen. Choose one in Edit project → Providers, then Try again.");
     const sentences = transcriptSentences(timingWords(deps, context, view));
     if (sentences.length === 0)
-        throw new Error("The narration's word timing holds no words, so there is nothing to cut shorts from. Use Re-run section on Video, then Retry stage.");
+        throw new Error("The narration's word timing holds no words, so there is nothing to cut shorts from. Use More → Render the video again in the Video section, then Try again.");
     const audio = await revisionAudio(deps, context, view);
     const durationSeconds = audio.reduce((sum, segment) => sum + segment.seconds, 0);
     const limits = {
@@ -80,13 +86,17 @@ async function pick(deps, context, providers, piece, snapshot) {
         count: shorts.count,
         minSeconds: shorts.minSeconds,
         maxSeconds: shorts.maxSeconds,
-        sentences: sentencesText(sentences),
+        sentences: sentencesText(sentences, usesVoices(config) && config.voices !== undefined
+            ? Object.fromEntries(config.voices.speakers.map((speaker) => [speaker.id, speaker.name.trim()]))
+            : undefined),
     };
     const ask = llmCall(deps, context, piece, view, (text) => {
         const checked = checkPicks(text, sentences, limits);
         return checked.ok ? undefined : checked.reason;
     });
-    const first = await providers.forPiece(piece.id).llm(ask(pickMessages(brief)));
+    const first = await providers
+        .forPiece(piece.id)
+        .llm(ask(withLanguage(pickMessages(brief), config.language)));
     if (!first.ok)
         return "held";
     let checked = checkPicks(first.value.text, sentences, limits);
@@ -99,7 +109,7 @@ async function pick(deps, context, providers, piece, snapshot) {
             return "held";
         const second = await providers
             .forPiece(piece.id)
-            .llm(ask(pickRetryMessages(brief, first.value.text, checked.problems)));
+            .llm(ask(withLanguage(pickRetryMessages(brief, first.value.text, checked.problems), config.language)));
         if (!second.ok)
             return "held";
         const again = checkPicks(second.value.text, sentences, limits);
@@ -163,12 +173,9 @@ async function image(deps, context, providers, piece, clip, index) {
     const input = piece.input;
     if (input.kind !== "image")
         throw setupError();
-    const made = await providers.forPiece(piece.id).image({
-        provider: input.provider,
-        model: input.model,
-        prompt: input.prompt,
-        aspect: input.aspect,
-    });
+    const made = await providers
+        .forPiece(piece.id)
+        .image(imageCall(deps, context.work.projectId, input, `Short ${String(clip.number)} image ${String(index)}`));
     if (!made.ok)
         return "held";
     const asset = writeAsset(deps, context.work.projectId, made.value.mime === "image/jpeg" ? "short-image.jpg" : "short-image.png", made.value.bytes);
@@ -193,13 +200,27 @@ async function render(deps, context, piece, snapshot, clip) {
         .map((recipe) => {
         const row = view.outputs.find((one) => one.workKey === recipe.key && one.selected && one.available && one.state === "ready");
         if (row === undefined)
-            throw new Error(`Short ${String(clip.number)} is missing one of its images. Retry stage to make it again; if it keeps happening, use Make this short again in Edit project → Shorts.`);
+            throw new Error(`Short ${String(clip.number)} is missing one of its images. Try again to make it again; if it keeps happening, use Make this short again in Edit project → Shorts.`);
         return outputPath(deps.paths, context.work.projectId, row.output.path);
     });
-    const words = clipWords(timingWords(deps, context, view), clip.start, clip.end);
-    const timeline = await revisionAudio(deps, context, view);
+    const allWords = timingWords(deps, context, view);
+    const words = clipWords(allWords, clip.start, clip.end);
+    // The upright cards whose descriptions fall in the clip, on the clip's own timeline.
+    const figures = usesFigureCards(config)
+        ? figureShots(deps, context, view, "9:16", allWords).flatMap((figure) => figure.end <= clip.start || figure.start >= clip.end
+            ? []
+            : [
+                {
+                    path: figure.path,
+                    start: Math.max(0, figure.start - clip.start),
+                    end: Math.min(clip.end, figure.end) - clip.start,
+                },
+            ])
+        : [];
+    const timeline = await revisionAudio(deps, context, view, { levelled: true });
     // The bundled Barlow is drawn in its own Bold face; any other font is emboldened.
-    const font = await resolveBoldFont(deps.paths, config.subtitles?.fontId ?? "default");
+    // In another language, a font that has its letters (`fonts/coverage.ts`).
+    const font = await captionBoldFont(deps.paths, config.subtitles?.fontId ?? "default", config.language);
     const shorts = config.shorts;
     const speed = shorts === undefined ? 1 : shortsSpeedOf(shorts);
     const music = await backgroundMusic(deps, context, view);
@@ -209,8 +230,9 @@ async function render(deps, context, piece, snapshot, clip) {
     const prepared = [];
     const seconds = (clip.end - clip.start) / speed;
     try {
-        await renderShort({
+        const master = await renderShort({
             bin: deps.ffmpeg,
+            master: masterGoal(config, "video"),
             timeline,
             start: clip.start,
             end: clip.end,
@@ -219,8 +241,10 @@ async function render(deps, context, piece, snapshot, clip) {
             motionStyle: config.motionStyle,
             zoomPercent: config.zoomPercent,
             words,
+            ...(wordTimingUnavailable(config.language) === undefined ? {} : { wordByWord: false }),
             font,
             ...(shorts?.titleOnScreen === true ? { title: clip.title } : {}),
+            ...(figures.length === 0 ? {} : { figures }),
             speed,
             music,
             output: pending.absolutePath,
@@ -241,6 +265,7 @@ async function render(deps, context, piece, snapshot, clip) {
         prepared.push(preparedResult(deps, context, piece, "short_video", asset, durationMs, {
             short: clip.number,
             sentences: [clip.first, clip.last],
+            ...(master === undefined ? {} : { master }),
         }));
         await publishResult(deps, context, piece, prepared, { short: clip.number, start: clip.start, end: clip.end, durationMs }, asset);
         // One per rendered short, with no stage: stage "video" would read as a finished video.
@@ -273,7 +298,7 @@ async function backgroundMusic(deps, context, view) {
     const shorts = view.revision.config.shorts;
     if (assetId === undefined || shorts === undefined)
         return undefined;
-    const fix = "Choose another file under Background music in Edit project → Shorts, or remove the music, then Retry stage.";
+    const fix = "Choose another file under Background music in Edit project → Shorts, or remove the music, then Try again.";
     const row = z
         .object({ path: z.string() })
         .safeParse(deps.db
@@ -294,14 +319,14 @@ async function backgroundMusic(deps, context, view) {
         throw new Error(`The shorts' background music file holds no sound. ${fix}`);
     return { path, volume: musicVolumeOf(shorts) };
 }
-function timingWords(deps, context, view) {
+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 shorts are cut and captioned from, is missing. Use Re-run section on Video, then Retry stage.");
+        throw new Error("The narration's word timing, which the shorts are cut and captioned from, 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;
 }
 // The project's text model, with the thinking settings saved for this step's catalogue.
@@ -326,5 +351,5 @@ function imageIndex(key) {
     return Number(key.split(":").at(-1));
 }
 function setupError() {
-    return new Error("Slopify hit an internal error (a Shorts step was set up wrongly). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+    return new Error("Slopify hit an internal error (a Shorts step was set up wrongly). Try again; if it happens again, use Download diagnostics in Settings and report it.");
 }

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

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { stageKinds, stageStates } from "../../kernel/pipeline.js";
 import { sourceOf } from "../admission/model.js";
 import { usesShorts, usesYoutubeDescription } from "../admission/rules.js";
+import { reviewsNarration } from "../reviews/rules.js";
 import { currentRevisionId } from "../revisions/repo.js";
 import { getRevisionView } from "../revisions/view.js";
 import { settleScheduleRunsForProject } from "../schedules/repo.js";
@@ -40,7 +41,8 @@ export function executionStages(deps, projectId) {
             view?.revision.content.subtitleCues !== undefined &&
             !usesYoutubeDescription(view.revision.config) &&
             !usesShorts(view.revision.config) &&
-            !editNeedsTiming(view.revision.config))
+            !editNeedsTiming(view.revision.config) &&
+            !reviewsNarration(view.revision.config))
             return false;
         if (piece.input.kind === "deferred" && piece.key.endsWith(":future")) {
             const cacheKey = String(row.id);
@@ -78,10 +80,13 @@ export function executionStages(deps, projectId) {
 }
 export function invocationReady(deps, work) {
     const row = deps.db
-        .prepare("SELECT recipe_context FROM revision_work WHERE id=? AND project_id=? AND revision_id=?")
+        .prepare("SELECT recipe_context,retry_at FROM revision_work WHERE id=? AND project_id=? AND revision_id=?")
         .get(work.workId, work.projectId, work.revisionId);
     if (row?.recipe_context === null || row === undefined)
         return false;
+    // Waiting out a failure time can fix: `dueRetries` clears the wait when it runs out.
+    if (row.retry_at !== null)
+        return false;
     const view = executionView(deps, work.projectId, work.revisionId);
     if (view === undefined)
         return false;
@@ -129,6 +134,9 @@ export function executionStandings(deps, projectId, derived) {
             return retained ? { ...entry, state: "done" } : entry;
         });
         let state = source === "off" ? "skipped" : source === "provide" ? "provided" : "pending";
+        const retryAt = group.some((entry) => entry.state === "failed")
+            ? null
+            : latestRetry(deps, group);
         if (group.some((entry) => entry.state === "running"))
             state = "running";
         else if (group.some((entry) => entry.state === "failed"))
@@ -141,9 +149,23 @@ export function executionStandings(deps, projectId, derived) {
                     ? "provided"
                     : "done"
                 : "pending";
-        return { kind, state };
+        return state === "pending" && retryAt !== null ? { kind, state, retryAt } : { kind, state };
     });
 }
+// The latest wait among a stage's steps that went back to wait after a failure time can fix.
+function latestRetry(deps, group) {
+    let latest = null;
+    for (const entry of group) {
+        if (entry.state !== "pending")
+            continue;
+        const at = deps.db
+            .prepare("SELECT retry_at FROM revision_work WHERE id=?")
+            .get(entry.work.workId)?.retry_at;
+        if (typeof at === "string" && (latest === null || at > latest))
+            latest = at;
+    }
+    return latest;
+}
 export function projectStandings(deps, projectId) {
     // One derivation serves every stage: each builds the whole execution plan.
     const work = executionStages(deps, projectId);
@@ -159,15 +181,19 @@ export function projectStandings(deps, projectId) {
                 .get(entry.work.workId);
             return total + fraction(progress?.progress_current, progress?.progress_total);
         }, 0);
-        const failed = all.find((work) => work.state === "failed");
+        // A failed step, or else one waiting to run again, says why on the stage row.
+        const failed = all.find((work) => work.state === "failed") ??
+            (stage.retryAt === undefined || stage.retryAt === null
+                ? undefined
+                : all.find((work) => work.state === "pending"));
         const failure = failed === undefined
-            ? null
-            : (deps.db
-                .prepare("SELECT failure_reason FROM revision_work WHERE id=?")
-                .get(failed.work.workId)?.failure_reason ?? null);
+            ? undefined
+            : deps.db
+                .prepare("SELECT failure_reason,failure_kind FROM revision_work WHERE id=?")
+                .get(failed.work.workId);
         deps.db
-            .prepare("UPDATE stages SET state=?,failure_reason=?,progress_current=?,progress_total=?,finished_at=CASE WHEN ?='done' THEN ? ELSE NULL END WHERE project_id=? AND kind=?")
-            .run(stage.state, failure, invocations.length === 0 ? null : current, invocations.length === 0 ? null : invocations.length, stage.state, deps.clock.now().toISOString(), projectId, stage.kind);
+            .prepare("UPDATE stages SET state=?,failure_reason=?,failure_kind=?,retry_at=?,progress_current=?,progress_total=?,finished_at=CASE WHEN ?='done' THEN ? ELSE NULL END WHERE project_id=? AND kind=?")
+            .run(stage.state, textOf(failure?.failure_reason), textOf(failure?.failure_kind), stage.retryAt ?? null, invocations.length === 0 ? null : current, invocations.length === 0 ? null : invocations.length, stage.state, deps.clock.now().toISOString(), projectId, stage.kind);
     }
     settleScheduleRunsForProject(deps.db, projectId, deps.clock.now().toISOString());
 }
@@ -225,6 +251,9 @@ const spokenKey = /^audio:(?:intro|body|outro)(?::(?!concat$|future$).+)?$/;
 function spoken(deps, workId) {
     return workPieces(deps.db, workId).some((piece) => spokenKey.test(piece.key));
 }
+function textOf(value) {
+    return typeof value === "string" ? value : null;
+}
 function fraction(current, total) {
     if (typeof current !== "number" || typeof total !== "number" || total <= 0)
         return 0;