Commit Graph
6752 Commits
Author SHA1 Message Date
WaterrrForeverandClaude Opus 5.5 d4e4b07e3c fix(cli): a wedged render trips its 60 s watchdog, one local render at a time, and fonts the cloud can't resolve are flagged (#7168)
* fix(producer): a wedged effect scan or screenshot-session open trips the 60 s stall watchdog

The sequential streaming watchdog raced only the capture call. Session init
(where the fast-capture effect scan runs) and opening the screenshot session
for effect frames waited on CDP's protocol timeout instead, which scales with
output area up to 30 minutes, so a starved page hung a render for ~25 minutes
before the watchdog saw the next frame. The effect scan now gives up when a
chunk outlasts its 120 s budget, opening the effect-frame session gets its own
no-progress window, and session init gets a 300 s one; each trip retries on a
fresh session like any other stall.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(cli): one local render at a time per machine; a second waits and says for whom

Renders started side by side from different sessions starve each other until
frames stop landing. `hyperframes render` now takes a machine-wide slot (a lock
file in the HyperFrames cache directory, held by pid) after its preflight and
holds it for the render or the whole batch. A second render waits and prints
the pid and project it is waiting behind; `--no-wait` fails at once instead.
A holder whose process is gone is taken over, and HYPERFRAMES_RENDER_LOCK=off
restores side-by-side renders. `--workers` is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(lint): flag fonts a cloud render cannot resolve, including the font shorthand

Lint read only `font-family`, so `font: 500 16px "PingFang SC", sans-serif`
passed while the renderer, which reads the shorthand too, drew the installed
Mac font locally and the cloud refused it. The shorthand now counts for
font_family_without_font_face (its parser moves to @hyperframes/parsers so
core and lint share one), and a new font_face_local_only warning names an
@font-face whose only sources are local(): it renders here and falls back in
the cloud. The rule's hint and the format reference stop recommending local()
for OS fonts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): a cloud render that refuses a font says which project files use it

The cloud's "fonts that could not be resolved: PingFang SC" named no
composition. For a render submitted from a local project, the failure now
lists each refused family with the project files that name it, and says how
to ship the font so the cloud can use it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(cli): keep comment shares and exports within the gates, and split the single-render notes out of executeHeldRender

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(parsers): read a spaced line-height slash and var() before the size in the font shorthand

`font: 16px / 1.5 Inter` was read as the family `/ 1.5 Inter`, and
`font: var(--weight) 16px Inter` as `16px Inter`, because a var() counted as
the size. The parser now follows the shorthand grammar: optional style,
variant, weight and width keywords (or var()), then a length, percentage,
keyword or calc() size, then a `/ line-height` in any spacing. When no size can
be told apart from a var(), it says so: lint skips that declaration instead of
reporting a missing font, and the renderer keeps its best guess.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): say the render slot is one per user account, not per machine

The lock lives in the account's HyperFrames cache folder, so renders by two
user accounts never queued behind each other while the messages, flag help and
docs said "this machine". They now say "per user account" and that
HYPERFRAMES_CACHE_DIR set to a shared folder shares the slot across accounts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): reclaim a render lock or takeover file left half-written

A lock or `.break` file that exists but cannot be parsed (a crash mid-write
where hard links are unavailable) was never reclaimed: a waiting render waited
forever and --no-wait refused forever. Once such a file is older than any real
write (5 s by mtime) it counts as abandoned: the lock goes through the same
`.break` takeover as a dead holder's, and a takeover file is removed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(producer): opening the capture session counts against the setup stall budget

The sequential streaming attempt opened its own capture session (Chrome launch
and new page) before the setup watchdog and outside the attempt's cleanup, so a
wedged launch still waited for the protocol timeout. Opening now shares the
300 s setup window with session initialisation, a trip fails the attempt like
any other sequential stall, and a session that finishes opening after its
attempt gave up is closed instead of leaking a browser.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(parsers): keep the shorthand result type module-private

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): reclaim an unreadable render lock only when its writer is provably gone

Where hard links are unavailable the lock is created by an exclusive open and
then written, so a contender paused between the two leaves an unreadable lock
while it is still alive. The 5 s mtime grace took such a lock over, and both
processes then held the slot. Each contender now writes an owner marker under
a name only it can take (pid plus random suffix, holding its process identity)
before it creates the lock, keeps it while it holds the slot, and removes it
otherwise. An unreadable lock or `.break` is reclaimed only when no other
contender's marker belongs to a live process; markers of dead processes, or of
a reused pid, are deleted. No reclaim is decided by time alone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor: split acquireRenderLock and the streaming-stage session stub under the complexity gate

acquireRenderLock hands contender setup and a single marked claim to their own
functions, and the test stub for createCaptureSession splits its held-open
cases from the fake session it builds, so neither exceeds Fallow's cognitive
or CRAP thresholds. Behaviour is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(ci): raise the CLI and engine size budgets for the watchdog, lock and font-lint additions

