Skip to content

Take the test count out of the narration, so that line cannot go stale - #60

Merged
peopleworks merged 1 commit into
mainfrom
chore/narration-without-the-count
Aug 29, 2026
Merged

Take the test count out of the narration, so that line cannot go stale#60
peopleworks merged 1 commit into
mainfrom
chore/narration-without-the-count

Conversation

@peopleworks

Copy link
Copy Markdown
Owner

Follows #59, which rebuilt the film and left this open because it needed a decision and a recording, not a rebuild.

The screen fixed itself; the voice could not

scene_kit.test_count() reads the suite size off the README instead of having it typed into a slide, so the rebuild moved 08-roslyn from 295 to 556 on its own. Its docstring is the whole argument:

Typing it into a slide would put a number on screen that nothing forces to stay true — the exact failure this material is about.

A recorded take has nothing keeping it honest. The narration said "doscientos setenta" / "two hundred and seventy" — so the rebuilt film was about to contradict itself out loud, in the very scene about not stating things you cannot back.

the frame that reads 556

The number is gone from the line, not corrected to 556

Correcting it buys a stronger sentence that is wrong again at the next release and needs a re-record every time the suite grows. Dropping it costs one re-record, ever — and the count stays on screen, read from the one place that has a test enforcing it. This is test_count()'s own argument applied to the audio.

es  "...no hace falta licencia, y sus tests corren gratis en un runner público."
en  "...it needs no licence, and its tests run free on a public runner."

Re-recorded with the voices the guion already names: Marcela for Spanish, and Rachel for English — who is not in the account and was already pinned by id in PREMADE_VOICE_IDS, with a comment saying why. Both resolved without touching the resolver.

No credential entered this repository. --narrate reads ELEVENLABS_API_KEY, so the key was passed through the environment for the one run; the diff carries nothing secret, and docs/Blog/video/.elevenlabs.key still does not exist. --narrate also skips any take that already exists, so this billed for two short lines rather than twenty-two.

What moved with it

The line is shorter without the number, so the scene is:

Was Now Film
es/08-roslyn 17.8s 17.0s 3:46
en/08-roslyn 17.8s 16.4s 3:28

--retime read those off the new takes and every other scene came back at the length it already had — so the only chapter stamps that move in PUBLICACION.md are the six after 08-roslyn, and they move by a second or two. Both films reassembled and re-probed: 226.6s and 208.1s, h264 + aac, 11/12 scenes voiced as before.

One thing left for you, deliberately

The blog article says "270 tests" in four files — xaflogic-hidden-behaviour-story.{es,en}.{md,html}.

I did not touch it, because it is a different kind of claim. A film is regenerated from live sources, so a stale number in it is a defect. An article is a dated publication, and what it said when it was published is not false. Updating it to 556, rephrasing it the way this narration just went, or leaving it as a snapshot are all defensible — which is why it is a decision rather than a fix.

🤖 Generated with Claude Code

https://claude.ai/code/session_01W45tzJFX3NoSrk7svtQeKT

The rebuilt frame reads 556 because scene_kit.test_count() takes it off the
README. The voice beside it said "doscientos setenta" / "two hundred and
seventy", because a recorded take has nothing keeping it honest -- and the two
were about to contradict each other on screen.

The number is gone from the line rather than corrected to 556. Correcting it
buys a stronger sentence that is wrong again at the next release and needs a
re-record every time the suite grows; dropping it costs one re-record, ever.
The count is still on screen, read from the one place that has a test enforcing
it. This is test_count()'s own argument applied to the audio.

    es  "...no hace falta licencia, y sus tests corren gratis en un runner publico."
    en  "...it needs no licence, and its tests run free on a public runner."

Both takes re-recorded with the voices the guion already names -- Marcela for
Spanish, Rachel for English, who is not in the account and was already pinned by
id in PREMADE_VOICE_IDS for exactly this reason. The key was passed through the
environment for the run; nothing was written into this repository.

The line is shorter without the number, so the scene is too: 17.8s becomes 17.0s
in Spanish and 16.4s in English. --retime read that off the new takes, every
other scene came back at the length it already had, and the six chapter stamps
after 08-roslyn in PUBLICACION.md move with it. Films are now 3:46 and 3:28.

Not touched, because it is a different kind of claim: the blog article says
"270 tests" in four files (es/en, md/html). A film is regenerated from live
sources, so a stale number in it is a defect. An article is a dated publication,
and what it said when it was published is not false. Worth deciding, not worth
deciding silently.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01W45tzJFX3NoSrk7svtQeKT
@peopleworks
peopleworks merged commit f2cb259 into main Aug 29, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant