@gentbajko/slopify 3.25.9 → 4.1.0

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

@@ -1,17 +1,22 @@
 import { readFileSync } from "node:fs";
 import { z } from "zod";
+import { internalError } from "../../kernel/errors.js";
 import { thinkingModes } from "../../kernel/ports/llm.js";
+import { editSettings } from "../../kernel/ports/settings-places.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 { isReadyOutput } from "../revisions/view.js";
 import { pickedShortsOf } from "../shorts/clips.js";
 import { outputPath } from "../storage/layout.js";
+import { openingOf, spokenArticle } from "./review-promise.js";
 import { exportSnapshot, revisionTranscript, } from "./runtime-export-inputs.js";
-import { savedCatalogue } from "./runtime-plan.js";
+import { workLlm } from "./runtime-plan.js";
 import { publishResult } from "./runtime-publication.js";
 import { wordsSchema } from "./runtime-subtitles.js";
+import { pieceAlreadyDone } from "./work-records.js";
 // What `recipe-reviews.ts` saves in the step's values, by position.
 const valuesSchema = z.tuple([
     z.enum(reviewStages),
@@ -32,9 +37,7 @@ const textMax = 60_000;
 // 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")
+    if (pieceAlreadyDone(deps.db, context.work.workId, piece.id))
         return "done";
     if (!context.maySubmit(piece.id))
         return "held";
@@ -44,33 +47,24 @@ export async function executeReviewRecipe(deps, context, providers, piece) {
         ? 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.");
+        throw new Error(internalError("a review step was set up wrongly"));
     const [stage, itemKey, , provider, model, thinking, prompt, mode, retries] = values.data;
     const snapshot = exportSnapshot(deps, context, piece);
     const material = reviewMaterial(deps, context, snapshot, 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);
+    const call = workLlm(deps.db, context.work.workId, { provider, model, thinking: level }, piece.key);
     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),
+    const answer = await providers.forPiece(piece.id).llm(call({
         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);
@@ -126,10 +120,7 @@ export async function executeReviewRecipe(deps, context, providers, piece) {
 // and outro, and the prepared or hand-edited spoken text rather than the article as written.
 // Falls back to the article when those texts can't be read.
 function spokenText(deps, snapshot) {
-    const present = ["intro", "body", "outro"].filter((kind) => snapshot.view.outputs.some((one) => one.selected &&
-        one.available &&
-        one.state === "ready" &&
-        one.output.role === `audio_${kind}`));
+    const present = ["intro", "body", "outro"].filter((kind) => snapshot.view.outputs.some((one) => isReadyOutput(one) && one.output.role === `audio_${kind}`));
     try {
         const text = present.map((kind) => revisionTranscript(deps, snapshot, kind)).join("\n\n");
         if (text.trim() !== "")
@@ -145,9 +136,7 @@ export function reviewMaterial(deps, context, snapshot, stage, itemKey, prompt)
     const recipes = snapshot.plan.recipes;
     const config = view.revision.config;
     const output = (workKey, role) => view.outputs.find((row) => row.workKey === workKey &&
-        row.selected &&
-        row.available &&
-        row.state === "ready" &&
+        isReadyOutput(row) &&
         (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"));
@@ -178,13 +167,33 @@ export function reviewMaterial(deps, context, snapshot, stage, itemKey, prompt)
                 itemFingerprint: article.fingerprint,
             };
         }
+        // The opening as the viewer will hear it, against what the title and the thumbnail brief
+        // promise; the whole article shows whether the promise is kept later on.
+        case "promise": {
+            const article = output("article:body", "article_md");
+            if (article === undefined)
+                throw missing("article", "Use More → Write the article again in the Article section");
+            const spoken = spokenArticle(readFileSync(path(article), "utf8"));
+            const thumbnail = recipes.find((one) => one.key === "thumbnail:image");
+            const brief = thumbnail?.input.kind === "image" ? thumbnail.input.prompt.trim() : "";
+            return {
+                request: request([
+                    { label: "Video title", text: config.title },
+                    ...(brief === "" ? [] : [{ label: "Thumbnail brief", text: clip(brief) }]),
+                    { label: "Opening (first ~30 s)", text: openingOf(spoken) },
+                    { label: "Whole article", text: clip(spoken) },
+                ]),
+                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");
+                    ? "Press Make this image again on it in the project's Images section"
+                    : "Press Make the thumbnail again in the project's Images section");
             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;
@@ -218,7 +227,7 @@ export function reviewMaterial(deps, context, snapshot, stage, itemKey, prompt)
         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");
+                throw missing("narration's word timing", "Press Make the video again in the project's 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 {
@@ -246,19 +255,16 @@ export function reviewMaterial(deps, context, snapshot, stage, itemKey, prompt)
         case "shorts": {
             const render = output(`${itemKey}:render`);
             if (render === undefined)
-                throw missing("short", "Use Make this short again in Edit project → Shorts");
+                throw missing("short", `Use Make this short again in ${editSettings.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")
+                .filter((row) => row.workKey.startsWith(`${itemKey}:image:`) && isReadyOutput(row))
                 .slice(0, 6);
             if (stills.length === 0)
-                throw missing("short's images", "Use Make this short again in Edit project → Shorts");
+                throw missing("short's images", `Use Make this short again in ${editSettings.shorts}`);
             const names = stills.map((_, index) => `image ${String(index + 1)} of the short`);
             return {
                 request: request([{ label: "Title of the short", text: title }], names),

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

@@ -2,6 +2,7 @@ import { executeAgentReviewRecipe } from "./runtime-agent-review.js";
 import { executeAnimateRecipe } from "./runtime-animate.js";
 import { executeDocumentRecipe } from "./runtime-document.js";
 import { executeExportRecipe } from "./runtime-export.js";
+import { lateKeywordProviders, lateValuesOf } from "./runtime-keywords.js";
 import { executeLocalRecipe } from "./runtime-local.js";
 import { pieceLabel } from "./runtime-piece-label.js";
 import { executeProviderRecipe } from "./runtime-provider.js";
@@ -11,7 +12,9 @@ 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) {
+export async function runRevisionInvocation(deps, context, sent) {
+    // `{{Slopify_Release_Date}}` and `{{Slopify_Duration}}` are filled as a request is sent.
+    const providers = lateKeywordProviders(sent, () => lateValuesOf(deps, context));
     const pieces = workPieces(deps.db, context.work.workId).filter((piece) => !piece.key.startsWith("article:continuation:"));
     let waiting = false;
     for (const piece of pieces) {

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

@@ -1,10 +1,11 @@
-import { readFileSync } from "node:fs";
-import { z } from "zod";
+import { errorText, internalError } from "../../kernel/errors.js";
 import { withLanguage, wordTimingUnavailable } from "../../kernel/ports/languages.js";
+import { editSettings } from "../../kernel/ports/settings-places.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 { assetPathOrUndefined } from "../revisions/mutation-assets.js";
+import { readyOutput } from "../revisions/view.js";
 import { clipWords } from "../shorts/captions.js";
 import { effectiveClips, pickedShortsOf } from "../shorts/clips.js";
 import { anchorKept, lostMessage, withNewPicks } from "../shorts/keep.js";
@@ -18,21 +19,21 @@ 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 { exportMachine, warningsOf } from "./runtime-export.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 { workLlm } from "./runtime-plan.js";
 import { softenIfAsked } from "./runtime-provider.js";
 import { preparedResult, preparedTexts, publishResult } from "./runtime-publication.js";
-import { wordsSchema } from "./runtime-subtitles.js";
+import { readTimingWords } from "./runtime-subtitles.js";
 import { clearSoftening } from "./soften.js";
+import { pieceAlreadyDone } from "./work-records.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 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=?")
-        .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";
@@ -48,7 +49,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 Try again.");
+        throw new Error(`The clip this short was cut from is no longer among the picked shorts. Use Pick different moments in ${editSettings.shorts}, then Try again.`);
     if (matched[2] === "prompts")
         return prompts(deps, context, providers, piece, snapshot, clip);
     if (matched[2] === "render")
@@ -66,10 +67,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 Try again.");
-    const sentences = transcriptSentences(timingWords(deps, context, view));
+        throw new Error(`Shorts need an AI model to pick the clips, and none is chosen. Choose a Service and a Model in ${editSettings.writer}, then Try again.`);
+    const sentences = transcriptSentences(readTimingWords(deps, context, view, shortsTimingPurpose).words);
     if (sentences.length === 0)
-        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.");
+        throw new Error("The narration's word timing holds no words, so there is nothing to cut shorts from. Press Make the video again in the project's Video section, then Try again.");
     const audio = await revisionAudio(deps, context, view);
     const durationSeconds = audio.reduce((sum, segment) => sum + segment.seconds, 0);
     // Kept shorts are found again in this timing; the model is asked only for the rest.
@@ -236,12 +237,12 @@ async function render(deps, context, piece, snapshot, clip) {
         .filter((recipe) => recipe.key.startsWith(prefix))
         .toSorted((left, right) => imageIndex(left.key) - imageIndex(right.key))
         .map((recipe) => {
-        const row = view.outputs.find((one) => one.workKey === recipe.key && one.selected && one.available && one.state === "ready");
+        const row = readyOutput(view, { workKey: recipe.key });
         if (row === undefined)
-            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.`);
+            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 ${editSettings.shorts}.`);
         return outputPath(deps.paths, context.work.projectId, row.output.path);
     });
-    const allWords = timingWords(deps, context, view);
+    const allWords = readTimingWords(deps, context, view, shortsTimingPurpose).words;
     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)
@@ -268,8 +269,11 @@ async function render(deps, context, piece, snapshot, clip) {
     const prepared = [];
     const seconds = (clip.end - clip.start) / speed;
     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: clip.start,
@@ -303,12 +307,13 @@ 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],
+            ...warningsOf(machine.notices),
             ...(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.
         // Its pick and prompt tokens are not counted here.
-        deps.count?.("stage.completed", { shorts: 1 });
+        deps.count?.("stage.completed", { shorts: 1 }, context.work.projectId);
         return "done";
     }
     finally {
@@ -340,58 +345,34 @@ 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 Try again.";
-    const row = z
-        .object({ path: z.string() })
-        .safeParse(deps.db
-        .prepare("SELECT path FROM project_assets WHERE project_id=? AND id=?")
-        .get(context.work.projectId, assetId));
-    if (!row.success)
+    const fix = `Choose another file under Background music in ${editSettings.shorts}, or remove the music, then Try again.`;
+    const saved = assetPathOrUndefined(deps, context.work.projectId, assetId);
+    if (saved === undefined)
         throw new Error(`The shorts' background music 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 shorts' background music couldn't be read as audio (${error instanceof Error ? error.message : String(error)}). ${fix}`);
+        throw new Error(`The shorts' background music couldn't be read as audio (${errorText(error)}). ${fix}`);
     }
     if (durationMs <= 0)
         throw new Error(`The shorts' background music file holds no sound. ${fix}`);
     return { path, volume: musicVolumeOf(shorts) };
 }
-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 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;
-}
+// What the shorts read the narration's word timing for, in the sentence a missing one fails with.
+const shortsTimingPurpose = "the shorts are cut and captioned from";
 // The project's text model, with the thinking settings saved for this step's catalogue.
 function llmCall(deps, context, piece, view, check) {
     const llm = view.revision.config.llm ?? { provider: "", model: "" };
-    const row = deps.db
-        .prepare("SELECT recipe_context FROM revision_work WHERE id=?")
-        .get(context.work.workId);
-    const model = savedCatalogue(row?.recipe_context).llm.find((one) => one.provider === llm.provider && one.id === llm.model);
-    return (messages) => ({
-        provider: llm.provider,
-        model: llm.model,
-        ...(llm.thinking === undefined ? {} : { thinking: llm.thinking }),
-        thinkingConfig: llm.thinking === undefined ? null : (model?.llm.thinking?.[llm.thinking] ?? null),
-        messages,
-        webSearch: false,
-        previewLabel: piece.key,
-        check: (value) => check(value.text),
-    });
+    const call = workLlm(deps.db, context.work.workId, llm, piece.key);
+    return (messages) => call({ messages, check: (value) => check(value.text) });
 }
 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). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+    return new Error(internalError("a Shorts step was set up wrongly"));
 }

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

@@ -6,7 +6,7 @@ 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 { getRevisionView, isDonePiece, isReadyOutput } from "../revisions/view.js";
 import { settleScheduleRunsForProject } from "../schedules/repo.js";
 import { editNeedsTiming } from "../video/edit-settings.js";
 import { executionPlan, executionView, savedCatalogue } from "./runtime-plan.js";
@@ -146,14 +146,9 @@ export function executionStandings(deps, projectId, derived) {
             .map((entry) => {
             const pieces = workPieces(deps.db, entry.work.workId);
             const retained = pieces.length > 0 &&
-                pieces.every((piece) => view.outputs.some((output) => output.workKey === piece.key &&
-                    output.selected &&
-                    output.available &&
-                    output.state === "ready") ||
+                pieces.every((piece) => view.outputs.some((output) => output.workKey === piece.key && isReadyOutput(output)) ||
                     view.pieces.some((output) => output.key === piece.key &&
-                        output.selected &&
-                        output.available &&
-                        output.piece.state === "done" &&
+                        isDonePiece(output) &&
                         (output.fingerprint === piece.fingerprint ||
                             madeFrom(deps, projectId, piece.key, output.fingerprint, piece.fingerprint))));
             // Save can bind an existing asset without granting its placeholder invocation.
@@ -228,7 +223,13 @@ export function projectStandings(deps, projectId) {
         }, 0);
         // A failed step, or else one waiting to run again, says why on the stage row. A failed
         // stage keeps the moment it failed: needs_attention tells a narration retry started after
-        // the failure (still going) from one started before it (spent) by it.
+        // the failure (still going) from one started before it (spent) by it. A stage's start is
+        // the moment it went running, kept through a wait to retry, between its steps (one done,
+        // the next not claimed yet) and once it ends; a pending start is kept only then, so a
+        // stage made again after it was done takes a new one when it runs. A done
+        // stage keeps the moment it finished: the project's run length, the time left on a running
+        // step and the usual time a step takes (`eta/history.ts`) read them, and a later save that
+        // changes nothing in the stage moves neither.
         const failed = all.find((work) => work.state === "failed") ??
             (stage.retryAt === undefined || stage.retryAt === null
                 ? undefined
@@ -241,7 +242,16 @@ export function projectStandings(deps, projectId) {
         deps.db
             .prepare(`UPDATE stages SET state=:state,failure_reason=:reason,failure_kind=:kind,retry_at=:retryAt,
            progress_current=:current,progress_total=:total,
-           finished_at=CASE WHEN :state='done' THEN :now
+           started_at=CASE
+             WHEN :state='running' THEN CASE
+               WHEN started_at IS NOT NULL AND state IN ('running','pending') THEN started_at
+               ELSE :now END
+             WHEN :state IN ('done','failed') THEN started_at
+             WHEN :state='pending' AND :retryAt IS NOT NULL THEN started_at
+             WHEN :state='pending' AND state IN ('running','pending') AND :current > 0 THEN started_at
+             ELSE NULL END,
+           finished_at=CASE
+             WHEN :state='done' THEN CASE WHEN state='done' AND finished_at IS NOT NULL THEN finished_at ELSE :now END
              WHEN :state='failed' THEN CASE WHEN state='failed' AND finished_at IS NOT NULL THEN finished_at ELSE :now END
              ELSE NULL END
          WHERE project_id=:projectId AND kind=:stage`)

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

@@ -1,12 +1,15 @@
 import { readFileSync } from "node:fs";
 import { z } from "zod";
+import { internalError } from "../../kernel/errors.js";
 import { subtitleModelDir } from "../../kernel/paths.js";
 import { projectLanguage } from "../../kernel/ports/languages.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { SubtitleMismatch } from "../../kernel/ports/subtitles.js";
 import { narrationAliasesOf } from "../admission/rules.js";
 import { captionFont, captionFontDeps } from "../fonts/coverage.js";
 import { resolveFont } from "../fonts/index.js";
 import { validateCues } from "../revisions/rules.js";
+import { donePiece, isReadyOutput, readyOutput } from "../revisions/view.js";
 import { discardPreparedAssets, writeAsset } from "../storage/assets.js";
 import { outputPath } from "../storage/layout.js";
 import { captionCues, serializeAss, serializeSrt, serializeVtt } from "../subtitles/captions.js";
@@ -47,6 +50,14 @@ const cuesSchema = z.object({
     })),
     omissions: wordsSchema.shape.omissions,
 });
+// The narration's word timing (`subtitles:timing`), read for a step that needs it. `purpose` says
+// what the step uses it for, in the sentence a missing timing fails with.
+export function readTimingWords(deps, context, view, purpose) {
+    const timing = readyOutput(view, { workKey: "subtitles:timing", role: "subtitle_words" });
+    if (timing === undefined)
+        throw new Error(`The narration's word timing, which ${purpose}, is missing. Press Make the video again in the project's Video section, then Try again.`);
+    return wordsSchema.parse(JSON.parse(readFileSync(outputPath(deps.paths, context.work.projectId, timing.output.path), "utf8")));
+}
 export async function executeSubtitleRecipe(deps, context, piece) {
     if (!context.maySubmit(piece.id))
         return "held";
@@ -58,15 +69,15 @@ export async function executeSubtitleRecipe(deps, context, piece) {
         return cues(deps, context, piece, snapshot);
     if (piece.key === "subtitles:files")
         return files(deps, context, piece, snapshot);
-    throw new Error("Slopify hit an internal error (unknown kind of caption step). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+    throw new Error(internalError("unknown kind of caption step"));
 }
 async function timing(deps, context, piece, snapshot) {
     const audio = await revisionAudio(deps, context, snapshot.view);
     if (audio.length === 0)
-        throw new Error("Captions and the YouTube description need narration audio, but this project has none. Turn captions and the YouTube description off in Edit project, or turn narration on, then Try again.");
+        throw new Error(`Captions and the YouTube description need narration audio, but this project has none. Turn captions off in ${editSettings.captions} and the YouTube description off in ${editSettings.extras}, or turn narration on, then Try again.`);
     const alignSubtitles = deps.alignSubtitles;
     if (alignSubtitles === undefined)
-        throw new Error("Slopify hit an internal error (the caption timing tool is missing from this build). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the caption timing tool is missing from this build"));
     if (!context.maySubmit(piece.id))
         return "held";
     const words = [];
@@ -111,7 +122,7 @@ async function timing(deps, context, piece, snapshot) {
         offset += segment.seconds;
     }
     if (captionCues(words).length === 0)
-        throw new Error("None of the narration could be matched to the article text, so captions can't be timed. The narration must be in the project language set in Edit project → Language; if you uploaded your own audio, make sure it reads the article text, then Try again.");
+        throw new Error(`None of the narration could be matched to the article text, so captions can't be timed. The narration must be in the project's language (${editSettings.language}); if you uploaded your own audio, make sure it reads the article text, then Try again.`);
     context.signal.throwIfAborted();
     const output = preparedText(deps, context, piece, "subtitle_words", "subtitles.json", JSON.stringify({ key: piece.logicalFingerprint ?? piece.fingerprint, words, omissions }));
     await publishResult(deps, context, piece, [output], { words, omissions }, output.asset);
@@ -123,7 +134,7 @@ async function cues(deps, context, piece, snapshot) {
     let value;
     if (manual !== undefined) {
         if (plan.work.find((one) => one.key === piece.key)?.disposition === "review")
-            throw new Error("Your edited captions were written for an older version of the narration. Review them in Edit project → Captions and save, then Try again.");
+            throw new Error(`Your edited captions were written for an older version of the narration. Look them over in ${editSettings.captions} and save, then Try again.`);
         const audio = await revisionAudio(deps, context, view);
         const errors = validateCues(manual.cues, audio.reduce((sum, segment) => sum + segment.seconds, 0));
         if (errors.length > 0)
@@ -131,12 +142,9 @@ async function cues(deps, context, piece, snapshot) {
         value = { cues: [...manual.cues], omissions: [] };
     }
     else {
-        const output = view.outputs.find((one) => one.selected &&
-            one.available &&
-            one.state === "ready" &&
-            one.workKey === "subtitles:timing");
+        const output = readyOutput(view, { workKey: "subtitles:timing" });
         if (output === undefined)
-            throw new Error("Caption timing is missing. Use More → Render the video again in the Video section, then Try again.");
+            throw new Error("Caption timing is missing. Press Make the video again in the project's Video section, then Try again.");
         const timed = wordsSchema.parse(JSON.parse(readFileSync(outputPath(deps.paths, context.work.projectId, output.output.path), "utf8")));
         value = { cues: [...captionCues(timed.words)], omissions: timed.omissions };
     }
@@ -150,10 +158,10 @@ async function files(deps, context, piece, snapshot) {
     const { view } = snapshot;
     const config = view.revision.config.subtitles;
     if (config === undefined || config.mode === "off")
-        throw new Error("Slopify hit an internal error (captions are off for this version of the project). Try again; if it happens again, use Download diagnostics in Settings and report it.");
-    const row = view.pieces.find((one) => one.key === "subtitles:cues" && one.selected && one.available && one.piece.state === "done");
+        throw new Error(internalError("captions are off for this version of the project"));
+    const row = donePiece(view, "subtitles:cues");
     if (row?.piece.payload === null || row?.piece.payload === undefined)
-        throw new Error("The captions haven't been prepared yet. Use More → Render the video again in the Video section, then Try again.");
+        throw new Error("The captions haven't been prepared yet. Press Make the video again in the project's Video section, then Try again.");
     const value = cuesSchema.parse(JSON.parse(row.piece.payload));
     const previous = view.outputs.find((one) => one.output.role === "subtitle_font" && one.selected && one.available);
     const previousFiles = view.pieces.find((one) => one.key === "subtitles:files" &&
@@ -219,9 +227,7 @@ async function files(deps, context, piece, snapshot) {
         ])
             prepared.push(preparedText(deps, context, piece, role, filename, text));
         prepared.push(preparedResult(deps, context, piece, "subtitle_font", writeAsset(deps, context.work.projectId, `selected${font.extension}`, readFileSync(font.path))));
-        const media = view.outputs.find((one) => one.selected &&
-            one.available &&
-            one.state === "ready" &&
+        const media = view.outputs.find((one) => isReadyOutput(one) &&
             (one.output.role === "audio_export" ||
                 (one.output.role === "video" && config.mode === "files")));
         if (media !== undefined) {
@@ -295,9 +301,6 @@ function mismatchChunks(snapshot, segment) {
         return [];
     }
 }
-export function mismatchMessage(snapshot, segment, mismatch) {
-    return describeMismatch(mismatchChunks(snapshot, segment), segment, mismatch);
-}
 // The chunk that holds the words the audio stopped matching, by index; -1 when none does.
 export function mismatchChunk(chunks, mismatch) {
     const probe = comparable(mismatch.expected).split(" ").slice(0, 6).join(" ");
@@ -316,19 +319,19 @@ retry) {
         : `${clock(mismatch.at)} into the ${segment} narration, in narration chunk ${String(at + 1)} of ${String(chunks.length)} (it starts "${opening(chunk.spokenText)}")`;
     const expected = mismatch.expected === "" ? "the end of the text" : `"${mismatch.expected}…"`;
     const heard = mismatch.heard === "" ? "no more speech" : `"${mismatch.heard.toLowerCase()}…"`;
-    const stopped = `Subtitles stopped matching the audio at ${where}. The text expected ${expected} but the audio has ${heard}`;
+    const stopped = `Captions stopped matching the audio at ${where}. The text expected ${expected} but the audio has ${heard}`;
     if (retry !== undefined) {
         const n = String(retry.chunk);
         return retry.try === undefined
-            ? `${stopped} Slopify already recorded narration chunk ${n} again ${String(narrationRetryLimit)} times and the audio still doesn't match there, so the voice probably reads something its own way (a year, an abbreviation or a name). Listen at ${clock(mismatch.at)}: if words are missing or wrong, reword that sentence in Edit project → Narration → narration chunk ${n}, save, then Continue the run. If it says them right, use Download diagnostics in Settings and report it.`
-            : `${stopped} The voice probably skipped or garbled words there, so Slopify is recording narration chunk ${n} again by itself (try ${String(retry.try)} of ${String(narrationRetryLimit)}) and carries on with the video when it's done. If this message is still here in a few minutes, regenerate narration chunk ${n} in Edit project → Narration, then Continue the run.`;
+            ? `${stopped} Slopify already recorded narration chunk ${n} again ${String(narrationRetryLimit)} times and the audio still doesn't match there, so the voice probably reads something its own way (a year, an abbreviation or a name). Listen at ${clock(mismatch.at)}: if words are missing or wrong, reword that sentence in narration chunk ${n} in ${editSettings.narration}, save, then Continue the run. If it says them right, use Download diagnostics in Settings and report it.`
+            : `${stopped} The voice probably skipped or garbled words there, so Slopify is recording narration chunk ${n} again by itself (try ${String(retry.try)} of ${String(narrationRetryLimit)}) and carries on with the video when it's done. If this message is still here in a few minutes, make narration chunk ${n} again in ${editSettings.narration}, then Continue the run.`;
     }
     const fix = chunk === undefined
-        ? `Listen at ${clock(mismatch.at)}: if words are missing or wrong, regenerate that part in Edit project → Narration, then Continue the run.`
-        : `Listen at ${clock(mismatch.at)}: if words are missing or wrong, regenerate narration chunk ${String(at + 1)} in Edit project → Narration, then Continue the run.`;
+        ? `Listen at ${clock(mismatch.at)}: if words are missing or wrong, make that part again in ${editSettings.narration}, then Continue the run.`
+        : `Listen at ${clock(mismatch.at)}: if words are missing or wrong, make narration chunk ${String(at + 1)} again in ${editSettings.narration}, then Continue the run.`;
     // A voice that reads a year, an abbreviation or a name its own way reads it the same way
     // again, so a remake would cost a chunk and fail here once more.
-    const same = "If it says them right, only another way (a year, an abbreviation or a name read its own way), regenerating gives the same reading: use Download diagnostics in Settings and report it.";
+    const same = "If it says them right, only another way (a year, an abbreviation or a name read its own way), making it again gives the same reading: use Download diagnostics in Settings and report it.";
     return `${stopped} The recording there probably skips or changes words. ${fix} ${same}`;
 }
 function comparable(text) {

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

@@ -1,10 +1,12 @@
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { z } from "zod";
+import { internalError } from "../../kernel/errors.js";
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 import { masterFile, masterReport } from "../loudness/loudnorm.js";
 import { masterGoal } from "../loudness/model.js";
 import { allocateAsset, discardPreparedAssets, sealAsset } from "../storage/assets.js";
-import { outputPath, projectDir } from "../storage/layout.js";
+import { projectDir } from "../storage/layout.js";
 import { audioExportArgs } from "../video/audio-export-args.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { audioChapters, audioFileArgs, ffmetadata } from "../voices/audio-files.js";
@@ -12,18 +14,17 @@ import { turnStarts } from "../voices/timing.js";
 import { exportSnapshot, revisionAudio } from "./runtime-export-inputs.js";
 import { lineLevelledAudio } from "./runtime-lines.js";
 import { preparedResult, publishResult } from "./runtime-publication.js";
-import { wordsSchema } from "./runtime-subtitles.js";
+import { readTimingWords } from "./runtime-subtitles.js";
+import { pieceAlreadyDone } from "./work-records.js";
 // The listening files of a multi-voice run: the MP3 and the M4B of the narration timeline,
 // with a chapter at each section of the script where its first turn is heard.
 export async function executeVoicesRecipe(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";
     if (piece.key !== "voices:files" || piece.input.kind !== "local")
-        throw new Error("Slopify hit an internal error (unknown kind of listening-file step). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("unknown kind of listening-file step"));
     context.signal.throwIfAborted();
     const { view } = exportSnapshot(deps, context, piece);
     const sections = z
@@ -32,17 +33,10 @@ export async function executeVoicesRecipe(deps, context, piece) {
         .rest(z.unknown())
         .parse(piece.input.values)[2]
         .map(([title, firstTurn]) => ({ title, firstTurn }));
-    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 chapter markers come from, 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, "the chapter markers come from");
     const audio = await revisionAudio(deps, context, view, { levelled: true });
     if (audio.length === 0)
-        throw new Error("The MP3 and M4B files need narration audio, but this project has none. Turn narration on in Edit project, or turn Audio files off under Speakers (Play → Narration, or Edit project → Providers), then Try again.");
+        throw new Error(`The MP3 and M4B files need narration audio, but this project has none. Turn narration on in ${editSettings.narration}, or untick Also make MP3 and M4B files under Speakers (${createRows.narration}, or ${editSettings.narration}), then Try again.`);
     const totalSeconds = audio.reduce((sum, segment) => sum + segment.seconds, 0);
     const chapters = audioChapters({
         title: view.revision.config.title,