@vibeframe/cli 0.76.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,7 +57372,7 @@ 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 `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.",
@@ -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.`
           ]
         };
       }
@@ -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.76.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);
@@ -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.76.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/core": "0.76.0",
-    "@vibeframe/ai-providers": "0.76.0"
+    "@vibeframe/ai-providers": "0.77.0",
+    "@vibeframe/core": "0.77.0"
   },
   "engines": {
     "node": ">=20"