@gentbajko/slopify 3.25.8 → 4.0.0

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

@@ -1,7 +1,7 @@
 import { subjectOf } from "../admission/model.js";
 import { usesYoutubeDescription } from "../admission/rules.js";
 import { recipe, resourceIdentity, } from "./recipe-model.js";
-import { renderedPrompt } from "./recipe-text.js";
+import { promptOf } from "./recipe-text.js";
 // The YouTube description is written from the word timing, so it waits for
 // `subtitles:timing` and nothing else: it runs beside the render, and a change to the
 // motion, zoom, images or captions' look leaves it current. The transcript is only known once
@@ -12,6 +12,7 @@ export function youtubeRecipes(context, exports) {
     const timing = exports.find((value) => value.key === "subtitles:timing");
     if (!usesYoutubeDescription(config) || timing === undefined)
         return [];
+    const prompt = config.descriptionPrompt?.trim() ? promptOf(context, "description") : undefined;
     return [
         recipe(context, "youtube:description", "video", {
             kind: "local",
@@ -24,12 +25,12 @@ export function youtubeRecipes(context, exports) {
                 config.llm?.thinking ?? null,
                 // Blank means the built-in prompt; the step fills it in, so a new built-in wording
                 // ships as a new operation version rather than a silent change here.
-                config.descriptionPrompt?.trim() ? renderedPrompt(context, "description") : "",
+                prompt?.text ?? "",
                 subjectOf(config),
                 // The project language, only when it is not English, so English keeps its fingerprint.
                 ...(config.language === undefined || config.language === "en" ? [] : [config.language]),
             ],
-        }, [timing.key], 
+        }, [timing.key, ...(prompt?.dependsOn ?? [])], 
         // A paid LLM call: readiness, the charge warning and the estimate treat it like one.
         { kind: "provider" }),
     ];

package/dist/slices/rebuild/recovery-selection.js

@@ -1,5 +1,6 @@
 import { readmitted } from "../../kernel/runner/graph.js";
 import { narrationRegenerationKey } from "../narration/plan.js";