Main's CLI unpacked size was already ~0.99% over its budget; the render lock and
owner markers push it past the 1% tolerance. The CLI unpacked budget takes the same
value as #7169 and #7170 (25,159,107) so the PRs merge cleanly. The engine's packed
size grows by about 4.7 KB for the effect-scan and session-open watchdogs; its packed
budget moves to 5% above the measured 467,097, as the budget file's headroom rule sets it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(parsers): a var() size glued to its line height is the shorthand's size

`font: 700 var(--size)/1.1 "Inter"` read as no family at all: the token was
tested whole against var(), and the slash after it hid that it was the size,
so the renderer injected no face for Inter. A var() followed by `/ line-height`
(glued or spaced) can only be the size, and is now read as one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(parsers): split the shorthand size search out of parseFontShorthand

Keeps parseFontShorthand under Fallow's cognitive-complexity gate; behaviour is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): render lock never removes another render's takeover, knows a reused pid, works in a shared folder and on Windows

- A `.break` takeover file is removed only by the render that wrote it. One
  whose writer is gone stops the render with the file to delete, instead of
  being removed on an earlier reading, which could remove a live `.break`
  written since and let two renders hold the slot. The takeover re-reads the
  lock under its own `.break` right before replacing it.
- The lock record keeps its holder's process start time, so a pid that now
  belongs to another process (an OOM-killed render in a container with a
  persisted cache) no longer holds the slot forever.
- The `locks` folder is created writable for every account, so accounts
  sharing HYPERFRAMES_CACHE_DIR take turns instead of the second failing with
  EACCES; a folder this account cannot write in says how to fix it, and
  another account's file that cannot be removed is left, not fatal.
- Windows: no PowerShell start-time lookup per check (pid liveness only), a
  file another handle holds (EPERM/EBUSY/EACCES) reads as held, a lock that
  vanished is retried once instead of in a tight loop, and a wait stops when
  its signal aborts. The tests end every acquire they start before removing
  their folder, and the paused contender writes through its open descriptor.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(ci): raise the lint packed size budget for the font-shorthand rule

With main's audio-attribute rule (#7169) merged in, the font-shorthand and
local()-only font findings take @hyperframes/lint's packed tarball to
181925 bytes, over the 179338 budget. The new budget is that measurement
plus the usual 5% headroom.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 18:41:56 +00:00
Miguel Ángel cba66f20a6 feat(cli): cloud render carries the system fonts a project uses in its zip (#7165)
* feat(cli): cloud render stops before upload when the cloud lacks a font

* refactor(cli): shorten the font preflight comments

* feat(cli): cloud render carries the system fonts a project uses in its zip

* fix(cli): say only what is known when a system font's file is not found

* fix(core): find a system font by the family names inside its file, including .ttc faces

* fix(core): look inside font files only when asked, keep regular and bold, cut comments
2026-11-04 18:41:12 +00:00
Miguel Ángel 06722eb9b9 chore: release v0.9.13 (#7175) v0.9.13 2026-11-04 18:24:32 +00:00
Ular Kimsanov f333569f16 docs: footer links go to HyperFrames' X and Discord, not HeyGen's X and Instagram (#7148) 2026-11-04 18:21:55 +00:00
WaterrrForeverandClaude Opus 5.5 fb738015a0 fix(cli): bug-bash fixes for pull, offline, preview, check, cloud aspect, sfx search, and media-use avatars (#7170)
* fix(cli): an interrupted templates pull leaves no partial folder

Unpacking now runs tar asynchronously and removes its .part folder on
SIGINT/SIGTERM/SIGHUP before re-raising the signal. Part folders carry the
owning pid, and the next pull clears any whose process is gone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): auth status and templates pull say when HeyGen cannot be reached

Offline, both commands waited on unbounded requests and then printed only
undici's 'fetch failed'. A new networkFailure helper names the host, the
reason (DNS lookup, no route, refused, no answer in time, dropped) and the
next step. The account and token-refresh requests now time out after 15 s,
the template link after 15 s, and auth status reports an offline refresh at
once instead of retrying with the stale token. describeCauseChain moves into
the helper so the registry and auth share it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): preview leaves the project's HTML files as they are

Opening a project in preview stamped data-hf-id into every composition on
disk. The preview route and every source mutation already mint the same
content-keyed ids in memory, so the startup pass is dropped: files gain ids
only when an edit to them is saved. The .hyperframes folder is still made
before the watcher starts, so the preview cache creating it is not reported
to Studio as a manifest change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): check runs the browser audits past a lint error

A lint error made check skip runtime, layout, motion and contrast, so one
known lint error hid every browser finding. The browser pass now runs
whenever there is a composition to load, and the lint error still fails the
check. Only a root with no data-composition-id skips it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): no desktop-app line for CI or a script reading render output

