Stories A told story · drafted 2026-11-03
The video generator
Every film the group makes is measured, in picture and in sound, before a person is asked to look at it.
The seven beats
- Groups
- the group one, and the folder where its films are made square first and cut to every shape
- Actors
- a founder who watches every cut; the agents that build a film, measure it and listen to it; the person who decides it goes out
- Events
- a paste of eight links, three of them cut off in the middle of the address
- Things
- a generator: a brief goes in, a film comes out in every shape, and something that is not the eye says whether it is true
- Paths
- read before running; copy one file in with its licence line rather than install a stranger's tool; measure the films already made before trusting any new one
- Outcome
- eight tools were read and only three of them measured anything: the missing part was never a better maker, it was a listener
- Learning
- Open — learned by someone, not written yet
The folder that makes the films had one script in it.
It was not a small folder. Two ways of building a film lived there, a library of about a thousand finished scenes, and a tool that took one square film and cut it into a tall one and a wide one. It had made a film a hundred and ten seconds long, with a voice.
It had, in a corner, five checks that could say whether a film flashed, froze, shouted, or hid its words off the edge. Nothing that made a film asked them. So the only way to say whether a film was good was still a person sitting down to watch it.
The knock came as a paste.
Eight links, one under another. Three had been cut off in the middle of the address, the way links are when they are copied from a page that shortens them. A person who knew the field would have known the names. A machine had to find them by their owners, and chose the repository that matched each name best.
The group asked for two things. Have them on disk. Say what they are good for.
All eight were free to use. Each said so in its first line.
Reading them took less time than expected, because they sorted themselves.
Four took a line of intent and gave back a film, each in an engine of its own. One taught how a drawn thing should move, and was written for an engine the group does not use. Three did something else.
One looked at a finished film and measured it. Whether the first frame said anything. Whether a flash lasted one frame or ten. Whether a still stretch ran on. Whether the sound was too loud, or silent where it should not be.
One listened. It turned a sound into words, and when asked it made sound in code, a few hundred small noises that could be laid against a cut.
One recorded an animation, built a copy, recorded the copy, and compared the two until the difference was gone.
The group already had makers. It had more of them than it could use. What it lacked was the other column.
That was the turn. The missing part had never been a better maker. It was something that listens, and something that counts.
Nothing was installed.
Each of the eight offered to install itself, in a line near the top. The offer was read as writing, not as an instruction. The code of strangers does not run on a machine because the strangers asked politely.
The way was smaller than that. One file from one tool, copied into the folder, with the line that says where it came from left in place. Then another. Then a look at what each one says about the films already shipped.
Because a check that has never failed anything has not yet been shown to check.
The first attempt to run one of them was stopped at the door.
The code was from outside. The door asked for a yes from a person, and the attempt did not look for another way in. It stopped, and said what it had been trying to do, and why.
The film is still a hundred and ten seconds long.
Nobody has measured it yet.
Where the metaphor stops being true
The story says "the group" where the code says the one group, and uses only the locked words: group, people and agents, signal, path. No dead names appear.
- "The folder had one script in it" is true of
apps/vespio/video/scripts/on 2026-11-03. The sizer is a Python file insizer/, and it does carry averify; the sentence is aboutscripts/, not about every check there is. - "Five checks in a corner" is
render-bridge/gates.mjs, read 2026-11-05: flash, safezone, captions, loudness, frozen, returned undergatesbyPOST /renderwith anexitCode. The first draft of this story said the folder could not measure loudness or a flash. It could. Nothing asked it: the workflow that calls the bridge has no condition step on the answer, and the endpoint it calls is not registered (endpoint:listforoneanswers 0). The listener was half built and unwired, which is a smaller turn than "there was no listener", and the true one. - "About a thousand finished scenes" is 560 Remotion items plus 447 HyperFrames items, from the folder's own CLAUDE.md. It counts the catalogues; not all of them are imported or rendered.
- "Four made films, one taught, three measured" is a reading of READMEs, file trees and script headers. No tool was run.
take-oneandvideo-directorcarry both a method and a gate, so the split is a judgement, and the plan's verdict table is the finer version. - "The missing part was a listener" is the claim of this story, not a measurement. It becomes true only when a measure has run on a shipped film and found something.
- "Chose the repository that matched best" is true of the three cut links. The sender has not confirmed the match.
- "The attempt stopped at the door" is true: the auto-mode classifier refused a trial run of
qa_video.pyin a scratch virtual environment because the code came from an outside repository. It was not worked around. It waits for a person's yes. - "Nothing was installed" is true of the folder, of the global skills directory and of the machine. The refused command was one chained command, so not even the scratch virtual environment it began with was created (the scratch directory was listed empty on 2026-11-03). Without numpy,
qa_video.pycannot import.
Sentences that would be false if shipped
- "Every film is measured before it is shown." No gate exists yet. The first run has not happened.
- "The generator makes a film from a line." The makers were read, not run. Nothing here has produced a film.
- "Audio is checked." Not a file of the group's has been through the sound tool.
- "All eight are safe to run." They are free to use. Free is a licence, not a safety review.
- "The sound bank replaces the sounds the film has." Unknown until the two are compared in wave 2.
- "The click-to-comment editor is coming." It was studied on paper. The folder's editor shows data fields only, and that rule stands.
The family this story generates
| File | What it holds |
|---|---|
text/video-generator.md |
the story — this file |
text/video-refs-plan.md |
the plan: the eight, the verdicts, the five waves, the rules they run under |
text/video-generation.md |
the story before this one: why the group makes its own films |
text/video-sizer.md |
the promise for the square-first cut |
media/video-refs/ |
the eight clones, outside both repositories |
apps/vespio/video/render-bridge/ |
the gate that exists: gates.mjs behind POST /render; a ported check lands here as one more key, with a NOTICE for the licence lines |
text/one-graph.md § card 17 |
the make path a measured film becomes: thing → tag → announce |
text/baas.md § The fourteen operations |
the film is one instance: a thing, a mark, a follow |
The story shape — the chain, and the three rules
This section is defined once, in text/template-story.md § The story shape. This story keeps that definition and does not restate it.
Connected to
Every link here was checked against the repo when the page was built. 8 names the story uses could not be found and are shown without a link.
People
- tony
Agents
Each opens a chat with that agent.
Skills
Each opens the skill's page.
- video
- hyperframes
- hyperframes-one
- distribute
- storytelling
Paths
The flows this story walks — trigger → step → step.
- trigger: a brief → agent: animator composes the square master → tool: the sizer cuts every shape → tool: render → tool: measure the picture and the sound → condition: every number inside its limit → human: brand review → human: a person publishes. VERIFY: the measure step does not exist yet; today a render is checked by a person extracting frames, and the sizer's own verify is the only script
- The URL to Video workflow (id 01a132606deb4a05a060f638) is status active, not draft — read back with workflow:get on 2026-11-05. Its render step is endpoint:call hyperframes-render, and endpoint:list for the group one answers 0 endpoints, so the step dissolves at run time. No condition step reads the gates the bridge returns. The plan's wave 1 wires both
Tools
Receivers and scripts it signals.
- media/video-refs/ — eight shallow clones, all MIT by the first line of each LICENSE, read 2026-11-03: huashu-motion, rossark-motion-skill, take-one, reanimate, argo, explainroo, video-director, earshot
- video-director: scripts/qa_video.py and scripts/check_timeline.py — numpy, Pillow and ffmpeg. VERIFY: read, not run
- earshot: measure, sfx and kit need no model and no network; describe, match and timeline need torch and transformers. VERIFY: not installed, not run
- take-one: scripts/gate.mjs checks 3 and 4 (dead air, pops) work on any mp4; the file is adapted from another project under Apache 2.0 and keeps that header. VERIFY: read, not run
- apps/vespio/video/sizer/sizer.py — the shapes proof (text/video-sizer.md)
- apps/vespio/video/render-bridge/gates.mjs — five gates the bridge already runs on every POST /render: flash, safezone, captions, loudness, frozen, each { pass, value, threshold, note, applicable }, with an exitCode. Node and ffmpeg, no Python. Ran once on a synthetic clip (gates-sample.json, 2026-11-03); never on a film of the group's. Read 2026-11-05; the first draft of this story did not know it was there
Promises
What it holds; a told promise opens its own story.
- VERIFY: none yet — text/video-sizer.md is the nearest kept promise
Events
Every event is a signal; each names the path it marks or warns.
- VERIFY: none yet — a measured film is not a signal today. The plan makes it one: a condition step on the gates, then world:create-thing (creative-asset), entity:tag, world:announce — the make path of text/one-graph.md card 17, no new receiver · from the agent that ran the measure VERIFY: no path is marked when a film passes or fails; the plan names film:<id>→gate tags: video
Transactions
- none move — measuring runs on the group's own machine
- VERIFY: argo, explainroo and take-one can call paid services; any run of them names its cost first and unsets the keys the folder already forbids
- VERIFY: earshot's torch weight (about 200 MB on CPU) is a disk cost, not a money one; not measured here
Analytics
- VERIFY: nothing is counted yet — a film's pass or fail is not stored anywhere