@gentbajko/slopify 2.4.0 → 3.0.0

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

@@ -1,14 +1,22 @@
 import { readFileSync } from "node:fs";
 import { z } from "zod";
 import { subtitleModelDir } from "../../kernel/paths.js";
+import { projectLanguage } from "../../kernel/ports/languages.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 { discardPreparedAssets, writeAsset } from "../storage/assets.js";
 import { outputPath } from "../storage/layout.js";
 import { captionCues, serializeAss, serializeSrt, serializeVtt } from "../subtitles/captions.js";
 import { spoken } from "../video/plan.js";
-import { exportSnapshot, retainedOutput, revisionAudio, revisionTranscript, } from "./runtime-export-inputs.js";
+import { usesVoices } from "../voices/model.js";
+import { speakerColour } from "../voices/palette.js";
+import { speakerPanelEvents, usesSpeakerPanel } from "../voices/panel.js";
+import { panelPortraits } from "../voices/portraits.js";
+import { attributeWords } from "../voices/timing.js";
+import { exportSnapshot, retainedOutput, revisionAudio, revisionTranscript, revisionTurns, } from "./runtime-export-inputs.js";
 import { narrationChunks, narrationTextParts, } from "./runtime-narration-text.js";
 import { preparedResult, preparedText, publishResult } from "./runtime-publication.js";
 // The saved `subtitles.json`: every word at its time in the final video. The YouTube
@@ -20,6 +28,9 @@ export const wordsSchema = z.object({
         start: z.number().finite().nonnegative(),
         end: z.number().finite().positive(),
         confidence: z.number().optional(),
+        // A multi-voice run's speaker id and script turn (`voices/timing.ts`).
+        speaker: z.string().optional(),
+        turn: z.number().int().positive().optional(),
     })),
     omissions: z
         .array(z.object({ start: z.number().finite().nonnegative(), text: z.string() }))
@@ -30,6 +41,7 @@ const cuesSchema = z.object({
         text: z.string(),
         start: z.number().finite().nonnegative(),
         end: z.number().finite().positive(),
+        speaker: z.string().optional(),
     })),
     omissions: wordsSchema.shape.omissions,
 });
@@ -44,19 +56,21 @@ 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). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+    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.");
 }
 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 Retry stage.");
+        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.");
     const alignSubtitles = deps.alignSubtitles;
     if (alignSubtitles === undefined)
-        throw new Error("Slopify hit an internal error (the caption timing tool is missing from this build). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        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.");
     if (!context.maySubmit(piece.id))
         return "held";
     const words = [];
     const omissions = [];
