@gentbajko/slopify 2.0.2 → 2.1.0

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

@@ -0,0 +1,36 @@
+import { sourceOf } from "../admission/model.js";
+import { documentThemeOf } from "../document/model.js";
+import { builtInTheme } from "../document/theme.js";
+import { recipe, resourceIdentity, } from "./recipe-model.js";
+// Bumped when the renderer's output changes for the same inputs, so documents made by an
+// older one read as outdated rather than current.
+const renderer = "document-v1";
+// The PDF is made from the saved article (whose end matter feeds the Sources page), the
+// research notes' links, the thumbnail as a cover and the resolved theme. It waits for
+// nothing else, so narration and images run beside it.
+export function documentRecipes(context, text, thumbnail) {
+    const { config } = context;
+    if (sourceOf(config.sources, "document") !== "generate")
+        return [];
+    const notes = text.recipes.find((value) => value.key === "research:notes");
+    const cover = thumbnail.find((value) => value.key === "thumbnail:image");
+    const theme = builtInTheme(documentThemeOf(config.document));
+    return [
+        recipe(context, "document:pdf", "document", {
+            kind: "local",
+            version: 1,
+            operation: "render-document",
+            values: [
+                renderer,
+                config.title,
+                JSON.parse(JSON.stringify(theme)),
+                resourceIdentity(context, text.article),
+                notes === undefined ? null : resourceIdentity(context, notes),
+                cover === undefined ? null : resourceIdentity(context, cover),
+            ],
+        }, [
+            text.article.key,
+            ...[notes, cover].flatMap((value) => (value === undefined ? [] : [value.key])),
+        ]),
+    ];
+}

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

@@ -1,3 +1,4 @@
+import { usesYoutubeDescription } from "../admission/rules.js";
 import { audioExportArgs } from "../video/audio-export-args.js";
 import { recipe, resourceIdentity, } from "./recipe-model.js";
 export function exportRecipes(context, audio) {
@@ -15,15 +16,26 @@ export function exportRecipes(context, audio) {
                 audioExportArgs([{ kind: "body", path: "$body", seconds: 0 }], "$output"),
             ],
         }, audio.keys));
-    if (config.subtitles === undefined || config.subtitles.mode === "off")
+    const captions = config.subtitles !== undefined && config.subtitles.mode !== "off";
+    // The YouTube description's chapters use the same word timing, so it runs for them even
+    // with captions off; only the caption files below wait for captions.
+    if (!captions && !usesYoutubeDescription(config))
         return recipes;
     const timing = recipe(context, "subtitles:timing", "video", {
         kind: "local",
         version: 1,
         operation: "wav2vec2-en-a19f851-v2-omissions",
-        values: [audio.timeline, config.silenceGapSeconds, config.subtitles.language],
+        // The lead-in moves every word, so the edge silence is part of the timing.
+        values: [
+            audio.timeline,
+            config.silenceGapSeconds,
+            config.subtitles?.language ?? "en",
+            config.edgeSilenceSeconds,
+        ],
     }, audio.keys);
     recipes.push(timing);
