Commit Graph
6799 Commits
Author SHA1 Message Date
Miguel Ángel d810bdbb27 fix(cli): init no longer crashes copying into a folder at a Windows drive root (#7220)
* fix(cli): init no longer crashes copying into a folder at a Windows drive root

* fix(cli): keep copyDirSync's comment to one line
2026-11-05 07:00:55 +00:00
James RussoandClaude Opus 5.5 d452a6fad4 feat(registry): add path-traced-3d example with raster preview and path-traced export (#7219)
* 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>
2026-11-05 06:40:37 +00:00
Vance IngallsandClaude Sonnet 5.5 898d0fb00b fix(core): blur scan and eventful reads put back the DOM a timeline call changed (#7191)
* fix(core): blur scan and eventful reads put back the DOM a timeline call changed

With data-motion-blur-events on, the mover scan runs the timeline to the end with
callbacks on and rewinds with callbacks on. GSAP fires a tl.call on a backward
crossing too, so the rewind left the earliest call's DOM effect in place: the
callbacks fixture showed label "B" from frame 0, before its 0.5 s call.

Calls cannot be un-fired, so the scan (and eventful per-frame reads) now journal
DOM mutations with a MutationObserver, land on the frame with callbacks on as
before (keeping JS-side call parity), then undo the journal back to the
pre-scan DOM, which is what a plain seek to the frame produced.

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

* test(engine,producer): callbacks label-early pins become ordinary outside cases

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

* perf(core): the DOM undo skips attributes and text already back at their old value

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

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-05 06:38:51 +00:00
WaterrrForeverandClaude Opus 5.5 060e6e4a12 fix(cli): billing stops checkout work once the payment wait ends, even mid sign-in refresh (#7216)
* 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>
2026-11-05 06:14:27 +00:00
WaterrrForever 1fecf5b82a fix(cli): two CLI fixes from Wenbo's reverse test (paywall link, plan label) (#7099)
* 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.
2026-11-05 05:50:59 +00:00
WaterrrForeverandClaude Opus 5.5 6728b82e63 fix(cli): reverse start makes its --dir project, and init takes the video already in it (#7089)
* 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>
2026-11-05 05:41:24 +00:00
WaterrrForeverandClaude Opus 5.5 823cd126ee fix(cli): measure reads an odd-sized box exactly (#7090)
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>
2026-11-05 05:31:40 +00:00
Miguel Ángel fa1942d5ac fix(cli): timeline apply checks the overlap of a plan's end state, not each step (#7214)
* fix(cli): timeline apply checks the overlap of a plan's end state, not each step

* fix(cli): drop two doc comments from the plan end-state check
2026-11-05 05:16:08 +00:00
James RussoandClaude Opus 5.5 f3e5b81dfe test(engine): pin the motion blur sweep defects A to O by their symptoms (#7149)
Adds 13 text-free fixtures from the 60-composition capture motion blur
sweep and one test per defect, each pinned by its current symptom so it
fails once the fix lands. Pins use the existing outside and inside
invariants where they see the defect, and a second check against the
engine's 32-sample sub-frame blur where they do not (E, J, K, M).

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-11-05 04:59:48 +00:00
Vance IngallsandClaude Sonnet 5.5 aa34cffe4b fix(core): a scrolled list keeps its offset when blur moves the root (#7190)
* fix(core): a scrolled list keeps its offset when blur moves the root

Chrome resets a scrolled container's offset when the root leaves or enters the
document, so the first blurred frame of a fresh page or render worker drew the
list at offset 0. Offsets are read at move time and put back before the re-seek,
so a container that became scrollable after the scan is covered too.

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

* test(engine): scroll-list is an ordinary outside case, not a pinned known bug

The scroll offset now survives the root's move, so the three engine differential
cases and the multi-worker render case expect blur on to equal blur off, and the
measured constants for the old symptom go.

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

* chore(core): drop the scroll-offset comment, the comment-share ratchet may only fall

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

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-05 04:59:44 +00:00
Ular Kimsanov 4ba47aaa12 docs: download links name where the visit began (#7197)
* docs: download links name where the visit began

Docs download links carry the visit's source (ref, utm_*, ad-click kind), like the
homepage's links. Mintlify's Card download button now carries them and the PostHog id
it was dropping.

* docs: keep the attribution comment to public names

* docs: take over only the Card's click, so Mintlify's own link handlers still run

Stopping every download click hid the navbar CTA's docs.navitem.cta_click. Only Mintlify's
Card (data-client-link) ignores a changed href; every other link is followed by the browser
from the tagged href, as before. A source restored from storage carries only its own names.
2026-11-05 04:47:19 +00:00
Miguel Ángel e976fdbfa1 fix(lint): a video gets no timing from its wrapper, and the docs and hints stop implying it (#7210) 2026-11-05 04:46:11 +00:00
Miguel Ángel 7862e271d1 fix(cli): check skips a contrast sample measured over a layer that is mid-motion (#7205)
* 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
2026-11-05 04:16:27 +00:00
heygen-rui-bot 3b3d7c2cd3 chore(codegen): resync cloud client from EF dd7ca48f (#7207) 2026-11-05 04:10:45 +00:00
Vincent Yip bdf9ba0ee6 feat(studio): alt marquee removes the covered items from the selection (#5680)
* feat(studio): alt marquee removes the covered items from the selection

Shift already adds marquee hits to the selection on the canvas and the
timeline; there was no way to take a few items back out of a large
selection. Both marquee paths now carry a MarqueeSelectionMode
(replace | add | subtract) resolved from the pointer modifiers in one
helper, with Alt winning over Shift. Subtracting the primary re-anchors
on a surviving member; subtracting everything clears the selection. The
band and candidate outlines turn the danger colour while subtracting.

Closes #5586

* fix(studio): same alt marquee rules on the canvas and the timeline

Both surfaces now let the modifiers held at release decide: the timeline
re-applies the marquee from the pointerup event before it finishes, so
letting go of Alt mid-drag turns a subtract back into a replace, as the
canvas already did. Alt at pointerdown no longer bakes a timeline base
mode; Cmd/Ctrl still sets add. While subtracting, the canvas outlines
only candidates that are in the current selection, so the band never
suggests removing something that is not selected. The timeline commit
helpers move to timelineMarqueeCommit.ts to keep the hook under the
file-size cap.
2026-11-05 04:09:52 +00:00
cooleryu 982070388e fix(core): stop script loading time from shifting WAAPI frames (#5017) 2026-11-05 03:13:48 +00:00
JasonandWhoosh 6e8454d6d5 fix(cli): bound the loopback Studio probe so a dropped connection costs 1 s, not 10 (#6466)
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>
2026-11-05 02:38:12 +00:00
Miguel Ángel 924bb64da6 fix(cli): lint and check accept --lint-verbose, and two skills stop teaching --describe false (#7201) 2026-11-05 02:22:27 +00:00
Jerrai 58b9ec0eff feat(cli): print the render's reference_background as an @hf-result line and in batch manifest rows (#7203)
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.
2026-11-05 02:19:38 +00:00
kevin 071ec1fddd fix(runtime): fail readiness waits when a buildReady promise rejects (#5746)
A rejected window.__hf.buildReady hold now sets window.__hfStartupError naming the key and the
reason, so render, snapshot and check fail instead of capturing a scene that was never built.

Fixes #5603
2026-11-05 02:15:44 +00:00
WaterrrForever 33c17df5ae chore: release v0.9.15 (#7202) v0.9.15 2026-11-05 02:08:44 +00:00
Miguel Ángel e2a6535860 fix(core): a paused preview lets go of the scenes it has unmounted (#7195)
* fix(core): a paused preview lets go of the scenes it has unmounted

* fix(core): a paused scrub also lets go of the scenes it has unmounted
2026-11-05 01:52:51 +00:00
Miguel Ángel 2372fc34a1 fix(cli): a browser install goes on when Windows holds a file for a moment (#7194)
* 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
2026-11-05 01:50:43 +00:00
WaterrrForeverandClaude Opus 5.5 f6ae9bfb43 fix(producer): duration normalization encodes from the delivery PCM, so a compliant mix is never cut (#7199)
* fix(producer): pad/trim audio from the delivery PCM, not its own AAC

The assemble stage's duration fix decoded audio.m4a and encoded it again.
That second AAC generation read about 2 dB hotter on a measured mix
(-1.8 dBTP out of the audio stage, +0.2 after the trim), so the whole-mix
cut then lowered an already compliant film by 3.4 dB, overshooting to
-2.5 dBTP. A sibling project with a slightly louder music bed escaped the
cut, so the two landed about 4 LU apart.

- The local render keeps the audio stage's PCM in the work dir until
  assembly; pad/trim and any peak correction there encode from it.
- A whole-mix cut in the audio stage is applied to that PCM too, so it
  still encodes to exactly the delivered AAC. If it cannot be rewritten
  it is removed and assembly falls back to the AAC.
- The distributed plan does not keep the PCM, so its plan dir is unchanged.

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

* refactor(producer): name the assemble stage's PCM input by what it is

The comment-ratchet does not let assembleStage.ts gain a comment line, so
the new input says what it holds in its name instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXN7wsMK6GqT3MNtqXw

* fix(producer): assembly never reuses a PCM whose delivered cut was not applied

When the audio stage cuts the whole mix and then fails to rewrite the kept
PCM, it tries to delete the PCM. Deletion is best-effort and can be refused,
for example on Windows, so the uncut PCM could stay on disk. The audio stage
handed it to assembly because the file still existed, and assembly would
then re-encode a mix louder than the AAC that was actually delivered.

The cut now reports when the PCM no longer matches the delivered AAC. The
audio stage keeps the PCM only on an explicit success, not because the file
exists, and assembly otherwise falls back to the verified AAC.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXN7wsMK6GqT3MNtqXw

* test(producer): the fake-FFmpeg PCM rewrite writes its output

The true-peak correction now rewrites the kept PCM with FFmpeg and reports
the PCM as stale when that output never appears. The fake FFmpeg in this
test answered the rewrite without writing anything, so a correct run looked
like a failed rewrite. The fake now writes the output, as real FFmpeg does.

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>
2026-11-05 01:39:01 +00:00
Vance IngallsandClaude Opus 5.5 aace91b5ec feat(core): data-motion-blur-phase sets when the shutter opens (#6983)
* 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>
2026-11-05 01:26:35 +00:00
Miguel Ángel 15b1de4aeb chore: release v0.9.14 (#7192) v0.9.14 2026-11-05 01:05:50 +00:00
James Russo bd6cff8157 docs(skills): explain update names and local YAML repair (#7196) 2026-11-05 01:01:31 +00:00
Michael WangandClaude Opus 5.5 a6e6717f2a feat(cli): checkout links name the CLI and the skill that sent them (#7177)
* 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>
2026-11-05 00:23:20 +00:00
Michael WangandClaude Opus 5.5 b503e55098 feat(skills): every published skill reports its own run (#7176)
* 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>

* fix(skills): say the usage beacon goes out with the CLI's usual telemetry

The beacon line said it sends only the skill's name. The events command uses
the CLI's normal telemetry, which also carries machine details, the install
id and, when signed in, the account. The line now says so.

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

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 23:32:35 +00:00
Michael WangandClaude Opus 5.5 fa318d9727 feat(cli,docs): links to our sites say where they came from (#7178)
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>
2026-11-04 23:19:51 +00:00
Miguel Ángel 4d9a4e4e86 fix(cli): keep OpenRouter as a vision provider for capture (#7189)
* fix(cli): keep OpenRouter as a vision provider for capture

Reverts #7188.

* fix(cli): shorten the restored thinking budget comment
2026-11-04 22:43:24 +00:00
Miguel Ángel 60ca970ed6 fix(cli): tell a failed billing checkout apart from a payment not finished in time (#7185)
* 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
2026-11-04 22:39:42 +00:00
Miguel Ángel af0c815c72 fix(fonts): stop failing cloud renders on var() shorthands, font-X-400 names and linked font sheets (#7166)
* fix(fonts): stop failing cloud renders on var() shorthands, font-X-400 names and linked font sheets

* style(producer): shorten the project font sheet comment

* style(core): shorten the field font families test header

* fix(fonts): split font size parsing and fit the CLI size budget

* fix(producer): read project font sheets for family names only, never fetch from them
2026-11-04 21:42:59 +00:00
Miguel Ángel 2ac011422e refactor(cli): remove OpenRouter as a vision provider for capture (#7188)
* 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
2026-11-04 21:37:59 +00:00
Ular Kimsanov b2b034fcd8 docs(catalog): a search box over the cards; it fills the ?q= filter the gallery already reads (#7147)
* 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

* docs(catalog): a search box over the cards; it fills the ?q= filter the gallery already reads

* 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 21:34:22 +00:00
Ular Kimsanov 054cf4f119 docs(nav): the docs menu button names the section you are in (#7133) 2026-11-04 21:33:35 +00:00
Ular Kimsanov 97b805dcbd docs: drop the hidden add-a-transition button; hand-off now works on windows and linux (#7132) 2026-11-04 21:33:34 +00:00
Ular Kimsanov c3eb052545 docs: say HyperFrames is free, and what the Studio app's Pro plan adds (#7131)
* docs: say HyperFrames is free, and what the Studio app's Pro plan adds

* docs(readme): the app picture's alt text names windows too

* docs(faq): the free plan's exact monthly numbers, from the live pricing page
2026-11-04 21:33:31 +00:00
Miguel Ángel 2f321e0b0b ci(studio): the studio-open journey counts the same thumbnails on every runner image (#7187)
At 900 px the root composition card sat on the edge of the list's thumbnail margin, so a small layout change between runner images decided whether it asked for a thumbnail. A 1400 px window puts every card well inside it.
2026-11-04 21:25:49 +00:00
Miguel Ángel c6f87f59b0 fix(cli): check copies only the stretch of a video it plays and stops after 2 minutes of copies (#7182)
* 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
2026-11-04 21:16:31 +00:00
Miguel Ángel 21e2038595 fix(cli): report why a reverse session could not be recorded (#7186) 2026-11-04 21:13:20 +00:00
Miguel Ángel be8122d0c4 fix(cli): check thins its craft samples when frames are slow, so the pass ends near 90 seconds (#7183)
* 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
2026-11-04 21:04:35 +00:00
Miguel Ángel 00ea86570a fix(cli): a command waiting on the project lock says what it waits for (#7184)
* fix(cli): a command waiting on the project lock says what it waits for

* fix(cli): the project lock timeout says to run the command again
2026-11-04 21:01:53 +00:00
Miguel Ángel 73e65e2c78 fix(engine): a background image that never finishes decoding no longer stalls the frame (#6972)
* fix(engine): a background image that never finishes decoding no longer stalls the frame

* fix(engine): capture tolerates a page that returns no list of late background images

* fix(engine): a background decode timeout is reported at every caller, url redacted

* fix(engine): a relative background url keeps only its path in the decode timeout report
2026-11-04 20:41:50 +00:00
Miguel Ángel cffd70f2f9 fix(cli): a track with no beats answers an empty result, not an error (#7173)
* fix(cli): a track with no beats answers an empty result, not an error

* fix(cli): keep beats run under the complexity gate
2026-11-04 20:21:59 +00:00
Miguel Ángel 2679bcdee7 ci(studio): the timeline viewport gate runs one pinned Chrome build, not the runner's (#7180)
The runner image ships Chrome 156.0.8078.47 or .79 run to run, and .79 renders one more thumbnail on open, so the studio-open ceilings failed on changes that never touched Studio. The ceilings file now records the major it is measured on.
2026-11-04 19:44:23 +00:00
Miguel Ángel 3d78ac0fa6 fix(core): a logo image no longer renders stretched to the frame bottom (#7179)
* fix(core): a logo image no longer renders stretched to the frame bottom

* style(core): name the image layout exception instead of commenting it
2026-11-04 19:11:32 +00:00
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