cueframe 0.4.10 → 0.7.0

package/dist/skills/rebrand-a-video/SKILL.md

@@ -5,6 +5,14 @@ description: Swaps the brand kit under an existing video and re-renders — toke
 
 # Rebrand a video
 
+## Scope and capability policy
+
+User intent and acceptance criteria override this recipe's aesthetic defaults. Silent, typography-only, uncaptioned and slow work are valid; no universal narration, footage, CTA, beat count or score target. Contracts, factual fidelity, media bindings and current source revisions remain mandatory.
+
+Read available tools and current project; preserve the chosen local/hosted lane. Supported local work needs no hosted registration. Do not silently install, authenticate, switch projects or upload local content. Before metered hosted work, check `get_account`, entitlements, balance and quotes. Desktop setup: https://docs.cueframe.ai.
+
+For scoped revisions, preserve unrelated timing, media, audio and shared brand-kit state. Edit affected content; inspect relevant frames, continuous motion and affected audio. No restarted intake, new approval pause, paid judge or final export by default. Judge only when useful; scores never override acceptance failures. Stop/report after two no-improvement passes. See [preview workflow](../cueframe-compose-loop/references/preview-workflow.md).
+
 You bring a finished video and a new brand (a kit, a website, or new colors/fonts/logo); you get
 the same video back wearing the new identity — everything bound to brand tokens re-themes at
 render, and the few graphics that hardcoded the old brand get found and fixed. Change one line,
@@ -23,9 +31,7 @@ Then back to the brand — most of this job is a kit definition and an audit.
   in.
 - **The new brand** (required): an existing kit id, a website to `extract_brand_kit` from
   (colors/fonts only — ask for logo, tagline, voice), or explicit values for `create_brand_kit`.
-- **Same identity or a new one?** Restyling THIS brand → upsert the same kit id and every
-  composition pointing at it re-themes. White-labeling for someone else → a NEW kit, so the
-  original stays intact.
+- **Scope:** a title/color/logo correction edits only affected clip values or bindings. Do not upsert a shared kit for one local correction. A project-wide brand change must be explicit: a same-kit upsert affects every referencing composition. For a new identity, use a new kit when supported. Styling preserves layout; a full redesign requires explicit scope.
 - **Tone shift**: does the new brand change the music mood too? Check the kit's `musicMood`
   intent.
 
@@ -35,7 +41,7 @@ Use `cueframe-compose-loop`'s [preview workflow](../cueframe-compose-loop/refere
 for affected graphics and saved-composition checks. Inspect motion if the kit changes timing;
 keep the final re-render separate from previews used to resolve individual styling corrections.
 
-1. **Pin the new brand as a kit.** `extract_brand_kit` or `create_brand_kit`; show the kit and
+1. **For an explicit project-wide brand change, pin the new brand as a kit.** `extract_brand_kit` or `create_brand_kit`; show the kit and
    get sign-off — it is the contract. Then bind it: upsert in place (same kit id) to restyle,
    or point the project at the new kit for a white-label. The kit lives on the PROJECT, not on
    a composition op.
@@ -56,31 +62,27 @@ keep the final re-render separate from previews used to resolve individual styli
 5. **Fix the holdouts surgically.** `apply_composition` edits per offending clip: rebind card
    fields to `$brand:` tokens (so the NEXT rebrand really is one line), swap the old-wordmark
    media, re-grade footage toward the new palette. A replaced card gets re-shelled with
-   `applyMotionPreset` in a FOLLOWING call. The §3 test governs every card you touch: if the
-   old brand's hex would still look correct in it, the layout was never bespoke — rebuild it,
-   don't tint it.
-6. **Re-decide the audio — required.** A brand swap is a mood swap: check the bed against the
+   `applyMotionPreset` in a FOLLOWING call. If the requested scope is styling, retain its layout; rebuild only for an explicitly requested redesign.
+6. **Review audio only when in scope.** A styling correction preserves existing audio and timing; for a broader brand change: check the bed against the
    new kit's `musicMood`. Wrong mood → `search_resources` a replacement (license recorded),
    same role and ducking, `materializeGrid` re-run if cut timing shifts. Still right → say so
    in the delivery note. If the piece was intentionally silent, confirm that decision still
    fits the new brand and restate it.
-7. **Judge against the NEW brand, render once.** `score_composition` with the new brand facts
-   as `brandContext` — the brand axis is exactly the check this job needs. Fix worst-first to
-   ≥ 7.5, then `create_render` → `wait_job (kind:"render")`.
+7. **Preview the affected styling.** Check the changed color/logo/text and relevant regressions against the requested values. For broader brand review, use `score_composition` only when useful and within budget. Export with `create_render` only for requested final delivery.
 
 ## What good looks like
 
 Quoted from `video-craft-standards` §3 (Brand-identity reel) — the bespoke test applies to every
 card in any class:
 
