@gentbajko/slopify 3.0.8 → 3.0.9

package/dist/main.js

@@ -89,6 +89,7 @@ import { isUpdateToken } from "./updater/model.js";
 import { npmCommand, updateCommitted } from "./updater/plan.js";
 import { publishedVersion } from "./updater/registry.js";
 import { createUpdater } from "./updater/service.js";
+import { workInProgress } from "./updater/work-in-progress.js";
 // ceiling: a burst of finished stages coalesces into one delivery a second later, and the
 // collector gets ten seconds to answer before the attempt is abandoned and the events
 // stay queued.
@@ -337,24 +338,10 @@ export async function boot(config, options = {}) {
                     : npm === undefined
                         ? "npm was not found, so in-app updates are off. Install Node.js with npm (https://nodejs.org), or update from the terminal: npx @gentbajko/slopify@latest"
                         : undefined,
-            busy: () => updateDb.prepare("SELECT 1 FROM stages WHERE state = 'running' LIMIT 1").get() !==
-                undefined ||
-                updateDb
-                    .prepare("SELECT id FROM projects")
-                    .all()
-                    .some((row) => typeof row.id === "string" && runner.hasInflight?.(row.id) === true),
-            busyWith: () => {
-                const running = updateDb
-                    .prepare("SELECT p.title FROM stages s JOIN projects p ON p.id=s.project_id WHERE s.state='running' LIMIT 1")
-                    .get();
-                if (typeof running?.title === "string")
-                    return running.title;
-                const inflight = updateDb
-                    .prepare("SELECT id,title FROM projects")
-                    .all()
-                    .find((row) => typeof row.id === "string" && runner.hasInflight?.(row.id) === true);
-                return typeof inflight?.title === "string" ? inflight.title : undefined;
-            },
+            // An update never installs while a job is going (`updater/work-in-progress.ts`).
+            busy: () => workInProgress(updateDb, (id) => runner.hasInflight?.(id) === true, Date.now()) !==
+                undefined,
+            busyWith: () => workInProgress(updateDb, (id) => runner.hasInflight?.(id) === true, Date.now()),
             report: (message) => log.write("warn", "update", { detail: message }),
             install: async (next, restarting) => {
                 if (npm === undefined)

package/dist/patch-notes/3.0.9.md

@@ -0,0 +1,27 @@
+# Slopify 3.0.9
+
+Released 29 September 2026.
+
+3.0.9 gives every image its own moment from the article, lets a project run without an article, and makes sure an update never lands in the middle of a job.
+
+## Highlights
+
+- **Scenes from the article:** images of one prompt stop being the same picture drawn again.
+- **Article can be Off**, for projects of images or a thumbnail only.
+- **Updates wait for every kind of job**, including a batch between two videos and a schedule about to run.
+
+## Images
+
+- **Scenes from the article** (Images, in Play and Edit project; off by default). Before the images are drawn, the project's AI model reads the article once and writes a short scene for each image, from the article's opening to its ending in the order the images are shown. Each image is drawn from its prompt with its scene added: where the prompt has `{{Scene}}`, there, otherwise after the prompt's first paragraph, so any prompt works unchanged. `{{Scene}}` is never a field to fill in; with the switch off, a `{{Scene}}` line is left out. One more AI call per run, shown on Review as "Image scenes".
+
+## Article
+
+- **Article: Off.** A project can have no article at all: for images or a thumbnail made from prompts, with no placeholder text. Choosing Off switches off what reads the article (research, narration, captions, the YouTube description, shorts, the PDF and Scenes from the article) and takes their sections out of Play and Edit project; the thumbnail offers From prompt and Provide only.
+
+## Updates
+
+- An update never installs while a job is going. Besides a running step, that now includes a step waiting to try again, a project between two steps, a batch with videos still queued, a narration chunk about to be recorded again, and a schedule writing topics or due to start within 10 minutes. A waiting update installs by itself once everything has been idle for two looks in a row. Updates still start only when you press Update.
+
+## Upgrading from 3.0.8
+
+- **Nothing becomes outdated.** Scenes from the article is off until you switch it on in a project or template.

package/dist/patch-notes/index.json

@@ -1,4 +1,10 @@
 [
+  {
+    "id": "3.0.9",
+    "title": "Slopify 3.0.9",
+    "version": "3.0.9",
+    "date": "2026-09-29"
+  },
   {
     "id": "3.0.8",
     "title": "Slopify 3.0.8",

package/dist/slices/admission/rules.js

@@ -58,7 +58,7 @@ export function edgeSilenceSecondsProblem(value) {
 // drawn in; the rule itself only asks whether a source is on its stage's list.
 export const allowedSources = {
     research: ["off", "generate", "provide"],
-    article: ["generate", "provide"],
+    article: ["off", "generate", "provide"],
     audio: ["off", "generate", "provide"],
     images: ["off", "generate", "provide"],
     thumbnail: ["off", "from_prompt", "prompt_by_llm", "provide"],
@@ -159,7 +159,8 @@ export function admit(input) {
 // only generated narration uses separately selected intro/outro entries.
 export function normaliseDraft(draft) {
     const sources = { ...draft.sources };
-    if (sources.article === "provide") {
+    // A pasted article, or none, is not researched.
+    if (sources.article !== "generate") {
         sources.research = "off";
     }
     if (sources.images === "off" && sources.video === "generate") {
@@ -226,6 +227,7 @@ function checkProvided(draft, staged, fields) {
     if (sources.article === "provide" && blank(provided.article)) {
         fields.push({ field: "provided.article", message: "Paste the article." });
     }
+    fields.push(...articleOffFields(draft));
     if (sources.audio === "provide") {
         checkFile(staged, provided.audio, "audio", "provided.audio", "Pick an audio file.", fields);
     }
@@ -497,3 +499,70 @@ export function usesPronunciationGlossary(draft) {
         draft.audio.provider === "inworld" &&
         (draft.audio.model === "inworld-tts-2" || draft.audio.model === "inworld-tts-2-flash"));
 }
+// Article Off: a project of images or a thumbnail from prompts, with no text at all. What reads
+// the article can't be on with it.
+export function articleOffFields(draft) {
+    const { sources } = draft;
+    if (sources.article !== "off")
+        return [];
+    const fix = "Set Article to Generate or Provide";
+    return [
+        ...(sources.audio === "generate"
+            ? [
+                {
+                    field: "sources.audio",
+                    message: `Narration reads the article, and Article is Off. ${fix}, or set Narration to Off or Provide.`,
+                },
+            ]
+            : []),
+        ...(sources.document === "generate"
+            ? [
+                {
+                    field: "sources.document",
+                    message: `The PDF is made from the article, and Article is Off. ${fix}, or set PDF to Off.`,
+                },
+            ]
+            : []),
+        ...(sources.thumbnail === "prompt_by_llm"
+            ? [
+                {
+                    field: "sources.thumbnail",
+                    message: `The AI writes the thumbnail prompt from the article, and Article is Off. ${fix}, or pick From prompt for the thumbnail.`,
+                },
+            ]
+            : []),
+        // Captions, the description and the shorts match the narration to the article's words.
+        ...(sources.audio !== "off" && draft.subtitles !== undefined && draft.subtitles.mode !== "off"
+            ? [
+                {
+                    field: "subtitles.mode",
+                    message: `Captions are matched to the article's words, and Article is Off. ${fix}, or turn captions off.`,
+                },
+            ]
+            : []),
+        ...(usesYoutubeDescription(draft)
+            ? [
+                {
+                    field: "youtubeDescription",
+                    message: `The YouTube description is written from the narration's words, which come from the article, and Article is Off. ${fix}, or turn the YouTube description off.`,
+                },
+            ]
+            : []),
+        ...(usesShorts(draft)
+            ? [
+                {
+                    field: "shorts.enabled",
+                    message: `Shorts are picked from the narration's words, which come from the article, and Article is Off. ${fix}, or turn Shorts off.`,
+                },
+            ]
+            : []),
+        ...(sources.images === "generate" && draft.imageScenes === true
+            ? [
+                {
+                    field: "imageScenes",
+                    message: `Scenes from the article need the article, and Article is Off. ${fix}, or turn Scenes from the article off.`,
+                },
+            ]
+            : []),
+    ];
+}

package/dist/slices/admission/schema.js

@@ -91,6 +91,8 @@ export const runDraftSchema = z.object({
     imagePrompts: z.array(z.object({ name: z.string(), number: z.number() })),
     // The ranges are `slices/images/scale.ts`'s, checked by admission, not the schema's.
     imageScale: z.object({ perHour: z.number(), words: z.number() }).optional(),
+    // Scenes from the article: each image drawn from its own scene (`images/scenes.ts`).
+    imageScenes: z.boolean().optional(),
     thumbnailPrompt: z.string().optional(),
     thumbnailCount: z.union([z.literal(1), z.literal(3)]).optional(),
     intro: entryChoice.optional(),

package/dist/slices/admission/substitute.js

@@ -37,15 +37,18 @@ export function detectSlots(body) {
     }
     return { names, errors };
 }
+// Filled by Slopify, never by the person: each image's own scene, which the project's AI model
+// writes from the article when an image prompt asks for it (`images/scenes.ts`).
+export const sceneKeyword = "Scene";
 // One field per distinct name; Common when a name is used on both sides, otherwise Text or
 // Image. The order is first appearance, which is why both sides arrive as ordered lists of
-// bodies rather than as sets.
+// bodies rather than as sets. The scene keyword is not a field: Slopify fills it.
 export function collectFields(textBodies, imageBodies) {
     const text = namesOf(textBodies);
     const image = namesOf(imageBodies);
     const fields = [];
     for (const name of [...text, ...image]) {
-        if (fields.some((field) => field.name === name)) {
+        if (name === sceneKeyword || fields.some((field) => field.name === name)) {
             continue;
         }
         const onText = text.includes(name);

package/dist/slices/estimate/index.js

@@ -176,6 +176,9 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
         });
     if (images === 0)
         local("Images", "Provided or off.");
+    // Scenes from the article: one call reads the article and writes every image's scene.
+    if (images > 0 && draft.imageScenes === true)
+        text("Image scenes", articleChars + 1500, 120 * images);
     // The establishing image is one more image when it is made from a prompt.
     if (usesReference(draft) && draft.reference?.source === "prompt")
         requests.push({

package/dist/slices/images/scenes.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { detectSlots, render, sceneKeyword } from "../admission/substitute.js";
+// Scenes from the article (Images → Scenes from the article): each image is drawn from its
+// own scene instead of the same text every time. One call to the project's AI model reads the
+// article and writes every scene, following the article from its opening to its end in the
+// order the images are shown.
+export function usesScene(body) {
+    return body != null && detectSlots(body).names.includes(sceneKeyword);
+}
+// The prompt with its scene: where the prompt has `{{Scene}}`, there; otherwise as a line of
+// its own after the prompt's first paragraph, so any prompt takes a scene without editing.
+export function withScene(body, scene) {
+    if (usesScene(body))
+        return render(body, { [sceneKeyword]: scene });
+    const at = body.indexOf("\n\n");
+    return at === -1
+        ? `${body}\n\nScene: ${scene}`
+        : `${body.slice(0, at)}\n\nScene: ${scene}${body.slice(at)}`;
+}
+// The prompt with the switch off: a line that holds `{{Scene}}` is left out, so the image is
+// drawn from the rest of the prompt as it always was.
+export function withoutScene(body) {
+    if (!usesScene(body))
+        return body;
+    return body
+        .split("\n")
+        .filter((line) => !usesScene(line))
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+// What kind of picture each image is: the prompt's own "Composition:" paragraph when it has
+// one (the wide shot, the close portrait), otherwise the prompt's name.
+export function pictureKind(body, name) {
+    const composition = /^\s*Composition:\s*(.+)$/im.exec(body)?.[1]?.trim();
+    return composition === undefined || composition === "" ? name : composition;
+}
+// The count is written on a line of its own so the answer can be checked against it when the
+// call runs (`sceneCountOf`), from the saved request alone.
+const countLine = /^Pictures: (\d+)$/m;
+export function sceneMessages(brief) {
+    const count = brief.pictures.length;
+    return [
+        {
+            role: "system",
+            content: [
+                "You plan the pictures for a narrated video. Read the article and write one scene for each picture listed, in the listed order.",
+                `The pictures are shown in that order while the article is narrated from start to finish. Divide the article into ${String(count)} consecutive stretches of about equal length: scene 1 comes from the first stretch, scene 2 from the second, and so on, so the last scene comes from the ending. Keep to this order even when a later moment would suit a picture better.`,
+                "Each scene is one or two sentences saying what the picture shows: the subject, the place, what is happening, and the light and mood. Choose a moment its stretch of the article actually describes, and frame it the way the picture's kind asks (a wide view, a close figure, a moment of action, a mood).",
+                "Every scene shows something different: never the same subject or moment twice.",
+                "Describe only what can be seen. No text, lettering, captions, labels or logos in the picture, and nothing about art style or medium: the style is set elsewhere.",
+                `Answer with a JSON array of exactly ${String(count)} strings, one scene per picture, and nothing else.`,
+                `Pictures: ${String(count)}`,
+            ].join("\n\n"),
+        },
+        {
+            role: "user",
+            content: [
+                `Video: ${brief.title}`,
+                `The ${String(count)} pictures, in order:\n${brief.pictures.map((kind, index) => `${String(index + 1)}. ${kind}`).join("\n")}`,
+                `Article:\n\n${brief.article}`,
+            ].join("\n\n"),
+        },
+    ];
+}
+export function sceneCountOf(messages) {
+    for (const message of messages) {
+        const found = countLine.exec(message.content);
+        if (found?.[1] !== undefined)
+            return Number(found[1]);
+    }
+    return undefined;
+}
+export function checkScenes(text, count) {
+    const fix = "Use Try again; if it keeps happening, choose another model in the Providers section of Edit project.";
+    const parsed = z.array(z.string()).safeParse(jsonArrayOf(text));
+    if (!parsed.success)
+        return {
+            ok: false,
+            reason: `The AI model didn't answer with a list of image scenes. ${fix}`,
+        };
+    const scenes = parsed.data.map((scene) => scene.replace(/\s+/g, " ").trim());
+    if (scenes.length !== count)
+        return {
+            ok: false,
+            reason: `The AI model wrote ${String(scenes.length)} image scenes for ${String(count)} images. ${fix}`,
+        };
+    if (scenes.some((scene) => scene === ""))
+        return { ok: false, reason: `One of the AI model's image scenes is empty. ${fix}` };
+    return { ok: true, scenes };
+}
+function jsonArrayOf(text) {
+    const start = text.indexOf("[");
+    const end = text.lastIndexOf("]");
+    if (start === -1 || end <= start)
+        return undefined;
+    try {
+        return JSON.parse(text.slice(start, end + 1));
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/slices/play-drafts/convert.js

@@ -31,7 +31,7 @@ export function toAdmissionDraft(input) {
     const fields = [];
     const sources = {
         ...form.sources,
-        ...(form.sources.article === "provide" ? { research: "off" } : {}),
+        ...(form.sources.article !== "generate" ? { research: "off" } : {}),
         ...(form.sources.images === "off" ? { video: "off" } : {}),
     };
     const number = (raw, field, max, min = 1) => {
@@ -217,6 +217,10 @@ export function toAdmissionDraft(input) {
         ...(sources.images === "generate" && form.imageScale !== undefined
             ? { imageScale: imageScaleOf(input.document, fields) }
             : {}),
+        // Scenes are written from the article: with Article Off the switch is left out.
+        ...(sources.images === "generate" && sources.article !== "off" && form.imageScenes === true
+            ? { imageScenes: true }
+            : {}),
         thumbnailPrompt: ["from_prompt", "prompt_by_llm"].includes(sources.thumbnail)
             ? form.thumbnailPrompt
             : undefined,

package/dist/slices/play-drafts/schema.js

@@ -141,6 +141,8 @@ export const playDraftFormSchema = z
         .strict()
         .readonly()
         .optional(),
+    // Scenes from the article, switched on. Absent is off.
+    imageScenes: z.boolean().optional(),
     thumbnailPrompt: text,
     intro: text,
     outro: text,

package/dist/slices/project-templates/from-project.js

@@ -238,6 +238,7 @@ export function documentFromProject(deps, revision) {
                 : { paragraphPause: String(config.paragraphPauseSeconds) }),
             imagePrompts,
             ...(config.imageScale === undefined ? {} : { imageScale: imageScaleForm(config.imageScale) }),
+            ...(config.imageScenes === true ? { imageScenes: true } : {}),
             thumbnailPrompt: config.thumbnailPrompt ?? "",
             intro: config.intro?.name ?? "",
             outro: config.outro?.name ?? "",

package/dist/slices/rebuild/preview-details.js

@@ -82,7 +82,9 @@ export function previewDetails(deps, view, allRecipes, selected) {
                                 ? "Research"
                                 : row.key.startsWith("shorts:")
                                     ? "Short image prompts"
-                                    : "Thumbnail prompt";
+                                    : row.key === "images:scenes"
+                                        ? "Image scenes"
+                                        : "Thumbnail prompt";
             return [
                 {
                     key: row.key,

package/dist/slices/rebuild/recipe-build.js

@@ -8,6 +8,7 @@ import { masterPlan } from "./recipe-loudness.js";
 import { resourceIdentity } from "./recipe-model.js";
 import { imageReference, referenceRecipe } from "./recipe-reference.js";
 import { withReviews } from "./recipe-reviews.js";
+import { imageScenes } from "./recipe-scenes.js";
 import { shortsRecipes } from "./recipe-shorts.js";
 import { textRecipes } from "./recipe-text.js";
 import { thumbnailRecipes, visualAssets, visualRecipes } from "./recipe-visual.js";
@@ -29,6 +30,8 @@ export function buildRecipes(context) {
     const drawnFrom = imageReference(context, reference);
     const thumbnail = thumbnailRecipes(context, text.recipes, referenceForThumbnail(context.config) ? drawnFrom : undefined);
     const youtube = youtubeRecipes(context, exports);
+    // Each image's scene, written from the article, for image prompts that ask for one.
+    const scenes = imageScenes(context, text);
     return withReviews(context, [
         ...text.recipes,
         ...audio.recipes,
@@ -38,6 +41,7 @@ export function buildRecipes(context) {
         ...shortsRecipes(context, exports, drawnFrom, audio.cards ?? [], masterPlan(context, audio.levels, "video")),
         ...thumbnail,
         ...documentRecipes(context, text, thumbnail),
-        ...visualAssets(context, visualRecipes(context.config, context.content, audio.mediaFingerprint, captions?.fingerprint ?? null, (images) => editPlan(context, exports, youtube, images, audio.cards ?? []), drawnFrom, timing === undefined ? null : resourceIdentity(context, timing), withLines(masterPlan(context, audio.levels, "video"), linePlan(context, timing)))),
+        ...visualAssets(context, visualRecipes(context.config, context.content, audio.mediaFingerprint, captions?.fingerprint ?? null, (images) => editPlan(context, exports, youtube, images, audio.cards ?? []), drawnFrom, timing === undefined ? null : resourceIdentity(context, timing), withLines(masterPlan(context, audio.levels, "video"), linePlan(context, timing)), scenes)),
+        ...(scenes === undefined ? [] : [scenes.recipe]),
     ]);
 }

package/dist/slices/rebuild/recipe-model.js

@@ -44,6 +44,9 @@ export const deferredOperations = [
     "shorts",
     "animate",
     "script-attribution",
+    // Scenes from the article (`recipe-scenes.ts`): the scenes step and each image waiting on it.
+    "image-scenes",
+    "image-scene",
 ];
 export function recipe(context, key, stage, input, dependsOn = [], options = {}) {
     const requestFingerprint = input.kind === "tts" && input.dialogue !== undefined

package/dist/slices/rebuild/recipe-provider-choice.js

@@ -32,7 +32,9 @@ export function recipeProviderChoice(recipe, config) {
             };
     if (input.kind !== "deferred")
         return undefined;
-    const family = input.operation === "narration-preparation" || input.operation === "narration-description"
+    const family = input.operation === "narration-preparation" ||
+        input.operation === "narration-description" ||
+        input.operation === "image-scenes"
         ? "llm"
         : recipe.stage === "audio"
             ? "tts"

package/dist/slices/rebuild/recipe-save.js

@@ -1,6 +1,6 @@
 import { stageKinds } from "../../kernel/pipeline.js";
 import { sourceOf } from "../admission/model.js";
-import { allowedSources, edgeSilenceSecondsProblem, imageSecondsProblem, normaliseDraft, silenceGapSecondsMax, voicesFields, zoomPercentProblem, } from "../admission/rules.js";
+import { allowedSources, articleOffFields, edgeSilenceSecondsProblem, imageSecondsProblem, normaliseDraft, silenceGapSecondsMax, voicesFields, zoomPercentProblem, } from "../admission/rules.js";
 import { shortModeFields } from "../admission/short-mode.js";
 import { render } from "../admission/substitute.js";
 import { effectiveClips, pickedShortsOf, rangeProblem } from "../shorts/clips.js";
@@ -27,7 +27,7 @@ function shortRangeFields(base, config, content) {
 }
 export function normalizeArticleIntent(base, edit) {
     const restart = edit.regenerate?.includes("article:body") === true ||
-        (base.revision.config.sources.article === "provide" &&
+        (base.revision.config.sources.article !== "generate" &&
             edit.config.sources.article === "generate");
     const submittedText = edit.content.articleEdited === true ||
         edit.content.articleMarkdown !== base.revision.content.articleMarkdown;
@@ -232,6 +232,7 @@ export function validateRevisionEdit(config, content) {
     if (config.sources.article === "provide" &&
         !(content.articleMarkdown ?? config.provided.article)?.trim())
         fields.push({ field: "provided.article", message: "Paste the article." });
+    fields.push(...articleOffFields(config));
     if (config.sources.audio === "off" &&
         config.subtitles !== undefined &&
         config.subtitles.mode !== "off")

package/dist/slices/rebuild/recipe-scenes.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { withLanguage } from "../../kernel/ports/languages.js";
+import { pictureKind, sceneMessages } from "../images/scenes.js";
+import { recipe, selectedReference, } from "./recipe-model.js";
+import { llmInput, llmInputFingerprint } from "./recipe-text.js";
+export const imageScenesKey = "images:scenes";
+export function imageScenes(context, text) {
+    const { config, content } = context;
+    if (config.sources.images !== "generate" || config.imageScenes !== true)
+        return undefined;
+    const keys = [];
+    const pictures = [];
+    for (const key of content.imageOrder) {
+        const image = content.imageDefinitions[key];
+        if (image?.source !== "generate")
+            continue;
+        const body = image.templateKey == null
+            ? image.prompt
+            : (content.promptTemplates[image.templateKey] ?? image.prompt);
+        if (body == null || body.trim() === "")
+            continue;
+        const at = /^imagePrompts\.(\d+)$/.exec(image.templateKey ?? "")?.[1];
+        const name = at === undefined ? "Image" : (config.imagePrompts[Number(at)]?.name ?? "Image");
+        keys.push(key);
+        pictures.push(pictureKind(body, name));
+    }
+    if (keys.length === 0)
+        return undefined;
+    const messages = withLanguage(sceneMessages({ title: config.title, article: text.articleText ?? "", pictures }), config.language);
+    const value = recipe(context, imageScenesKey, "images", text.articleText === null
+        ? {
+            kind: "deferred",
+            version: 1,
+            operation: "image-scenes",
+            template: [llmInputFingerprint(context, messages), text.article.fingerprint],
+        }
+        : llmInput(context, messages), [text.article.key]);
+    return {
+        recipe: value,
+        keys,
+        scenes: text.articleText === null ? undefined : savedScenes(context, value, keys.length),
+    };
+}
+// The scenes saved for this request. The request carries the model's thinking settings from
+// the catalogue, which the plan without a catalogue has not got, so either fingerprint
+// matches (like the shorts' saved prompts).
+function savedScenes(context, value, count) {
+    const logical = context.catalogue === undefined || value.input.kind !== "llm"
+        ? value.fingerprint
+        : recipe({ content: context.content }, value.key, value.stage, { ...value.input, thinkingConfig: null }, value.dependsOn).fingerprint;
+    const piece = context.manifest.pieces.find((row) => row.key === value.key &&
+        selectedReference(row) &&
+        row.piece.state === "done" &&
+        (row.fingerprint === value.fingerprint || row.fingerprint === logical));
+    if (piece?.piece.payload == null)
+        return undefined;
+    const parsed = z
+        .object({ scenes: z.array(z.string()) })
+        .safeParse(JSON.parse(piece.piece.payload));
+    return parsed.success && parsed.data.scenes.length === count ? parsed.data.scenes : undefined;
+}

package/dist/slices/rebuild/recipe-text.js

@@ -124,7 +124,8 @@ export function textRecipes(context) {
             speakers: voices.speakers.map((speaker) => ({ id: speaker.id, name: speaker.name })),
             attribute: !writesScript,
         };
-    const article = config.sources.article === "provide" || content.articleEdited === true
+    // A pasted article, or with Article Off an empty one: nothing is written.
+    const article = config.sources.article !== "generate" || content.articleEdited === true
         ? recipe(context, "article:body", "article", {
             kind: "local",
             version: 1,
@@ -250,7 +251,7 @@ export function textRecipes(context) {
         ...(script === undefined ? {} : { script }),
     };
 }
-function llmInputFingerprint(context, messages) {
+export function llmInputFingerprint(context, messages) {
     return fingerprint(JSON.parse(JSON.stringify(llmInput(context, messages))));
 }
 export function matchingText(context, value, field) {
@@ -265,7 +266,7 @@ export function matchingText(context, value, field) {
 }
 function articleMarkdownOf(context) {
     const { config, content, resolved } = context;
-    return config.sources.article === "provide" || content.articleEdited === true
+    return config.sources.article !== "generate" || content.articleEdited === true
         ? (content.articleMarkdown ?? config.provided.article ?? "")
         : resolved.articleMarkdown;
 }

package/dist/slices/rebuild/recipe-validation.js

@@ -1,5 +1,5 @@
 import { narrationPreparationFields, shortsFields, usesNarrationPreparation, usesReference, usesShorts, usesYoutubeDescription, videoEditFields, youtubeDescriptionFields, } from "../admission/rules.js";
-import { detectSlots, render } from "../admission/substitute.js";
+import { detectSlots, render, sceneKeyword } from "../admission/substitute.js";
 import { imagesPerVideoMax } from "../images/scale.js";
 import { loudnessFields } from "../loudness/model.js";
 import { pauseFields } from "../narration/pauses-model.js";
@@ -143,7 +143,8 @@ export function validateRecipeInputs(config, content) {
         if (slots.errors.length > 0)
             fields.push({ field: prompt.field, message: "Fix the keyword placeholders in this prompt." });
         for (const key of slots.names)
-            if (!Object.hasOwn(config.values, key) || !config.values[key]?.trim())
+            if (key !== sceneKeyword &&
+                (!Object.hasOwn(config.values, key) || !config.values[key]?.trim()))
                 fields.push({ field: `values.${key}`, message: "Enter a value for this keyword." });
     }
     return fields;

package/dist/slices/rebuild/recipe-visual.js

@@ -1,6 +1,7 @@
 import { thumbnailCountOf, thumbnailKey } from "../admission/model.js";
 import { usesShortMode } from "../admission/short-mode.js";
 import { render } from "../admission/substitute.js";
+import { withoutScene, withScene } from "../images/scenes.js";
 import { usesAmbientBed } from "../video/ambient-bed.js";
 import { castFor } from "./recipe-cast.js";
 import { noMaster } from "./recipe-loudness.js";
@@ -15,7 +16,9 @@ reference,
 // The word timing's identity, which a short's captions are drawn from.
 timing = null, 
 // Level the volume: the levelled narration and the master (`recipe-loudness.ts`).
-master = noMaster) {
+master = noMaster, 
+// Each image's own scene, for the images whose prompt asks for one (`recipe-scenes.ts`).
+scenes) {
     const recipes = [];
     const imageKeys = config.sources.images === "off" ? [] : content.imageOrder;
     for (const key of imageKeys) {
@@ -25,7 +28,17 @@ master = noMaster) {
         const raw = image.templateKey === undefined || image.templateKey === null
             ? undefined
             : content.promptTemplates[image.templateKey];
-        const prompt = raw === undefined || raw === null ? image.prompt : render(raw, config.values);
+        const at = scenes?.keys.indexOf(key) ?? -1;
+        if (scenes !== undefined && at !== -1 && image.source === "generate") {
+            recipes.push(sceneImage(config, content, key, raw ?? image.prompt ?? "", scenes, at, reference));
+            continue;
+        }
+        // With Scenes from the article off, a prompt's `{{Scene}}` line is left out.
+        const prompt = raw === undefined || raw === null
+            ? image.prompt === null || image.prompt === undefined
+                ? image.prompt
+                : withoutScene(image.prompt)
+            : render(withoutScene(raw), config.values);
         recipes.push(recipe({ content }, `image:${key}`, "images", image.source === "provide"
             ? { kind: "provided", version: 1, assetId: image.assetId, semantic: null }
             : {
@@ -109,6 +122,37 @@ master = noMaster) {
     }
     return recipes;
 }
+// An image drawn from its own scene. Until the scenes are written it waits as a deferred
+// request that names the scenes step and the image's place among them, so writing them turns
+// it into its image request (materialization), and writing them again draws it again.
+function sceneImage(config, content, key, body, scenes, at, reference) {
+    const scene = scenes.scenes?.[at];
+    const prompt = scene === undefined ? undefined : withScene(render(body, config.values), scene);
+    return recipe({ content }, `image:${key}`, "images", prompt === undefined
+        ? {
+            kind: "deferred",
+            version: 1,
+            operation: "image-scene",
+            template: [
+                scenes.recipe.fingerprint,
+                at,
+                config.images?.provider ?? null,
+                config.images?.model ?? null,
+                config.format,
+                ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
+                ...(reference === undefined ? [] : [reference.input.fingerprint]),
+            ],
+        }
+        : {
+            kind: "image",
+            version: 1,
+            ...imageChoice(config),
+            aspect: config.format,
+            prompt,
+            ...(reference === undefined ? {} : { reference: reference.input }),
+            ...castField(castFor(config, prompt)),
+        }, [scenes.recipe.key, ...(reference === undefined ? [] : [reference.key])]);
+}
 // What the ambient bed adds to the render's fingerprint: its settings and, for the user's own
 // file, the project asset it plays. Undefined without a bed.
 export function ambientBedValues(config, content) {