cueframe 0.4.7 → 0.4.8

package/dist/skills/clip-a-talking-head/SKILL.md

@@ -50,8 +50,11 @@ correction, retain the approved edit and check relevant regressions without auto
    `focus:{mode:"active-speaker"}` as the base, `all-faces` to hold a two-shot, a `face` +
    `shotScale:"close"` punch-in on the emphasis line. A static center crop is the amateur tell;
    the camera should move because the conversation moved.
-6. **Captions from the real transcript.** `captions.fromTranscript` with the mediaId and the
-   clip's window; style via `setCaptionStyle` — plated, high-contrast, never over the mouth or
+6. **Captions from the edited clip.** Save cuts and exclusions first, then call
+   `captions.fromComposition` with the speech track ID in a separate `apply_composition` call.
+   It projects the real transcript through every saved edit; clips must have saved duration matching playable source duration divided by playbackRate. Re-run after later edits. Get the
+   exact input from `describe_composition_ops({type:"captions.fromComposition"})` and style via
+   `setCaptionStyle` — plated, high-contrast, never over the mouth or
    eyes. Where the footage allows, put the emphasized keyword BEHIND the speaker as an overlay
    clip at `zPlane:"behind-subject"` — the focused signature depth move. If the user explicitly
    wants every running caption behind the speaker, set the caption layer's own
@@ -79,7 +82,7 @@ Quoted from `video-craft-standards` §4 (Talking-head clip) — the full checkli
 > **MUST** Active-speaker reframe (`focus: active-speaker` / `face`) — a moving camera, not a
 > static center crop.
 
-> **MUST** Captions timed to the real transcript (`captions.fromTranscript`); behind-speaker
+> **MUST** Captions timed to the edited clip (`captions.fromComposition`); behind-speaker
 > placement where the footage allows it. **MUST** Dead air and false starts cut
 > (`addExcludedRange` / `cutAndRipple`).
 

package/dist/skills/cueframe-cli/SKILL.md

@@ -203,8 +203,9 @@ npx -y cueframe new component my-badge --json
 npx -y cueframe push my-badge --json            # one component
 npx -y cueframe sync --json                      # every component in the workspace
 
-# 5. Reference the component id in your composition (as an alpha-layer clip), then render
-#    with the same verb. Preview a single component first via the MCP preview_component loop.
+# 5. Reference the component id in your composition as a {kind:'component', componentId, props}
+#    clip, then render with the same verb. Preview a single component first via the MCP
+#    preview_component loop.
 npx -y cueframe render <projectId> -o ./out.mp4 --json
 ```
 

package/dist/skills/cueframe-component-authoring/SKILL.md

@@ -42,11 +42,17 @@ Single self-contained module per component (`create_component` takes one `tsxSou
    verified artifact produced by the same bundle contract used by final render. A failed
    `component_does_not_compile` job carries the compiler error — read it, fix via `update_component`
    (same id, in place), and preview again.
+   **Once the component is placed in a project, pass that project on every update:**
+   `update_component({ componentId, body: { tsxSource, projectId, compositionId? } })`. A placed clip
+   renders the exact version it pins; only the composition you name moves to the new version in the
+   same write (`repinned` says what moved). Without `projectId` your clips keep rendering the old
+   version, and `placementsPinnedToPrevious` counts them.
    Set preview duration deliberately: `durationInFrames` is not a trim window and can retime
    duration-dependent motion. Preserve production timing; inspect the live tool's request shape.
-4. **Check integration:** add it as an `alpha-layer` clip (`apply_composition`), then inspect
-   saved-composition stills or a scoped `preview_clip` for placement and motion. Use
-   `create_render` → `wait_job kind:"render"` when delivering a finished MP4, not per tweak.
+4. **Check integration:** add it as a `{kind:'component', componentId, props}` clip
+   (`apply_composition`), then inspect saved-composition stills or a scoped `preview_clip` for
+   placement and motion. Use `create_render` → `wait_job kind:"render"` when delivering a
+   finished MP4, not per tweak.
 
 ## Path B — CLI / coding agent (customer-owned source under git)
 