The 'Keep editing by chatting with Framey' line printed on every render and
preview, including CI and piped runs where nobody can open the app. It now
prints for a person at a terminal, and for a coding agent, which the
hyperframes skill tells to pass the line on; CI and other non-TTY runs get
nothing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): cloud render takes a composition at any aspect ratio

A 1920x960 composition got 'server will default aspect_ratio to 16:9'
although the render kept 1920x960: at 1080p the cloud renders at the
composition's own size and aspect_ratio only picks a 4K preset. The CLI now
names the detected ratio (2:1) and says the size is kept, takes
--aspect-ratio as any W:H checked against the composition, sends only the
16:9, 9:16 and 1:1 the API accepts, and refuses a 4K render of any other
ratio before upload, where no preset fits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(media-use): a weak sound-effect match says so instead of passing silently

resolve --type sfx returned a HeyGen sound at any score down to 0.4, and a
project file that shared one word of its name with the intent, with nothing
to tell them from a real match. Such a result now carries a match object in
the JSON ({score, min_score, low_confidence} or the matched words and the
intent the file was resolved for) and a low-confidence line on stderr. A
HeyGen search with no hit says so with the min score it used, and a sound
effect nothing matches fails with 'no sound effect matched'.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(cli): media-use avatars lists the film account's avatar looks

Templates had to reach for 'heygen avatar list', a separate sign-in that can
be another account. 'media-use avatars' lists the private looks on the
HyperFrames account making the film (GET /v3/avatars/looks?ownership=private,
following next_token up to --limit) as {avatars: [{avatar_id, name, ...}]},
the id that 'generate --type avatar --avatar' takes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(skills): leave style-sampling's avatar line to #7164, which owns that skill

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): templates pull removes only the part folders it marked as its own

The abandoned-part cleanup deleted any sibling named '<slug>.part-*' whose
next token was not a live pid, so a person's own 'sample.part-notes/',
'sample.part-reference.txt' or a symlink went with it. A pull now writes an
ownership marker (owner tag + pid) into its part folder, and the cleanup
removes only a real directory with the generated '<slug>.part-<pid>-XXXXXX'
name whose marker names a dead pid. Files, symlinks, unmarked folders and
older unmarked parts are left alone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): media-use avatars says it is offline when the login refresh cannot reach HeyGen

A network failure while refreshing the stored login was reported as 'no
HeyGen sign-in' with 'auth login' as the fix, though the login was still
there. It now keeps the network failure's message and next step.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(media-use): a reused weak sound keeps its low-confidence advisory

The first resolve of a weak HeyGen sound or a name-matched project file
flagged it, but an identical second resolve hit the project manifest and
returned it with no match object. The advisory is now rebuilt from the
record's provenance (the stored score, or the adopted file's name) on reuse.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(cli): keep the comment share of files this branch touched from rising

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): no check-then-use on pull markers, and the download is never written to disk

CodeQL flagged the downloaded bundle written to a file before tar read it,
and a stat-then-read in the preview test. The verified archive now streams
into tar's stdin, so no network bytes reach a file the CLI writes. The
abandoned-part scan takes the entry type from readdir instead of an lstat,
reads the ownership marker through one O_NOFOLLOW descriptor it fstats, and
the preview test reads each file once instead of stat-checking it first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(ci): raise the CLI's unpacked size budget to 5% over its measured size

main's @hyperframes/cli was already about 0.99% over its 23722874-byte
unpacked budget, so this branch's additions (networkFailure, the avatars
command, the larger skill references) tip it past the 1% tolerance. This is
the same value #7169 sets, 25159107 bytes (5% headroom over the measured
size), so the two PRs merge cleanly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(cli): split the pull-marker check and share the token-endpoint POST

Fallow flagged pullOwner (CRAP 49.5, cyclomatic 13) and a 28-line clone
between refreshOnce and exchangeCodeForTokens. pullOwner is now the name
match, the O_NOFOLLOW marker read and the marker check as three small
functions, with the same behaviour. Both token requests go through one
postToTokenEndpoint, which keeps the 15 s timeout and the named network
failure.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): a 4k cloud render checks the exact size against its preset before upload

