@gentbajko/slopify 2.5.0 → 3.0.1

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

@@ -3,16 +3,22 @@ import { transact } from "../../kernel/db/tx.js";
 import { sourceOf } from "../admission/model.js";
 import { projectById } from "../admission/repo.js";
 import { detectSlots } from "../admission/substitute.js";
+import { projectChannelId } from "../channels/repo.js";
 import { listCheckpoints } from "../checkpoints/repo.js";
 import { documentThemeOf } from "../document/model.js";
+import { imageScaleForm } from "../images/scale.js";
 import { requestHash } from "../play-drafts/repo.js";
+import { reviewSettingsForm } from "../reviews/model.js";
 import { currentRevisionId, revisionById } from "../revisions/repo.js";
 import { shortsExtrasForm } from "../shorts/model.js";
+import { ambientBedFormOf } from "../video/ambient-bed.js";
+import { usesScriptPrompt } from "../voices/model.js";
+import { templateNameMax } from "./schema.js";
 import { createTemplate, readTemplate } from "./service.js";
 export const projectTemplateCreateSchema = z
     .object({
     id: z.uuid(),
-    name: z.string().trim().min(1).max(200),
+    name: z.string().trim().min(1).max(templateNameMax),
     projectId: z.string().min(1).max(64),
     revisionId: z.string().min(1).max(64),
 })
@@ -47,7 +53,11 @@ export function createTemplateFromProject(deps, input) {
         const result = createTemplate(deps, {
             id: parsed.data.id,
             name: parsed.data.name,
-            document: documentFromProject(deps, revision),
+            // The project's channel, so the template lands where the video came from.
+            document: {
+                ...documentFromProject(deps, revision),
+                channelId: projectChannelId(deps.db, project.id),
+            },
         });
         if (result.ok)
             deps.db
@@ -56,7 +66,7 @@ export function createTemplateFromProject(deps, input) {
         return result;
     });
 }
-function documentFromProject(deps, revision) {
+export function documentFromProject(deps, revision) {
     const config = revision.config;
     const prompts = [];
     const entries = [];
@@ -75,14 +85,21 @@ function documentFromProject(deps, revision) {
             updatedAt: revision.createdAt,
         });
     };
-    addPrompt("article", config.articlePrompt, "article");
+    addPrompt(usesScriptPrompt(config) ? "script" : "article", config.articlePrompt, "article");
     addPrompt("narration", config.narrationPrompt, "narration");
     addPrompt("description", config.descriptionPrompt, "description");
+    for (const [stage, picked] of Object.entries(config.reviews?.stages ?? {}))
+        addPrompt("review", picked.prompt, `review.${stage}`);
     const definitions = revision.content.imageOrder.flatMap((key) => {
         const definition = revision.content.imageDefinitions[key];
         return definition === undefined ? [] : [definition];
     });
