@vibeframe/cli 0.73.0 → 0.74.0

package/dist/index.js

@@ -6546,8 +6546,10 @@ var output_exports = {};
 __export(output_exports, {
   COST_ESTIMATES: () => COST_ESTIMATES,
   ExitCode: () => ExitCode,
+  _resetDeprecationMemoryForTesting: () => _resetDeprecationMemoryForTesting,
   apiError: () => apiError,
   authError: () => authError,
+  emitDeprecationWarning: () => emitDeprecationWarning,
   exitWithError: () => exitWithError,
   generalError: () => generalError,
   isJsonMode: () => isJsonMode,
@@ -6692,6 +6694,19 @@ function suggestNext(tip) {
   Tip: ${tip}`));
   }
 }
+function emitDeprecationWarning(oldName, newName, removeIn) {
+  if (isJsonMode() || isQuietMode()) return;
+  if (!process.stderr.isTTY) return;
+  const key = `${oldName}\u2192${newName}`;
+  if (_seenDeprecations.has(key)) return;
+  _seenDeprecations.add(key);
+  process.stderr.write(
+    source_default.yellow(`[deprecated] '${oldName}' is deprecated; use '${newName}' instead. Alias will be removed in ${removeIn}.`) + "\n"
+  );
+}
+function _resetDeprecationMemoryForTesting() {
+  _seenDeprecations.clear();
+}
 function outputError(error, details) {
   if (isJsonMode()) {
     console.error(JSON.stringify({ success: false, error, ...details }, null, 2));
@@ -6699,7 +6714,7 @@ function outputError(error, details) {
     console.error(error);
   }
 }
-var ExitCode, PROVIDER_ERROR_HINTS, COST_ESTIMATES;
+var ExitCode, PROVIDER_ERROR_HINTS, COST_ESTIMATES, _seenDeprecations;
 var init_output = __esm({
   "src/commands/output.ts"() {
     "use strict";
@@ -6734,7 +6749,7 @@ var init_output = __esm({
       { pattern: /context_length_exceeded|maximum.*context.*length|token.*limit.*exceeded|prompt.*too.*long/i, suggestion: "Input exceeds the model's context window. Shorten the prompt, or use a model with larger context (run 'vibe schema <command>' for options).", retryable: false },
       { pattern: /model.*not.*found|invalid.*model|unknown.*model|model_not_found/i, suggestion: "The specified model is unavailable. Check 'vibe schema <command>' for valid model options.", retryable: false },
       // Provider-specific
-      { pattern: /voice.*not.*found|voice_not_found|invalid.*voice.?id/i, suggestion: "Voice ID not found. Run 'vibe audio voices' to list available voices, then pass --voice <id>.", retryable: false },
+      { pattern: /voice.*not.*found|voice_not_found|invalid.*voice.?id/i, suggestion: "Voice ID not found. Run 'vibe audio list-voices' to list available voices, then pass --voice <id>.", retryable: false },
       { pattern: /character.*(count|limit).*exceeded|invalid_character_count/i, suggestion: "Text exceeds the TTS provider's character limit. Shorten the text or split into chunks.", retryable: false },
       { pattern: /invalid.*aspect.*ratio|unsupported.*aspect.*ratio|unsupported.*resolution/i, suggestion: "This aspect ratio or resolution isn't supported by the chosen model. Check 'vibe schema <command>' for supported values.", retryable: false },
       { pattern: /invalid.*file.*format|unsupported.*(format|codec)|unsupported.*media.?type/i, suggestion: "Input file format not supported. Convert to MP4/MP3/PNG first with 'vibe export' or 'ffmpeg'.", retryable: false },
@@ -6785,6 +6800,7 @@ var init_output = __esm({
       // pre-flight). Range covers a 1-beat preview to a 10-beat long-form.
       "compose scenes with skills": { min: 0.05, max: 1.5, unit: "per pipeline" }
     };
+    _seenDeprecations = /* @__PURE__ */ new Set();
   }
 });
 
@@ -30237,10 +30253,8 @@ var init_scene = __esm({
     init_compose_prompts();
     VALID_ASPECTS2 = ["16:9", "9:16", "1:1", "4:5"];
     VALID_SCENE_INIT_PROFILES = ["minimal", "agent", "full"];
-    sceneCommand = new Command("scene").description("Advanced scene commands for VibeFrame video projects").addHelpText("after", `
+    sceneCommand = new Command("scene").description("Lower-level scene authoring (add, lint, styles). For project flow use `vibe init` / `vibe build` / `vibe render`.").addHelpText("after", `
 Examples:
-  $ vibe scene init my-video                              # Scaffold a new project
-  $ vibe scene init my-video -r 9:16 -d 30                # Vertical 30s project
   $ vibe scene add intro --style announcement \\
       --headline "Welcome to VibeFrame"                   # Headline-only scene
   $ vibe scene add overview --narration "VibeFrame turns scripts into video." \\
@@ -30248,14 +30262,13 @@ 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 render                                     # Render to renders/<name>-<timestamp>.mp4
-  $ vibe scene render -o demo.mp4 --quality high          # Custom output path + quality
-  $ vibe scene render --fps 60 --format webm              # 60fps WebM render
+  $ vibe scene styles                                     # Browse seed visual styles for DESIGN.md
 
-Most users can start with \`vibe init\`, \`vibe build\`, and \`vibe render\`.
-This namespace exposes lower-level scene authoring and rendering controls.
+For the project flow (init / build / render), use the top-level commands.
+The \`scene init\`, \`scene build\`, and \`scene render\` legacy aliases
+are still callable but hidden from this help \u2014 they will be removed in v1.0.
 Run 'vibe schema scene.<command>' for structured parameter info.`);
-    sceneCommand.command("init").description("Scaffold a new scene project (or safely augment an existing project)").argument("<dir>", "Project directory (created if it doesn't exist)").option("-n, --name <name>", "Project name (defaults to directory basename)").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, 1:1, 4:5", "16:9").option("-d, --duration <sec>", "Default root composition duration (seconds)", "10").option("--visual-style <name>", `Seed DESIGN.md from a named style (browse via \`vibe scene styles\`). E.g. "Swiss Pulse"`).option("--profile <profile>", "Scene profile: minimal (storyboard/design only), agent (recommended), full (render scaffold upfront)", "agent").option("--dry-run", "Preview parameters without writing files").action(async (dir, options) => {
+    sceneCommand.command("init", { hidden: true }).description("Scaffold a new scene project (or safely augment an existing project) [legacy \u2014 prefer `vibe init`]").argument("<dir>", "Project directory (created if it doesn't exist)").option("-n, --name <name>", "Project name (defaults to directory basename)").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, 1:1, 4:5", "16:9").option("-d, --duration <sec>", "Default root composition duration (seconds)", "10").option("--visual-style <name>", `Seed DESIGN.md from a named style (browse via \`vibe scene styles\`). E.g. "Swiss Pulse"`).option("--profile <profile>", "Scene profile: minimal (storyboard/design only), agent (recommended), full (render scaffold upfront)", "agent").option("--dry-run", "Preview parameters without writing files").action(async (dir, options) => {
       const startedAt = Date.now();
       const aspect = validateAspect(options.ratio);
       const duration = validateDuration(options.duration);
@@ -30712,7 +30725,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
     VALID_FPS = [24, 30, 60];
     VALID_QUALITIES = ["draft", "standard", "high"];
     VALID_FORMATS = ["mp4", "webm", "mov"];
-    sceneCommand.command("render").description("Render a scene project to MP4/WebM/MOV via the Hyperframes producer (requires Chrome)").argument("[root]", "Root composition file relative to --project", "index.html").option("--project <dir>", "Project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--fps <n>", `Frames per second: ${VALID_FPS.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--dry-run", "Preview parameters without rendering").action(async (root, options) => {
+    sceneCommand.command("render", { hidden: true }).description("Render a scene project to MP4/WebM/MOV via the Hyperframes producer (requires Chrome) [legacy \u2014 prefer `vibe render`]").argument("[root]", "Root composition file relative to --project", "index.html").option("--project <dir>", "Project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--fps <n>", `Frames per second: ${VALID_FPS.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--dry-run", "Preview parameters without rendering").action(async (root, options) => {
       const startedAt = Date.now();
       const fps = validateFps(options.fps);
       const quality = validateQuality(options.quality);
@@ -30788,7 +30801,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
         }
       }
     });
-    sceneCommand.command("build").description("One-shot: read STORYBOARD.md cues, dispatch TTS + image-gen per beat, compose, render to MP4 (v0.60)").argument("[project-dir]", "Project directory containing STORYBOARD.md", ".").option("--mode <mode>", "Build mode: agent (host-agent authors HTML) | batch (CLI's internal LLM authors HTML) | auto (agent if any host detected) [Plan H \u2014 Phase 3]", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "LLM that composes scene HTML in batch mode: claude|openai|gemini (default: auto-resolve from available API keys, claude > gemini > openai)").option("--skip-narration", "Don't dispatch TTS even when beats declare narration cues").option("--skip-backdrop", "Don't dispatch image-gen even when beats declare backdrop cues").option("--skip-render", "Compose only \u2014 don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro (overrides frontmatter)").option("--voice <id>", "Voice id (provider-specific \u2014 overrides frontmatter)").option("--image-provider <name>", "Image provider: openai (only one supported in v0.60)").option("--quality <q>", "Image quality: standard|hd", "hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536", "1536x1024").option("--force", "Re-dispatch primitives even when assets already exist").option("--dry-run", "Preview parameters without dispatching").action(async (projectDirArg, options) => {
+    sceneCommand.command("build", { hidden: true }).description("One-shot: read STORYBOARD.md cues, dispatch TTS + image-gen per beat, compose, render to MP4 [legacy \u2014 prefer `vibe build`]").argument("[project-dir]", "Project directory containing STORYBOARD.md", ".").option("--mode <mode>", "Build mode: agent (host-agent authors HTML) | batch (CLI's internal LLM authors HTML) | auto (agent if any host detected) [Plan H \u2014 Phase 3]", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "LLM that composes scene HTML in batch mode: claude|openai|gemini (default: auto-resolve from available API keys, claude > gemini > openai)").option("--skip-narration", "Don't dispatch TTS even when beats declare narration cues").option("--skip-backdrop", "Don't dispatch image-gen even when beats declare backdrop cues").option("--skip-render", "Compose only \u2014 don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro (overrides frontmatter)").option("--voice <id>", "Voice id (provider-specific \u2014 overrides frontmatter)").option("--image-provider <name>", "Image provider: openai (only one supported in v0.60)").option("--quality <q>", "Image quality: standard|hd", "hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536", "1536x1024").option("--force", "Re-dispatch primitives even when assets already exist").option("--dry-run", "Preview parameters without dispatching").action(async (projectDirArg, options) => {
       const startedAt = Date.now();
       const projectDir = resolve14(projectDirArg);
       if (options.dryRun) {
@@ -62588,7 +62601,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.73.0",
+  version: "0.74.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -63714,22 +63727,28 @@ init_sanitize();
 init_validate();
 import { readFile as readFile26, writeFile as writeFile31 } from "node:fs/promises";
 import { resolve as resolve36 } from "node:path";
-var analyzeCommand = new Command("analyze").alias("az").description("Analyze media using AI (images, videos, YouTube URLs)").addHelpText(
+var analyzeCommand = new Command("inspect").alias("analyze").alias("az").description("Inspect media using AI (images, videos, YouTube URLs)").hook("preAction", () => {
+  const invoked = process.argv[2];
+  if (invoked === "analyze" || invoked === "az") {
+    emitDeprecationWarning(invoked, "inspect", "v1.0");
+  }
+}).addHelpText(
   "after",
   `
 Examples:
-  $ vibe analyze media image.png "Describe this image"
-  $ vibe analyze media video.mp4 "Summarize this video"
-  $ vibe analyze media "https://youtube.com/watch?v=..." "Key takeaways"
-  $ vibe analyze video video.mp4 "List all scene changes" --low-res
-  $ vibe analyze review video.mp4 --auto-apply -o fixed.mp4
-  $ vibe analyze suggest project.vibe.json "make it more dramatic"
+  $ vibe inspect media image.png "Describe this image"
+  $ vibe inspect media video.mp4 "Summarize this video"
+  $ vibe inspect media "https://youtube.com/watch?v=..." "Key takeaways"
+  $ vibe inspect video video.mp4 "List all scene changes" --low-res
+  $ vibe inspect review video.mp4 --auto-apply -o fixed.mp4
+  $ vibe inspect suggest project.vibe.json "make it more dramatic"
 
 API Keys:
-  GOOGLE_API_KEY  Required for all analyze commands (Gemini)
+  GOOGLE_API_KEY  Required for all inspect commands (Gemini)
 
+Aliases: \`analyze\`, \`az\` (deprecated \u2014 removed in v1.0).
 Use '--fields response,model' to limit output size.
-Run 'vibe schema analyze.<command>' for structured parameter info.
+Run 'vibe schema inspect.<command>' for structured parameter info.
 `
 );
 analyzeCommand.command("media").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("-v, --verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").action(async (source, prompt3, options) => {
@@ -63924,18 +63943,19 @@ var audioCommand = new Command("audio").alias("au").description("Audio operation
 Examples:
   $ vibe audio transcribe interview.mp3 -o transcript.srt -f srt
   $ vibe audio transcribe video.mp4 -l ko                  # Specify language
-  $ vibe audio voices                                       # List available voices
+  $ vibe audio list-voices                                  # List available voices
   $ vibe audio isolate song.mp3 -o vocals.mp3
-  $ vibe audio voice-clone sample.mp3 -n "my-voice"
+  $ vibe audio clone-voice sample.mp3 -n "my-voice"
   $ vibe audio dub video.mp4 -l ko -o dubbed.mp4
   $ vibe audio duck music.mp3 --voice narration.mp3 -o ducked.mp3
 
 API Keys:
   OPENAI_API_KEY      transcribe (Whisper)
-  ELEVENLABS_API_KEY  voices, isolate, voice-clone
+  ELEVENLABS_API_KEY  list-voices, isolate, clone-voice
   OPENAI_API_KEY + ANTHROPIC_API_KEY + ELEVENLABS_API_KEY  dub (full pipeline)
   No key needed       duck (FFmpeg only)
 
+Aliases (deprecated, removed in v1.0): voices \u2192 list-voices, voice-clone \u2192 clone-voice
 Run 'vibe schema audio.<command>' for structured parameter info.
 `
 );
@@ -63999,7 +64019,9 @@ audioCommand.command("transcribe").description("Transcribe audio using Whisper")
     exitWithError(apiError(`Transcription failed: ${msg}`, true));
   }
 });
-audioCommand.command("voices").description("List available ElevenLabs voices").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").action(async (options) => {
+audioCommand.command("list-voices").alias("voices").description("List available ElevenLabs voices").hook("preAction", () => {
+  if (process.argv[3] === "voices") emitDeprecationWarning("audio voices", "audio list-voices", "v1.0");
+}).option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").action(async (options) => {
   const startedAt = Date.now();
   try {
     const apiKey = await requireApiKey("ELEVENLABS_API_KEY", "ElevenLabs", options.apiKey);
@@ -64010,7 +64032,7 @@ audioCommand.command("voices").description("List available ElevenLabs voices").o
     spinner2.succeed(source_default.green(`Found ${voices.length} voices`));
     if (isJsonMode()) {
       outputSuccess({
-        command: "audio voices",
+        command: "audio list-voices",
         startedAt,
         data: {
           voices: voices.map((v) => ({ name: v.name, voiceId: v.voice_id, category: v.category, labels: v.labels }))
@@ -64077,12 +64099,14 @@ audioCommand.command("isolate").description("Isolate vocals from audio using Ele
     exitWithError(apiError(`Audio isolation failed: ${msg}`, true));
   }
 });
-audioCommand.command("voice-clone").description("Clone a voice from audio samples using ElevenLabs").argument("[samples...]", "Audio sample files (1-25 files)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-n, --name <name>", "Voice name (required)").option("-d, --description <desc>", "Voice description").option("--labels <json>", `Labels as JSON (e.g., '{"accent": "american"}')`).option("--remove-noise", "Remove background noise from samples").option("--list", "List all available voices").option("--dry-run", "Preview parameters without executing").action(async (samples, options) => {
+audioCommand.command("clone-voice").alias("voice-clone").description("Clone a voice from audio samples using ElevenLabs").hook("preAction", () => {
+  if (process.argv[3] === "voice-clone") emitDeprecationWarning("audio voice-clone", "audio clone-voice", "v1.0");
+}).argument("[samples...]", "Audio sample files (1-25 files)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-n, --name <name>", "Voice name (required)").option("-d, --description <desc>", "Voice description").option("--labels <json>", `Labels as JSON (e.g., '{"accent": "american"}')`).option("--remove-noise", "Remove background noise from samples").option("--list", "List all available voices").option("--dry-run", "Preview parameters without executing").action(async (samples, options) => {
   const startedAt = Date.now();
   try {
     if (options.dryRun) {
       outputSuccess({
-        command: "audio voice-clone",
+        command: "audio clone-voice",
         startedAt,
         dryRun: true,
         data: { params: { samples: samples?.length, name: options.name } }
@@ -64143,7 +64167,7 @@ audioCommand.command("voice-clone").description("Clone a voice from audio sample
     spinner2.succeed(source_default.green("Voice cloned successfully"));
     if (isJsonMode()) {
       outputSuccess({
-        command: "audio voice-clone",
+        command: "audio clone-voice",
         startedAt,
         data: { name: options.name, voiceId: result.voiceId }
       });
@@ -64609,24 +64633,29 @@ function registerScriptPipelineCommands(aiCommand) {
 init_ai_highlights();
 init_ai_animated_caption();
 init_output();
-var pipelineCommand = new Command("pipeline").alias("pipe").description(
+var pipelineCommand = new Command("remix").alias("pipeline").alias("pipe").description(
   "AI media transformations on existing video / audio (highlights, auto-shorts, animated captions). For BUILD-from-text flows see `vibe build`."
-).addHelpText(
+).hook("preAction", () => {
+  const invoked = process.argv[2];
+  if (invoked === "pipeline" || invoked === "pipe") {
+    emitDeprecationWarning(invoked, "remix", "v1.0");
+  }
+}).addHelpText(
   "after",
   `
 Two flows \u2014 pick by intent:
   BUILD     \u2014 text \u2192 MP4 (intent \u2192 AI generation \u2192 new video)
               Use \`vibe build\` with a STORYBOARD.md + DESIGN.md.
               Idempotent, agent-editable, skills-driven (v0.60+).
-  PROCESS   \u2014 existing video/audio \u2192 transformed media
-              Use \`vibe pipeline\` (this group) or \`vibe edit\` / \`vibe audio\`.
+  REMIX     \u2014 existing video/audio \u2192 transformed media
+              Use \`vibe remix\` (this group) or \`vibe edit\` / \`vibe audio\`.
               One-shot, batch-oriented, no storyboard required.
 
-Examples (PROCESS):
-  $ vibe pipeline highlights long-video.mp4 -o highlights.json -d 60
-  $ vibe pipeline auto-shorts long-video.mp4 -o shorts/ -n 3 --add-captions
-  $ vibe pipeline animated-caption video.mp4 -o captioned.mp4 -s highlight
-  $ vibe pipeline animated-caption video.mp4 -o out.mp4 -s karaoke-sweep --fast
+Examples (REMIX):
+  $ vibe remix highlights long-video.mp4 -o highlights.json -d 60
+  $ vibe remix auto-shorts long-video.mp4 -o shorts/ -n 3 --add-captions
+  $ vibe remix animated-caption video.mp4 -o captioned.mp4 -s highlight
+  $ vibe remix animated-caption video.mp4 -o out.mp4 -s karaoke-sweep --fast
 
 Provider API Keys:
   highlights:          GOOGLE_API_KEY (Gemini analysis)
@@ -64639,12 +64668,9 @@ Cost tiers:
   animated-caption:    $   Low (~$0.01)
   regenerate-scene:    $$$ High (per-scene re-run; depends on provider)
 
-Note: \`pipeline script-to-video\` was removed \u2014 use \`vibe build\` for
-text \u2192 MP4. \`pipeline regenerate-scene\` still operates on the
-storyboard.{yaml,json} layout produced by older runs.
-
+Aliases: \`pipeline\`, \`pipe\` (deprecated \u2014 removed in v1.0).
 Use '--dry-run' to preview parameters before execution.
-Run 'vibe schema pipeline.<command>' for structured parameter info.
+Run 'vibe schema remix.<command>' for structured parameter info.
 `
 );
 registerScriptPipelineCommands(pipelineCommand);
@@ -64654,9 +64680,9 @@ pipelineCommand.command("animated-caption").description("Add animated captions w
   "after",
   `
 Examples:
-  $ vibe pipeline animated-caption video.mp4 -o captioned.mp4
-  $ vibe pipeline animated-caption video.mp4 -o out.mp4 -s bounce
-  $ vibe pipeline animated-caption video.mp4 -o out.mp4 -s karaoke-sweep --fast
+  $ vibe remix animated-caption video.mp4 -o captioned.mp4
+  $ vibe remix animated-caption video.mp4 -o out.mp4 -s bounce
+  $ vibe remix animated-caption video.mp4 -o out.mp4 -s karaoke-sweep --fast
 
 Styles:
   highlight (default)  TikTok-style background highlight on active word (Remotion)
@@ -69834,13 +69860,13 @@ skills-driven pipeline (v0.60+) dispatches narration TTS + backdrop
 image-gen per beat, composes scene HTML via the bundled composition rules
 bundle, then renders to MP4. Idempotent re-runs reuse cached assets.
 
-**PROCESS \u2014 transform existing video / audio.**
-Use \`vibe pipeline\`, \`vibe edit\`, or \`vibe audio\`. One-shot,
+**REMIX \u2014 transform existing video / audio.**
+Use \`vibe remix\`, \`vibe edit\`, or \`vibe audio\`. One-shot,
 batch-oriented operations on a file the user already has on disk.
 
 Decision rule: if the user is starting from intent (a script, a brand,
 an idea), it's BUILD. If the user is starting from a media file, it's
-PROCESS.
+REMIX.
 
 ## Common workflows
 
@@ -69855,18 +69881,18 @@ PROCESS.
 | Generate a single video | \`vibe generate video "prompt" -i image.png -o clip.mp4\` |
 | Generate narration | \`vibe generate speech "text" -o voice.mp3\` |
 
-### PROCESS (transform existing media)
+### REMIX (transform existing media)
 
 | Task | Command |
 |---|---|
-| Extract highlights from a long video | \`vibe pipeline highlights file.mp4 -d 60\` |
-| Long video \u2192 vertical shorts | \`vibe pipeline auto-shorts file.mp4 -n 3 --add-captions\` |
-| Add animated word-by-word captions | \`vibe pipeline animated-caption file.mp4 -s karaoke-sweep\` |
+| Extract highlights from a long video | \`vibe remix highlights file.mp4 -d 60\` |
+| Long video \u2192 vertical shorts | \`vibe remix auto-shorts file.mp4 -n 3 --add-captions\` |
+| Add animated word-by-word captions | \`vibe remix animated-caption file.mp4 -s karaoke-sweep\` |
 | Remove silence | \`vibe edit silence-cut in.mp4 -o out.mp4\` |
 | Add static captions | \`vibe edit caption in.mp4 -o out.mp4\` |
 | Translate audio (transcribe \u2192 TTS) | \`vibe audio dub file.mp4 -t ko\` |
 | Transcribe (Whisper, word-level) | \`vibe audio transcribe file.mp4 --granularity word\` |
-| Analyze a video | \`vibe analyze video file.mp4 "summarise"\` |
+| Inspect a video | \`vibe inspect video file.mp4 "summarise"\` |
 
 ### Compose pipelines (Video as Code)
 
@@ -69880,9 +69906,9 @@ PROCESS.
 | Tier | Examples | Approx. per call |
 |---|---|---|
 | **Free** | \`detect *\`, \`edit silence-cut/fade/noise-reduce\`, \`schema\`, \`project\`, \`timeline\` | $0 |
-| **Low** | \`analyze *\`, \`audio transcribe\`, \`generate image\` | $0.01\u2013$0.10 |
+| **Low** | \`inspect *\`, \`audio transcribe\`, \`generate image\` | $0.01\u2013$0.10 |
 | **High** | \`generate video\`, \`edit image\` | $1\u2013$5 |
-| **Very High** | \`pipeline *\` (highlights, auto-shorts, regenerate-scene), \`build\` | $5\u2013$50+ |
+| **Very High** | \`remix *\` (highlights, auto-shorts, regenerate-scene), \`build\` | $5\u2013$50+ |
 
 ## Agent invariants
 
@@ -69894,7 +69920,7 @@ When you run vibe commands programmatically:
 3. **Use \`vibe schema <command>\`** to discover parameters; do not guess flags
 4. **Pass complex options via \`--stdin\`**:
    \`\`\`bash
-   echo '{"video":"long.mp4","count":3,"aspect":"9:16"}' | vibe pipeline auto-shorts --stdin --json
+   echo '{"video":"long.mp4","count":3,"aspect":"9:16"}' | vibe remix auto-shorts --stdin --json
    \`\`\`
 
 ## Provider keys
@@ -72357,32 +72383,38 @@ Global flags (work with any command):
   --stdin        Read options from stdin as JSON (for agent/script use)
   --dry-run      Preview without executing (most commands)
 
-Cost tiers:
-  Free     detect, edit (silence-cut/fade/noise-reduce), project, timeline, export
-  Low      analyze, audio transcribe, generate image               ~$0.01-$0.10
-  High     generate video, edit image                              ~$1-$5
-  V.High   pipeline (regenerate-scene, highlights, auto-shorts)   ~$5-$50+
-  Tip      Add --dry-run before paid generation to preview the work.
-
-Project flow:
+Get started (90% of users start here):
   vibe doctor                  Check system health and API keys
   vibe setup                   Configure API keys interactively
   vibe init my-video           Scaffold a video project
   vibe build my-video          Build STORYBOARD.md into scene compositions/assets
   vibe render my-video         Render the project to MP4
-
-Asset tools:
-  vibe generate image "..."    Generate a still image
-  vibe generate video "..."    Generate a standalone AI video
-
-Workflow automation:
-  vibe run workflow.yaml       Run a Video-as-YAML pipeline
-  vibe schema --list           Discover all commands
-
-Agent integration:
-  vibe walkthrough scene       Load the scene authoring guide
-  echo '{"provider":"kling"}' | vibe generate video "prompt" --stdin --json
-  vibe schema generate.video   Get parameter schema for any command
+  vibe demo                    Try VibeFrame without API keys
+
+One-shot media tools:
+  vibe generate image "..."           Generate a still image
+  vibe generate video "..."           Generate a standalone AI video
+  vibe edit caption clip.mp4 -o out.mp4
+  vibe inspect media clip.mp4 "Summarize this"
+  vibe remix highlights long.mp4 -d 60
+
+Advanced authoring:
+  vibe project create my-video        CRUD on .vibe.json
+  vibe scene add intro --headline "Welcome"
+  vibe timeline add-clip project.vibe.json <source-id>
+
+Automation & agents:
+  vibe run workflow.yaml              Run a Video-as-YAML pipeline
+  vibe agent                          Natural-language interface
+  vibe schema generate.video          Tool schema for any command
+  vibe walkthrough scene              Step-by-step authoring guide
+
+Cost tiers (per call):
+  Free     detect, edit (silence-cut/fade/noise-reduce), project, timeline, export
+  Low      inspect, audio transcribe, generate image               ~$0.01-$0.10
+  High     generate video, edit image                              ~$1-$5
+  V.High   remix (regenerate-scene, highlights, auto-shorts)      ~$5-$50+
+  Tip      Add --dry-run before paid generation to preview the work.
 `
 );
 program2.hook("preAction", async (thisCommand, actionCommand) => {
@@ -72458,7 +72490,7 @@ program2.addCommand(agentCommand);
 program2.addCommand(projectCommand);
 program2.addCommand(sceneCommand);
 program2.addCommand(timelineCommand);
-program2.addCommand(exportCommand);
+program2.addCommand(exportCommand, { hidden: true });
 program2.addCommand(detectCommand);
 program2.addCommand(batchCommand);
 program2.addCommand(schemaCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.73.0",
+  "version": "0.74.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.73.0",
-    "@vibeframe/core": "0.73.0"
+    "@vibeframe/ai-providers": "0.74.0",
+    "@vibeframe/core": "0.74.0"
   },
   "engines": {
     "node": ">=20"