@@ -72,10 +78,12 @@ MCP path stores. To preview before a full render, push it and use the MCP `previ
 ## Path C — Director editing a local desktop project (project-embedded source)
 
 When `get_context` reports the project lane as local, motion does not require an account or an org
-component. When exposed, use `open_component_preview` to compile an isolated preview,
-`update_component_preview` to replace its source, and `render_component_preview_frame` for exact
-frame evidence. Inspect playback for motion; `commit_component_preview` commits the checked revision
-with a fresh ETag. Close the preview when finished. This loop does not bake a timeline video and
+component. When exposed, use `open_component_preview` to compile an isolated preview (new source,
+or `component_id` for a component already in the desktop's library), `update_component_preview`
+with exact-text edits (`{oldText, newText, replaceAll?}`, each `oldText` matching once), and
+`render_component_preview_frame` for exact frame evidence. Inspect playback for motion;
+`commit_component_preview` publishes the checked source to the library and pins the clip, with a
+fresh ETag. `read_component` and `edit_component` read and edit the library directly. Close the preview when finished. This loop does not bake a timeline video and
 does not imply HMR: source updates still compile.
 
 If those tools are unavailable, add/update through `apply_composition` and inspect the local
@@ -103,7 +111,9 @@ timeline. An inline custom overlay has this shape:
 }
 ```
 
-The desktop compiles the module in an isolated child process and persists its immutable source version.
+The desktop compiles the module in an isolated child process and creates it in the desktop's component
+library. Inline source creates a component only: a clip whose component already exists with other
+source is refused as `component_exists`, and that component changes through edits.
 The timeline and final export render that exact version; no preview media is baked. A compile failure
 refuses the whole batch and leaves the composition untouched. Use `create_component` only for a reusable
 org-catalog component on a reachable cloud lane.
@@ -165,3 +175,5 @@ const R = params.region ?? { x: 0, y: 0, w: 1, h: 1 };
 - Don't hand-roll a graphic from zero when a built-in is close — fork it (fetch the source with
   `get_component_source`, paste it into a `npx -y cueframe new component` scaffold) and edit.
 - Don't `create_component` a fresh id each fix iteration — `update_component` (same id) is the loop.
+- Don't update a placed component without its `projectId` in the body — the placed clips keep the
+  version they pin, so the next preview or render shows the old graphic.

package/dist/skills/cueframe-compose-loop/references/preview-workflow.md

@@ -9,7 +9,7 @@ Read the current tool contracts and project context. Do not infer a hosted sessi
 | Need | Hosted evidence | Local desktop evidence, when exposed |
 |---|---|---|
 | Isolated HTML card layout | `preview_card` with the card's HTML and tokens | Inspect the card in the local project |
-| Authored component layout or motion | `preview_component`, with explicit dimensions, FPS, params, assets, and appropriate duration | `open_component_preview` → `update_component_preview`; inspect playback and `render_component_preview_frame` at exact frames |
+| Authored component layout or motion | `preview_component`, with explicit dimensions, FPS, params, assets, and appropriate duration | `open_component_preview` → `update_component_preview` (exact-text edits); inspect playback and `render_component_preview_frame` at exact frames |
 | Saved composition layout and overlap | `preview_frame`, batching the needed timestamps | The local composition preview/capture tools |
 | Cuts, entrances, camera motion, or audio timing | `preview_clip` for the affected `[fromSec, toSec)` window, including its lead-in and settle | Play/seek the affected window; capture matching frames when needed |
 | Finished deliverable | `create_render` and verify the resulting file | The project's export path and verification of its resulting file |

package/dist/skills/launch-video/SKILL.md

@@ -56,9 +56,11 @@ affected window and regressions without automatically rerunning the full-film ju
    narrated: the VO is the rhythm authority instead — cut to the voice and duck the bed under
    it. Silence is almost never right for a launch; if chosen anyway, record the decision and
    reason in the delivery note.
