* fix(cli): capture takes a refused screenshot once more before naming it
* fix(cli): keep the screenshot retry's doc to one line
* test(cli): refuse the same capture shot twice now that one refusal is retried
* fix(engine): headline a pending setup as a setup timeout, not zero duration
When the runtime never reaches render-ready, __hf.duration reads 0 because
the bridge masks it, so pollHfReady's timeout reported "Composition has zero
duration" even for compositions with a declared data-duration whose
window.__hf.buildReady promise was still pending. Headline that case as
"Composition setup did not finish within <timeout>ms", skip the duration
inference hint that cannot apply yet, and note that the render clock stays
at 0 until the first frame. Keep its transient retry classification and give
it its own CLI diagnostic code.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(engine): name animation frames in the setup-timeout hint
Setup that awaits requestAnimationFrame hits the same render-clock rule as
setup that waits on Date or performance.now: frames only fire on a seek, and
the first seek waits for setup. Say so, and point at the waits that work.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(engine): stop suggesting scheduler.yield() for setup waits
Chrome runs scheduler.yield() continuations ahead of ordinary tasks, so a
setup loop that polls with it starves the setTimeout-driven work it waits on
(Three's compileAsync polls with setTimeout(10)) and never finishes. Plain
headless Chrome 152 hangs on a ten-line page that does exactly that. Point
authors at setTimeout and say why yield-polling does not work.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(engine): point setup waits at the library's readiness promise
HyperFrames guidance is no system timers, so the hint should not tell authors
to wait with setTimeout. Point them at the library's own readiness promise
(Three.js renderer.compileAsync) and keep the warning about scheduler.yield()
polling loops.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(engine): keep the setup-timeout hint to what it can diagnose
A scheduler.yield() polling loop starves the page, so the readiness poll never
returns and the render reports a capture stall instead of this message. Drop
that sentence; the hint covers animation-frame and clock waits only.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(registry): add path-traced-3d example with raster preview and path-traced export
An opt-in Three.js starter: previews with raster rendering and exports with
three-gpu-pathtracer, from one scene file. three 0.180.0, three-gpu-pathtracer
0.0.24 and three-mesh-bvh 0.9.5 ship as one local, pinned ES module with their
licences and a rebuild recipe, so renders make no network requests and 2D
projects never load the tracer.
Setup is one buildReady promise that awaits library readiness promises only
and ends with a throwaway frame and a one-pixel readback. Frames are drawn in
the hf-seek listener through waitUntil, each time from zero with a fixed
sample count. Math.random is seeded while the scene and tracer are built,
because object ids order light sampling and the tracer's noise textures come
from it.
Adds a skill reference and a docs guide for the setup and seek contract, the
frozen clock, why scheduler.yield() waits hang, and sample/bounce cost.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(registry): list path-traced-3d in CLI docs and tighten its notes
Add the example's section to the CLI examples doc, which docs.test.ts
requires for every registry example. Throw if the tracer reports compiling
but exposes no compile promise, instead of spinning renderSample(). Say that
three's object uuids set the tracer's sort order, that later-created objects
need the seed too, and that Date and performance.now read the current seek
time during a render rather than staying at 0.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(cli): billing stops checkout work once the payment wait ends, and a token refresh can't hang it
The wait for a purchase ends when the account shows it or at --timeout.
Checkout work still in flight then kept going: a price read that answered
late still created and printed a checkout, an Enter-time checkout that
answered late still opened Stripe, and the command waited on that work
past the purchase or the deadline. A token refresh with no deadline could
hold any of these reads forever.
readPlan, readOffer and createCheckout take the wait's stop signal, joined
with their own deadline, and stop waiting on a sign-in refresh once it
fires. Billing checks it after the price read and after each checkout
before printing or opening anything. The token refresh POST gives up
after 20 s.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXN7wsMK6GqT3MNtqXw
* refactor(cli): billing's checkout failure and its two billing reads each live in one place
The comment-share ratchet and the fallow audit failed on #7216: a new comment
in billing.ts, readPlan and readOffer repeating the same eight-line request,
and offerCheckout over the complexity threshold. The reads share getBilling,
the failure report moves to reportCheckoutFailure, and the comment goes.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXN7wsMK6GqT3MNtqXw
* fix(cli): billing's stop signal fires at --timeout, not only when the poll returns
The checkout path stopped once the polling task ended, but the poll's
readPlan carried no signal. A poll read stalled across the deadline kept the
signal live, so a held offer could still create and print a checkout after
--timeout. A timer now aborts the controller at the deadline on its own, the
initial and polling plan reads take the same signal, and the deadline counts
from the start of the command.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXN7wsMK6GqT3MNtqXw
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* feat(cli): a paywall refusal carries its page link in its own url field
An agent hit the Pro paywall, found the link only inside the fix sentence,
and handed the person a shell command instead of the page. The link now
also comes as url.
* fix(cli): auth status says hyperframes is the plan, not the HeyGen app's
An agent read user.subscription.plan (the HeyGen app's pro) as the
HyperFrames plan and ran past Free. With the HyperFrames plan read,
billing_notice now names which is which.
* fix(cli): a paywall refusal with url null names no purchase link
HeyGen sends url: null when it can't sell to this account right now. The
refusal now says so and carries no link, as reverse start does since #7031;
a missing url (older server) still gets the plans or credits page.
* fix(cli): reverse start makes its --dir project, and init takes the video already in it
Bug bash: production has no reverse/start route yet, so every run came back unrecorded,
and reverse start then made no folder and no hyperframes.json. The agent downloaded the
video into the folder it named, and init refused it as not empty, so agents moved files
around. reverse start now makes --dir and stamps it with the skill when no session is
recorded, and init accepts a folder whose only other files are its --video or --audio.
* refactor(cli): say in names what the comments said, so the comment share holds
* fix(cli): init keeps an in-folder source safe, and saved_to only names a stamped config
- Only an audio or video file in the folder counts as the source; a file named
index.html, meta.json or AGENTS.md is refused, so the scaffold never writes over it.
- An in-folder .mp4 that needs transcoding goes to <name>.h264.mp4 beside it,
instead of being both ffmpeg's input and output.
- reverse start names saved_to only when hyperframes.json now holds the skill;
a broken config is left as it was and saved_to is null.
* fix(cli): init transcodes an in-folder .MP4 beside it on case-insensitive disks too
original.MP4 and original.mp4 are one file on macOS and Windows, so the
same-file check now ignores case. The test's ffprobe call gets its --.
* fix(cli): init tells the source in the folder by the file, not its spelling
On a case-blind disk --video original.mp4 names Original.MP4, so the folder
check and the copy now compare device and inode; a source named in another
case is accepted and never copied onto itself.
* fix(cli): init transcodes only to a name with nothing at it, so a linked alias is never the output
The folder guard admits every alias of the source by file identity, but the
transcode output was chosen by path spelling. A hard link or symlink at
name.mp4 or name.h264.mp4, or a source named through a linked folder, made
FFmpeg (-y) rewrite the original. The output is now the first of name.mp4,
name.h264.mp4, name.h264-2.mp4, ... with nothing at its path (lstat, so a link
counts), which also covers a case-only spelling on a case-blind disk.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXN7wsMK6GqT3MNtqXw
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
A crop on yuv420p rounds an odd size or offset down to even. readClip
split the 32x32 output as 33x33 bytes, so a 10-frame clip came back as
9.4 frames and every frame after the first was misaligned; an odd offset
also shifted the chroma. Raw reads now convert to rgb24 (or gray) before
the crop, which is exact at any size and place. extract and diff stay on
yuv and add exact=1.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): check skips a contrast sample measured over a layer that is mid-motion
* fix(cli): move the backdrop overlap read out of sampleOf, and add no comment lines
* fix(cli): shorten the measuredInMotion comment
Some hosts drop a connection to a closed loopback port instead of refusing it
(WSL 2 mirrored networking, a firewall in stealth mode). The Vite Studio probe
on 127.0.0.1:5190 then waits for fetch's 10 s connect timeout, and since
every render, check and snapshot looks for a Studio through the history owner,
each of them paid 10 s. Aborting the fetch does not help: the connect attempt
keeps its socket, and the process, alive for the full 10 s.
The default probe now connects with node:net under a 1 s bound and destroys
the socket, then fetches only from a host that accepted.
Co-authored-by: Whoosh <nhatkha1407@gmail.com>
A piped, non-quiet local render now writes one versioned @hf-result JSON line
after success. Batch manifest rows carry the same reference_background value.
* fix(cli): a browser install goes on when Windows holds a file for a moment
* chore(cli): shorten the lock-retry comment
* fix(cli): keep the lock check private
* chore(cli): wrap the lock-check comment
* feat(core): data-motion-blur-phase sets when the shutter opens
Page motion blur always centres the shutter on the frame. Add a phase in degrees of a
frame, -360 to 360: the window starts at t + phase / 360 / fps and lasts shutter / 360 /
fps. Unset stays centred, so a page without the attribute renders the same bytes.
Both tiers take the window from one place, shutterTimes in frames.ts.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* feat(core): the motion blur report carries the shutter phase
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* chore(core): drop the phaseDeg doc comment, the comment-share ratchet may only fall
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* feat(skills): every published skill reports its own run
`hyperframes events --skill=<name>` exists so a skill can say it ran, but
only reverse-any-video and figma asked the agent to call it, so the other
skills' use was invisible. Each of the nine published skills now opens with
a one-line usage beacon naming itself. The line says what it sends (the
skill's name only) and that the telemetry opt-out applies. The router's
`init` line also passes `--skill=hyperframes`, so renders of new projects
carry the skill.
check-core-skills fails a core skill that lacks its own beacon; each core
skill's size budget grows by 192 B for the line.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* feat(cli): checkout links name the CLI and the skill that sent them
Only `billing subscribe` marked its pricing link `from=cli`, and the
terminal's Press-Enter Pro checkout sent no return page, so a purchase made
from the terminal looked like one made on the site. Now:
- `pageUrl` adds `utm_source=cli` and `skill`: the one named, else the
project's own `authoringSkill` from hyperframes.json.
- `billing` takes `--skill`. The terminal Pro checkout returns to the plans
page marked `from=cli&skill=...`, and retries without the return page if
the server does not allow it.
- Pricing links the server hands back (reverse's upgrade link, a refused
media call's link) gain `from=cli` and the skill when they lack them.
- The Pro gates name their skill: reverse -> reverse-any-video, templates ->
style-sampling, paid media calls -> media-use, in the CLI's printed fix and
in those skills' billing commands.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): report a refused checkout return page, and say where --skill goes
When the server refuses the terminal checkout's return page, the CLI still
sells Pro without it, but that purchase loses its CLI origin. A
cli_billing_checkout_return_refused event now makes that visible.
The --skill help said the skill is recorded with the purchase. It is sent
with the pricing link; the purchase itself does not store it yet.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
README links to hyperframes.studio, hyperframes.heygen.com and heygen.com
carry utm_source=github&utm_medium=readme, the values the README's download
links already use. Three README links went through docs redirects that drop
the query string (/showcase, /guides/claude-design, /guides/open-design);
they now point at the pages themselves.
The docs navbar's Community and changelog links carry src=docs-navbar, and
the export page's reinstall link src=docs-export, beside the existing docs-*
tags.
Links the CLI prints to our sites (init's docs links, the Lambda docs, the
publish claim URL, the HeyGen API-key page) carry utm_source=cli. Discord
invites stay untagged.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): tell a failed billing checkout apart from a payment not finished in time
* fix(cli): keep waiting for payment after a failed billing checkout
* refactor(cli): split billing checkout opening out of offerCheckout
* refactor(cli): remove OpenRouter as a vision provider for capture
* refactor(cli): tidy comment and formatting after OpenRouter removal
* refactor(cli): shorten the thinking-budget comment
* chore(skills): refresh the skills manifest for the film reference
* fix(cli): check stops after 2 minutes of video copies and says how to finish
* fix(cli): check copies only the stretch of a video the composition plays
* docs(cli): check copies only the played stretch of a long video
* docs(cli): shorten two comments on the copy window
* fix(cli): finding crops and frames get the same copy windows as the check
* fix(cli): drop a comment the ratchet counts
* refactor(studio-server): keep runFfmpeg under the complexity gate
* fix(cli): check thins its craft samples when frames are slow, so the pass ends near 90 seconds
* style(cli): format the craft loop
* fix(cli): cap the craft stride so the widened grid stays under the dead-stretch threshold
* 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>
* 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
* 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>
* 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>
* 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>
* 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
* 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
* 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>
* 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
* 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
* 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
* 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
* 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
* 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