+    const turns = revisionTurns(snapshot);
+    const language = projectLanguage(snapshot.view.revision.config);
     let offset = 0;
     const total = audio.reduce((sum, segment) => sum + segment.seconds, 0);
     for (const segment of audio) {
@@ -66,7 +80,9 @@ async function timing(deps, context, piece, snapshot) {
             const aligned = await located(snapshot, kind, () => alignSubtitles({
                 audioPath: path,
                 text: revisionTranscript(deps, snapshot, kind),
-                cacheDir: subtitleModelDir(deps.paths.dataDir),
+                aliases: narrationAliasesOf(snapshot.view.revision.config),
+                cacheDir: subtitleModelDir(deps.paths.dataDir, language),
+                ...(language === "en" ? {} : { language }),
                 ffmpeg: deps.ffmpeg,
                 signal: context.signal,
                 onOmission: (value) => omissions.push({ ...value, start: value.start + offset }),
@@ -78,9 +94,11 @@ async function timing(deps, context, piece, snapshot) {
                     total: 100,
                 }),
             }));
-            for (const word of aligned) {
+            for (const word of kind === "body" && turns.length > 0
+                ? attributeWords(turns, aligned)
+                : aligned) {
                 if (word.end > segment.seconds + 0.1)
-                    throw new Error("Caption timing came out longer than the narration audio. Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+                    throw new Error("Caption timing came out longer than the narration audio. Try again; if it happens again, use Download diagnostics in Settings and report it.");
                 words.push({
                     ...word,
                     start: word.start + offset,
@@ -91,7 +109,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. Captions only work for English narration; if you uploaded your own audio, make sure it reads the article text, then Retry stage.");
+        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.");
     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);
@@ -103,7 +121,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 Retry stage.");
+            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.");
         const audio = await revisionAudio(deps, context, view);
         const errors = validateCues(manual.cues, audio.reduce((sum, segment) => sum + segment.seconds, 0));
         if (errors.length > 0)
@@ -116,7 +134,7 @@ async function cues(deps, context, piece, snapshot) {
             one.state === "ready" &&
             one.workKey === "subtitles:timing");
         if (output === undefined)
-            throw new Error("Caption timing is missing. Use Re-run section on Video, then Retry stage.");
+            throw new Error("Caption timing is missing. Use More → Render the video again in the 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 };
     }
@@ -130,10 +148,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). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        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");
     if (row?.piece.payload === null || row?.piece.payload === undefined)
-        throw new Error("The captions haven't been prepared yet. Use Re-run section on Video, then Retry stage.");
+        throw new Error("The captions haven't been prepared yet. Use More → Render the video again in the 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" &&
@@ -152,9 +170,17 @@ async function files(deps, context, piece, snapshot) {
             .optional(),
     })
         .parse(JSON.parse(previousFiles?.piece.payload ?? "{}")).font;
-    const font = savedFont?.id === config.fontId && previous !== undefined
-        ? { ...savedFont, path: outputPath(deps.paths, context.work.projectId, previous.output.path) }
-        : await resolveFont(deps.paths, config.fontId);
+    // Another language's captions may need a font with its letters (`fonts/coverage.ts`); an
+    // English project keeps the saved font as it always did.
+    const language = projectLanguage(view.revision.config);
+    const font = language !== "en"
+        ? await captionFont(captionFontDeps(deps.paths), config.fontId, language)
+        : savedFont?.id === config.fontId && previous !== undefined
+            ? {
+                ...savedFont,
+                path: outputPath(deps.paths, context.work.projectId, previous.output.path),
+            }
+            : await resolveFont(deps.paths, config.fontId);
     if (!context.maySubmit(piece.id))
         return "held";
     const prepared = [];
@@ -162,9 +188,20 @@ async function files(deps, context, piece, snapshot) {
         const frame = view.revision.config.format === "16:9"
             ? { width: 1920, height: 1080 }
             : { width: 1080, height: 1920 };
+        const voices = captionVoices(view.revision.config);
+        const portraits = panelPortraits(deps.db, voices);
+        const overlay = voices !== undefined && usesSpeakerPanel(voices.format)
+            ? speakerPanelEvents(value.cues, voices.speakers.map((speaker, index) => ({
+                id: speaker.id,
+                name: speaker.name.trim(),
+                colour: speakerColour(index),
+                ...(portraits[index] === undefined ? {} : { portrait: true }),
+            })), frame, (await revisionAudio(deps, context, view)).reduce((sum, segment) => sum + segment.seconds, 0))
+            : [];
+        const speakers = voices === undefined ? undefined : captionSpeakers(voices);
         for (const [role, filename, text] of [
-            ["subtitles_srt", "subtitles.srt", serializeSrt(value.cues)],
-            ["subtitles_vtt", "subtitles.vtt", serializeVtt(value.cues)],
+            ["subtitles_srt", "subtitles.srt", serializeSrt(value.cues, speakers)],
+            ["subtitles_vtt", "subtitles.vtt", serializeVtt(value.cues, speakers)],
             [
                 "subtitle_ass",
                 "subtitles.ass",
@@ -173,6 +210,10 @@ async function files(deps, context, piece, snapshot) {
                     fontName: font.assName,
                     fontSize: config.fontSize,
                     position: config.position,
+                    color: config.color,
+                    outlineColor: config.outlineColor,
+                    speakers,
+                    overlay,
                 }),
             ],
         ])
@@ -242,8 +283,8 @@ export function describeMismatch(chunks, segment, mismatch) {
     const expected = mismatch.expected === "" ? "the end of the text" : `"${mismatch.expected}…"`;
     const heard = mismatch.heard === "" ? "no more speech" : `"${mismatch.heard.toLowerCase()}…"`;
     const fix = chunk === undefined
-        ? "Check that part of the narration, regenerate it in Edit project → Narration, then Resume."
-        : `In Edit project → Narration, regenerate narration chunk ${String(at + 1)}, then Resume.`;
+        ? "Check that part of the narration, regenerate it in Edit project → Narration, then Continue the run."
+        : `In Edit project → Narration, regenerate narration chunk ${String(at + 1)}, then Continue the run.`;
     return `Subtitles stopped matching the audio at ${where}. The text expected ${expected} but the audio has ${heard} The recording there probably skips or changes words. ${fix}`;
 }
 function comparable(text) {
@@ -266,3 +307,15 @@ function clock(seconds) {
         ? `${String(hours)}:${String(minutes).padStart(2, "0")}:${rest}`
         : `${String(minutes)}:${rest}`;
 }
+function captionVoices(config) {
+    return usesVoices(config) ? config.voices : undefined;
+}
+function captionSpeakers(voices) {
+    return {
+        styles: Object.fromEntries(voices.speakers.map((speaker, index) => [
+            speaker.id,
+            { name: speaker.name.trim(), colour: speakerColour(index) },
+        ])),
+        nameTags: voices.nameTags,
+    };
+}

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

@@ -0,0 +1,103 @@
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+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 { audioExportArgs } from "../video/audio-export-args.js";
+import { runFfmpeg } from "../video/ffmpeg.js";
+import { audioChapters, audioFileArgs, ffmetadata } from "../voices/audio-files.js";
+import { turnStarts } from "../voices/timing.js";
+import { exportSnapshot, revisionAudio } from "./runtime-export-inputs.js";
+import { preparedResult, publishResult } from "./runtime-publication.js";
+import { wordsSchema } from "./runtime-subtitles.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")
+        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.");
+    context.signal.throwIfAborted();
+    const { view } = exportSnapshot(deps, context, piece);
+    const sections = z
+        .tuple([z.unknown(), z.unknown(), z.array(z.tuple([z.string(), z.number()])), z.string()])
+        // Level the volume's master may follow (`recipe-loudness.ts`).
+        .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 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 → Audio, or Edit project → Providers), then Try again.");
+    const totalSeconds = audio.reduce((sum, segment) => sum + segment.seconds, 0);
+    const chapters = audioChapters({
+        title: view.revision.config.title,
+        sections,
+        turnStarts: turnStarts(words),
+        totalSeconds,
+    });
+    const directory = mkdtempSync(join(projectDir(deps.paths, context.work.projectId), "audio-"));
+    const pending = [
+        allocateAsset(deps, context.work.projectId, "narration.mp3"),
+        allocateAsset(deps, context.work.projectId, "audiobook.m4b"),
+    ];
+    const prepared = [];
+    try {
+        const metadata = join(directory, "chapters.txt");
+        writeFileSync(metadata, ffmetadata(view.revision.config.title, chapters), { mode: 0o600 });
+        // Level the volume: the sound is mixed once and mastered to the audio files' target, and both
+        // files are encoded from that (`loudness/model.ts`).
+        const goal = masterGoal(view.revision.config, "audioFiles");
+        let sound = audio;
+        if (goal !== undefined) {
+            const mixed = join(directory, "mix.wav");
+            await runFfmpeg({
+                bin: deps.ffmpeg,
+                args: audioExportArgs(audio, mixed),
+                signal: context.signal,
+                log: deps.log,
+                onProgress: () => { },
+            });
+            const mastered = join(directory, "master.wav");
+            await masterFile({ bin: deps.ffmpeg, log: deps.log, signal: context.signal }, mixed, mastered, goal, { sampleRate: 44100, channels: 2 });
+            sound = [{ path: mastered, seconds: totalSeconds }];
+        }
+        for (const [at, kind] of ["mp3", "m4b"].entries()) {
+            const target = pending[at];
+            if (target === undefined)
+                continue;
+            await runFfmpeg({
+                bin: deps.ffmpeg,
+                args: audioFileArgs(sound, metadata, target.absolutePath, kind),
+                signal: context.signal,
+                log: deps.log,
+                onProgress: () => { },
+            });
+            context.signal.throwIfAborted();
+            // What each finished file measures, after its encode.
+            const master = goal === undefined
+                ? undefined
+                : await masterReport({ bin: deps.ffmpeg, log: deps.log, signal: context.signal }, target.absolutePath, goal);
+            prepared.push(preparedResult(deps, context, piece, kind === "mp3" ? "audio_mp3" : "audio_m4b", sealAsset(deps, target), Math.round(totalSeconds * 1000), master === undefined ? {} : { master }));
+        }
+        await publishResult(deps, context, piece, prepared, { chapters });
+        return "done";
+    }
+    finally {
+        discardPreparedAssets(deps, [...pending, ...prepared.map((one) => one.asset)]);
+        rmSync(directory, { recursive: true, force: true });
+    }
+}

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

@@ -1,4 +1,5 @@
 import { readFileSync } from "node:fs";
+import { withLanguage } from "../../kernel/ports/languages.js";
 import { outputPath } from "../storage/layout.js";
 import { assembleDescription, checkDescriptionAnswer, descriptionMessages, tagsText, } from "../youtube/answer.js";
 import { defaultDescriptionPrompt } from "../youtube/model.js";
@@ -21,35 +22,35 @@ export async function executeYoutubeRecipe(deps, context, providers, piece) {
     context.signal.throwIfAborted();
     const input = piece.input;
     if (input.kind !== "local" || input.operation !== "youtube-description-v1")
-        throw new Error("Slopify hit an internal error (the YouTube description step was set up wrongly). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error("Slopify hit an internal error (the YouTube description step was set up wrongly). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     const { view } = exportSnapshot(deps, context, 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 Retry stage.");
+        throw new Error("The YouTube description needs an AI text model, and none is chosen. Choose one in Edit project → Providers, then Try again.");
     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 YouTube description's chapters come from, is missing. Use Re-run section on Video, then Retry stage.");
+        throw new Error("The narration's word timing, which the YouTube description's chapters 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 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 Re-run section on Video, then Retry stage.");
+        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.");
     // 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);
     const durationSeconds = audio.reduce((sum, segment) => sum + segment.seconds, 0);
     const saved = Array.isArray(input.values) ? input.values[4] : undefined;
     const instruction = typeof saved === "string" && saved.trim() !== "" ? saved : defaultDescriptionPrompt;
-    const messages = descriptionMessages({
+    const messages = withLanguage(descriptionMessages({
         instruction,
         title: config.title,
         durationSeconds,
         transcript: transcriptText(passages),
-    });
+    }), config.language);
     const row = deps.db
         .prepare("SELECT recipe_context FROM revision_work WHERE id=?")
         .get(context.work.workId);

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

@@ -1,4 +1,5 @@
 import { checkRuntimeModel } from "../../catalog/runtime-models.js";
+import { referenceRefusal, takesReferenceImage } from "../../catalog/schema.js";
 import { readinessIsUsable } from "../../kernel/ports/model.js";
 import { cliPathChanged } from "../settings/cli-paths.js";
 import { isLocalCliProvider } from "../settings/model.js";
@@ -38,7 +39,7 @@ export async function checkReadiness(deps, snapshot, view) {
             });
             continue;
         }
-        const result = await checkRuntimeModel(deps.modelsFor, choice.provider, choice.family, choice.model, choice.family === "llm" ? (choice.thinking ?? undefined) : undefined);
+        const result = await checkRuntimeModel(deps.modelsFor, choice.provider, choice.family, choice.model, choice.family === "tts" ? undefined : (choice.thinking ?? undefined));
         if (result === "missing")
             fields.push({
                 field: `${choice.family}.model`,
@@ -112,6 +113,19 @@ export function localReadiness(deps, snapshot, view, providers, catalogue) {
                     field: `work.${recipe.key}.aspect`,
                     message: "The model does not support this output shape.",
                 });
+            // Only the keyed providers' models are listed; the Codex CLI always takes a reference.
+            if (model !== undefined &&
+                input.reference !== undefined &&
+                !takesReferenceImage(model) &&
+                !fields.some((row) => row.field === "reference.source"))
+                fields.push({ field: "reference.source", message: referenceRefusal });
+            if (model !== undefined &&
+                input.thinking !== undefined &&
+                !fields.some((row) => row.field === "images.thinking"))
+                fields.push({
+                    field: "images.thinking",
+                    message: "This image model has no effort setting. Set the images' Effort back to Model default under Providers.",
+                });
         }
     }
     return fields;

package/dist/slices/rebuild/soften.js

@@ -0,0 +1,49 @@
+// Soften and retry: an image prompt a content filter refused is reworded by the project's
+// AI model, inside the image step's own run (so the call goes through the retry policy and
+// the new wording streams onto the step's live panel), then drawn again. A request is kept
+// per step until an image is made from the softened prompt.
+// The steps of a stage whose last attempt a content filter refused, on the current run.
+export function refusedKeys(db, projectId, stage) {
+    return db
+        .prepare(`SELECT DISTINCT p.work_key FROM revision_work_pieces p
+       JOIN revision_work w ON w.id=p.work_id
+       JOIN revision_work_reservations r ON r.work_id=w.id
+       JOIN project_heads h ON h.project_id=r.project_id AND h.revision_id=r.revision_id
+       WHERE w.project_id=? AND w.kind=? AND w.state='failed' AND p.state!='done'
+       AND (SELECT a.outcome FROM attempts a WHERE a.work_piece_id=p.id ORDER BY a.rowid DESC LIMIT 1)='refusal'
+       ORDER BY p.work_key`)
+        .all(projectId, stage)
+        .map((row) => String(row.work_key));
+}
+export function requestSoftening(db, projectId, keys, at) {
+    for (const key of keys)
+        db.prepare("INSERT INTO prompt_softening(project_id,work_key,requested_at) VALUES (?,?,?) ON CONFLICT(project_id,work_key) DO UPDATE SET requested_at=excluded.requested_at").run(projectId, key, at);
+}
+export function softeningRequested(db, projectId, key) {
+    return (db
+        .prepare("SELECT 1 FROM prompt_softening WHERE project_id=? AND work_key=?")
+        .get(projectId, key) !== undefined);
+}
+export function clearSoftening(db, projectId, keys) {
+    for (const key of keys)
+        db.prepare("DELETE FROM prompt_softening WHERE project_id=? AND work_key=?").run(projectId, key);
+}
+export function softenMessages(prompt) {
+    return [
+        {
+            role: "user",
+            content: `An image generator's content filter refused the image prompt below. Rewrite it so it keeps the same scene, subject, composition and style but leaves out whatever a filter could flag: graphic violence, gore, nudity or sexual content, real people's names, weapons aimed at people, self-harm and hateful symbols. Describe such things indirectly or leave them out. Answer with the rewritten prompt only, no preamble and no quotes.
+
+Prompt:
+${prompt}`,
+        },
+    ];
+}
+// The model's answer, trimmed of the quotes and labels models add anyway.
+export function softenedPrompt(answer) {
+    return answer
+        .trim()
+        .replace(/^(?:rewritten prompt|prompt)\s*:\s*/i, "")
+        .replace(/^["“](.*)["”]$/s, "$1")
+        .trim();
+}

package/dist/slices/rebuild/transition-repo.js

@@ -130,18 +130,25 @@ function existingWork(db, projectId, key, fingerprint) {
         : { workId: z.string().parse(row.work_id), pieceId: z.string().parse(row.piece_id) };
 }
 function stageForKey(key) {
+    // A review runs in its item's stage; the narration's review in Audio.
+    if (key === "review:narration")
+        return "audio";
+    if (key.startsWith("review:shorts:"))
+        return "video";
+    if (key.startsWith("review:"))
+        return stageForKey(key.slice("review:".length));
     const prefix = key.split(":")[0];
     if (prefix === "research")
         return "research";
-    if (prefix === "article" || prefix === "entry")
+    if (prefix === "article" || prefix === "entry" || prefix === "script")
         return "article";
     if (prefix === "audio" || prefix === "narration")
         return "audio";
-    if (prefix === "image")
+    if (prefix === "image" || prefix === "reference")
         return "images";
     if (prefix === "thumbnail")
         return "thumbnail";
-    if (prefix === "export" || prefix === "subtitles" || prefix === "video")
+    if (prefix === "export" || prefix === "subtitles" || prefix === "video" || prefix === "voices")
         return "video";
     if (prefix === "document")
         return "document";

package/dist/slices/research/run.js

@@ -10,7 +10,7 @@ import { chaptersFrom, plannerMessages, subAgentMessages } from "./planner.js";
 import { sourcedAnswer, synthesisMessages } from "./synthesis.js";
 // A model that cannot ground on the web fails the stage immediately, with no fallback to
 // what the model already knows.
-export const webResearchUnsupported = "The chosen AI model can't search the web, which research needs. Choose a model with web search in Edit project → Providers, or turn research off, then Retry stage.";
+export const webResearchUnsupported = "The chosen AI model can't search the web, which research needs. Choose a model with web search in Edit project → Providers, or turn research off, then Try again.";
 // What a chapter piece carries between runs: its title, and its notes once a sub-agent
 // has answered. That is the whole of the resume.
 const chapterPayload = z.object({ title: z.string(), notes: z.string().optional() });
@@ -25,7 +25,7 @@ export async function runResearch(deps, context, providers) {
     if (choice === undefined || articlePrompt === undefined) {
         // Admission refuses a run whose research is Generate without both, so
         // reaching here is a bug in admission rather than something the user did.
-        throw new Error("No AI model or article prompt is set for research. Choose a model in Edit project → Providers and check Edit project → Prompts, then Retry stage.");
+        throw new Error("No AI model or article prompt is set for research. Choose a model in Edit project → Providers and check Edit project → Prompts, then Try again.");
     }
     const brief = { articlePrompt, values: project.config.values };
     try {
@@ -111,7 +111,7 @@ async function plan(deps, context, providers, choice, brief, add) {
         previewLabel: "Planning research",
         // An empty answer, or one with no chapter in it, is a failed attempt.
         check: (given) => chaptersFrom(given.text).length === 0
-            ? "The AI model didn't return any research topics. Retry stage; if it keeps happening, choose a different model in Edit project → Providers."
+            ? "The AI model didn't return any research topics. Try again; if it keeps happening, choose a different model in Edit project → Providers."
             : undefined,
     });
     if (!answer.ok)
@@ -217,7 +217,7 @@ function section(label, messages) {
 }
 function payloadOf(piece) {
     if (piece.payload === null) {
-        throw new Error("Slopify hit an internal error (a saved research topic is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error("Slopify hit an internal error (a saved research topic is empty). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return chapterPayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/research/synthesis.js

@@ -41,9 +41,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}. Retry stage; 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 Edit project → Providers.`;
     }
     return endsWithSources(text)
         ? undefined
-        : `The AI model's answer for ${who} had no sources. Research needs web sources: Retry stage, 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 Edit project → Providers.`;
 }

package/dist/slices/reviews/model.js

@@ -0,0 +1,105 @@
+// Automatic reviews: a reviewer model looks at each finished item of a stage (the article,
+// every image, the narration, the thumbnail, every short) before the run moves on, and says
+// pass or fail with its reasons. A failed item is flagged, or made again while its retries
+// last. Browser-safe: Play, Edit project and the project page read these names and limits too.
+export const reviewStages = ["article", "images", "narration", "thumbnail", "shorts"];
+// Off is the same as the stage having no entry, which is what every project saved before
+// reviews existed has.
+export const reviewModes = ["off", "flag", "redo"];
+// ceiling: the owner's numbers. Two redos is what a person would try before looking at it
+// themselves; five is already six paid images for one slot.
+export const defaultReviewRetries = 2;
+export const reviewRetriesMin = 0;
+export const reviewRetriesMax = 5;
+export const reviewStageLabels = {
+    article: "Article",
+    images: "Images",
+    narration: "Narration",
+    thumbnail: "Thumbnail",
+    shorts: "Shorts",
+};
+export const reviewModeLabels = {
+    off: "Off",
+    flag: "Flag only",
+    redo: "Flag and redo",
+};
+// The stages whose items are pictures, so the reviewer has to be shown them.
+export const visionStages = ["images", "thumbnail", "shorts"];
+// The text providers whose adapter hands the model image files (`capabilities.images` in
+// `adapters/llm`): Claude Code reads them with its Read tool in a private folder, Codex
+// attaches them with `--image`. The Gemini CLI and OpenRouter adapters send text only.
+export const imageReviewers = ["claude-code", "codex"];
+export function reviewModeOf(settings, stage) {
+    return settings?.stages[stage]?.mode ?? "off";
+}
+export function reviewRetriesOf(settings) {
+    return settings?.retries ?? defaultReviewRetries;
+}
+export function reviewedStages(settings) {
+    return reviewStages.filter((stage) => reviewModeOf(settings, stage) !== "off");
+}
+// The key a stage's picked Review prompt renders under in `config.rendered`.
+export function reviewPromptKey(stage) {
+    return `review.${stage}`;
+}
+// A review's step is `review:` and the key of the item it reviews. The narration is
+// reviewed as a whole, so its item key names no step.
+export const narrationItemKey = "narration";
+export function reviewKey(itemKey) {
+    return `review:${itemKey}`;
+}
+export function reviewedItemKey(key) {
+    return key.startsWith("review:") ? key.slice("review:".length) : undefined;
+}
+export function reviewSettingsForm(settings) {
+    return {
+        provider: settings.provider,
+        model: settings.model,
+        ...(settings.thinking === undefined ? {} : { thinking: settings.thinking }),
+        retries: settings.retries === undefined ? "" : String(settings.retries),
+        stages: Object.fromEntries(reviewStages.flatMap((stage) => {
+            const picked = settings.stages[stage];
+            return picked === undefined
+                ? []
+                : [[stage, { mode: picked.mode, prompt: picked.prompt ?? "" }]];
+        })),
+    };
+}
+// The form back to settings: only the reviews of stages that make something (`makes`), and
+// none left is no reviews at all, which is what every project saved before them has. Retries
+// that are not a number are left out and reported, so the form marks the field.
+export function reviewSettingsFromForm(form, makes) {
+    const stages = Object.fromEntries(reviewStages.flatMap((stage) => {
+        const picked = form.stages[stage];
+        if (picked === undefined || picked.mode === "off" || !makes(stage))
+            return [];
+        return [
+            [stage, { mode: picked.mode, ...(picked.prompt.trim() ? { prompt: picked.prompt } : {}) }],
+        ];
+    }));
+    if (Object.keys(stages).length === 0)
+        return { settings: undefined };
+    const retries = form.retries.trim() === "" ? undefined : Number(form.retries);
+    const valid = retries === undefined || Number.isFinite(retries);
+    return {
+        settings: {
+            provider: form.provider,
+            model: form.model,
+            ...(form.thinking === undefined ? {} : { thinking: form.thinking }),
+            ...(retries === undefined || !valid ? {} : { retries }),
+            stages,
+        },
+        ...(valid
+            ? {}
+            : {
+                retriesProblem: `Enter a number of redos between ${String(reviewRetriesMin)} and ${String(reviewRetriesMax)} in the Reviews section.`,
+            }),
+    };
+}
+export const defaultReviewPrompts = {
+    article: "Review this article against the article prompt it was written from. Fail it when it breaks the prompt's rules on length, structure or tone; when it states names, places, events or facts that neither the prompt nor the research notes support (invented lore); or when a section repeats another section's content. Small style preferences are not a reason to fail it.",
+    images: "Review this image against the brief it was drawn from. Fail it when a hand or body is malformed (extra or missing fingers, fused limbs, broken anatomy); when it shows stray text, letters, captions or watermarks the brief did not ask for; when it does not show what the brief asks for; or, when an establishing image is attached, when it does not match it (a different character, palette or style).",
+    narration: "Review this narration against the text it was read from. The transcript was heard back from the audio; the gaps list stretches of text the timing could not hear. Fail it when words, sentences or passages are missing or garbled in a way a listener would notice. Ignore punctuation, numbers written out, and small differences in how words were transcribed.",
+    thumbnail: "Review this thumbnail as it would be seen on a phone, about 320 pixels wide. Fail it when its text (if any) cannot be read at that size, when the subject is unclear or cluttered, when a hand or body is malformed, or when it shows stray letters or watermarks.",
+    shorts: "Review these images from one vertical short, as they would be seen full screen on a phone. Fail them when the subject is unclear, when a hand or body is malformed, when they show stray text, letters or watermarks, or when they do not fit the short's title.",
+};