@gentbajko/slopify 4.0.0 → 4.1.0

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

@@ -1,6 +1,7 @@
 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";
@@ -52,18 +53,18 @@ export async function narrationAudio(deps, view, options = {}) {
                 ? 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,
@@ -108,7 +109,7 @@ 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");

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

@@ -19,7 +19,7 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
     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";

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

@@ -1,6 +1,7 @@
 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";
@@ -46,7 +47,7 @@ export async function executeExportRecipe(deps, context, piece) {
     if (!wav && piece.key !== "export:video")
         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";
@@ -240,7 +241,7 @@ export function slideshowImages(deps, context, view) {
     return view.revision.content.imageOrder.map((key) => {
         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);
     });
 }
@@ -249,7 +250,7 @@ function captionDirectory(deps, context, snapshot) {
     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 });

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

@@ -1,4 +1,5 @@
 import { readFileSync } from "node:fs";
+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";
@@ -22,7 +23,7 @@ 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 saved = assetPathOrUndefined(deps, projectId, input.reference.assetId);
@@ -37,7 +38,7 @@ function referenceImage(deps, projectId, input) {
     }
     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
@@ -51,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-local.js

@@ -2,6 +2,7 @@ import { rmSync, statSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { z } from "zod";
 import { internalError } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { referenceKey, thumbnailVariant } from "../admission/model.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
@@ -31,7 +32,7 @@ export async function executeLocalRecipe(deps, context, piece) {
     const input = piece.input;
     if (input.kind === "provided") {
         if (input.assetId === null)
-            throw new Error("A file you uploaded for this project is missing. Upload it again in Edit project, then Try again.");
+            throw new Error("A file you uploaded for this project is missing. Upload it again in Edit settings, then Try again.");
         const row = z
             .object({ id: z.string(), project_id: z.string(), path: z.string(), created_at: z.string() })
             .parse(deps.db
@@ -115,7 +116,7 @@ async function concatenate(deps, context, piece) {
             isDonePiece(candidate) &&
             candidate.fingerprint === plan.recipes.find((value) => value.key === key)?.fingerprint);
         if (input?.assetId === null || input === undefined)
-            throw new Error("One narration chunk has no saved audio, so the narration can't be joined together. Regenerate the missing chunk in Edit project → Narration, then Try again.");
+            throw new Error(`One narration chunk has no saved audio, so the narration can't be joined together. Make the missing chunk again in ${editSettings.narration}, then Try again.`);
         return outputPath(deps.paths, context.work.projectId, assetPath(deps, context.work.projectId, input.assetId));
     });
     // Level the volume repeats the join its recipe names, from the same pieces, each levelled

package/dist/slices/rebuild/runtime-narration-text.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { internalError } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { isDonePiece } from "../revisions/view.js";
 import { executionPlan, executionView, savedCatalogue, workCatalogue } from "./runtime-plan.js";
 import { preparedTexts, publishResult } from "./runtime-publication.js";
@@ -16,7 +17,7 @@ export function narrationTextParts(view, plan, segment) {
         const recipe = plan.recipes.find((row) => row.key === key);
         const selected = view.pieces.find((row) => row.key === key && isDonePiece(row) && row.fingerprint === recipe?.fingerprint);
         if (selected === undefined || recipe === undefined)
-            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}.`);
         const input = recipe.input;
         if (input.kind === "provided" &&
             Array.isArray(input.semantic) &&
@@ -33,7 +34,7 @@ export function narrationTextParts(view, plan, segment) {
             .parse(JSON.parse(selected.piece.payload ?? "{}"));
         if (input.spokenText !== undefined &&
             (payload.spokenText !== input.spokenText || payload.text !== input.text))
-            throw new Error("A narration chunk's audio no longer matches its prepared text. Regenerate that chunk in Edit project → Narration, then Try again.");
+            throw new Error(`A narration chunk's audio no longer matches its prepared text. Make that chunk again in ${editSettings.narration}, then Try again.`);
         return {
             logicalKey: input.logicalKey,
             spokenText: input.spokenText === undefined ? (payload.text ?? input.text) : (payload.spokenText ?? ""),

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

@@ -1,5 +1,6 @@
 import { basename } from "node:path";
 import { internalError } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { referenceKey, thumbnailVariant } from "../admission/model.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
@@ -189,17 +190,17 @@ export async function softenIfAsked(deps, context, providers, piece, prompt, lab
         messages: softenMessages(prompt),
         previewLabel: `${label}: softened prompt`,
         check: (value) => softenedPrompt(value.text) === ""
-            ? "The AI model sent back an empty prompt while softening it. Use Soften and retry again, or reword the prompt yourself in Edit project → Images."
+            ? `The AI model sent back an empty prompt while softening it. Use Soften and retry again, or reword the prompt yourself in ${editSettings.images}.`
             : undefined,
     });
     return answer.ok ? softenedPrompt(answer.value.text) : "held";
 }
 function checkAnswer(piece, answer) {
     if (answer.text.trim() === "")
-        return "The AI model sent back an empty answer. Use Try again; if it keeps happening, choose another model in the Providers section of Edit project.";
+        return `The AI model sent back an empty answer. Use Try again; if it keeps happening, choose another model in ${editSettings.writer}.`;
     if (piece.input.kind === "llm" && piece.input.describe !== undefined)
         return spokenPassage(answer.text) === ""
-            ? "The AI model's description had no words a narrator could say. Use Try again; if it keeps happening, choose another model in the Providers section of Edit project, or turn off Describe tables and figures there."
+            ? `The AI model's description had no words a narrator could say. Use Try again; if it keeps happening, choose another model in ${editSettings.writer}, or turn off Describe tables and figures in ${editSettings.narration}.`
             : undefined;
     // Scenes from the article: one scene per image, as many as the request lists.
     if ((piece.key === imageScenesKey || piece.key === thumbnailScenesKey) &&
@@ -222,7 +223,7 @@ function checkAnswer(piece, answer) {
         return checkPost(answer.text, piece.input.social);
     if (piece.key === "research:planner")
         return chaptersFrom(answer.text).length === 0
-            ? "The AI model's research plan listed no chapters, so research could not go on. Use Try again; if it keeps happening, choose another model in the Providers section of Edit project."
+            ? `The AI model's research plan listed no chapters, so research could not go on. Use Try again; if it keeps happening, choose another model in ${editSettings.writer}.`
             : undefined;
     if (piece.key === "research:notes" || piece.key.startsWith("research:chapter:"))
         return sourcedAnswer(piece.key, answer.text);
@@ -236,7 +237,7 @@ function checkAnswer(piece, answer) {
         const checked = parseScript(answer.text, piece.input.script.speakers);
         return checked.ok
             ? undefined
-            : `The conversation the text model wrote can't be read as a script: ${checked.reason}`;
+            : `The conversation the AI model wrote can't be read as a script: ${checked.reason}`;
     }
     return undefined;
 }
@@ -322,7 +323,7 @@ async function publishText(deps, context, piece, answer) {
         if (piece.input.kind === "llm" && piece.input.script !== undefined) {
             const checked = parseScript(parts.body, piece.input.script.speakers);
             if (!checked.ok)
-                throw new Error(`The text model's script can't be read: ${checked.reason} Try again to have it written again, or fix it in Edit project → Article.`);
+                throw new Error(`The AI model's script can't be read: ${checked.reason} Try again to have it written again, or fix it in ${editSettings.article}.`);
         }
         await publishResult(deps, context, piece, preparedTexts(deps, context, piece, [
             ["instructions", "instructions.md", frozenInstructions(deps, context, piece)],

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

@@ -2,6 +2,7 @@ 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";
@@ -191,8 +192,8 @@ export function reviewMaterial(deps, context, snapshot, stage, itemKey, prompt)
             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;
@@ -226,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 {
@@ -254,7 +255,7 @@ 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 ??
@@ -263,7 +264,7 @@ export function reviewMaterial(deps, context, snapshot, stage, itemKey, prompt)
                 .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-shorts.js

@@ -1,5 +1,6 @@
 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 { masterGoal } from "../loudness/model.js";
@@ -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.");
+        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.
@@ -238,7 +239,7 @@ async function render(deps, context, piece, snapshot, clip) {
         .map((recipe) => {
         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 = readTimingWords(deps, context, view, shortsTimingPurpose).words;
@@ -344,7 +345,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 Try again.";
+    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}`);

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

@@ -223,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
@@ -236,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

@@ -3,6 +3,7 @@ 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";
@@ -54,7 +55,7 @@ const cuesSchema = z.object({
 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. Use More → Render the video again in the Video section, then Try again.`);
+        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) {
@@ -73,7 +74,7 @@ export async function executeSubtitleRecipe(deps, context, piece) {
 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(internalError("the caption timing tool is missing from this build"));
@@ -121,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);
@@ -133,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)
@@ -143,7 +144,7 @@ async function cues(deps, context, piece, snapshot) {
     else {
         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 };
     }
@@ -160,7 +161,7 @@ async function files(deps, context, piece, snapshot) {
         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" &&
@@ -318,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

@@ -2,6 +2,7 @@ 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";
@@ -35,7 +36,7 @@ export async function executeVoicesRecipe(deps, context, piece) {
     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,

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

@@ -1,5 +1,6 @@
 import { internalError } from "../../kernel/errors.js";
 import { withLanguage } from "../../kernel/ports/languages.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { assembleDescription, checkDescriptionAnswer, descriptionMessages, tagsText, } from "../youtube/answer.js";
 import { defaultDescriptionPrompt } from "../youtube/model.js";
 import { keepsShape, titleShape } from "../youtube/titles.js";
@@ -26,11 +27,11 @@ export async function executeYoutubeRecipe(deps, context, providers, piece) {
     const config = view.revision.config;
     const llm = config.llm;
     if (llm === undefined || llm.provider.trim() === "" || llm.model.trim() === "")
-        throw new Error("The YouTube description needs an AI text model, and none is chosen. Choose one in Edit project → Providers, then Try again.");
+        throw new Error(`The YouTube description needs an AI model, and none is chosen. Choose a Service and a Model in ${editSettings.writer}, then Try again.`);
     const { words } = readTimingWords(deps, context, view, "the YouTube description's chapters come from");
     const passages = transcriptPassages(words);
     if (passages.length === 0)
-        throw new Error("The narration's word timing holds no words, so there is nothing to write the YouTube description 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 write the YouTube description from. Press Make the video again in the project's Video section, then Try again.");
     // The same timeline the timing walked: silence at the start, intro, gaps, body, outro and
     // silence at the end.
     const audio = await revisionAudio(deps, context, view);

package/dist/slices/rebuild/service-readiness.js

@@ -33,9 +33,14 @@ export async function checkReadiness(deps, snapshot, view) {
         if (provider === undefined || !readinessIsUsable(provider.readiness)) {
             fields.push({
                 field: choice.family,
+                // Said under the step's name on the project page ("Images: …"), in the person's words:
+                // a service Slopify does not offer here (a sample's own) is changed in the project's
+                // settings, one it offers is set up under Keys & services.
                 message: provider !== undefined && provider.readiness.kind !== "keyed" && provider.readiness.issue
                     ? provider.readiness.issue
-                    : "Configure this provider before rebuilding.",
+                    : provider === undefined
+                        ? "This project's service isn't one Slopify can use here. Choose another in Edit settings, then try again."
+                        : "Its service isn't set up yet. Add it in Settings → Keys & services, then try again.",
             });
             continue;
         }
@@ -72,7 +77,10 @@ export function localReadiness(deps, snapshot, view, providers, catalogue) {
                 message: "The configured CLI command changed. Check readiness again before rebuilding.",
             });
         if (provider?.readiness.kind === "keyed" && !hasKey(deps.db, provider.id))
-            fields.push({ field: choice.family, message: "Save the provider key before rebuilding." });
+            fields.push({
+                field: choice.family,
+                message: "Its key isn't saved yet. Add it in Settings → Keys & services, then try again.",
+            });
         if (choice.voice !== undefined &&
             !listVoices(deps.db).some((row) => row.provider === choice.provider && row.voiceId === choice.voice))
             fields.push({ field: "audio.voice", message: "Choose a saved voice before rebuilding." });
@@ -88,7 +96,7 @@ export function localReadiness(deps, snapshot, view, providers, catalogue) {
             if (maximum !== undefined && input.text.length > maximum)
                 fields.push({
                     field: `work.${recipe.key}.text`,
-                    message: "This saved physical request exceeds the current model limit. Regenerate this narration group to plan new parts.",
+                    message: "This saved request is longer than the voice model takes now. Make this part of the narration again, so it is split into parts that fit.",
                 });
         }
         else if (input.kind === "llm") {

package/dist/slices/research/synthesis.js

@@ -1,4 +1,5 @@
 import { documentIndex } from "../../kernel/ports/llm-documents.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { researchDocuments } from "./documents.js";
 import { briefText } from "./planner.js";
 // An editorial pass over every sub-agent's output that selects and organizes the findings; it
@@ -41,9 +42,9 @@ export function endsWithSources(text) {
 // but cannot be used is a failed attempt, so the wrapper retries it.
 export function sourcedAnswer(who, text) {
     if (text.trim() === "") {
-        return `The AI model returned an empty answer for ${who}. Try again; if it keeps happening, choose a different model in Edit project → Providers.`;
+        return `The AI model returned an empty answer for ${who}. Try again; if it keeps happening, choose a different model in ${editSettings.writer}.`;
     }
     return endsWithSources(text)
         ? undefined
-        : `The AI model's answer for ${who} had no sources. Research needs web sources: Try again, or choose a model with web search in Edit project → Providers.`;
+        : `The AI model's answer for ${who} had no sources. Research needs web sources: Try again, or choose a model with web search in ${editSettings.writer}.`;
 }

package/dist/slices/reviews/external-model.js

@@ -20,5 +20,5 @@ export const closedReviewSentences = {
     superseded: "This review was replaced: its item was made again or edited, and the new one waits for its own verdict. Call needs_attention to see it.",
     "replaced-pending": "This review was replaced: its item was made again or edited, so it takes no verdict, and no new review waits for it yet. One opens once the new item is made; an edit saved but not continued makes none until the run is continued. There is nothing to answer here: call needs_attention to see what is waiting now.",
     canceled: "This review's run was canceled, so nothing waits on it and it takes no verdict: a canceled run's reviews never pass. Call needs_attention to see what is waiting now.",
-    trashed: "This review's project is in the Trash, so nothing waits on it and it takes no verdict. Restore the project in Settings → Backup & storage → Trash; the review then waits for its verdict again.",
+    trashed: "This review's project is in the Trash, so nothing waits on it and it takes no verdict. Restore the project in Settings → Trash; the review then waits for its verdict again.",
 };

package/dist/slices/reviews/holds.js

@@ -4,7 +4,7 @@ import { pendingAdmitted } from "../admission/admitted-work.js";
 import { liveProject, oneProject, stageStandingsByProject } from "../admission/repo.js";
 import { checkpointStageSchema } from "../checkpoints/schema.js";
 import { heldForItsDay } from "../schedules/prepare.js";
-import { uploadedAndSettled } from "../uploads/repo.js";
+import { settledProjects } from "../uploads/repo.js";
 import { projectsWaitingOnAgents } from "./external-waiting.js";
 const gateRow = z.object({
     project_id: z.string(),
@@ -18,7 +18,7 @@ const gateRow = z.object({
 const projectRow = z.object({ project_id: z.string() });
 // Every project's holds, or one project's alone when `projectId` is given. A caller that has
 // already read the stage standings (`stageStandingsByProject`) or the uploaded projects that
-// read Done (`uploadedAndSettled`) passes them; one that lists what it can read passes `skip`,
+// read Done (`settledProjects`) passes them; one that lists what it can read passes `skip`,
 // given each checkpoint row that can't be read instead of failing them all.
 export function projectHolds(db, scope = {}) {
     const { projectId, skip } = scope;
@@ -74,8 +74,9 @@ export function projectHolds(db, scope = {}) {
         .map((row) => projectRow.parse(row).project_id);
     const agents = projectsWaitingOnAgents(db, projectId);
     const runs = heldRuns(db, projectId);
-    // An uploaded project with nothing admitted reads Done (`edge/http/projects.ts`).
-    const settled = scope.settled ?? uploadedAndSettled(db, projectId);
+    // An uploaded project with nothing admitted, or a finished one an edit left only outdated,
+    // reads Done (`edge/http/projects.ts`).
+    const settled = scope.settled ?? settledProjects(db, projectId);
     const waitingForAgent = new Set([...agents].filter((id) => !reachedTheirs.has(id) && runs.get(id)?.held !== true));
     const stopped = new Set([...runs]
         .filter(([, run]) => run.stuck)