The aspect detector matches a ratio within ±0.05, so at 4k a 1920x1055
composition was sent as 16:9 and 1000x980 as 1:1, and the producer then
refused both as an aspect mismatch. At 4k the matched ratio's preset
(landscape-4k, portrait-4k, square-4k, the ones the API maps it to) now goes
through the producer's own checkOutputResolutionCompatibility, and a
composition it does not fit is refused locally with the producer's reason
and the 1080p alternative. 1080p, where the render keeps the composition's
own size, is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 18:21:36 +00:00
WaterrrForeverandClaude Opus 5.5 370f886aa9 fix(skills): style-sampling bug bash fixes, and the five style packs re-pinned (#7164)
* fix(skills): style-sampling follows what the kits can do

Stop 1 poses on the kit's free timing estimate instead of a plain page, a voice
id prefix is resolved from the account's clones, speed is measured as REMIX
says and changed locally, Pexels without a key and sites that refuse agents
move to the next source, and stop 2's preview opens no browser.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(skills): style-sampling answers the second bug bash

A stock voice is made only at the voice step, after the storyboard; an unfit
topic gets the nearest angle in the first reply; credits name only who the
person names; logos and page screenshots need terms that allow them; a long
render gets a time estimate and progress; and picking a finished episode back
up loads this skill.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(cli): pin the five style packs with both bug bashes fixed

ffmpeg 9 works, a voice line is bought once and re-timed for free, a crash after a
paid call never pays twice, the run's credit limit holds in every kit tool, the
storyboard poses on free estimated timing, checks pass on the shipped components,
and pulled files carry a real date.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(skills): keep the style-sampling description within the 320-byte budget

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(skills): a stock voice is picked by language with --plan, and resuming routes through the project's CLAUDE.md

media-use resolve --type voice needs --intent and returns an audio asset, not a voice id
the kit can reuse. generate --plan names the first public voice in a language without
making anything. The description goes back to main's wording; a finished project's
CLAUDE.md now says changes go through style-sampling instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(skills): style-sampling offers a free Pexels key in the one round of questions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(skills): style-sampling thanks the creators these styles learned from, without naming them

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(skills): style-sampling lists a presenter's looks with media-use avatars, never the heygen sign-in

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(cli): pin the five style packs with the plain end card and interruption-safe paid takes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(skills): style-sampling names the creators these styles learned from, and that they don't endorse them

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(skills): trim the style-sampling thanks line

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(cli): pin the style packs with the restart fixes from review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 18:13:20 +00:00
Ular Kimsanov 71b67ccf49 docs: the current top tab is a quiet grey pill again, not a green ring (#7055)
* docs: the current top tab is a quiet grey pill again, not a green ring

* docs: the Docs tab keeps its grey pill on docs pages, where Mintlify marks it .text-primary
2026-11-04 18:09:39 +00:00
Ular Kimsanov 7128dc0599 docs: a download card on the quickstart, the Windows zip on the install page (#6988)
* docs: a download button on the quickstart and direct links on the install page

* docs: the Windows download is a zip, and no billing note on the quickstart

* docs: Windows on Arm runs the Windows download

* docs: link the AppImage from the Linux install steps
2026-11-04 18:09:36 +00:00
Ular Kimsanov 986d7c6806 docs: one-line HyperFrames logo, Made by HeyGen in the footer (#7042) 2026-11-04 18:09:32 +00:00
Ular Kimsanov b3dd76661a docs(catalog): every card on screen plays a small looping video instead of a live player (#7146)
* docs(catalog): every card on screen plays a small looping video instead of a live player

* docs(catalog): the preview generator also writes each card's small loop and poster

* fix(catalog): end ffprobe options before the card file, as the argv contract requires

* fix(catalog): a pause control for the card loops; none play in a hidden tab or under 25% visible
2026-11-04 18:09:27 +00:00
Vance IngallsandClaude Sonnet 5.5 d36cad7985 test(engine): pixel invariants and fixtures that guard default-on capture blur (#7108)
* test(engine): pixel invariants for capture blur against blur off

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): fixtures for every capture blur failure class seen so far

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): nested canvas fixture reproduces #6975, sharp-tile fixtures have no moving times

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): capture blur must match blur off outside the trail and the shutter average inside it

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): differential tests pin known bugs by symptom, history test checks the reference frame

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): a playing preview keeps changing with blur on

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(producer): a multi-worker blur render must match blur off outside the trail

Renders five blur fixtures through the real producer as a PNG sequence with 4
workers (contiguous blocks, three of them starting mid-film, the #6967
condition): blur off twice, blur on once. Outside the trail of everything that
moved, blur on must equal blur off in every frame with two neighbours. The
callbacks and scroll-list known differences are pinned by symptom.

Import route: a relative import of blurDifferential.ts, fixtures.ts and
thresholds.ts from packages/engine/src/services/__fixtures__. The producer
tsconfig excludes test files, so I type-checked the file with a temporary
tsconfig (rootDir widened); no error. No package subpath was needed.

RENDER_OUTSIDE_MAX_MAE: render noise is 0 (blur off, twice, bit-identical), the
rewind mutation measured 111.085 when caught, so the 1.0 floor applies.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(producer): render callbacks with workers that start between its calls

With 4 workers the blocks started at 0, 15, 30, 45, each on a call, so the
rewind mutation showed in a render only 3 times in 5. Seven workers over 60
frames start at 0, 9, 18, 27, 36, 45 and 54, two of them strictly between the
calls at frames 16 and 30; the mutation then fails callbacks in 8 of 8 runs
(worst MAE 97.02), the clean build in none.

A new case checks the partition with distributeFrames. The #list and #label
rects now come from the fixture's markup, and MEASURED_RENDER_REWIND_MUTATION
is 97.02.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): blur pins bound the symptom, liveness detector reports blindness, fixtures time out