+import { promiseItemKey } from "../reviews/model.js";
 export function sectionRoots(view, plan, stage) {
     if (stage === "article" &&
         (view.revision.config.sources.article !== "generate" || view.revision.content.articleEdited))
@@ -35,7 +36,8 @@ export function redoTarget(view, plan, item) {
     };
     if (item === "narration")
         return section("audio");
-    if (item === "article:body")
+    // The promise check sends the article back: its opening is what broke the promise.
+    if (item === "article:body" || item === promiseItemKey)
         return section("article");
     const own = (roots) => ({
         roots,

package/dist/slices/rebuild/recovery.js

@@ -1,4 +1,5 @@
 import { transact } from "../../kernel/db/tx.js";
+import { internalError } from "../../kernel/errors.js";
 import { stagesOf } from "../admission/repo.js";
 import { withProjectControl } from "../control/lock.js";
 import { requestHash } from "../revisions/mutation-request.js";
@@ -93,7 +94,7 @@ options = {}) {
         if (record.edit !== null) {
             const prior = retainedPreviewPlan(deps, base, deps.catalogue.read());
             if (input.action.kind !== "rerun" && input.action.kind !== "redo")
-                throw new Error("Slopify hit an internal error (a recovery edit has nothing to re-run). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+                throw new Error(internalError("a recovery edit has nothing to re-run"));
             const affected = dependentClosure(prior.recipes, rootsOf(base, prior));
             const savedIntent = deps.db
                 .prepare("SELECT result_revision_id FROM revision_mutations WHERE project_id=? AND idempotency_key=?")
@@ -200,7 +201,7 @@ options = {}) {
         storePreview(deps, preview.value.preview, preview.value.execution);
         const stored = previewById(deps.db, projectId, preview.value.preview.id);
         if (stored === undefined)
-            throw new Error("Slopify hit an internal error (the saved recovery preview is missing). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("the saved recovery preview is missing"));
         return {
             plan: { preview: stored, execution: preview.value.execution },
             view,

package/dist/slices/rebuild/repo.js

@@ -1,4 +1,5 @@
 import { transact } from "../../kernel/db/tx.js";
+import { internalError } from "../../kernel/errors.js";
 import { workExists } from "../../kernel/runner/work-authority.js";
 import { currentRevisionId, revisionById } from "../revisions/repo.js";
 import { rebuildPreviewSchema } from "./model.js";
@@ -7,7 +8,7 @@ export { transitionRevisionWork } from "./transition-repo.js";
 export function publicationTargets(db, publication, workKey, workFingerprint) {
     const { work, pieceId, publicationId } = publication;
     if (publicationId !== (pieceId ?? work.workId))
-        throw new Error("Slopify hit an internal error (a finished result is filed under the wrong step). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("a finished result is filed under the wrong step"));
     if (!workExists(db, work))
         return [];
     if (pieceId !== null) {
@@ -15,9 +16,9 @@ export function publicationTargets(db, publication, workKey, workFingerprint) {
             .prepare("SELECT work_key,fingerprint FROM revision_work_pieces WHERE id=? AND work_id=?")
             .get(pieceId, work.workId);
         if (piece === undefined)
-            throw new Error("Slopify hit an internal error (a finished result belongs to a different step). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("a finished result belongs to a different step"));
         if (piece.work_key !== workKey || piece.fingerprint !== workFingerprint)
-            throw new Error("Slopify hit an internal error (a finished result doesn't match its saved step). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("a finished result doesn't match its saved step"));
     }
     const currentId = currentRevisionId(db, work.projectId);
     const owns = (revisionId) => {

package/dist/slices/rebuild/review-promise.js

@@ -0,0 +1,25 @@
+import { plainText } from "../article/plain.js";
+import { splitEndMatter } from "../article/split.js";
+import { spokenWordsPerMinute } from "../images/scale.js";
+import { normalizeNarrationText } from "../narration/plan.js";
+// How long the opening the promise check reads lasts: the span in which a viewer decides
+// whether the video is what its title and thumbnail said.
+export const promiseOpeningSeconds = 30;
+// The article as the voice would say it (no Markdown, no end matter: what `recipe-text.ts`
+// hands the narration), so the reviewer reads what the viewer will hear.
+export function spokenArticle(markdown) {
+    return normalizeNarrationText(plainText(splitEndMatter(markdown).body));
+}
+// The spoken text cut after the words said in the opening seconds, its own line breaks kept.
+export function openingOf(spoken, seconds = promiseOpeningSeconds, wordsPerMinute = spokenWordsPerMinute) {
+    const words = Math.round((seconds * wordsPerMinute) / 60);
+    let end = 0;
+    let count = 0;
+    for (const match of spoken.matchAll(/\S+/g)) {
+        if (count === words)
+            break;
+        count += 1;
+        end = match.index + match[0].length;
+    }
+    return spoken.slice(0, end);
+}

package/dist/slices/rebuild/review-redo.js

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { errorText } from "../../kernel/errors.js";
 import { reviewKey } from "../reviews/model.js";
 import { pendingRedos, setRedoState } from "../reviews/repo.js";
 import { currentRevisionId } from "../revisions/repo.js";
@@ -49,7 +50,7 @@ export function createReviewRedos() {
                 .catch((error) => {
                 deps.log.write("error", "review.redo", {
                     projectId: verdict.projectId,
-                    detail: error instanceof Error ? error.message : String(error),
+                    detail: errorText(error),
                 });
                 setRedoState(deps.db, verdict.id, "failed", "Slopify hit an internal error while making this item again. Use Redo beside it; if it happens again, use Download diagnostics in Settings and report it.");
             })

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

@@ -1,4 +1,5 @@
 import { transact } from "../../kernel/db/tx.js";
+import { internalError } from "../../kernel/errors.js";
 import { narrationRegenerationToken } from "../narration/plan.js";
 import { currentRevisionId } from "../revisions/repo.js";
 import { bindNarrationReuse, narrationOrdinal } from "./runtime-narration-reuse.js";
@@ -25,7 +26,7 @@ export function admitInitialRevision(deps, view, catalogue) {
         if (deps.db
             .prepare("SELECT 1 FROM revision_work WHERE project_id=? LIMIT 1")
             .get(view.revision.projectId) !== undefined)
-            throw new Error("Slopify hit an internal error (this project was started twice). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("this project was started twice"));
         const snapshot = executionCatalogue(catalogue, view.revision.config);
         const plan = executionPlan(deps, view, snapshot);
         for (const recipe of plan.recipes) {
@@ -35,7 +36,7 @@ export function admitInitialRevision(deps, view, catalogue) {
             const logicalKey = recipe.input.kind === "tts" ? `${recipe.input.logicalKey}:1` : recipe.key;
             const anchor = view.revision.fingerprints[logicalKey] ?? desired;
             if (anchor === undefined)
-                throw new Error(`Slopify hit an internal error (step ${recipe.key} has no saved starting point). Try again; if it happens again, use Download diagnostics in Settings and report it.`);
+                throw new Error(internalError(`step ${recipe.key} has no saved starting point`));
             const reuse = plan.work.find((row) => row.key === recipe.key)?.disposition === "reuse";
             if (reuse)
                 bindNarrationReuse(deps, view, recipe, narrationOrdinal(plan.recipes, recipe.key));
@@ -49,7 +50,7 @@ export function insertInvocation(deps, view, recipe, catalogue, anchor, complete
         .prepare("SELECT id FROM stages WHERE project_id=? AND kind=?")
         .get(projectId, recipe.stage);
     if (typeof stage?.id !== "string")
-        throw new Error("Slopify hit an internal error (a step has no matching stage). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("a step has no matching stage"));
     const work = {
         projectId,
         revisionId,

package/dist/slices/rebuild/runtime-agent-review.js

@@ -1,4 +1,6 @@
 import { z } from "zod";
+import { internalError } from "../../kernel/errors.js";
+import { fillLateKeywords, mentionsLateKeyword } from "../keywords/fill.js";
 import { externalReviewWaitMs } from "../reviews/external-model.js";
 import { openExternalReview } from "../reviews/external-repo.js";
 import { externalReviewByFingerprint } from "../reviews/external-rows.js";
@@ -6,8 +8,10 @@ import { reviewStages } from "../reviews/model.js";
 import { nextAttempt, reviewOutcome } from "../reviews/outcome.js";
 import { latestVerdict, saveVerdict } from "../reviews/repo.js";
 import { exportSnapshot } from "./runtime-export-inputs.js";
+import { lateValuesOf } from "./runtime-keywords.js";
 import { publishResult } from "./runtime-publication.js";
 import { reviewMaterial } from "./runtime-review.js";
+import { pieceAlreadyDone } from "./work-records.js";
 // What `recipe-reviews.ts` saves for a review an external agent answers, by position.
 const valuesSchema = z.tuple([
     z.enum(reviewStages),
@@ -21,16 +25,18 @@ const valuesSchema = z.tuple([
 // agent's verdict through MCP. Waiting is not "held": the stage's other reviews still open
 // theirs in the same pass, and `agentReviewHold` keeps the runner from claiming it again.
 export async function executeAgentReviewRecipe(deps, context, piece) {
-    if (deps.db
-        .prepare("SELECT state FROM revision_work_pieces WHERE id=? AND work_id=?")
-        .get(piece.id, context.work.workId)?.state === "done")
+    if (pieceAlreadyDone(deps.db, context.work.workId, piece.id))
         return "done";
     if (!context.maySubmit(piece.id))
         return "held";
     const values = piece.input.kind === "local" ? valuesSchema.safeParse(piece.input.values) : undefined;
     if (values === undefined || !values.success)
-        throw new Error("Slopify hit an internal error (a review step was set up wrongly). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
-    const [stage, itemKey, , prompt, mode, retries] = values.data;
+        throw new Error(internalError("a review step was set up wrongly"));
+    const [stage, itemKey, , planned, mode, retries] = values.data;
+    // The release date and the length are filled as the review opens, like a request a model is sent.
+    const prompt = mentionsLateKeyword(planned)
+        ? fillLateKeywords(planned, await lateValuesOf(deps, context))
+        : planned;
     const projectId = context.work.projectId;
     const known = externalReviewByFingerprint(deps.db, projectId, piece.fingerprint);
     if (known === undefined || known.state === "superseded" || known.state === "canceled") {

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

@@ -1,10 +1,13 @@
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
+import { errorText, internalError } from "../../kernel/errors.js";
+import { isReadyOutput } from "../revisions/view.js";
 import { discardPreparedAssets, writeAsset } from "../storage/assets.js";
 import { outputPath, projectDir } from "../storage/layout.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { executionView } from "./runtime-plan.js";
 import { preparedResult, publishResult } from "./runtime-publication.js";
+import { pieceAlreadyDone } from "./work-records.js";
 // Animate images: one still of the slideshow sent to the image provider's image-to-video
 // model, and the clip it makes saved beside the image. The still goes up as a small JPEG, so
 // the request stays well under what either provider takes inline.
@@ -16,17 +19,15 @@ import { preparedResult, publishResult } from "./runtime-publication.js";
 // for, and keeps a JPEG to a few hundred KB.
 const sentWidth = 1280;
 export async function executeAnimateRecipe(deps, context, providers, piece) {
-    if (deps.db
-        .prepare("SELECT state FROM revision_work_pieces WHERE id=? AND work_id=?")
-        .get(piece.id, context.work.workId)?.state === "done")
+    if (pieceAlreadyDone(deps.db, context.work.workId, piece.id))
         return "done";
     const input = piece.input;
     if (input.kind !== "image" || input.animate === undefined)
-        throw new Error("Slopify hit an internal error (an animated image was set up wrongly). Use Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("an animated image was set up wrongly"));
     const imageKey = piece.key.slice("animate:".length);
     const view = executionView(deps, context.work.projectId, context.work.revisionId);
     const index = (view?.revision.content.imageOrder.indexOf(imageKey) ?? -1) + 1;
-    const still = view?.outputs.find((row) => row.workKey === `image:${imageKey}` && row.selected && row.available && row.state === "ready");
+    const still = view?.outputs.find((row) => row.workKey === `image:${imageKey}` && isReadyOutput(row));
     const fallback = async (reason) => {
         deps.log.write("warn", "video.animate.fallback", { detail: reason });
         await publishResult(deps, context, piece, [], {
@@ -38,7 +39,7 @@ export async function executeAnimateRecipe(deps, context, providers, piece) {
         return fallback("its image wasn't ready to animate. Use More → Render the video again in the Video section after the image is made.");
     const animate = providers.forPiece(piece.id).animate;
     if (animate === undefined)
-        throw new Error("Slopify hit an internal error (animating images isn't wired up in this build). Use Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("animating images isn't wired up in this build"));
     if (!context.maySubmit(piece.id))
         return "held";
     let made;
@@ -55,7 +56,7 @@ export async function executeAnimateRecipe(deps, context, providers, piece) {
     catch (error) {
         if (context.signal.aborted)
             throw error;
-        return fallback(`${error instanceof Error ? error.message : String(error)} To try again, use More → Render the video again in the Video section.`);
+        return fallback(`${errorText(error)} To try again, use More → Render the video again in the Video section.`);
     }
     if (!made.ok)
         return "held";
@@ -73,7 +74,7 @@ export async function executeAnimateRecipe(deps, context, providers, piece) {
             stage: context.work.kind,
             provider: input.provider,
             model: input.model,
-        });
+        }, context.work.projectId);
     }
     finally {
         discardPreparedAssets(deps, [asset]);

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

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
+import { internalError } from "../../kernel/errors.js";
 import { continuationLimit, continuationMessages } from "../article/continuation.js";
 import { currentRevisionId, revisionById } from "../revisions/repo.js";
 import { recipe } from "./recipe-model.js";
@@ -12,14 +13,14 @@ const answerSchema = z.object({
 });
 export async function executeArticleRequests(deps, context, providers, initial) {
     if (initial.input.kind !== "llm")
-        throw new Error("Slopify hit an internal error (the article step has no AI request). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the article step has no AI request"));
     let piece = initial;
     let text = "";
     let inputTokens = 0;
     let outputTokens = 0;
     for (let part = 0; part <= continuationLimit; part += 1) {
         if (piece.input.kind !== "llm")
-            throw new Error("Slopify hit an internal error (an article continuation has no AI request). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("an article continuation has no AI request"));
         const saved = deps.db
             .prepare("SELECT result_json FROM revision_work_pieces WHERE id=? AND work_id=?")
             .get(piece.id, context.work.workId);

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

@@ -1,3 +1,4 @@
+import { internalError } from "../../kernel/errors.js";
 import { checkpointClosure, checkpointFingerprint } from "../checkpoints/fingerprint.js";
 import { saveCheckpointSet } from "../checkpoints/repo.js";
 import { currentRevisionId } from "../revisions/repo.js";
@@ -11,14 +12,14 @@ export function admitReviewedCheckpoints(deps, projectIds, reviewed, catalogue)
         const revisionId = currentRevisionId(deps.db, projectId);
         const view = revisionId === undefined ? undefined : getRevisionView(deps, projectId, revisionId);
         if (!view)
-            throw new Error("Slopify hit an internal error (the project version to review is missing). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("the project version to review is missing"));
         const plan = executionPlan(deps, view, executionCatalogue(catalogue, view.revision.config));
         const checkpoints = gates.map((gate) => {
             const work = deps.db
                 .prepare("SELECT id FROM revision_work WHERE project_id=? AND revision_id=? AND kind=? ORDER BY id LIMIT 1")
                 .get(projectId, view.revision.id, gate.stage);
             if (typeof work?.id !== "string")
-                throw new Error("Slopify hit an internal error (a review checkpoint has no matching stage). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+                throw new Error(internalError("a review checkpoint has no matching stage"));
             return {
                 checkpointId: gate.checkpointId,
                 stage: gate.stage,
@@ -34,11 +35,11 @@ export function admitReviewedCheckpoints(deps, projectIds, reviewed, catalogue)
             createdAt: deps.clock.now().toISOString(),
         });
         if (!saved.ok)
-            throw new Error("Slopify hit an internal error (the review checkpoints could not be saved). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("the review checkpoints could not be saved"));
         return saved.value.map((row) => {
             const gate = gates.find((gate) => gate.checkpointId === row.checkpointId);
             if (!gate)
-                throw new Error("Slopify hit an internal error (a saved review checkpoint could not be matched). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+                throw new Error(internalError("a saved review checkpoint could not be matched"));
             return { ...row, reviewedFingerprint: gate.fingerprint };
         });
     });

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

@@ -1,16 +1,17 @@
 import { readFileSync } from "node:fs";
+import { errorText, internalError } from "../../kernel/errors.js";
 import { readDocumentAssets } from "../document/fonts.js";
 import { renderDocument } from "../document/render.js";
 import { resolvedDocumentTheme } from "../document/theme.js";
+import { readyOutput } from "../revisions/view.js";
 import { writeAsset } from "../storage/assets.js";
 import { outputPath } from "../storage/layout.js";
 import { executionPlan, executionView, savedCatalogue } from "./runtime-plan.js";
 import { preparedResult, publishResult } from "./runtime-publication.js";
+import { pieceAlreadyDone } from "./work-records.js";
 // Lays the saved article out as a PDF. Local and quick: no provider, no charge.
 export async function executeDocumentRecipe(deps, context, piece) {
-    if (deps.db
-        .prepare("SELECT state FROM revision_work_pieces WHERE id=? AND work_id=?")
-        .get(piece.id, context.work.workId)?.state === "done")
+    if (pieceAlreadyDone(deps.db, context.work.workId, piece.id))
         return "done";
     if (!context.maySubmit(piece.id))
         return "held";
@@ -36,7 +37,7 @@ export async function executeDocumentRecipe(deps, context, piece) {
             cover = new Uint8Array(readFileSync(outputPath(deps.paths, projectId, thumbnail.output.path)));
         }
         catch (error) {
-            throw new Error(`The document's cover is the project's thumbnail, and its file can't be read (${error instanceof Error ? error.message : String(error)}). Regenerate or upload the thumbnail again (More → make it again in its section on Thumbnail, or Edit project → Thumbnail), then use Try again on Document.`, { cause: error });
+            throw new Error(`The document's cover is the project's thumbnail, and its file can't be read (${errorText(error)}). Regenerate or upload the thumbnail again (More → make it again in its section on Thumbnail, or Edit project → Thumbnail), then use Try again on Document.`, { cause: error });
         }
     }
     const rendered = renderDocument({
@@ -60,7 +61,7 @@ export async function executeDocumentRecipe(deps, context, piece) {
     const asset = writeAsset(deps, projectId, "document.pdf", rendered.bytes);
     // publishResult discards the file itself when the publication doesn't commit.
     await publishResult(deps, context, piece, [preparedResult(deps, context, piece, "document_pdf", asset)], { pages: rendered.pages, words: rendered.words, cover: rendered.cover });
-    deps.count?.("stage.completed", { stage: "document" });
+    deps.count?.("stage.completed", { stage: "document" }, context.work.projectId);
     return "done";
 }
 function documentView(deps, context, piece) {
@@ -69,16 +70,12 @@ function documentView(deps, context, piece) {
         .prepare("SELECT recipe_context FROM revision_work WHERE id=?")
         .get(context.work.workId);
     if (view === undefined || row === undefined)
-        throw new Error("Slopify hit an internal error (the project version the document belongs to is missing). Use Try again on Document; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the project version the document belongs to is missing", "Use Try again on Document"));
     const recipe = executionPlan(deps, view, savedCatalogue(row.recipe_context)).recipes.find((one) => one.key === piece.key && one.fingerprint === piece.fingerprint);
     if (recipe === undefined || recipe.unresolved)
         throw new Error("The project changed after this document was queued, so it no longer matches the saved article. Use Choose what to remake (in the project's More menu) (or Try again on Document) to make it from the current version.");
     return view;
 }
 function ready(view, role, workKey) {
-    return view.outputs.find((row) => row.selected &&
-        row.available &&
-        row.state === "ready" &&
-        row.workKey === workKey &&
-        row.output.role === role);
+    return readyOutput(view, { workKey, role });
 }

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

@@ -1,4 +1,5 @@
-import { z } from "zod";
+import { errorText } from "../../kernel/errors.js";
+import { assetPathOrUndefined } from "../revisions/mutation-assets.js";
 import { outputPath } from "../storage/layout.js";
 import { usesAmbientBed } from "../video/ambient-bed.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
@@ -19,23 +20,17 @@ export async function exportBed(deps, context, view) {
         return { source: { kind: "noise", preset: bed.source }, ...settings };
     const fix = "Make the video again from Play with another file under Video and style → Ambient sound, or pick Rain, Fireplace or Wind there instead.";
     const assetId = view.revision.content.ambientBed;
-    const row = z
-        .object({ path: z.string() })
-        .safeParse(assetId === undefined
-        ? undefined
-        : deps.db
-            .prepare("SELECT path FROM project_assets WHERE project_id=? AND id=?")
-            .get(context.work.projectId, assetId));
-    if (!row.success)
+    const saved = assetId === undefined ? undefined : assetPathOrUndefined(deps, context.work.projectId, assetId);
+    if (saved === undefined)
         throw new Error(`The ambient sound's audio file is no longer in the project. ${fix}`);
-    const path = outputPath(deps.paths, context.work.projectId, row.data.path);
+    const path = outputPath(deps.paths, context.work.projectId, saved);
     let durationMs;
     try {
         durationMs = await probeDurationMs(deps.ffmpeg, path, context.signal, deps.log);
     }
     catch (error) {
         context.signal.throwIfAborted();
-        throw new Error(`The ambient sound's audio file couldn't be read as audio (${error instanceof Error ? error.message : String(error)}). ${fix}`);
+        throw new Error(`The ambient sound's audio file couldn't be read as audio (${errorText(error)}). ${fix}`);
     }
     if (durationMs <= 0)
         throw new Error(`The ambient sound's audio file holds no sound. ${fix}`);

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

@@ -1,16 +1,16 @@
-import { readFileSync } from "node:fs";
 import { extname } from "node:path";
 import { z } from "zod";
 import { usesFigureCards, usesYoutubeDescription } from "../admission/rules.js";
 import { captionFont, captionFontDeps } from "../fonts/coverage.js";
 import { resolveFont } from "../fonts/index.js";
+import { isReadyOutput, readyOutput } from "../revisions/view.js";
 import { outputPath } from "../storage/layout.js";
 import { headingChapters } from "../video/chapters.js";
 import { sentenceCutPoints } from "../video/cuts.js";
 import { usesChapterCards, usesNarrationCuts, videoEditOf, } from "../video/edit-settings.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
 import { passageSpans } from "../video/figure-spans.js";
-import { wordsSchema } from "./runtime-subtitles.js";
+import { readTimingWords } from "./runtime-subtitles.js";
 // The containers an uploaded clip may come in; anything else in the images is a still.
 const clipExtensions = new Set([".mp4", ".mov", ".m4v", ".webm", ".mkv"]);
 export function isClipPath(path) {
@@ -19,7 +19,7 @@ export function isClipPath(path) {
 export async function exportEdit(deps, context, view, images) {
     const config = view.revision.config;
     const order = view.revision.content.imageOrder;
-    const ready = (key) => view.outputs.find((row) => row.workKey === key && row.selected && row.available && row.state === "ready");
+    const ready = (key) => readyOutput(view, { workKey: key });
     // Clips: an animated image's clip first, then an uploaded clip in the image's own place.
     const clips = [];
     for (const [index, key] of order.entries()) {
@@ -109,15 +109,8 @@ async function titleFont(deps, config) {
         ...(config.titleStyle?.color === undefined ? {} : { color: config.titleStyle.color }),
     };
 }
-export function timingWords(deps, context, view) {
-    const timing = view.outputs.find((row) => row.selected &&
-        row.available &&
-        row.state === "ready" &&
-        row.workKey === "subtitles:timing" &&
-        row.output.role === "subtitle_words");
-    if (timing === undefined)
-        throw new Error("The narration's word timing, which the video's cuts and chapter cards follow, is missing. Use More → Render the video again in the Video section, then Try again.");
-    return wordsSchema.parse(JSON.parse(readFileSync(outputPath(deps.paths, context.work.projectId, timing.output.path), "utf8"))).words;
+function timingWords(deps, context, view) {
+    return readTimingWords(deps, context, view, "the video's cuts and chapter cards follow").words;
 }
 // The YouTube description's chapters when that step runs, the article's headings otherwise.
 function chaptersOf(view, config, words) {
@@ -150,9 +143,7 @@ async function clipSeconds(deps, context, path, place) {
 // found in the timing is left out rather than shown at the wrong moment.
 export function figureShots(deps, context, view, format = view.revision.config.format, words = timingWords(deps, context, view)) {
     const cards = view.outputs
-        .filter((row) => row.selected &&
-        row.available &&
-        row.state === "ready" &&
+        .filter((row) => isReadyOutput(row) &&
         row.output.role === "figure_card" &&
         row.workKey.startsWith("figure:card:") &&
         (row.output.meta.format ?? view.revision.config.format) === format)

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

@@ -1,9 +1,11 @@
 import { readFileSync } from "node:fs";
 import { z } from "zod";
+import { internalError } from "../../kernel/errors.js";
 import { narrationAliasesOf, usesNarrationPreparation, usesPronunciationGlossary, } from "../admission/rules.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
 import { usesLoudness } from "../loudness/model.js";
+import { donePiece, isReadyOutput, readyOutput } from "../revisions/view.js";
 import { outputPath } from "../storage/layout.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
 import { audioTimeline } from "../video/plan.js";
@@ -17,11 +19,11 @@ export function exportSnapshot(deps, context, piece) {
         .prepare("SELECT recipe_context FROM revision_work WHERE id=?")
         .get(context.work.workId);
     if (view === undefined || row === undefined)
-        throw new Error("Slopify hit an internal error (the project version being exported is missing). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the project version being exported is missing"));
     const plan = executionPlan(deps, view, savedCatalogue(row.recipe_context));
     const recipe = plan.recipes.find((one) => one.key === piece.key && one.fingerprint === piece.fingerprint);
     if (recipe === undefined || recipe.deferred || recipe.unresolved)
-        throw new Error("Slopify hit an internal error (the export no longer matches the project's saved inputs). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the export no longer matches the project's saved inputs"));
     return { view, plan };
 }
 export async function revisionAudio(deps, context, view, 
@@ -45,9 +47,7 @@ export async function narrationAudio(deps, view, options = {}) {
     const levelled = options.levelled === true && usesLoudness(config) && config.sources.audio === "generate";
     const input = async (role) => {
         const segment = role === "audio_body" ? "body" : role === "audio_intro" ? "intro" : "outro";
-        const row = view.outputs.find((one) => one.selected &&
-            one.available &&
-            one.state === "ready" &&
+        const row = view.outputs.find((one) => isReadyOutput(one) &&
             (levelled
                 ? one.output.role === "audio_levelled" && one.workKey === levelKey(segment)
                 : one.output.role === role));
@@ -95,7 +95,7 @@ export function revisionTranscript(deps, snapshot, kind) {
     const concat = plan.recipes.find((one) => one.key === (kind === "body" ? "audio:body:concat" : `audio:${kind}`));
     if (concat !== undefined) {
         const texts = concat.dependsOn.map((key) => {
-            const row = view.pieces.find((one) => one.key === key && one.selected && one.available && one.piece.state === "done");
+            const row = donePiece(view, key);
             const payload = row?.piece.payload === null || row?.piece.payload === undefined
                 ? undefined
                 : z.object({ text: z.string().optional() }).parse(JSON.parse(row.piece.payload));
@@ -114,7 +114,7 @@ export function revisionTranscript(deps, snapshot, kind) {
             return texts.join("\n");
     }
     if (kind === "body") {
-        const row = view.outputs.find((one) => one.selected && one.available && one.state === "ready" && one.output.role === "article_txt");
+        const row = readyOutput(view, { role: "article_txt" });
         if (row !== undefined)
             return readFileSync(outputPath(deps.paths, view.revision.projectId, row.output.path), "utf8");
         if (view.articleMarkdown !== null)

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

@@ -5,9 +5,9 @@ import { renderShort, shortFrame } from "../shorts/render.js";
 import { allocateAsset, discardPreparedAssets, sealAsset } from "../storage/assets.js";
 import { projectDir } from "../storage/layout.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
-import { slideshowImages } from "./runtime-export.js";
+import { exportMachine, slideshowImages, warningsOf, } from "./runtime-export.js";
 import { preparedResult, preparedText, publishResult } from "./runtime-publication.js";
-import { timingWords } from "./runtime-shorts.js";
+import { readTimingWords } from "./runtime-subtitles.js";
 // A short-mode project's video (`admission/short-mode.ts`): the whole narration timeline as
 // one clip through the Shorts renderer, so it looks like every short Slopify cuts from a long
 // video - the images moving as the project says, the title on top and big word-by-word
@@ -16,7 +16,7 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
     const { view } = snapshot;
     const config = view.revision.config;
     const images = slideshowImages(deps, context, view);
-    const words = timingWords(deps, context, view);
+    const words = readTimingWords(deps, context, view, "the shorts are cut and captioned from").words;
     const seconds = timeline.reduce((sum, segment) => sum + segment.seconds, 0);
     if (seconds <= 0)
         throw new Error("The short has no narration to play, so there is nothing to render. Let the Narration stage finish (Resume, or Try again on it), then retry this stage.");
@@ -28,8 +28,11 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
     const directory = projectDir(deps.paths, context.work.projectId);
     const relativePath = (path) => relative(directory, path).split(sep).join("/");
     try {
+        const machine = await exportMachine(deps, context.work.projectId);
         const master = await renderShort({
             bin: deps.ffmpeg,
+            machine: machine.machine,
+            notice: machine.notice,
             master: masterGoal(config, "video"),
             timeline,
             start: 0,
@@ -58,6 +61,7 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
         const asset = sealAsset(deps, pending);
         prepared.push(preparedResult(deps, context, piece, "video", asset, durationMs, {
             subtitlesMode: "off",
+            ...warningsOf(machine.notices),
             ...(master === undefined ? {} : { master }),
         }));
         prepared.push(preparedText(deps, context, piece, "render_params", "render.json", JSON.stringify({
@@ -76,7 +80,7 @@ export async function executeShortExport(deps, context, piece, snapshot, timelin
             output: pending.path,
         })));
         await publishResult(deps, context, piece, prepared, { totalSeconds: seconds }, asset);
-        deps.count?.("stage.completed", { stage: "video" });
+        deps.count?.("stage.completed", { stage: "video" }, context.work.projectId);
         return "done";
     }
     finally {