@gentbajko/slopify 4.1.0 → 4.2.0

package/dist/slices/narration/pronunciations-library.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { fingerprint } from "../../kernel/runner/work.js";
+import { actors } from "../agents/model.js";
+import { deleteSetting, readJsonSetting, readSetting, writeSetting } from "../settings/repo.js";
+import { libraryPronunciationsMax, parsePronunciationGlossary, } from "./pronunciation.js";
+// Settings → Voices → Name pronunciations: one Pronunciation Glossary of your own, in the same
+// `Term: /ipa/` lines an article's own glossary uses. Its entries come before the article's, so
+// a name keeps the same pronunciation in every video however each article spells it out. A
+// project takes a copy when it starts (and again when Edit project refreshes it), so a change
+// here never alters a project's narration behind its back. Aliases on the Pronunciation page are
+// the other half: they change the words, this changes the sounds.
+export const libraryPronunciationsKey = "narration.pronunciations";
+const savedKey = "narration.pronunciations.saved";
+const savedRow = z
+    .object({ at: z.string().min(1).max(40), by: z.enum(actors) })
+    .strict()
+    .readonly();
+export function readLibraryPronunciations(db) {
+    const saved = readJsonSetting(db, savedKey, savedRow, undefined);
+    return {
+        ...describeLibraryPronunciations(readSetting(db, libraryPronunciationsKey) ?? ""),
+        ...(saved === undefined ? {} : { savedAt: saved.at, savedBy: saved.by }),
+    };
+}
+export function describeLibraryPronunciations(text) {
+    const parsed = parsePronunciationGlossary(text);
+    return {
+        text,
+        terms: parsed.ok ? parsed.entries.length : 0,
+        version: versionOf(text),
+        ...(parsed.ok && parsed.skipped !== undefined ? { skipped: parsed.skipped } : {}),
+        ...(parsed.ok && parsed.unpronounced !== undefined
+            ? { unpronounced: parsed.unpronounced }
+            : {}),
+    };
+}
+// Short enough to pass around and read in a refusal, long enough never to collide.
+export function versionOf(text) {
+    return fingerprint({ pronunciations: text.trim() }).slice(0, 16);
+}
+// `version` is the list the save was made from. It is required once a list exists: a save
+// without it, or from an older one, is refused rather than replacing what somebody else wrote
+// in another window or through an agent.
+export function saveLibraryPronunciations(deps, text, version, by = "person") {
+    if (typeof text !== "string")
+        return {
+            ok: false,
+            reason: "refused",
+            detail: "Write the list as Term: /ipa/ lines, one name per line.",
+        };
+    if (text.length > libraryPronunciationsMax)
+        return {
+            ok: false,
+            reason: "refused",
+            detail: `Keep the list under ${String(libraryPronunciationsMax)} characters; it is ${String(text.length)} now. Remove the names you no longer narrate, then Save.`,
+        };
+    const current = readLibraryPronunciations(deps.db);
+    if (current.text !== "" && version !== current.version)
+        return {
+            ok: false,
+            reason: "conflict",
+            detail: conflictDetail(current, version),
+            current,
+        };
+    const trimmed = text.trim();
+    if (trimmed === "")
+        deleteSetting(deps.db, libraryPronunciationsKey);
+    else
+        writeSetting(deps.db, libraryPronunciationsKey, trimmed);
+    writeSetting(deps.db, savedKey, JSON.stringify({ at: deps.clock.now().toISOString(), by }));
+    return { ok: true, list: readLibraryPronunciations(deps.db) };
+}
+// Said to whoever sent the save: the person at the page, or an agent reading a refusal. It
+// names what the list is now and the one step that keeps their own work.
+function conflictDetail(current, version) {
+    const who = current.savedBy === "agent"
+        ? " by an agent"
+        : current.savedBy === "assistant"
+            ? " by the assistant"
+            : "";
+    const when = current.savedAt === undefined ? "" : ` at ${current.savedAt}`;
+    const names = `${String(current.terms)} ${current.terms === 1 ? "name" : "names"}`;
+    return version === undefined
+        ? `The list has ${names} already, saved${who}${when}. Read it first and send your save with the version it gives, so this one does not replace what is there.`
+        : `The list changed since this save was prepared: it has ${names} now, saved${who}${when}. Read it again and save with the version it gives; on the page, Save mine anyway keeps what is on screen.`;
+}
+// The entries a project's copy pronounces, under the project's own language and rules. An
+// unparseable list is never fatal: its bad rows are skipped, and the editor is where they are
+// named (the run's notices number the rows of the article's glossary, not of this list).
+export function libraryGlossary(text, language, rules) {
+    if (text === undefined || text.trim() === "")
+        return { ok: true, entries: [] };
+    return parsePronunciationGlossary(text, language, rules);
+}

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

