@gentbajko/slopify 3.0.11 → 3.0.13

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

@@ -1,5 +1,6 @@
 import { referenceKey } from "../admission/model.js";
 import { usesReference } from "../admission/rules.js";
+import { lookWait, withLooks } from "./recipe-appearance.js";
 import { castFor } from "./recipe-cast.js";
 import { recipe, selectedAsset, } from "./recipe-model.js";
 import { renderedPrompt } from "./recipe-text.js";
@@ -16,7 +17,9 @@ export function imageChoice(config) {
         ...(config.images?.thinking === undefined ? {} : { thinking: config.images.thinking }),
     };
 }
-export function referenceRecipe(context) {
+export function referenceRecipe(context, 
+// How the subject looks, for an establishing prompt with `{{Appearance}}`.
+appearance) {
     const { config, content } = context;
     if (!usesReference(config) || config.reference === undefined)
         return undefined;
@@ -27,7 +30,24 @@ export function referenceRecipe(context) {
             assetId: content.provided.reference ?? null,
             semantic: "reference",
         }, [], { unresolved: content.provided.reference === undefined });
-    const prompt = renderedPrompt(context, referencePromptKey);
+    const written = renderedPrompt(context, referencePromptKey);
+    const prompt = withLooks(written, appearance);
+    if (prompt === null) {
+        const wait = lookWait(written, appearance);
+        return recipe(context, referenceKey, "images", {
+            kind: "deferred",
+            version: 1,
+            operation: "image-scene",
+            template: [
+                ...wait.template,
+                written,
+                config.images?.provider ?? null,
+                config.images?.model ?? null,
+                config.format,
+                ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
+            ],
+        }, wait.dependsOn);
+    }
     return recipe(context, referenceKey, "images", {
         kind: "image",
         version: 1,

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

@@ -1,9 +1,43 @@
 import { z } from "zod";
 import { withLanguage } from "../../kernel/ports/languages.js";
-import { pictureKind, sceneMessages } from "../images/scenes.js";
+import { thumbnailCountOf } from "../admission/model.js";
+import { pictureKind, sceneMessages, usesScene } from "../images/scenes.js";
 import { recipe, selectedReference, } from "./recipe-model.js";
 import { llmInput, llmInputFingerprint } from "./recipe-text.js";
 export const imageScenesKey = "images:scenes";
+export const thumbnailScenesKey = "thumbnail:scenes";
+// With Scenes from the article on, a thumbnail drawn from a Library prompt whose text asks for
+// `{{Scene}}` takes one scene per thumbnail; any other thumbnail is drawn as it always was.
+export function thumbnailScenes(context, text) {
+    const { config, content } = context;
+    if (config.sources.images !== "generate" || config.imageScenes !== true)
+        return undefined;
+    if (config.sources.thumbnail !== "from_prompt")
+        return undefined;
+    const body = content.promptTemplates.thumbnailPrompt ?? config.rendered.thumbnailPrompt;
+    if (!usesScene(body))
+        return undefined;
+    const count = thumbnailCountOf(config);
+    const messages = withLanguage(sceneMessages({
+        title: config.title,
+        article: text.articleText ?? "",
+        pictures: [],
+        thumbnails: count,
+    }), config.language);
+    const value = recipe(context, thumbnailScenesKey, "thumbnail", text.articleText === null
+        ? {
+            kind: "deferred",
+            version: 1,
+            operation: "thumbnail-scenes",
+            template: [llmInputFingerprint(context, messages), text.article.fingerprint],
+        }
+        : llmInput(context, messages), [text.article.key]);
+    return {
+        recipe: value,
+        count,
+        scenes: text.articleText === null ? undefined : savedScenes(context, value, count),
+    };
+}
 export function imageScenes(context, text) {
     const { config, content } = context;
     if (config.sources.images !== "generate" || config.imageScenes !== true)

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, sceneKeyword } from "../admission/substitute.js";
+import { detectSlots, filledKeywords, render } 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,7 @@ 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 (key !== sceneKeyword &&
+            if (!filledKeywords.includes(key) &&
                 (!Object.hasOwn(config.values, key) || !config.values[key]?.trim()))
                 fields.push({ field: `values.${key}`, message: "Enter a value for this keyword." });
     }

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

@@ -3,6 +3,7 @@ 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 { lookWait, withLooks } from "./recipe-appearance.js";
 import { castFor } from "./recipe-cast.js";
 import { noMaster } from "./recipe-loudness.js";
 import { recipe, resourceIdentity, } from "./recipe-model.js";
@@ -18,7 +19,9 @@ timing = null,
 // Level the volume: the levelled narration and the master (`recipe-loudness.ts`).
 master = noMaster, 
 // Each image's own scene, for the images whose prompt asks for one (`recipe-scenes.ts`).
-scenes) {
+scenes, 
+// How the subject and characters look, for prompts with `{{Appearance}}`.
+appearance) {
     const recipes = [];
     const imageKeys = config.sources.images === "off" ? [] : content.imageOrder;
     for (const key of imageKeys) {
@@ -30,15 +33,37 @@ scenes) {
             : content.promptTemplates[image.templateKey];
         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));
+            recipes.push(sceneImage(config, content, key, raw ?? image.prompt ?? "", scenes, at, reference, appearance));
             continue;
         }
         // With Scenes from the article off, a prompt's `{{Scene}}` line is left out.
-        const prompt = raw === undefined || raw === null
+        const written = raw === undefined || raw === null
             ? image.prompt === null || image.prompt === undefined
                 ? image.prompt
                 : withoutScene(image.prompt)
             : render(withoutScene(raw), config.values);
+        const prompt = written === null || written === undefined || image.source !== "generate"
+            ? written
+            : withLooks(written, appearance);
+        // Waiting for the looks: the same wait an image with a scene has, on the lookup instead.
+        if (prompt === null && written !== null && written !== undefined) {
+            const wait = lookWait(written, appearance);
+            recipes.push(recipe({ content }, `image:${key}`, "images", {
+                kind: "deferred",
+                version: 1,
+                operation: "image-scene",
+                template: [
+                    ...wait.template,
+                    written,
+                    config.images?.provider ?? null,
+                    config.images?.model ?? null,
+                    config.format,
+                    ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
+                    ...(reference === undefined ? [] : [reference.input.fingerprint]),
+                ],
+            }, [...wait.dependsOn, ...(reference === undefined ? [] : [reference.key])]));
+            continue;
+        }
         recipes.push(recipe({ content }, `image:${key}`, "images", image.source === "provide"
             ? { kind: "provided", version: 1, assetId: image.assetId, semantic: null }
             : {
@@ -125,9 +150,12 @@ scenes) {
 // 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) {
+function sceneImage(config, content, key, body, scenes, at, reference, appearance) {
     const scene = scenes.scenes?.[at];
-    const prompt = scene === undefined ? undefined : withScene(render(body, config.values), scene);
+    const prompt = scene === undefined
+        ? undefined
+        : (withLooks(withScene(render(body, config.values), scene), appearance, scene) ?? undefined);
+    const wait = lookWait(body, appearance);
     return recipe({ content }, `image:${key}`, "images", prompt === undefined
         ? {
             kind: "deferred",
@@ -141,6 +169,7 @@ function sceneImage(config, content, key, body, scenes, at, reference) {
                 config.format,
                 ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
                 ...(reference === undefined ? [] : [reference.input.fingerprint]),
+                ...wait.template,
             ],
         }
         : {
@@ -151,7 +180,7 @@ function sceneImage(config, content, key, body, scenes, at, reference) {
             prompt,
             ...(reference === undefined ? {} : { reference: reference.input }),
             ...castField(castFor(config, prompt)),
-        }, [scenes.recipe.key, ...(reference === undefined ? [] : [reference.key])]);
+        }, [scenes.recipe.key, ...wait.dependsOn, ...(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.
@@ -170,7 +199,11 @@ export function ambientBedValues(config, content) {
 }
 export function thumbnailRecipes(context, textRecipes, 
 // The establishing image, when it is on and the thumbnail is drawn from it too.
-reference) {
+reference, 
+// Scenes from the article: a thumbnail prompt with `{{Scene}}` takes one per thumbnail.
+scenes, 
+// How the subject and characters look, for a prompt with `{{Appearance}}`.
+appearance) {
     const { config, content } = context;
     if (config.sources.thumbnail === "off")
         return [];
@@ -184,40 +217,63 @@ reference) {
             }, [], { unresolved: content.provided.thumbnail === undefined }),
         ];
     const promptRecipe = textRecipes.find((value) => value.key === "thumbnail:prompt");
-    const prompt = config.sources.thumbnail === "prompt_by_llm" && promptRecipe !== undefined
+    const written = config.sources.thumbnail === "prompt_by_llm" && promptRecipe !== undefined
         ? matchingText(context, promptRecipe, "prompt")
         : renderedPrompt(context, "thumbnailPrompt");
+    const sceneFor = (variant) => scenes?.scenes?.[variant - 1];
+    const withScenes = scenes !== undefined;
     const variants = Array.from({ length: thumbnailCountOf(config) }, (_, index) => index + 1);
-    return variants.map((variant) => recipe(context, thumbnailKey(variant), "thumbnail", prompt === null
-        ? {
-            kind: "deferred",
-            version: 1,
-            operation: "thumbnail-image",
-            template: [
-                promptRecipe?.fingerprint ?? null,
-                config.images?.provider ?? null,
-                config.images?.model ?? null,
-                config.format,
-                // Only what is in use, so a thumbnail made before these existed keeps its
-                // fingerprint.
-                ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
-                ...(reference === undefined ? [] : [reference.input.fingerprint]),
-                ...(variant === 1 ? [] : [["thumbnail-variant", variant]]),
-            ],
-        }
-        : {
-            kind: "image",
-            version: 1,
-            ...imageChoice(config),
-            aspect: config.format,
-            prompt: thumbnailVariantPrompt(prompt, variant),
-            ...(reference === undefined ? {} : { reference: reference.input }),
-            // The thumbnail stands for the whole video, like the establishing image.
-            ...castField(castFor(config, config.title, prompt)),
-        }, [
-        ...(promptRecipe === undefined ? [] : [promptRecipe.key]),
-        ...(reference === undefined ? [] : [reference.key]),
-    ]));
+    return variants.map((variant) => {
+        const scene = sceneFor(variant);
+        // With a scene the thumbnail waits for it; with the switch off a `{{Scene}}` line is left
+        // out, as the images do.
+        const sceneFilled = written === null
+            ? null
+            : withScenes
+                ? scene === undefined
+                    ? null
+                    : withScene(written, scene)
+                : withoutScene(written);
+        // A thumbnail stands for the subject, so it always has the subject's look.
+        const prompt = sceneFilled === null
+            ? null
+            : withLooks(sceneFilled, appearance, scene, { subjectAlways: true });
+        const wait = lookWait(written, appearance);
+        return recipe(context, thumbnailKey(variant), "thumbnail", prompt === null
+            ? {
+                kind: "deferred",
+                version: 1,
+                operation: "thumbnail-image",
+                template: [
+                    promptRecipe?.fingerprint ?? null,
+                    config.images?.provider ?? null,
+                    config.images?.model ?? null,
+                    config.format,
+                    // Only what is in use, so a thumbnail made before these existed keeps its
+                    // fingerprint.
+                    ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
+                    ...(reference === undefined ? [] : [reference.input.fingerprint]),
+                    ...(variant === 1 ? [] : [["thumbnail-variant", variant]]),
+                    ...(withScenes ? [["thumbnail-scene", scenes.recipe.fingerprint]] : []),
+                    ...wait.template,
+                ],
+            }
+            : {
+                kind: "image",
+                version: 1,
+                ...imageChoice(config),
+                aspect: config.format,
+                prompt: thumbnailVariantPrompt(prompt, variant),
+                ...(reference === undefined ? {} : { reference: reference.input }),
+                // The thumbnail stands for the whole video, like the establishing image.
+                ...castField(castFor(config, config.title, prompt)),
+            }, [
+            ...(promptRecipe === undefined ? [] : [promptRecipe.key]),
+            ...(reference === undefined ? [] : [reference.key]),
+            ...(withScenes ? [scenes.recipe.key] : []),
+            ...wait.dependsOn,
+        ]);
+    });
 }
 // The second and third thumbnails are the same prompt asked for another composition, so the
 // three test one idea against itself rather than three ideas. The first is the prompt as it

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

@@ -281,7 +281,10 @@ export function priceRecipe(work, value, config) {
     // Scenes from the article: an image waiting for its scene is one image, and the scenes are
     // one call that reads the article (its length is known once the article is written).
     if (input.kind === "deferred" &&
-        (input.operation === "image-scene" || input.operation === "image-scenes")) {
+        (input.operation === "image-scene" ||
+            input.operation === "image-scenes" ||
+            input.operation === "thumbnail-scenes" ||
+            input.operation === "image-appearance")) {
         const choice = config === undefined ? undefined : recipeProviderChoice(value, config);
         if (choice !== undefined && input.operation === "image-scene")
             return { kind: "image", stage: work.key, provider: choice.provider, model: choice.model };
@@ -292,7 +295,7 @@ export function priceRecipe(work, value, config) {
                 provider: choice.provider,
                 model: choice.model,
                 inputCharacters: 90000,
-                outputCharacters: 4000,
+                outputCharacters: input.operation === "image-appearance" ? 6000 : 4000,
                 detail: "The article is read when the step runs; its length is estimated. Retries are excluded.",
             };
     }

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

@@ -123,7 +123,8 @@ export async function executeExportRecipe(deps, context, piece) {
             type: "stage.progress",
             projectId: context.work.projectId,
             stage: "video",
-            current: Math.min(100, Math.round(elapsedMs / (totalSeconds * 10))),
+            // A tenth of a percent, so a two-hour render moves every few seconds, not minutes.
+            current: Math.min(100, Math.round(elapsedMs / totalSeconds) / 10),
             total: 100,
         });
         // Level the volume: the audio-only file is mastered to the audio files' target, the video to

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

@@ -2,6 +2,7 @@ import { basename } from "node:path";
 import { referenceKey, thumbnailVariant } from "../admission/model.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
+import { checkAppearance } from "../images/appearance.js";
 import { checkScenes, sceneCountOf } from "../images/scenes.js";
 import { spokenPassage } from "../narration/describe.js";
 import { observeNarration } from "../narration/live.js";
@@ -15,7 +16,8 @@ import { outputPath } from "../storage/layout.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
 import { parseAttribution } from "../voices/attribution.js";
 import { parseScript } from "../voices/script.js";
-import { imageScenesKey } from "./recipe-scenes.js";
+import { imageAppearanceKey } from "./recipe-appearance.js";
+import { imageScenesKey, thumbnailScenesKey } from "./recipe-scenes.js";
 import { executeArticleRequests } from "./runtime-article.js";
 import { imageCall } from "./runtime-image.js";
 import { frozenInstructions } from "./runtime-instructions.js";
@@ -196,10 +198,16 @@ function checkAnswer(piece, answer) {
             ? "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."
             : undefined;
     // Scenes from the article: one scene per image, as many as the request lists.
-    if (piece.key === imageScenesKey && piece.input.kind === "llm") {
+    if ((piece.key === imageScenesKey || piece.key === thumbnailScenesKey) &&
+        piece.input.kind === "llm") {
         const checked = checkScenes(answer.text, sceneCountOf(piece.input.messages) ?? 0);
         return checked.ok ? undefined : checked.reason;
     }
+    // The looks it looked up: at least the video's subject.
+    if (piece.key === imageAppearanceKey && piece.input.kind === "llm") {
+        const checked = checkAppearance(answer.text);
+        return checked.ok ? undefined : checked.reason;
+    }
     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."
@@ -217,7 +225,8 @@ function attributionSource(messages) {
     return messages.at(-1)?.content ?? "";
 }
 async function publishText(deps, context, piece, answer) {
-    if (piece.key === imageScenesKey && piece.input.kind === "llm") {
+    if ((piece.key === imageScenesKey || piece.key === thumbnailScenesKey) &&
+        piece.input.kind === "llm") {
         const checked = checkScenes(answer.text, sceneCountOf(piece.input.messages) ?? 0);
         if (!checked.ok)
             throw new Error(checked.reason);
@@ -226,6 +235,15 @@ async function publishText(deps, context, piece, answer) {
         ]), { scenes: checked.scenes, text: answer.text });
         return;
     }
+    if (piece.key === imageAppearanceKey && piece.input.kind === "llm") {
+        const checked = checkAppearance(answer.text);
+        if (!checked.ok)
+            throw new Error(checked.reason);
+        await publishResult(deps, context, piece, preparedTexts(deps, context, piece, [
+            ["instructions", "instructions.md", frozenInstructions(deps, context, piece)],
+        ]), { appearance: checked.appearance, text: answer.text });
+        return;
+    }
     if (piece.input.kind === "llm" && piece.input.preparation !== undefined) {
         const checked = validatePreparation(answer.text, piece.input.preparation.source);
         if (!checked.ok)

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

@@ -79,7 +79,7 @@ export function transitionRevisionWork(deps, input) {
                 db.prepare(`INSERT INTO revision_work_reservations(project_id,revision_id,work_key,work_id,piece_id,fingerprint) VALUES (?,?,?,?,?,?)`).run(input.projectId, input.revisionId, key, existing.workId, existing.pieceId, fp);
                 continue;
             }
-            const kind = exact?.stage ?? stageForKey(key);
+            const kind = exact?.stage ?? input.stages?.[key] ?? stageForKey(key);
             const stage = db
                 .prepare("SELECT id FROM stages WHERE project_id=? AND kind=?")
                 .get(input.projectId, kind);
@@ -129,7 +129,7 @@ function existingWork(db, projectId, key, fingerprint) {
         ? undefined
         : { workId: z.string().parse(row.work_id), pieceId: z.string().parse(row.piece_id) };
 }
-function stageForKey(key) {
+export function stageForKey(key) {
     // A review runs in its item's stage; the narration's review in Audio.
     if (key === "review:narration")
         return "audio";
@@ -142,13 +142,21 @@ function stageForKey(key) {
         return "research";
     if (prefix === "article" || prefix === "entry" || prefix === "script")
         return "article";
-    if (prefix === "audio" || prefix === "narration")
+    if (prefix === "audio" || prefix === "narration" || prefix === "level")
         return "audio";
-    if (prefix === "image" || prefix === "reference")
+    // `images:scenes` and `images:appearance` (the latter is Thumbnail's in a project that draws
+    // no images, which the plan's own stages say).
+    if (prefix === "image" || prefix === "images" || prefix === "reference" || prefix === "figure")
         return "images";
     if (prefix === "thumbnail")
         return "thumbnail";
-    if (prefix === "export" || prefix === "subtitles" || prefix === "video" || prefix === "voices")
+    if (prefix === "export" ||
+        prefix === "subtitles" ||
+        prefix === "video" ||
+        prefix === "voices" ||
+        prefix === "shorts" ||
+        prefix === "youtube" ||
+        prefix === "animate")
         return "video";
     if (prefix === "document")
         return "document";

package/dist/slices/revisions/publication-rules.js

@@ -3,7 +3,7 @@ import { z } from "zod";
 import { workExists } from "../../kernel/runner/work-authority.js";
 import { pieceFile } from "../storage/reconcile.js";
 import { outputSchema } from "../storage/schema.js";
-import { outputsForRevision, piecesForRevision, revisionById } from "./repo.js";
+import { currentRevisionId, outputsForRevision, piecesForRevision, revisionById } from "./repo.js";
 import { stagePieceSchema } from "./schema.js";
 export function publicationAuthority(db, publication) {
     const { work, pieceId, publicationId } = publication;
@@ -42,6 +42,14 @@ export function validatePublication(db, publication, outputs, pieces) {
             .prepare("SELECT logical_fingerprint FROM revision_work_pieces WHERE id=? AND work_id=?")
             .get(publication.pieceId, publication.work.workId);
     const revision = revisionById(db, publication.work.projectId, publication.work.revisionId);
+    // The captions an export carries are the ones selected when it started. An edit while it ran
+    // (a thumbnail redo, say) makes a newer revision: captions made after that are selected there
+    // only, so the current revision counts as well as the work's own.
+    const head = currentRevisionId(db, publication.work.projectId);
+    const captionRevisions = [
+        publication.work.revisionId,
+        ...(head === undefined || head === publication.work.revisionId ? [] : [head]),
+    ];
     for (const row of outputs) {
         const retainedMember = ((authority?.key === "subtitles:files" &&
             ((row.workKey === "export:wav" && row.output.role === "audio_export") ||
@@ -51,12 +59,12 @@ export function validatePublication(db, publication, outputs, pieces) {
             ((authority?.key === "export:wav" || authority?.key === "export:video") &&
                 row.workKey === "subtitles:files" &&
                 ["subtitles_srt", "subtitles_vtt", "subtitle_ass", "subtitle_font"].includes(row.output.role))) &&
-            outputsForRevision(db, publication.work.projectId, publication.work.revisionId).some((old) => old.selected &&
+            captionRevisions.some((revisionId) => outputsForRevision(db, publication.work.projectId, revisionId).some((old) => old.selected &&
                 old.state === "ready" &&
                 old.workKey === row.workKey &&
                 old.output.role === row.output.role &&
                 old.assetId === row.asset.id &&
-                old.fingerprint === row.fingerprint);
+                old.fingerprint === row.fingerprint));
         if (!retainedMember &&
             row.fingerprint !== revision?.fingerprints[row.workKey] &&
             !(row.workKey === authority?.key &&

package/dist/slices/revisions/restore.js

@@ -48,7 +48,12 @@ export async function restoreRevision(deps, input) {
             baseRevisionId: input.baseRevisionId,
             revisionId: revision.id,
             fingerprints: revision.fingerprints,
-            ...(comparison.ok ? { baseFingerprints: comparison.baseFingerprints } : {}),
+            ...(comparison.ok
+                ? {
+                    baseFingerprints: comparison.baseFingerprints,
+                    stages: Object.fromEntries(comparison.recipes.map((row) => [row.key, row.stage])),
+                }
+                : {}),
             logicalKeys: logicalKeys(deps, input.projectId, input.baseRevisionId, revision.fingerprints),
         });
         carryCheckpointGates(deps, input.baseRevisionId, revision);

package/dist/slices/run-cost/timing.js

@@ -4,6 +4,7 @@ import { currentRevisionId } from "../revisions/repo.js";
 const attemptRow = z.object({
     kind: z.enum(stageKinds),
     revision_id: z.string().nullable(),
+    work_id: z.string().nullable(),
     started_at: z.string(),
     ended_at: z.string().nullable(),
     work_state: z.string().nullable(),
@@ -26,14 +27,22 @@ export function coveredMs(intervals) {
 }
 export function projectTiming(db, projectId, now) {
     const rows = db
-        .prepare(`SELECT s.kind AS kind, a.revision_id AS revision_id, a.started_at AS started_at,
-         a.ended_at AS ended_at, w.state AS work_state
+        .prepare(`SELECT s.kind AS kind, a.revision_id AS revision_id, a.work_id AS work_id,
+         a.started_at AS started_at, a.ended_at AS ended_at, w.state AS work_state
        FROM attempts a JOIN stages s ON s.id = a.stage_id
        LEFT JOIN revision_work w ON w.id = a.work_id
        WHERE s.project_id = ?`)
         .all(projectId)
         .map((row) => attemptRow.parse(row));
     const head = currentRevisionId(db, projectId);
+    // Work an edit carried over to the current revision is still its run's work: a video
+    // retried after a thumbnail redo renders on the revision it started on, and its hours count.
+    const carried = new Set(head === undefined
+        ? []
+        : db
+            .prepare("SELECT work_id FROM revision_work_reservations WHERE revision_id=?")
+            .all(head)
+            .flatMap((row) => (typeof row.work_id === "string" ? [row.work_id] : [])));
     const all = [];
     const runs = new Map();
     const stages = new Map();
@@ -50,12 +59,15 @@ export function projectTiming(db, projectId, now) {
         const interval = [start, end];
         all.push(interval);
         stages.set(row.kind, [...(stages.get(row.kind) ?? []), interval]);
-        if (row.revision_id !== null) {
-            const run = runs.get(row.revision_id) ?? { intervals: [], running: false, last: start };
+        const owner = head !== undefined && row.work_id !== null && carried.has(row.work_id)
+            ? head
+            : row.revision_id;
+        if (owner !== null) {
+            const run = runs.get(owner) ?? { intervals: [], running: false, last: start };
             run.intervals.push(interval);
             run.running ||= live;
             run.last = Math.max(run.last, start);
-            runs.set(row.revision_id, run);
+            runs.set(owner, run);
         }
     }
     const latest = (head === undefined ? undefined : runs.get(head)) ??

package/dist/tutorials/Notifications.md

@@ -42,6 +42,15 @@ If you blocked notifications for Slopify earlier, Slopify says "Notifications ar
 
 Some browsers only allow notifications from installed apps. If the test says so, use a Notification URL instead.
 
+## Run sounds
+
+**Settings → Notifications → Run sounds** (on by default) plays a chime when a run starts and a different, longer one when it finishes, fails or stops to wait for you, like a message arriving on a phone. **Play start** and **Play end** let you hear them.
+
+- Works while any Slopify tab is open; only one tab plays each chime.
+- Needs no permission, but browsers keep a page silent until it has been clicked once, so click anywhere in Slopify after opening it.
+- With **Browser notifications** on too, a run's start also shows "Started: *title*".
+- It is this browser's own setting. Your computer's volume sets how loud.
+
 ## Get notifications on your phone (Notification URL)
 
 A Notification URL works with no Slopify tab open. When a run finishes, fails or waits, or a review needs a decision, Slopify sends that address one `POST` with a short plain-text body. Its last line is the project's link, so you can open it straight from the message, for example:

package/dist/tutorials/Play-Images.md

@@ -118,9 +118,19 @@ Where the scene goes:
 - A prompt with `{{Scene}}` gets the scene there, for example a line `Scene: {{Scene}}` under the prompt's first sentence. `{{Scene}}` is never a field to fill in: Slopify writes it.
 - A prompt without it gets the scene as a line of its own after its first paragraph, so any prompt works unchanged.
 - With the switch off, a line holding `{{Scene}}` is left out and the prompt is drawn as it always was.
+- A **thumbnail** prompt with `{{Scene}}` gets a scene from a call of its own (one more AI call, in the Thumbnail stage, so changing the thumbnail never remakes the images): the article's most striking moment, the one that would make someone click, taken from anywhere in the article. With **Thumbnails** set to 3, each thumbnail gets a different moment, so the A/B test compares ideas as well as compositions. A thumbnail prompt without `{{Scene}}` is drawn as it always was.
 
 The style, composition and everything else in the prompt stay as written; only the scene changes from image to image. The scenes are written once the article exists, and each image waits for them. Switching it on or off in **Edit project** remakes the images.
 
+## Looks looked up: {{Appearance}}
+
+An image model draws a named figure from whatever it half remembers, so the same character can look different in every image. Put `{{Appearance}}` in an image, thumbnail or establishing prompt, for example a line `Looks: {{Appearance}}`, and Slopify looks the looks up instead.
+
+- Once the article exists, one call to the project's AI model **searches the web** for how the video's subject and every named character in the article look: build, face, clothing, colours and the marks that make them recognisable. Where depictions disagree, it describes the most iconic one.
+- With **Scenes from the article** on, each picture gets the looks of the figures its scene names (up to three besides the subject), so a scene of a place or of someone else isn't redrawn with the subject in it; a scene that names no one leaves the looks line out. A thumbnail always gets the subject's look. Without scenes, every picture gets the subject's look.
+- There is no switch: a prompt with `{{Appearance}}` turns it on, and prompts without it are drawn as they always were. `{{Appearance}}` is never a field to fill in.
+- It costs one more AI call per run, with web search. The pictures that use it wait for it.
+
 ## How long each image stays on screen
 
 **Seconds per image** (1 to 600, default 15) is in the **Video and style** row, beside **Cuts**, **Zoom** and **Motion**. When cuts follow the narration, it is the target length and a cut waits for a sentence end. When images run out, they start again. See [Play Video and Style](Play-Video-and-Style).

package/dist/tutorials/Play-Outputs.md

@@ -32,7 +32,7 @@ The Thumbnail part has its own **Source** switch:
 | Option | What it does | Default |
 | --- | --- | --- |
 | **Thumbnail prompt** | The Library thumbnail prompt, keywords filled in. **From prompt** sends it to the image model as it is; **Prompt by LLM** gives it to the text model with the title and article to write the image prompt. | None |
-| **Thumbnails** (**1** or **3**) | **3** makes two more thumbnails from the same prompt with different compositions, for YouTube's Test & compare. Each costs one more image, so 3 thumbnails are 3 image calls. | 1 |
+| **Thumbnails** (**1** or **3**) | **3** makes two more thumbnails from the same prompt with different compositions, for YouTube's Test & compare. Each costs one more image, so 3 thumbnails are 3 image calls. With a thumbnail prompt that has `{{Scene}}` and Images → **Scenes from the article** on, each also shows a different moment of the article (see [Play Images](Play-Images#scenes-from-the-article)). | 1 |
 
 ### Make three thumbnails for Test & compare