-> **MUST** Every graphic is bespoke to the brand: its type, its palette as fields, its layout
-> system. **K:** any layout that would look correct with another brand's hex swapped in.
+> **DEFAULT** Every graphic is bespoke to the brand: its type, its palette as fields, its layout
+> system. **Consider:** any layout that would look correct with another brand's hex swapped in.
 
-> **MUST** Footage color and brand palette agree — grade toward the palette or choose footage
+> **DEFAULT** Footage color and brand palette agree — grade toward the palette or choose footage
 > that lives in it.
 
-And cross-cutting: *"**MUST** Brand/text graphics are AUTHORED — `kind:"card"` HTML (your
-typography, layout, palette-as-fields) […] **K:** a brand graphic rendered from a catalog text
+And cross-cutting: *"**DEFAULT** Brand/text graphics are AUTHORED — `kind:"card"` HTML (your
+typography, layout, palette-as-fields) […] **Consider:** a brand graphic rendered from a catalog text
 primitive."*
 
 ## Delivering

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

@@ -1,30 +1,28 @@
 ---
 name: video-craft-standards
-description: The definition of DONE for every video made with CueFrame — per-artifact checklists (social reel, launch film, brand reel, talking-head clip) with kill criteria. Read this BEFORE composing and score your work against it BEFORE rendering. Other skills quote this document; when a skill and this document disagree, this document wins. Triggers on "is this good enough", "quality bar", "what should a finished reel have", "review my video", or any request to make a video when no other skill has stated the bar.
+description: Craft defaults and applicable review checklists for CueFrame videos (social reel, launch film, brand reel, talking-head clip). User intent and requested scope govern their application; factual fidelity and tool contracts remain mandatory. Triggers on "is this good enough", "quality bar", "what should a finished reel have", "review my video", or any request to make a video when no other skill has stated the bar.
 ---
 
 # Video-Craft Standards — what "finished" means
 
-This is the single source of truth for output quality. A video that misses a
-MUST for its artifact class is **not done** — fix it or explicitly record why
-the rule doesn't apply. Kill criteria (**K**) mean: do not render; fix first.
+## Scope and capability policy
 
-## Why this exists
+User intent and acceptance criteria override this recipe's aesthetic defaults. Silent, typography-only, uncaptioned and slow work are valid; no universal narration, footage, CTA, beat count or score target. Contracts, factual fidelity, media bindings and current source revisions remain mandatory.
 
-Every quality dimension nobody measures decays to the laziest default:
-template titles, silent reels, centered white text on footage. Each class
-below is the checklist a good human editor carries implicitly. Score against
-it with stills (`preview_frame`) and the judge (`score_composition`) before
-your one final render.
+Read available tools and current project; preserve the chosen local/hosted lane. Supported local work needs no hosted registration. Do not silently install, authenticate, switch projects or upload local content. Before metered hosted work, check `get_account`, entitlements, balance and quotes. Desktop setup: https://docs.cueframe.ai.
+
+For scoped revisions, preserve unrelated timing, media, audio and shared brand-kit state. Edit affected content; inspect relevant frames, continuous motion and affected audio. No restarted intake, new approval pause, paid judge or final export by default. Judge only when useful; scores never override acceptance failures. Stop/report after two no-improvement passes. See [preview workflow](../cueframe-compose-loop/references/preview-workflow.md).
+
+These are aesthetic defaults for the named formats, not universal delivery gates. Apply only the checklist items relevant to the requested artifact; a silent typography study needs neither footage nor narration, and a title correction needs only affected evidence. User acceptance criteria govern delivery. The labels below describe recommendations; do not reject explicit creative choices using a default or a judge score.
 
 ## The controlling idea — the rule above every rule
 