@@ -12,6 +12,7 @@ import { splitEndMatter } from "../article/split.js";
 import { withEarlierEpisodes } from "../episodes/related.js";
 import { withoutSlopifyScene } from "../images/scenes.js";
 import { parsePronunciationGlossary, pronunciationRulesOf, } from "../narration/pronunciation.js";
+import { libraryGlossary } from "../narration/pronunciations-library.js";
 import { withSharedGlossary } from "../narration/shared-glossary.js";
 import { researchDocuments } from "../research/documents.js";
 import { plannerMessages, subAgentMessages } from "../research/planner.js";
@@ -333,12 +334,23 @@ export function narrationGlossary(context) {
     const markdown = articleMarkdownOf(context);
     return glossaryOf(context, markdown === null ? null : splitEndMatter(markdown));
 }
-// The project's own glossary, then the other projects' pronunciations it copied, when it
-// shares them. Rows the own glossary had to skip are still reported.
+// Your own pronunciation list first, then the project's own glossary, then the other projects'
+// pronunciations it copied, when it shares them. The list wins so a name is said the same way in
+// every video however this article spelled it out. Rows the own glossary had to skip are still
+// reported; rows the list had to skip are named in its editor, where they can be fixed.
 function withShared(own, config) {
-    if (!own.ok || config.audio?.shareGlossary !== true)
+    if (!own.ok)
         return own;
-    return { ...own, entries: withSharedGlossary(own.entries, config.sharedGlossary) };
+    const list = libraryGlossary(config.libraryPronunciations, config.language, pronunciationRulesOf(config));
+    const shared = config.audio?.shareGlossary === true ? config.sharedGlossary : undefined;
+    if (!list.ok)
+        return list;
+    if (list.entries.length === 0 && shared === undefined)
+        return own;
+    return {
+        ...own,
+        entries: withSharedGlossary(list.entries, withSharedGlossary(own.entries, shared)),
+    };
 }
 function withSampleScope(prompt, sample) {
     return sample === undefined || sample.fullScript

package/dist/tutorials/Create-Narration.md

@@ -83,7 +83,7 @@ It needs the Inworld TTS-2 model. With several speakers it works per speaker: ea
 
 | Option | What it does | Default |
 | --- | --- | --- |
-| **Use the article's pronunciation glossary** | Shown only for voices that read it. Reads names with the IPA in the article's Pronunciation Glossary, such as `Arda: /ˈɑɹdə/`, with no extra AI call. Works with Inworld TTS-2 and TTS-2 Flash. The written text stays unchanged. | On |
+| **Use pronunciations** | Shown only for voices that read IPA. Reads names with the IPA they are given, with no extra AI call: your **Name pronunciations** list first, so a listed name sounds the same in every video, then the article's own Pronunciation Glossary, such as `Arda: /ˈɑɹdə/`. Works with Inworld TTS-2 and TTS-2 Flash. The written text stays unchanged. | On |
 | **Also use pronunciations from my other projects** | Adds every term from your other projects' glossaries, copied when this project starts. This project's own glossary wins where they differ. Turn it off to use only this article's glossary. | On |
 
 With another service or model the tick is not shown; your choice is kept for when you pick an Inworld TTS-2 voice.

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

@@ -62,6 +62,7 @@ When the narration was spoken as one whole request, the section says so: editing
 
 | Control | What it does |
 | --- | --- |
+| **Use pronunciations** → **Copy the list again** | Copies your **Name pronunciations** (Settings → Voices) into this project again, so a name you corrected there is said the new way here too. A change to the list reaches the project only when you press this. After you save, only the chunks where a changed name appears are spoken again, paid per character. |
 | **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 your pronunciation list** → **Copy the list again** | Copies your Pronunciation list (Settings → Voices → **Pronunciation**) into this project again. A change to the list 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 AI writes a short spoken passage for each table, figure, equation and code block. Turning it on costs one AI call per block, and after you save the chunks that contain a block are spoken again (the whole narration when it is spoken as one request). **Leave code out** skips code blocks. |

package/dist/tutorials/Narration-Aliases-and-Glossary.md

@@ -1,8 +1,55 @@
 # Narration Aliases and Glossary
 
-Two tools control how the narrator says words without changing what is written. **Narration aliases** swap a written form for a spoken one, such as `Dr.` said as "Doctor", with any generated voice. The **Pronunciation Glossary** gives exact IPA pronunciations for names, such as `Arda: /ˈɑɹdə/`, with Inworld's TTS-2 voices. In both cases the article, the transcript and the captions keep the written words; only the audio changes.
+Three tools control how the narrator says words without changing what is written. **Name pronunciations** is your own list of names with their IPA, used before anything an article says, so a name sounds the same in every video. **Narration aliases** swap a written form for a spoken one, such as `Dr.` said as "Doctor", with any generated voice. The **Pronunciation Glossary** is the list each article writes for itself, such as `Arda: /ˈɑɹdə/`. IPA is read by Inworld's TTS-2 voices; aliases work with every voice. In all three the article, the transcript and the captions keep the written words; only the audio changes.
 
-**Where to find it:** aliases in **Settings → Voices → Pronunciation**. Both switches are on Create under **Narration → Change → More narration settings**, and in a project's **Edit settings** → **Narration**. A project's glossary is shown on its **Article** section, in the **Pronunciation** tab.
+**Where to find it:** your list in **Settings → Voices → Name pronunciations**, aliases in **Settings → Voices → Pronunciation**. The switches are on Create under **Narration → Change → More narration settings**, and in a project's **Edit settings** → **Narration**. A project's own glossary is shown on its **Article** section, in the **Pronunciation** tab.
+
+## Name pronunciations
+
+Your list settles a name once. Every project copies it when it starts, and its entries come **before** the glossary that project's article wrote, so the name is said your way whatever the article spelled out.
+
+1. Open **Settings → Voices → Name pronunciations**.
+2. Write one `Term: /IPA/` per line, in standard-English IPA between slashes:
+
+```
+Gygax: /ˈɡaɪɡæks/
+Faerûn: /feɪˈruːn/
+Mordenkainen: /ˌmɔːrdənˈkeɪnən/
+```
+
+3. Press **Save pronunciations**. The line under the box says how many names the list pronounces, and a note names any line narration has to skip, by its number and reason, the way the article's glossary does.
+
+- One IPA word per written word. A hyphenated name's parts each get one.
+- A possessive follows its name: `Gygax's` is said from the `Gygax` entry.
+- A dash, `n/a` or nothing leaves the name read as written: useful for a name you want plain.
+- Up to 100,000 characters, which is thousands of names.
+- Only Inworld **TTS-2** and **TTS-2 Flash** read IPA. For any other voice, use an alias instead.
+- **Use pronunciations** must be on for the project (the default) — the same switch that reads the article's glossary.
+
+A project keeps the copy it started with. Editing the list later changes new projects only, until you open a project's **Edit settings** → **Narration** and press **Copy the list again** under **Use pronunciations**; only the narration where a changed name appears is made again.
+
+### Two people, or an agent, at the same list
+
+The whole list is saved at once, so Slopify makes sure one save never quietly replaces another. Every save carries the version of the list it was made from. If something else saved meanwhile — a second window, or an agent — the save is refused and the page says so:
+
+> **The list changed somewhere else.** An agent saved it: it has 3 names you don't have, 1 said differently.
+
+Nothing is lost. What you typed stays in the box, and you choose:
+
+- **Save mine anyway** keeps what is on screen, over theirs.
+- **Load theirs instead** puts their list in the box, so you can add your change to it and save.
+
+An agent gets the same refusal as a sentence, with the list as it stands: it reads the version, folds its change into that text, and saves again (`get_library_pronunciations`, then `set_library_pronunciations` with `{text, version}`).
+
+### Which list wins
+
+| Where a pronunciation comes from | Order |
+|---|---|
+| **Name pronunciations** (your list) | First: it wins everywhere |
+| The article's own **Pronunciation Glossary** | Next, for names your list does not have |
+| **Other projects' pronunciations**, while shared | Last, for names neither of the above has |
+
+An alias beats all three, because it changes the words before the sounds are decided.
 
 ## Narration aliases
 
@@ -39,7 +86,7 @@ Each row's title line sums it up, for example "Says Dr. as Doctor · whole word"
 - Two aliases can't share a written form.
 - Where two overlap in the text, the one starting first wins, then the longer.
 - A multi-word alias is read with single spaces around it: "Grey et al. wrote" goes to the voice as "Grey and others wrote".
-- An alias wins over a Pronunciation Glossary entry for the same words.
+- An alias wins over a Name pronunciations entry and a Pronunciation Glossary entry for the same words.
 - Aliases work with every generated voice, and in multi-voice runs they apply to each speaker's turn.
 - Aliases also change the sentences **Narration preparation** reads, so its cues match what is said.
 
@@ -87,7 +134,7 @@ A table with `Term | IPA` columns works too. If you paste your own article, add
 ### Turn it on
 
 1. On Create, open **Narration → Change → More narration settings**.
-2. Keep **Use the article's pronunciation glossary** on (the default). It shows only while the voice is one that reads it.
+2. Keep **Use pronunciations** on (the default). It shows only while the voice is one that reads IPA, and it covers both your Name pronunciations and this article's glossary.
 3. Optional: keep **Also use pronunciations from my other projects** on (the default). It adds every term from your other projects' glossaries, copied when this project starts. This project's own glossary wins where they differ. Turn it off to use only this article's glossary.
 
 ### Entries that are skipped
@@ -104,21 +151,56 @@ An entry narration can't use is skipped and read as ordinary text. It never bloc
 
 To fix skipped entries, edit the Pronunciation Glossary at the end of the article in **Edit settings** → **Article**, then save. See [Editing a project](Editing-a-Project).
 
-## Aliases or glossary?
+## Does this video say the names right?
+
+Two checks on the project page answer that from files the project already has. Neither one blocks the run or the upload, neither costs anything, and neither changes a thing.
+
+### Before the narration is paid for
+
+The **Narration** section says, in one line, which names this article uses that nothing pronounces: not its own Pronunciation Glossary, not your **Name pronunciations** list, not the pooled copy of the other projects' glossaries. **Every mention** opens the table — each name, how often it is said as written and how often as a possessive, proper names first.
+
+This is the cheapest moment to settle a name, because adding it to **Name pronunciations** costs nothing and the voice has not been paid yet.
+
+It also catches the names a glossary looks like it covers and doesn't:
+
+| What the glossary has | What the article says | Why the voice guesses |
+|---|---|---|
+| `Belwar Dissengulp` | "Belwar" on its own | A two-word term never matches one of its words said alone. |
+| `Drizzt` | "Drizzt's" | A project narrated under the old pronunciation rules wrapped no possessive. |
+| `Catti-brie` | "Catti-brie" | The old rules skipped a hyphenated term, so it was read as ordinary text. |
+
+A project is judged by the rules it was voiced under, so a video made before those rules changed is told what actually happened to it, not what would happen today.
+
+### After the render, before the upload
+
+The **YouTube** section carries the same line, saying two things.
+
+**What the voice was sent.** Counted from the voice script itself, which is exactly the text the voice received: a name with no IPA in front of it there was guessed, whatever the glossary says.
+
+**How each name was heard.** Read from the per-word confidence the subtitle timing already wrote when the captions were made: each name's mean, and the spread across its mentions. Nothing is listened to again and nothing is re-aligned.
+
+The spread is the signal, not a low score. A rare name is heard poorly even when it is said perfectly, so only a name whose own mentions disagree with each other is flagged: eight mentions or more, and a spread of 0.30 or more between its 10th and 90th percentile.
+
+A name read as an ordinary English word is left out of both checks: a one-word name that the same text also writes in lower case is a word here and not a name, which is why "Hall" stays quiet in a video that also says "hall".
+
+## Which one do I use?
 
 | You want | Use |
 |---|---|
 | An abbreviation read in full (Dr., St., vs.) | Alias |
 | A word read as a different word or spelling | Alias |
 | Any voice service | Alias |
-| A made-up or foreign name said exactly right, on Inworld TTS-2 | Glossary |
-| Pronunciations that come with each article automatically | Glossary |
+| A name said the same way in every video | Name pronunciations |
+| To correct a name once, for everything you have made since | Name pronunciations |
+| A made-up or foreign name said exactly right, on Inworld TTS-2 | Name pronunciations, or the article's glossary |
+| Pronunciations that come with each article automatically | The article's glossary |
 
 ## Tips
 
 - Spell **Say it as** the way it sounds, not the way it is written: "Shiv-awn" rather than "Siobhan".
 - Keep **Whole word** on unless you really want to match inside other words. Otherwise `St.` could fire inside unrelated text.
 - Listen to the first minute of a new run before a long batch, and add aliases for anything the voice stumbles on.
+- A name that comes back video after video belongs in **Name pronunciations**, not in each article's prompt: one line there holds for every project that follows.
 
 ## Related pages
 

package/dist/tutorials/Settings-Reference.md

@@ -58,6 +58,7 @@ Full details: [Keys and Services](Providers-and-Keys) and [AI CLIs](AI-CLIs).
 | **Sounds like a real person** | On for a voice cloned from, or made to sound like, someone real. Copy for YouTube Studio then answers Yes to YouTube's question for videos it narrates. | Default: off. |
 | **Listen** | Reads one sentence aloud: free with the system voice, one short paid request with a service that has a key. | |
 | **Remove** | Removes the voice after you confirm. Projects keep the audio they made with it. | |
+| **Name pronunciations** | Opens your own list of names with their IPA, said that way in every video, before any article's own glossary. | |
 | **Pronunciation** | Opens the narration aliases: words the narrator says differently from how they are written. | |
 
 A line above the table says when a voice's service has no key yet, with a button to add it. See [Keys and Services](Providers-and-Keys#add-a-voice) and [Narration Aliases and Glossary](Narration-Aliases-and-Glossary).