-    const imagePrompts = config.sources.images === "generate" && definitions.length > 0
+    const imagePrompts = 
+    // A project that scales its images with the narration's length keeps its ticked prompts
+    // and the setting, rather than one prompt per image of the count it planned.
+    config.sources.images === "generate" &&
+        definitions.length > 0 &&
+        config.imageScale === undefined
         ? definitions.map((definition, index) => {
             const key = definition.templateKey ?? "";
             const original = revision.content.promptTemplates[key];
@@ -139,6 +156,9 @@ function documentFromProject(deps, revision) {
         ...(config.shorts?.enabled === true && revision.content.shortsMusic !== undefined
             ? { shortsMusic: attachment("Music from project") }
             : {}),
+        ...(config.ambientBed?.source === "upload" && revision.content.ambientBed !== undefined
+            ? { ambientBed: attachment("Ambient sound from project") }
+            : {}),
     };
     return {
         schemaVersion: 1,
@@ -168,8 +188,10 @@ function documentFromProject(deps, revision) {
                     },
                 }),
             articlePrompt: config.articlePrompt ?? "",
+            ...(config.thumbnailCount === 3 ? { thumbnailCount: 3 } : {}),
             ...(config.narrationPrompt === undefined ? {} : { narrationPrompt: config.narrationPrompt }),
             ...(config.youtubeDescription === true ? { youtubeDescription: true } : {}),
+            ...(config.language === undefined ? {} : { language: config.language }),
             ...(config.descriptionPrompt === undefined
                 ? {}
                 : { descriptionPrompt: config.descriptionPrompt }),
@@ -189,7 +211,33 @@ function documentFromProject(deps, revision) {
             // A project without edit settings makes a template without them, so a video made from
             // it cuts every N seconds like the project did.
             ...(config.videoEdit === undefined ? {} : { videoEdit: config.videoEdit }),
+            ...(config.reviews === undefined ? {} : { reviews: reviewSettingsForm(config.reviews) }),
+            // Without the book: every run of a template would otherwise be the same chapter. "Make the
+            // next chapter" (`next-chapter.ts`) sets it itself.
+            ...(config.voices === undefined ? {} : { voices: withoutBook(config.voices) }),
+            ...(config.ambientBed === undefined
+                ? {}
+                : { ambientBed: ambientBedFormOf(config.ambientBed) }),
+            // Level the volume at the project's targets while it is on; off leaves it to Settings'
+            // default, which is how a template made before the setting starts a run.
+            ...(config.loudness === undefined
+                ? {}
+                : {
+                    loudness: {
+                        enabled: true,
+                        videoLufs: config.loudness.videoLufs,
+                        audioFilesLufs: config.loudness.audioFilesLufs,
+                    },
+                }),
+            // The project's pauses; a project without them leaves the template to the defaults.
+            ...(config.sentencePauseSeconds === undefined
+                ? {}
+                : { sentencePause: String(config.sentencePauseSeconds) }),
+            ...(config.paragraphPauseSeconds === undefined
+                ? {}
+                : { paragraphPause: String(config.paragraphPauseSeconds) }),
             imagePrompts,
+            ...(config.imageScale === undefined ? {} : { imageScale: imageScaleForm(config.imageScale) }),
             thumbnailPrompt: config.thumbnailPrompt ?? "",
             intro: config.intro?.name ?? "",
             outro: config.outro?.name ?? "",
@@ -214,8 +262,13 @@ function documentFromProject(deps, revision) {
         },
         section: "content",
         variants: [],
-        expectedWords: "1500",
+        // The length a project that scales its images planned for, so the template plans the same.
+        expectedWords: String(config.imageScale?.words ?? 1500),
         previewText: "Every story begins with a word.",
         fontUpload: null,
     };
 }
+function withoutBook(voices) {
+    const { book: _book, ...rest } = voices;
+    return rest;
+}

