@gentbajko/slopify 2.4.0 → 3.0.0

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

@@ -3,11 +3,16 @@ 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 { createTemplate, readTemplate } from "./service.js";
 export const projectTemplateCreateSchema = z
     .object({
@@ -47,7 +52,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
@@ -75,14 +84,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];
@@ -103,6 +119,10 @@ function documentFromProject(deps, revision) {
     // and a snapshot holds one prompt per kind and name.
     if (!prompts.some((prompt) => prompt.kind === "image" && prompt.name === config.shorts?.imagePrompt))
         addPrompt("image", config.shorts?.imagePrompt, "shortsImage");
+    // The establishing image's prompt, the same way.
+    if (config.reference?.source === "prompt" &&
+        !prompts.some((prompt) => prompt.kind === "image" && prompt.name === config.reference?.prompt))
+        addPrompt("image", config.reference.prompt, "referencePrompt");
     for (const category of ["intro", "outro"]) {
         const choice = config[category];
         const body = revision.content.promptTemplates[category] ?? config.rendered[category];
@@ -125,9 +145,19 @@ function documentFromProject(deps, revision) {
             : "",
         audio: config.sources.audio === "provide" ? attachment("Audio from project") : null,
         thumbnail: config.sources.thumbnail === "provide" ? attachment("Thumbnail from project") : null,
+        ...(config.reference?.source === "provide"
+            ? { reference: attachment("Establishing image from project") }
+            : {}),
         images: config.sources.images === "provide"
             ? (definitions.length ? definitions : (config.provided.images ?? [])).map((_, index) => attachment(`Image ${index + 1}`))
             : [],
+        // Named like the project's other files, to be attached again on Play.
+        ...(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,
@@ -147,9 +177,20 @@ function documentFromProject(deps, revision) {
             llm: config.llm ?? { provider: "", model: "" },
             audio: config.audio ?? { provider: "", model: "", voice: "" },
             images: config.images ?? { provider: "", model: "" },
+            ...(config.reference === undefined
+                ? {}
+                : {
+                    reference: {
+                        source: config.reference.source,
+                        prompt: config.reference.prompt ?? "",
+                        thumbnail: config.reference.thumbnail !== false,
+                    },
+                }),
             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 }),
@@ -169,7 +210,31 @@ 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) }),
+            ...(config.voices === undefined ? {} : { voices: 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 ?? "",
@@ -194,7 +259,8 @@ 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,
     };

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 "D&D Lore: {{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/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,30 @@
+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 : "",
+        },
     ];
     for (const choice of choices) {
         if (choice.name === "")
@@ -28,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 } },
@@ -45,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,
@@ -53,6 +70,16 @@ export function freshTemplateDraft(deps, document, source) {
                 audio: provided.audio === null ? null : fresh(provided.audio),
                 thumbnail: provided.thumbnail === null ? null : fresh(provided.thumbnail),
                 images: provided.images.map(fresh),
+                ...(provided.reference === undefined
+                    ? {}
+                    : { reference: provided.reference === null ? null : fresh(provided.reference) }),
+                // Like the images: the name is kept and the file is attached again on Play.
+                ...(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
@@ -46,9 +50,21 @@ export function previewDetails(deps, view, allRecipes, selected) {
             return [
                 {
                     key: row.key,
-                    label: index < 0 ? "Thumbnail image" : `Image ${index + 1}`,
+                    label: row.key === "reference:image"
+                        ? "Establishing image"
+                        : 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, input.model, input.aspect].join(" · "),
+                    settings: [
+                        input.provider,
+                        input.model,
+                        ...(input.thinking === undefined ? [] : [`effort ${input.thinking}`]),
+                        input.aspect,
+                        ...(input.reference === undefined ? [] : ["drawn from the establishing image"]),
+                    ].join(" · "),
                 },
             ];
         }
@@ -85,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 };
@@ -128,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");
@@ -140,8 +167,22 @@ 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
+        : before.reference.thumbnail === false
+            ? "Off"
+            : "On", after.reference === undefined ? undefined : after.reference.thumbnail === false ? "Off" : "On");
     add("Title on the shorts", before.shorts === undefined ? undefined : before.shorts.titleOnScreen === true ? "On" : "Off", after.shorts === undefined ? undefined : after.shorts.titleOnScreen === true ? "On" : "Off");
     add("Shorts speed", before.shorts === undefined ? undefined : `${shortsSpeedOf(before.shorts).toFixed(2)}×`, after.shorts === undefined ? undefined : `${shortsSpeedOf(after.shorts).toFixed(2)}×`);
     add("Shorts music", old.shortsMusic === undefined ? "None" : "Uploaded file", next.shortsMusic === undefined
@@ -154,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]);
@@ -191,3 +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,