@gentbajko/slopify 3.0.4 → 3.0.6

package/dist/slices/storage/portable.js

@@ -23,8 +23,7 @@ import { appearances, providerById, providerIds } from "../settings/model.js";
 import { listVoices } from "../settings/repo.js";
 import { realPersonVoicesKey, voiceIdMax, voiceNameMax } from "../settings/voices.js";
 import { whatsNewSeenKey } from "../settings/whats-new.js";
-import { studioPlaylistMax } from "../studio/model.js";
-import { studioChannelPlaylistPrefix, studioFillQueuePrefix, studioPairingKey, studioPlaylistKey, studioRealFootageKey, } from "../studio/settings.js";
+import { storedPlaylistsSchema, storedProjectPlaylistsSchema, studioChannelPlaylistPrefix, studioFillQueuePrefix, studioPairingKey, studioPlaylistKey, studioProjectPlaylistsKey, studioRealFootageKey, } from "../studio/settings.js";
 import { channelLinksKey } from "../youtube/edits-repo.js";
 import { defaultBackupsDir, projectDir, stagingPath } from "./layout.js";
 import { stageKinds } from "./model.js";
@@ -354,7 +353,6 @@ const storedAppearance = z.enum(appearances);
 const storedLoudness = z
     .object({ enabled: z.boolean(), videoLufs: z.number(), audioFilesLufs: z.number() })
     .strict();
-const storedPlaylist = z.string().max(studioPlaylistMax);
 // Settings → Channel links, and the providers a fresh Play form starts with.
 // The AI use marks: ticked voices, Image prompts and projects, by id.
 const storedIds = z.array(z.string().max(200)).max(100_000);