-- **MUST (K)** Before composing, write the video's CLAIM in one sentence —
+- **DEFAULT** For new work, consider stating the video's CLAIM in one sentence —
   the thing a viewer should be able to repeat afterward ("real bread takes
   48 hours and you can taste every one of them"). Not a vibe, not a tagline:
   a claim with tension (what does this brand/story believe that its category
   doesn't?).
-- **MUST (K)** Every channel is EVIDENCE for the claim, in harmony:
+- **DEFAULT** Each included channel serves the requested intent, in harmony:
   - **Footage** — each clip earns its place as proof of the claim, chosen
     from the claim's shot list, not from search-term aesthetics.
   - **Sound** — the bed's mood and TEMPO embody the claim (a "slow" claim
@@ -34,7 +32,7 @@ your one final render.
     platform convention when the claim demands it.
   - **Type/cards** — copy advances the argument; the tagline lands as the
     CONCLUSION the beats have earned, never as a caption.
-- **Kill tests:** (1) beats reorderable without changing what the video
+- **Review prompts:** (1) beats reorderable without changing what the video
   says; (2) any channel (bed, shot, card) that would fit a different claim
   equally well; (3) a viewer who watched it cannot state the claim.
 
@@ -46,83 +44,78 @@ For scoped corrections and preview selection, use `cueframe-compose-loop`'s
 motion and listen to affected audio, not only stills or judge scores. Keep the user's explicit
 scope and acceptance criteria; approved simulated UI is not evidence of a real product capture.
 
-- **MUST** Brand/text graphics are AUTHORED — `kind:"card"` HTML (your
+- **DEFAULT** Brand/text graphics are AUTHORED — `kind:"card"` HTML (your
   typography, layout, palette-as-fields) shelled with `applyMotionPreset`,
   or a custom component. Catalog text primitives are for utility only.
-  **K:** a brand graphic rendered from a catalog text primitive.
-- **MUST** Audio is decided, never defaulted: a music bed (curated packs via
+  **Consider:** a brand graphic rendered from a catalog text primitive.
+- **DEFAULT** Audio is decided, never defaulted: a music bed (curated packs via
   `import_resource {kind:"music-pack"}`) or ambience/loops (Freesound via
   `search_resources kind:"sfx"`), honoring the brand kit's `musicMood`;
   cut to the beat via `materializeGrid` when the bed drives pacing — OR an
   explicit intentional-silence decision recorded in your delivery note with
-  the reason. **K:** a render whose silence nobody chose.
-- **MUST** Footage carries the video: real footage / real UI / real data
-  ≥60% of runtime for footage-first classes. Text alone is not a video.
-- **MUST** Every stock asset's provenance is recorded (provider, id, author).
-- **MUST** Safe-area respected: no critical copy in the outer ~8% of frame.
-- **MUST** One final render per approval; iterate with previews, not renders.
-- **MUST** Delivery never ends with "done": the last message carries the
+  the reason. **Consider:** a render whose silence nobody chose.
+- **DEFAULT** Footage carries the video: real footage / real UI / real data
+  ≥60% of runtime for footage-first classes. Typography-only work is a valid requested format.
+- **DEFAULT** Every stock asset's provenance is recorded (provider, id, author).
+- **DEFAULT** Safe-area respected: no critical copy in the outer ~8% of frame.
+- **DEFAULT** One final render per approval; iterate with previews, not renders.
+- **DEFAULT** Delivery never ends with "done": the last message carries the
   output link and where to find it, plus the intentional-silence note if any.
 
 ## 1. Social reel — 9:16 · 8–30s
 
-- **MUST (K)** The hook lands inside 2 seconds: the strongest image, motion,
+- **DEFAULT** The hook lands inside 2 seconds: the strongest image, motion,
   or claim opens the piece. No logo-first cold opens, no fade-in-from-black
   preambles.
-- **MUST** Typography is poster-grade: composed plates/fields in the brand
-  palette, considered alignment and scale. **K:** centered white text
+- **DEFAULT** Typography is poster-grade: composed plates/fields in the brand
+  palette, considered alignment and scale. **Consider:** centered white text
   floating on footage.
-- **MUST** Pacing is cut-driven: a new visual beat at least every ~4s; static
+- **DEFAULT** Pacing is cut-driven: a new visual beat at least every ~4s; static
   holds >4s need motion inside the frame (reframe push, kenBurns, animated
   card) or they die.
-- **MUST** Ends on a deliberate beat: tagline, logo, or CTA lockup — not a
+- **DEFAULT** Ends on a deliberate beat: tagline, logo, or CTA lockup — not a
   clip running out.
 - **SHOULD** Cuts land on the music grid when a bed exists.
 
 ## 2. Launch film / feature announcement — 16:9 · 30–90s
 
-- **MUST (K)** Payoff-first hook: the OUTCOME, not the feature name
+- **DEFAULT** Payoff-first hook: the OUTCOME, not the feature name
   ("Close the books two days faster" beats "Introducing the reconciliation
   module"). No throat-clearing ("in this video we're going to…").
-- **MUST** Narration or a bed that builds toward the reveal; pacing tightens
+- **DEFAULT** Narration or a bed that builds toward the reveal; pacing tightens
   as the payoff approaches.
-- **MUST** Real product surface: actual UI/screens/output — never mocked.
-- **MUST** End card with a single CTA.
-- **MUST** Captions present when narrated.
+- **DEFAULT** Real product surface: actual UI/screens/output — never mocked.
+- **DEFAULT** End card with a single CTA.
+- **DEFAULT** Captions present when narrated.
 
 ## 3. Brand-identity reel — 9:16 · 12–20s (the showcase class)
 
 Everything in §1, plus:
-- **MUST** Three-beat arc: opening brand moment (wordmark treatment) →
+- **DEFAULT** Three-beat arc: opening brand moment (wordmark treatment) →
   middle craft/proof beat (the subject's world, with an editorial device —
   numbered chapter, pull-quote, stat) → closing tagline lockup.
-- **MUST** Every graphic is bespoke to the brand: its type, its palette as
-  fields, its layout system. **K:** any layout that would look correct with
+- **DEFAULT** Every graphic is bespoke to the brand: its type, its palette as
+  fields, its layout system. **Consider:** any layout that would look correct with
   another brand's hex swapped in.
-- **MUST** Footage color and brand palette agree — grade toward the palette
+- **DEFAULT** Footage color and brand palette agree — grade toward the palette
   or choose footage that lives in it.
 
 ## 4. Talking-head clip — any aspect · 15–60s
 
-- **MUST (K)** Hook = the strongest sentence, first. Cut TO the moment;
+- **DEFAULT** Hook = the strongest sentence, first. Cut TO the moment;
   never open on wind-up.
-- **MUST** Active-speaker reframe (`focus: active-speaker` / `face`) — a
+- **DEFAULT** Active-speaker reframe (`focus: active-speaker` / `face`) — a
   moving camera, not a static center crop.
-- **MUST** Captions timed to the saved edited timeline (`captions.fromComposition`
+- **DEFAULT** 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
   caption behind the speaker and the legibility gate accepts it.
-- **MUST** Dead air and false starts cut (`addExcludedRange` /
+- **DEFAULT** Dead air and false starts cut (`addExcludedRange` /
   `cutAndRipple`).
 
 ## Scoring discipline
 
-Before the final render: (1) pull stills at each beat boundary and describe
-each one to yourself BEFORE judging it; (2) walk the class checklist and list
-every MUST as pass/fail; (3) any K fails → fix, re-preview; (4) run
-`score_composition` when the budget allows and fix the worst criterion first.
-The checklist is the floor; the judge is the critic; neither substitutes for
-looking at the frames.
+Check the requested criteria against appropriate real evidence: affected stills, continuous motion and audio when relevant. Broader review can use `score_composition` when useful and within budget; it is not mandatory for a scoped correction. The hosted judge includes a fixed caption criterion and can penalize intentionally uncaptioned work; do not add captions solely to improve that score. These skill changes do not change judge behavior. Failed user acceptance criteria remain failures regardless of score. Stop and report remaining gaps after two passes without improvement; export only for requested final delivery.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueframe",
-  "version": "0.4.10",
+  "version": "0.7.0",
   "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": "Apache-2.0",
   "type": "module",
   "bin": {
     "cueframe": "dist/cueframe.js"
@@ -22,7 +22,9 @@
   "main": "dist/cueframe.js",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "NOTICE"
   ],
   "engines": {
     "node": ">=24"
@@ -44,23 +46,21 @@
     "@types/node": "^24.0.0",
     "tsup": "^8.5.1",
     "vitest": "^4.1.2",
-    "@cueframe/composition": "0.1.0",
-    "@cueframe/component-runtime": "0.1.0",
-    "@cueframe/primitives": "0.1.0",
-    "@cueframe/plane": "0.1.0",
-    "@cueframe/sdk": "0.2.2"
+    "@cueframe/sdk": "^0.5.0",
+    "@cueframe/skills": "0.2.0"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cueframe-ai/cueframe.git",
+    "url": "git+https://github.com/cueframe-ai/cueframe-mcp.git",
     "directory": "packages/cli"
   },
   "bugs": {
-    "url": "https://github.com/cueframe-ai/cueframe/issues"
+    "url": "https://github.com/cueframe-ai/cueframe-mcp/issues"
   },
   "scripts": {
-    "build": "node ../../apps/director-agent/scripts/generate-marketplace.mjs && node ../../apps/director-agent/scripts/validate-agent.mjs && tsup && node scripts/copy-agent-skills.mjs",
+    "build": "tsup && node scripts/copy-agent-skills.mjs && node scripts/check-bundle-free-of-kernel.mjs",
     "check": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "check:bundle": "node scripts/check-bundle-free-of-kernel.mjs"
   }
 }

package/dist/analyze-CDC4H53Q.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import{H as a}from"./chunk-QS37SCWN.js";import"./chunk-3QSA3EBY.js";export{a as analyzeCommand};