@gentbajko/slopify 4.0.0 → 4.1.0

package/dist/slices/reviews/model.js

@@ -13,12 +13,13 @@ export const reviewStages = [
     "shorts",
     "promise",
 ];
-// The stages in the order a run reaches them, as the Reviews rows list them.
+// The stages in the order a run reaches them, as the Reviews rows list them: the narration is
+// made before the images (`kernel/pipeline.ts`), as the pause ticks say.
 export const reviewStagesInRunOrder = [
     "article",
     "promise",
-    "images",
     "narration",
+    "images",
     "thumbnail",
     "shorts",
 ];
@@ -30,9 +31,11 @@ export const reviewers = ["model", "agent"];
 // Who gave a verdict: the reviewer model, an external agent, the person (through the verdict
 // route), or nobody when the review passed at its deadline.
 export const reviewAnswerers = ["model", "agent", "person", "nobody"];
+// Said to a person who never heard of MCP: a model Slopify pays per check, or an AI agent they
+// connected themselves (Settings → AI agents), which answers for free.
 export const reviewerLabels = {
-    model: "Model",
-    agent: "External agent (MCP)",
+    model: "An AI model",
+    agent: "Your own AI agent",
 };
 // ceiling: the owner's numbers. Two redos is what a person would try before looking at it
 // themselves; five is already six paid images for one slot.
@@ -123,7 +126,7 @@ export function reviewSettingsFromForm(form, makes) {
         ...(valid
             ? {}
             : {
-                retriesProblem: `Enter a number of redos between ${String(reviewRetriesMin)} and ${String(reviewRetriesMax)} in the Reviews section.`,
+                retriesProblem: `Enter a number of redos between ${String(reviewRetriesMin)} and ${String(reviewRetriesMax)} under Pauses and checks → Checker and stages.`,
             }),
     };
 }

package/dist/slices/reviews/rules.js

@@ -44,14 +44,14 @@ export function reviewFields(draft) {
     if (!byAgent && (reviews.provider.trim() === "" || reviews.model.trim() === ""))
         fields.push({
             field: "reviews.provider",
-            message: "Automatic reviews need a reviewer model. Choose one in the Reviews section, or set every review to Off.",
+            message: "AI checks need a model to check with. Choose one under Pauses and checks → Checker and stages → Checked by, or set every check to Off.",
         });
     const retries = reviews.retries;
     if (retries !== undefined &&
         (!Number.isInteger(retries) || retries < reviewRetriesMin || retries > reviewRetriesMax))
         fields.push({
             field: "reviews.retries",
-            message: `Enter a number of redos between ${reviewRetriesMin} and ${reviewRetriesMax} in the Reviews section.`,
+            message: `Enter a number of redos between ${reviewRetriesMin} and ${reviewRetriesMax} under Pauses and checks → Checker and stages.`,
         });
     const pictures = active.filter((stage) => visionStages.includes(stage));
     if (!byAgent &&
@@ -60,7 +60,7 @@ export function reviewFields(draft) {
         !reviewerSeesImages(reviews.provider))
         fields.push({
             field: "reviews.provider",
-            message: `The ${pictures.map((stage) => reviewStageLabels[stage]).join(", ")} ${pictures.length === 1 ? "review looks" : "reviews look"} at pictures, and Slopify can't show pictures to this reviewer. In the Reviews section, choose Claude Code or Codex as the reviewer, or set ${pictures.length === 1 ? "that review" : "those reviews"} to Off.`,
+            message: `The ${pictures.map((stage) => reviewStageLabels[stage]).join(", ")} ${pictures.length === 1 ? "check looks" : "checks look"} at images, and Slopify can't show images to this checker. Under Pauses and checks → Checker and stages → Checked by, choose Claude Code or Codex, or set ${pictures.length === 1 ? "that check" : "those checks"} to Off.`,
         });
     return fields;
 }

package/dist/slices/reviews/verdict.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 // The whole answer the reviewer may give: one JSON object, nothing else. A failed item names
 // at least one reason, since a reason is what the person reads beside it.
 export const reviewReasonMax = 500;
@@ -46,7 +47,7 @@ export function reviewMessages(material) {
         },
     ];
 }
