@gentbajko/slopify 2.0.2 → 2.0.3

package/dist/slices/narration/run.js

@@ -14,7 +14,7 @@ import { planLegacyNarration } from "./legacy-plan.js";
 import { observeNarration } from "./live.js";
 // An empty narration source fails the stage immediately with no retries. Thrown from the
 // slice rather than from a provider call, so the attempt wrapper never sees it.
-export const nothingToNarrate = "nothing to narrate";
+export const nothingToNarrate = "There is nothing to narrate because the article is empty. Add article text in Edit project → Article, then Retry stage.";
 // What a chunk piece carries between runs: the text that was sent, and the file it came
 // back as once the provider answered. That is the whole of the resume.
 const chunkPayload = z.object({ text: z.string(), file: z.string().optional() });
@@ -35,13 +35,13 @@ export async function runNarration(deps, context, providers) {
     deps.audioPreviews?.clear(projectId);
     const project = projectById(deps.db, projectId);
     if (project === undefined) {
-        throw new Error(`project ${projectId} has no row`);
+        throw new Error("This project no longer exists; it may have been deleted while it was running.");
     }
     const choice = project.config.audio;
     if (choice === undefined) {
         // Admission refuses a run whose audio is Generate without a provider and a voice, so
         // reaching here is a bug in admission rather than something the user did.
-        throw new Error("the run has no TTS provider or voice");
+        throw new Error("No voice is set for the narration. Choose a voice in Edit project → Providers, then Retry stage.");
     }
     // Read once, before anything is written: the segment steps below ask it what a previous
     // run already stored, and the body step is the only thing that adds to it.
@@ -168,7 +168,7 @@ async function speakSegments(deps, context, providers, choice, outputs) {
         if (text === "") {
             // The same rule, applied to a segment: there is nothing to say, and silently
             // dropping an intro the user picked would lose it without telling anyone.
-            throw new Error(`the ${segment.category} segment has ${nothingToNarrate}`);
+            throw new Error(`The ${segment.category} is empty, so there is nothing to narrate for it. Write the ${segment.category} or remove it in Edit project, then Retry stage.`);
         }
         const spoken = await providers.forPiece(piece.id).tts({
             provider: choice.provider,
@@ -200,7 +200,7 @@ function segmentPieces(deps, projectId) {
     if (article === undefined) {
         // Admission writes all six stage rows with the project, so a project without an article
         // stage is a bug rather than a run the user configured.
-        throw new Error(`project ${projectId} has no article stage`);
+        throw new Error("Slopify hit an internal error (the project has no article stage). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return piecesOf(deps.db, article.id, "segment");
 }
@@ -257,13 +257,13 @@ function store(deps, projectId, role, path, durationMs, choice) {
 }
 function chunkOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`chunk ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (a saved narration chunk is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return chunkPayload.parse(JSON.parse(piece.payload));
 }
 function segmentOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`segment ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (a saved intro or outro is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return segmentPayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/narration/steering.js

@@ -9,14 +9,14 @@ function atoms(source, from, to, spans) {
         const span = spans.get(at);
         if (span !== undefined) {
             if (span.end > to || span.end <= at)
-                throw new Error("Pronunciation span crosses a word.");
+                throw new Error("Slopify hit an internal error (a pronunciation fix spans more than one word). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
             result.push({ text: span.text, spokenText: source.slice(at, span.end) });
             at = span.end;
         }
         else {
             const point = source.codePointAt(at);
             if (point === undefined)
-                throw new Error("Narration offset is outside the source.");
+                throw new Error("Slopify hit an internal error (a narration position is outside the article text). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
             const text = String.fromCodePoint(point);
             result.push({ text, spokenText: text });
             at += text.length;
@@ -34,7 +34,7 @@ function checkedSpans(source, pronunciation) {
             span.end <= span.start ||
             span.end > source.length ||
             !/^[^\s\uD800-\uDFFF]+$/u.test(source.slice(span.start, span.end)))
-            throw new Error("Pronunciation spans must cover disjoint whole source characters in a word.");
+            throw new Error("Slopify hit an internal error (pronunciation fixes overlap or split a word). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         spans.set(span.start, span);
         end = span.end;
     }

package/dist/slices/play-drafts/convert.js

@@ -31,7 +31,7 @@ export function toAdmissionDraft(input) {
             return { name: saved.name, mode: saved.mode };
         fields.push({
             field: category,
-            message: `That ${category} entry no longer exists; pick another.`,
+            message: `That ${category} entry was deleted. Choose another.`,
         });
         return undefined;
     };
@@ -42,8 +42,8 @@ export function toAdmissionDraft(input) {
         fields.push({
             field,
             message: attachment?.state === "copying" || attachment?.state === "pending"
-                ? "This upload is still copying."
-                : "That upload is no longer available; pick the file again.",
+                ? "This file is still uploading. Wait for it to finish."
+                : "That upload is no longer available. Choose the file again.",
         });
         return undefined;
     };
@@ -117,7 +117,8 @@ export function toAdmissionDraft(input) {
     if (!parsed.success)
         fields.push(...parsed.error.issues.map((issue) => ({
             field: issue.path.join("."),
-            message: issue.message,
+            // The schema carries no sentences of its own; its defaults read like code.
+            message: "This setting is not valid. Reload the page and choose it again.",
         })));
     return fields.length || !parsed.success
         ? { ok: false, fields }

package/dist/slices/play-drafts/readiness.js

@@ -48,7 +48,7 @@ export async function checkDraftReadiness(deps, runs) {
                 field: c.field,
                 message: provider?.readiness.kind === "cli" && provider.readiness.issue
                     ? provider.readiness.issue
-                    : "Configure this provider before starting.",
+                    : "Set up this provider in Settings → Providers before starting.",
             });
             continue;
         }
@@ -56,12 +56,12 @@ export async function checkDraftReadiness(deps, runs) {
         if (result === "missing")
             fields.push({
                 field: `${c.field}.model`,
-                message: "Choose an available model before starting.",
+                message: "This model is no longer available. Choose another model.",
             });
         else if (result === "thinking")
             fields.push({
                 field: `${c.field}.thinking`,
-                message: "Choose a supported thinking setting.",
+                message: "This model does not support that thinking setting. Choose another.",
             });
     }
     return { fields: [...fields, ...localDraftReadiness(deps, runs, providers)], providers };
@@ -73,15 +73,21 @@ export function localDraftReadiness(deps, runs, providers) {
         if (cliPathChanged(deps.db, provider))
             fields.push({
                 field: `${c.field}.cliPath`,
-                message: "The configured CLI command changed. Check readiness again.",
+                message: "This provider's command-line tool changed in Settings → Providers. Choose Review and start again.",
             });
         if (provider?.readiness.kind === "keyed" && !hasKey(deps.db, provider.id))
-            fields.push({ field: c.field, message: "Save the provider key before starting." });
+            fields.push({
+                field: c.field,
+                message: "Add this provider's API key in Settings → Providers before starting.",
+            });
     }
     for (const { draft } of runs)
         if (draft.sources.audio === "generate" &&
             draft.audio &&
             !listVoices(deps.db).some((v) => v.provider === draft.audio?.provider && v.voiceId === draft.audio.voice))
-            fields.push({ field: "audio.voice", message: "Choose a saved voice before starting." });
+            fields.push({
+                field: "audio.voice",
+                message: "Choose one of your saved voices. Add voices in Settings → Voices.",
+            });
     return fields;
 }

package/dist/slices/play-drafts/review-inputs.js

@@ -47,7 +47,10 @@ export function resolveReviewInputs(deps, view, font) {
     if (!words.success)
         fields.push({ field: "expectedWords", message: "Enter a whole number between 1 and 100000." });
     if (document.variants.length > 49)
-        fields.push({ field: "variants", message: "Review at most 50 runs including the base run." });
+        fields.push({
+            field: "variants",
+            message: "You can review at most 50 videos at once, counting the first one. Remove some variations.",
+        });
     const converted = toAdmissionDraft({
         document,
         attachments: fresh.value.attachments,
@@ -96,7 +99,7 @@ export function resolveReviewInputs(deps, view, font) {
             field: index > 0 && (issue.field === "title" || issue.field.startsWith("values."))
                 ? `variants.${index - 1}.${issue.field}`
                 : issue.field,
-            message: `${index > 0 ? `Run ${index + 1}: ` : ""}${issue.message}`,
+            message: `${index > 0 ? `Video ${index + 1}: ` : ""}${issue.message}`,
         })));
         runs.push({
             draft: accepted,
@@ -118,7 +121,7 @@ export function resolveReviewInputs(deps, view, font) {
         if (!stat?.isFile() || font.id !== converted.draft.subtitles?.fontId)
             fields.push({
                 field: "subtitles.fontId",
-                message: "The selected font is no longer available. Choose another font.",
+                message: "This font was deleted. Choose another font.",
             });
         else
             fontHash = createHash("sha256").update(readFileSync(font.path)).digest("hex");
@@ -133,7 +136,7 @@ export function resolveReviewInputs(deps, view, font) {
                 : run.draft.sources[stage] !== "generate")
                 fields.push({
                     field: `checkpoints.${stage}`,
-                    message: "Choose a checkpoint only before an enabled generated stage or export.",
+                    message: "Checkpoints can only go before a step Slopify generates, or before export. Remove this checkpoint or turn that step on.",
                 });
     if (fields.length)
         return reviewRefusal(view, fields);

package/dist/slices/play-drafts/review.js

@@ -27,7 +27,7 @@ export async function resolvePlayReview(deps, view) {
             return reviewRefusal(view, [
                 {
                     field: "subtitles.fontId",
-                    message: "The selected font is no longer available. Choose another font.",
+                    message: "This font was deleted. Choose another font.",
                 },
             ]);
         }
@@ -41,12 +41,12 @@ export async function resolvePlayReview(deps, view) {
         if (result === "missing")
             fields.push({
                 field: `${choice.field}.model`,
-                message: "Choose an available model before reviewing.",
+                message: "This model is no longer available. Choose another model.",
             });
         else if (result === "thinking")
             fields.push({
                 field: `${choice.field}.thinking`,
-                message: "Choose a supported thinking setting.",
+                message: "This model does not support that thinking setting. Choose another.",
             });
     }
     if (fields.length)

package/dist/slices/play-drafts/service.js

@@ -68,7 +68,9 @@ function attachmentsOf(deps, id) {
             state,
             stagedFileId: invalid ? null : row.staged_file_id,
             bytes: invalid ? 0 : (staged?.bytes ?? 0),
-            error: invalid ? "Upload is missing or incomplete. Reattach the file." : row.error,
+            error: invalid
+                ? "This file is missing or did not finish uploading. Attach it again."
+                : row.error,
         };
     });
 }

package/dist/slices/play-drafts/uploads.js

@@ -43,7 +43,7 @@ export async function uploadDraftAttachment(deps, input) {
     if (!result.ok) {
         deps.db
             .prepare("UPDATE play_draft_attachments SET status='reattach',error=? WHERE id=? AND draft_id=? AND staged_file_id IS NULL")
-            .run("Upload failed. Reattach the file.", input.attachmentId, input.draftId);
+            .run("The upload failed. Attach the file again.", input.attachmentId, input.draftId);
         return refuse("invalid-edit");
     }
     const updated = deps.db

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

@@ -92,14 +92,14 @@ export function admitPreview(deps, input) {
                 continue;
             }
             if (existing?.state === "running")
-                throw new Error("Selected work has a mismatched running reservation.");
+                throw new Error("Slopify hit an internal error (a step is already running for a different version of the project). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             deps.db
                 .prepare("DELETE FROM revision_work_reservations WHERE revision_id=? AND work_key=?")
                 .run(view.revision.id, recipe.key);
             const key = reservationKey(recipe, view);
             const fingerprint = snapshot.anchors[key];
             if (fingerprint === undefined)
-                throw new Error("Selected work has no reviewed desired anchor.");
+                throw new Error("Slopify hit an internal error (a step has no saved starting point). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             const work = insertInvocation(deps, view, recipe, catalogue, { key, fingerprint }, false, view.revision.id, admissionId);
             workIds.push(work.workId);
         }

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

@@ -117,7 +117,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-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-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];

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=?")
@@ -176,7 +176,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-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-export-inputs.js

@@ -14,11 +14,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("The export revision no longer exists.");
+        throw new Error("Slopify hit an internal error (the project version being exported is missing). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     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("The export inputs do not match the admitted recipe.");
+        throw new Error("Slopify hit an internal error (the export no longer matches the project's saved inputs). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     return { view, plan };
 }
 export async function revisionAudio(deps, context, view) {
@@ -34,12 +34,12 @@ export async function revisionAudio(deps, context, view) {
             (await (deps.measureAudio?.(path, context.signal) ??
                 probeDurationMs(deps.ffmpeg, path, context.signal, deps.log)));
         if (!Number.isFinite(duration) || duration <= 0)
-            throw new Error("The narration duration could not be measured.");
+            throw new Error("Slopify couldn't read the length of the narration audio, so the file may be damaged or empty. Regenerate the narration (or upload your audio file again in Edit project → Narration), then Retry stage.");
         return { path, seconds: duration / 1000 };
     };
     const body = await input("audio_body");
     if (body === undefined)
-        throw new Error("The revision has no complete narration.");
+        throw new Error("The narration audio isn't finished yet. Let the Narration stage finish (Resume, or Retry stage on it), then retry this stage.");
     return audioTimeline({
         body,
         intro: config.sources.audio === "generate" && config.intro !== undefined
@@ -72,7 +72,7 @@ export function revisionTranscript(deps, snapshot, kind) {
                 Array.isArray(recipe.input.semantic) &&
                 typeof recipe.input.semantic[0] === "string")
                 return recipe.input.semantic[0];
-            throw new Error("The saved narration transcript is incomplete.");
+            throw new Error("Some narration chunks aren't finished, so the full narration text isn't available. Let the Narration stage finish (Resume, or Retry stage on it), or regenerate the missing chunk in Edit project → Narration.");
         });
         if (texts.length > 0)
             return texts.join("\n");
@@ -84,7 +84,7 @@ export function revisionTranscript(deps, snapshot, kind) {
         if (view.articleMarkdown !== null)
             return plainText(splitEndMatter(view.articleMarkdown).body);
     }
-    throw new Error(`The saved ${kind} narration transcript is missing.`);
+    throw new Error(`The saved text of the ${kind === "body" ? "article" : kind} is missing, so it can't be matched to the narration. Use Re-run section on Article, then Retry stage.`);
 }
 export function retainedOutput(deps, view, row) {
     const asset = z

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

@@ -20,9 +20,9 @@ export async function executeExportRecipe(deps, context, piece) {
     const audio = await revisionAudio(deps, context, view);
     const wav = piece.key === "export:wav";
     if (!wav && piece.key !== "export:video")
-        throw new Error("Unknown media export recipe.");
+        throw new Error("Slopify hit an internal error (unknown kind of export). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     if (wav && audio.length === 0)
-        throw new Error("Audio export needs complete narration.");
+        throw new Error("The audio export has nothing to export because narration is turned off for this project. Turn narration on in Edit project, then Retry stage.");
     const filename = wav ? "audio.wav" : "video.mp4";
     const pending = allocateAsset(deps, context.work.projectId, filename);
     const prepared = [];
@@ -48,7 +48,7 @@ export async function executeExportRecipe(deps, context, piece) {
         const images = (wav ? [] : view.revision.content.imageOrder).map((key) => {
             const row = view.outputs.find((one) => one.workKey === `image:${key}` && one.selected && one.available && one.state === "ready");
             if (row === undefined)
-                throw new Error("The revision is missing an image selected for its slideshow.");
+                throw new Error("The video export can't find one of the slideshow images. Use Re-run section on Images (or regenerate that image in Edit project → Images), then Retry stage.");
             return outputPath(deps.paths, context.work.projectId, row.output.path);
         });
         const plan = wav
@@ -124,7 +124,7 @@ function captionDirectory(deps, context, snapshot) {
     const ass = find("subtitle_ass");
     const font = find("subtitle_font");
     if (ass === undefined || font === undefined)
-        throw new Error("Burned subtitles need prepared captions and their saved font.");
+        throw new Error("Burned-in captions are missing their caption file or font. Use Re-run section on Video (or choose the caption font again in Edit project → Subtitles), then Retry stage.");
     const directory = mkdtempSync(join(projectDir(deps.paths, context.work.projectId), "render-"));
     try {
         mkdirSync(join(directory, "fonts"), { mode: 0o700 });

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

@@ -19,7 +19,7 @@ export async function executeLocalRecipe(deps, context, piece) {
     const input = piece.input;
     if (input.kind === "provided") {
         if (input.assetId === null)
-            throw new Error("The provided recipe has no retained asset.");
+            throw new Error("A file you uploaded for this project is missing. Upload it again in Edit project, then Retry stage.");
         const row = z
             .object({ id: z.string(), project_id: z.string(), path: z.string(), created_at: z.string() })
             .parse(deps.db
@@ -43,7 +43,7 @@ export async function executeLocalRecipe(deps, context, piece) {
         return "done";
     }
     if (input.kind !== "local")
-        throw new Error("Expected an exact local recipe.");
+        throw new Error("Slopify hit an internal error (a local step was set up wrongly). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     if (input.operation === "narration-files-v1") {
         await publishNarrationText(deps, context, piece);
         return "done";
@@ -75,19 +75,19 @@ export async function executeLocalRecipe(deps, context, piece) {
         });
         return "done";
     }
-    throw new Error(`No local executor for ${input.operation}.`);
+    throw new Error(`Slopify hit an internal error (no handler for the step "${input.operation}"). Retry stage; if it happens again, use Download diagnostics in Settings and report it.`);
 }
 async function concatenate(deps, context, piece) {
     const view = executionView(deps, context.work.projectId, context.work.revisionId);
     if (view === undefined)
-        throw new Error("The pinned revision is missing.");
+        throw new Error("Slopify hit an internal error (the project version being built is missing). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     const row = deps.db
         .prepare("SELECT recipe_context FROM revision_work WHERE id=?")
         .get(context.work.workId);
     const plan = executionPlan(deps, view, savedCatalogue(row?.recipe_context));
     const recipe = plan.recipes.find((candidate) => candidate.key === piece.key && candidate.fingerprint === piece.fingerprint);
     if (recipe === undefined)
-        throw new Error("The pinned concatenation no longer matches its inputs.");
+        throw new Error("Slopify hit an internal error (the narration chunks to join no longer match the project's saved inputs). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     const files = recipe.dependsOn.map((key) => {
         const input = view.pieces.find((candidate) => candidate.key === key &&
             candidate.selected &&
@@ -95,7 +95,7 @@ async function concatenate(deps, context, piece) {
             candidate.piece.state === "done" &&
             candidate.fingerprint === plan.recipes.find((value) => value.key === key)?.fingerprint);
         if (input?.assetId === null || input === undefined)
-            throw new Error("A narration part has no retained audio.");
+            throw new Error("One narration chunk has no saved audio, so the narration can't be joined together. Regenerate the missing chunk in Edit project → Narration, then Retry stage.");
         const asset = deps.db
             .prepare("SELECT path FROM project_assets WHERE id=? AND project_id=?")
             .get(input.assetId, context.work.projectId);