@gentbajko/slopify 3.25.9 → 4.1.0

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

@@ -255,7 +255,7 @@ config) {
             model: typeof llmModel === "string" ? llmModel : "",
             inputCharacters: (typeof style === "string" ? style.length : 0) + 3000,
             outputCharacters: 2400,
-            detail: "One LLM call per short writes its image prompts; its length is estimated.",
+            detail: "One AI call per short writes its image prompts; its length is estimated.",
         })),
         ...Array.from({ length: images }, () => ({
             kind: "image",
@@ -285,7 +285,9 @@ export function priceRecipe(work, value, config) {
         (input.operation === "image-scene" ||
             input.operation === "image-scenes" ||
             input.operation === "thumbnail-scenes" ||
-            input.operation === "image-appearance")) {
+            input.operation === "image-appearance" ||
+            input.operation === "keyword-digest" ||
+            input.operation === "social-post")) {
         const choice = config === undefined ? undefined : recipeProviderChoice(value, config);
         if (choice !== undefined && input.operation === "image-scene")
             return { kind: "image", stage: work.key, provider: choice.provider, model: choice.model };
@@ -296,7 +298,13 @@ export function priceRecipe(work, value, config) {
                 provider: choice.provider,
                 model: choice.model,
                 inputCharacters: 90000,
-                outputCharacters: input.operation === "image-appearance" ? 6000 : 4000,
+                outputCharacters: input.operation === "image-appearance"
+                    ? 6000
+                    : input.operation === "keyword-digest"
+                        ? 2000
+                        : input.operation === "social-post"
+                            ? 600
+                            : 4000,
                 detail: "The article is read when the step runs; its length is estimated. Retries are excluded.",
             };
     }
@@ -304,13 +312,13 @@ export function priceRecipe(work, value, config) {
         return {
             kind: "unknown",
             stage: work.key,
-            detail: "Narration Preparation: one LLM call per future logical chunk or entry; source length is not yet known.",
+            detail: "Narration preparation: one AI call per narration piece or intro or outro; how many is known once the text is written.",
         };
     if (input.kind === "deferred" && input.operation === "narration-description")
         return {
             kind: "unknown",
             stage: work.key,
-            detail: "Narration descriptions: one LLM call per table, figure, equation or code block in the article; how many is known once the article is written.",
+            detail: "Narration descriptions: one AI call per table, figure, equation or code block in the article; how many is known once the article is written.",
         };
     if (input.kind === "llm")
         return {
@@ -320,7 +328,11 @@ export function priceRecipe(work, value, config) {
             model: input.model,
             inputCharacters: input.messages.reduce((sum, message) => sum + message.content.length, 0) +
                 (input.documents ?? []).reduce((sum, document) => sum + document.content.length, 0),
-            outputCharacters: work.key === "article:body" ? 9000 : input.describe !== undefined ? 600 : 2400,
+            outputCharacters: work.key === "article:body"
+                ? 9000
+                : input.describe !== undefined || input.social !== undefined
+                    ? 600
+                    : 2400,
             detail: "Actual saved request input; output length is estimated. Retries and tools are excluded.",
         };
     if (input.kind === "tts")
@@ -409,7 +421,7 @@ function cliRequest(work, value, config) {
         detail: preparation
             ? value.input.operation === "narration-description"
                 ? "Runs on your CLI plan, so it adds no charge. Narration descriptions make one call per table, figure, equation or code block; how many is known once the article is written, so no API figure is given."
-                : "Runs on your CLI plan, so it adds no charge. Narration Preparation makes one call per logical chunk or entry; how many is known when the step runs, so no API figure is given."
+                : "Runs on your CLI plan, so it adds no charge. Narration preparation makes one call per narration piece or intro or outro; how many is known when the step runs, so no API figure is given."
             : "Runs on your CLI plan, so it adds no charge. The request is built when the step runs, so its API figure uses an estimated length.",
     };
 }

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

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

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

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

package/dist/slices/rebuild/recovery.js

@@ -1,4 +1,5 @@
 import { transact } from "../../kernel/db/tx.js";
+import { internalError } from "../../kernel/errors.js";
 import { stagesOf } from "../admission/repo.js";
 import { withProjectControl } from "../control/lock.js";
 import { requestHash } from "../revisions/mutation-request.js";
@@ -78,7 +79,7 @@ options = {}) {
                             field: "stage",
                             message: input.action.kind === "redo"
                                 ? "This item is no longer made by the project (it was removed, or its source changed), so it can't be made again. Reload the project page."
-                                : "This section has no generated work to rerun. Use Edit project to change its source.",
+                                : "This section has nothing made by AI to make again. Change its source in Edit settings.",
                         },
                     ],
                 };
