chore: release v0.8.48

[miguel-heygen]

Generated by bun run release:prepare 0.8.48 off main at 2a9912ec9, with the release summary written by hand. 18 files: 16 version manifests, releases/v0.8.48.md, and the prepended docs/changelog.mdx entry. Zero source changes.

What's in it

Features

• Studio: the main track snaps clips together and closes gaps automatically when you delete one (feat(studio): operators get a magnetic main track that closes gaps on delete #4069)
• Studio: the segment ease control is now visible without hovering (feat(studio): the segment ease control is discoverable at rest #4074)
• Studio: host apps can open the ask-agent flow directly from a picked element (feat(studio): host apps can open the ask-agent flow from a picked element #4075)
• Studio: a project's root composition now opens automatically on load (feat(studio): open a project's root composition automatically on load #4057)

Fixes

• Studio: the volume slider stays editable while automation owns the level (fix(studio): keep the volume slider editable while automation owns the level #4066)
• Studio: dropped timeline assets land where you drop them (fix(studio): dropped timeline assets land where you drop them #4062)
• Studio: clips stay on their row through group, ungroup, and composition recovery (fix(studio): keep clips on their row through group, ungroup, and composition recovery #4068)
• CLI: a missing or stale Studio build is detected before it crashes (fix(cli): detect a missing or stale studio build before it crashes #4076)
• CLI: two flaky pid-file-read tests fixed (fix(cli): stop the cancellable-process test reading a pid file mid-write #4080, fix(cli): stop the preflight cancel test reading a pid file mid-write #4077)
• CLI: startup lint output collapses to one line (fix(cli): collapse startup lint output to a one-line summary #4052)
• CLI: agent and execution-harness telemetry are now distinguishable (fix(cli): distinguish agent and execution harness telemetry #4071)

Catalog

• Registry: corner brackets now fade in on cue in the north-korea-locked-down block (fix(registry): corner brackets fade in on cue in north-korea-locked-down #4081)

Internal

• Studio: hotkey dispatch extracted out of useAppHotkeys (refactor(studio): extract hotkey dispatch out of useAppHotkeys #4079)
• CLI: timing added to a flaky Windows contact-sheet test and a headless-shell spawn test (test(cli): time the native Sharp calls in a flaky Windows contact-sheet test #4070, test(engine): time the bun --eval spawn in resolveHeadlessShellPath tests #4078)

Scope check

Sixteen commits landed since v0.8.47. One of them, #4071 (CLI: distinguish agent and execution harness telemetry), was not on the list handed to me for this release — verified merged to main (2a559714e, merged 2026-09-18T10:10:23Z) and correctly picked up by the changelog generator straight from git history. It's included above. No merged PR since v0.8.47 is missing from this release.

Verification

• release:prepare ran the repo's own draft → review → set-version flow; the generated docs/changelog.mdx and releases/v0.8.48.md entries were rewritten by hand to remove the TODO marker.
• Diffed against origin/main: only 16 package.json/plugin-manifest version bumps plus the two changelog files changed. The format pre-commit hook initially reformatted three unrelated registry block files as a side effect of running across the whole staged set; reverted those three back to origin/main before committing so this PR carries zero source changes, matching the pattern in chore: release v0.8.45 #4027 and chore: release v0.8.47 #4063.
• Local tag v0.8.48 was created by set-version and was not pushed; the publish workflow tags the merge SHA on merge.

Merging this PR publishes npm and cuts the GitHub release; do not push the local tag.

[mintlify]

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

Project	Status	Preview	Updated
hyperframes	🟢 Ready	View Preview	Sep 18, 2026, 2:50 PM

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