package/dist/slices/project-templates/next-chapter.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { transact } from "../../kernel/db/tx.js";
+import { projectById } from "../admission/repo.js";
+import { projectChannelId } from "../channels/repo.js";
+import { draftRow } from "../play-drafts/repo.js";
+import { createDraft, readDraft } from "../play-drafts/service.js";
+import { currentRevisionId, revisionById } from "../revisions/repo.js";
+import { bookChapterMax, bookLabel, bookTitleMax } from "../voices/model.js";
+import { documentFromProject } from "./from-project.js";
+// Books: an audiobook is written chapter by chapter, one project each. "Make the next chapter"
+// on a chapter opens a new Play draft with everything the book shares - format, speakers and
+// their voices, channel (and so its cast), prompts and settings - and the chapter number one
+// higher. The chapter's own words are left empty: the new chapter is written or pasted fresh,
+// and files the last one was given are listed to attach again, as a template's are.
+export const nextChapterSchema = z
+    .object({ id: z.uuid(), projectId: z.string().min(1).max(64) })
+    .strict()
+    .readonly();
+// The book a project's next chapter belongs to: its own book one chapter on, or, for an
+// audiobook made on its own, a book named after it whose second chapter comes next.
+export function nextBook(title, book) {
+    return book === undefined
+        ? { title: title.trim().slice(0, bookTitleMax) || "Untitled book", chapter: 2 }
+        : { title: book.title, chapter: Math.min(bookChapterMax, book.chapter + 1) };
+}
+export function makeNextChapter(deps, input) {
+    const parsed = nextChapterSchema.safeParse(input);
+    if (!parsed.success)
+        return {
+            ok: false,
+            reason: "not-found",
+            message: "That project could not be found. Open it again from Projects, then try again.",
+        };
+    const { id, projectId } = parsed.data;
+    return transact(deps.db, () => {
+        // Pressed twice (a retry after a dropped answer): the draft it made the first time.
+        if (draftRow(deps.db, id) !== undefined) {
+            const made = readDraft(deps, id);
+            if (made.ok)
+                return { ok: true, value: made.value };
+        }
+        const project = projectById(deps.db, projectId);
+        const current = project === undefined ? undefined : currentRevisionId(deps.db, project.id);
+        const revision = project === undefined || current === undefined
+            ? undefined
+            : revisionById(deps.db, project.id, current);
+        if (project === undefined || revision === undefined)
+            return {
+                ok: false,
+                reason: "not-found",
+                message: "That project could not be found; it may have been deleted. Open Projects and pick another chapter.",
+            };
+        const voices = revision.config.voices;
+        if (voices?.format !== "audiobook")
+            return {
+                ok: false,
+                reason: "not-an-audiobook",
+                message: "Only an audiobook has chapters. Pick Audiobook under Speakers (Play → Narration) to start a book.",
+            };
+        const book = nextBook(revision.config.title, voices.book);
+        const document = documentFromProject(deps, revision);
+        const form = document.form;
+        const result = createDraft(deps, {
+            id,
+            document: {
+                ...document,
+                channelId: projectChannelId(deps.db, project.id),
+                form: {
+                    ...form,
+                    title: bookLabel(book),
+                    voices: { ...voices, book },
+                    provided: {
+                        ...form.provided,
+                        // The new chapter's own words, written or pasted fresh.
+                        research: "",
+                        article: "",
+                    },
+                },
+            },
+        });
+        if (!result.ok)
+            return {
+                ok: false,
+                reason: "conflict",
+                message: "The next chapter's draft could not be made. Press Make the next chapter again; if it keeps failing, use Download diagnostics in Settings and report it.",
+            };
+        // Files the last chapter was given are attached again on Play, as with a template.
+        deps.db.prepare("UPDATE play_draft_attachments SET status='reattach' WHERE draft_id=?").run(id);
+        const made = readDraft(deps, id);
+        if (!made.ok)
+            throw new Error("The next chapter's draft could not be read back");
+        return { ok: true, value: made.value };
+    });
+}

package/dist/slices/project-templates/one-off.js

