chore: release v0.7.52

Author: vanceingalls

.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-to-video capture for HyperFrames.",
-  "version": "0.7.51",
+  "version": "0.7.52",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperframes",
-  "version": "0.7.51",
+  "version": "0.7.52",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website-to-video capture for HyperFrames.",
   "author": {
     "name": "HeyGen",

.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
-  "version": "0.7.51",
+  "version": "0.7.52",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website-to-video capture for HyperFrames.",
   "author": {
     "name": "HeyGen",

docs/changelog.mdx

@@ -8,6 +8,39 @@ 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.7.52"
+  description="Released - 2026-07-11"
+  tags={["Release", "CLI", "Skills", "Sdk"]}
+>
+The CLI now runs a free trial of the drawElement parallel router (`HF_DE_PARALLEL_ROUTER`) on eligible local renders — it stays on until a real failure fires the safety net, then turns off for that install — and every router/inversion failure path (OOM, blank frames, PSNR, capture errors) now reaches telemetry with a fallback reason, with OOM retries dropping to a single worker after killing stale workers. Also fixes keyframe shots ignoring direct entries, SDK template GSAP scripts missing from resolver parity, and `hyperframes lint` tripping on macOS AppleDouble files.
+
+## Features
+
+- **CLI:** One-shot DE parallel-router trial per install for real telemetry ([37b6a4e7e](https://github.com/heygen-com/hyperframes/commit/37b6a4e7e557d4ec7008ea64d22743602a0c65fb))
+- **Producer,cli:** Full telemetry visibility for DE parallel-router/inversion failures ([ec921e143](https://github.com/heygen-com/hyperframes/commit/ec921e143b35fbaf82068a8442a9e45faa693a58))
+
+## Fixes
+
+- **CLI:** Honor direct entries in keyframe shots ([b95ddd74d](https://github.com/heygen-com/hyperframes/commit/b95ddd74d57509e189704617010d86a8bf2dee63), [#2217](https://github.com/heygen-com/hyperframes/pull/2217))
+- **Skills:** Align core contract with check ([de4e85add](https://github.com/heygen-com/hyperframes/commit/de4e85add6795755e02101dfe6eb523bde8bcdfb), [#2218](https://github.com/heygen-com/hyperframes/pull/2218))
+- **Sdk:** Align template script traversal ([a61f7de8d](https://github.com/heygen-com/hyperframes/commit/a61f7de8d79255da5a79730959a8ac5614415db9))
+- **Lint:** Ignore macOS AppleDouble HTML files ([0e7f40dfc](https://github.com/heygen-com/hyperframes/commit/0e7f40dfc0d5f60796894a4dad38fe989091fbdb), [#2191](https://github.com/heygen-com/hyperframes/pull/2191))
+- **Cli,producer:** Opt-in trial polarity + narrowed-fallback-flag docs (review) ([b02703b7c](https://github.com/heygen-com/hyperframes/commit/b02703b7c9b3f5fb002e2df9ee0320208b333f02))
+- **Sdk:** Include template GSAP scripts in resolver parity ([46602d75f](https://github.com/heygen-com/hyperframes/commit/46602d75f4a3f70803b5d1a89cded3f72c4a2915))
+- **CLI:** Atomic config writes, gated trial warning, and write-failure signal ([6172d79dc](https://github.com/heygen-com/hyperframes/commit/6172d79dc2237a02d18084c3bef30b0dca8e51a4))
+- **CLI:** Stale-cache arm reads, retry double-count, and unwritable-config re-arm in DE trial ([2542e9427](https://github.com/heygen-com/hyperframes/commit/2542e94277d152898681bb9b838d77f11ea9e426))
+- **CLI:** Fix concurrency race, none-vs-undefined bug, and 3 more DE trial gaps ([dc6df93de](https://github.com/heygen-com/hyperframes/commit/dc6df93de586708153a48f87e78c03a115a7c0ae))
+- **CLI:** Fix batch re-entrancy, config race, exposure cap, and shouldTrack gap in DE trial ([532dad7cc](https://github.com/heygen-com/hyperframes/commit/532dad7cc78e98654d4552987625b3763fc0486b))
+- **CLI:** Keep the DE parallel-router trial on until a real failure, not first engagement ([19f90b0b9](https://github.com/heygen-com/hyperframes/commit/19f90b0b92aad1bdf03df81c01a9664609fd8065))
+- **Producer,engine,cli:** Oom wrapping, cancellation, fallback-reason gaps ([a355fb2f6](https://github.com/heygen-com/hyperframes/commit/a355fb2f6be0b6fb98fe0998e56a13e53773624d))
+- **Engine:** Recognize Bun/JavaScriptCore's OOM message in isMemoryExhaustionError ([b3f244a7e](https://github.com/heygen-com/hyperframes/commit/b3f244a7e9bcd110d8878582a212735a480a4848))
+- **Producer:** Drop to a single worker on OOM retry instead of the pre-pinned count ([51353a7ed](https://github.com/heygen-com/hyperframes/commit/51353a7ed6006ac63e68d9d944f0a934508c9ce5))
+- **Producer:** Widen DE self-verify retry to generic failures on a pinned worker count ([df57eb0fd](https://github.com/heygen-com/hyperframes/commit/df57eb0fde334911c712a663f4401b5ca56dfb8b))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.51...v0.7.52).
+</Update>
+
 <Update
   label="HyperFrames v0.7.51"
   description="Released - 2026-07-11"

packages/aws-lambda/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.51",
+  "version": "0.7.52",
   "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.7.51",
+  "version": "0.7.52",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "repository": {
     "type": "git",

packages/core/package.json

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

packages/engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.51",
+  "version": "0.7.52",
   "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.7.51",
+  "version": "0.7.52",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",

packages/lint/package.json

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