-const retryHint = "Slopify asks again while attempts remain; if it keeps happening, choose another reviewer model in Edit project → Reviews, then use Try again.";
+const retryHint = `Slopify asks again while attempts remain; if it keeps happening, choose another reviewer model in ${editSettings.checks}, then use Try again.`;
 // Strict: one JSON object in the shape above, optionally inside a single ```json fence (the
 // one wrapping models add unasked). Anything else is refused with what was wrong with it.
 export function parseVerdict(text) {

package/dist/slices/revisions/image-plan.js

@@ -86,7 +86,7 @@ export function replanImagePrompts(input) {
         if (body === undefined) {
             fields.push({
                 field: `imagePrompts.${String(index)}.name`,
-                message: `The image prompt "${prompt.name}" is not in the Library any more. Untick it under Images, or add it back on Library → Prompts.`,
+                message: `The image prompt "${prompt.name}" is not in Prompts any more. Untick it under Images, or add it back in Prompts → Image.`,
             });
             continue;
         }

package/dist/slices/revisions/mutation-assets.js

@@ -1,5 +1,6 @@
 import { statSync } from "node:fs";
 import { z } from "zod";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { referenceKey, thumbnailCountOf } from "../admission/model.js";
 import { usesReference } from "../admission/rules.js";
 import { outputPath, stagingPath } from "../storage/layout.js";
@@ -59,7 +60,7 @@ export function validateUploads(deps, edit) {
         if (to.kind === "shortsMusic" && edit.config.shorts?.enabled !== true)
             fields.push({
                 field,
-                message: "Background music is only used by the shorts. Turn Shorts on in Edit project → Shorts, then add the music.",
+                message: `Background music is only used by the shorts. Turn Shorts on in ${editSettings.shorts}, then add the music.`,
             });
         const destination = JSON.stringify(to);
         if (staged.has(upload.stagedFileId) || destinations.has(destination))

package/dist/slices/revisions/mutations.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { rebrandedEdit } from "../channels/rebrand.js";
 import { projectChannelId, resolveChannelId, setProjectChannel } from "../channels/repo.js";
 import { carryCheckpointGates } from "../checkpoints/recovery.js";
@@ -204,14 +205,14 @@ function settingProblems(edit) {
             ? []
             : ambientBedProblems(bed).map((problem) => ({
                 field: `ambientBed.${problem.field}`,
-                message: `${problem.message} Change it in Edit project → Inputs → Ambient sound.`,
+                message: `${problem.message} Change it under Ambient sound in ${editSettings.sound}.`,
             }))),
         ...(scaleProblem === undefined
             ? []
             : [
                 {
                     field: "imageScale",
-                    message: `${scaleProblem} Change it in Edit project → Images → More images for long videos.`,
+                    message: `${scaleProblem} Change it under More images for long videos in ${editSettings.images}.`,
                 },
             ]),
     ];

package/dist/slices/schedules/agenda.js

@@ -1,14 +1,14 @@
 import { z } from "zod";
 import { derive, progressOf } from "../../kernel/runner/graph.js";
 import { liveProject, stageStandingsByProject } from "../admission/repo.js";
-import { readsByWaitBesideFailure } from "../admission/state-words.js";
+import { readsByWaitBesideFailure, retryingAt } from "../admission/state-words.js";
 import { queueEntries } from "../batch/index.js";
 import { sampleIds } from "../onboarding/model.js";
 import { readSampleRecord } from "../onboarding/state.js";
 import { projectHolds } from "../reviews/holds.js";
 import { limitWaitsByProject, listingWait } from "../run-cost/panel.js";
 import { notTemplateSample } from "../template-studio/repo.js";
-import { setAsideProjects, uploadedAndSettled, uploadedProjects } from "../uploads/repo.js";
+import { setAsideProjects, settledProjects, uploadedProjects } from "../uploads/repo.js";
 import { settledStatus } from "../uploads/rules.js";
 import { nextOccurrence } from "./calendar.js";
 import { upcomingDesignRuns } from "./design-agenda.js";
@@ -151,8 +151,8 @@ function sampleProjectIds(db) {
 // What a project on the calendar asks of the person, if anything. The same readings Home's
 // Needs you uses: a failed run, a paused run, one a restart stopped (Continue the run), or one
 // waiting for a review. A step failed beside a wait reads by that wait and is listed apart
-// (`stepFailed`). One Kept as is asks nothing, nor does an uploaded one that reads Done
-// (`uploadedAndSettled`).
+// (`stepFailed`). One Kept as is asks nothing, nor does an uploaded or edited one that reads
+// Done (`settledProjects`).
 function needsOf(state, ask) {
     if (state === "failed")
         return "failed";
@@ -170,7 +170,7 @@ function needsOf(state, ask) {
 // the range, with what each needs from the person and whether its video is ready to upload.
 function projectsIn(deps, from, to) {
     const standings = stageStandingsByProject(deps.db);
-    const settled = uploadedAndSettled(deps.db);
+    const settled = settledProjects(deps.db);
     const holds = projectHolds(deps.db, { standings, settled });
     const reviewing = awaitingReview(deps.db, holds);
     const uploads = uploadedProjects(deps.db);
@@ -224,6 +224,7 @@ function projectsIn(deps, from, to) {
             !uploads.has(project.id) &&
             !samples.has(project.id);
         const waiting = waits.get(project.id);
+        const retry = state === "running" ? retryingAt(standings.get(project.id) ?? []) : undefined;
         return [
             {
                 id: project.id,
@@ -242,6 +243,7 @@ function projectsIn(deps, from, to) {
                 ...(readsByWaitBesideFailure(state, standings.get(project.id) ?? [])
                     ? { stepFailed: true }
                     : {}),
+                ...(retry === undefined ? {} : { retryAt: retry }),
                 ...(waiting === undefined ? {} : { limitWaits: waiting.map(listingWait) }),
             },
         ];

package/dist/slices/schedules/design-check.js

@@ -11,25 +11,25 @@ export function checkDesign(deps, input) {
         return {
             ok: false,
             reason: "invalid-input",
-            message: "A design schedule makes each row's piece ahead of its date: it has no cadence, topic generation or release days. Choose Ahead of each date.",
+            message: "A poster schedule makes each row's poster ahead of its date: it has no cadence, topic generation or release days. Choose Ahead of each date.",
         };
     const template = getTemplate(deps.db, input.templateId);
     if (template === undefined)
         return { ok: false, reason: "missing-template" };
     const plan = designPlanOf(deps.db, input.templateId);
     if (plan === undefined)
-        return refuse(`The schedule wasn't saved. ${template.name} doesn't say which field holds each date. Open it in Library → Designs → Templates, choose the date field under Schedule, save it, then save the schedule again.`);
+        return refuse(`The schedule wasn't saved. ${template.name} doesn't say which keyword holds each date. Open it from Templates → Poster templates, choose the date keyword under Schedule, save it, then save the schedule again.`);
     const fields = designFields(plan.document);
     const named = fields.length === 0 ? "none" : fields.map((one) => `{{${one}}}`).join(", ");
     const problems = [];
     for (const keyword of Object.keys(input.values))
         if (!fields.includes(keyword))
-            problems.push(`{{${keyword}}} (for every row) is not a field of this template (its fields are ${named}). Remove it.`);
+            problems.push(`{{${keyword}}} (for every row) is not a keyword of this template (its keywords are ${named}). Remove it.`);
     for (const [index, row] of input.items.entries()) {
         const where = `Row ${String(index + 1)} (${row.title})`;
         for (const keyword of Object.keys(row.values))
             if (!fields.includes(keyword))
-                problems.push(`${where} fills {{${keyword}}}, which this template doesn't use (its fields are ${named}). Remove that column.`);
+                problems.push(`${where} fills {{${keyword}}}, which this template doesn't use (its keywords are ${named}). Remove that column.`);
         if (rowDate(row, plan.dateField) === undefined)
             problems.push(`${where} has no date in {{${plan.dateField}}}. Write it as YYYY-MM-DD, for example 2026-11-14.`);
     }

package/dist/slices/schedules/design-run.js

@@ -72,11 +72,11 @@ export function claimDesignRun(deps, schedule, now) {
         // missed runs. The row stays and is tried again at the same time the next day.
         const scheduledFor = schedule.nextRunAt === null ? now : new Date(schedule.nextRunAt);
         if (current.missedPolicy === "skip" && now.valueOf() - scheduledFor.valueOf() > missedGraceMs)
-            return keep("skipped", `Skipped: Slopify wasn't open at ${time} when ${row.title}'s piece was due, and this schedule skips the runs it misses. It tries again at ${time} tomorrow; to make a missed piece as soon as Slopify opens, set Missed run to Run once when Slopify reopens in Library → Designs → Templates → ${plan.name} → Schedule.`);
+            return keep("skipped", `Skipped: Slopify wasn't open at ${time} when ${row.title}'s poster was due, and this schedule skips the runs it misses. It tries again at ${time} tomorrow; to make a missed poster as soon as Slopify opens, set Missed run to Run once when Slopify reopens in Templates → Poster templates → ${plan.name} → Schedule.`);
         if (designs === undefined)
             return keep("failed", "Not started: designs aren't available in this copy of Slopify. Restart Slopify; if it keeps happening, reinstall it.");
         if (plan.readyVersion === null)
-            return keep("skipped", `Not started: ${plan.name} has no version marked ready. Open it in Library → Designs → Templates and press Mark ready.`);
+            return keep("skipped", `Not started: ${plan.name} has no version approved for schedules. Open it in Templates → Poster templates and press Approve for schedules.`);
         const missing = missingValues(plan.document, row.values);
         if (missing.length > 0) {
             const list = missing.map((name) => `{{${name}}}`).join(", ");
@@ -85,7 +85,7 @@ export function claimDesignRun(deps, schedule, now) {
         const quote = quoteDocument(designs.catalogue(), plan.document);
         if (current.spendLimitCents !== null &&
             (quote.unknown > 0 || quote.high * 100 > current.spendLimitCents))
-            return keep("failed", `Not started: ${row.title}'s piece costs up to $${quote.high.toFixed(2)}${quote.unknown > 0 ? " and some prices are unknown" : ""}, over this schedule's spend limit. Raise the spend limit or choose an image model with a known, lower price.`);
+            return keep("failed", `Not started: ${row.title}'s poster costs up to $${quote.high.toFixed(2)}${quote.unknown > 0 ? " and some prices are unknown" : ""}, over this schedule's spend limit. Raise the spend limit or choose an image model with a known, lower price.`);
         const started = run("running", null);
         if (!insertRun(deps.db, started))
             return;

package/dist/slices/schedules/repo.js

@@ -4,6 +4,7 @@ import { transact } from "../../kernel/db/tx.js";
 import { derive } from "../../kernel/runner/graph.js";
 import { projectExists, projectPaused, stagesOf } from "../admission/repo.js";
 import { readStartReceipt } from "../play-drafts/start-repo.js";
+import { setupSectionNames } from "../project-templates/setup-sections.js";
 import { scheduleRunSchema, scheduleSummarySchema, } from "./schema.js";
 const rowSchema = z.object({
     id: z.string(),
@@ -361,12 +362,12 @@ function parseRun(row) {
 const internalRunError = "Slopify hit an internal error while starting this run. The next run will try again; if it keeps happening, use Download diagnostics in Settings and report it.";
 const runErrors = {
     "missing-template": "The template this schedule uses was deleted or changed. Edit the schedule and choose a template again.",
-    "unsupported-media": "This template uses audio, images, a thumbnail, shorts background music or an ambient sound file you supplied, which scheduled runs cannot use. Pick a template that generates these instead, or on Play remove the music under Outputs → More shorts options (or pick Rain, Fireplace or Wind under Video and style → Ambient sound) and save the template again.",
+    "unsupported-media": `This template uses audio, images, a thumbnail, shorts background music or an ambient sound file you supplied, which scheduled runs cannot use. Pick a template that generates these instead, or open this one in Edit template, remove the music under ${setupSectionNames.shorts} (or pick Rain, Fireplace or Wind as the Ambient sound under ${setupSectionNames.video}) and save it again.`,
     "spend-limit": "Not started: the estimated cost was above this schedule's spend limit, or some prices were unknown. Raise the spend limit or choose models with known prices.",
-    readiness: "Not started: a provider was not ready, for example a missing API key, model or voice. Check Settings → Providers; the next run will try again.",
-    "not-found": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Library > Templates and save it.",
-    "invalid-draft": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Library > Templates and save it.",
-    "invalid-edit": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Library > Templates and save it.",
+    readiness: "Not started: a provider was not ready, for example a missing API key, model or voice. Check Settings → Keys & services; the next run will try again.",
+    "not-found": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Templates → Edit template and save it.",
+    "invalid-draft": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Templates → Edit template and save it.",
+    "invalid-edit": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Templates → Edit template and save it.",
     conflict: internalRunError,
     "pending-start": internalRunError,
     "already-started": internalRunError,

package/dist/slices/schedules/schema.js

@@ -309,6 +309,9 @@ export const calendarProjectSchema = z
     // A step failed while the run still reads by a wait (`readsByWaitBesideFailure`): listed as a
     // failed item beside what it waits for, as on Home. Older servers leave it out.
     stepFailed: z.literal(true).optional(),
+    // When a step that failed on something time can fix runs again by itself, while no step
+    // runs (`admission/state-words.ts` retryingAt): it reads Waiting to try again, as on Home.
+    retryAt: z.string().optional(),
     // Stages waiting for a CLI plan's limits to reset.
     limitWaits: z
         .array(z

package/dist/slices/schedules/topics.js

@@ -108,9 +108,9 @@ async function ask(deps, schedule, options) {
     const template = deps.template(schedule.templateId);
     const llm = schedule.topicGeneration.llm ?? template?.document.form.llm;
     if (llm === undefined)
-        return fail("the template this schedule uses was deleted, so there is no LLM to ask. Edit the schedule and choose a template, or pick an LLM under Topic generation.");
+        return fail("the template this schedule uses was deleted, so there is no AI model to ask. Edit the schedule and choose a template, or pick a Service and Model under Topic generation.");
     if (deps.topicLlm === undefined)
-        return fail("no LLM is available in this Slopify. Restart Slopify and try again.");
+        return fail("no AI model is available in this Slopify. Restart Slopify and try again.");
     const wanted = Math.max(generationWanted(schedule), options.force ? spare : 0);
     const known = knownTitles(deps, schedule.id);
     const signal = AbortSignal.any([
@@ -134,11 +134,11 @@ async function ask(deps, schedule, options) {
         if (options.signal?.aborted === true)
             return { ok: false, reason: "failed", message: "Slopify was closing." };
         const detail = errorText(error);
-        return fail(`${llm.provider} (${llm.model}) did not answer: ${detail.trim().slice(0, 300)}. Check it in Settings → Providers, or pick another LLM under Edit → Topic generation.`);
+        return fail(`${llm.provider} (${llm.model}) did not answer: ${detail.trim().slice(0, 300)}. Check it in Settings → Keys & services, or pick another Service or Model under Edit → Topic generation.`);
     }
     const suggested = parseTopics(answer);
     if (suggested.length === 0)
-        return fail(`${llm.provider} (${llm.model}) answered without a list of topics. Try again, or pick another LLM under Edit → Topic generation.`);
+        return fail(`${llm.provider} (${llm.model}) answered without a list of topics. Try again, or pick another Service or Model under Edit → Topic generation.`);
     // Scored outside the transaction: search may take seconds, and never holds the database.
     const scores = schedule.topicScoring === "off"
         ? undefined
@@ -154,7 +154,7 @@ async function ask(deps, schedule, options) {
             ? candidates
             : candidates.toSorted((a, b) => (scores.get(b)?.score ?? -1) - (scores.get(a)?.score ?? -1))).slice(0, Math.max(0, Math.min(wanted, queueMax - current.items.length)));
         if (fresh.length === 0)
-            return fail("every topic the LLM suggested was already made, queued or turned down for this schedule. Add more detail to the series brief under Edit, so it has new ground to cover.");
+            return fail("every topic the AI model suggested was already made, queued or turned down for this schedule. Add more detail to the series brief under Edit, so it has new ground to cover.");
         const at = deps.clock.now().toISOString();
         const mode = current.topicGeneration.mode === "hold" ? "hold" : "queue";
         if (scores !== undefined)

package/dist/slices/settings/first-run.js

@@ -9,17 +9,17 @@ export const providerDefaultsSchema = z
     .strict();
 export const providerDefaultsKey = "provider.defaults";
 const defaultsKey = providerDefaultsKey;
+// Set by the first-launch callout's "Got it" in older versions. Nothing writes it now; an
+// install that pressed it keeps its first launch behind it.
 const doneKey = "first-run.done";
 // The order a text tool is preferred in when several are found.
 const textPreference = ["claude-code", "codex", "gemini"];
 export function readProviderDefaults(db) {
     return readJsonSetting(db, defaultsKey, providerDefaultsSchema, {});
 }
-export function dismissFirstRun(db) {
-    writeSetting(db, doneKey, "1");
-}
-// First launch: find Claude Code, Codex and Gemini, pick the found ones as Play's defaults, and
-// say a video can be made without any API key. Later launches only report what was found.
+// First launch: find Claude Code, Codex and Gemini and pick the found ones as Create's defaults.
+// Later launches only report what was found. The first-run screen (slices/onboarding) says what
+// was found in its own words.
 export async function firstRunStatus(deps, statuses) {
     const detected = statuses
         .filter((status) => status.readiness.kind === "cli")
@@ -58,28 +58,7 @@ export async function firstRunStatus(deps, statuses) {
         };
         writeSetting(deps.db, defaultsKey, JSON.stringify(defaults));
     }
-    const names = detected
-        .filter((cli) => cli.usable && cli.id !== "codex-image")
-        .map((cli) => cli.displayName);
-    const systemVoice = statuses.some((status) => status.readiness.kind === "local" && status.readiness.available);
-    const narration = systemVoice
-        ? "Narration can use your computer's built-in voice (System voice in Settings → Voices); add an ElevenLabs or OpenAI key later for a better one."
-        : "Narration still needs a voice provider key, or turn Audio off or upload your own.";
-    return {
-        firstRun,
-        detected,
-        defaults,
-        message: !firstRun
-            ? null
-            : names.length > 0
-                ? "You can make a video now, no API keys needed."
-                : "No AI command-line tool was found on this computer.",
-        detail: !firstRun
-            ? null
-            : names.length > 0
-                ? `Slopify found ${list(names)} and picked ${names.length === 1 ? "it" : "them"} on Play. ${narration} Keys are optional extras in Settings → Providers.`
-                : "Install Claude Code, Codex or Antigravity CLI and sign in once in a terminal, then reload this page. Or paste an API key in Settings → Providers.",
-    };
+    return { firstRun, detected, defaults };
 }
 async function firstModel(deps, provider, family) {
     try {
@@ -90,8 +69,3 @@ async function firstModel(deps, provider, family) {
         return "";
     }
 }
-function list(names) {
-    return names.length <= 1
-        ? (names[0] ?? "")
-        : `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
-}

package/dist/slices/settings/health.js

@@ -1,10 +1,15 @@
 import { choiceSites, retiredModelUsage, slotLabels, } from "../model-upkeep/usage.js";
 import { cliPathStatus } from "./cli-paths.js";
-import { keyGuides } from "./key-guides.js";
 import { testProviderKey } from "./key-test.js";
 import { isLocalCliProvider } from "./model.js";
 import { modelReach } from "./model-reach.js";
 import { providerStatuses } from "./readiness.js";
+// The kinds as Keys & services heads its lists.
+const familyTitles = {
+    llm: "Writing services",
+    tts: "Voice services",
+    image: "Image services",
+};
 const signInCommand = {
     "claude-code": "claude auth login",
     codex: "codex login",
@@ -13,7 +18,16 @@ const signInCommand = {
 function loginSource(id) {
     return id === "codex-image" ? "codex" : id;
 }
-// Where each provider's models are chosen, as "Text model in template “Weekly”".
+// Where a model is chosen, as a person finds it: "template “Weekly”", "the draft “Moon” on
+// Create".
+function siteWords(kind, name) {
+    if (kind !== "draft")
+        return `${kind} “${name}”`;
+    return name === "Untitled draft"
+        ? "an untitled draft on Create"
+        : `the draft “${name}” on Create`;
+}
+// Where each provider's models are chosen, as "Writing model in template “Weekly”".
 function uses(db) {
     const found = new Map();
     for (const site of choiceSites(db))
@@ -24,7 +38,7 @@ function uses(db) {
             const list = found.get(choice.provider) ?? [];
             list.push({
                 model: choice.model,
-                where: `${slotLabels[slot]} in ${site.kind} “${site.name}”`,
+                where: `${slotLabels[slot]} in ${siteWords(site.kind, site.name)}`,
             });
             found.set(choice.provider, list);
         }
@@ -37,7 +51,7 @@ function overall(checks, used, setUp) {
         return "warning";
     return setUp || used ? "ok" : "unused";
 }
-// "Check all" on Settings → Providers: each command-line tool found and signed in, each saved
+// "Check all" on Settings → Keys & services: each command-line tool found and signed in, each saved
 // key accepted by its provider, and each chosen model still offered and answering for the key.
 // `only` checks one provider: its row's Check again, or a sign-in fix-it's.
 export async function checkProviderHealth(deps, only) {
@@ -85,7 +99,7 @@ async function cliHealth(deps, status, used) {
             label: "Installed",
             state: used.length > 0 ? "problem" : "skipped",
             detail: readiness.issue ??
-                `${name} was not found on this computer. Install it, sign in once in a terminal, then choose Check all again. If it is installed somewhere unusual, set its path in Settings → Providers.`,
+                `${name} was not found on this computer. Install it, sign in once in a terminal, then press Check again. If it is installed somewhere unusual, set its path in Settings → Keys & services.`,
         });
         return { ...base, state: used.length > 0 ? "problem" : "unused", checks };
     }
@@ -93,7 +107,7 @@ async function cliHealth(deps, status, used) {
         label: "Installed",
         state: readiness.issueKind === "version" ? "problem" : "ok",
         detail: readiness.issueKind === "version"
-            ? (readiness.issue ?? `Update ${name}, then choose Check all again.`)
+            ? (readiness.issue ?? `Update ${name}, then press Check again.`)
             : `Found ${command}${readiness.version === undefined ? "" : ` (version ${readiness.version})`}.`,
     });
     const source = loginSource(status.id);
@@ -115,7 +129,7 @@ async function cliHealth(deps, status, used) {
             ? {
                 label: "Signed in",
                 state: "problem",
-                detail: `${name} is not signed in. Open a terminal on the computer running it, run "${signInCommand[source]}" and sign in, then choose Check all again.`,
+                detail: `${name} is not signed in. Open a terminal on the computer running it, run "${signInCommand[source]}" and sign in, then press Check again.`,
             }
             : {
                 label: "Signed in",
@@ -141,7 +155,7 @@ async function cliModels(deps, status, used) {
         return {
             label: "Chosen models",
             state: "warning",
-            detail: `Slopify could not read ${status.displayName}'s model list, so it could not check the chosen models. Make sure it is signed in and up to date, then choose Check all again.`,
+            detail: `Slopify could not read ${status.displayName}'s model list, so it could not check the chosen models. Make sure it is signed in and up to date, then press Check again.`,
         };
     }
     const ids = new Set(offered.map((model) => model.id));
@@ -174,14 +188,14 @@ async function reachable(deps, status, used) {
         return {
             label: "Model reachable",
             state: "problem",
-            detail: `${name} does not offer ${describe(missing)} to this key: the model id is wrong, retired, or the account has no access to it. Pick another model there and save, or enable the model for your account, then choose Check all again.`,
+            detail: `${name} does not offer ${describe(missing)} to this key: the model id is wrong, retired, or the account has no access to it. Pick another model there and save, or enable the model for your account, then press Check again.`,
         };
     const unknown = [...found].filter(([, reach]) => reach === "unknown").map(([model]) => model);
     if (unknown.length > 0)
         return {
             label: "Model reachable",
             state: "warning",
-            detail: `${name} didn't answer for ${unknown.join(", ")}, so Slopify couldn't confirm the key can use ${unknown.length === 1 ? "it" : "them"}. Check your internet connection, then choose Check all again.`,
+            detail: `${name} didn't answer for ${unknown.join(", ")}, so Slopify couldn't confirm the key can use ${unknown.length === 1 ? "it" : "them"}. Check your internet connection, then press Check again.`,
         };
     return {
         label: "Model reachable",
@@ -198,16 +212,17 @@ function describe(missing) {
 async function keyedHealth(deps, status, used, retired) {
     const { readiness } = status;
     const base = { id: status.id, displayName: status.displayName, family: status.family };
-    const guide = keyGuides[status.id];
     const checks = [];
     const hasKey = readiness.kind === "keyed" && readiness.hasKey;
     if (!hasKey) {
+        // Said where it is read, Keys & services: the service's own setup, under its kind, has
+        // the key box and where to get a key.
         checks.push({
-            label: "Key saved",
+            label: "Key",
             state: used.length > 0 ? "problem" : "skipped",
-            detail: `No key is saved.${used.length > 0 ? ` It is chosen for ${describe(used)}.` : ""} Make one at ${guide?.keyPage.url ?? "the provider's website"}, paste it in Settings → Providers → ${status.displayName} and choose Save.`,
+            detail: `${used.length > 0 ? `None is saved, and ${status.displayName} is chosen for ${describe(used)}.` : "None is saved."} Open ${status.displayName} under ${familyTitles[status.family]}, paste a key and press Save.`,
         });
-        return { ...base, state: used.length > 0 ? "problem" : "unused", checks };
+        return { ...base, state: used.length > 0 ? "no-key" : "unused", checks };
     }
     const test = await testProviderKey(deps, status.id);
     checks.push({
@@ -228,7 +243,7 @@ async function keyedHealth(deps, status, used, retired) {
             state: "problem",
             detail: `${describe(mine.map((usage) => ({
                 model: usage.model,
-                where: `${slotLabels[usage.slot]} in ${usage.kind} “${usage.name}”`,
+                where: `${slotLabels[usage.slot]} in ${siteWords(usage.kind, usage.name)}`,
             })))} ${mine.length === 1 ? "is" : "are"} no longer offered. Use Switch in Settings → Models → Retired models in use.`,
         });
     else if (used.length > 0)

package/dist/slices/settings/key-test.js

@@ -21,7 +21,7 @@ export function keyTestOutcome(provider, answer, checkedAt, badKey) {
     const guide = keyGuides[provider];
     const keyPage = guide === undefined ? "the provider's website" : guide.keyPage.url;
     const billing = guide?.billing?.url;
-    const place = `Settings → Providers → ${name}`;
+    const place = `Settings → Keys & services → ${name}`;
     const done = (result, message) => ({
         provider,
         result,

package/dist/slices/settings/model.js

@@ -11,8 +11,8 @@ export const providerIds = [
     "claude-code",
     "codex",
     "gemini",
-    "elevenlabs",
     "openai-tts",
+    "elevenlabs",
     "cartesia",
     "inworld",
     "system-voice",
@@ -70,8 +70,10 @@ export const providers = [
         binary: "agy",
         versionArgs: ["--version"],
     },
-    { id: "elevenlabs", family: "tts", displayName: "ElevenLabs", auth: "key" },
+    // OpenAI first among the voices: the voices Slopify sets up are OpenAI's, so its key narrates
+    // at once, while ElevenLabs, Cartesia and Inworld also need a voice saved under Voices.
     { id: "openai-tts", family: "tts", displayName: "OpenAI", auth: "key" },
+    { id: "elevenlabs", family: "tts", displayName: "ElevenLabs", auth: "key" },
     { id: "cartesia", family: "tts", displayName: "Cartesia", auth: "key" },
     { id: "inworld", family: "tts", displayName: "Inworld", auth: "key" },
     { id: "system-voice", family: "tts", displayName: "System voice", auth: "local" },

package/dist/slices/settings/playback.js

@@ -56,7 +56,7 @@ export function saveSettings(deps, settings) {
     if (!subtitleModelValue.safeParse(settings.subtitleModel).success) {
         fields.push({
             field: "subtitleModel",
-            message: "Choose Most accurate, Balanced or Smallest in Settings → Production defaults → Subtitle timing model.",
+            message: "Choose Most accurate, Balanced or Smallest in Settings → Production defaults → Caption timing model.",
         });
     }
     if (!videoEncoderValue.safeParse(settings.videoEncoder).success) {
@@ -74,7 +74,7 @@ export function saveSettings(deps, settings) {
     if (!renderPriorityValue.safeParse(settings.renderPriority).success) {
         fields.push({
             field: "renderPriority",
-            message: "Choose Normal or Background in Settings → Production defaults → Render priority.",
+            message: "Choose Normal or Background in Settings → Production defaults → Encoding priority.",
         });
     }
     if (fields.length > 0) {

package/dist/slices/shorts/keep.js

@@ -1,3 +1,4 @@
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { clipBounds } from "./pick.js";
 // Shorts kept through a change of their moments: a count raised or lowered, a new intro or a
 // narration edit that moves the timing. A kept short is remembered by its sentences' text, so
@@ -87,5 +88,5 @@ export function lostMessage(lost, kept) {
         return short === undefined ? `short ${String(at)}` : `short ${String(at)} ("${short.title}")`;
     })
         .join(", ");
-    return `The narration of ${names} changed, so its moment can't be kept. Open Edit project → Shorts and choose Pick a new moment for it or drop it, then Remake.`;
+    return `The narration of ${names} changed, so its moment can't be kept. Untick it under Keep finished shorts in ${editSettings.shorts}, so a new moment is picked for it, save, then use Choose what to make again (in the project's More menu).`;
 }

package/dist/slices/shorts/pick.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { jsonBetween } from "../../kernel/json-answer.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { youtubeTimestamp } from "../youtube/timestamps.js";
 import { shortHashtagsMax, shortHashtagsMin, shortTitleMax } from "./model.js";
 export const shortPickSchema = z.object({
@@ -121,7 +122,7 @@ const answerSchema = z.array(z.object({
     hashtags: z.array(z.string()),
     why: z.string().optional(),
 }));
-const fix = "Try again, or choose another model in Edit project → Providers.";
+const fix = `Try again, or choose another model in ${editSettings.writer}.`;
 // Timing noise: the length rules are checked to the hundredth of a second.
 const tolerance = 0.01;
 // Reads the model's answer and keeps the clips that follow the rules: in range, the right
@@ -221,8 +222,8 @@ export function checkPicks(text, sentences, limits) {
 export function noPicksMessage(problems, limits) {
     const shortVideo = limits.durationSeconds < limits.minSeconds;
     if (shortVideo)
-        return `The narration is ${String(Math.round(limits.durationSeconds))} seconds long, shorter than the ${String(limits.minSeconds)}-second minimum for a short, so there is nothing to cut. Lower the shortest length in Edit project → Shorts, then Try again.`;
-    return `The AI model didn't pick any clip Slopify could use as a short, twice (${problems[0] ?? "no clips were listed"}). Try again; if it keeps happening, widen the length range in Edit project → Shorts, or choose another model in Edit project → Providers.`;
+        return `The narration is ${String(Math.round(limits.durationSeconds))} seconds long, shorter than the ${String(limits.minSeconds)}-second minimum for a short, so there is nothing to cut. Lower the shortest Length in ${editSettings.shorts}, then Try again.`;
+    return `The AI model didn't pick any clip Slopify could use as a short, twice (${problems[0] ?? "no clips were listed"}). Try again; if it keeps happening, widen the Length range in ${editSettings.shorts}, or choose another model in ${editSettings.writer}.`;
 }
 function round(seconds) {
     return Math.round(seconds * 1000) / 1000;