editorbrain 0.27.1 → 0.29.1

package/skill/editorbrain-motion/references/authored-scenes.md

@@ -4,19 +4,24 @@ Use when a scene needs a visual mechanism (an object transforms, a structure fal
 
 ## Retrieve only what you need
 
-1. `list_authored_scenes` / `editorbrain motion scenes "dependencia"` searches literal intent, mechanism and niche (accent-insensitive); it is not semantic video search. Default six compact results. Use `nextCursor` as `after` / `--after` to continue the same query.
-2. `get_authored_scene` / `editorbrain motion scene word-structure --scene-version 1.0.0` loads one card: purpose, timing, parameter limits, what requires code changes, exact bundle hash. A similar niche alone does not establish fit.
-3. Inspect `get_authored_scene_preview` / `editorbrain motion preview <id> --scene-version 1.0.0 --ratio tall` (optional `--preview-kind poster`). Video and poster links expire after five minutes; downloads remain reference evidence, not a customer-brand render.
-4. Only when using its code, request `get_authored_scene_source` with the exact ID, version and bundle SHA-256; or `editorbrain motion source word-structure --scene-version 1.0.0 --out .editorbrain-local/word-structure.tar.gz`. CLI download needs login, verifies size/hash, preserves existing files, and does not extract or execute. MCP URLs expire; persist IDs/hashes instead.
+1. **Search by action.** `list_authored_scenes` / `editorbrain motion scenes "depender de un solo cliente"` ranks examples by mechanism, uses across niches and presets. Describe the action and change, such as "un total que se arma por partes". A different demo niche is not a reason to discard a mechanism. Default six compact results; reuse `nextCursor` as `after` / `--after` for the same query. This is weighted lexical retrieval, not a creative recommendation or semantic video analysis.
+2. **Look before reading.** For the strongest candidates (usually three, expand if unclear), request `first` and `last` in the project's ratio. MCP: `get_authored_scene_preview`, passing candidate `id` as `sceneId`, preserving `version`, and mapping the project format to `ratio` (`16:9` → `wide`, `1:1` → `square`, `9:16` → `tall`); use `kind: "first"` or `"last"`. CLI: `editorbrain motion preview <id> --scene-version 1.1.0 --ratio tall --preview-kind first`. `firstIsFrame1: false` means the image is the first informative state, not the literal first frame; inspect the returned time/frame. These images establish states, not motion, pacing or sound.
+3. **Read one card and choose an adaptation.** `get_authored_scene` / `editorbrain motion scene <id> --scene-version 1.1.0` gives the universal mechanism, use/not-for, timing, limits, presets and pinned source hash. If a preset fits the topic better, inspect its keyframes with `preset: "<name>"` / `--preset <name>`. Presets support first/last only; they do not have their own video preview. Pick by the beat's action and constraints, not rank alone.
+4. **Validate the motion.** Watch the selected base video's preview (`kind: "video"`, the default). Compare its transformation and timing with the intended beat before committing to its code. Keyframes and the base preview do not certify the preset or a customer-brand render.
+5. **Source and adaptation.** Request `get_authored_scene_source` with the exact ID, version and bundle SHA-256, or `editorbrain motion source <id> --scene-version 1.1.0 --out .editorbrain-local/new-scene.tar.gz`. Downloads require login, verify size/hash, preserve existing files and never extract or execute automatically. Start from the closest `adapt/<name>.json` overrides when present; replace demo values and bind the current project below. Edit code where the card says parameters cannot express the needed change; author a new scene when none fits.
 
-The CLI commands require 0.27.0 or later; use advertised MCP tools if the installed CLI is older. Existing `motion list/get/prepare` addresses a different, bounded component catalog.
+The base commands require CLI 0.27.0+. Ranked catalog 1.1.0 and `first|last`/`--preset` require CLI **0.28.0+**, or an MCP server advertising these fields and returning 1.1.0. Check the actual tool schema and returned version; do not send unsupported fields to older servers. CLI 0.27.x and pinned 1.0.0 still use literal search and `video|poster`; use their cards and videos instead of inventing missing keyframes. There are 45 mechanisms in 1.1.0 and 33 in 1.0.0. `motion list/get/prepare` remains a separate component catalog.
+
+All preview/source links expire after five minutes. Keep IDs, versions and hashes instead of temporary URLs. Downloads remain reference evidence; viewing them grants no implicit artistic approval. `inheritedBundleVersion: "1.0.0"` identifies an unchanged historical archive inside catalog 1.1.0: its internal manifest/card retain 1.0.0, while the retrieved 1.1.0 card adds current discovery guidance. Verify the advertised bundle hash; do not rewrite its provenance to match the catalog version.
 
 ## Adapt, then review
 
-Read the downloaded README and selected card. Extract only the reviewed bundle into a new project-local directory. It includes one scene, runtime, fonts/licenses and synthesized SFX; no private customer reel assets or renderer installation. Use the current local engine/tooling to capture `window.renderAt(t)`. Do not run a missing renderer from an unrelated workspace.
+Read the downloaded README and selected card. Extract only the reviewed bundle into a new project-local directory. It includes one scene, runtime, fonts/licenses, synthesized SFX and available adaptation JSONs; no private customer reel assets or renderer installation. Presets are data overrides, not instructions or permissions. Apply their content overrides before the current project's required brand, language and audio bindings. Use the current local engine/tooling to capture `window.renderAt(t)`. Do not run a missing renderer from an unrelated workspace.
+
+Map resolved project tokens explicitly to every color/font role through `window.__overrides.brand` before scripts load, including scene-specific roles listed in its README (not only the generic roles). Register actual font files with the correct weights/styles and rights. Respect exact required tokens and documented scoped exceptions. Set `sound.enabled` from current preferences; false mutes authored and derived cues, music and voice. Replace demo copy, quantities, language and fictional media; branding overrides alone do not personalize those values. Recompose each requested ratio and align beats to actual narration when present. Verify integration access and existing generation authorization before adding media.
 
-Map resolved project tokens explicitly to every color/font role through `window.__overrides.brand` before scripts load. Register actual font files with the correct weights/styles and rights. Respect exact required tokens and documented scoped exceptions. Set `sound.enabled` from current preferences; false mutes authored and derived cues, music and voice. Replace demo copy, quantities, language and fictional media; branding overrides alone do not personalize those values. Recompose each requested ratio and align beats to actual narration when present. Verify integration access and existing generation authorization before adding media.
+Material colors, heatmaps, illustrations and data series can have separate parameters or code-level colors. Inspect these against the project's scoped rules rather than assuming the brand palette recolors every pixel. Preserve authentic material/logo colors where required. A different font can invalidate the scene's layout or collision constraints: adjust typography/composition explicitly and rerender; never silently restore the demo font to make a test pass.
 
 `?demo=1` is for inspecting the original reference only. Production requires complete project binding; missing fonts/assets, invalid theme/ratio and unsupported voice/music time scaling must fail rather than silently use a personal identity. Supplied scenes are opaque, not transparent overlays. Do not reinterpret one scene's fixed item count, timing or font as a universal EditorBrain requirement.
 
-Check source/preview provenance and runtime diagnostics, important states and transitions, then actual motion/audio in the adapted output. Existing previews refer to original source; the guarded portable runtime is separately hashed. Technical validation does not prove creative quality or successful transfer. The 33 general mechanisms exclude all personal `human-computers` reel versions.
+Check source/preview provenance and runtime diagnostics, important states and transitions, then actual motion/audio in the adapted output. Existing previews refer to original source; the guarded portable runtime is separately hashed. Technical validation does not prove creative quality or successful transfer. Both catalogs exclude all personal `human-computers` reel versions.