* 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
* 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
* 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
* 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>
* 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>
* 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
* 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
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>
* 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(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
* 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
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>
* 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
* 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
* 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
* 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
* 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
* 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
* 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.
* fix(check): the analysis restarts the idle window with every call it makes
* test(check): runAuditGrid's analysis must use the progress-reporting driver
* 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
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>
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>
* fix(studio-server): a render that ran over 5 minutes can still be read after it finishes
* fix(studio-server): keep the finished-jobs helper's reasoning in its names
* feat(engine): a script-load failure names where the script came from and why it failed
* fix(engine): keep the script-load cause helpers private and within the engine size budget
* fix(cli): no auto-update across 0.x minors; install skills at the CLI's release tag
- autoUpdate: before 1.0 a minor bump counts as a major one, so 0.8.x -> 0.9.x
is a notice, not a silent background install. From 1.0 on, the major alone.
- skills: `skills update` / bare `skills` / `init` install from
heygen-com/hyperframes#v<VERSION>, and `skills check` plus the background
freshness nudge read the manifest at the same tag. A build the repo has no
tag for (dev build) falls back to main, as before.
- skills: run the upstream installer as `npx skills@1.7.4` instead of an
unpinned `npx skills`.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): keep the comment share of the touched files from rising
Comment ratchet: trim the comments added in the previous commit. No code change.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): pass the CLI version into the skills check instead of importing it
scripts/clawhub-unlist-retired.mjs loads skillsManifest.ts from source under
plain node, which cannot resolve a relative `../version.js` import. Callers now
pass `cliVersion` (and skillsSourceRef takes it as an argument), so the module
keeps importing only node builtins.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): read skills at the CLI's tag without a probe; pin skills@1.5.13
- A release build reads the manifest at its own tag directly (publish pushes
the tag before npm publish). Only a 404 for that manifest falls back to main;
a timeout, missing git or proxy error now surfaces instead of quietly
comparing against main, so the background nudge can't cache a false
"outdated" count.
- checkSkills returns the ref it read, and skills update installs from that
same ref, so check and install can't disagree within one run.
- Pin skills@1.5.13 (it parses `#<ref>` too) so the pin matches the version
agentDirs.generated.ts and the lock-path notes were checked against.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* refactor(cli): split the tag and main manifest fetches
Fallow flagged fetchRemoteManifest's CRAP score (31.6 > 30). The tag fetch
(404 is the only fallback to main) and the SHA-pinned main fetch are now their
own functions. No behaviour change.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): never auto-upgrade a Homebrew install
`brew upgrade hyperframes` installs whatever formula the tap holds, so a
background run scheduled for an allowed patch could still cross a 0.x minor.
Homebrew installs now only get the update notice naming `brew upgrade`.
A new test drives the scheduler through the real installer detection and
installer script: no spawn on Homebrew, a versioned npm install for a patch.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* test(parsers): a stamped document needs no parse to keep its ids
* perf(parsers): ensureHfIds skips the parse when every element already has its id
* fix(parsers): a fragment checks every tag, a stray body tag included
* fix(parsers): keep the parse for a page not opening head then body
* refactor(parsers): split the head check out of the page shape check
* fix(parsers): find the head end tag without stripping comments
* fix(core): Safari audio that sits frozen after its cut is pulled onto the playhead in 0.4 s, not 1 s
* fix(core): shorten the frozen-audio comment
* fix(core): leave a WebKit audio element that is still filling data out of the frozen rule