chore: release v0.8.159 (#5621)

* chore: release v0.8.159

* chore: v0.8.159 notes list the first-frame fix

* chore: v0.8.159 notes list the sandboxed GPU check fix

* chore: v0.8.159 notes list the hidden-scene fix and the offline font test

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",

.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",

.cursor-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"

docs/changelog.mdx

@@ -8,6 +8,33 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.8.159"
+  description="Released - 2026-10-14"
+  tags={["Release", "CLI"]}
+>
+`check` and `snapshot` now work in sandboxes that refuse to listen on localhost. `snapshot --keep` lets you redo one still without losing the others.
+
+## Features
+
+- **CLI:** `snapshot --keep` redoes one still and leaves the others ([c0636d017f6](https://github.com/heygen-com/hyperframes/commit/c0636d017f68073522ab8eeb6cc24a2d3993b656), [#5605](https://github.com/heygen-com/hyperframes/pull/5605)). It adds to the output folder instead of clearing it and names each still for its time, such as `at-1.5s.png`.
+
+## Fixes
+
+- **Core:** A render's first frame shows each scene's starting state ([8c00ebad80c](https://github.com/heygen-com/hyperframes/commit/8c00ebad80c634f607e3a5283f8a0aa73e35f1dd), [#5614](https://github.com/heygen-com/hyperframes/pull/5614)).
+- **Core:** A hidden scene's contents stay hidden when a child is set visible ([24a9b781715](https://github.com/heygen-com/hyperframes/commit/24a9b781715d0c59f06e4540831529d99c63ae75), [#5619](https://github.com/heygen-com/hyperframes/pull/5619)). Before, a nested scene's card could paint before its host started. The `static-volume-future-set` regression baseline changes for this reason.
+- **CLI:** `check` and `snapshot` run where a sandbox refuses to listen on localhost ([71595dd8201](https://github.com/heygen-com/hyperframes/commit/71595dd82012314f353d1237f50da0fad7639817), [#5618](https://github.com/heygen-com/hyperframes/pull/5618)).
+- **CLI:** The GPU check uses the same pipe as the render, so a sandboxed `check` no longer waits 120 s ([6c89decb0dd](https://github.com/heygen-com/hyperframes/commit/6c89decb0ddbac7c30a7dca6d947f945ebd58c0e), [#5622](https://github.com/heygen-com/hyperframes/pull/5622)).
+- **CLI:** A long video conversion in `init` never stalls on ffmpeg's own log ([b14a4564716](https://github.com/heygen-com/hyperframes/commit/b14a45647166e60e2e51dc018ccb1bb7331003a2), [#5616](https://github.com/heygen-com/hyperframes/pull/5616)).
+
+## Internal
+
+- **Core:** The `var()` font fallback test uses an offline fetch stub instead of Google Fonts ([8f0bcadcd32](https://github.com/heygen-com/hyperframes/commit/8f0bcadcd32893d3ad5231f33b210c410096281f), [#5623](https://github.com/heygen-com/hyperframes/pull/5623)).
+- A stalled history fetch in change detection is retried instead of failing the run ([cd87cf11106](https://github.com/heygen-com/hyperframes/commit/cd87cf11106985c6222723f5b391723882691d6c), [#5615](https://github.com/heygen-com/hyperframes/pull/5615)).
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.158...v0.8.159).
+</Update>
+
 <Update
   label="HyperFrames v0.8.158"
   description="Released - 2026-10-14"

gemini-extension.json

@@ -1,5 +1,5 @@
 {
   "name": "hyperframes",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames."
 }

packages/aws-lambda/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "",
   "repository": {
     "type": "git",

packages/engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",

packages/gcp-cloud-run/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",

packages/inspector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/inspector",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",

packages/lint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",

packages/parsers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",

packages/player/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",

packages/producer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",

packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",

packages/shader-transitions/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",

packages/studio-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",

packages/studio/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "description": "",
   "repository": {
     "type": "git",

plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.158",
+  "version": "0.8.159",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",

releases/v0.8.159.md

@@ -0,0 +1,26 @@
+# HyperFrames v0.8.159
+
+Released on 2026-10-14.
+
+`check` and `snapshot` now work in sandboxes that refuse to listen on localhost. `snapshot --keep` lets you redo one still without losing the others.
+
+## Features
+
+- **CLI:** `snapshot --keep` redoes one still and leaves the others ([c0636d017f6](https://github.com/heygen-com/hyperframes/commit/c0636d017f68073522ab8eeb6cc24a2d3993b656), [#5605](https://github.com/heygen-com/hyperframes/pull/5605)). It adds to the output folder instead of clearing it and names each still for its time, such as `at-1.5s.png`.
+
+## Fixes
+
+- **Core:** A render's first frame shows each scene's starting state ([8c00ebad80c](https://github.com/heygen-com/hyperframes/commit/8c00ebad80c634f607e3a5283f8a0aa73e35f1dd), [#5614](https://github.com/heygen-com/hyperframes/pull/5614)).
+- **Core:** A hidden scene's contents stay hidden when a child is set visible ([24a9b781715](https://github.com/heygen-com/hyperframes/commit/24a9b781715d0c59f06e4540831529d99c63ae75), [#5619](https://github.com/heygen-com/hyperframes/pull/5619)). Before, a nested scene's card could paint before its host started. The `static-volume-future-set` regression baseline changes for this reason.
+- **CLI:** `check` and `snapshot` run where a sandbox refuses to listen on localhost ([71595dd8201](https://github.com/heygen-com/hyperframes/commit/71595dd82012314f353d1237f50da0fad7639817), [#5618](https://github.com/heygen-com/hyperframes/pull/5618)).
+- **CLI:** The GPU check uses the same pipe as the render, so a sandboxed `check` no longer waits 120 s ([6c89decb0dd](https://github.com/heygen-com/hyperframes/commit/6c89decb0ddbac7c30a7dca6d947f945ebd58c0e), [#5622](https://github.com/heygen-com/hyperframes/pull/5622)).
+- **CLI:** A long video conversion in `init` never stalls on ffmpeg's own log ([b14a4564716](https://github.com/heygen-com/hyperframes/commit/b14a45647166e60e2e51dc018ccb1bb7331003a2), [#5616](https://github.com/heygen-com/hyperframes/pull/5616)).
+
+## Internal
+
+- **Core:** The `var()` font fallback test uses an offline fetch stub instead of Google Fonts ([8f0bcadcd32](https://github.com/heygen-com/hyperframes/commit/8f0bcadcd32893d3ad5231f33b210c410096281f), [#5623](https://github.com/heygen-com/hyperframes/pull/5623)).
+- A stalled history fetch in change detection is retried instead of failing the run ([cd87cf11106](https://github.com/heygen-com/hyperframes/commit/cd87cf11106985c6222723f5b391723882691d6c), [#5615](https://github.com/heygen-com/hyperframes/pull/5615)).
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.8.158...v0.8.159