+    if (config.subtitles === undefined || config.subtitles.mode === "off")
+        return recipes;
     const cues = content.subtitleCues;
     const cueRecipe = cues === undefined
         ? recipe(context, "subtitles:cues", "video", {

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

@@ -17,6 +17,10 @@ export const config = {
     values: {},
     provided: { article: "First paragraph.\n\nSecond paragraph." },
     silenceGapSeconds: 0,
+    imageSeconds: 15,
+    zoomPercent: 22.5,
+    motionStyle: "zoom",
+    edgeSilenceSeconds: 0,
     rendered: { article: "Write an article." },
 };
 export const content = {

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

@@ -54,6 +54,11 @@ export function legacyOutputWorkKey(output, config) {
             return "export:wav";
         case "video":
             return "export:video";
+        case "document_pdf":
+            return "document:pdf";
+        case "youtube_description":
+        case "youtube_tags":
+            return "youtube:description";
         case "subtitles_srt":
         case "subtitles_vtt":
         case "subtitle_ass":
@@ -117,7 +122,7 @@ export function legacyImageOutput(piece, outputs) {
                     row.meta.promptName === undefined ||
                     row.meta.promptName === promptName)));
     if (matches.length > 1)
-        throw new Error(`Legacy image piece ${piece.id} matches multiple outputs.`);
+        throw new Error(`Slopify hit an internal error (an image from an older Slopify version, ${piece.id}, matches multiple outputs). Try again; if it happens again, use Download diagnostics in Settings and report it.`);
     return matches[0];
 }
 const legacyImageMetadata = z

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

@@ -15,6 +15,8 @@ export const localOperations = [
     "entry-text",
     "concat-narration",
     "narration-files-v1",
+    "render-document",
+    "youtube-description-v1",
 ];
 export const deferredOperations = [
     "narration-preparation",

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

@@ -26,7 +26,7 @@ export function narrationFileRecipe(context, segment, parts) {
                     ];
                 if (part.input.kind === "provided")
                     return [resourceIdentity(context, part), part.input.semantic, null];
-                throw new Error("Narration files require exact audio parts.");
+                throw new Error("Slopify hit an internal error (a narration chunk has an unexpected source). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             }),
         },
     }, dependencies, { unresolved: parts.length === 0 });

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

