New-track drops leave an audio group
A clip lands exactly where the ghost showed. One undo restores its track and membership.
audited 5trusting 0not exercised 1open decisions 0hyperframes @ de13693179f53c3f625b7b501f1f5fc7b083b6c9, working changes, 2026-10-02
In one breath. At the audited base, the move transaction saved track and timing but dropped membership before persistence. Detachment must travel through that transaction, rather than become a second save.
Where the value travels
Drop edits → Move adapter → Source patch → File + history → Undo restore
The contract, per boundary
Move payload
At the audited base, membership was absent from the move payload. The adapter explicitly selects only these fields.
edits.map(({ element, updates }) => ({
element,
start: updates.start,
track: operation === "timing" ? undefined : updates.track,
}))producer src/player/components/timelineClipDragCommit.ts:153; consumer src/hooks/timelineMoveAdapter.ts:37. Paths relative to packages/studio.membership: absentreachable: nowritten: no
Atomic source edit
The group move turns all clip changes into source patches inside one queued file transaction. Track changes bypass the timing-only SDK path.
buildTimelineMoveTimingPatch( original, target, toAuthoredStart(change.element, change.start), change.element.duration, change.track, )producer src/hooks/useTimelineGroupEditing.ts:311; consumer src/hooks/timelineEditingHelpers.ts:235. SDK eligibility src/hooks/useTimelineGroupEditing.ts:299.
track: existsreachablewritten
Undo owns whole-file snapshots
One transaction records the complete before and after source. Including membership in the same patch gives undo its original value.
snapshots[path] = { before, after };
await recordEdit({ label, coalesceKey, coalesceMs, files: snapshots });producer src/utils/studioFileHistory.ts:128,144; undo consumer src/hooks/usePersistentEditHistory.ts:81,99; preview sync consumer src/hooks/useEditHistoryActions.ts:112.snapshots: existreachablewritten and restored
How it says no
| Signal | Meaning and response |
|---|---|
| Locked shifted clip | Insertion returns without persistence. Existing permission rules remain the owner. |
| Save rejection | The file transaction restores already-written snapshots and rethrows. The optimistic clip rollback must restore membership alongside timing and track. |
| Undo content mismatch | History refuses to overwrite a file changed since the edit and reports the conflict. |
Decision already supplied
New tracks outside a group detach the dragged clip. Drops onto member tracks retain existing behavior. Cmd+Z restores membership. There is no open product decision.
Coverage, honestly
| Label | Coverage |
|---|---|
| Audited | Drop edits, adapter, group move, source patch, snapshot and undo consumers opened at the named base. |
| Not exercised | This page records the pre-implementation audit. Runtime proof is reported separately against the implementation head. |
What would prove this page wrong
Drop a grouped clip at a group edge, reload the file, then Cmd+Z. The clip must lose membership after the drop, occupy the promised lane, and regain its original track and membership in one undo. A member-track drop must retain membership.