@@ -93,7 +94,7 @@ options = {}) {
         if (record.edit !== null) {
             const prior = retainedPreviewPlan(deps, base, deps.catalogue.read());
             if (input.action.kind !== "rerun" && input.action.kind !== "redo")
-                throw new Error("Slopify hit an internal error (a recovery edit has nothing to re-run). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+                throw new Error(internalError("a recovery edit has nothing to re-run"));
             const affected = dependentClosure(prior.recipes, rootsOf(base, prior));
             const savedIntent = deps.db
                 .prepare("SELECT result_revision_id FROM revision_mutations WHERE project_id=? AND idempotency_key=?")
@@ -120,7 +121,7 @@ options = {}) {
                                 {
                                     field: "stage",
                                     message: late === "running"
-                                        ? "Wait for this section to finish, or Pause the project before rerunning it."
+                                        ? "Wait for this section to finish, or Pause the project before making it again."
                                         : acceptedJobMessage,
                                 },
                             ],
@@ -153,7 +154,7 @@ options = {}) {
                 fields: [
                     {
                         field: "stage",
-                        message: "This section has no enabled work. Use Edit project to change its source.",
+                        message: "This section is switched off. Change its source in Edit settings.",
                     },
                 ],
             });
@@ -166,7 +167,7 @@ options = {}) {
                 reason: "review-required",
                 fields: preview.value.preview.providedReuseRequired.map((key) => ({
                     field: key,
-                    message: "Review changed supplied content or manual captions in Edit project or Advanced rebuild review.",
+                    message: "Look over the changed content you supplied, or the captions you edited, in Edit settings or in Choose what to make again.",
                 })),
             });
         const blocked = preview.value.preview.work.filter((row) => row.disposition === "blocked");
@@ -186,11 +187,11 @@ options = {}) {
                     input.action.stage === "video"
                         ? {
                             field: "video",
-                            message: "Source media is incomplete. Use Continue the run to recover it before rerunning the export.",
+                            message: "Some of what the video is made from isn't finished. Use Continue the run to finish it before making the video again.",
                         }
                         : {
                             field: "document",
-                            message: "The article or thumbnail the document is made from isn't finished. Use Continue the run to finish it, then More → make it again in its section on Document.",
+                            message: "The article or thumbnail the document is made from isn't finished. Use Continue the run to finish it, then press Make the PDF again in the project's PDF section.",
                         },
                 ],
             });
