[miguel-heygen]

What

The project lint no longer reads compositions that .hyperframesignore leaves out. A blank index.html beside an archived standalone composition in an ignored folder no longer fails check, snapshot, render and publish with blank_root_with_standalone_composition, and an ignored file's own findings no longer count.

Why

Someone kept an old standalone video under compositions/<folder>/index.html and listed that folder in .hyperframesignore. check still found it, reported blank_root_with_standalone_composition, and snapshot aborted with "the default index.html entry is blank". The ignore file was read only when building the publish and cloud archives, so the lint walk of compositions/ had no way to know the folder was not part of the project.

How

The ignore rules (root renders/ and snapshots/, dotfiles, then the project's .hyperframesignore) move from publishProject.ts into @hyperframes/lint as projectIgnore(projectDir), so lint and publish read one rule set. Publish calls it in place of its private copy. lintProject's walk of compositions/ skips every file and folder it matches. @hyperframes/lint gains the ignore dependency the CLI already uses, at the same range. The dotfile rule stays the unanchored .*, so it matches at any depth and a .hyperframesignore negation can still re-include a hidden folder (#3859).

The root-level multiple_root_compositions rule is unchanged: it guards files the runtime can open as entry points, and is not part of this report.

Test plan

• Unit tests added/updated:
  • fails without the fix: project.test.ts "does not count a composition in a folder the project's .hyperframesignore leaves out": a blank root, compositions/archive/index.html with a timed clip, and compositions/archive/ in .hyperframesignore; lint reads only index.html and reports no blank_root_with_standalone_composition. It fails with the skip removed.
  • project.test.ts (87) passes three runs in a row; publishProject.test.ts and publishProject.srcset.test.ts (150) pass with publish on the moved rules.
• Manual testing performed: the built CLI's lint --json on the reported shape (blank root, a standalone composition in compositions/archive/) reports blank_root_with_standalone_composition; with compositions/archive/ in .hyperframesignore it does not. check, snapshot, render and publish read the same finding from this lint.
• Documentation updated (if applicable): the .hyperframesignore paragraph in docs/packages/cli.mdx.
• Comments follow CONTRIBUTING.md "Comments": one doc line on projectIgnore; the new file stays under the package's comment share, and the dotfile note it had in publish is in this body.

Size

About 20 lines of source in five files, one test and two doc lines. One fix: lint honours the project's ignore file.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
hyperframes	🟢 Ready	View Preview	Nov 5, 2026, 12:37 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[github-actions]

Edit accuracy: accurate 267 (base branch 267), smooth 95 of those

The gate passes.
Smoothness is reported in the artifact, not gated. A case fails only if it fails 2 of 3 runs.

Quarantined, measured but not gated (8)

• seqplainkeys-none-center-r0-nested-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): pass, passes
• seqplainkeys-none-center-r0-root-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): pass, passes
• seqplainkeys-none-center-r30-root-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): not run
• seqplainkeys-none-pct-r0-root-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): pass, passes
• seqplainkeys-none-pct-r30-root-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): not run
• seqplainkeys-none-px-r0-nested-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): pass, passes
• seqplainkeys-none-px-r30-nested-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): not run
• seqplainkeys-none-px-r30-root-z100 (fixed by studio: undo/redo on a keyframed plain element sometimes leaves the box 230-400px off (edit-accuracy seqplainkeys-none-*) #6989): not run

[heygengenesis]

Verdict: REQUEST CHANGES · 1 blocker · 0 important · 0 nits · head efa65615

The code looks right; the only blocker is CI. The Comments check fails and the PR body doesn't explain it: NEW file over its package's comment share: packages/lint/src/projectIgnore.ts is 18.8% (3/16), the package is 10.8%. ↓ inline

Scope

Read the full diff. The lintProject compositions walk is the only path into blank_root_with_standalone_composition. Publish keeps the same rules: the defaults and .hyperframesignore loading moved without changes. Paths are built with /, so matching holds on Windows. Locally project.test.ts passes 87/87. With the ignored.ignores line removed, the new test fails (['index.html', …(1)] ≠ ['index.html']), so the fails without the fix: line holds. All other CI was green; CodeQL and Windows render were still running. No earlier reviews.

— Genesis V2 (Lane B)

[miguel-heygen]

Fixed at 4898cab: projectIgnore.ts is now one comment line in 13 (7.7%, under the package's 10.8%). The dotfile note moved to the PR body.

[heygengenesis]

Verdict: APPROVE — 1 resolved, 0 open, 0 new · efa65615 → 4898cab4

— Genesis V2 (Lane B)