@@ -0,0 +1,26 @@
+import { detectSlots } from "../admission/substitute.js";
+// A template keeps the settings, never what was typed for one video. A keyword the project
+// title names ({{Topic}} in "History: {{Topic}}") is the video's topic: it changes with every
+// video, so a template stores it empty. Every other keyword ({{minWords}}, {{style}}) is a
+// setting and keeps its value.
+export function topicKeywords(title) {
+    return detectSlots(title).names;
+}
+// The values a template stores: the topic keywords emptied, the rest as they were.
+export function templateValues(title, values) {
+    const topics = topicKeywords(title);
+    // Prototype-free, as `slices/admission/rules.ts` explains: a keyword can be "__proto__".
+    const kept = Object.create(null);
+    for (const [name, value] of Object.entries(values))
+        kept[name] = topics.includes(name) ? "" : value;
+    return kept;
+}
+// The Play document a template is saved from, without the one-off values: the topic keywords
+// emptied and the queued extra videos dropped (each is a topic of its own).
+export function templateDocument(document) {
+    return {
+        ...document,
+        form: { ...document.form, values: templateValues(document.form.title, document.form.values) },
+        variants: [],
+    };
+}

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { projectTemplateSchema } from "./schema.js";
-const select = `SELECT t.id,r.version,r.name,t.created_at AS createdAt,r.created_at AS updatedAt,r.document_json AS document FROM project_templates t JOIN project_template_revisions r ON r.template_id=t.id`;
+// A template in the trash (`deleted_at` set, Settings → Trash) is invisible to every read here.
+const select = `SELECT t.id,r.version,r.name,t.created_at AS createdAt,r.created_at AS updatedAt,r.document_json AS document FROM project_templates t JOIN project_template_revisions r ON r.template_id=t.id AND t.deleted_at IS NULL`;
 const templateSummarySchema = z
     .object({
     id: z.uuid(),

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

@@ -1,9 +1,14 @@
 import { z } from "zod";
 import { playDraftDocumentSchema } from "../play-drafts/schema.js";
+// The longest template name, in characters. Play's Save as template and Library → Templates
+// (save and rename) cap their name fields at it, and a new template is refused past it.
+export const templateNameMax = 120;
+// A template named before the cap (Play once allowed 200) can still be saved under its name.
+const templateNameStoredMax = 200;
 export const templateCreateSchema = z
     .object({
     id: z.uuid(),
-    name: z.string().trim().min(1).max(200),
+    name: z.string().trim().min(1).max(templateNameMax),
     document: playDraftDocumentSchema,
 })
     .strict()
@@ -11,6 +16,7 @@ export const templateCreateSchema = z
 export const templateUpdateSchema = templateCreateSchema
     .unwrap()
     .extend({
+    name: z.string().trim().min(1).max(templateNameStoredMax),
     baseVersion: z.number().int().positive(),
     mutationId: z.uuid(),
 })

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

@@ -1,12 +1,17 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
+import { resolveChannelId, templateChannels } from "../channels/repo.js";
 import { requestHash } from "../play-drafts/repo.js";
 import { createDraft, readDraft } from "../play-drafts/service.js";
 import { insertTemplateRevision, templateById, templateSummaries } from "./repo.js";
 import { templateCreateSchema, templateDeleteSchema, templateInstantiateSchema, templateUpdateSchema, } from "./schema.js";
 import { freshTemplateDraft, templateSetup } from "./setup.js";
 export function listTemplates(deps) {
-    return templateSummaries(deps.db);
+    const channels = templateChannels(deps.db);
+    return templateSummaries(deps.db).map((template) => ({
+        ...template,
+        channelId: channels.get(template.id) ?? resolveChannelId(deps.db, undefined),
+    }));
 }
 export function readTemplate(deps, id, version) {
     if (!z.uuid().safeParse(id).success ||
@@ -39,9 +44,11 @@ export function createTemplate(deps, input) {
             createdAt: at,
             updatedAt: at,
         };
+        // The channel is the template's, not part of its setup: moving it (Channels)
+        // makes no new version, and a draft made from it asks the template (`draftChannel`).
         deps.db
-            .prepare("INSERT INTO project_templates(id,head_version,creation_hash,created_at) VALUES (?,1,?,?)")
-            .run(id, hash, at);
+            .prepare("INSERT INTO project_templates(id,head_version,creation_hash,created_at,channel_id) VALUES (?,1,?,?,?)")
+            .run(id, hash, at, resolveChannelId(deps.db, document.channelId));
         insertTemplateRevision(deps.db, value);
         return { ok: true, value };
     });
@@ -96,7 +103,11 @@ export function deleteTemplate(deps, input) {
             .prepare("SELECT 1 FROM schedules WHERE template_id=? AND deleted_at IS NULL LIMIT 1")
             .get(parsed.data.id))
             return { ok: false, reason: "referenced-by-schedule" };
-        deps.db.prepare("DELETE FROM project_templates WHERE id=?").run(parsed.data.id);
+        // Into the trash (Settings → Trash), not gone: `slices/trash` restores it or removes it
+        // for good. A schedule that is itself in the trash may still name it.
+        deps.db
+            .prepare("UPDATE project_templates SET deleted_at=? WHERE id=? AND deleted_at IS NULL")
+            .run(deps.clock.now().toISOString(), parsed.data.id);
         return { ok: true, value: { deleted: true } };
     });
 }

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

@@ -1,15 +1,26 @@
+import { templateChannelId } from "../channels/repo.js";
 import { snapshotEntry, snapshotPrompt } from "../library/snapshot.js";
