agentsope/SkillAlchemy / skills/agentsope-ai-video-director
agentsope-ai-video-director
UnverifiedDirect and implement programmatic videos from a natural-language sentence: brief, shots, style, timeline, assets, engine-specific coding prompts, draft, review and repair. Use when asked to make a video, product launch, explainer, Reel/Short, kinetic typography or docs-to-video with HyperFrames, Remotion or Motion Canvas, or to improve an existing code-video project. 一句话视频制作与导演工作流。
references/engine-adapters.md
View on GitHub# Isolated engine adapters
Select one route only after filling the director plan. This guide preserves documented and locally recorded profiles; it does not establish an engine ranking. Routing, dependency gaps and artifact-state reporting are authored C05/C07/C09. Every executable engine requirement below comes from its admitted P record and explicit binding.
## Route by actual environment and rights — authored C05
1. Record the intended production subject/use and asset permissions. Noncommercial evaluation does not establish the user’s production eligibility. No service or media purchase is authorized.
2. Probe actual local Node, browser, FFmpeg/exporter and relevant packages. Record exact versions/revisions, lock/tree, exporter route and licenses; do not assume availability from installed code alone.
3. Choose an eligible runnable profile whose capabilities fit the director plan. Distinguish HyperFrames local CLI, Remotion Node server, Remotion browser compositor, Motion Canvas local editor/exporter and the particular kinetic-reel Canvas/WebGL source renderer.
4. Compile the prompt using only that profile’s clocks, APIs, readiness and output route. Carry the environment/rights basis and missing gaps with it.
5. Implement and execute when available; otherwise deliver the achieved plan/prompt/code state plus the specific missing dependency or eligibility information. A browser preview, static build or source renderer is not an encoded video.
6. Inspect the actual output and record its evidence state using [quality-rubric.md](quality-rubric.md). Keep technical probes, frame review, full viewing, listening and rights status independent.
| Profile | Established contract | Boundary / current observation |
|---|---|---|
| HyperFrames | 0.8.142; seconds, HTML composition metadata, completed paused GSAP timeline, local CLI | Docs pin `2dd708e0` and npm gitHead `0b210169` are distinct; only selected core/determinism docs were byte-identical. A silent geometry smoke does not validate fonts/media/async/audio. |
| Remotion server | 4.0.534 / `4d9ff70e`; Node screenshot capture and FFmpeg encoding | Version-matched server CLI/API; silent geometry smoke only. User production rights unknown. |
| Remotion browser | 4.0.534 `@remotion/web-renderer`; browser compositor/WebCodecs subset | Different from server route; browser export unexecuted. Browser/codec/component support must be established. |
| Motion Canvas | Released 3.17.2 / `e735a995`; generator scenes, Vite/local editor and selected FFmpeg exporter | Install/build/server checks do not establish UI video export. No admitted official headless render CLI. |
| Canvas/WebGL | Kinetic-reel source at `18c8426f`; Node/Chrome/external FFmpeg | Source-local renderer only; browser-only is preview. Renderer execution and general fallback were not established. |
## HyperFrames 0.8.142
Read P16–P20 together. The root’s finite `data-duration` is read before script execution; runtime rewriting cannot change it. Timing attributes use seconds. Complete the paused GSAP timeline before registration under the matching composition ID, including after asynchronous setup. Preserve the separate standalone/nested branches and current assembler fallback behavior.
Declare computation readiness through the admitted `__hf.buildReady` mechanism, preserve engine-owned namespaces, and inspect warnings/asset completeness. Let the framework own timed clip visibility and media clocks; animate inner visual elements from seek time.
The exact CLI templates appear in P20. Angle-bracket values are caller placeholders, not literal shell arguments. Invoke each command separately. The strict one-worker/cache-off profile is reproduced validation, not a performance optimum. Coleam’s older blank-preview incident remains a separate diagnosis with unspecified older engine version.
## Remotion 4.0.534: shared frame model
P21 defines registration and zero-indexed frame motion. For a 15-second 30-fps project, arithmetic yields 450 frames, last frame 449; that arithmetic does not describe the two-second research smoke as a 15-second validation. Sequence visibility is half-open and child frames are local. Keep spring fps and interpolation clamp intent explicit.
P40 defines audio frames and Caption milliseconds; captions are plain data, not transcription. Translate upstream one-based inclusive frame tables before use. P24 defines stable readiness handles and the separate server/browser branches. Data state is permitted; visual motion must remain requested-frame-derived.
### Node server path
Use only P22’s version-matched studio/still/render or bundle/serve→selectComposition→renderMedia route. A local browser screenshot renderer with FFmpeg is this server path; it does not validate the browser compositor. Probe the actual encoded file. Do not promise a pixel format from the codec flag alone.
### Browser compositor path
Use only P23’s `renderMediaOnWeb`/`renderStillOnWeb` contract with component/config/inputProps and its supported DOM/CSS/media subset. Browser/WebCodecs/codec eligibility is independent of Node availability. Unsupported OffthreadVideo/Html5Video/Html5Audio must not be imported as if this path supported them. The optional nested HTML-in-canvas Chrome requirement is separate from baseline support; the recorded Chrome 154 server smoke does not satisfy it.
### Production rights
P37 keeps exact v4 eligibility and telemetry separate from announced v5 requirements. Establish the user’s subject/use basis before production. Individuals, nonprofits, for-profit subjects with at most three employees and noncommercial evaluation are the source-defined free conditions; other for-profit uses require the Company License. No purchase or production clearance follows from a smoke test. Hosted services, codecs/encoder licenses and media permissions remain separate.
## Motion Canvas released 3.17.2
Read P25/P26/P31/P39. Use seconds and generator/yield semantics, registered scenes and the local Vite editor route. Explicitly install/register/select the version-matched video exporter for encoded delivery. The default image sequence, editor preview, static production build and encoded video are different states. P25’s UI RENDER path was not executed in research; no headless CLI command is supplied.
Configure one authorized project audio track separately and enable Include audio when available. Retain the positive-offset FIXME and absence of listening/export validation. Do not import main-branch `sound()` APIs into the released profile. Preserve named editor event metadata when using `waitUntil`/`useDuration`.
The released exporter wrapper is MIT at `e735a995`; main at `7b91435c` carries GPLv3 exporter metadata despite the same version string. These are different revision/dependency/license paths. P39’s inspected `@ffmpeg-installer/darwin-arm64@4.1.5` FFmpeg 4.4 binary reports nonfree parts and no redistribution permission; this exact cached binary and dependency tree are excluded from distribution. The observation does not establish all FFmpeg builds’ rights.
## Source-specific Canvas/WebGL kinetic-reel
P27 is the selected Canvas 2D→Three 0.160.0→WebGL post→output canvas source backend, with `window.ready`, `renderAt(i/fps)` and Puppeteer/Chrome capture before external FFmpeg. Audio is an explicit input. The admitted payload describes `--clip`/`--range`, `--frames` and `--encode` but does not authorize inventing a full command line or browser export API. Treat browser-only execution as preview for this repository. No universal Canvas fallback is supplied.
## Historical export incidents
P36’s Motion Canvas #1052/#1204 reports illustrate preview/export evidence boundaries only at their historical 3.10-era and 3.18-alpha scopes. They are not current stable exporter defect claims. C07 independently requires honest artifact-state reporting for all routes; it does not turn that authored policy into a new P36 recovery component.
Authored routing/state provenance: [C05/C07/C09](provenance.json). Use [HyperFrames prompt](../examples/hyperframes-prompt.md) and [Remotion prompt](../examples/remotion-prompt.md) as synthetic applications of their own profiles.
## Admitted operations and boundaries
<a id="p16"></a>
### P16 — Compile HyperFrames timing and completed timeline registration
**Admission:** General. **Exact scope:** HyperFrames GSAP composition profile 0.8.142, research core docs at 2dd708e0 and byte-identical core/determinism docs at npm gitHead 0b210169; seconds, static finite root duration and completed paused registration. No all-files/source-build equivalence or matched-engine effectiveness.
**Condition:** An HTML HyperFrames composition needs a requested finite duration and a seekable animation timeline. (Evidence: R04-F001, R04-F002, R04-F003.)
**Action:** Use seconds for data-start/data-duration. Author finite root data-duration when exact runtime is required. Build one completed paused timeline and register it under the matching composition ID; if build waits on fonts or other async setup, register at the end of that callback.
HyperFrames profile: root HTML uses data-composition-id, data-width, data-height and finite data-duration where requested. Timed clips use data-start/data-duration in seconds. For the GSAP profile, build gsap.timeline({paused:true}) completely, then assign window.__timelines[compositionId] = timeline. Root duration is read before script execution. Node >=22 and local FFmpeg/browser dependencies must be available for the documented CLI route. (Evidence: R04-F001, R04-F002, R04-F003.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Conditional branches (retain separately):**
- Synchronous build → Register the fully built paused timeline once.
- Async build → Register after build completes, never an early empty timeline.
- Exact output duration → Use finite authored root duration.
- Duration intentionally inferred → Use the documented timeline/media/adapter inference.
**Boundaries:** Root duration is read at compilation before scripts; later rewrites do not change it. Excess animation is cut, shorter timeline holds. Omitted duration invokes inference. Async setup is supported. No matched 15-second engine comparison.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R04-F001:** origin `documented_contract`; confidence `medium`; observed: Pinned code/documentation read; source production output not executed Relation: `unresolved`. Boundary: This report establishes HyperFrames side only. Do not call2s smoke a matched15s cross-engine contrast.
**R04-F002:** origin `documented_contract`; confidence `high`; observed: Pinned code/documentation read; source production output not executed Relation: `changed`. Boundary: Async build is supported; source explicitly rejects registration-before-build, not async setup itself.
**R04-F003:** origin `documented_contract`; confidence `high`; observed: Pinned code/documentation read; source production output not executed Relation: `changed`. Boundary: Explicit15s requested output should have finite authored root duration; no implied global creative default.
**Admitted profile binding (action):** HyperFrames profile: root HTML uses data-composition-id, data-width, data-height and finite data-duration where requested. Timed clips use data-start/data-duration in seconds. For the GSAP profile, build gsap.timeline({paused:true}) completely, then assign window.__timelines[compositionId] = timeline. Root duration is read before script execution. Node >=22 and local FFmpeg/browser dependencies must be available for the documented CLI route.
Binding scope: hyperframes@0.8.142; research docs 2dd708e0 versus registry gitHead 0b210169; critical core docs byte-identical, not all-files/source-build equivalence. Observation: Two-second synthetic paused-timeline geometry render and repeated seek ran; async, fonts, media and audio did not. Source IDs: R04-S001, R04-S002, R04-S003, R04-S004, R04-S005, R04-S016, R04-S017, R04-S018, R04-S019. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R04-S001](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/cli/package.json) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S002](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/core/package.json) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S004](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/determinism-rules.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S005](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/minimal-composition.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S006](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-cli/SKILL.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S012](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/concepts/compositions.mdx) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S016](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/skills/hyperframes-core/references/determinism-rules.md) (revision `0b21016905f208f8bc9fb37f7b65737f75fe0d2f`); [R04-S017](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/skills/hyperframes-core/SKILL.md) (revision `0b21016905f208f8bc9fb37f7b65737f75fe0d2f`); [R04-S018](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/packages/cli/src/commands/render/plan.ts) (revision `0b21016905f208f8bc9fb37f7b65737f75fe0d2f`); [R04-S019](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/packages/core/src/runtime/init.ts) (revision `0b21016905f208f8bc9fb37f7b65737f75fe0d2f`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P16` when tracing a decision.
<a id="p17"></a>
### P17 — Choose HyperFrames standalone versus nested composition structure
**Admission:** General. **Exact scope:** HyperFrames 0.8.142 core/assembler documentation at 2dd708e0: direct standalone root versus recommended template sub-composition form; documented plain-document/mismatched-ID fallbacks remain possible.
**Condition:** The same content is used as a top-level root or mounted sub-composition. (Evidence: R04-F006.)
**Action:** Use a direct body composition for a standalone root. For the recommended nested form, keep internal style/script within the template and match host, root and timeline IDs rather than depending on fallback. (Evidence: R04-F006.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Conditional branches (retain separately):**
- Standalone root → Direct body composition.
- Nested composition → Recommended template form with matching host/root/timeline IDs.
**Boundaries:** Plain-document and single mismatched-ID fallback exists. Do not turn an older creator’s strict-ID repair into a false claim that no fallback exists.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R04-F006:** origin `documented_contract`; confidence `high`; observed: Pinned code/documentation read; source production output not executed Relation: `changed`. Boundary: Core notes assembler permits a plain full-document fallback and mismatched local ID fallback, though mismatch can be silent. Do not promote older strict-match repair into claim no fallback exists.
**Sources:** [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S005](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/minimal-composition.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S012](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/concepts/compositions.mdx) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P17` when tracing a decision.
<a id="p18"></a>
### P18 — Wait for declared HyperFrames resources instead of using duration as readiness
**Admission:** General. **Exact scope:** HyperFrames recorded 0.8.142 core/readiness contract at 2dd708e0: declared fonts/images/media/computation and framework namespace ownership. Resource-error settling and best-effort behavior are contract boundaries, not tested asset completeness.
**Condition:** Assets or composition build are pending even though duration is already known. (Evidence: R04-F004.)
**Action:** Use the engine’s declared readiness for fonts, images, media and computation; a known duration alone does not establish completed build/assets.
HyperFrames readiness profile: keep framework-owned window.__timelines, __hf, __hyperframes, __player and readiness flags intact. Declare application computation through __hf.buildReady with unique promise keys; use application-specific namespaces and element IDs. (Evidence: R04-F004.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Inspect resource warnings and rendered completeness; media errors can settle promises and best-effort output can still omit assets. (Evidence: R04-F004.)
**Boundaries:** The research smoke used no fonts/media/audio or async setup; successful process status is not visual completeness.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R04-F004:** origin `documented_contract`; confidence `high`; observed: Pinned code/documentation read; source production output not executed Relation: `changed`. Boundary: Media errors settle promises; render defaults best-effort, so missing assets can yield warned output. Successful process is not visual completeness.
**Admitted profile binding (action):** HyperFrames readiness profile: keep framework-owned window.__timelines, __hf, __hyperframes, __player and readiness flags intact. Declare application computation through __hf.buildReady with unique promise keys; use application-specific namespaces and element IDs.
Binding scope: HyperFrames recorded core/readiness contract at 2dd708e0, version 0.8.142. Observation: Documentation and types read; no injected async/media loading test. Source IDs: R04-S003, R04-S004, R04-S009, R04-S010. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S004](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/determinism-rules.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S009](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/core/src/compositionReadiness.ts) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S010](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/core/src/runtime/window.d.ts) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P18` when tracing a decision.
<a id="p19"></a>
### P19 — Keep HyperFrames animation inside its ownership boundary
**Admission:** General. **Exact scope:** HyperFrames 0.8.142 timed-clip/media ownership and seek-state contract at 2dd708e0. Approved non-GSAP adapters remain possible; no imported Remotion/Motion Canvas timing.
**Condition:** A seekable composition animates timed visual/media elements. (Evidence: R04-F007.)
**Action:** Derive animation state from seek time and animate inner visual elements; let the framework control timed clip visibility and video/audio clock. Avoid writing visibility/autoAlpha on timed clips or manually playing/seeking their media. (Evidence: R04-F007.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Boundaries:** GSAP is the primary profile, with approved non-GSAP seekable adapters possible; not a claim that GSAP is the only runtime.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R04-F007:** origin `documented_contract`; confidence `high`; observed: Pinned code/documentation read; source production output not executed Relation: `changed`. Boundary: Authors may use approved non-GSAP seekable adapters; GSAP primary, not sole runtime.
**Sources:** [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S004](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/determinism-rules.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S012](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/concepts/compositions.mdx) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P19` when tracing a decision.
<a id="p20"></a>
### P20 — Inspect visible HyperFrames loading separately from static lint
**Admission:** Scoped. **Exact scope:** Two separate recorded cases: installed HyperFrames 0.8.142 local check/snapshot/strict-export validation profile; and Coleam 098505b5 empty-preview mounting diagnosis with unspecified older engine version. The older diagnosis is not a universal current fallback rule.
**Condition:** Lint is clean or preview appears blank, and the composition must be visibly mounted. (Evidence: R04-F005, R01-F006.)
**Action:** Run browser check and snapshots at relevant times to inspect actual mounting/layout; retain reported sample counts because lint errors can prevent browser layout/contrast sampling.
Pinned local CLI templates (angle-bracket values are caller parameters): ./node_modules/.bin/hyperframes --version; ./node_modules/.bin/hyperframes check <project-dir> --at <seconds-list> --json; ./node_modules/.bin/hyperframes snapshot <project-dir> --at <seconds-list> --no-end --describe false. Preview contract: ./node_modules/.bin/hyperframes preview <project-dir> --background. These are separate invocations, not shell chains. (Evidence: R04-F005.)
**Recovery:** For the older Coleam empty-preview incident, inspect cross-file composition IDs, clip timing/class/metadata and displayed browser duration; treat it as version-specific diagnosis. (Evidence: R01-F006.)
**Verification:** Confirm visible snapshots and expected duration separately from lint status; check does not guarantee full motion or audio correctness.
Pinned strict smoke/export template: ./node_modules/.bin/hyperframes render <project-dir> --output <output.mp4> --fps <fps> --workers 1 --no-best-effort --frames-cache-dir off. Then inspect the actual file with ffprobe -v error -show_format -show_streams -of json <output.mp4>. The one-worker/disabled-cache/strict settings are a reproduced validation profile, not a claim of fastest or universally required settings. (Evidence: R04-F005, R01-F006.)
**Boundaries:** Do not import the older strict-match claim into the current assembler’s fallback semantics. The smoke is a two-second silent geometry fixture, not an async/media quality validation.
**Admission confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "not_applicable_or_case_limited", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R01-F006:** origin `author_stated`; confidence `medium`; observed: Read source text/code; no controlled production experiment Relation: `changed`. Boundary: Version-specific creator incident; no exact engine version or independent rerun
**R04-F005:** origin `documented_contract`; confidence `high`; observed: Pinned code/documentation read; source production output not executed Relation: `changed`. Boundary: check includes lint; lint errors skip layout/contrast and can show0 samples. No automated audit guarantees full motion/audio correctness.
**Admitted profile binding (action):** Pinned local CLI templates (angle-bracket values are caller parameters): ./node_modules/.bin/hyperframes --version; ./node_modules/.bin/hyperframes check <project-dir> --at <seconds-list> --json; ./node_modules/.bin/hyperframes snapshot <project-dir> --at <seconds-list> --no-end --describe false. Preview contract: ./node_modules/.bin/hyperframes preview <project-dir> --background. These are separate invocations, not shell chains.
Binding scope: Installed hyperframes@0.8.142 CLI; choose meaningful scene/mount/boundary sample times rather than copying the smoke times. Observation: Version/check/snapshot ran on silent two-second smoke; preview route is documented, not visually reviewed in R04. Source IDs: R04-S006, R04-S008, R04-S015. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Admitted profile binding (verification):** Pinned strict smoke/export template: ./node_modules/.bin/hyperframes render <project-dir> --output <output.mp4> --fps <fps> --workers 1 --no-best-effort --frames-cache-dir off. Then inspect the actual file with ffprobe -v error -show_format -show_streams -of json <output.mp4>. The one-worker/disabled-cache/strict settings are a reproduced validation profile, not a claim of fastest or universally required settings.
Binding scope: Installed hyperframes@0.8.142 local CLI profile, exact help/commands retained in research_R04.engine_contract and validation_results. Observation: Actual silent geometry MP4: 640×360, 30fps, 60 frames, two seconds; sampled-frame/repeated-seek review only. Source IDs: R04-S006, R04-S008, R04-S015. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R01-S009](https://github.com/coleam00/hyperframes-ai-video-generation/blob/098505b5d6b14dfcf87a5a7a50241fd9a119eb6e/.claude/rules/sub-composition-wiring.md) (revision `098505b5d6b14dfcf87a5a7a50241fd9a119eb6e`); [R04-S006](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-cli/SKILL.md) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S008](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/guides/rendering.mdx) (revision `2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2`); [R04-S015](https://registry.npmjs.org/hyperframes/-/hyperframes-0.8.142.tgz) (revision `0b21016905f208f8bc9fb37f7b65737f75fe0d2f`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P20` when tracing a decision.
<a id="p21"></a>
### P21 — Compile Remotion’s frame-derived timing deterministically
**Admission:** General. **Exact scope:** Remotion 4.0.534 / 4d9ff70e1f489cd671045d8a2e944e4b8853c63d frame-function, Sequence, spring, interpolation and flickering contracts. Reordered/repeated-frame verification establishes only tested frames/environment.
**Condition:** A Remotion composition and its child intervals must render under out-of-order or parallel capture. (Evidence: R05-F001, R05-F004, R08-F007.)
**Action:** Derive visible motion from the requested zero-indexed frame. Set durationInFrames from fps and target seconds, with last frame duration−1. Treat Sequence visibility as [from, from+duration), retain local child clocks, pass fps to spring and make interpolation clamps explicit.
Remotion registration profile: registerRoot(Root); Root contains Composition with id, component, fps, width, height and durationInFrames. useCurrentFrame() is zero-indexed and local inside a Sequence; supply an absolute-frame prop only when that design needs it. spring({frame,fps,...}) uses composition fps; interpolate(frame,inputRange,outputRange,{extrapolateLeft:"clamp",extrapolateRight:"clamp"}) explicitly bounds values when clamping is intended. (Evidence: R05-F001, R05-F004, R08-F007.)
**Recovery:** Replace timer or mutable tab-state motion with requested-frame state; concurrency 1 does not reliably synchronize wall-clock animation. (Evidence: R08-F007.)
**Verification:** Compare the same requested frame under reordered/repeated capture; bound the conclusion to tested frames/environment. (Evidence: R08-F007.)
**Boundaries:** 15 seconds × 30fps gives 450 frames 0…449 as arithmetic. The actual smoke was 60 frames/2 seconds and one repeated still; no matched-engine performance or full determinism certification.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R05-F001:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: Exact tag docs read; synthetic fixture not matched15s comparison Relation: `unresolved`. Boundary: Only Remotion side established; missing other side cannot confirm changed
**R05-F004:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: ffprobe60frames/30fps/2s; sampled29/30/59 verify boundary/local reset in smoke only Relation: `unresolved`. Boundary: 450 count is arithmetic from official contract; synthetic2s fixture actually60frames
**R08-F007:** origin `documented_contract`; confidence `high documented boundary; medium author-reported outcomes`; observed: First-party text/source read; no controlled production trial Relation: `changed`. Boundary: Official applicability contract; no injected flickering failure or full determinism certification from one repeated still
**Admitted profile binding (action):** Remotion registration profile: registerRoot(Root); Root contains Composition with id, component, fps, width, height and durationInFrames. useCurrentFrame() is zero-indexed and local inside a Sequence; supply an absolute-frame prop only when that design needs it. spring({frame,fps,...}) uses composition fps; interpolate(frame,inputRange,outputRange,{extrapolateLeft:"clamp",extrapolateRight:"clamp"}) explicitly bounds values when clamping is intended.
Binding scope: Remotion 4.0.534 / 4d9ff70e; package versions match; direct Sequence legal while docs advise timing props. Observation: Two-second frame/Sequence/spring smoke rendered; 29/30/59 samples and one repeated still inspected. Source IDs: R05-S005, R05-S006, R05-S007, R05-S008, R05-S009. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R05-S004](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/flickering.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S005](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/use-current-frame.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S006](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/composition.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S007](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/sequence.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S008](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/interpolate.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S009](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/spring.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P21` when tracing a decision.
<a id="p22"></a>
### P22 — Select Remotion’s Node server export path when that environment is available
**Admission:** General. **Exact scope:** Remotion 4.0.534 / 4d9ff70e server/Node screenshot and encoding route with exact version-matched packages and selected browser. CLI concurrency 2 and silent geometry probe are reproduced profiles, not performance optima.
**Condition:** Node and the required browser/encoding environment are available for server rendering. (Evidence: R05-F002, R06-F003.)
**Action:** Use a bundled or served composition URL, selectComposition and renderMedia, or the version-matched render/still CLI path; server capture screenshots browser frames and encodes with FFmpeg.
Version-matched local CLI templates: ./node_modules/.bin/remotion versions; ./node_modules/.bin/remotion studio <entry.tsx> --port=<port>; ./node_modules/.bin/remotion still <entry.tsx> <composition-id> <output.png> --frame=<frame> --image-format=png --browser-executable=<chrome-path>; ./node_modules/.bin/remotion render <entry.tsx> <composition-id> <output.mp4> --codec=h264 --concurrency=2 --browser-executable=<chrome-path>. API route: bundle/serve URL → selectComposition → renderMedia. Concurrency 2 is the executed smoke configuration, not a universal performance optimum. (Evidence: R05-F002, R06-F003.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Server profile output probe: ffprobe -v error -show_format -show_streams -of json <output.mp4>; compare actual dimensions/fps/duration/frame coverage to Composition. Do not treat the intentionally empty initial local spring frame in the smoke as an unintended black-frame failure. (Evidence: R05-F004, R05-F002.)
**Boundaries:** Version-matched CLI/API paths only; server two-second geometry smoke ran, font/audio/media fault injection and full-motion review did not.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R05-F002:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: Same release documentation and package checked; server smoke executed; browser render unexecuted Relation: `changed`. Boundary: Stable>=4.0.491; Chrome94+/FF130+/Safari26+ baseline; OffthreadVideo/Html5Video/Html5Audio unsupported browser compositor; optional HTML-in-canvas has separate support constraints
**R05-F004:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: ffprobe60frames/30fps/2s; sampled29/30/59 verify boundary/local reset in smoke only Relation: `unresolved`. Boundary: 450 count is arithmetic from official contract; synthetic2s fixture actually60frames
**R06-F003:** origin `documented_contract`; confidence `high`; observed: R05 shared immutable v4.0.534 docs read; current official docs verified stable>=4.0.491 Relation: `changed`. Boundary: First-party contract not controlled rendered comparison. Browser requires WebCodecs, supported codec, correct media components; HTML-in-canvas optional feature must not be assumed in installedChrome154. Remotion licensing unchanged across contexts.
**Admitted profile binding (action):** Version-matched local CLI templates: ./node_modules/.bin/remotion versions; ./node_modules/.bin/remotion studio <entry.tsx> --port=<port>; ./node_modules/.bin/remotion still <entry.tsx> <composition-id> <output.png> --frame=<frame> --image-format=png --browser-executable=<chrome-path>; ./node_modules/.bin/remotion render <entry.tsx> <composition-id> <output.mp4> --codec=h264 --concurrency=2 --browser-executable=<chrome-path>. API route: bundle/serve URL → selectComposition → renderMedia. Concurrency 2 is the executed smoke configuration, not a universal performance optimum.
Binding scope: Remotion 4.0.534 at 4d9ff70e; all installed Remotion packages exact 4.0.534. Observation: CLI help/versions, still and server render executed; Studio HTTP 200 observed, visual Studio review absent. Source IDs: R05-S018, R05-S019, R05-S020, R05-S021, R05-S022, R05-S023, R05-S024. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Admitted profile binding (verification):** Server profile output probe: ffprobe -v error -show_format -show_streams -of json <output.mp4>; compare actual dimensions/fps/duration/frame coverage to Composition. Do not treat the intentionally empty initial local spring frame in the smoke as an unintended black-frame failure.
Binding scope: Remotion 4.0.534 server smoke/output validation; caller Composition determines acceptance. Observation: Actual 320×180 H264, 30fps, 60-frame/two-second file; sample frame 30 is intentionally initial/empty; no audio track. Source IDs: R05-S006, R05-S018, R05-S021. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R05-S006](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/composition.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S014](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/index.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S015](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/limitations.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S018](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/cli/render.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S019](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/cli/still.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S020](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/cli/studio.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S021](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/renderer/render-media.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S022](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/renderer/select-composition.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S023](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/bundle.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S024](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/ssr.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P22` when tracing a decision.
<a id="p23"></a>
### P23 — Select the isolated Remotion browser compositor only within its supported subset
**Admission:** General. **Exact scope:** Remotion 4.0.534 @remotion/web-renderer browser compositor, WebCodecs/codec and documented DOM/CSS/media subset; React >=18. HTML-in-canvas Chrome 157.0.8080.0+ condition is separate from baseline browsers. Browser export remains unexecuted.
**Condition:** Only a browser is available and its WebCodecs/codec and supported composition subset can be established. (Evidence: R05-F002, R06-F003.)
**Action:** Use renderMediaOnWeb with component/config/inputProps rather than server bundling. Adapt media and DOM/CSS to the browser compositor’s supported subset; OffthreadVideo, Html5Video and Html5Audio are not supported by this path.
Browser profile uses @remotion/web-renderer renderMediaOnWeb/renderStillOnWeb with composition config and inputProps. Pinned baseline support: Chrome 94+, Firefox 130+, Safari 26+, plus supported codec/WebCodecs. web-renderer requires React >=18. Optional nested HTML-in-canvas capture requires Chrome 157.0.8080.0+; the fallback built-in DOM compositor has its own supported subset. (Evidence: R05-F002, R06-F003.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Verify the actual browser, WebCodecs and target codec/component support; optional HTML-in-canvas has its own browser requirement and cannot be assumed in the tested Chrome 154. (Evidence: R05-F002, R06-F003.)
**Boundaries:** Browser export unexecuted. Server rendering and client compositing are different routes; the installed Chrome server smoke does not validate browser export.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R05-F002:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: Same release documentation and package checked; server smoke executed; browser render unexecuted Relation: `changed`. Boundary: Stable>=4.0.491; Chrome94+/FF130+/Safari26+ baseline; OffthreadVideo/Html5Video/Html5Audio unsupported browser compositor; optional HTML-in-canvas has separate support constraints
**R06-F003:** origin `documented_contract`; confidence `high`; observed: R05 shared immutable v4.0.534 docs read; current official docs verified stable>=4.0.491 Relation: `changed`. Boundary: First-party contract not controlled rendered comparison. Browser requires WebCodecs, supported codec, correct media components; HTML-in-canvas optional feature must not be assumed in installedChrome154. Remotion licensing unchanged across contexts.
**Admitted profile binding (action):** Browser profile uses @remotion/web-renderer renderMediaOnWeb/renderStillOnWeb with composition config and inputProps. Pinned baseline support: Chrome 94+, Firefox 130+, Safari 26+, plus supported codec/WebCodecs. web-renderer requires React >=18. Optional nested HTML-in-canvas capture requires Chrome 157.0.8080.0+; the fallback built-in DOM compositor has its own supported subset.
Binding scope: Remotion 4.0.534 browser path; separate compositor/codec checks still required. Observation: Official contract/packages read; browser render was not executed. Source IDs: R05-S014, R05-S015, R05-S016. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R05-S014](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/index.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S015](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/limitations.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S016](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/web-renderer/package.json) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P23` when tracing a decision.
<a id="p24"></a>
### P24 — Keep Remotion resource-wait handles stable and clear them
**Admission:** General. **Exact scope:** Remotion 4.0.534 server delayRender/resource/font handling and browser context-bound useDelayRender contract; stable handles, clear/cancel semantics and default readiness timeout only.
**Condition:** A render depends on asynchronous data, images or fonts. (Evidence: R05-F003.)
**Action:** Use a stable lazily initialized wait handle on the documented server path, and useDelayRender’s context-bound hook on the browser compositor. Continue every completed handle, or cancel on failure, instead of allocating handles on every rerender.
Remotion readiness profile: allocate server delayRender handles through stable lazy useState initialization; use continueRender(handle) or cancelRender(error). On the browser compositor use the context-bound useDelayRender hook. Load fonts before measuring text. The default readiness timeout is 30 seconds at this pin. (Evidence: R05-F003.)
**Recovery:** Resolve leaked/pending handles or cancel the failing render; do not disguise the timeout as completed resource loading. (Evidence: R05-F003.)
**Verification:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Conditional branches (retain separately):**
- Server screenshot/render readiness → Stable wait handle; clear or cancel all handles.
- Browser compositor readiness → Use context-bound useDelayRender hook; clear or cancel all handles.
**Boundaries:** Default 30-second timeout is the versioned engine contract, not a creative timing default. Data state is allowed; motion must remain frame-derived. No resource fault injection executed.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R05-F003:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: Official bug/fix code read; no remote-resource fault injection Relation: `changed`. Boundary: Default30s timeout; repeated handles per React rerender leak; data state allowed, frame-motion state must remain deterministic
**Admitted profile binding (action):** Remotion readiness profile: allocate server delayRender handles through stable lazy useState initialization; use continueRender(handle) or cancelRender(error). On the browser compositor use the context-bound useDelayRender hook. Load fonts before measuring text. The default readiness timeout is 30 seconds at this pin.
Binding scope: Remotion 4.0.534 resource/font-readiness contract; frame motion remains deterministic. Observation: Bug/fix/docs read; remote-resource and font fault injection not executed. Source IDs: R05-S004, R05-S010, R05-S011. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R05-S004](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/flickering.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S010](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/delay-render.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S011](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/fonts.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P24` when tracing a decision.
<a id="p25"></a>
### P25 — Require an explicit Motion Canvas video exporter for encoded delivery
**Admission:** General. **Exact scope:** Motion Canvas released 3.17.2 / e735a995aa738ca682feb4204a39ee7db7b5d279 generator/project/Vite-editor FFmpeg exporter contract. Local HMR/server bridge required; default image-sequence export and static build remain different routes; no official headless CLI assumed.
**Condition:** The scene must deliver encoded video instead of the default image sequence. (Evidence: R06-F001.)
**Action:** Install/register the version-matched @motion-canvas/ffmpeg plugin beside motionCanvas(), select Video (FFmpeg) in editor Video Settings, then use local editor RENDER and inspect output/<project-name>.mp4.
Motion Canvas 3.17.2 profile: makeScene2D(function* (view)); createRef/createSignal/waitFor/all from @motion-canvas/core; yield* delegates waits/tweens and durations are seconds. Import scenes with ?scene into makeProject({scenes}). In vite.config.ts, import ffmpeg and register ffmpeg() after motionCanvas(). Start the authored local Vite project with its npm run start script; select Video (FFmpeg) in Video Settings and click RENDER. The expected default video location is output/<project-name>.mp4; no headless CLI render command is asserted. (Evidence: R06-F001.)
**Recovery:** When the video exporter is absent, install/register/select it before claiming video export; default image export and editor preview remain distinct states. (Evidence: R06-F001.)
**Verification:** Check that the video exporter is actually selected and an encoded file exists. (Evidence: R06-F001.)
**Boundaries:** Local install/build passed, UI render did not execute. Released exporter needs local Vite/HMR/server bridge; static production bundle is not this path. No verified official headless render CLI.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R06-F001:** origin `documented_contract`; confidence `high`; observed: Docs and installed3.17.2 client read; local install/build pass; UI export not executed Relation: `changed`. Boundary: First-party applicability boundary; missing exporter is a documented condition, not a historical failed user project. Audio held fixed. No executed paired missing/present video export.
**Admitted profile binding (action):** Motion Canvas 3.17.2 profile: makeScene2D(function* (view)); createRef/createSignal/waitFor/all from @motion-canvas/core; yield* delegates waits/tweens and durations are seconds. Import scenes with ?scene into makeProject({scenes}). In vite.config.ts, import ffmpeg and register ffmpeg() after motionCanvas(). Start the authored local Vite project with its npm run start script; select Video (FFmpeg) in Video Settings and click RENDER. The expected default video location is output/<project-name>.mp4; no headless CLI render command is asserted.
Binding scope: Motion Canvas all packages exact 3.17.2 / released e735a995; generator replay is not an arbitrary pure renderAt(t) API. Observation: npm install and tsc/Vite build passed; preview server started, native/browser UI unavailable; no encoded render. Source IDs: R06-S001, R06-S002, R06-S004, R06-S006, R06-S007, R06-S024. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R06-S001](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/rendering/index.mdx) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S002](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/rendering/video.mdx) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S004](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/flow.mdx) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S006](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/client/FFmpegExporterClient.ts) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S007](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/server/FFmpegExporterServer.ts) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S024](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/signals.mdx) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P25` when tracing a decision.
<a id="p26"></a>
### P26 — Configure Motion Canvas project audio separately from video export
**Admission:** General. **Exact scope:** Motion Canvas released 3.17.2 one-track project audio and FFmpeg exporter settings at e735a995, with Include audio conditional on project.audio. Positive-offset FIXME and untested sync/listening remain explicit.
**Condition:** The selected video exporter must include an authorized local audio track, or the project intentionally has no audio. (Evidence: R06-F002.)
**Action:** Import the local track and pass it to makeProject({scenes, audio}); configure its offset and enable Include audio. With no project audio, Include audio is disabled and the video can be silent.
Released Motion Canvas audio profile: import authorized local audio and supply makeProject({scenes,audio}); store audio offset in shared project metadata and select Include audio when available. One project track is supported here. Do not import newer main sound() APIs; the positive-offset FIXME prevents assuming tested offset behavior. (Evidence: R06-F002.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Check configured project audio and Include audio independently from exporter presence. (Evidence: R06-F002.)
**Boundaries:** No export/listening performed. Positive offset implementation contains a FIXME; do not promise tested sync. Current main sound() APIs are not 3.17.2 evidence.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R06-F002:** origin `documented_contract`; confidence `high`; observed: Installed client disable(!project.audio) and server input conditional inspected; no audio export/listening Relation: `changed`. Boundary: Separate contrast from exporter existence; released3.17.2 one project track, offset implementation contains FIXME positive offsets; current main has newer sound API, not evidence for released3.17.2
**Admitted profile binding (action):** Released Motion Canvas audio profile: import authorized local audio and supply makeProject({scenes,audio}); store audio offset in shared project metadata and select Include audio when available. One project track is supported here. Do not import newer main sound() APIs; the positive-offset FIXME prevents assuming tested offset behavior.
Binding scope: Motion Canvas released 3.17.2 one-track project-audio implementation. Observation: Installed disable(!project.audio)/server audio input code inspected; audio export and listening unexecuted. Source IDs: R06-S002, R06-S003, R06-S006, R06-S007. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R06-S002](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/rendering/video.mdx) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S003](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/media.mdx) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S006](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/client/FFmpegExporterClient.ts) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R06-S007](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/server/FFmpegExporterServer.ts) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P26` when tracing a decision.
<a id="p27"></a>
### P27 — Route the specific Canvas/WebGL reel through its actual encoder
**Admission:** Scoped. **Exact scope:** Visualx kinetic-reel at 18c8426f Node/Chrome/external-FFmpeg source renderer only; browser-only source route is preview. No renderer execution or general Canvas/WebGL encoding fallback demonstrated.
**Condition:** This reel’s documented Node/Chrome/FFmpeg stack is available; browser preview alone has no demonstrated encoded-export API. (Evidence: R06-F004.)
**Action:** Wait for window.ready/fonts, call renderAt(i/fps), and capture frames through the documented Puppeteer pipeline before FFmpeg encoding; audio is an explicit input.
The selected kinetic-reel backend is Canvas 2D → Three 0.160.0 → WebGL post → output canvas. Its Node renderer waits window.ready, invokes window.renderAt(t) at t=i/fps, and captures through Puppeteer/Chrome to JPEG sequence or pipe. External FFmpeg uses libx264/yuv420p/+faststart; audio is explicitly provided and encoded to AAC. The recorded script exposes --clip/--range and --frames then --encode; no browser-only encoding route is shown. (Evidence: R06-F004.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Treat browser-only execution as preview-only for this repository; do not claim a WebCodecs fallback that this source does not implement. (Evidence: R06-F004.)
**Boundaries:** Canvas/WebGL names alone do not identify an encoder. Source-local route, no video generated and no general renderer certification. Same code case as R03, not an additional case.
**Admission confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "not_applicable_or_case_limited", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R06-F004:** origin `researcher_inferred`; confidence `medium`; observed: Read renderAt/frame functions, readiness/font gate, ffmpeg args; no video generated in R06 Relation: `changed`. Boundary: Source-local boundary. No WebCodecs encoder demonstrated by this project. Do not call it browser-only export fallback. Actual recorded source is R03-C code case, deduplicate; not new union case.
**Admitted profile binding (action):** The selected kinetic-reel backend is Canvas 2D → Three 0.160.0 → WebGL post → output canvas. Its Node renderer waits window.ready, invokes window.renderAt(t) at t=i/fps, and captures through Puppeteer/Chrome to JPEG sequence or pipe. External FFmpeg uses libx264/yuv420p/+faststart; audio is explicitly provided and encoded to AAC. The recorded script exposes --clip/--range and --frames then --encode; no browser-only encoding route is shown.
Binding scope: Visualx kinetic-reel 18c8426f source contract only; resolve actual Puppeteer/Chrome/FFmpeg versions and rights before use. Observation: Source renderer and dependency manifest inspected; no generated video and no CLI command beyond source-documented flags assumed. Source IDs: R03-S005, R06-S013, R06-S014. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R03-S005](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/reel/reel.js) (revision `18c8426fe97c1353dc62afd584f7ac8e39ad64bd`); [R06-S013](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/render.mjs) (revision `18c8426fe97c1353dc62afd584f7ac8e39ad64bd`); [R06-S014](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/package.json) (revision `18c8426fe97c1353dc62afd584f7ac8e39ad64bd`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P27` when tracing a decision.
<a id="p31"></a>
### P31 — Use Motion Canvas’s own persisted event cues for spoken timing
**Admission:** General. **Exact scope:** Motion Canvas released 3.17.2 / e735a995 named editor events waitUntil/useDuration and persisted scene metadata contract, including downstream shifts. No automatic transcription/alignment or Remotion event API.
**Condition:** A Motion Canvas scene’s cues need adjustment to match ready or revised voiceover timing. (Evidence: R07-F004.)
**Action:** Use named waitUntil events and useDuration where appropriate, adjust their time in the editor and preserve the resulting scene metadata so downstream event shifts follow the engine’s contract.
Motion Canvas event profile: waitUntil(name) names an editor event; useDuration(name) reads its duration. Editor adjustments persist in scene metadata and can shift downstream events. Preserve metadata with the project. (Evidence: R07-F004.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Boundaries:** Separate engine contract from RAG/Remotion frame constants. No automatic transcription/alignment is implied and no revised voice recording was tested.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R07-F004:** origin `source_stated_boundary`; confidence `high for documented contract; medium for author historical accounts; perception unverified`; observed: Read pinned docs; no revised voice recording or re-render Relation: `changed`. Boundary: Separate engine contracts. RAG retiming statement is source local; Motion Canvas waitUntil events belong to3.17.2 and are not Remotion APIs. No actual revised-voice audio pair acquired.
**Admitted profile binding (action):** Motion Canvas event profile: waitUntil(name) names an editor event; useDuration(name) reads its duration. Editor adjustments persist in scene metadata and can shift downstream events. Preserve metadata with the project.
Binding scope: Motion Canvas 3.17.2 / e735a995 event APIs, never Remotion APIs. Observation: Pinned event docs read; no automatic alignment or retimed voice render performed. Source IDs: R06-S005. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R02-S009](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/narration-storyboard.md) (revision `735c79c8724e897e8971cd59dde7e5aa11e4d6ce`); [R06-S005](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/time-events.mdx) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`); [R07-S004](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/交付说明.md) (revision `735c79c8724e897e8971cd59dde7e5aa11e4d6ce`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P31` when tracing a decision.
<a id="p36"></a>
### P36 — Verify the encoded artifact independently of preview or build
**Admission:** Scoped. **Exact scope:** Historical Motion Canvas export reports #1052 (3.10-era selected-range duration/seek) and #1204 (3.18 alpha missing frames) only. Export-specific reported failures do not establish current stable defects or every programmatic-video probe procedure.
**Condition:** Delivery requires an encoded file, while only editor preview or successful build may currently exist. (Evidence: R08-F004.)
**Action:** For these reported Motion Canvas export incidents, inspect the encoded file for reported missing frames and selected-range duration/end/seek behavior independently of the editor preview. (Evidence: R08-F004.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Retain preview/build evidence as separate from measured exported properties. The historical selected-range and missing-frame incidents are version-specific examples of what preview cannot prove. (Evidence: R08-F004.)
**Boundaries:** Issues #1052 at 3.10-era and #1204 at 3.18 alpha are not assertions of current stable defects; no own matched preview/export reproduction.
**Admission confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "not_applicable_or_case_limited", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R08-F004:** origin `author_stated`; confidence `high documented boundary; medium author-reported outcomes`; observed: First-party text/source read; no controlled production trial Relation: `changed`. Boundary: Documented export-specific failure scope; issue1052 old3.10 versions and1204 alpha not current stable defect assertions; no matched own preview/export reproduction
**Sources:** [R06-S009](https://github.com/motion-canvas/motion-canvas/issues/1204) (revision `unresolved`); [R06-S011](https://github.com/motion-canvas/motion-canvas/issues/1052) (revision `unresolved`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P36` when tracing a decision.
<a id="p37"></a>
### P37 — Determine Remotion production eligibility under its pinned license
**Admission:** General. **Exact scope:** Remotion 4.0.534 software LICENSE at 4d9ff70e, current v4 terms, exact subject/use eligibility and v4 server/browser telemetry. Upcoming v5, hosted services, codecs and media permissions remain separate; no user eligibility/purchase inferred.
**Condition:** The intended production use is evaluated under pinned v4 eligibility; individual/nonprofit/for-profit with at most three employees/noncommercial-evaluation conditions differ from other for-profit uses. (Evidence: R08-F001, R05-F005.)
**Action:** Establish the intended subject/use and applicable v4 license before production. Source-defined eligible uses can use the free tier; a for-profit outside that group requires the Company License. Do not infer production eligibility from a noncommercial smoke test. (Evidence: R08-F001.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Record the exact package license and subject/use basis; retain server/client telemetry differences separately and treat announced v5 requirements as upcoming, not v4 terms.
Remotion 4.0.534 telemetry profile: server telemetry is tied to licenseKey and successful renders; browser sends completed/failed render telemetry regardless of key, excluding aborted renders. v5 mandatory Automators key/telemetry is announced upcoming and is not substituted for the pinned v4 software terms. Hosted-service, Mediabunny/encoder MPL-2.0 and media permissions remain separate scopes. (Evidence: R08-F001, R05-F005.)
**Boundaries:** User company/production eligibility unknown and no purchase authorized. No legal clearance, paid service or media/font/music rights follow from evaluation permission.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R05-F005:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: Pinned LICENSE,FAQ,telemetry read; synthetic evaluation only Relation: `changed`. Boundary: 5.0 mandatory Automators key/telemetry is announced transition; do not assume production free eligibility
**R08-F001:** origin `documented_contract`; confidence `high documented boundary; medium author-reported outcomes`; observed: First-party text/source read; no controlled production trial Relation: `changed`. Boundary: Explicit versioned eligibility boundary suffices; this research is evaluation, user production/company eligibility unknown; no purchase authorized
**Admitted profile binding (verification):** Remotion 4.0.534 telemetry profile: server telemetry is tied to licenseKey and successful renders; browser sends completed/failed render telemetry regardless of key, excluding aborted renders. v5 mandatory Automators key/telemetry is announced upcoming and is not substituted for the pinned v4 software terms. Hosted-service, Mediabunny/encoder MPL-2.0 and media permissions remain separate scopes.
Binding scope: Exact Remotion 4.0.534/license/current v4 terms; no user production eligibility or service purchase inferred. Observation: License/FAQ/telemetry/package text read; noncommercial synthetic evaluation only. Source IDs: R05-S001, R05-S017, R05-S025, R05-S039, R05-S040, R05-S041, R08-S002. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R05-S001](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/LICENSE.md) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S017](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/telemetry.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S025](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/license/faq.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S039](https://registry.npmjs.org/mediabunny/1.56.1) (revision `1.56.1`); [R05-S040](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/terms.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S041](https://www.remotion.pro/terms-4-0) (revision `Current v4.0 terms; page last update2023-11-23; retrieved2026-10-08UTC`); [R08-S002](https://www.remotion.pro/terms-4-0) (revision `unresolved`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P37` when tracing a decision.
<a id="p39"></a>
### P39 — Freeze revision identity and binary rights instead of relying on a version label
**Admission:** Scoped. **Exact scope:** Motion Canvas npm 3.17.2 release e735a995 versus main 7b91435c exporter/license metadata, plus exact locally inspected @ffmpeg-installer/darwin-arm64@4.1.5 FFmpeg 4.4 binary. The nonredistributable observation applies to this build only.
**Condition:** A manifest version is the same while source revision, exporter dependencies or license path differ. (Evidence: R08-F006.)
**Action:** Record release commit/gitHead, installed lock/tree and actual license paths. Keep released MIT wrapper and main GPLv3 exporter metadata separate, and inspect the actual FFmpeg binary’s terms/build rather than inherit the wrapper license. (Evidence: R08-F006.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** Compare the installed release and selected source revision; the locally inspected bundled FFmpeg reports nonfree parts and no redistribution permission, so it remains outside distribution.
Exact binary observation: installed Motion Canvas @ffmpeg-installer/darwin-arm64@4.1.5 contains FFmpeg 4.4 with --enable-gpl --enable-libx264 --enable-version3 --enable-nonfree. Its -L reports nonfree parts and says the binary is not legally redistributable. Keep this cached binary and installed dependency tree excluded from runtime distribution; a wrapper MIT notice does not grant binary rights. (Evidence: R08-F006.)
**Boundaries:** Version/license provenance contract, no broad relicense conclusion. The cached binary’s observation is exact-build-specific; no dependencies/binaries are bundled into runtime.
**Admission confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "not_applicable_or_case_limited", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R08-F006:** origin `documented_contract`; confidence `high documented boundary; medium author-reported outcomes`; observed: First-party text/source read; no controlled production trial Relation: `changed`. Boundary: Source revision/license path and installed tree are necessary scope; no broad legal relicense claim. Exact bundled binary nonredistributable observation stored separately
**Admitted profile binding (verification):** Exact binary observation: installed Motion Canvas @ffmpeg-installer/darwin-arm64@4.1.5 contains FFmpeg 4.4 with --enable-gpl --enable-libx264 --enable-version3 --enable-nonfree. Its -L reports nonfree parts and says the binary is not legally redistributable. Keep this cached binary and installed dependency tree excluded from runtime distribution; a wrapper MIT notice does not grant binary rights.
Binding scope: Exact locally probed installer/binary build only, separate from current main exporter and system FFmpeg. Observation: Actual binary version/license probes executed and retained under engine-validation/motion-canvas; no media encoding ran. Source IDs: R06-S018, R08-S006, R06-S019. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R06-S018](https://ffmpeg.org/legal.html) (revision `unresolved`); [R06-S019](https://github.com/motion-canvas/motion-canvas/blob/7b91435c301d530351dcf5ebb91dd139c002e405/packages/ffmpeg/package.json) (revision `7b91435c301d530351dcf5ebb91dd139c002e405`); [R08-S006](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/package.json) (revision `e735a995aa738ca682feb4204a39ee7db7b5d279`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P39` when tracing a decision.
<a id="p40"></a>
### P40 — Translate audio and caption timing through the selected engine’s declared units
**Admission:** General. **Exact scope:** Typed translation between Remotion 4.0.534 Audio/Caption/frame contracts at 4d9ff70e and Anything2Explainer 735c79c8 generated one-based inclusive frame tables. Does not establish actual audio alignment or audiovisual quality.
**Condition:** Measured voiced tables are being consumed by the chosen Remotion implementation rather than their source workflow. (Evidence: R07-F002, R05-F004.)
**Action:** Retain each timing field’s unit and index/range convention when translating the voiced plan. Remotion composition/audio timing uses frames while Caption timing uses milliseconds; RAG generated tables use their own inclusive one-based frame convention and cannot be passed directly as zero-based Remotion intervals.
Remotion 4.0.534 media profile: import {Audio} from "@remotion/media" and use staticFile for local authorized assets. Audio from, trimBefore and durationInFrames are frame counts; durationInFrames selects source frames and occupies durationInFrames/playbackRate parent frames. Caption from @remotion/captions has text, startMs/endMs, timestampMs:number|null and confidence:number|null; preserve whitespace in text. Caption data is plain data, not automatic transcription. The RAG workflow’s one-based inclusive generated frames are an upstream convention to translate, not Remotion API indices. (Evidence: R07-F002, R05-F004.)
**Recovery:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Verification:** `null` — unsupported; do not fill this operation component. (Evidence: none.)
**Boundaries:** This is a typed technical-contract translation, not evidence of speech alignment, language performance or a watched audiovisual result. Official Remotion audio/Caption details are explicit supplemental source bindings below.
**Admission confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}.
**Research verification state:** {"research_full_motion_review": "not_executed", "research_audio_listening": "not_executed", "empirical_effectiveness": "not_verified", "technical_contract": "documented", "runtime_observation": "Only observations in the finding/profile records apply; no broader executed validation inferred."}.
**R05-F004:** origin `documented_contract`; confidence `high_for_documented_contract; limited_runtime_validation`; observed: ffprobe60frames/30fps/2s; sampled29/30/59 verify boundary/local reset in smoke only Relation: `unresolved`. Boundary: 450 count is arithmetic from official contract; synthetic2s fixture actually60frames
**R07-F002:** origin `documented_workflow_contract`; confidence `high for documented contract; medium for author historical accounts; perception unverified`; observed: Read empty template and synthesis code; no TTS/provider invoked; RAG historical output author-stated Relation: `changed`. Boundary: Source-stated dependency, not an executed same-script before/after experiment. Pending text or placeholder frames cannot substantiate final aligned subtitles/completed narration.
**Admitted profile binding (action):** Remotion 4.0.534 media profile: import {Audio} from "@remotion/media" and use staticFile for local authorized assets. Audio from, trimBefore and durationInFrames are frame counts; durationInFrames selects source frames and occupies durationInFrames/playbackRate parent frames. Caption from @remotion/captions has text, startMs/endMs, timestampMs:number|null and confidence:number|null; preserve whitespace in text. Caption data is plain data, not automatic transcription. The RAG workflow’s one-based inclusive generated frames are an upstream convention to translate, not Remotion API indices.
Binding scope: Remotion 4.0.534 / 4d9ff70e audio and Caption contracts; RAG source 735c79c8 generated-data convention. Observation: Official API docs, generated template and synthesis code read. No actual audio/caption render, transcription or listening executed. Source IDs: R05-S012, R05-S013, R02-S001, R02-S010, R02-S009. Binding kind: `explicit_profile_citation_supplement_not_imputed_finding_proof`.
**Sources:** [R02-S001](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/README.md) (revision `735c79c8724e897e8971cd59dde7e5aa11e4d6ce`); [R02-S009](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/narration-storyboard.md) (revision `735c79c8724e897e8971cd59dde7e5aa11e4d6ce`); [R02-S010](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/scripts/tts_build.py) (revision `735c79c8724e897e8971cd59dde7e5aa11e4d6ce`); [R05-S005](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/use-current-frame.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S006](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/composition.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S007](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/sequence.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S008](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/interpolate.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S009](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/spring.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S012](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/media/audio.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R05-S013](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/captions/caption.mdx) (revision `4d9ff70e1f489cd671045d8a2e944e4b8853c63d`); [R07-S017](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/src/common/Subtitle.tsx) (revision `735c79c8724e897e8971cd59dde7e5aa11e4d6ce`).
Full component support and provenance: [operation cards](sop_models.md), [provenance](provenance.json), [source index](sources.md). Identify `P40` when tracing a decision.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |