From 996ebff0b0dc81ce6b8d0ae678f9fe06124ee898 Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Wed, 22 Apr 2026 19:30:42 +0000
Subject: [PATCH 1/3] docs(readme): note git-lfs requirement for full clones

Repo uses Git LFS for regression-test baselines (~240 MB of .mp4 files
under packages/producer/tests/**/output.mp4). Users cloning without
git-lfs installed hit a cryptic 'git-lfs: command not found' error, as
reported in #407.

Document the requirement with install instructions and the
GIT_LFS_SKIP_SMUDGE=1 escape hatch.
---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index e808907a6..17d283106 100644
--- a/README.md
+++ b/README.md
@@ -191,6 +191,27 @@ npx skills add heygen-com/hyperframes
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
+### Cloning the repo
+
+The repo uses [Git LFS](https://git-lfs.com) for golden regression-test baselines under `packages/producer/tests/**/output.mp4` (~240 MB of `.mp4` files). If you're cloning the full repo for development, install Git LFS first:
+
+```bash
+# macOS
+brew install git-lfs
+
+# Ubuntu/Debian
+sudo apt install git-lfs
+
+# Then (once, per machine)
+git lfs install
+```
+
+If you hit `git-lfs filter-process: command not found` during `git clone` or `npx skills add heygen-com/hyperframes`, install Git LFS and retry. You can also skip LFS content if you only need the source files:
+
+```bash
+GIT_LFS_SKIP_SMUDGE=1 git clone https://github.com/heygen-com/hyperframes.git
+```
+
 ## License
 
 [Apache 2.0](LICENSE)

From 5519f0b7660bc278e4c1c09ed5aa5ece456d6864 Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Wed, 22 Apr 2026 19:38:05 +0000
Subject: [PATCH 2/3] docs(readme): add Windows install instructions for
 git-lfs

Per review from @miguel-heygen.
---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 17d283106..63e4f1ce2 100644
--- a/README.md
+++ b/README.md
@@ -202,6 +202,10 @@ brew install git-lfs
 # Ubuntu/Debian
 sudo apt install git-lfs
 
+# Windows
+winget install GitHub.GitLFS
+# (or install Git for Windows, which bundles Git LFS as an optional component)
+
 # Then (once, per machine)
 git lfs install
 ```

From 11aa4d32845f3d9acc458f426a24d97d27050a04 Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Wed, 22 Apr 2026 20:50:29 +0000
Subject: [PATCH 3/3] chore(ci): fix oxfmt formatting on renovate.json

Drive-by to unblock CI. Landed unformatted in #422 because
Renovate's config-migration PR bypasses the lefthook pre-commit hook,
so every subsequent PR's `bun run format:check` (which scans the whole
repo) was failing on this file.
---
 .github/renovate.json | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/.github/renovate.json b/.github/renovate.json
index b4c5c5d54..56277761f 100644
--- a/.github/renovate.json
+++ b/.github/renovate.json
@@ -36,9 +36,7 @@
     },
     {
       "enabled": false,
-      "matchPackageNames": [
-        "/^@hyperframes//"
-      ]
+      "matchPackageNames": ["/^@hyperframes//"]
     }
   ]
 }