@vibeframe/cli 0.75.0 → 0.77.0

package/dist/index.js

@@ -18722,8 +18722,8 @@ var init_elevenlabs = __esm({
         "generate speech",
         "generate sound-effect",
         "generate music",
-        "audio voices",
-        "audio voice-clone",
+        "audio list-voices",
+        "audio clone-voice",
         "audio dub"
       ]
     });
@@ -25999,7 +25999,7 @@ function buildEmptyRootHtml(opts) {
 }
 function buildDesignMd(opts) {
   const { name, style } = opts;
-  const intro = style ? `Visual identity for **${name}**, scaffolded from the **${style.name}** style (after ${style.designer}). Customise freely \u2014 this file is the single source of truth for every scene's palette, typography, and motion.` : `Visual identity for **${name}**. Fill the sections below before authoring any scene HTML or generating any backdrop. Pick a named style with \`vibe scene styles\` if you want a credible starting point.`;
+  const intro = style ? `Visual identity for **${name}**, scaffolded from the **${style.name}** style (after ${style.designer}). Customise freely \u2014 this file is the single source of truth for every scene's palette, typography, and motion.` : `Visual identity for **${name}**. Fill the sections below before authoring any scene HTML or generating any backdrop. Pick a named style with \`vibe scene list-styles\` if you want a credible starting point.`;
   const moodLine = style ? `**Mood:** ${style.mood} \xB7 **Best for:** ${style.bestFor}` : `**Mood:** _(one line \u2014 what should the viewer FEEL?)_`;
   const palette = style ? `${style.palette.map((c) => `- \`${c}\``).join("\n")}
 
@@ -26057,7 +26057,7 @@ ${avoid}
 
 ---
 