@@ -389,7 +387,9 @@ function portableSettings(settings) {
         else if (key === "loudness")
             storedLoudness.parse(parsed);
         else if (key === studioPlaylistKey || key.startsWith(studioChannelPlaylistPrefix))
-            storedPlaylist.parse(parsed);
+            storedPlaylistsSchema.parse(parsed);
+        else if (key === studioProjectPlaylistsKey)
+            storedProjectPlaylistsSchema.parse(parsed);
         else if (key === channelLinksKey)
             storedChannelLinks.parse(parsed);
         else if (key === realPersonVoicesKey ||

package/dist/slices/storage/trim.js

@@ -21,6 +21,8 @@ export const outputRoles = [
     "sources",
     "youtube_description",
     "youtube_tags",
+    "youtube_pinned_comment",
+    "youtube_titles",
     "document_pdf",
     "audio_export",
     "subtitles_srt",

package/dist/slices/studio/pack.js

@@ -17,7 +17,7 @@ import { usesVoices } from "../voices/model.js";
 import { effectiveDescription } from "../youtube/edits-repo.js";
 import { aiDisclosureOf } from "./disclosure.js";
 import { studioAudience, studioTitleMax, } from "./model.js";
-import { readRealFootage, readStudioPlaylist } from "./settings.js";
+import { projectPlaylists, readRealFootage } from "./settings.js";
 // What `shorts.json` holds for each picked clip; only what the pack uses.
 const clipsSchema = z.object({
     shorts: z.array(z.object({
@@ -50,8 +50,10 @@ export function uploadPack(deps, projectId) {
         ? undefined
         : readFileSync(outputPath(deps.paths, projectId, output.path), "utf8").trim();
     const channelId = projectChannelId(deps.db, projectId);
-    // The channel's own playlist, else the default (Settings → YouTube Studio).
-    const playlist = readStudioPlaylist(deps.db, channelId);
+    // The channel's playlists (Settings → YouTube Studio), ticked as this project chose.
+    const playlistChoices = projectPlaylists(deps.db, projectId, channelId);
+    const playlists = playlistChoices.filter((one) => one.chosen).map((one) => one.name);
+    const playlist = playlists[0] ?? null;
     const missing = [];
     // The channel's setting, then what the project narrates and shows (`disclosure.ts`).
     const setting = channelById(deps.db, channelId)?.aiDisclosure ?? "auto";
@@ -84,6 +86,7 @@ export function uploadPack(deps, projectId) {
         : effectiveDescription(deps.db, projectId, {
             description: written,
             tags: writtenTags ?? "",
+            titles: text(outputs.find((output) => output.role === "youtube_titles")),
             // The last chapter is checked against the video's own length when it is known.
             durationSeconds: video?.durationMs === null || video?.durationMs === undefined
                 ? undefined
@@ -107,18 +110,23 @@ export function uploadPack(deps, projectId) {
             : "The thumbnail isn't made yet. Let the Thumbnail stage finish, then open Prepare upload again.");
     else if (thumbnails.length < count)
         missing.push(`Only ${String(thumbnails.length)} of the ${String(count)} thumbnails are made. Regenerate the missing ones in the project's Images section.`);
-    if (playlist === null)
-        missing.push("No playlist is set for this project's channel, so the playlist step is left to you. Set one in Settings → YouTube Studio → Playlist.");
+    if (playlistChoices.length === 0)
+        missing.push("No playlist is set for this project's channel, so the playlist step is left to you. Set one in Settings → YouTube Studio → Playlists.");
     const items = [
         {
             kind: "video",
             video: video === undefined ? null : file(video),
             title: project.title.slice(0, studioTitleMax),
+            titles: (edited?.titles ?? "")
+                .split("\n")
+                .map((one) => one.trim().slice(0, studioTitleMax))
+                .filter((one) => one !== ""),
             description: description ?? "",
             tags: tagsOf(tagsFile),
             thumbnails: thumbnails.map(file),
             audience: studioAudience,
             alteredContent: disclosure("video"),
+            playlists,
             playlist,
             ...(edited?.chapterNotice === undefined ? {} : { chapterNotice: edited.chapterNotice }),
         },
@@ -140,6 +148,7 @@ export function uploadPack(deps, projectId) {
             short: clip.number,
             video: render === undefined ? null : file(render),
             title: clip.title.slice(0, studioTitleMax),
+            titles: [],
             description: [
                 clip.description,
                 fullVideoLine(config.shorts?.fullVideoLink),
@@ -152,6 +161,7 @@ export function uploadPack(deps, projectId) {
             thumbnails: [],
             audience: studioAudience,
             alteredContent: disclosure("short"),
+            playlists,
             playlist,
         });
     }
@@ -162,6 +172,7 @@ export function uploadPack(deps, projectId) {
             projectTitle: project.title,
             items,
             missing,
+            playlistChoices,
             ...(uploadedClips > 0 ? { footage: { clips: uploadedClips, real: realFootage } } : {}),
         },
     };

package/dist/slices/studio/settings.js

@@ -2,7 +2,7 @@ import { randomBytes, timingSafeEqual } from "node:crypto";
 import { z } from "zod";
 import { readSetting, writeSetting } from "../settings/repo.js";
 import { studioPlaylistMax } from "./model.js";
-// Two rows of the key/value `settings` table. The playlist travels with a backup; the
+// Rows of the key/value `settings` table. The playlists travel with a backup; the
 // pairing stays on this machine (`slices/storage/portable.ts`): its token is what lets the
 // browser extension read a project's upload pack.
 export const studioPlaylistKey = "studio.playlist";
@@ -12,23 +12,37 @@ const pairingSchema = z.object({
     origin: z.string().nullable(),
     pairedAt: z.string().nullable(),
 });
-// A channel's own playlist is a row of its own, `studio.playlist.<channelId>`; a channel
-// without one uses the default above.
+// A channel's own playlists are a row of their own, `studio.playlist.<channelId>`; a channel
+// without one uses the default list above. Each playlist is ticked by default or not; a
+// project's Prepare upload can change which it goes into. A row saved before lists existed
+// holds one name, read as one playlist ticked by default.
 export const studioChannelPlaylistPrefix = `${studioPlaylistKey}.`;
 function playlistKey(channelId) {
     return channelId === undefined ? studioPlaylistKey : `${studioChannelPlaylistPrefix}${channelId}`;
 }
-// The playlist an upload pack names: the channel's own, else the default. Without a channel,
-// the default alone.
-export function readStudioPlaylist(db, channelId) {
+// Up to 20 playlists a list: Studio's own dialog shows every playlist of the channel, and a
+// video in more than a handful of them is rare.
+export const studioPlaylistsMax = 20;
+export const studioPlaylistSchema = z.object({
+    name: z.string().trim().min(1).max(studioPlaylistMax),
+    byDefault: z.boolean(),
+});
+// What a row holds: the list, or the one name a row held before lists.
+export const storedPlaylistsSchema = z.union([
+    z.string().max(studioPlaylistMax),
+    z.array(studioPlaylistSchema).max(studioPlaylistsMax),
+]);
+// The playlists a channel's upload packs offer: the channel's own list, else the default.
+// Without a channel, the default alone.
+export function readStudioPlaylists(db, channelId) {
     if (channelId !== undefined) {
-        const own = storedPlaylist(db, playlistKey(channelId));
+        const own = storedPlaylists(db, playlistKey(channelId));
         if (own !== null)
             return own;
     }
-    return storedPlaylist(db, studioPlaylistKey);
+    return storedPlaylists(db, studioPlaylistKey) ?? [];
 }
-// Every channel's own playlist, by channel id.
+// Every channel's own list, by channel id.
 export function readChannelPlaylists(db) {
     const prefix = studioChannelPlaylistPrefix;
     const rows = db
@@ -36,41 +50,92 @@ export function readChannelPlaylists(db) {
         .all(prefix.length, prefix);
     const out = {};
     for (const { key } of rows) {
-        const value = storedPlaylist(db, key);
+        const value = storedPlaylists(db, key);
         if (value !== null)
             out[key.slice(prefix.length)] = value;
     }
     return out;
 }
-function storedPlaylist(db, key) {
+function storedPlaylists(db, key) {
     const stored = readSetting(db, key);
     if (stored === undefined)
         return null;
     try {
-        const value = JSON.parse(stored);
-        return typeof value === "string" && value.trim() !== "" ? value : null;
+        const parsed = storedPlaylistsSchema.safeParse(JSON.parse(stored));
+        if (!parsed.success)
+            return null;
+        if (typeof parsed.data === "string")
+            return parsed.data.trim() === "" ? null : [{ name: parsed.data.trim(), byDefault: true }];
+        return parsed.data.length === 0 ? null : parsed.data;
     }
     catch {
         return null;
     }
 }
-export function studioPlaylistProblem(raw) {
-    return raw.trim().length > studioPlaylistMax
-        ? `The playlist name is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio.`
-        : undefined;
-}
-// Saves the default playlist, or a channel's own; empty clears it (the channel then uses the
-// default again).
-export function saveStudioPlaylist(db, raw, channelId) {
-    const value = raw.trim();
+// Why a list can't be saved, in words for Settings → YouTube Studio; undefined when it can.
+export function studioPlaylistsProblem(list) {
+    const long = list.find((one) => one.name.trim().length > studioPlaylistMax);
+    if (long !== undefined)
+        return `The playlist name "${long.name.slice(0, 40)}…" is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio.`;
+    const seen = new Set();
+    for (const one of list) {
+        const key = one.name.trim().toLowerCase();
+        if (seen.has(key))
+            return `"${one.name.trim()}" is listed twice. Remove one in Settings → YouTube Studio.`;
+        seen.add(key);
+    }
+    return undefined;
+}
+// Saves the default list, or a channel's own; an empty list clears it (the channel then uses
+// the default again). Blank names are dropped.
+export function saveStudioPlaylists(db, list, channelId) {
+    const value = list
+        .map((one) => ({ name: one.name.trim(), byDefault: one.byDefault }))
+        .filter((one) => one.name !== "");
     const key = playlistKey(channelId);
-    if (value === "") {
+    if (value.length === 0) {
         db.prepare("DELETE FROM settings WHERE key = ?").run(key);
-        return null;
+        return [];
     }
     writeSetting(db, key, JSON.stringify(value));
     return value;
 }
+// The playlists a project's uploads go into, when its Prepare upload changed them from the
+// channel's defaults: one row, project id to names.
+export const studioProjectPlaylistsKey = "studio.projectPlaylists";
+export const storedProjectPlaylistsSchema = z.record(z.string().max(64), z.array(z.string().max(studioPlaylistMax)).max(studioPlaylistsMax));
+function projectChoices(db) {
+    const stored = readSetting(db, studioProjectPlaylistsKey);
+    if (stored === undefined)
+        return {};
+    try {
+        const parsed = storedProjectPlaylistsSchema.safeParse(JSON.parse(stored));
+        return parsed.success ? parsed.data : {};
+    }
+    catch {
+        return {};
+    }
+}
+// The channel's playlists, each ticked as this project goes into it: the project's own choice
+// when it made one (a playlist the channel no longer lists is dropped), else the defaults.
+export function projectPlaylists(db, projectId, channelId) {
+    const list = readStudioPlaylists(db, channelId);
+    const own = projectChoices(db)[projectId];
+    return list.map((one) => ({
+        name: one.name,
+        chosen: own === undefined
+            ? one.byDefault
+            : own.some((name) => name.toLowerCase() === one.name.toLowerCase()),
+    }));
+}
+export function saveProjectPlaylists(db, projectId, names) {
+    const { [projectId]: _previous, ...others } = projectChoices(db);
+    const next = names === null ? others : { ...others, [projectId]: [...names] };
+    if (Object.keys(next).length === 0)
+        db.prepare("DELETE FROM settings WHERE key = ?").run(studioProjectPlaylistsKey);
+    else
+        writeSetting(db, studioProjectPlaylistsKey, JSON.stringify(next));
+}
 // The projects whose uploaded clips are real footage (filmed, not generated): ticked in the
 // project's Prepare upload, under AI use. One row holding their ids; YouTube's second AI use
 // case is footage of a real event or place altered by AI (`disclosure.ts`).

package/dist/slices/youtube/answer.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { descriptionMaxCharacters, hashtagsMax, minChapterSeconds, minChapters, tagMaxCharacters, tagsMaxCharacters, } from "./model.js";
+import { alternativeTitles, descriptionMaxCharacters, hashtagsMax, minChapterSeconds, minChapters, pinnedCommentMaxCharacters, tagMaxCharacters, tagsMaxCharacters, titleMaxCharacters, } from "./model.js";
 import { parseTimestamp, youtubeTimestamp } from "./timestamps.js";
 export function descriptionMessages(brief) {
     const end = youtubeTimestamp(brief.durationSeconds);
@@ -8,7 +8,7 @@ export function descriptionMessages(brief) {
             role: "system",
             content: [
                 "You write YouTube descriptions. Answer with one JSON object and nothing else, in this shape:",
-                '{"summary": "...", "chapters": [{"start": "0:00", "title": "..."}], "hashtags": ["#Example"], "tags": ["example tag"]}',
+                '{"summary": "...", "chapters": [{"start": "0:00", "title": "..."}], "hashtags": ["#Example"], "tags": ["example tag"], "pinnedComment": "...", "titles": ["...", "..."]}',
                 "",
                 "Rules YouTube enforces, which the answer must follow:",
                 '- The first chapter starts at exactly "0:00".',
@@ -20,6 +20,11 @@ export function descriptionMessages(brief) {
                 `- Tags are plain search terms without # or commas, each at most ${String(tagMaxCharacters)} characters, no tag repeated, and all tags together at most ${String(tagsMaxCharacters)} characters.`,
                 "- No < or > anywhere.",
                 "- The summary is plain text without chapters, hashtags or links.",
+                `- The pinned comment is plain text without links, at most ${String(pinnedCommentMaxCharacters)} characters.`,
+                `- Titles are exactly ${String(alternativeTitles)} other titles for this video, for YouTube's title A/B test beside the video's own title: each at most ${String(titleMaxCharacters)} characters, one line, different from the video title and from each other.`,
+                "",
+                "The pinned comment is what the channel pins under the video, unless the instructions below say otherwise: thank the viewer in one line, ask one question a viewer can answer from their own experience of the subject, point to the chapters in the description, and end by inviting a suggestion for the next video. Two to four short paragraphs, in the same voice as the summary.",
+                "The other titles try different angles on the same video (a question, a stake, a surprising fact) while staying true to it and in the video title's language and tone.",
             ].join("\n"),
         },
         {
@@ -42,16 +47,20 @@ const answerSchema = z.object({
     chapters: z.array(z.object({ start: z.union([z.string(), z.number()]), title: z.string() })),
     hashtags: z.array(z.string()),
     tags: z.array(z.string()),
+    pinnedComment: z.string(),
+    titles: z.array(z.string()),
 });
 const fix = "Try again, or choose another model in Edit project → Providers.";
 // Reads and checks the model's answer. The reason is the sentence the stage shows; the
 // provider wrapper's `check` asks the model again while attempts remain.
-export function checkDescriptionAnswer(text, durationSeconds) {
+export function checkDescriptionAnswer(text, durationSeconds, 
+// The video's own title, which the other titles must differ from.
+title = "") {
     const parsed = answerSchema.safeParse(jsonOf(text));
     if (!parsed.success)
         return {
             ok: false,
-            reason: `The AI model's YouTube description didn't come back in the expected format (a JSON object with a summary, chapters, hashtags and tags). ${fix}`,
+            reason: `The AI model's YouTube description didn't come back in the expected format (a JSON object with a summary, chapters, hashtags, tags, a pinned comment and titles). ${fix}`,
         };
     const summary = parsed.data.summary.trim();
     if (summary === "")
@@ -65,7 +74,25 @@ export function checkDescriptionAnswer(text, durationSeconds) {
     const tags = checkTags(parsed.data.tags);
     if (!tags.ok)
         return tags;
-    const value = { summary, chapters: chapters.value, hashtags: hashtags.value, tags: tags.value };
+    const pinnedComment = parsed.data.pinnedComment.trim();
+    if (pinnedComment === "")
+        return { ok: false, reason: `The AI model wrote no pinned comment. ${fix}` };
+    if (pinnedComment.length > pinnedCommentMaxCharacters)
+        return {
+            ok: false,
+            reason: `The AI model's pinned comment is ${String(pinnedComment.length)} characters, over the ${String(pinnedCommentMaxCharacters)} Slopify allows. ${fix}`,
+        };
+    const titles = checkTitles(parsed.data.titles, title);
+    if (!titles.ok)
+        return titles;
+    const value = {
+        titles: titles.value,
+        summary,
+        chapters: chapters.value,
+        hashtags: hashtags.value,
+        tags: tags.value,
+        pinnedComment,
+    };
     const description = assembleDescription(value);
     if (/[<>]/.test(description))
         return {
@@ -139,6 +166,28 @@ function checkChapters(raw, durationSeconds) {
     }
     return { ok: true, value: chapters };
 }
+function checkTitles(raw, title) {
+    const broke = (rule) => ({
+        ok: false,
+        reason: `The AI model's other titles broke YouTube's rules (${rule}). ${fix}`,
+    });
+    const titles = raw.map((one) => one.trim().replace(/\s+/g, " ")).filter((one) => one !== "");
+    if (titles.length !== alternativeTitles)
+        return broke(`there must be ${String(alternativeTitles)} other titles, and it wrote ${String(titles.length)}`);
+    const long = titles.find((one) => one.length > titleMaxCharacters);
+    if (long !== undefined)
+        return broke(`"${long.slice(0, 40)}…" is over ${String(titleMaxCharacters)} characters`);
+    const odd = titles.find((one) => /[<>]/.test(one));
+    if (odd !== undefined)
+        return broke(`"${odd}" contains < or >`);
+    const seen = new Set([title.trim().toLowerCase()]);
+    for (const one of titles) {
+        if (seen.has(one.toLowerCase()))
+            return broke(`"${one}" repeats a title`);
+        seen.add(one.toLowerCase());
+    }
+    return { ok: true, value: titles };
+}
 function checkHashtags(raw) {
     const broke = (rule) => ({
         ok: false,

package/dist/slices/youtube/edits-repo.js

@@ -63,7 +63,8 @@ export function readChannelLinksFor(db, channelId) {
         return channel.brand.links;
     return channel.id === defaultChannelId ? readChannelLinks(db) : [];
 }
-// The description and tags as the project page shows and copies them: the user's edits over
+// The description, tags, pinned comment and other titles as the project page shows and copies
+// them: the user's edits over
 // the generated text, the chapters fitted to YouTube's rules (`chapters.ts`; the last one's
 // length only checked when the video's length is given), placeholders filled from the
 // project's and its channel's links (one with no link stays as typed). For anything that hands
@@ -71,7 +72,10 @@ export function readChannelLinksFor(db, channelId) {
 // fitting changed.
 export function effectiveDescription(db, projectId, generated) {
     const edits = readDescriptionEdits(db, projectId);
-    const shown = shownFields(resolveFields(splitDescription(generated.description, generated.tags), edits.fields));
+    const shown = shownFields(resolveFields(splitDescription(generated.description, generated.tags, {
+        pinnedComment: generated.pinnedComment,
+        titles: generated.titles,
+    }), edits.fields));
     const fitted = fitChapters(shown.chapters, generated.durationSeconds);
     const notice = chapterNotice(fitted.adjustments);
     const links = mergeLinks(readChannelLinksFor(db, projectChannelId(db, projectId)), edits.links);
@@ -79,6 +83,8 @@ export function effectiveDescription(db, projectId, generated) {
         description: fillPlaceholders(composeDescription({ ...shown, chapters: fitted.text }), links)
             .text,
         tags: fillPlaceholders(shown.tags, links).text,
+        pinnedComment: fillPlaceholders(shown.pinnedComment, links).text,
+        titles: shown.titles,
         ...(notice === undefined ? {} : { chapterNotice: notice }),
     };
 }

package/dist/slices/youtube/edits.js

@@ -1,14 +1,22 @@
 // Hand edits to the YouTube description. The project page lets the user edit the summary,
-// the chapters, the hashtags and the tags in place; each edit is saved with the generated
+// the chapters, the hashtags, the tags and the pinned comment in place; each edit is saved with the generated
 // text it was made from (`base`), so when the description is written again the page can tell
 // a field the user changed from one they left alone. Browser-safe: the project page applies
 // these rules to what it shows, and the server only stores the edits.
 import { parseTimestamp } from "./timestamps.js";
-export const descriptionFields = ["summary", "chapters", "hashtags", "tags"];
-// Splits a written description back into its three parts. `assembleDescription` (answer.ts) lays it out as
+export const descriptionFields = [
+    "summary",
+    "chapters",
+    "hashtags",
+    "tags",
+    "pinnedComment",
+    "titles",
+];
+// Splits a written description back into its three parts, beside the tags, the pinned comment
+// and the other titles (each empty for a description written before it existed). `assembleDescription` (answer.ts) lays it out as
 // the summary, a blank line, one chapter per line, a blank line and the hashtags; reading it
 // from the end keeps a summary with blank lines of its own whole.
-export function splitDescription(description, tags) {
+export function splitDescription(description, tags, extras = {}) {
     const lines = description.replace(/\r\n?/gu, "\n").split("\n");
     while (lines.length > 0 && lines.at(-1)?.trim() === "")
         lines.pop();
@@ -29,6 +37,8 @@ export function splitDescription(description, tags) {
         chapters: chapters.join("\n"),
         hashtags,
         tags: tags.trim(),
+        pinnedComment: (extras.pinnedComment ?? "").trim(),
+        titles: (extras.titles ?? "").trim(),
     };
 }
 function isChapterLine(line) {
@@ -65,6 +75,8 @@ export function resolveFields(generated, edits) {
         chapters: one("chapters"),
         hashtags: one("hashtags"),
         tags: one("tags"),
+        pinnedComment: one("pinnedComment"),
+        titles: one("titles"),
     };
 }
 export function shownFields(resolved) {
@@ -73,6 +85,8 @@ export function shownFields(resolved) {
         chapters: resolved.chapters.text,
         hashtags: resolved.hashtags.text,
         tags: resolved.tags.text,
+        pinnedComment: resolved.pinnedComment.text,
+        titles: resolved.titles.text,
     };
 }
 // Saving an edit: text equal to the generated text is no edit at all, so the field follows the

package/dist/slices/youtube/model.js

@@ -1,5 +1,6 @@
 // The optional YouTube description step of the Video stage: a short summary, a chapter list
-// YouTube turns into chapters, hashtags, and a separate list for YouTube's Tags field.
+// YouTube turns into chapters, hashtags, a separate list for YouTube's Tags field, a comment
+// to pin under the video, and two more titles for YouTube's title A/B test.
 // Browser-safe: Play, Edit project and the project page read these names and limits too.
 // YouTube's own rules for chapters in a description: the first starts at 0:00, there are at
 // least three, and each lasts at least ten seconds.
@@ -12,6 +13,12 @@ export const tagMaxCharacters = 100;
 export const hashtagsMax = 15;
 // 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
+// these alternatives. YouTube's limit on a title.
+export const alternativeTitles = 2;
+export const titleMaxCharacters = 100;
+// YouTube's limit on a comment is 10,000; a pinned comment people read in full is far shorter.
+export const pinnedCommentMaxCharacters = 1500;
 // What a project uses when no Description prompt from the library is picked. No keywords,
 // so it never asks Play for a field.
 export const defaultDescriptionPrompt = [

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 end to end`. 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 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.
 
 ## After a run: the Run cost tab
 
@@ -65,7 +65,7 @@ If nothing has been spent yet, it says "Nothing has been spent yet. The cost of
 | **paid to providers** | The total cost of this project's calls. Reads "known cost, paid to providers" when some calls have no price, with a line "Plus N calls the model catalogue has no price for." |
 | **same work via API** | The API equivalent of the calls that ran on a CLI plan. |
 | Plan meters | One per plan window a CLI reported, for example "3% of weekly Codex limit". Hover or read the line below for the level it is at now. |
-| **end to end** | How long the whole run took. |
+| **this run's working time** | How long some step of the run was working. Waiting on a review, a limit or a pause never counts, and steps that ran side by side count once. Each save that remakes something starts a new run. |
 
 Lines under the summary:
 
@@ -89,7 +89,7 @@ Lines under the summary:
 
 **Cost by model**: the same spending split by provider and model, with **Cost**, **Via API**, **Usage** and **Calls**. A CLI model shows the API model it was priced as, in brackets after "as". The CLI's own default model shows as "default model".
 
-The last lines give the total usage and stage time, and "Priced from the model catalogue of <date> when each call finished."
+The last lines give the total usage and the working time over every run, and "Priced from the model catalogue of <date> when each call finished."
 
 ## Across all projects: Home → This week
 

package/dist/tutorials/Project-Page.md

@@ -20,7 +20,7 @@ The page opens where the next action points: the failed step, the held review or
 
 ### The run cost line
 
-When a run has ended (done, done with problems, failed or cancelled), a line under the title sums it up, for example `This run cost $0.42 · ~$3.10 via API · 12 min end to end`. A run that ended early says **Spent so far** instead, and calls without a known price add "plus unpriced calls". **See cost by stage** opens the **Cost** section. The line is hidden while the run is going and when it spent nothing. See [Costs and Run Cost](Costs-and-Run-Cost).
+When a run has ended (done, done with problems, failed or cancelled), a line under the title sums it up, for example `This run cost $0.42 · ~$3.10 via API · 12 min of work`: only the time Slopify was working, never the time waiting on you, a review or a limit. A run that ended early says **Spent so far** instead, and calls without a known price add "plus unpriced calls". **See cost by stage** opens the **Cost** section. The line is hidden while the run is going and when it spent nothing. While the run is going, a clock sits there instead: `Working for 9 min 30 s`, ticking while a step runs; while it is paused or waits on you it holds still and reads `9 min 30 s of work so far`. See [Costs and Run Cost](Costs-and-Run-Cost).
 
 ### Time left
 

package/dist/tutorials/Publishing-to-YouTube.md

@@ -2,11 +2,11 @@
 
 Slopify never uploads or publishes for you: there is no YouTube sign-in and no upload API. Instead, **Prepare upload** lists everything YouTube Studio asks for, in the order it asks, with a Copy button for each value, for the long video and for every short. You upload in Studio in your own browser and press Publish yourself. The optional [Studio-Extension](Studio-Extension) can fill Studio's upload dialog from the same list.
 
-**Where to find it:** a finished project → **Prepare upload** (the next action, and in the **YouTube** section), Home → **Ready to upload** → **Prepare upload**, or the Calendar's **Needs you** → **Prepare upload**. Settings → **YouTube Studio** holds the playlist, and each channel's **Brand** tab holds the links it uses.
+**Where to find it:** a finished project → **Prepare upload** (the next action, and in the **YouTube** section), Home → **Ready to upload** → **Prepare upload**, or the Calendar's **Needs you** → **Prepare upload**. Settings → **YouTube Studio** holds the playlists, and each channel's **Brand** tab holds the links it uses.
 
 ## Before your first upload
 
-1. Open **Settings → YouTube Studio** and type your **Playlist** name exactly as it is called in Studio (up to 150 characters), then press **Save**. It is the default for every channel; pick a channel in the list above the field to give that channel its own playlist. Leave it empty for no playlist.
+1. Open **Settings → YouTube Studio**, press **Add playlist** and type each playlist exactly as it is called in Studio (up to 150 characters). Tick **On by default** for the ones every video goes into, then press **Save playlists**. The list is the default for every channel; pick a channel above it to give that channel its own list.
 2. Open **Channels** → your channel → **Brand** and, under **Channel links**, add any links your descriptions use, such as `Patreon` or `Discord`. See [Channels](Channels#channel-links).
 3. In **Settings → Voices**, turn on **Real person** for any voice cloned from, or made to sound like, a real person.
 4. In **Library → Prompts**, turn on **Draws photorealistic pictures** for any Image prompt whose style looks like real photos or film.
@@ -27,7 +27,7 @@ Steps 3 and 4 decide the AI use answer; see [AI use disclosure](#ai-use-disclosu
 | **Title** | The project's title (up to 100 characters), or the short's title. **Copy**. |
 | **Description** | The description with chapters and hashtags, links filled in. For a short: its description, the "Watch the full video:" line and its hashtags. **Copy**. |
 | **Thumbnail** | The thumbnail file, with **Open folder**. With three thumbnails: "The first under Thumbnail; all 3 in A/B Testing (beside the title)." Shorts have no thumbnail step, since Studio shows a frame of a short. |
-| **Playlist** | The project's channel's playlist from Settings → YouTube Studio (or the default one), or "None set". **Copy**. |
+| **Playlist** | The project's channel's playlists from Settings → YouTube Studio (or the default list), or "None set". With more than one, each has a tick: tick the ones this project goes into (saved for this project; the others keep the defaults). **Copy**. |
 | **Audience** | "No, it's not made for kids". |
 | **AI use (under Show more)** | **Yes** or **No**, with the reason. |
 | **Tags (under Show more)** | The tags, comma-separated. For a short, its hashtags without the `#`. **Copy**. |
@@ -119,7 +119,7 @@ Slopify does not check YouTube, so it can't know when you've published. After yo
 
 ## Tips
 
-- Set the playlist once in Settings (per channel if your channels upload to different playlists); every upload pack names it.
+- Set the playlists once in Settings (per channel if your channels upload to different playlists), and tick the few a single video joins in its Prepare upload.
 - Upload the long video first, then paste its link as the shorts' **Full video link** so each short's description points to it.
 - If the AI use answer surprises you, read its reason: it names the voice, footage or prompt that made it Yes.
 

package/dist/tutorials/Settings-Reference.md

@@ -15,7 +15,7 @@ Every section of Settings, what each control does and its default. Sections with
 | [Playback & appearance](#playback--appearance) | Silence gap, light or dark, volume levelling | This page |
 | [Notifications](#notifications) | Browser and phone notifications | [Notifications](Notifications) |
 | [Channel links](#channel-links) | A pointer to each channel's own links | [Channels](Channels#channel-links) |
-| [YouTube Studio](#youtube-studio) | Playlist per channel, the Studio extension's download and pairing | [Studio-Extension](Studio-Extension) |
+| [YouTube Studio](#youtube-studio) | Playlists per channel, the Studio extension's download and pairing | [Studio-Extension](Studio-Extension) |
 | [Backup & storage](#backup--storage) | Your files folder, export and import, disk space, samples | [Where-Your-Files-Live](Where-Your-Files-Live) |
 | [Backups](#backups) | The daily automatic backup | [Backups](Backups) |
 | [Trash](#trash) | Deleted items, kept 30 days | [Trash](Trash) |
@@ -140,12 +140,12 @@ Each channel now keeps its own links, on its **Brand** tab under **Channel links
 
 ## YouTube Studio
 
-"The playlist upload packs name, and the Studio extension's pairing."
+"The playlists upload packs offer, and the Studio extension's pairing."
 
 | Control | What it does | Default / limit |
 |---|---|---|
 | **Upload pack and extension** | Explains that Slopify never uploads or publishes: **Prepare upload** on a finished project lists everything Studio asks for, and the optional extension fills Studio's upload dialog from it. | |
-| **Playlist** | The YouTube playlist upload packs name, typed exactly as it is called in Studio. Pick **Every channel (default)** or one channel first: the default is used by every channel without its own. **Save** stores it. Empty means no playlist (or, for a channel, the default). | Empty; up to 150 characters |
+| **Playlists** | The YouTube playlists upload packs offer, each typed exactly as it is called in Studio. Pick **Every channel (default)** or one channel first: the default list is used by every channel without its own. **Add playlist** adds a row; **On by default** puts every project into it; **Remove** drops it; **Save playlists** stores the list. A project's **Prepare upload** changes which ones it goes into. | None; up to 20, each up to 150 characters |
 | **Extension pairing token** | A secret the Slopify Studio extension needs before it may read your upload packs. **Copy** it into the extension's options and press Pair there. | |
 | **New pairing token** | Makes a fresh token, unpairs the extension until you paste the new one, and clears the uploads waiting for Studio. | |
 | **Install the Studio extension** | **Chrome, Edge, Brave** or **Firefox**, then **Download for Chrome** or **Download for Firefox**, with the three install steps. | |

package/dist/tutorials/Studio-Extension.md

@@ -58,7 +58,7 @@ The section is headed **Upload pack and extension**.
 
 | Option | What it does | Default / range |
 |---|---|---|
-| **Playlist** | The YouTube playlist upload packs name, so the extension ticks it in Studio's dialog. Pick **Every channel (default)** or one channel in the channel list, type the playlist exactly as it is called in Studio, and press **Save**. The default is used by every channel without its own; a channel's own playlist wins for its videos. Leave it empty for no playlist. | Empty; up to 150 characters |
+| **Playlists** | The YouTube playlists upload packs offer, so the extension ticks them in Studio's dialog. Pick **Every channel (default)** or one channel, **Add playlist** for each, type it exactly as it is called in Studio, tick **On by default** for the ones every video joins, and press **Save playlists**. A channel's own list wins for its videos; Prepare upload changes the ticks for one project. | None; up to 20, each up to 150 characters |
 | **Extension pairing token** | The secret the extension needs before it may read your upload packs. **Copy** copies it; **New pairing token** makes a new one and unpairs the extension. | Made for you |
 | **Install the Studio extension** | The download and install steps (see [Get the extension](#get-the-extension)). | |
 
@@ -89,7 +89,7 @@ Each press of **Fill in YouTube Studio** adds the item to **Waiting for Studio**
 | **Title** | Types the title (up to 100 characters for the video, the short's own title for a short). |
 | **Description** | Types the description line by line, so line breaks are kept. |
 | **Thumbnail** | Sets the first thumbnail. With three thumbnails, it looks for Studio's **A/B Testing** button beside the title and puts all three in. If the button isn't there or its dialog can't be filled, it sets the first and asks you to add the others in A/B Testing by hand. Shorts get no thumbnail. |
-| **Playlists** | Opens the dropdown, ticks the playlist named in Settings → YouTube Studio, and closes it. |
+| **Playlists** | Opens the dropdown, ticks every playlist the project goes into (Settings → YouTube Studio, and the project's own ticks in Prepare upload), and closes it. |
 | **Audience** | Picks "No, it's not made for kids". |
 | **Show more** | Presses it once, to reach the advanced settings. |
 | **AI use** | Picks Yes or No, as Prepare upload worked it out. See [AI use disclosure](Publishing-to-YouTube#ai-use-disclosure). |