* fix(cli): keep files received that a host's kept record still lists
When the received-state file names a project as expected and the host
keeps its own copy of that project's record beside the state file, the
received-file checks read the record together with each entry that copy
lists whose path still holds something. A record shortened or emptied
outside the host no longer makes those files read as the person's own.
A kept copy with no list, a doubted one, a link or one that cannot be
read counts every file as received; with no kept copy, nothing changes.
* fix(cli): keep a record's own lines when the host's kept copy cannot be read
A kept copy with no list, or one that cannot be read, now counts every
file as received through its own entry, named by the kept copy's path,
instead of hiding the record's lines from Studio's rename and move
tracking. A copy found only by folder identity counts only when its
identity matches the folder, and a copy that disappears mid-read counts
as no copy.
* docs(cli): say a kept entry whose file is gone is not added back
* fix(cli): say a listed received file is gone, and drop a media file's line on rename
Follow-up to the change that keeps a deleted received page listed.
- The render warning for a listed file that no longer exists now says it
is gone and how to clear it.
- A listed file whose name was already a media name drops its old line
when renamed to another media name, so repeated renames leave no
dead lines.
- The docs say that any listed file that is not media by its first bytes
stays listed after a delete, and that the line can sit in a record
above or inside the project.
- A test restores content after a plain Studio delete and checks that
outside files stay refused.
* test(cli): match the gone-file warning without a POSIX path, for Windows
compositionSrcsIn read template.content at every nesting level. linkedom
builds that fragment by deep-cloning the template's children, so a file of
nested templates cost work and memory that grew with the square of the
depth. The scan now walks the parsed tree once and tracks whether each
element sits inside a template.
A Studio delete took a received page's line off the record, and files
created afterwards were not followed. A script in the preview could
delete every received page and create it again with new bytes, so the
project no longer counted as received and outside files were read.
A deleted page, stylesheet or script now stays listed, so whatever is
written in its place counts as received. A received page renamed to a
media name keeps its old line too. Deleted or renamed media, fonts and
images still drop off, so a media-only project keeps working.
Free's 5 cloud exports a month read as a cap on every export. One sentence in the FAQ's cost answer and on the Export page says local exports are unlimited.
* test(core): a hover capture page keeps a 4K clip's file instead of waiting for its copy
* fix(core): hover and thumbnail captures never wait for a 4K clip's preview copy
* fix(core): keep mediaProxy's comment share flat
* test(core): keep the capture-page test comment within 120 characters
scanExistingAssets printed the project's own file and folder names to
stderr as they are. A name holding escape sequences could rewrite or
hide terminal lines. The line now goes through terminalText, like the
rest of media-use's output.
* feat(cli): check reports text drawn over a face in a video
The layout audit reports text painted in front of an opaque video with its
word boxes and where the video's frame lands; Node finds the faces in the
video file with the detector `measure face` uses and adds a `text_over_face`
finding (info from 5% of the face covered, warning from 30%) with
`coveredFraction` and `faceRect`. `layout.faceCheck` in the report says
whether the pass looked. `data-layout-allow-on-face` waives it.
Also reads a two-token `object-position` whose first token is "50%" as the
horizontal one.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
* feat(cli): measure cuts names the shot a take resumes
A shot that returns to an earlier camera setup after at least one other
shot (a wide take, a close-up cut into it, the wide take again) carries
`continues`: the index in `shots` of the shot it resumes. It is read from
the signatures `cuts` already decodes, by the scene's edges, so a person
who has moved or an exposure that drifted does not hide the match.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
* feat(cli): measure hands follows a hand through a clip
`measure hands <video>` reports where a hand's palm (with the hand's
size), index fingertip or pinch is in each sampled frame of a stretch of
up to 15 s, from MediaPipe's hand landmarker. A frame with no such hand
is null, never filled in. The landmarker runs in the CLI's headless
Chrome on a page answered from disk; its code and model are not shipped
and are downloaded on first use, pinned by size and sha256, into the
trusted cache.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
* fix(cli): text_over_face is info only, and a stalled OpenCV download no longer stalls check
The face detector can take texture for a face, so text_over_face is
reported as info however much of the face is covered and never fails
--strict.
check passes its deadline and a 30 s limit into the detector's first-use
OpenCV download. A download that does not answer costs the face pass
only: faceCheck is { ran: false, reason }, the other findings are kept
and the process exits.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
---------
Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
* fix: refuse framework build output and service-account files; lint skips private compositions
Review follow-ups:
- Hidden framework build-output folders (.next, .nuxt, .output, .svelte-kit,
.vercel, .netlify, .wrangler, .astro, .turbo) are private whatever the file
type, since their scripts can carry inlined server environment values.
- credentials.json and common service-account key names are private.
- Lint's compositions/ walk skips private files and folders, and an explicit
lint entry that is a private file is refused.
- New lint tests link .git/m.json, .mcp.json and a .hyperframes record as an
import map; they fail when lint's private-file check is removed.
* fix: a hidden file is private whatever its type; files in hidden folders keep the asset rule
* fix(lint): derive the root duration with the parser's timing reader
`deriveDurationFromClips` read `data-start` with a raw `Number()`, so a clip
authored at `data-start="-2"` produced an end of `-1`. `resolveCompositionDuration`
only counts positive ends, so the clip vanished from the derivation and the
composition was reported as having no duration source at all — a hard error that
blocks strict renders, even though the parser clamps the same start to zero and
renders the clip for its full length.
Read the start through `readClipTiming`, the same contract parser the renderer
uses, and keep the media-duration default for untimed images.
* fix(lint): derive the root duration with the parser's timing reader
`deriveDurationFromClips` read `data-start` with a raw `Number()`, so a clip
authored at `data-start="-2"` produced a negative end and vanished from the
derivation. Read the start through `readClipTiming`, which clamps it to zero,
and keep `readAuthoredDurationSeconds` for the authored length so a valid
`data-end` still backs an unparseable `data-duration`.
* test(release): a release's approver must not have pushed it, and a second maintainer must have
* fix(release): count every pusher of a release, need a second maintainer, date approvals
* docs(release): who may approve a stable release, and the second maintainer it needs
* test(release): a push the activity log records with no account stops the release
* fix(release): a push recorded with no account stops the release
A provider key from a project .env is still used when no own credential
competes. Capture vision (OpenRouter, Gemini, Google and both Vertex parts),
snapshot --describe, Gemini speech and Lyria music now print one note per key
before it is first used, naming the variable and the escaped .env path, as
the ElevenLabs note does. The ignoring notes escape the path too, and the
media-use skill gets a generated copy of the CLI's terminal-text helper.
`subcomposition_blanks_before_host` read `data-start` and `data-duration` with a
raw `Number()`, so a mount with a reference start (`intro + 0.5`) looked like it
started at 0 and was reported as leaving a blank tail that may not exist. A
negative start was measured from the raw value, so the reported gap and the
`data-duration` fix hint were wrong in the other direction.
Read the mount through `readClipTiming`, the same contract parser the renderer
uses: a runtime-resolved start is skipped (its end cannot be known statically),
and a negative start is measured from zero.
* test(studio): a sealed preview's timeline rows bind to their elements
* fix(studio): timeline rows in a sealed preview know their element, source file and audio group
A media-proxy request with neither Sec-Fetch-Site nor a Referer naming the
host was treated as same-site. Play, the static project server and Studio now
require a positive signal and refuse the request otherwise. The check
command's own re-request of failed media sends a Referer for its origin so it
keeps working.
— Rames
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* test(studio): scrubbing a sealed preview plays the music track
* fix(studio): scrubbing the playhead plays the music track in a sealed preview
* fix(core): the scrub uses the runtime's wall-clock timers and media-time writer
The blur's filter <svg> is appended to <html>, outside the body swap a
same-document re-init performs. A torn-down run left it (and
window.__hfMotionBlur) behind, so the next run's hf-mb-0 collided with
the stale id and url(#hf-mb-N) drew movers through the old filter
region, rendering them blank.
Fixes#7986
* test(release): a release merged in one push with other PRs is found and published at its own commit
* fix(release): a release merged in one push with other PRs publishes at its own commit
* test(studio): the edit bench measures an element inside a sealed preview
* fix(studio): the edit bench reads a sealed preview through its editing port
* fix(studio): the edit bench drops a preview reply that lands after a release or the next drag
* fix(studio): the edit bench pairs each frame's pushed geometry with the pointer at that moment
* fix(studio): the edit bench pairs Studio's outlines and the watched element by time, not arrival
* fix(studio): the edit bench starts a drag only once the preview has measured the element
* fix(producer): frames start drawing while the audio mix finishes
* fix(producer): keep the encode stage's comment share
* fix(producer): on machines with under 4 CPUs frames wait for the audio mix
* test(producer): a mix that fails during capture is reported as the audio stage's failure
* fix(producer): a mix that fails during capture names the audio stage as where the render failed
* fix(engine): the render file server never serves a project file as a service worker's script
* fix(producer): render, capture and inspector servers never serve a service worker's script
* test(studio): audio meters and group volume in a sealed preview
* fix(studio): audio meters and audio groups work in a sealed preview
* chore(inspector): raise the unpacked size budget for the preview's audio editing kinds
* test(studio): the sealed audio test serves a Studio-marked preview, as the editing port now requires
* feat(core): the preview can stream an element's geometry to the editor every frame
* refactor(core): the editing client hands unasked pushes to one function
* fix(core): geometry watches are capped per page; a lost port or failed measure stops nothing else
* fix(core): the preview measures watched geometry after the frame renders, not inside rAF
* fix(core): watched geometry is measured in the frame's resize-observer step, just before paint
* docs(core): a hidden preview's geometry pushes pause until it has a size
* test(core): keep the fake resize observer's note within the line limit
* perf(engine): check still frames on several pages at once so text films start sooner
* fix(engine): parallel still-frame check keeps its full time budget
* test(engine): give the Bun download check the minute its spawn already allows
* test(release): npm publishes with the job's OIDC token, no stored token named
* fix(release): publish to npm with the job's OIDC token, not a stored token
* test(release): catch a secret named by index or inherited, not only secrets.X
* test(core): a held picture is drawn through a closed VideoFrame
* fix(core): a held video picture is drawn through a VideoFrame closed after the draw
* test(core): read the held frame's closed flag only once it is a VideoFrame
* test(core): the reloaded-video playhead test builds a smaller film so busy CI never times it out
* test(core): keep the playhead fixture note inside the comment line limit
A bare listSiteFiles now leaves out files and folders linked in from outside
the project; a caller that wants them passes "include". listSiteFilesForUpload
warns on the console when the caller passes no onNotice, so SDK callers learn
that files were left out. The regression harness keeps its fixtures' outside
links with "include".
— Rames
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(studio): a service worker a project left behind is gone before a preview frame loads
* fix(cli): the player page's inlined script list is escaped for a script tag
* fix(cli): cloud render --json reports re-encode progress and times out a stalled cache check
* refactor(parsers): share the ffmpeg progress reader from ff-binaries
The reader lived in a new studio-server entry point, which pushed its packed size over budget and left package.json out of step with package-subpaths.json. Both callers already depend on parsers. The re-encode now gets a progress callback only when someone listens.
* style(cli): format the offload test
A scene mounted as `\\host\share/scene.html` read its own file from inside the
project, but its sibling assets were looked up next to `\\host\share`, which on
Windows connects to that host and sends the user's login. The compile's asset
checks now report any path outside the project as missing without touching the
disk, and a data-composition-src with a leading `\` or `./` is rewritten to the
project file it names before its assets are resolved.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* test(publish): a stable release counts only maintainers' reviews, never the approver's own push
* fix(publish): a stable release needs a maintainer's approval, not any account's
* fix(publish): only approvers and change requesters are looked up, and a failed lookup always refuses
* style(publish): the release gate's comments and lines fit the 120-character limit
A `?hf-proxy=` request makes this machine run ffmpeg. Studio already refuses
one that comes from another site; the `play` composition route and the static
project server (used by check, snapshot and capture) still served it. Both now
answer 403 to a cross-site or same-site `?hf-proxy=` request before any probe
or transcode starts. Their own pages and plain asset requests are unchanged.
— Rames
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
- parseSubCompositions and the inliner's disk fallback check again right before they
read a composition, so a file swapped for an outside link after the pre-flight is
refused too. recompileWithResolutions carries the outside-file policy.
- The refusal says any scripts in the file would run, which holds whether or not it
has any, and offers moving the file into the project, which Studio and benchmark
renders can do without the CLI flag.
— Rames
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): leave files from outside the project out of Lambda and Cloud Run site uploads
A site upload for `lambda` or `cloudrun` followed every symlink in the project and
shipped what it pointed at, wherever that was on the machine. `publish` and `cloud
render` already ask first. Site uploads now leave a file or folder linked in from
outside the project out and name each one; `--include-outside-files` (or
`includeOutsideFiles` in the SDK's deploySite, renderToLambda and renderToCloudRun)
uploads them. publishProjectArchive called without a prepared archive now leaves
outside files out too, since nothing approved them.
— Rames
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(producer): drop the new option comments the comment ratchet refuses
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): a host can name projects whose received files are expected or all received
HYPERFRAMES_RECEIVED_STATE_FILE points at a JSON file a host app keeps,
listing project folders (by path, and optionally by device and inode) as
"expected" or "all". For an expected project, a missing received-files
record counts every file as received and is not started afresh; for an
all project, every file counts as received whatever the record lists. A
state file that is named but cannot be read counts every file as received.
A record lock dated in the future is taken over like a stale one.
* fix(cli): read host provenance state through one file handle
* fix(cli): canonicalize host state paths like record writes
* test(cli): expect canonical received warning paths
* fix(core): only Studio's own preview pages get the editing port, and undo sets only safe attributes
restore-attributes now changes only class, style and the editor's timing, layout, audio and label data- attributes, and drops only data- ones; any other change answers applied: false and Studio reloads the preview. The editing agent hands its port over only when the page carries Studio's preview mark and not the another-site mark, so a page no Studio marked never offers it.
* fix(core): undo on a lazily loaded image still applies in place
The preview server adds loading="lazy" to timed images and the saved file does not have it, so the restore now may drop loading; dropping it loads nothing new.
* style(core): keep the restore plan's doc comment within the line limit
* fix(lint): match a timed wrapper's close tag literally
The parser keeps any tag name up to whitespace, / or >, so a wrapper's
name can hold regex syntax. closeTag built its pattern from the raw name:
an unbalanced name threw a SyntaxError that rejected the whole lint, and a
nested-quantifier name backtracked exponentially over the text before a
nested video. Escape the name with the file's own escapeRegExp.
* refactor(lint): name the escaped close-tag pattern instead of commenting it
The comment ratchet keeps a file's comment share from rising.
* test(studio): three quick drags give three undo entries in the history list
* fix(studio): each drag shows as its own undo step once its save lands
* test(studio): the edit bench fails a gesture missing from the history list
* refactor(studio): the held-entry close is a plain function, and the bench helper stays private
* chore(studio): mark the history hook's existing complexity the way other large hooks are
* fix(studio): a drag's history claim waits for the previous drag's close to land
* fix(cli): a refused reverse start reports whether HeyGen sent the refusal
* fix(cli): a refusal body that is not JSON is never read
* refactor(cli): drop the comments the names already say
* refactor(cli): reading a refusal's source lives in one helper