Repository navigation
Films: self-contained works produced at three levels, with a cut editor - #99
Merged
Merged
Conversation
A film is the other kind of project a library holds (ADR-0050): a directory with a film.yaml, produced at three levels addressed with the three positions a channel's are. layout.mjs reads the kind from disk; `_` names a level's own unit. film.mjs and cut-timeline.mjs are the manifests' and the cut's contracts, readable in the browser. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Clips of picture and sound on tracks, rendered by FFmpeg: trims, speed, fit, opacity, dissolves, fades and wipes, a catalog of picture and sound effects, ducking, a mix mastered to a loudness target. Rendered window by window and kept between renders, so a changed shot re-renders the windows it is in. Stills, contact sheets, cut detection and proxies for reading footage before it is cut. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@studio/film: making films, scenes and shots; a cut stored with counted revisions and edited by operations that hold together; clips a person locked left to the person; assembling a shot from its media, a scene from its shots, the film from its scenes; rendering with a cascade that renders exactly what is not fresh; footage ingest with sheets, cuts, proxies and loudness; the film as a tree with where each unit stands. A film's budget is one purse: its ledger is the journal of the level that declares it. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…at renders a cut film-project, film-scene and film-shot, each with an automatic variant (and a directed one for shots). A level's pipeline.yaml names the pipeline of the levels below it (scenes:, shots:), so one film can be automatic in most shots and directed by a person in one scene. The cut-render adapter performs every film render stage. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
pva_create_film/scene/shot, pva_film (the film in running order and what stands between it and its render), pva_update_unit, pva_ingest_footage, pva_footage, pva_inspect_media, pva_assemble_cut, pva_edit_cut, pva_check_cut, pva_render_cut, pva_cut_frame, pva_cut_effects. The studio's other tools reach a film's units as channel/series/episode, with _ for the level itself. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
A film is listed beside the channels with its kind; its scenes come in running order and its shots in cutting order, each with the state of its cut and render. /api/films/:film/tree is the film at a glance; a unit's manifest and cut are read and written through their contracts, a cut is assembled, shown at a frame and rendered in the background with progress on the event bus. Review threads are kept inside the episode: they were still written to the layout-1 path, outside it. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
… under it; a still per render Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The renderer keeps its rendered windows under .cut/ and a unit's locks under .locks/; a render in progress writes *.partial.mp4. None of them is something a person opens, so the default ignore rules leave them out. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
A JSON or YAML file opens as its fields: a number is typed as a number, a long text gets room, a list of small records is a table, and anything that holds more opens and closes, so a long file is first an outline. An edit changes the one field it names and rewrites the text around it as it was; for YAML the comments and the order of the keys survive. The source is one click away, and is where a file that does not parse is fixed. A pipeline manifest keeps its own view: it has a chain to draw. Whether a file can be saved is the artifact's declaration, not the name of the viewer it was narrowed to: a YAML file could be edited and had no Save. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…he cut A film is listed apart from the channels and opens on its board: its scenes in running order, each with its shots, where each stands between its cut and its render, and what stands between the film and its own. A scene opens on its shot list, a shot on its plan and its takes. Each level edits its manifest as a form, says who decides at it and under it, and renders. A film is started from the library. The cut is one editor at the three levels: sources (the units under it, its files, the film's footage, a colour), a monitor, the timeline, and an inspector for the clip, the track or the whole cut, with the renderer's own effect catalog. The monitor shows the draft played from its sources, the unit's render, or one frame composed with every effect, and says which. A person edits a draft with undo; a save names the revision it was made on, so an edit the agent made meanwhile is never overwritten. The shell gives the work its room: focus puts both side panels away (Cmd-\), the agent bar folds to one line, and the inspector panel is the cut's inspector while a cut is showing. A closed panel no longer pushes the canvas into the divider's column. In a film the inspector, the palette and the agent bar say film, scene and shot. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The film pipelines named skills that did not exist. They do now: film-producer (the three levels, how a unit is addressed, who decides, what to do next from where each unit stands), film-development (treatment and screenplay, to length), film-breakdown (the bible, scenes and shots as units, a scene's direction), footage-ingest (bringing real material in and logging what it shows), shot-production (a shot planned, its takes made or found, each looked at), film-sound (dialogue, ambience, effects, music and how they sit in a mix) and film-editing (the cut's operations and rules, effects, rendering and reviewing a render). The executive producer says what a film is and which tools make one, and the film package has its generated page. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
"stops rather than dispatching when the stage-started write is dropped" gave its service a 40 ms lease, and then ran a whole stage on it: on a loaded machine the run that follows the lapse lost its own lease before it finished, and the test failed one time in two — on main as well. The lease is 400 ms and the wait for its lapse 450. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
… squeezed to a letter The log entry's last column could not shrink below its content and left the panel. The agent bar's status gave all its room to the suggestions. The empty canvas names films among the things to choose. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The decision record for films: produced at three levels, each a unit with its own cut and renders, joined by a cut whose clips are the renders of the units under it. The workspace contract has a film's layout, the pipeline model its families and how a level says who decides, the running guide the film tools and what the studio shows, the gateway's API its film routes, and the web operator's guide the board, the cut and the keys. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
A film has no channel.md and no series/. The doctor checked every project of the library as a channel, so a library with one film reported two errors for it and was never healthy. A directory with a film.yaml is a film: it is checked for the container its scenes live in. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…he library The doctor exits non-zero when the library has an error, and health read that exit as the runtime being down: one old episode short of a folder made the whole studio "unhealthy". When the doctor answered with a report the runtime is ready, and the count of what it found is said beside it. It is down only when the command fails without one. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Owner
Author
|
Integration validation: |
This was referenced Nov 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
The studio made serialised content: a channel keeps producing episodes of a series. This adds the other kind of work — a film: one self-contained piece, short or feature length, made from real footage, stock, generated and programmed material, with recorded or generated dialogue, sound and music, edited on a timeline and rendered with FFmpeg. It can be produced unattended, or directed by a person at any level and granularity.
The decision record is ADR-0050.
A film is produced at three levels
The hierarchy is film / scene / shot; sequences and acts group scenes in
film.yamlrather than being a directory level. Knowledge lives at every level, as it does for a channel.Each level is a production unit like an episode — its own pipeline state, journal, approvals, budget view and renders — addressed with the three positions every tool and route already takes, with
_for the level itself (tide/010-shore/_is a scene). Nothing that worked on an episode needed a second code path.A shot's render is a source of its scene's cut, and a scene's of the film's. Freshness is derived from fingerprints, so a change to one shot re-renders that shot and re-joins what is above it — not the film.
By layer
Film,Scene,Shotmanifests; delivery formats; theCutTimeline(tracks, clips in frames, trims, speed, transitions, picture and sound effects, fades, ducking, markers, master); layout paths for films.@av/video-composer— the cut renderer: 44 effects with declared parameters, dissolves/fades/wipes, a mix with ducking and loudness, the timeline rendered in windows kept by content hash, one composed frame on demand, contact sheets, cut detection, proxies. It knows nothing of films.@studio/film(new) — units and manifests, cut store with revisions and locks, assembly, cascading render and freshness, footage ingest and log, the film tree.film-project,film-scene,film-shot, with-autoand-directedvariants that differ only in where they wait for a person; a unit'spipeline.yamlnames its own and the one the levels under it run. A film's budget covers every unit under it.pva_create_film…pva_render_cut), written once and served to Pi and to Claude Code; seven skills:film-producer,film-development,film-breakdown,footage-ingest,shot-production,film-sound,film-editing.The browser studio
Fixed on the way
maintoo; its lease is longer.How it was checked
npm run checkpasses (paths, boundaries, contracts, pipelines, docs, typecheck, every package's tests), as do the web app'ssvelte-check,tscandeslint.@studio/film's cover create → assemble → cascade render → staleness → locks → ingest.Not in this PR
🤖 Generated with Claude Code