-7. **Caption narration.** If there is a voice, `captions.fromTranscript` (or authored word
-   timings for generated VO), styled legible via `setCaptionStyle`. Captions are mandatory when
-   narrated.
+7. **Caption narration.** For transcribed voice, save the edits first, then call
+   `captions.fromComposition` with the narration track ID in a separate `apply_composition`
+   call. Speech clips must have saved duration matching playable source duration divided by
+   playbackRate. Re-run after later edits. Use authored word timings for generated VO without a
+   transcript, and style legibly via `setCaptionStyle`. Captions are mandatory when narrated.
 8. **Preview, judge, one render.** `preview_frame` at t=0, hook-end, the reveal, and the end
    card; describe each still — is that a REAL capture on screen? Then `score_composition` with
    the payoff line as `editorialIntent`; fix worst-first to ≥ 7.5; `create_render` →

package/dist/skills/make-a-social-reel/SKILL.md

@@ -61,7 +61,12 @@ affected window and regressions without automatically rerunning the full-film ju
    `{ grid:"beat" }` and land your cut points and transition midpoints on the markers. If the
    piece is genuinely better silent, that is a decision — record it and its reason in the
    delivery note. A reel whose silence nobody chose is not done.
-7. **Caption any speech.** `captions.fromTranscript` with the mediaId, styled via
+7. **Caption any speech.** After saving the edited clips, use
+   `captions.fromComposition` with the speech track ID in a separate `apply_composition`
+   call. It follows trims, excluded ranges and clip placement across the reel. Speech clips
+   must have saved duration matching playable source duration divided by playbackRate.
+   Re-run it after later edits. Discover its exact input with
+   `describe_composition_ops({type:"captions.fromComposition"})`, then style via
    `setCaptionStyle` (plated, bottom, out of the mouth/eyes). Most social viewing is sound-off;
    don't karaoke a beat with no speech.
 8. **Look, then get judged.** `preview_frame` at t=0, hook-end, and every beat boundary;

package/dist/skills/video-craft-standards/SKILL.md

@@ -108,7 +108,9 @@ Everything in §1, plus:
   never open on wind-up.
 - **MUST** Active-speaker reframe (`focus: active-speaker` / `face`) — a
   moving camera, not a static center crop.
-- **MUST** Captions timed to the real transcript (`captions.fromTranscript`).
+- **MUST** Captions timed to the saved edited timeline (`captions.fromComposition`
+  after the clip edits; re-run after later edits). Speech clips must have saved duration matching playable source duration divided by
+  playbackRate.
   The focused behind-the-speaker LOOK is an overlay text layer at
   `zPlane:"behind-subject"` where the footage allows. Use caption-layer
   `zPlane:"behind-subject"` only when the user explicitly wants every running

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueframe",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "Agent-native CLI for CueFrame — author compositions and render video from the terminal (early-access preview).",
   "keywords": [
     "cueframe",
@@ -14,7 +14,7 @@
   ],
   "homepage": "https://docs.cueframe.ai",
   "author": "CueFrame, Inc.",
-  "license": "AGPL-3.0-only",
+  "license": "FSL-1.1-ALv2",
   "type": "module",
   "bin": {
     "cueframe": "dist/cueframe.js"
@@ -45,8 +45,8 @@
     "tsup": "^8.5.1",
     "vitest": "^4.1.2",
     "@cueframe/component-runtime": "0.1.0",
-    "@cueframe/sdk": "0.1.5",
     "@cueframe/plane": "0.1.0",
+    "@cueframe/sdk": "0.2.1",
     "@cueframe/primitives": "0.1.0",
     "@cueframe/composition": "0.1.0"
   },

package/dist/analyze-J3YAYGD4.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import{Y as a}from"./chunk-WFQZXC67.js";import"./chunk-MCQRX24V.js";export{a as analyzeCommand};