@@ -2,6 +2,9 @@ export function recipeProviderChoice(recipe, config) {
     const input = recipe.input;
     if (input.kind === "llm" || input.kind === "tts" || input.kind === "image")
         return { ...input, family: input.kind };
+    // The YouTube description's request is built when it runs, from the project's LLM row.
+    if (input.kind === "local" && input.operation === "youtube-description-v1")
+        return config.llm === undefined ? undefined : { ...config.llm, family: "llm" };
     if (input.kind !== "deferred")
         return undefined;
     const family = input.operation === "narration-preparation"

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

@@ -1,5 +1,6 @@
 import { stageKinds } from "../../kernel/pipeline.js";
-import { allowedSources, normaliseDraft, silenceGapSecondsMax, } from "../admission/rules.js";
+import { sourceOf } from "../admission/model.js";
+import { allowedSources, edgeSilenceSecondsProblem, imageSecondsProblem, normaliseDraft, silenceGapSecondsMax, zoomPercentProblem, } from "../admission/rules.js";
 import { render } from "../admission/substitute.js";
 import { buildRecipes } from "./recipe-build.js";
 import { selectedReference } from "./recipe-model.js";
@@ -153,10 +154,10 @@ function normalizeImages(content) {
 export function validateRevisionEdit(config, content) {
     const fields = [];
     for (const kind of stageKinds)
-        if (!allowedSources[kind].includes(config.sources[kind]))
+        if (!allowedSources[kind].includes(sourceOf(config.sources, kind)))
             fields.push({
                 field: `sources.${kind}`,
-                message: `The ${kind} stage cannot be set to ${config.sources[kind]}.`,
+                message: `The ${kind} stage cannot be set to ${sourceOf(config.sources, kind)}.`,
             });
     if (config.sources.images === "provide" &&
         content.imageOrder.some((key) => content.imageDefinitions[key]?.source === "generate"))
@@ -187,6 +188,17 @@ export function validateRevisionEdit(config, content) {
             field: "silenceGapSeconds",
             message: `Use a gap between 0 and ${silenceGapSecondsMax} seconds.`,
         });
+    const imageProblem = config.sources.video === "off" ? undefined : imageSecondsProblem(config.imageSeconds);
+    if (imageProblem !== undefined)
+        fields.push({ field: "imageSeconds", message: imageProblem });
+    const zoomProblem = config.sources.video === "off" ? undefined : zoomPercentProblem(config.zoomPercent);
+    if (zoomProblem !== undefined)
+        fields.push({ field: "zoomPercent", message: zoomProblem });
+    const edgeProblem = config.sources.audio === "off"
+        ? undefined
+        : edgeSilenceSecondsProblem(config.edgeSilenceSeconds);
+    if (edgeProblem !== undefined)
+        fields.push({ field: "edgeSilenceSeconds", message: edgeProblem });
     if (config.sources.article === "generate" &&
         content.articleEdited === true &&
         !content.articleMarkdown?.trim())

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

@@ -1,11 +1,15 @@
-import { narrationPreparationFields, usesNarrationPreparation, } from "../admission/rules.js";
+import { narrationPreparationFields, usesNarrationPreparation, usesYoutubeDescription, youtubeDescriptionFields, } from "../admission/rules.js";
 import { detectSlots, render } from "../admission/substitute.js";
 export function validateRecipeInputs(config, content) {
-    const fields = [...narrationPreparationFields(config)];
+    const fields = [
+        ...narrationPreparationFields(config),
+        ...youtubeDescriptionFields(config),
+    ];
     const llm = (config.sources.research === "generate" && config.sources.article !== "provide") ||
         (config.sources.article === "generate" && !content.articleEdited) ||
         config.sources.thumbnail === "prompt_by_llm" ||
         usesNarrationPreparation(config) ||
+        usesYoutubeDescription(config) ||
         (config.sources.audio === "generate" &&
             (config.intro?.mode === "llm" || config.outro?.mode === "llm"));
     if (llm && (!config.llm?.provider.trim() || !config.llm.model.trim()))
@@ -43,6 +47,15 @@ export function validateRecipeInputs(config, content) {
             raw: content.promptTemplates.narration ?? null,
             literal: config.rendered.narration,
         });
+    // Only a picked Description prompt is checked: none picked uses the built-in one.
+    if (usesYoutubeDescription(config) &&
+        config.descriptionPrompt?.trim() &&
+        content.promptTemplates.description != null)
+        prompts.push({
+            field: "rendered.description",
+            raw: content.promptTemplates.description,
+            literal: config.rendered.description,
+        });
     if ((config.sources.article === "generate" && !content.articleEdited) ||
         (config.sources.research === "generate" && config.sources.article !== "provide"))
         prompts.push({

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

@@ -7,7 +7,7 @@ export function visualRecipes(config, content, audioFingerprint, captionFingerpr
     for (const key of imageKeys) {
         const image = content.imageDefinitions[key];
         if (image === undefined)
-            throw new Error("Saved image definition is missing");
+            throw new Error("Slopify hit an internal error (one of the project's images has no saved settings). Try again; if it happens again, use Download diagnostics in Settings and report it.");
         const raw = image.templateKey === undefined || image.templateKey === null
             ? undefined
             : content.promptTemplates[image.templateKey];
@@ -45,7 +45,16 @@ export function visualRecipes(config, content, audioFingerprint, captionFingerpr
                 recipes.map((value) => value.fingerprint),
                 audioFingerprint,
                 config.subtitles?.mode === "burn-in" ? captionFingerprint : null,
-                "slideshow-zoom-v1",
+                // Only here: how long a still is held and how it moves change the render,
+                // never an image.
+                config.imageSeconds,
+                config.zoomPercent,
+                // Left out for "zoom", which is what every video did before the setting
+                // existed, so a project that keeps it keeps its render; the other styles
+                // each render differently.
+                ...(config.motionStyle === "zoom" ? [] : [config.motionStyle]),
+                // v1 split the timeline evenly across the images; v2 cycles them.
+                "slideshow-zoom-v2",
             ],
         }, [
             ...recipes.map((value) => value.key),

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

@@ -177,6 +177,9 @@ function retainedFor(row, logical, manifest, available) {
         pieceIds: [],
     }));
 }
+// ceiling: the timed transcript of a 20-minute narration, about 3,000 words. The real one
+// is only built once the word timing lands.
+const youtubeTranscriptEstimate = 20000;
 export function priceRecipe(work, value) {
     if (value === undefined || work.disposition !== "generate")
         return {
@@ -214,6 +217,18 @@ export function priceRecipe(work, value) {
         };
     if (input.kind === "image")
         return { kind: "image", stage: work.key, provider: input.provider, model: input.model };
+    if (input.kind === "local" && input.operation === "youtube-description-v1") {
+        const [, provider, model, , prompt] = Array.isArray(input.values) ? input.values : [];
+        return {
+            kind: "llm",
+            stage: work.key,
+            provider: typeof provider === "string" ? provider : "",
+            model: typeof model === "string" ? model : "",
+            inputCharacters: (typeof prompt === "string" ? prompt.length : 0) + youtubeTranscriptEstimate,
+            outputCharacters: 2400,
+            detail: "The timed transcript is built when the step runs; its length is estimated. Retries are excluded.",
+        };
+    }
     return {
         kind: "tts-estimate",
         stage: work.key,

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

@@ -0,0 +1,33 @@
+import { usesYoutubeDescription } from "../admission/rules.js";
+import { recipe, resourceIdentity, } from "./recipe-model.js";
+import { renderedPrompt } 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
+// the timing lands, so the request is built when the step runs (`runtime-youtube.ts`); what
+// identifies it here is the timing it reads, the prompt, the model and the title.
+export function youtubeRecipes(context, exports) {
+    const { config } = context;
+    const timing = exports.find((value) => value.key === "subtitles:timing");
+    if (!usesYoutubeDescription(config) || timing === undefined)
+        return [];
+    return [
+        recipe(context, "youtube:description", "video", {
+            kind: "local",
+            version: 1,
+            operation: "youtube-description-v1",
+            values: [
+                resourceIdentity(context, timing),
+                config.llm?.provider ?? "",
+                config.llm?.model ?? "",
+                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") : "",
+                config.title,
+            ],
+        }, [timing.key], 
+        // A paid LLM call: readiness, the charge warning and the estimate treat it like one.
+        { kind: "provider" }),
+    ];
+}

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

@@ -16,6 +16,8 @@ export function sectionRoots(view, plan, stage) {
                     ["body-narration", "intro-narration", "outro-narration"].includes(row.input.operation)));
         if (stage === "article")
             return row.key === "article:body" && row.kind === "provider";
+        if (stage === "document")
+            return row.key === "document:pdf";
         return row.kind === "provider";
     })
         .map((row) => row.key);

package/dist/slices/rebuild/recovery.js

@@ -78,7 +78,7 @@ export async function recoverProject(deps, projectId, raw) {
             const prior = retainedPreviewPlan(deps, base, deps.catalogue.read());
             const action = input.action;
             if (action.kind !== "rerun")
-                throw new Error("Recovery edit has no rerun action");
+                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.");
             const affected = dependentClosure(prior.recipes, sectionRoots(base, prior, action.stage));
             const savedIntent = deps.db
                 .prepare("SELECT result_revision_id FROM revision_mutations WHERE project_id=? AND idempotency_key=?")
@@ -158,16 +158,21 @@ export async function recoverProject(deps, projectId, raw) {
                 fields: blocked.map((row) => ({ field: row.key, message: row.reason })),
             });
         if (input.action.kind === "rerun" &&
-            input.action.stage === "video" &&
+            (input.action.stage === "video" || input.action.stage === "document") &&
             preview.value.preview.work.some((row) => row.kind === "provider" && row.disposition !== "reuse"))
             return finish({
                 ok: false,
                 reason: "readiness",
                 fields: [
-                    {
-                        field: "video",
-                        message: "Source media is incomplete. Use Resume to recover it before rerunning the export.",
-                    },
+                    input.action.stage === "video"
+                        ? {
+                            field: "video",
+                            message: "Source media is incomplete. Use Resume to recover it before rerunning the export.",
+                        }
+                        : {
+                            field: "document",
+                            message: "The article or thumbnail the document is made from isn't finished. Use Resume to finish it, then Re-run section on Document.",
+                        },
                 ],
             });
         const conflict = rerunKeys.length > 0 ? activeConflict(deps, projectId, rerunKeys) : undefined;
@@ -176,7 +181,7 @@ export async function recoverProject(deps, projectId, raw) {
         storePreview(deps, preview.value.preview, preview.value.execution);
         const stored = previewById(deps.db, projectId, preview.value.preview.id);
         if (stored === undefined)
-            throw new Error("Stored recovery preview is missing.");
+            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.");
         return {
             plan: { preview: stored, execution: preview.value.execution },
             view,

package/dist/slices/rebuild/repo.js

@@ -7,7 +7,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("Publication identity does not match its durable work.");
+        throw new Error("Slopify hit an internal error (a finished result is filed under the wrong step). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     if (!workExists(db, work))
         return [];
     if (pieceId !== null) {
@@ -15,9 +15,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("Publication piece does not belong to its work.");
+            throw new Error("Slopify hit an internal error (a finished result belongs to a different step). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         if (piece.work_key !== workKey || piece.fingerprint !== workFingerprint)
-            throw new Error("Publication authority does not match its durable piece.");
+            throw new Error("Slopify hit an internal error (a finished result doesn't match its saved step). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     const currentId = currentRevisionId(db, work.projectId);
     const owns = (revisionId) => {

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

@@ -72,5 +72,7 @@ function keyStage(key) {
         return "thumbnail";
     if (prefix === "research")
         return "research";
+    if (prefix === "document")
+        return "document";
     return "video";
 }

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

@@ -18,11 +18,11 @@ export function reservationKey(recipe, view) {
 export function admitInitialRevision(deps, view, catalogue) {
     transact(deps.db, () => {
         if (currentRevisionId(deps.db, view.revision.projectId) !== view.revision.id)
-            throw new Error("Initial admission requires the selected revision.");
+            throw new Error("The project was changed while this run was starting. Try again.");
         if (deps.db
             .prepare("SELECT 1 FROM revision_work WHERE project_id=? LIMIT 1")
             .get(view.revision.projectId) !== undefined)
-            throw new Error("An existing project requires explicit rebuild admission.");
+            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.");
         const snapshot = executionCatalogue(catalogue, view.revision.config);
         const plan = executionPlan(deps, view, snapshot);
         for (const recipe of plan.recipes) {
@@ -32,7 +32,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(`Initial work ${recipe.key} has no desired anchor.`);
+                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.`);
             const reuse = plan.work.find((row) => row.key === recipe.key)?.disposition === "reuse";
             if (reuse)
                 bindNarrationReuse(deps, view, recipe, narrationOrdinal(plan.recipes, recipe.key));
@@ -46,7 +46,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("Revision work has no owned stage.");
+        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.");
     const work = {
         projectId,
         revisionId,

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

@@ -12,14 +12,14 @@ const answerSchema = z.object({
 });
 export async function executeArticleRequests(deps, context, providers, initial) {
     if (initial.input.kind !== "llm")
-        throw new Error("Article generation needs a pinned LLM request.");
+        throw new Error("Slopify hit an internal error (the article step has no AI request). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     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("An article continuation must contain an exact LLM request.");
+            throw new Error("Slopify hit an internal error (an article continuation has no AI request). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         const saved = deps.db
             .prepare("SELECT result_json FROM revision_work_pieces WHERE id=? AND work_id=?")
             .get(piece.id, context.work.workId);
@@ -38,9 +38,9 @@ export async function executeArticleRequests(deps, context, providers, initial)
                 webSearch: input.webSearch,
                 previewLabel: part === 0 ? "Article" : `Continuation ${part}`,
                 check: (value) => value.text.trim() === ""
-                    ? "The article answered with nothing."
+                    ? "The AI model returned an empty article. Retry stage; if it keeps happening, choose a different model in Edit project → Providers."
                     : part === continuationLimit && value.finishReason === "length"
-                        ? `The article was still unfinished after ${continuationLimit} continuations.`
+                        ? `The article was still unfinished after ${continuationLimit} continuations because the AI model kept stopping at its length limit. Ask for a shorter article in Edit project → Prompts, or choose a model with a larger output limit in Edit project → Providers, then Retry stage.`
                         : undefined,
             }, (event) => {
                 if (event.type === "delta")
@@ -72,7 +72,7 @@ export async function executeArticleRequests(deps, context, providers, initial)
             return { ok: false, reason: "held" };
         piece = next;
     }
-    throw new Error("The article exceeded its continuation limit.");
+    throw new Error(`The article was still unfinished after ${continuationLimit} continuations because the AI model kept stopping at its length limit. Ask for a shorter article in Edit project → Prompts, or choose a model with a larger output limit in Edit project → Providers, then Retry stage.`);
 }
 function continuationPiece(deps, context, initial, part, text) {
     return transact(deps.db, () => {

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

@@ -11,14 +11,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("Checkpoint admission has no retained revision");
+            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.");
         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("Checkpoint admission has no stage work");
+                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.");
             return {
                 checkpointId: gate.checkpointId,
                 stage: gate.stage,
@@ -34,11 +34,11 @@ export function admitReviewedCheckpoints(deps, projectIds, reviewed, catalogue)
             createdAt: deps.clock.now().toISOString(),
         });
         if (!saved.ok)
-            throw new Error("Checkpoint admission could not persist reviewed gates");
+            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.");
         return saved.value.map((row) => {
             const gate = gates.find((gate) => gate.checkpointId === row.checkpointId);
             if (!gate)
-                throw new Error("Checkpoint admission lost its reviewed identity");
+                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.");
             return { ...row, reviewedFingerprint: gate.fingerprint };
         });
     });

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

@@ -0,0 +1,85 @@
+import { readFileSync } from "node:fs";
+import { readDocumentAssets } from "../document/fonts.js";
+import { documentThemeOf } from "../document/model.js";
+import { renderDocument } from "../document/render.js";
+import { builtInTheme } from "../document/theme.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";
+// 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")
+        return "done";
+    if (!context.maySubmit(piece.id))
+        return "held";
+    context.signal.throwIfAborted();
+    const view = documentView(deps, context, piece);
+    const { projectId } = context.work;
+    const text = (role, workKey) => {
+        const row = ready(view, role, workKey);
+        return row === undefined
+            ? null
+            : readFileSync(outputPath(deps.paths, projectId, row.output.path), "utf8");
+    };
+    const config = view.revision.config;
+    const article = view.revision.content.articleEdited === true || config.sources.article === "provide"
+        ? view.articleMarkdown
+        : text("article_md", "article:body");
+    if (article === null)
+        throw new Error("The article isn't finished yet, so there's nothing to make the document from. Let the Article stage finish (Resume, or Retry stage on Article), then use Retry stage on Document.");
+    const thumbnail = ready(view, "thumbnail", "thumbnail:image");
+    let cover = null;
+    if (config.sources.thumbnail !== "off" && thumbnail !== undefined) {
+        try {
+            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 (Re-run section on Thumbnail, or Edit project → Thumbnail), then use Retry stage on Document.`, { cause: error });
+        }
+    }
+    const rendered = renderDocument({
+        title: config.title,
+        articleMarkdown: article,
+        researchNotes: config.sources.research === "off" ? null : text("notes", "research:notes"),
+        cover,
+        theme: builtInTheme(documentThemeOf(config.document)),
+        writtenOn: deps.clock.now(),
+        assets: readDocumentAssets(),
+    });
+    if (rendered.cover === "unsupported")
+        deps.log.write("warn", "document.cover", {
+            projectId,
+            stage: "document",
+            detail: "The thumbnail is not a PNG, JPEG or WebP image, so the document has no cover.",
+        });
+    context.signal.throwIfAborted();
+    if (!context.maySubmit(piece.id))
+        return "held";
+    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" });
+    return "done";
+}
+function documentView(deps, context, piece) {
+    const view = executionView(deps, context.work.projectId, context.work.revisionId);
+    const row = deps.db
+        .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 Retry stage on Document; if it happens again, use Download diagnostics in Settings and report it.");
+    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 Rebuild affected outputs (or Retry stage 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);
+}