Pinned known bugs now require every bad tile inside the pinned region and a worst
MAE within half to double of the measured one. tileTouches, Rect and the band check
move into blurDifferential.ts with a dpr 2 unit test. The blank-frame census counts
canvases it cannot read and asserts none, and names both readings when no blank frame
is seen. No console.info on passing runs. Fixtures cases get a 30 s timeout.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(producer): scroll-list render case bounds the race, pins share the engine helpers

The scroll-list loss depends on timing per worker block, so the case now requires
frames 2..27 clean and any later bad tile inside #list, without requiring the loss.
The callbacks pin keeps requiring its symptom, bounds it to the label and to half to
double of its measured size, and its message names the entry to delete. Wording says
multi-worker, not 4-worker.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* build(engine): keep the blur test helpers out of the published tarball

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): print the worst outside tile of each arm to explain the CI text diff

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test: both arms draw grayscale text so host subpixel settings are not read as blur

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(producer): run the multi-worker blur render alone so it cannot skew other Chrome tests

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test: re-pin the producer lane runner after splitting out the heavy blur render

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): read the blank-frame pin from a wrap observer, not an animation frame poll

The pin sampled in requestAnimationFrame, so it could miss the gap between the
wrap and the first draw. A MutationObserver now reads the output canvas the
moment the root is wrapped, which is deterministic, and every fixture must
report a wrapped root.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): drop the blurs field no fixture could set to false

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* ci: give the flake gate 60 minutes, it budgets runs by file count not time

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-04 17:55:07 +00:00
Miguel Ángel 04bc4737ad fix(producer): retry with fewer workers when every page times out loading (#7171) 2026-11-04 17:29:28 +00:00
WaterrrForeverandClaude Opus 5.5 cd7b7383cb fix(lint): flag a data-automation or data-fx-chain the render cannot read (#7169)
* fix(lint): flag a data-automation or data-fx-chain the render cannot read

A cue whose automation lane has no "version": 1 passed `hyperframes check`
and only failed at render: locally with "Unsupported automation version:
undefined", in the cloud with no cause at all. The new error
`audio_attribute_unreadable` reads each data-automation and data-fx-chain
envelope (JSON object, version 1, a lanes or nodes array, a target and
points per lane, a type per node) and names the element.

Lint cannot import the renderer's parsers from @hyperframes/core, which
depends on it, so core gains a parity test that fails if the two disagree
on any envelope case.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(lint): an empty data-automation or data-fx-chain is ignored, as the mixer does

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(lint): split the audio attribute shape check and raise the CLI size budget

audioAttributeShapeError splits its envelope and per-entry checks to stay under
the cognitive-complexity gate, and media.ts drops the added rule label comment.
The CLI's unpacked size was already 0.99% over its budget on main (23,958,7xx of
23,722,874); this rule adds about 2.4 KB of bundled code, which crosses the 1%
tolerance. The budget moves to 5% above the measured 23,961,054, as the budget
file's own headroom rule sets it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* style(lint): format the split audio attribute checks

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(ci): raise the lint package's unpacked size budget for the audio attribute rule

The rule and its envelope checks take @hyperframes/lint's unpacked size to 702,230,
just over 1% past its 695,173 budget. The budget moves to 5% above the measured size,
as the budget file's headroom rule sets it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 16:59:04 +00:00
Miguel Ángel 0bbc9b2943 fix(studio-server): splitting a clip that starts after another clip cuts where it plays (#7172) 2026-11-04 16:57:09 +00:00
Miguel Ángel 845bd638a7 fix(producer): a drive that refuses frame links gets a copy, whatever code it refuses with (#7163)
* fix(producer): a drive that refuses frame links gets a copy, whatever code it refuses with

* fix(producer): an entry already where the frames go still gets cleared and relinked

* test(producer): the relinked frame dir is read through its new link
2026-11-04 15:46:32 +00:00
Miguel Ángel ac1948a88b fix(engine): a full disk during frame extraction says so, not that the video is broken (#7161)
* fix(engine): a full disk during frame extraction says so, not that the video is broken

* fix(engine): a pass that filled the disk is not decoded again in software
2026-11-04 14:45:56 +00:00
TejashmakwanaandClaude Opus 5.5 21f2119194 docs: Discord in the top bar and footer, and each Discord link tagged by where it sits (#7153)
The docs site never linked the community server. Add it to the navbar beside
GitHub and to the footer socials. Every link already went to the new server
through the Dev Server invite, which tags joins "Joined: Dev Server"; the
README and ADOPTERS now use the server's GitHub invite and the docs use its
website invite, so joins are counted by where they came from.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 14:34:32 +00:00
Wenbo ZhuandClaude Opus 5.5 604a25fbaa fix(cli): address skills install and update hints to the person (#7160)
* fix(cli): address skills install and update hints to the person

DeltaVerdict D5 fails any text an agent reads that tells the agent to
install, update or remove skills, even when gated on the user. #7094 and
#7102 fixed the update notice and skills/; the scaffolded CLAUDE.md and
AGENTS.md, CLI output and the quickstart prompt still told the agent to
run `skills update`.

Reword them to state the fact and name the command the person runs
("For the user: ..."), matching the #7094 `_meta.updateNotice` style.
The two scaffold templates stay byte-identical. No behavior changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): address media-use repair and update --check hints to the person

Review follow-up on #7160. The media-use SFX repair error and its
`resolve --doctor` line still told the agent to run
`npx hyperframes skills update media-use`; `update --check` printed a
bare `Run: <cmd>`; and the README addressed agents directly. Reword them
in the "For the user:" form. The JSON `fix` field keeps the bare command.

Pin the wording in tests: both scaffold templates, the stderr nudge, the
`init --skip-skills` hint, the media-use error and doctor line, and the
`update --check` output.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 13:31:12 +00:00
Miguel Ángel b3b6a8116b fix(cli): a failed run exits 1 when its output pipe closes early (#7158)
* fix(cli): a failed run exits 1 when its output pipe closes early

* fix(cli): the EPIPE header comment no longer says it always exits 0
2026-11-04 13:23:06 +00:00
Miguel Ángel 1ff4cefd40 chore: release v0.9.12 (#7156) v0.9.12 2026-11-04 12:23:12 +00:00
Miguel Ángel 5cea10e76e fix(producer): fail a render once when its page never became ready (#7154)
* fix(producer): fail a render once when its page never became ready

* refactor(producer): keep the page-never-ready error private to its module

* test(producer): drop a mock field the page-never-ready test never set
2026-11-04 11:53:21 +00:00
Miguel Ángel 11f43268a1 fix(cli): name the refused file and parameter when a cloud upload is rejected (#7155)
* fix(cli): name the refused file and parameter when a cloud upload is rejected

* fix(cli): blame the file type only for type refusals at upload complete
2026-11-04 11:21:44 +00:00
Miguel Ángel 50ce9fb514 fix(cli): an output in a drive root (D:\) no longer fails before it is written on Windows (#7151)
* fix(cli): an output in a drive root (D:\) no longer fails before it is written on Windows

* fix(cli): keep the output folder helper's reason in its test

* fix(cli): make the output folder only when nothing is there, as the producer does

* fix(cli): keep the output folder's directory check and fix the stat mock that hid isDirectory
2026-11-04 10:47:39 +00:00
Wenbo ZhuandClaude Opus 5.5 6857bb08e8 docs(skills): stop directing the agent to install, update or remove skills (#7102)
A third-party skill-trust grader (DeltaVerdict D5) fails any skill text
that has the agent modify its own skills, even when disclosed or gated on
the user. Reword the skill lifecycle, plugin, CLI and scaffold text so it
states facts the agent can relay (skills are versioned with the CLI; the
person installs and updates them, and which command does it) instead of
commands for the agent to run. Every agent-run `init` example passes
--skip-skills, since init otherwise installs missing core skills; the
plugin header, plugin-cli and sfx messages are person-addressed; the
person's install commands are marked as theirs; /style-sampling joins
the on-demand lists. Regenerate skills-manifest.json and update the
pinned reverse init regex.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 10:17:14 +00:00
Miguel Ángel e04b722a99 chore: release v0.9.11 (#7152) v0.9.11 2026-11-04 10:16:08 +00:00
Wenbo ZhuandClaude Opus 5.5 7cb6018c6b feat(cli): surface outdated CLI and skills to agents; add hyperframes update --check (#7094)
* feat(cli): surface outdated CLI and skills to agents; add hyperframes update

Single commit of #7094 on top of main (no merge commits through the signed
GraphQL path). Includes: 2h update/skills check interval and stale-cache
recheck; `_meta.checkedAt`, `_meta.skillsOutdated`, `_meta.skillsMissing`;
`_meta.updateNotice`, one sentence for the agent to relay to the person, at
most once a day per project (brew/npx-aware command, omitted under CI, the
update-check opt-out and agent plugins); `hyperframes update [--check]
[--yes] [--json]` (CLI then skills at the installed CLI's tag; brew
version read back); doctor names the running binary and its channel; the
hyperframes-cli skill gets one line to pass the notice on, naming no
command. Keeps main's install-target skills check (#7120) in updateSkills.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(cli): update notice names a command that moves this install

- `_meta.updateNotice` (and `update --check`'s skills command) now name a
  command that moves the running install: a global npm/pnpm/bun/brew CLI
  runs its own `hyperframes update` (or just its manager's command when
  only the CLI is behind), since `npx hyperframes` would run a project's
  copy or a fresh npx one; a project-local CLI moves with its project's
  manager by lockfile (`npm install`/`pnpm add`/`bun add`/`yarn add
  hyperframes@<v>`), which `update --yes` now names too instead of
  `npx hyperframes@latest`.
- `update`'s confirmation hint states a fact and names no step for the
  agent: "Updating is the person's call; `update --check` only reports."
- `upgrade --json`, `upgrade --project --json` and every `skills` JSON
  output leave out `_meta.updateNotice` (NO_UPDATE_NOTICE), like `update`.
- dailyNotice: a null/non-object file reads as empty and is repaired; a
  future timestamp is stale; writes go through a 0600 tmp file + rename;
  withMeta never throws from the notice.
- Docs: --json without --yes exits 2; plugin `update` exits 1
  (plugin_managed); full `_meta` sample; per-install notice commands.
  `update --check` says "npm registry not reached" instead of "latest".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 09:31:52 +00:00
Miguel Ángel 76da5f6932 fix(cli): a credit limit the person names holds on every paid media call (#7145)
* fix(cli): a credit limit the person names holds on every paid media call

A limit was only a per-call --max-credits flag that each caller had to remember, so kit tools, voice resolve and transcribe could spend past it. The limit now lives in the project's credit-limit file and runJob, which every paid call goes through, refuses a new job past what is left (unpriced calls included). Voice and avatar video resolved through the heygen CLI are refused under a limit, since they cannot be priced there.

* fix(cli): keep a lost job's reserved credits, and hold the limit on the audio engine's voice

A resumed job refused with a status that says nothing about the job released its reservation while the job may still be running. Only the call that reserved releases, and only for a refusal that rules the job out. The audio engine's HeyGen speech call now refuses under a limit too.

* fix(cli): type withinLimit as returning whether it reserved

* chore: regenerate the skills manifest

* fix(cli): a credit-limit file is a run-time project file, and a lighter runJob catch

* chore(cli): mark runJob's complexity as accepted
2026-11-04 07:43:23 +00:00
Miguel Ángel 7e717189c5 fix(core): a host inside a scene keeps its own timeline when its file shares a composition id (#7143)
* test(core): two hosts in a scene whose files share an id get their own timelines

* fix(core): a host inside a scene keeps its own timeline when its file shares a composition id

* fix(core): the nested-host fallback is told by its docstring alone

* fix(core): the identity map's docstring keeps its length
2026-11-04 05:59:09 +00:00
Miguel Ángel 19be35a463 fix(cli): the voice a film uses is listed from the HyperFrames account, never the heygen sign-in (#7144)
* fix(cli): the voice a film uses is listed from the HyperFrames account, never the heygen sign-in

* fix(cli): drop a comment line and an unenforced range from the voices command
2026-11-04 05:51:12 +00:00
Miguel Ángel 183614bda3 chore: release v0.9.10 (#7128) v0.9.10 2026-11-04 02:25:21 +00:00
James Russo b02fe6506e fix(cli): check skill freshness at the install destination (#7120)
* fix(cli): check skill freshness at the install destination

* fix(cli): report foreign skill requests while offline
2026-11-04 01:45:59 +00:00
Miguel Ángel c5a5e08827 feat(cli): billing and upgrade links carry the signed-in workspace (#7103) 2026-11-04 01:37:52 +00:00
Miguel Ángel d21877eb20 feat(cli): billing top-up is renamed to add-credits with no alias (#7121) 2026-11-04 01:34:12 +00:00
Miguel Ángel e46ecd850e fix(cli): check ignores the cancelled fetch of a proxy-swapped media file, not a broken image (#6928)
* fix(cli): check ignores the cancelled fetch of a proxy-swapped video in any container

* fix(cli): check ignores the cancelled fetch of a proxy-swapped media file, not a broken image
2026-11-04 00:25:01 +00:00
Miguel Ángel f487a20b28 fix(cli): check waits for the composition as long as snapshot and render do (#6947)
* test(cli): check waits as long as snapshot for the composition by default

* fix(cli): check waits for the composition as long as snapshot and render do

* docs(cli): check's --timeout default matches snapshot and render

* fix(cli): check's render-ready warning advises a --timeout above the new default

* fix(cli): drop the doc comment on the render-ready warning suffix

* style(cli): format checkBrowser.ts
2026-11-03 23:52:11 +00:00
Miguel Ángel 3adc9f130d fix(cli): media-use sends a picture on a machine with no ffmpeg (#7112)
* fix(cli): media-use sends a picture on a machine with no ffmpeg

* fix(cli): pictures fall back to ffmpeg when sharp cannot load

* fix(cli): drop two comments the names already carry
2026-11-03 23:51:38 +00:00
Miguel Ángel 482bcd73ed fix(cli): the FFmpeg cannot-start error names the OS error code or signal (#7115)
* fix(cli): the FFmpeg cannot-start error names the OS error code or signal

* fix(cli): drop a comment the check counts

* test(cli): a timed-out FFmpeg reads as the timeout, not its kill signal
2026-11-03 23:29:40 +00:00
Miguel Ángel 87a42e7470 feat(cli): billing shows the price and pays from the terminal on Enter (#7068)
* feat(cli): billing top-up becomes add-credits, top-up stays as an alias

* fix(cli): keep the skills manifest and core-skills test in step with add-credits

* revert: leave the core-skills test to its own PR

* feat(cli): billing shows the price and pays from the terminal on Enter

* fix(cli): the top-up page opens at the credit packs

* test(cli): billing tests cover the checkout offer with no terminal

* fix(cli): the purchase wait runs while Press Enter is open
2026-11-03 23:24:53 +00:00
Miguel Ángel d88d2cce4b fix(cli): templates pull reuses only a template it pulled, not any path in the way (#7116)
* fix(cli): templates pull reuses only a template it pulled, not any path in the way

* fix(cli): templates pull names an older pull, with the reasons in names, not comments
2026-11-03 23:22:39 +00:00
Miguel Ángel e2edc93f5f fix(producer): a laptop that sleeps mid-render no longer counts the sleep as a capture stall (#7096)
* fix(producer): a laptop that sleeps mid-render no longer counts the sleep as a capture stall

* style(producer): format the stall watchdog timers
2026-11-03 23:11:32 +00:00
Miguel Ángel 3dc82f18e3 fix(producer): a stalled capture resumes at the first unwritten frame, not frame 0 (#7104)
* fix(producer): a stalled capture resumes at the first unwritten frame instead of frame 0

* fix(producer): a page that keeps stalling falls back after three resumes instead of resuming forever
2026-11-03 22:25:52 +00:00
Miguel Ángel 9304d73ec8 test(skills): core-skills test matches the reverse start wording (#7114) 2026-11-03 22:14:13 +00:00
WaterrrForever 341fdd353c docs(skills): reverse-any-video runs sign-in and payment itself and opens the result (#7101)
* docs(skills): reverse-any-video runs sign-in and payment itself and opens the result

From Wenbo's end-to-end reverse test (F1, F2, F8, F9, F12, F13):
- the person types nothing: the agent runs auth login, billing subscribe and
  billing top-up itself and gives each page as a clickable link
- never sign in with an API key to get past Pro
- reverse start's plan is final; auth status is read only for a null plan,
  and its hyperframes field, never user.subscription
- an old CLI without reverse start: run this run as npx -y hyperframes@latest
- hand over: side by side from diff --sbs, Studio preview, Framey line
- animated shots: cut the guide inside a dissolve, retime each generated shot

* docs(skills): reverse sign-in names --device, reads auth status --json, trims dissolve frames

Rames's three wording notes on #7101, and the old-CLI subscribe line now
applies only to a plugin's pinned CLI, beside main's null upgrade_url rule.

* docs(skills): a plugin whose CLI can't reverse stops before payment

Jerrai on #7101: the plugin fallback sent the person to subscribe when the
pinned CLI has no reverse start, so the run could not go on after paying.
It now stops and says the plugin needs updating.
2026-11-03 20:05:22 +00:00
Miguel Ángel 3aaed65ef6 fix(check): the analysis restarts the idle window with every call it makes (#6919)
* fix(check): the analysis restarts the idle window with every call it makes

* test(check): runAuditGrid's analysis must use the progress-reporting driver
2026-11-03 19:47:13 +00:00
Miguel Ángel 3a28ef41ae perf(studio): a long film's media durations write the store once per file, not once per clip (#6745)
* fix(studio): a film that cuts one file into many clips plays smoothly while their durations load

* test(studio): the metadata test counts one store write per file
2026-11-03 18:54:17 +00:00
Wenbo ZhuandClaude Opus 5.5 a5a6121332 fix(cli): don't invent a purchase link when the server withholds upgrade_url (#7031)
reverse/start answers upgrade_url: null when no plan can be bought right
now. The CLI treated that like a missing field and built its own plans
link, so a Free account under gate "block" was sent to a page where it
can't buy. Now null means no link anywhere: the JSON prints
upgrade_url: null and subscribe_command: null (billing subscribe would
open that same plans page), the refusal says a plan can't be purchased
right now instead of naming the subscribe command, and the skill runs
nothing and passes on no link. Only an absent field (an older server)
falls back to the plans page; a string is used as is.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 16:47:05 +00:00
WaterrrForeverandClaude Opus 5.5 faae6017dd refactor(cli): templates pull unpacks the verified pack from memory (#7084)
The pack was written to a temporary file before tar read it. tar now
reads the checked bytes on stdin, so nothing downloaded is written to
disk before it is unpacked.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 16:25:14 +00:00
WaterrrForever 12ce8c2ffd chore: release v0.9.9 (#7095) v0.9.9 2026-11-03 11:28:41 -05:00
Miguel Ángel 1071ff35a7 docs: point the Discord links at the new community server (#7097) 2026-11-03 10:44:08 -05:00
Miguel Ángel 67d11c0a5c fix(engine): a script the page cancelled is not a failed load (#7093) 2026-11-03 15:00:39 +00:00