@@ -200,7 +201,7 @@ options = {}) {
         storePreview(deps, preview.value.preview, preview.value.execution);
         const stored = previewById(deps.db, projectId, preview.value.preview.id);
         if (stored === undefined)
-            throw new Error("Slopify hit an internal error (the saved recovery preview is missing). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("the saved recovery preview is missing"));
         return {
             plan: { preview: stored, execution: preview.value.execution },
             view,

package/dist/slices/rebuild/remake-outdated.js

@@ -3,19 +3,19 @@ export function remadeWork(work) {
 }
 export function remakeBlocker(status, sample) {
     if (status === "running")
-        return "It is running now. Remake it once the run has finished.";
+        return "It is running now. Make its outdated parts again once the run has finished.";
     if (sample)
-        return "It is a sample project, which stays as it came with Slopify. Open it, press Make my own copy at the top of its page, then remake the copy.";
+        return "It is a sample project, which stays as it came with Slopify. Open it, press Make my own copy at the top of its page, then change the copy.";
     return undefined;
 }
 export function previewBlocker(preview, label) {
     if (remadeWork(preview.work).length === 0)
-        return "Nothing in it is outdated, so there is nothing to remake.";
+        return "Nothing in it is outdated, so there is nothing to make again.";
     const blocked = preview.work.find((work) => work.disposition === "blocked");
     if (blocked !== undefined)
-        return `${label(blocked.key)} can't run: ${blocked.reason.trim() || "no reason was given."} Open the project and press Choose what to remake to see what to fix.`;
+        return `${label(blocked.key)} can't run: ${blocked.reason.trim() || "no reason was given."} Open the project and press Choose what to make again to see what to fix.`;
     if (preview.providedReuseRequired.length > 0)
-        return "It uses content you supplied, which you confirm on the project itself: open it and press Choose what to remake.";
+        return "It uses content you supplied, which you confirm on the project itself: open it and press Choose what to make again.";
     return undefined;
 }
 export function remakeTotal(costs) {

package/dist/slices/rebuild/repo.js

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

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

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

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

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { errorText } from "../../kernel/errors.js";
 import { reviewKey } from "../reviews/model.js";
 import { pendingRedos, setRedoState } from "../reviews/repo.js";
 import { currentRevisionId } from "../revisions/repo.js";
@@ -49,7 +50,7 @@ export function createReviewRedos() {
                 .catch((error) => {
                 deps.log.write("error", "review.redo", {
                     projectId: verdict.projectId,
-                    detail: error instanceof Error ? error.message : String(error),
+                    detail: errorText(error),
                 });
                 setRedoState(deps.db, verdict.id, "failed", "Slopify hit an internal error while making this item again. Use Redo beside it; if it happens again, use Download diagnostics in Settings and report it.");
             })
@@ -127,7 +128,7 @@ export function redoRefusal(result) {
         case "running":
             return "Slopify couldn't make this item again automatically because work that depends on it was already running. Use Redo beside it once the run has finished.";
         case "readiness":
-            return `Slopify couldn't make this item again automatically: ${detail ?? "a provider isn't ready"}. Fix that in Settings → Providers, then use Redo beside it.`;
+            return `Slopify couldn't make this item again automatically: ${detail ?? "a provider isn't ready"}. Fix that in Settings → Keys & services, then use Redo beside it.`;
         case "conflict":
         case "control-changed":
             return "Slopify couldn't make this item again automatically because the project changed at the same moment (an edit, Pause or Cancel). Use Redo beside it.";

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

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

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

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

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

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

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

@@ -1,5 +1,7 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
+import { internalError } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { continuationLimit, continuationMessages } from "../article/continuation.js";
 import { currentRevisionId, revisionById } from "../revisions/repo.js";
 import { recipe } from "./recipe-model.js";
@@ -12,14 +14,14 @@ const answerSchema = z.object({
 });
 export async function executeArticleRequests(deps, context, providers, initial) {
     if (initial.input.kind !== "llm")
-        throw new Error("Slopify hit an internal error (the article step has no AI request). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("the article step has no AI request"));
     let piece = initial;
     let text = "";
     let inputTokens = 0;
     let outputTokens = 0;
     for (let part = 0; part <= continuationLimit; part += 1) {
         if (piece.input.kind !== "llm")
-            throw new Error("Slopify hit an internal error (an article continuation has no AI request). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("an article continuation has no AI request"));
         const saved = deps.db
             .prepare("SELECT result_json FROM revision_work_pieces WHERE id=? AND work_id=?")
             .get(piece.id, context.work.workId);
@@ -38,9 +40,9 @@ export async function executeArticleRequests(deps, context, providers, initial)
                 webSearch: input.webSearch,
                 previewLabel: part === 0 ? "Article" : `Continuation ${part}`,
                 check: (value) => value.text.trim() === ""
-                    ? "The AI model returned an empty article. Try again; if it keeps happening, choose a different model in Edit project → Providers."
+                    ? `The AI model returned an empty article. Try again; if it keeps happening, choose a different model in ${editSettings.writer}.`
                     : part === continuationLimit && value.finishReason === "length"
-                        ? `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 Try again.`
+                        ? `The article was still unfinished after ${continuationLimit} continuations because the AI model kept stopping at its length limit. Ask for a shorter article in the article prompt in ${editSettings.article}, or choose a model with a larger output limit under Written by there, then Try again.`
                         : undefined,
             }, (event) => {
                 if (event.type === "delta")
@@ -72,7 +74,7 @@ export async function executeArticleRequests(deps, context, providers, initial)
             return { ok: false, reason: "held" };
         piece = next;
     }
-    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 Try again.`);
+    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 the article prompt in ${editSettings.article}, or choose a model with a larger output limit under Written by there, then Try again.`);
 }
 function continuationPiece(deps, context, initial, part, text) {
     return transact(deps.db, () => {

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

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

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

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