@gentbajko/slopify 2.0.1 → 2.0.3

package/dist/slices/images/run.js

@@ -22,19 +22,19 @@ export async function runImages(deps, context, providers) {
     const { projectId } = context.stage;
     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.images;
     if (choice === undefined) {
         // Admission refuses a run whose images are Generate without a provider and a model, so
         // reaching here is a bug in admission rather than the user's.
-        throw new Error("the run has no image provider or model");
+        throw new Error("No image model is set for this project. Choose one in Edit project → Providers, then Retry stage.");
     }
     const pieces = plan(deps, context, project.config);
     if (pieces.length === 0) {
         // Admission makes an image source mandatory and puts the Number at one or more, so an
         // empty plan is a bug upstream rather than a run with no pictures.
-        throw new Error("the run ticked no image prompt");
+        throw new Error("Slopify hit an internal error (no image prompt was selected). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     // The run's own frame. The adapter turns it into whatever its provider spells the
     // closest supported size, and the render crops whatever is left over.
@@ -78,7 +78,7 @@ function plan(deps, context, config) {
         // it, so the run carries the substituted text under this key.
         const prompt = config.rendered[`imagePrompts.${String(at)}`];
         if (prompt === undefined) {
-            throw new Error(`the run has no rendered text for the image prompt ${picked.name}`);
+            throw new Error(`Slopify hit an internal error (the image prompt ${picked.name} was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.`);
         }
         for (let send = 1; send <= picked.number; send += 1) {
             planned.push({
@@ -224,7 +224,7 @@ function report(deps, context, done, total) {
 }
 function payloadOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`image ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (a saved image step is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return imagePayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/library/lint.js

@@ -13,17 +13,23 @@ function lint(name, body) {
     const fields = [];
     const trimmed = name.trim();
     if (trimmed === "") {
-        fields.push({ field: "name", message: "A name is required." });
+        fields.push({ field: "name", message: "Enter a name." });
     }
     else if (trimmed.length > nameMax) {
-        fields.push({ field: "name", message: `A name is at most ${String(nameMax)} characters.` });
+        fields.push({
+            field: "name",
+            message: `Keep the name to ${String(nameMax)} characters or fewer.`,
+        });
     }
     if (body.trim() === "") {
-        fields.push({ field: "body", message: "A body is required." });
+        fields.push({ field: "body", message: "Enter the text." });
         return fields;
     }
     if (body.length > bodyMax) {
-        fields.push({ field: "body", message: `A body is at most ${String(bodyMax)} characters.` });
+        fields.push({
+            field: "body",
+            message: `The text is too long. Keep it to ${String(bodyMax)} characters or fewer.`,
+        });
         return fields;
     }
     for (const error of detectSlots(body).errors) {
@@ -37,11 +43,11 @@ function describe(error, body) {
     const where = positionOf(body, error.at);
     switch (error.kind) {
         case "unclosed":
-            return `The \`{{\` at ${where} is never closed.`;
+            return `The \`{{\` at ${where} is never closed. Add \`}}\` after the keyword name.`;
         case "empty":
-            return `The slot at ${where} has no name.`;
+            return `The keyword at ${where} has no name. Write a name between \`{{\` and \`}}\`.`;
         case "nested":
-            return `The slot at ${where} holds a brace; slots do not nest.`;
+            return `The keyword at ${where} contains a brace. Keywords cannot be placed inside other keywords.`;
     }
 }
 function positionOf(body, at) {

package/dist/slices/library/slots.js

@@ -58,7 +58,7 @@ function body(db, kind, name, field, missing, into, key, snapshot) {
     }
     const prompt = snapshotPrompt(db, snapshot, kind, name);
     if (prompt === undefined) {
-        missing.push({ field, message: `That ${kind} prompt no longer exists; pick another.` });
+        missing.push({ field, message: `That ${kind} prompt was deleted. Choose another.` });
         return;
     }
     into.push({ key, body: prompt.body });
@@ -71,7 +71,7 @@ function pickEntry(db, category, choice, missing, snapshot) {
     if (entry === undefined) {
         missing.push({
             field: category,
-            message: `That ${category} entry no longer exists; pick another.`,
+            message: `That ${category} entry was deleted. Choose another.`,
         });
     }
     return entry;

package/dist/slices/narration/concat.js

@@ -46,7 +46,7 @@ export async function joinNarration(deps, input) {
     const first = input.files[0];
     if (first === undefined) {
         // The stage refuses an empty narration before it gets here, so this is a bug.
-        throw new Error("there are no audio chunks to join");
+        throw new Error("Slopify hit an internal error (there is no narration audio to join). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     mkdirSync(dirname(input.output), { recursive: true, mode: 0o700 });
     if (input.files.length === 1) {

package/dist/slices/narration/pronunciation-chunks.js

@@ -18,7 +18,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
     const chunks = chunkNarration(source, chunking).map((text) => {
         const start = source.indexOf(text, offset);
         if (start < 0)
-            throw new Error("Narration chunk is missing from its source.");
+            throw new Error("Slopify hit an internal error (a narration chunk isn't in the article text). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         offset = start + text.length;
         return { key: nextKey(text), text, start, end: offset };
     });
@@ -78,7 +78,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
         }
         const chunk = chunks[index];
         if (chunk === undefined)
-            throw new Error("Narration chunk disappeared.");
+            throw new Error("Slopify hit an internal error (a narration chunk went missing). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         while ((matches[matchIndex]?.end ?? Infinity) <= chunk.end)
             matchIndex++;
         const match = matches[matchIndex];
@@ -90,7 +90,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
             continue;
         const first = chunks[from];
         if (first === undefined)
-            throw new Error("Narration group has no first chunk.");
+            throw new Error("Slopify hit an internal error (a group of narration chunks is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         const text = source.slice(first.start, chunk.end);
         result.push(from === index
             ? { key: chunk.key, text }

package/dist/slices/narration/pronunciation.js

@@ -105,7 +105,7 @@ export function pronunciationMatches(source, entries) {
             continue;
         const entry = ordered.find((_, index) => match[index + 1] !== undefined);
         if (entry === undefined)
-            throw new Error("Matched glossary term has no mapping.");
+            throw new Error("Slopify hit an internal error (a pronunciation glossary term has no pronunciation). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         matches.push({ start: match.index, end, entry });
     }
     return matches;
@@ -117,7 +117,7 @@ export function pronunciationSpans(source, entries) {
         for (const [index, word] of Array.from(words).entries()) {
             const ipa = match.entry.ipa[index];
             if (ipa === undefined)
-                throw new Error("Validated glossary term has no IPA word.");
+                throw new Error("Slopify hit an internal error (a pronunciation glossary term is missing a word). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
             const start = match.start + word.index;
             spans.push({ start, end: start + word[0].length, text: `/${ipa}/` });
         }

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 };
         });
     });