@gentbajko/slopify 3.9.1 → 3.10.1

package/dist/slices/schedules/agenda.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { derive } from "../../kernel/runner/graph.js";
-import { liveProject, projectPaused, stageStandingsByProject } from "../admission/repo.js";
+import { liveProject, stageStandingsByProject } from "../admission/repo.js";
 import { queueEntries } from "../batch/index.js";
 import { sampleIds } from "../onboarding/model.js";
 import { readSampleRecord } from "../onboarding/state.js";
@@ -102,7 +102,9 @@ function upcomingRuns(deps, schedule, now, from, to) {
 const projectRow = z.object({
     id: z.string(),
     title: z.string(),
-    config: z.string(),
+    // The stored `sources.video`, null when absent or the configuration is unreadable.
+    video_source: z.unknown(),
+    paused: z.number(),
     created_at: z.string(),
     finished_at: z.string().nullable(),
 });
@@ -125,15 +127,8 @@ function awaitingReview(db) {
 }
 // Whether a finished project's settings make a video: projects stored before sources were
 // recorded made one.
-const videoSource = z.object({ sources: z.object({ video: z.string() }).partial() }).partial();
-function makesVideo(config) {
-    try {
-        const parsed = videoSource.safeParse(JSON.parse(config));
-        return !parsed.success || parsed.data.sources?.video !== "off";
-    }
-    catch {
-        return true;
-    }
+function makesVideo(videoSource) {
+    return videoSource !== "off";
 }
 function sampleProjectIds(db) {
     return new Set(sampleIds.flatMap((id) => {
@@ -169,13 +164,23 @@ function projectsIn(deps, from, to) {
         fromSchedule.set(parsed.project_id, parsed.schedule_id);
     }
     return deps.db
-        .prepare(`SELECT projects.id,projects.title,projects.config,projects.created_at,max(stages.finished_at) AS finished_at
+        .prepare(
+    // A project with no stage pending or running, not paused and with stages is finished
+    // (`derive`), so one that ended before the range is left out here rather than read.
+    `SELECT projects.id,projects.title,projects.created_at,
+         CASE WHEN json_valid(projects.config) THEN json_extract(projects.config,'$.sources.video') END AS video_source,
+         COALESCE(project_controls.paused,0) AS paused,max(stages.finished_at) AS finished_at
        FROM projects LEFT JOIN stages ON stages.project_id=projects.id
-       WHERE projects.created_at<? AND ${liveProject()} GROUP BY projects.id ORDER BY projects.created_at,projects.id`)
-        .all(to.toISOString())
+       LEFT JOIN project_controls ON project_controls.project_id=projects.id
+       WHERE projects.created_at<? AND ${liveProject()} GROUP BY projects.id
+       HAVING COALESCE(project_controls.paused,0)=1 OR count(stages.id)=0
+         OR sum(stages.state IN ('pending','running'))>0
+         OR COALESCE(max(stages.finished_at),projects.created_at)>=?
+       ORDER BY projects.created_at,projects.id`)
+        .all(to.toISOString(), from.toISOString())
         .flatMap((row) => {
         const project = projectRow.parse(row);
-        const state = derive(standings.get(project.id) ?? [], projectPaused(deps.db, project.id));
+        const state = derive(standings.get(project.id) ?? [], project.paused === 1);
         const terminal = state === "done" || state === "partial" || state === "failed" || state === "canceled";
         if (terminal) {
             const ended = project.finished_at ?? project.created_at;
@@ -184,7 +189,7 @@ function projectsIn(deps, from, to) {
         }
         const needs = needsOf(state, reviewing.has(project.id));
         const ready = (state === "done" || state === "partial") &&
-            makesVideo(project.config) &&
+            makesVideo(project.video_source) &&
             !uploads.has(project.id) &&
             !samples.has(project.id);
         const waiting = waits.get(project.id);

package/dist/slices/schedules/held-bulk.js

@@ -0,0 +1,66 @@
+import { transact } from "../../kernel/db/tx.js";
+import { scheduleById } from "./repo.js";
+import { writeHeldValues } from "./topics.js";
+// Held topics decided several at a time: Reject selected (or Reject all, as the ids shown),
+// and its Undo, which puts turned-down topics back to wait with the keywords they had.
+function liveSchedule(deps, scheduleId) {
+    const schedule = scheduleById(deps.db, scheduleId);
+    if (schedule === undefined || schedule.deletedAt !== null)
+        return { ok: false, reason: "not-found" };
+    if (schedule.status === "canceled" || schedule.status === "completed")
+        return { ok: false, reason: "conflict" };
+    return { ok: true, value: schedule };
+}
+// Every id must still be waiting, or nothing is turned down: the list on screen was stale.
+export function rejectHeldTopics(deps, scheduleId, ids) {
+    const unique = [...new Set(ids)];
+    if (unique.length === 0)
+        return { ok: false, reason: "invalid-input" };
+    return batch(deps, () => {
+        const open = liveSchedule(deps, scheduleId);
+        if (!open.ok)
+            return open;
+        const at = deps.clock.now().toISOString();
+        const reject = deps.db.prepare(`UPDATE schedule_topics SET state='rejected',decided_at=?
+       WHERE id=? AND schedule_id=? AND state='held'`);
+        for (const id of unique)
+            if (Number(reject.run(at, id, scheduleId).changes) !== 1)
+                throw new TopicGone();
+        writeHeldValues(deps.db);
+        return { ok: true, value: scheduleById(deps.db, scheduleId) };
+    });
+}
+// Turned-down topics wait again, each with the keywords it had (`values`, from the list the
+// person saw), in its old place.
+export function restoreRejectedTopics(deps, scheduleId, topics) {
+    if (topics.length === 0)
+        return { ok: false, reason: "invalid-input" };
+    return batch(deps, () => {
+        const open = liveSchedule(deps, scheduleId);
+        if (!open.ok)
+            return open;
+        const restore = deps.db.prepare(`UPDATE schedule_topics SET state='held',decided_at=NULL
+       WHERE id=? AND schedule_id=? AND state='rejected'`);
+        for (const topic of topics)
+            if (Number(restore.run(topic.id, scheduleId).changes) !== 1)
+                throw new TopicGone();
+        writeHeldValues(deps.db, (stored) => ({
+            ...stored,
+            ...Object.fromEntries(topics.flatMap((topic) => topic.values === undefined ? [] : [[topic.id, { ...topic.values }]])),
+        }));
+        return { ok: true, value: scheduleById(deps.db, scheduleId) };
+    });
+}
+// Thrown inside the transaction so a half-done batch rolls back.
+class TopicGone extends Error {
+}
+function batch(deps, run) {
+    try {
+        return transact(deps.db, run);
+    }
+    catch (error) {
+        if (error instanceof TopicGone)
+            return { ok: false, reason: "topic-not-found" };
+        throw error;
+    }
+}

package/dist/slices/schedules/topics.js

@@ -299,7 +299,7 @@ function readHeldValues(db) {
 }
 // Entries of topics that are no longer held (approved, turned down, or gone with their
 // schedule) are dropped on every write.
-function writeHeldValues(db, change = (values) => values) {
+export function writeHeldValues(db, change = (values) => values) {
     const held = new Set(db
         .prepare("SELECT id FROM schedule_topics WHERE state='held'")
         .all()

package/dist/slices/storage/backup-import.js

@@ -433,7 +433,7 @@ function checkScratch(deps, scratch, library, parts) {
         }
     }
     catch {
-        throw unreadable("a document theme");
+        throw unreadable("a PDF theme");
     }
     try {
         for (const row of rowsOf(scratch, "SELECT id FROM channels")) {
@@ -489,7 +489,7 @@ function projectConflict(deps, scratch, id) {
     if (deps.db.prepare("SELECT 1 FROM projects WHERE id=?").get(id) !== undefined)
         return "It is already in this install.";
     if (existsSync(projectDir(deps.paths, id)))
-        return "Its folder is already in the projects folder without a project. Press Clean orphan files in Settings → Backup & storage, then import again.";
+        return "Its folder is already in the projects folder without a project. Press Clear leftover files in Settings → Backup & storage, then import again.";
     for (const table of projectTables)
         for (const row of projectRows(scratch, table, id))
             if (typeof row.id === "string" &&
@@ -854,11 +854,15 @@ function mergeChannels(db, scratch, work, images, now) {
         db.prepare("INSERT INTO image_blobs(sha256,mime,bytes,created_at) VALUES (?,?,?,?) ON CONFLICT(sha256) DO NOTHING").run(image.sha256, image.mime, readFileSync(path), now);
     }
     const cast = { added: 0, renamed: 0, skipped: 0 };
-    for (const row of rowsOf(scratch, "SELECT * FROM cast_members ORDER BY rowid")) {
+    // In the backup's order (an older backup was given its alphabetical order by migration 0052),
+    // after any members the channel here already has.
+    const lastPlace = db.prepare("SELECT coalesce(max(position)+1,0) AS next FROM cast_members WHERE channel_id=?");
+    for (const row of rowsOf(scratch, "SELECT * FROM cast_members ORDER BY channel_id, position, lower(name), id")) {
         if (has("SELECT 1 FROM cast_members WHERE id=?", String(row.id)))
             cast.skipped += 1;
         else {
-            insertRow(db, "cast_members", row);
+            const next = lastPlace.get(String(row.channel_id))?.next;
+            insertRow(db, "cast_members", { ...row, position: typeof next === "number" ? next : 0 });
             cast.added += 1;
         }
     }

package/dist/slices/storage/downloads.js

@@ -44,6 +44,38 @@ export { assetOf };
 export function downloadName(slug, output) {
     return `${slug}-${assetOf(output)}${extname(output.path)}`;
 }
+// Which version of its place a file is: 1 for the first file ever saved there, 2 for the one
+// that replaced it, and so on. Retained files keep their number across later versions of the
+// project, so the same file always downloads under the same name.
+export function fileVersion(deps, projectId, slot, assetId) {
+    const assets = deps.db
+        .prepare(`SELECT o.asset_id AS id, MIN(a.created_at) AS made FROM revision_outputs o
+      JOIN project_assets a ON a.project_id=o.project_id AND a.id=o.asset_id
+      WHERE o.project_id=? AND o.slot=? GROUP BY o.asset_id ORDER BY made, o.asset_id`)
+        .all(projectId, slot)
+        .map((row) => String(row.id));
+    return Math.max(1, assets.indexOf(assetId) + 1);
+}
+// "tides-image-3.png" for a first version, "tides-image-3-v2.png" once it was remade, so a
+// newer download never silently takes an older one's name.
+export function versionedName(name, version) {
+    if (version <= 1)
+        return name;
+    const extension = extname(name);
+    return `${name.slice(0, name.length - extension.length)}-v${String(version)}${extension}`;
+}
+// The version of the file a project's current output points at, so the current download and
+// History name the same file the same way.
+function currentVersion(deps, projectId, path) {
+    const row = deps.db
+        .prepare(`SELECT o.slot, o.asset_id FROM revision_outputs o
+      JOIN project_assets a ON a.project_id=o.project_id AND a.id=o.asset_id
+      WHERE o.project_id=? AND a.path=? LIMIT 1`)
+        .get(projectId, path);
+    return row === undefined
+        ? 1
+        : fileVersion(deps, projectId, String(row.slot), String(row.asset_id));
+}
 export function findDownload(deps, projectId, asset) {
     const title = projectTitle(deps.db, projectId);
     if (title === undefined) {
@@ -68,7 +100,7 @@ export function findDownload(deps, projectId, asset) {
         ok: true,
         download: {
             path,
-            filename: downloadName(slugOf(title), output),
+            filename: versionedName(downloadName(slugOf(title), output), currentVersion(deps, projectId, output.path)),
             bytes: shown?.byteLength ?? stats,
             contentType: contentTypeOf(path),
             ...(shown === undefined ? {} : { text: shown }),
@@ -111,7 +143,8 @@ function shownYoutubeText(deps, projectId, role) {
     return new TextEncoder().encode(`${text}\n`);
 }
 // "download all" images as `<title-slug>-images.zip`, thumbnail included.
-export function imagesZip(deps, projectId) {
+// `set`: every picture (Images' Download all), the thumbnails alone, or every rendered short.
+export function imagesZip(deps, projectId, set = "images") {
     const title = projectTitle(deps.db, projectId);
     if (title === undefined) {
         return { ok: false, reason: "unknown-project" };
@@ -119,7 +152,12 @@ export function imagesZip(deps, projectId) {
     const slug = slugOf(title);
     const entries = {};
     for (const output of outputsOf(deps.db, projectId)) {
-        if (output.role !== "image" && output.role !== "thumbnail") {
+        const member = set === "images"
+            ? output.role === "image" || output.role === "thumbnail"
+            : set === "thumbnails"
+                ? output.role === "thumbnail"
+                : output.role === "short_video";
+        if (!member) {
             continue;
         }
         const path = outputPath(deps.paths, projectId, output.path);
@@ -138,7 +176,7 @@ export function imagesZip(deps, projectId) {
     if (Object.keys(entries).length === 0) {
         return { ok: false, reason: "no-images" };
     }
-    return { ok: true, filename: `${slug}-images.zip`, bytes: zipSync(entries) };
+    return { ok: true, filename: `${slug}-${set}.zip`, bytes: zipSync(entries) };
 }
 function sizeOf(path) {
     const stats = statSync(path, { throwIfNoEntry: false });

package/dist/slices/studio/backfill.js

@@ -8,6 +8,12 @@ export function backfillVideos(deps, rows, at) {
         byTitle.set(norm(row.title), row.videoId);
     if (byTitle.size === 0)
         return 0;
+    // A video already linked to an upload is never claimed by another: two projects can have a
+    // short with the same title (a remake of a topic), and only one of them made that video.
+    const taken = new Set(deps.db
+        .prepare("SELECT video_id FROM youtube_videos")
+        .all()
+        .map((row) => String(row.video_id)));
     let found = 0;
     for (const project of listProjects(deps.db)) {
         const known = projectVideos(deps.db, project.id).filter((one) => one.uploadState === "done");
@@ -20,9 +26,10 @@ export function backfillVideos(deps, rows, at) {
                 continue;
             const titles = item.pickable?.titles ?? [item.title, ...item.titles];
             const videoId = titles.map((one) => byTitle.get(norm(one))).find((one) => one !== undefined);
-            if (videoId === undefined)
+            if (videoId === undefined || taken.has(videoId))
                 continue;
             recordVideo(deps.db, project.id, short, videoId, at);
+            taken.add(videoId);
             found += 1;
         }
     }

package/dist/slices/voices/adaptation.js

@@ -0,0 +1,19 @@
+import { scriptContract } from "./script.js";
+// "Adapt into a conversation": the text model rewrites an existing article as speaker turns in
+// the chosen format (a podcast's hosts talking it through, an interview). The article itself is
+// left as written; the conversation is the narration's script, kept beside it. Unlike the
+// audiobook's speaker split this is a rewrite, so the words are not held to the source - only
+// its facts and order are asked for - and the script is checked as a script before it is used.
+export function adaptationMessages(source, format, speakers) {
+    return [
+        {
+            role: "system",
+            content: [
+                scriptContract(format, speakers),
+                "Turn the text you are given into this conversation. Keep its facts, names and order, and say nothing the text does not support.",
+                "Keep the text's own chapter headings as the section headings.",
+            ].join("\n"),
+        },
+        { role: "user", content: source },
+    ];
+}

package/dist/slices/voices/model.js

@@ -12,8 +12,10 @@ export const voiceFormatLabels = {
 export const speakerRoles = ["narrator", "host", "guest", "character"];
 // Where the script comes from. `script` asks the text model for speaker turns with a Script
 // prompt; `attribute` (audiobooks) writes or takes the article as usual and has the text model
-// hand its dialogue to the speakers.
-export const scriptSources = ["script", "attribute"];
+// hand its dialogue to the speakers; `adapt` writes or takes the article as usual and has the
+// text model rewrite it as a conversation between the speakers (a podcast of an article). With
+// `attribute` and `adapt` the article stays as written and the spoken script is kept beside it.
+export const scriptSources = ["script", "attribute", "adapt"];
 export const speakersMax = 10;
 export const speakerNameMax = 40;
 export const paceSteps = [0.8, 0.9, 1, 1.1, 1.2];

package/dist/slices/youtube/model.js

@@ -9,8 +9,10 @@ export const minChapterSeconds = 10;
 // YouTube's limits on the Tags field: 500 characters in all, 100 for one tag.
 export const tagsMaxCharacters = 500;
 export const tagMaxCharacters = 100;
-// YouTube ignores every hashtag of a description that has more than 15.
-export const hashtagsMax = 15;
+// YouTube ignores every hashtag of a description that has more than 60 (YouTube Help,
+// "Use hashtags for YouTube videos"); the first three show above the title.
+export const hashtagsMax = 60;
+export const hashtagsShownByTitle = 3;
 // YouTube's limit on a description.
 export const descriptionMaxCharacters = 5000;
 // YouTube's title A/B test ("Test & compare") takes up to three titles: the video's own and
@@ -33,3 +35,32 @@ export const defaultDescriptionPrompt = [
 // The name Play, Edit project and the review summary show for the prompt used when none is
 // picked.
 export const defaultDescriptionPromptName = "Built-in";
+// YouTube's API refuses < and > in a title or a description.
+const forbidden = /[<>]/;
+// Why YouTube would refuse a title as typed, or undefined when it takes it: at most 100
+// characters, no < or >. The project's own title is not this; only the title sent to YouTube.
+export function youtubeTitleProblem(title) {
+    const trimmed = title.trim();
+    if (trimmed.length > titleMaxCharacters)
+        return `YouTube takes titles of up to ${String(titleMaxCharacters)} characters; this one has ${String(trimmed.length)}. Shorten it.`;
+    if (forbidden.test(trimmed))
+        return "YouTube doesn't allow < or > in a title. Remove them.";
+    return undefined;
+}
+// The same for a description: at most 5,000 characters, no < or >.
+export function youtubeDescriptionProblem(description) {
+    if (description.length > descriptionMaxCharacters)
+        return `YouTube takes descriptions of up to ${descriptionMaxCharacters.toLocaleString("en-US")} characters; this one has ${description.length.toLocaleString("en-US")}. Shorten it.`;
+    if (forbidden.test(description))
+        return "YouTube doesn't allow < or > in a description. Remove them.";
+    return undefined;
+}
+// The hashtags of a hashtag line, and a warning when YouTube would ignore them all.
+export function hashtagNote(line) {
+    const count = line.split(/\s+/u).filter((word) => word.startsWith("#") && word.length > 1).length;
+    if (count === 0)
+        return undefined;
+    if (count > hashtagsMax)
+        return `${String(count)} hashtags: YouTube ignores every hashtag when there are more than ${String(hashtagsMax)}. Remove ${String(count - hashtagsMax)}.`;
+    return `${String(count)} hashtag${count === 1 ? "" : "s"}; the first ${String(Math.min(count, hashtagsShownByTitle))} show above the title.`;
+}

package/dist/tutorials/AI-CLIs.md

@@ -102,7 +102,7 @@ When a tool says its allowance is used up, the run does not fail:
 3. The project's status reads **Waiting for limits**, with a line such as "Waiting for Codex limits (resets at 14:00)." The same words show on Home's Running now, the Projects row and the Calendar.
 4. When the reset passes, the run continues by itself.
 
-Other providers are not held up: a project whose narration uses a key carries on while its Codex images wait. The wait survives a restart; a project that was waiting when Slopify stopped resumes on the next start and waits again. A project you paused or cancelled meanwhile is left alone.
+Other providers are not held up: a project whose narration uses a key carries on while its Codex images wait. The wait survives a restart; a project that was waiting when Slopify stopped resumes on the next start and waits again. A project you paused or canceled meanwhile is left alone.
 
 Gemini's daily quota is handled the same way ("Slopify waits and tries again later by itself").
 

package/dist/tutorials/Backups.md

@@ -2,7 +2,7 @@
 
 A backup is one `.tar` file with everything you made in Slopify: every project with its files and history, your library, templates, schedules, channels and settings. Make one by hand at any time with **Export everything**, or let Slopify write one every day. Bring one back with **Import a backup**. Provider keys are never included.
 
-**Where to find it:** **Settings → Backup & storage** (Export everything, Import a backup) and **Settings → Backups** (daily backups, Back up now).
+**Where to find it:** **Settings → Backup & storage**: daily backups and Back up now, Export everything and Import a backup.
 
 ## What a backup holds
 
@@ -54,7 +54,7 @@ If the import fails, Slopify says: "The backup wasn't imported. Check it is a fi
 
 Daily backups are off by default, because each backup holds every project's video and can fill a disk.
 
-1. Open **Settings → Backups**.
+1. Open **Settings → Backup & storage**.
 2. Turn **Back up automatically** on.
 3. Set **Time of day**, **Keep last** and optionally **Folder** (see below).
 4. Press **Save**.
@@ -78,7 +78,7 @@ The screen shows the last backup's time and size, the result of the last attempt
 
 ## Back up now
 
-1. Open **Settings → Backups**.
+1. Open **Settings → Backup & storage**.
 2. Press **Back up now**. Slopify says "Backup started. Its result shows here when it finishes."
 
 It writes the same file into the backup folder. It says which projects it is waiting for, if any, and is refused while another backup is being written.
@@ -97,11 +97,11 @@ It writes the same file into the backup folder. It says which projects it is wai
 - Free space is checked first. A backup that would not fit fails with the sizes.
 - Backup files are readable by your user only.
 - An update waits for a backup that is being written.
-- Every failure is explained on **Settings → Backups** with what to change, for example free space, lower **Keep last**, or pick another **Folder**.
+- Every failure is explained on **Settings → Backup & storage** with what to change, for example free space, lower **Keep last**, or pick another **Folder**.
 
 ## Other storage tools on Backup & storage
 
-- **Clean orphan files** deletes files that no project, draft or template uses any more. Slopify also does this each time it starts.
+- **Clear leftover files** deletes files that no project, draft or template uses any more. Slopify also does this each time it starts.
 - **Keep outputs only** on a finished project deletes its working files and keeps the finished outputs.
 
 Both are explained in [Where your files live](Where-Your-Files-Live).

package/dist/tutorials/Calendar.md

@@ -10,7 +10,7 @@ The calendar starts on this week's Monday and shows four weeks, Monday to Sunday
 
 - **Scheduled runs**, each with the project title it will make. A run shows **Queued** when a topic is lined up, **Needs a topic** when its topic is still waiting for your approval or for generation, and **Paused** when its schedule is paused.
 - **Needs you**, above the weeks: every project that is waiting on you or ready to upload (see below).
-- **Projects** running or finished on their day, with their state: **Running**, **Paused**, **Waiting**, **Failed**, **Done with problems**, **Done** or **Canceled**. A project waiting for a CLI plan says so, for example **Waiting for Codex limits (resets at 14:00)**.
+- **Projects** running or finished on their day, with their state: **Running**, **Paused**, **Queued**, **Failed**, **Done with problems**, **Done** or **Canceled**. A project waiting for a CLI plan says so, for example **Waiting for Codex limits (resets at 14:00)**.
 - **Batch queue**: projects waiting to start (see below).
 - **Suggested topics**, beside the weeks, for schedules that hold generated topics for approval.
 
@@ -33,7 +33,7 @@ The bundled samples never show here. A press anywhere on an entry opens its proj
 
 ## The batch queue
 
-Videos started together, such as extra videos queued from Play, run one at a time. **Batch queue** lists them in the order they run, numbered (**1 in line**, **2 in line**, …), each marked **Running now**, **Waiting its turn** or **Paused**. Its heading says how many are waiting to start. Pausing a queued project holds the whole queue; when one fails or is cancelled, the next one starts. The batch queue is only shown on the calendar; Projects links here and has a **Queued** filter. It is hidden when nothing is queued.
+Videos started together, such as extra videos queued from Play, run one at a time. **Batch queue** lists them in the order they run, numbered (**1 in line**, **2 in line**, …), each marked **Running now**, **Waiting its turn** or **Paused**. Its heading says how many are waiting to start. Pausing a queued project holds the whole queue; when one fails or is canceled, the next one starts. The batch queue is only shown on the calendar; Projects links here and has a **Queued** filter. It is hidden when nothing is queued.
 
 ## Switch between weeks and a list
 

package/dist/tutorials/Channels.md

@@ -61,7 +61,7 @@ Mark voices in **Settings → Voices** and Image prompts in **Library → Prompt
 | **Title font** | The font of chapter cards and the end screen, for videos whose template sets no title style. |
 | **Title colour** | The text colour of chapter cards and the end screen, such as `#FFD700`. |
 | **End screen text** | A line shown centred over the last 5 seconds of every video, such as "Subscribe for more". Up to 200 characters. Blank shows none. |
-| **Intro** / **Outro** | An entry from **Library → Intros & Outros**, narrated before or after the body of every video whose template has none. Each is narrated with the video's voice, so each costs one voice request per video (plus a text call for an LLM entry), and it shows in the estimate. See [Intros and outros](Intros-and-Outros). |
+| **Intro** / **Outro** | An entry from **Library → Intros & outros**, narrated before or after the body of every video whose template has none. Each is narrated with the video's voice, so each costs one voice request per video (plus a text call for an LLM entry), and it shows in the estimate. See [Intros and outros](Intros-and-Outros). |
 | **Document theme** | The look of the PDF for videos whose template picks no theme. A saved theme that was deleted is skipped. |
 | **Ambient sound** | Rain, Fireplace or Wind under the long video's narration, with its level (−40 to −6 dB, default −18), fade-in (0 to 30 s, default 3) and tail (0 to 30 s, default 6). Used when the template leaves its own ambient sound on "The channel's". A channel can't hold your own audio file. |
 

package/dist/tutorials/Costs-and-Run-Cost.md

@@ -49,7 +49,7 @@ When a CLI's plan is used up, the run waits instead of failing: the status reads
 
 ## After a run: the run cost line
 
-When a run has ended, one line at the top of its project page, under the title, sums it up: for example `This run cost $0.42 · ~$3.10 via API · 12 min of work`. A failed or cancelled run says **Spent so far**, and calls without a known price add "plus unpriced calls". **See cost by stage** opens the full breakdown below. The line doesn't show while the run is going, or when it spent nothing.
+When a run has ended, one line at the top of its project page, under the title, sums it up: for example `This run cost $0.42 · ~$3.10 via API · 12 min of work`. A failed or canceled run says **Spent so far**, and calls without a known price add "plus unpriced calls". **See cost by stage** opens the full breakdown below. The line doesn't show while the run is going, or when it spent nothing.
 
 ## After a run: the Run cost tab
 

package/dist/tutorials/Document-Themes.md

@@ -2,7 +2,7 @@
 
 A document theme is the look of the PDF Slopify makes from the article: paper size, colours, fonts, spacing, the title page, contents, sources and closing pages, headers and page numbers. Slopify ships a built-in **Plain** theme. Copy it to make themes of your own, with a live preview as you edit.
 
-**Where to find it:** **Library → Documents**. Pick a theme on Play's **Document** row, in **Edit project**, or as a channel's default in its brand kit.
+**Where to find it:** **Library → PDF themes**. Pick a theme on Play's **Document** row, in **Edit project**, or as a channel's default in its brand kit.
 
 ## Built-in and your own themes
 
@@ -15,7 +15,7 @@ A project keeps its own copy of the theme's settings. Editing or deleting a them
 
 ## Make a theme
 
-1. Open **Library → Documents**.
+1. Open **Library → PDF themes**.
 2. Press **New theme** (it starts from Plain), or pick a built-in theme and press **Copy theme**, or press **Duplicate** on one of your themes.
 3. Type a **Name** (up to 80 characters). This is what the Document row on Play and Edit project shows.
 4. Open the groups on the left and change what you like (every setting is listed below). The first two groups start open.

package/dist/tutorials/Editing-a-Project.md

@@ -31,7 +31,7 @@ The form has its own section list on the left. Some sections appear only when th
 
 At the bottom: **Save changes** saves a revision, **Discard changes** drops the draft. While a file is uploading the bar says "Waiting for uploads to finish…" and saving waits.
 
-If someone (or another tab) saved the project while you were editing, the bar says "A newer revision is available. Your unsaved changes are kept below." Press **Reload current revision and discard my draft** to start from the newer one.
+If someone (or another tab) saved the project while you were editing, the bar says "A newer revision is available. Your unsaved changes are kept below and in this browser." Press **Reload latest and re-apply my edit** to lay your changes over the newer revision (check them, then **Save changes**), or **Copy my edit** to keep a copy on the clipboard first.
 
 ## Change the article text
 
@@ -119,7 +119,7 @@ The project keeps its own copy of each prompt, so later Library edits reach it o
 | Control | What it does |
 | --- | --- |
 | **Also use pronunciations from my other projects** → **Update from other projects** | Copies your other projects' Pronunciation Glossary terms into this project again, picking up any added since the last copy. After you save, only the chunks whose words those terms change are spoken again, paid per character. |
-| **Use narration aliases** → **Update from Library** | Copies Library → Aliases into this project again. A Library edit reaches the project only when you press this. After you save, only the chunks the changed aliases touch are spoken again. |
+| **Use narration aliases** → **Update from Library** | Copies Library → Narration aliases into this project again. A Library edit reaches the project only when you press this. After you save, only the chunks the changed aliases touch are spoken again. |
 | **Describe tables and figures in the narration** | The text model writes a short spoken passage for each table, figure, equation and code block. Turning it on costs one text call per block, and after you save the chunks that contain a block are spoken again (the whole narration when Chunking is the whole article). **Leave code out** skips code blocks. |
 
 **Show tables and figures on screen** (in **Inputs → Cuts and look**, when Describe tables and figures is on) shows each described block in the video while its description is spoken, as the article's picture or a card drawn on your computer at no cost. Turning it on or off renders the video again, and any Shorts that include a card; the narration is kept.

package/dist/tutorials/FAQ.md

@@ -86,7 +86,7 @@ The main output was made, but another step failed, for example the thumbnail. Th
 
 ### I deleted a project by mistake. Can I get it back?
 
-Yes, within 30 days. Open Settings → **Trash** and press **Restore**. See [Trash](Trash).
+Yes, within 30 days. Open Settings → **Backup & storage** → **Trash** and press **Restore**. See [Trash](Trash).
 
 ### Are captions free?