The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.
TypeScript agent-skillsagentic-aiai-agentsai-videobyokclaude-codecodexdeepseek-harnessdsh-plugingenerative-ailocal-firstmcpmotionmotion-graphicsmultimodalopenmotionreverse-engineeringvideo-editingvideo-generationworkbuddy
fix(skills): keep preview handoff paused at exactly zero
罗高44b2fb799720
diff --git a/skills/openmotion-production/references/native.md b/skills/openmotion-production/references/native.mdindex dd88ca86..3419e7f9 100644--- a/skills/openmotion-production/references/native.md+++ b/skills/openmotion-production/references/native.md@@ -18,9 +18,9 @@ The first output of original creation, reference-video recreation and editable-tFirst delivery must complete steps 1–5 under [Continuing edits](#continuing-edits) too: preparing the preview is only the first step. Hidden-tab playback, screenshots, `markDeliverable()` and a completed MP4 export do not prove editor delivery. Before finishing, either confirm the native panel is visible with the latest content, or state the specific display failure/deferred status and give the project URL. Do not silently replace the editor with files.-After verifying playback, pause the preview first, then seek to 0 seconds (`seek(0)`) through the host's supported preview controls. Inspect the actual preview picture. If the opening frame is blank, seek forward only far enough to reach the earliest opening frame with recognizable authored content. Keep playback paused at that frame. An explicit user request for another playback position or playing state takes precedence.+After verifying playback, pause the preview first, then seek to 0 seconds (`seek(0)`) through the host's supported preview controls. Keep playback paused at 0 seconds, including when the opening frame is blank; do not advance to find visible content. An explicit user request for another playback position or playing state takes precedence.-Before recording display confirmation or delivering the editor, verify the selected playback state. The default handoff requires recognizable authored content at the selected opening time and a playhead that remains stable while paused. For an explicit playback request, verify the requested position or playing state instead. Include the observed time, playback state and visible content in the display evidence. This applies to first delivery, unchanged first-run templates and continued edits. If the controls, content or resulting playback state cannot be verified, report that limitation and keep display confirmation pending.+Before recording display confirmation or delivering the editor, verify the selected playback state. The default handoff requires a playhead at 0 seconds that remains stable while paused. Verify that the intended project and current content loaded; an authored blank opening frame is valid, but an unloaded preview is not. For an explicit playback request, verify the requested position or playing state instead. Include the observed time, playback state and visible content in the display evidence. This applies to first delivery, unchanged first-run templates and continued edits. If the controls, content or resulting playback state cannot be verified, report that limitation and keep display confirmation pending.The Tool runs lint and selects an existing project in Studio; it does not create a project or open the host browser. Preserve the URL's embed/query/hash, verify that the intended project and current content loaded, and reuse its browser tab on continued work. If lint fails, fix the reported source problem before retrying. If preview or browser capability is unavailable, provide the project URL when available and state the concrete gap; report the page as opened only after observing it. Do not substitute the system `open` command, AppleScript or a separately launched visible browser for the host's browser. For an independent folder/ZIP, use a supported managed-project handoff if available; the public MCP has no general folder/ZIP adoption Tool. Preserve the actual source and report that limitation rather than opening an unrelated carrier.diff --git a/skills/openmotion-template-to-video/SKILL.md b/skills/openmotion-template-to-video/SKILL.mdindex b9da39d1..6dc965c1 100644--- a/skills/openmotion-template-to-video/SKILL.md+++ b/skills/openmotion-template-to-video/SKILL.md@@ -47,7 +47,7 @@ Once this turn's requested HTML is ready, complete the [editable preview handoffFor an unchanged request, confirm in the editor that the intended template loaded and plays; unless the user asks for a video file, do not render, export or compare it. For an edited request, play the changed content and its related motion and sound in the editor preview; native snapshots help with layout but do not show motion. Do not export unless the user asks for a video file, then verify that actual MP4.-After the playback check, complete the shared [editable preview handoff](../openmotion-production/references/native.md#editable-preview-handoff). Leave the editor paused at the beginning, advancing through a blank opening only to the earliest frame with recognizable authored content. Verify the visible content and stable paused position before recording display confirmation or delivering the editor. Follow an explicit user request for another playback state.+After the playback check, complete the shared [editable preview handoff](../openmotion-production/references/native.md#editable-preview-handoff). Leave the editor paused at 0 seconds, even when the opening frame is blank. Verify the loaded content and stable paused position before recording display confirmation or delivering the editor. Follow an explicit user request for another playback state.For an edited request, inspect the requested content, its related layout/timing and unchanged sections against the template's `preview.mp4`. Verify that supplied replacement assets are actually used and old brand content does not remain at another relevant appearance. Record passed, failed and unrun checks separately in the copy's `TEMPLATE.md`. The project open in the editor is the deliverable. Do not copy, link or attach MP4s or other files unless the user asks for them; save requested files in the current workspace and link them by absolute local path, with only the plain path in each link target. For the editable Studio page, use the exact previewUrl from the handoff. Keep the reply short and in the user's words: one or two sentences on what changed and only the limitations the user would notice. For an unchanged request, use one completion sentence; the editable page remains open in the host. An accepted first-run experience follows the [first-run delivery and contextual invitation](../openmotion-production/references/templates.md#first-run-experience-defaults), including its limited exceptions, instead of adding project screenshots or technical evidence. Humans decide visual acceptance; do not give a subjective pass/fail verdict. Do not claim independent-agent verification unless a separate session actually performed it.diff --git a/tests/workflow.test.ts b/tests/workflow.test.tsindex a1719a21..e9f7bcd0 100644--- a/tests/workflow.test.ts+++ b/tests/workflow.test.ts@@ -106,7 +106,7 @@ test('every workflow document and linked reference is reachable over MCP with ca} finally { await rm(directory, { recursive: true, force: true }); }});-test('MCP template delivery exposes a paused, visible opening-frame handoff with user playback precedence', async () => {+test('MCP template delivery exposes a paused zero-second handoff with user playback precedence', async () => {const directory = await mkdtemp(path.join(tmpdir(), 'motion-workflow-opening-frame-'));try {const responses = stdio(directory, [@@ -117,9 +117,11 @@ test('MCP template delivery exposes a paused, visible opening-frame handoff withconst native = responses.get(2).structuredContent;assert.ok(template.references.some((reference: { documentId: string }) =>reference.documentId === native.documentId), 'Template delivery must expose the shared handoff to MCP-only clients');- assert.match(template.content, /After the playback check[\s\S]*?paused at the beginning/i, 'The template route must apply the handoff after playback');- assert.match(native.content, /opening frame[^.]*blank[\s\S]*?earliest opening frame[^.]*authored content/i, 'A blank first frame needs an early authored-content fallback');- assert.match(native.content, /Before recording display confirmation[\s\S]*?default handoff[^.]*authored content[^.]*stable[^.]*paused/i, 'Visible content and stable paused playback must be checked before confirmation');+ assert.match(template.content, /After the playback check[\s\S]*?paused at 0 seconds[^.]*opening frame is blank/i, 'Template delivery must stay at zero even with a blank first frame');+ assert.match(native.content, /pause the preview first[^.]*seek to 0 seconds/i, 'Playback must pause before seeking to zero');+ assert.match(native.content, /paused at 0 seconds[^.]*opening frame is blank[^.]*do not advance/i, 'A blank opening must not move the playhead forward');+ assert.match(native.content, /Before recording display confirmation[\s\S]*?default handoff[^.]*at 0 seconds[^.]*stable[^.]*paused/i, 'Stable paused playback at zero must be checked before confirmation');+ assert.match(native.content, /authored blank opening frame is valid[^.]*unloaded preview is not/i, 'An authored blank frame must remain distinct from a preview that failed to load');assert.match(native.content, /explicit user request[^.]*playback[^.]*takes precedence/i, 'Explicit playback requests must retain precedence');assert.match(native.content, /explicit playback request[^.]*verify[^.]*requested position or playing state/i, 'Requested playing states must be verified without forcing a pause');assert.match(native.content, /observed time[^.]*playback state[^.]*visible content[^.]*display evidence/i, 'Display evidence must identify the observed handoff state');