-_Browse other named styles: \`vibe scene styles\`_
+_Browse other named styles: \`vibe scene list-styles\`_
 ${style ? `_This file was seeded by \`vibe scene init --visual-style "${style.name}"\`._` : `_Seed this file from a named style: \`vibe scene init <dir> --visual-style "<name>"\`._`}
 `;
 }
@@ -26123,7 +26123,7 @@ typography, motion, and transition rules. Both the agent-driven path and
 the fallback emit reference it; scenes that contradict DESIGN.md are
 rejected by the Hyperframes \`hyperframes\` skill.
 
-Browse named styles: \`vibe scene styles\`. Re-seed from one with
+Browse named styles: \`vibe scene list-styles\`. Re-seed from one with
 \`vibe scene init . --visual-style "Swiss Pulse"\` (idempotent).
 
 ## Skills \u2014 USE THESE FIRST
@@ -29405,7 +29405,7 @@ Examples:
   $ vibe scene lint                                       # Validate every scene against composition rules
   $ vibe scene lint --fix                                 # Auto-fix mechanical issues (e.g. missing class="clip")
   $ vibe scene lint --json                                # Structured output for agent loops
-  $ vibe scene styles                                     # Browse seed visual styles for DESIGN.md
+  $ vibe scene list-styles                                     # Browse seed visual styles for DESIGN.md
 
 For the project flow (init / build / render), use the top-level commands.
 The \`scene init\`, \`scene build\`, and \`scene render\` legacy aliases
@@ -29520,13 +29520,13 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       console.log();
       console.log(source_default.dim("Re-run with --json to get the full per-beat userPrompt + cues for direct consumption."));
     });
-    sceneCommand.command("styles").description("List vendored visual styles (or show one) for DESIGN.md seeding").argument("[name]", "Style name to inspect (omit to list all)").action((name) => {
+    sceneCommand.command("list-styles").description("List vendored visual styles (or show one) for DESIGN.md seeding").argument("[name]", "Style name to inspect (omit to list all)").action((name) => {
       const startedAt = Date.now();
       if (!name) {
         const all = listVisualStyles();
         if (isJsonMode()) {
           outputSuccess({
-            command: "scene styles",
+            command: "scene list-styles",
             startedAt,
             data: {
               count: all.length,
@@ -29550,7 +29550,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
           );
         }
         console.log();
-        console.log(source_default.dim("Show details: "), source_default.cyan('vibe scene styles "<name>"'));
+        console.log(source_default.dim("Show details: "), source_default.cyan('vibe scene list-styles "<name>"'));
         console.log(source_default.dim("Seed DESIGN.md:"), source_default.cyan('vibe scene init <dir> --visual-style "<name>"'));
         return;
       }
@@ -29566,7 +29566,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       }
       if (isJsonMode()) {
         outputSuccess({
-          command: "scene styles",
+          command: "scene list-styles",
           startedAt,
           data: { style }
         });
@@ -38839,7 +38839,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(generalError(`Frame interpolation failed: ${msg}`));
       }
     });
-    editCommand.command("upscale-video").description("Upscale video resolution using AI or FFmpeg").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("-s, --scale <factor>", "Scale factor: 2 or 4", "2").option("-m, --model <model>", "Model: real-esrgan, topaz", "real-esrgan").option("--ffmpeg", "Use FFmpeg lanczos (free, no API)").option("-k, --api-key <key>", "Replicate API token (or set REPLICATE_API_TOKEN env)").option("--no-wait", "Start processing and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    editCommand.command("upscale").description("Upscale video resolution using AI or FFmpeg").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("-s, --scale <factor>", "Scale factor: 2 or 4", "2").option("-m, --model <model>", "Model: real-esrgan, topaz", "real-esrgan").option("--ffmpeg", "Use FFmpeg lanczos (free, no API)").option("-k, --api-key <key>", "Replicate API token (or set REPLICATE_API_TOKEN env)").option("--no-wait", "Start processing and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
       try {
         if (options.output) {
@@ -38852,7 +38852,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         }
         if (options.dryRun) {
           outputSuccess({
-            command: "edit upscale-video",
+            command: "edit upscale",
             startedAt,
             dryRun: true,
             data: {
@@ -38888,7 +38888,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
             spinner3.succeed(source_default.green(`Upscaled to ${newWidth}x${newHeight}`));
             if (isJsonMode()) {
               outputSuccess({
-                command: "edit upscale-video",
+                command: "edit upscale",
                 startedAt,
                 data: {
                   dimensions: `${newWidth}x${newHeight}`,
@@ -57372,10 +57372,10 @@ var init_scene2 = __esm({
       )
     });
     sceneStylesTool = defineTool({
-      name: "scene_styles",
+      name: "scene_list_styles",
       category: "scene",
       cost: "free",
-      description: "List the 8 vendored visual identities available for `scene_init --visual-style` (Swiss Pulse, Data Drift, \u2026) or, when `name` is provided, return the full DESIGN.md hard-gate body for one style. The DESIGN.md content is what the LLM uses as a non-negotiable visual rulebook during compose-scenes-with-skills.",
+      description: "List the 8 vendored visual identities available for `init --visual-style` (Swiss Pulse, Data Drift, \u2026) or, when `name` is provided, return the full DESIGN.md hard-gate body for one style. The DESIGN.md content is what the LLM uses as a non-negotiable visual rulebook during compose-scenes-with-skills.",
       schema: sceneStylesSchema,
       async execute(args) {
         if (args.name) {
@@ -57383,7 +57383,7 @@ var init_scene2 = __esm({
           if (!style) {
             return {
               success: false,
-              error: `Unknown visual style "${args.name}". Run scene_styles with no name to list all 8.`
+              error: `Unknown visual style "${args.name}". Run scene_list_styles with no name to list all 8.`
             };
           }
           return {
@@ -57423,7 +57423,7 @@ var init_scene2 = __esm({
               (s) => `   \u2022 ${s.name} (${s.slug}) \u2014 ${s.mood}; best for ${s.bestFor}`
             ),
             ``,
-            `Run scene_styles { name: "<slug>" } to fetch the full DESIGN.md hard-gate body for one style.`
+            `Run scene_list_styles { name: "<slug>" } to fetch the full DESIGN.md hard-gate body for one style.`
           ]
         };
       }
@@ -57435,7 +57435,7 @@ var init_scene2 = __esm({
       duration: external_exports.number().optional().describe("Default root composition duration in seconds. Default 10.")
     });
     sceneInitTool = defineTool({
-      name: "scene_init",
+      name: "init",
       category: "scene",
       cost: "free",
       description: "Scaffold a new VibeFrame video scene project. Supports minimal, agent, and full profiles; full includes the current HTML render backend metadata. Idempotent: re-running keeps user-authored files and merges backend config instead of overwriting. No API keys required.",
@@ -57581,7 +57581,7 @@ var init_scene2 = __esm({
       workers: external_exports.number().optional().describe("Capture worker count (1-16). Default 1.")
     });
     sceneRenderTool = defineTool({
-      name: "scene_render",
+      name: "render",
       category: "scene",
       cost: "free",
       description: "Render a scene project to MP4/WebM/MOV via the Hyperframes producer. Requires Chrome installed locally. Output defaults to renders/<projectName>-<isoStamp>.<format>.",
@@ -57598,7 +57598,7 @@ var init_scene2 = __esm({
           workers: args.workers
         });
         if (!result.success) {
-          return { success: false, error: result.error ?? "scene_render failed" };
+          return { success: false, error: result.error ?? "render failed" };
         }
         return {
           success: true,
@@ -57636,10 +57636,10 @@ var init_scene2 = __esm({
       force: external_exports.boolean().optional().describe("Re-dispatch primitives even when cached assets exist.")
     });
     sceneBuildTool = defineTool({
-      name: "scene_build",
+      name: "build",
       category: "scene",
       cost: "high",
-      description: "v0.60 one-shot orchestrator: read STORYBOARD.md per-beat YAML cues (narration / backdrop / duration), dispatch TTS + image generation per beat, compose scene HTML via the compose-scenes-with-skills pipeline, then render to MP4. Use this instead of chaining scene_init + scene_add + scene_render manually. Caches by SHA256 of (DESIGN.md + cue body) so re-runs are idempotent and cheap.",
+      description: "v0.60 one-shot orchestrator: read STORYBOARD.md per-beat YAML cues (narration / backdrop / duration), dispatch TTS + image generation per beat, compose scene HTML via the compose-scenes-with-skills pipeline, then render to MP4. Use this instead of chaining init + scene_add + render manually. Caches by SHA256 of (DESIGN.md + cue body) so re-runs are idempotent and cheap.",
       schema: sceneBuildSchema,
       async execute(args, ctx) {
         const projectDir = args.projectDir ? resolve55(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
@@ -57659,7 +57659,7 @@ var init_scene2 = __esm({
           force: args.force
         });
         if (!result.success) {
-          return { success: false, error: result.error ?? "scene_build failed" };
+          return { success: false, error: result.error ?? "build failed" };
         }
         return {
           success: true,
@@ -57742,7 +57742,7 @@ var init_scene2 = __esm({
       name: "scene_compose_prompts",
       category: "scene",
       cost: "free",
-      description: "Emit the per-beat compose plan for the host agent to author scene HTML itself. Reads STORYBOARD.md + DESIGN.md and returns each beat's outputPath + userPrompt + cues + body, plus references to the project's SKILL.md (Hyperframes rules) and DESIGN.md (visual identity). The host agent writes each compositions/scene-<id>.html file directly \u2014 VibeFrame makes NO LLM call here. Pairs with scene_install_skill (Phase H1). Phase H2 of the agentic-native composer plan; the internal-LLM batch path (scene_build) remains as a fallback for non-agent contexts.",
+      description: "Emit the per-beat compose plan for the host agent to author scene HTML itself. Reads STORYBOARD.md + DESIGN.md and returns each beat's outputPath + userPrompt + cues + body, plus references to the project's SKILL.md (Hyperframes rules) and DESIGN.md (visual identity). The host agent writes each compositions/scene-<id>.html file directly \u2014 VibeFrame makes NO LLM call here. Pairs with scene_install_skill (Phase H1). Phase H2 of the agentic-native composer plan; the internal-LLM batch path (build) remains as a fallback for non-agent contexts.",
       schema: sceneComposePromptsSchema,
       async execute(args, ctx) {
         const projectDir = resolve55(ctx.workingDirectory, args.projectDir);
@@ -57842,7 +57842,7 @@ var init_audio2 = __esm({
       }
     });
     audioVoiceCloneTool = defineTool({
-      name: "audio_voice_clone",
+      name: "audio_clone_voice",
       category: "audio",
       cost: "low",
       description: "Clone a voice from audio samples using ElevenLabs. Requires ELEVENLABS_API_KEY.",
@@ -58388,7 +58388,7 @@ var init_analyze = __esm({
     init_ai_review();
     init_ai_suggest_edit();
     analyzeMediaTool = defineTool({
-      name: "analyze_media",
+      name: "inspect_media",
       category: "analyze",
       cost: "low",
       description: "Analyze media (image, video, or YouTube URL) using Gemini AI. Requires GOOGLE_API_KEY.",
@@ -58416,7 +58416,7 @@ var init_analyze = __esm({
       }
     });
     analyzeVideoTool = defineTool({
-      name: "analyze_video",
+      name: "inspect_video",
       category: "analyze",
       cost: "low",
       description: "Analyze video content using Gemini AI with temporal understanding. Requires GOOGLE_API_KEY.",
@@ -58444,7 +58444,7 @@ var init_analyze = __esm({
       }
     });
     analyzeReviewTool = defineTool({
-      name: "analyze_review",
+      name: "inspect_review",
       category: "analyze",
       cost: "low",
       description: "AI video review: analyzes quality, suggests fixes, and optionally auto-applies them. Requires GOOGLE_API_KEY.",
@@ -58472,7 +58472,7 @@ var init_analyze = __esm({
       }
     });
     analyzeSuggestTool = defineTool({
-      name: "analyze_suggest",
+      name: "inspect_suggest",
       category: "analyze",
       cost: "low",
       description: "Get natural-language edit suggestions for a project from Gemini. Returns suggestions array with type/confidence/clipIds. With `apply: true`, applies the first suggestion in place. Requires GOOGLE_API_KEY.",
@@ -58853,7 +58853,7 @@ var init_pipeline2 = __esm({
     init_ai_highlights();
     init_pipeline();
     pipelineHighlightsTool = defineTool({
-      name: "pipeline_highlights",
+      name: "remix_highlights",
       category: "pipeline",
       cost: "low",
       description: "Extract highlight clips from a longer video using AI analysis. Requires OPENAI_API_KEY+ANTHROPIC_API_KEY or GOOGLE_API_KEY (with --use-gemini).",
@@ -58886,10 +58886,10 @@ var init_pipeline2 = __esm({
       }
     });
     pipelineAutoShortsTool = defineTool({
-      name: "pipeline_auto_shorts",
+      name: "remix_auto_shorts",
       category: "pipeline",
       cost: "medium",
-      description: "Automatically generate short-form content (Reels/TikTok/Shorts) from a longer video. Same API key requirements as pipeline_highlights.",
+      description: "Automatically generate short-form content (Reels/TikTok/Shorts) from a longer video. Same API key requirements as remix_highlights.",
       schema: external_exports.object({
         video: external_exports.string().describe("Path to the input video file"),
         outputDir: external_exports.string().optional().describe("Output directory for shorts"),
@@ -58923,7 +58923,7 @@ var init_pipeline2 = __esm({
       }
     });
     pipelineRunTool = defineTool({
-      name: "pipeline_run",
+      name: "run",
       category: "pipeline",
       cost: "very-high",
       surfaces: ["mcp"],
@@ -59002,7 +59002,7 @@ var init_pipeline2 = __esm({
       }
     });
     pipelineRegenerateSceneTool = defineTool({
-      name: "pipeline_regenerate_scene",
+      name: "remix_regenerate_scene",
       category: "pipeline",
       cost: "high",
       description: "Regenerate specific scenes against an existing storyboard.{yaml,json} on disk. Can regenerate video, image, or narration independently.",
@@ -61650,7 +61650,7 @@ Safe to invoke on user-provided projects.
 
 \`\`\`bash
 vibe scene init <dir> [-r 16:9|9:16|1:1|4:5] [-d <sec>] [--visual-style "<name>"]
-vibe scene styles [<name>]                   # list / show vendored visual identities
+vibe scene list-styles [<name>]                   # list / show vendored visual identities
 vibe scene install-skill [<dir>] [--host all]  # retroactive composition-rules install
 vibe scene add <name> --style <preset> [...]
 vibe scene compose-prompts [<dir>] [--beat <id>]   # H2: emit plan, no LLM call
@@ -61838,7 +61838,7 @@ overlay, etc.) \u2014 useful at the tail of a pipeline.
         ],
         relatedCommands: [
           "vibe init",
-          "vibe scene styles",
+          "vibe scene list-styles",
           "vibe scene install-skill",
           "vibe scene compose-prompts",
           "vibe build",
@@ -62167,7 +62167,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.75.0",
+  version: "0.77.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -62584,12 +62584,12 @@ var timelineCommand = new Command("timeline").description("Timeline editing comm
 Examples:
   $ vibe timeline add-source project.vibe.json video.mp4         # Returns source ID
   $ vibe timeline add-clip project.vibe.json <source-id>         # Add clip from source
-  $ vibe timeline trim project.vibe.json <clip-id> --start 5 --end 30
-  $ vibe timeline split project.vibe.json <clip-id> --time 10
+  $ vibe timeline trim-clip project.vibe.json <clip-id> --start 5 --end 30
+  $ vibe timeline split-clip project.vibe.json <clip-id> --time 10
   $ vibe timeline list project.vibe.json --json
-  $ vibe timeline delete project.vibe.json <clip-id>
+  $ vibe timeline delete-clip project.vibe.json <clip-id>
 
-Typical workflow: create project \u2192 add-source \u2192 add-clip \u2192 trim/split \u2192 export
+Typical workflow: create project \u2192 add-source \u2192 add-clip \u2192 trim-clip/split-clip \u2192 export
 Cost: Free (no API keys needed).
 Run 'vibe schema timeline.<command>' for structured parameter info.`);
 timelineCommand.command("add-source").description("Add a media source to the project").argument("<project>", "Project file path").argument("<media>", "Media file path").option("-n, --name <name>", "Source name (defaults to filename)").option("-t, --type <type>", "Media type (video, audio, image, lottie)").option("-d, --duration <seconds>", "Duration in seconds (required for images)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, mediaPath, options) => {
@@ -62865,14 +62865,14 @@ timelineCommand.command("add-effect").description("Add an effect to a clip").arg
     exitWithError(generalError(`Failed to add effect: ${msg}`));
   }
 });