+import { templateDocument } from "./one-off.js";
 export function templateSetup(deps, input) {
     const prompts = [];
     const entries = [];
     const choices = [
-        { kind: "article", name: input.form.articlePrompt },
+        {
+            kind: input.form.voices?.source === "script" && input.form.sources.audio === "generate"
+                ? "script"
+                : "article",
+            name: input.form.articlePrompt,
+        },
         { kind: "narration", name: input.form.narrationPrompt ?? "" },
         { kind: "description", name: input.form.descriptionPrompt ?? "" },
         ...input.form.imagePrompts.map((row) => ({ kind: "image", name: row.name })),
         { kind: "thumbnail", name: input.form.thumbnailPrompt },
         { kind: "shorts", name: input.form.shorts?.prompt ?? "" },
         { kind: "image", name: input.form.shorts?.imagePrompt ?? "" },
+        ...Object.values(input.form.reviews?.stages ?? {}).map((stage) => ({
+            kind: "review",
+            name: stage.mode === "off" ? "" : stage.prompt,
+        })),
         {
             kind: "image",
             name: input.form.reference?.source === "prompt" ? input.form.reference.prompt : "",
@@ -32,7 +43,8 @@ export function templateSetup(deps, input) {
             return { ok: false, reason: "missing-prompt" };
         entries.push(row);
     }
-    const { templateSource: _source, ...document } = input;
+    // Only the settings are kept: the topic typed for one video is left empty (`one-off.ts`).
+    const { templateSource: _source, channelId: _channel, ...document } = templateDocument(input);
     return {
         ok: true,
         value: { ...document, fontUpload: null, librarySnapshot: { prompts, entries } },
@@ -49,6 +61,7 @@ export function freshTemplateDraft(deps, document, source) {
         section: "content",
         fontUpload: null,
         templateSource: source,
+        channelId: templateChannelId(deps.db, source.id),
         variants: document.variants.map((variant) => ({ ...variant, id: deps.uuid() })),
         form: {
             ...document.form,
@@ -64,6 +77,9 @@ export function freshTemplateDraft(deps, document, source) {
                 ...(provided.shortsMusic === undefined
                     ? {}
                     : { shortsMusic: provided.shortsMusic === null ? null : fresh(provided.shortsMusic) }),
+                ...(provided.ambientBed === undefined
+                    ? {}
+                    : { ambientBed: provided.ambientBed === null ? null : fresh(provided.ambientBed) }),
             },
         },
     };

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

@@ -72,7 +72,7 @@ export function admitPreview(deps, input) {
                 workIds.push(String(existing.id));
                 if (existing.state !== "running") {
                     deps.db
-                        .prepare("UPDATE revision_work SET state='pending',dispatch_state='allowed',failure_reason=NULL WHERE id=?")
+                        .prepare("UPDATE revision_work SET state='pending',dispatch_state='allowed',failure_reason=NULL,failure_kind=NULL,retry_at=NULL,auto_retries=0 WHERE id=?")
                         .run(String(existing.id));
                     deps.db
                         .prepare(`UPDATE revision_work_pieces SET state='pending',dispatch_state='allowed'

package/dist/slices/rebuild/model.js

@@ -30,6 +30,9 @@ const costRowSchema = z.object({
     low: z.number().finite().nonnegative().nullable(),
     high: z.number().finite().nonnegative().nullable(),
     detail: z.string(),
+    onPlan: z.boolean().optional(),
+    apiLow: z.number().finite().nonnegative().nullable().optional(),
+    apiHigh: z.number().finite().nonnegative().nullable().optional(),
 });
 const costEstimateSchema = z.object({
     currency: z.literal("USD"),
@@ -37,6 +40,9 @@ const costEstimateSchema = z.object({
     low: z.number().finite().nonnegative(),
     high: z.number().finite().nonnegative(),
     unknown: z.number().int().nonnegative(),
+    apiLow: z.number().finite().nonnegative().optional(),
+    apiHigh: z.number().finite().nonnegative().optional(),
+    apiUnknown: z.number().int().nonnegative().optional(),
     expectedWords: z.number().finite().nonnegative(),
     catalogueDate: z.string().nullable(),
     assumptions: z.array(z.string()),

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

@@ -1,9 +1,13 @@
 import { stageKinds } from "../../kernel/pipeline.js";
+import { languageInfo } from "../../kernel/ports/languages.js";
 import { sourceOf } from "../admission/model.js";
 import { motionStyleLabels } from "../admission/rules.js";
 import { documentThemeLabel } from "../document/model.js";
+import { loudnessLabel } from "../loudness/model.js";
+import { reviewModeLabels, reviewModeOf, reviewStageLabels, reviewStages, } from "../reviews/model.js";
 import { getRevisionView } from "../revisions/view.js";
 import { musicVolumeOf, shortsSpeedOf } from "../shorts/model.js";
+import { ambientBedLabels } from "../video/ambient-bed.js";
 import { videoEditOf, videoEditRows } from "../video/edit-settings.js";
 export function previewDetails(deps, view, allRecipes, selected) {
     const parent = view.revision.parentId === null
@@ -48,9 +52,11 @@ export function previewDetails(deps, view, allRecipes, selected) {
                     key: row.key,
                     label: row.key === "reference:image"
                         ? "Establishing image"
-                        : index < 0
-                            ? "Thumbnail image"
-                            : `Image ${index + 1}`,
+                        : row.key.startsWith("thumbnail:image:")
+                            ? `Thumbnail image ${row.key.slice("thumbnail:image:".length)}`
+                            : index < 0
+                                ? "Thumbnail image"
+                                : `Image ${index + 1}`,
                     text: input.prompt,
                     settings: [
                         input.provider,
@@ -95,6 +101,9 @@ export function previewDetails(deps, view, allRecipes, selected) {
     });
     return { inputChanges: parent === undefined ? [] : inputChanges(parent, view), requests };
 }
+function loudnessSummary(value) {
+    return `Video ${loudnessLabel(value.videoLufs, "video")}; audio files ${loudnessLabel(value.audioFilesLufs, "audioFiles")}`;
+}
 function narrationIdentity(row) {
     if (row.input.kind === "tts")
         return { logicalKey: row.input.logicalKey, segment: row.input.segment };
@@ -138,9 +147,17 @@ function inputChanges(parent, view) {
         add(`${name} model`, a?.model, b?.model);
         add(`${name} thinking`, a?.thinking, b?.thinking);
     }
+    add("Language", languageInfo(before.language).name, languageInfo(after.language).name);
     add("Narration voice", before.audio?.voice, after.audio?.voice);
     add("Narration Preparation", before.narrationPrompt, after.narrationPrompt);
     add("Narration chunking", before.chunking, after.chunking);
+    add("Narration aliases", before.audio?.useNarrationAliases === true ? aliasLines(before.narrationAliases) : "Off", after.audio?.useNarrationAliases === true ? aliasLines(after.narrationAliases) : "Off");
+    const described = (audio) => audio?.describeFigures !== true ? "Off" : audio.skipCode === true ? "On, code left out" : "On";
+    add("Describe tables and figures", described(before.audio), described(after.audio));
+    add("Show tables and figures on screen", before.showFigures === true ? "On" : "Off", after.showFigures === true ? "On" : "Off");
+    add("Pause between sentences (seconds)", before.sentencePauseSeconds ?? 0, after.sentencePauseSeconds ?? 0);
+    add("Pause between paragraphs (seconds)", before.paragraphPauseSeconds ?? 0, after.paragraphPauseSeconds ?? 0);
+    add("Level the volume", before.loudness === undefined ? "Off" : loudnessSummary(before.loudness), after.loudness === undefined ? "Off" : loudnessSummary(after.loudness));
     add("YouTube description", before.youtubeDescription === true ? "On" : "Off", after.youtubeDescription === true ? "On" : "Off");
     add("Description prompt", before.descriptionPrompt, after.descriptionPrompt);
     add("Shorts", before.shorts?.enabled === true ? "On" : "Off", after.shorts?.enabled === true ? "On" : "Off");
@@ -150,8 +167,16 @@ function inputChanges(parent, view) {
         : `${String(before.shorts.minSeconds)}-${String(before.shorts.maxSeconds)}`, after.shorts === undefined
         ? undefined
         : `${String(after.shorts.minSeconds)}-${String(after.shorts.maxSeconds)}`);
+    add("Thumbnails", before.thumbnailCount === 3 ? "3" : "1", after.thumbnailCount === 3 ? "3" : "1");
     add("Shorts prompt", before.shorts?.prompt, after.shorts?.prompt);
     add("Shorts image prompt", before.shorts?.imagePrompt, after.shorts?.imagePrompt);
+    add("Reviewer provider", before.reviews?.provider, after.reviews?.provider);
+    add("Reviewer model", before.reviews?.model, after.reviews?.model);
+    add("Reviewer redos", before.reviews?.retries, after.reviews?.retries);
+    for (const stage of reviewStages) {
+        add(`${reviewStageLabels[stage]} review`, reviewModeLabels[reviewModeOf(before.reviews, stage)], reviewModeLabels[reviewModeOf(after.reviews, stage)]);
+        add(`${reviewStageLabels[stage]} review prompt`, before.reviews?.stages[stage]?.prompt, after.reviews?.stages[stage]?.prompt);
+    }
     add("Establishing image", referenceLabel(before), referenceLabel(after));
     add("Thumbnail drawn from the establishing image", before.reference === undefined
         ? undefined
@@ -170,6 +195,7 @@ function inputChanges(parent, view) {
     add("Short ranges set by hand", old.shortsRanges, next.shortsRanges);
     add("Silence gap (seconds)", before.silenceGapSeconds, after.silenceGapSeconds);
     add("Silence at start and end (seconds)", before.edgeSilenceSeconds, after.edgeSilenceSeconds);
+    add("Ambient sound", ambientBedLabel(before, old), ambientBedLabel(after, next));
     add("Seconds per image", before.imageSeconds, after.imageSeconds);
     add("Zoom (%)", before.zoomPercent, after.zoomPercent);
     add("Motion", motionStyleLabels[before.motionStyle], motionStyleLabels[after.motionStyle]);
@@ -207,9 +233,26 @@ function inputChanges(parent, view) {
     add("Manual captions", old.subtitleCues?.cues, next.subtitleCues?.cues);
     return changes;
 }
+// The ambient bed in one line; undefined without one, so a project that never had one lists
+// no change.
+function ambientBedLabel(config, content) {
+    const bed = config.ambientBed;
+    if (bed === undefined)
+        return undefined;
+    const file = bed.source === "upload" && content.ambientBed !== undefined ? " (uploaded file)" : "";
+    return `${ambientBedLabels[bed.source]}${file}, ${String(bed.levelDb)} dB, fade in ${String(bed.fadeInSeconds)} s, tail ${String(bed.tailSeconds)} s`;
+}
 function referenceLabel(config) {
     const reference = config.reference;
     if (reference === undefined)
         return "Off";
     return reference.source === "provide" ? "Uploaded image" : `Prompt: ${reference.prompt ?? ""}`;
 }
+// One line per alias, as the Library shows it, so a changed alias reads as a changed line.
+function aliasLines(aliases) {
+    if (aliases === undefined || aliases.length === 0)
+        return "On, no aliases copied";
+    return aliases
+        .map((alias) => `${alias.written} → ${alias.spoken}${alias.wholeWord ? "" : " (inside words too)"}${alias.caseSensitive ? " (match case)" : ""}`)
+        .join("\n");
+}

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

@@ -168,13 +168,20 @@ export function planPreview(deps, view, catalogue, selection, id) {
         providedReuseRequired: execution.reviews.map((row) => row.key),
         costs: estimateRequests(work.flatMap((row) => priceRecipes(row.inflight || !requiresNewSubmission(deps, view.revision.id, row.key, row.fingerprint)
             ? { ...row, disposition: "reuse" }
-            : row, recipes.find((recipe) => recipe.key === row.key))), snapshot),
+            : row, recipes.find((recipe) => recipe.key === row.key), view.revision.config)), 
+        // The whole catalogue, as Play's review prices with: a CLI row's API figure is read
+        // from the API models, which the execution snapshot leaves out.
+        catalogue),
         wholeRequestNotice: plan.wholeRequestNotice,
-        warnings: submissions.some((row) => row.uncertain)
-            ? [
-                "A previous request was submitted without a saved result or resumable job. Retrying may charge you again.",
-            ]
-            : [],
+        warnings: [
+            ...(submissions.some((row) => row.uncertain)
+                ? [
+                    "A previous request was submitted without a saved result or resumable job. Retrying may charge you again.",
+                ]
+                : []),
+            ...(plan.glossaryNotice ? [plan.glossaryNotice] : []),
+            ...(plan.speakerPronunciationNotice ? [plan.speakerPronunciationNotice] : []),
+        ],
     };
     return { ok: true, value: { preview, execution } };
 }

package/dist/slices/rebuild/recipe-audio-parts.js

@@ -1,4 +1,6 @@
-import { usesNarrationPreparation, usesPronunciationGlossary } from "../admission/rules.js";
+import { aliasMatches } from "../../kernel/ports/narration-aliases.js";
+import { narrationAliasesOf, usesNarrationPreparation, usesPronunciationGlossary, } from "../admission/rules.js";
+import { aliasSpans, withAliasSpans } from "../narration/aliases.js";
 import { narrationRegenerationToken, normalizeNarrationText, planNarration, } from "../narration/plan.js";
 import { pronunciationSpans } from "../narration/pronunciation.js";
 import { prepareRequests } from "../narration/steering.js";
@@ -20,18 +22,20 @@ export function narrationParts(context, logicalKey, originalText, segment, depen
     if (!glossary.ok)
         return [refusedPart(context, logicalKey, dependsOn, glossary.reason)];
     const logicalText = normalizeNarrationText(override?.kind === "text" ? override.text : originalText);
-    const spans = pronunciationSpans(logicalText, glossary.entries);
+    // Aliases first: where one applies, the glossary does not.
+    const aliases = narrationAliasesOf(context.config);
+    const matches = aliasMatches(logicalText, aliases);
+    const spans = withAliasSpans(pronunciationSpans(logicalText, glossary.entries), aliasSpans(logicalText, aliases));
     const wholeRequest = segment !== "body" || (context.config.chunking?.mode ?? "whole") === "whole";
     const choice = context.config.audio;
-    const model = context.catalogue?.tts.find((row) => row.provider === choice?.provider &&
-        row.id === choice.model &&
-        row.enabled &&
-        !row.deprecated);
+    // A retired model's character limit is still its limit: the automatic catalogue check marks
+    // models deprecated, and that alone must not re-split narration and outdate a project.
+    const model = context.catalogue?.tts.find((row) => row.provider === choice?.provider && row.id === choice.model && row.enabled);
     const logicalLimit = Math.max(2, logicalText.length +
         spans.reduce((sum, span) => sum + Math.max(0, span.text.length - (span.end - span.start)), 0));
     const maxCharacters = model?.tts.maxCharacters ?? logicalLimit;
     if (usesNarrationPreparation(context.config)) {
-        const prepared = preparationForGroup(context, logicalKey, logicalText, segment, dependsOn, maxCharacters, spans);
+        const prepared = preparationForGroup(context, logicalKey, logicalText, segment, dependsOn, maxCharacters, spans, matches);
         preparations.push(prepared.preparation);
         if (prepared.refusal !== null)
             return [refusedPart(context, logicalKey, [prepared.preparation.key], prepared.refusal)];
@@ -135,6 +139,35 @@ export function pronunciationFutureValues(context, glossary, article, logicalKey
             ],
         ];
 }
+// What aliases add to a narration recipe that can't be worked out yet. With none copied into
+// the project (every project from before aliases), nothing: its fingerprints stay as they were.
+export function aliasFutureValues(context, logicalKey, source) {
+    const aliases = narrationAliasesOf(context.config);
+    if (aliases.length === 0)
+        return [];
+    const override = context.content.narrationOverrides[logicalKey];
+    if (override?.kind === "asset")
+        return [];
+    // Unknown generated text may contain any alias.
+    if (source === null)
+        return [
+            [
+                "narration-aliases-v1",
+                aliases.map((alias) => [alias.written, alias.spoken, alias.wholeWord, alias.caseSensitive]),
+            ],
+        ];
+    const clean = normalizeNarrationText(override?.kind === "text" ? override.text : source);
+    const matches = aliasMatches(clean, aliases);
+    return matches.length === 0
+        ? []
+        : [
+            [
+                "narration-aliases-v1",
+                logicalKey,
+                matches.map((match) => [match.start, match.end, match.spoken]),
+            ],
+        ];
+}
 export function voiceValues(context) {
     return [
         context.config.audio?.provider ?? null,