-timelineCommand.command("trim").description("Trim a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID").option("--start <seconds>", "New start time").option("--duration <seconds>", "New duration").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("trim-clip").description("Trim a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID").option("--start <seconds>", "New start time").option("--duration <seconds>", "New duration").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Trimming clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
       outputSuccess({
-        command: "timeline trim",
+        command: "timeline trim-clip",
         startedAt,
         dryRun: true,
         data: {
@@ -62906,7 +62906,7 @@ timelineCommand.command("trim").description("Trim a clip").argument("<project>",
     spinner2.succeed(source_default.green("Clip trimmed"));
     if (isJsonMode()) {
       outputSuccess({
-        command: "timeline trim",
+        command: "timeline trim-clip",
         startedAt,
         data: {
           id: updatedClip.id,
@@ -63027,14 +63027,14 @@ timelineCommand.command("list").description("List timeline contents").argument("
     exitWithError(generalError(`Failed to list timeline: ${msg}`));
   }
 });
-timelineCommand.command("split").description("Split a clip at a specific time").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to split").option("-t, --time <seconds>", "Split time relative to clip start", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("split-clip").description("Split a clip at a specific time").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to split").option("-t, --time <seconds>", "Split time relative to clip start", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Splitting clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
       outputSuccess({
-        command: "timeline split",
+        command: "timeline split-clip",
         startedAt,
         dryRun: true,
         data: {
@@ -63071,7 +63071,7 @@ timelineCommand.command("split").description("Split a clip at a specific time").
     spinner2.succeed(source_default.green("Clip split successfully"));
     if (isJsonMode()) {
       outputSuccess({
-        command: "timeline split",
+        command: "timeline split-clip",
         startedAt,
         data: {
           first: { id: first.id, duration: first.duration },
@@ -63089,14 +63089,14 @@ timelineCommand.command("split").description("Split a clip at a specific time").
     exitWithError(generalError(`Failed to split clip: ${msg}`));
   }
 });
-timelineCommand.command("duplicate").description("Duplicate a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to duplicate").option("-t, --time <seconds>", "Start time for duplicate (default: after original)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("duplicate-clip").description("Duplicate a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to duplicate").option("-t, --time <seconds>", "Start time for duplicate (default: after original)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Duplicating clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
       outputSuccess({
-        command: "timeline duplicate",
+        command: "timeline duplicate-clip",
         startedAt,
         dryRun: true,
         data: {
@@ -63128,7 +63128,7 @@ timelineCommand.command("duplicate").description("Duplicate a clip").argument("<
     spinner2.succeed(source_default.green(`Clip duplicated: ${duplicated.id}`));
     if (isJsonMode()) {
       outputSuccess({
-        command: "timeline duplicate",
+        command: "timeline duplicate-clip",
         startedAt,
         data: {
           id: duplicated.id,
@@ -63148,14 +63148,14 @@ timelineCommand.command("duplicate").description("Duplicate a clip").argument("<
     exitWithError(generalError(`Failed to duplicate clip: ${msg}`));
   }
 });
-timelineCommand.command("delete").description("Delete a clip from the timeline").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to delete").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("delete-clip").description("Delete a clip from the timeline").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to delete").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Deleting clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
       outputSuccess({
-        command: "timeline delete",
+        command: "timeline delete-clip",
         startedAt,
         dryRun: true,
         data: {
@@ -63185,7 +63185,7 @@ timelineCommand.command("delete").description("Delete a clip from the timeline")
     spinner2.succeed(source_default.green("Clip deleted"));
     if (isJsonMode()) {
       outputSuccess({
-        command: "timeline delete",
+        command: "timeline delete-clip",
         startedAt,
         data: {
           id: clipId,
@@ -63200,7 +63200,7 @@ timelineCommand.command("delete").description("Delete a clip from the timeline")
     exitWithError(generalError(`Failed to delete clip: ${msg}`));
   }
 });
-timelineCommand.command("move").description("Move a clip to a new position").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to move").option("-t, --time <seconds>", "New start time").option("--track <track-id>", "Move to different track").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("move-clip").description("Move a clip to a new position").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to move").option("-t, --time <seconds>", "New start time").option("--track <track-id>", "Move to different track").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Moving clip...").start();
   try {
@@ -63208,7 +63208,7 @@ timelineCommand.command("move").description("Move a clip to a new position").arg
     if (options.track) validateResourceId(options.track);
     if (options.dryRun) {
       outputSuccess({
-        command: "timeline move",
+        command: "timeline move-clip",
         startedAt,
         dryRun: true,
         data: {
@@ -63243,7 +63243,7 @@ timelineCommand.command("move").description("Move a clip to a new position").arg
     spinner2.succeed(source_default.green("Clip moved"));
     if (isJsonMode()) {
       outputSuccess({
-        command: "timeline move",
+        command: "timeline move-clip",
         startedAt,
         data: {
           id: updated.id,
@@ -64189,7 +64189,7 @@ init_ai_highlights();
 init_ai_animated_caption();
 init_output();
 var pipelineCommand = new Command("remix").description(
-  "AI media transformations on existing video / audio (highlights, auto-shorts, animated captions). For BUILD-from-text flows see `vibe build`."
+  "Transform existing media (highlights, auto-shorts, animated captions, regenerate-scene)"
 ).addHelpText(
   "after",
   `
@@ -69745,7 +69745,7 @@ async function runSceneInit(projectDirArg, options, startedAt) {
   }
   const visualStyle = options.visualStyle ? getVisualStyle(String(options.visualStyle)) : void 0;
   if (options.visualStyle && !visualStyle) {
-    exitWithError(usageError(`Unknown visual style: ${String(options.visualStyle)}`, `Valid: ${visualStyleNames()}. Browse with \`vibe scene styles\`.`));
+    exitWithError(usageError(`Unknown visual style: ${String(options.visualStyle)}`, `Valid: ${visualStyleNames()}. Browse with \`vibe scene list-styles\`.`));
   }
   const projectDir = resolve42(projectDirArg);
   const projectName = basename14(projectDir);
@@ -71169,7 +71169,7 @@ You have access to tools for:
 - For generate_image: Ask what kind of image (subject, style, mood) if not specified
 - For generate_video: Ask about the video prompt/motion if not specified
 - For generate_speech: Ask what text to convert if not provided
-- For scene_build (text \u2192 MP4): Ask for the storyboard / script content
+- For build (text \u2192 MP4): Ask for the storyboard / script content
 - Example: "generate an image" \u2192 Ask "What kind of image would you like? (e.g., space landscape, cute robot, product photo)"
 - DON'T make up random content - the user knows what they want
 
@@ -71212,7 +71212,7 @@ When working with script-to-video / scene-build output directories:
 - **narration-N.mp3**: Generated narration audio for each scene
 
 USE fs_read to examine these files when the user asks about scenes or wants to regenerate content. For example:
-- "regenerate scene 3" \u2192 First fs_read storyboard.json, tell user what scene 3 contains, then use pipeline_regenerate_scene
+- "regenerate scene 3" \u2192 First fs_read storyboard.json, tell user what scene 3 contains, then use remix_regenerate_scene
 - "what's in scene 2?" \u2192 fs_read storyboard.json and explain scene 2 details
 
 ### Error Recovery
@@ -71923,10 +71923,13 @@ program2.name("vibe").showSuggestionAfterError(true).description("VibeFrame CLI
   "after",
   `
 Global flags (work with any command):
+  -V, --version  Print version and exit
+  -h, --help     Print help for the command and exit
   --json         Output JSON (auto-enabled when piped)
   --fields       Limit output fields (e.g., --fields "path,duration")
-  --quiet        Output only the result value (path, URL, or ID)
+  -q, --quiet    Output only the result value (path, URL, or ID)
   --stdin        Read options from stdin as JSON (for agent/script use)
+  --describe     Print the command's JSON schema and exit (no execution)
   --dry-run      Preview without executing (most commands)
 
 Get started (90% of users start here):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.75.0",
+  "version": "0.77.0",
   "description": "VibeFrame CLI - natural language video editing from the terminal",
   "private": false,
   "license": "MIT",
@@ -182,8 +182,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/ai-providers": "0.75.0",
-    "@vibeframe/core": "0.75.0"
+    "@vibeframe/ai-providers": "0.77.0",
+    "@vibeframe/core": "0.77.0"
   },
   "engines": {
     "node": ">=20"