@vibeframe/cli 0.82.0 → 0.84.0

package/dist/index.js

@@ -35862,6 +35862,45 @@ var init_video = __esm({
   }
 });
 
+// src/commands/_shared/cost-tier.ts
+function applyTier(cmd, tier) {
+  cmd[COST_TIER_KEY] = tier;
+  const colored = TIER_COLOR[tier](`Cost: ${tier} (${TIER_DESCRIPTION[tier]})`);
+  cmd.addHelpText("after", `
+${colored}
+`);
+  return cmd;
+}
+function getCostTier(cmd) {
+  return cmd[COST_TIER_KEY];
+}
+function applyTiers(parent, tiers) {
+  for (const cmd of parent.commands) {
+    const tier = tiers[cmd.name()];
+    if (tier) applyTier(cmd, tier);
+  }
+}
+var TIER_DESCRIPTION, TIER_COLOR, COST_TIER_KEY;
+var init_cost_tier = __esm({
+  "src/commands/_shared/cost-tier.ts"() {
+    "use strict";
+    init_source();
+    TIER_DESCRIPTION = {
+      "free": "FFmpeg only, no API call",
+      "low": "$0.01\u2013$0.10 per call",
+      "high": "$1\u2013$5 per call",
+      "very-high": "$5\u2013$50+ per call"
+    };
+    TIER_COLOR = {
+      "free": source_default.green,
+      "low": source_default.cyan,
+      "high": source_default.yellow,
+      "very-high": source_default.red
+    };
+    COST_TIER_KEY = Symbol.for("@vibeframe/cli.costTier");
+  }
+});
+
 // src/commands/generate.ts
 var generate_exports = {};
 __export(generate_exports, {
@@ -35873,6 +35912,10 @@ __export(generate_exports, {
   executeStoryboard: () => executeStoryboard,
   generateCommand: () => generateCommand
 });
+function tierLast(parent, tier) {
+  const newest = parent.commands[parent.commands.length - 1];
+  if (newest) applyTier(newest, tier);
+}
 var generateCommand;
 var init_generate = __esm({
   "src/commands/generate.ts"() {
@@ -35891,6 +35934,7 @@ var init_generate = __esm({
     init_video_extend();
     init_image();
     init_video();
+    init_cost_tier();
     init_sound_effect();
     init_music_status();
     init_background();
@@ -35928,18 +35972,31 @@ Run 'vibe schema generate.<command>' for structured parameter info.
 `
     );
     registerImageCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerVideoCommand(generateCommand);
+    tierLast(generateCommand, "very-high");
     registerSpeechCommand(generateCommand);
+    tierLast(generateCommand, "low");
     registerSoundEffectCommand(generateCommand);
+    tierLast(generateCommand, "low");
     registerMusicCommand(generateCommand);
+    tierLast(generateCommand, "low");
     registerMusicStatusCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerStoryboardCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerMotionCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerThumbnailCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerBackgroundCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerVideoStatusCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerVideoCancelCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerVideoExtendCommand(generateCommand);
+    tierLast(generateCommand, "very-high");
   }
 });
 
@@ -37238,7 +37295,7 @@ var init_ai_edit = __esm({
 import { resolve as resolve28, extname as extname5, basename as basename7 } from "node:path";
 import { existsSync as existsSync22 } from "node:fs";
 function registerEditCommands(aiCommand) {
-  aiCommand.command("silence-cut").alias("sc").description("Remove silent segments from video (FFmpeg default, or Gemini for smart detection)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-cut.<ext>)").option("--noise <dB>", "Silence threshold in dB (default: -30)", "-30").option("-d, --min-duration <seconds>", "Minimum silence duration to cut (default: 0.5)", "0.5").option("--padding <seconds>", "Padding around non-silent segments (default: 0.1)", "0.1").option("--analyze-only", "Only detect silence, don't cut").option("--use-gemini", "Use Gemini Video Understanding for context-aware silence detection").option("-m, --model <model>", "Gemini model (default: flash)").option("--low-res", "Low resolution mode for longer videos (Gemini only)").option("-k, --api-key <key>", "Google API key override (or set GOOGLE_API_KEY env)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
+  aiCommand.command("silence-cut").alias("sc").description("Remove silent segments from video (FFmpeg default, or Gemini for smart detection)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-cut.<ext>)").option("--noise <dB>", "Silence threshold in dB (default: -30)", "-30").option("-d, --min-duration <seconds>", "Minimum silence duration to cut (default: 0.5)", "0.5").option("--padding <seconds>", "Padding around non-silent segments (default: 0.1)", "0.1").option("--analyze-only", "(deprecated \u2014 use `vibe detect silence`) Only detect silence, don't cut").option("--use-gemini", "Use Gemini Video Understanding for context-aware silence detection").option("-m, --model <model>", "Gemini model (default: flash)").option("--low-res", "Low resolution mode for longer videos (Gemini only)").option("-k, --api-key <key>", "Google API key override (or set GOOGLE_API_KEY env)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe edit silence-cut interview.mp4 -o clean.mp4
   $ vibe ed sc podcast.mp4 -o trimmed.mp4 --noise -25 --min-duration 1.0
@@ -37263,6 +37320,13 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
       const name = basename7(videoPath, ext);
       const outputPath = options.output || `${name}-cut${ext}`;
       const useGemini = options.useGemini || false;
+      if (options.analyzeOnly) {
+        console.error(
+          source_default.yellow(
+            "\u26A0 --analyze-only is deprecated. Use `vibe detect silence` for read-only detection. Will be removed in v1.0."
+          )
+        );
+      }
       if (options.dryRun) {
         outputSuccess({
           command: "edit silence-cut",
@@ -38485,6 +38549,7 @@ var init_edit_cmd = __esm({
     init_ai_fill_gaps();
     init_output();
     init_validate();
+    init_cost_tier();
     editCommand = new Command("edit").alias("ed").description(
       "Edit and post-process media (silence-cut, caption, grade, reframe, upscale...)"
     ).addHelpText(
@@ -39232,6 +39297,26 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(generalError(`Video upscaling failed: ${msg}`));
       }
     });
+    applyTiers(editCommand, {
+      // free — FFmpeg only
+      "noise-reduce": "free",
+      "fade": "free",
+      "text-overlay": "free",
+      "interpolate": "free",
+      // low — Whisper / single LLM call
+      "silence-cut": "low",
+      "caption": "low",
+      "translate-srt": "low",
+      "jump-cut": "low",
+      "grade": "low",
+      "speed-ramp": "low",
+      // high — vision LLM or image gen
+      "reframe": "high",
+      "image": "high",
+      "upscale": "high",
+      // very-high — video gen per gap
+      "fill-gaps": "very-high"
+    });
   }
 });
 
@@ -50622,6 +50707,7 @@ var init_detect = __esm({
     init_exec_safe();
     init_output();
     init_validate();
+    init_cost_tier();
     detectCommand = new Command("detect").description("Auto-detect scenes, beats, and silences in media");
     detectCommand.command("scenes").description("Detect scene changes in video").argument("<video>", "Video file path").option("--threshold <value>", "Scene change threshold (0-1)", "0.3").option("-o, --output <path>", "Output JSON file with timestamps").option("--project <path>", "Add scenes as clips to project").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
@@ -50913,6 +50999,11 @@ var init_detect = __esm({
         exitWithError(generalError(`Beat detection failed: ${msg}`));
       }
     });
+    applyTiers(detectCommand, {
+      "scenes": "free",
+      "silence": "free",
+      "beats": "free"
+    });
   }
 });
 
@@ -50942,7 +51033,7 @@ function listWalkthroughs() {
 function isWalkthroughTopic(value) {
   return typeof value === "string" && WALKTHROUGH_TOPICS.includes(value);
 }
-var SCENE_WALKTHROUGH, PIPELINE_WALKTHROUGH, META, CONTENT, WALKTHROUGH_TOPICS;
+var SCENE_WALKTHROUGH, PIPELINE_WALKTHROUGH, ARCHITECTURE_WALKTHROUGH, META, CONTENT, WALKTHROUGH_TOPICS;
 var init_walkthroughs = __esm({
   "src/commands/_shared/walkthroughs/walkthroughs.ts"() {
     "use strict";
@@ -51182,6 +51273,59 @@ When the user has a working shell sequence, extract steps:
 
 The \`compose\` action is the catch-all assembly step (audio mux, video
 overlay, etc.) \u2014 useful at the tail of a pipeline.
+`;
+    ARCHITECTURE_WALKTHROUGH = `# vibe agent / build / run \u2014 when to pick which
+
+The CLI has three orchestrating commands that coordinate other primitives:
+\`vibe agent\`, \`vibe build\`, \`vibe run\`. New users routinely ask which one
+they want for a given task. The full audit lives in
+[\`docs/cli-architecture.md\`](../../../docs/cli-architecture.md); this
+walkthrough is the operator-facing summary.
+
+## TL;DR
+
+| | \`vibe agent\` | \`vibe build\` | \`vibe run\` |
+|---|---|---|---|
+| **Driving input** | natural-language prompt | \`STORYBOARD.md\` | YAML pipeline file |
+| **Interactivity** | REPL or one-shot | one-shot | one-shot |
+| **Reproducibility** | none | high (idempotent) | highest (checkpointed) |
+| **Budget caps** | per-session max-turns | none | \`--budget-usd\`, \`--budget-tokens\`, \`--max-errors\` |
+| **Resume after crash** | no | re-invoke | \`--resume\` |
+| **Best for** | exploration | finished script | repeatable workflows |
+
+## Decision tree
+
+- "I want to play, I'll know it when I see it" \u2192 \`vibe agent\`
+- "I have a finished script + visual identity" \u2192 \`vibe build\`
+- "I want this to run again next month" \u2192 \`vibe run\`
+
+If two seem to fit, pick the rightmost one \u2014 more reproducible, less surprise.
+
+## Cost-tier awareness (v0.83+)
+
+Every primitive subcommand carries a cost tier (\`free\` / \`low\` / \`high\` /
+\`very-high\`). \`vibe schema --list\` exposes the tier as JSON, and each
+\`vibe <group> <sub> --help\` page shows it as a colored footer. Use
+\`vibe doctor --test-keys\` before kicking off any high-cost orchestrator \u2014
+a single bad key wastes time and money.
+
+## Cross-command primitives
+
+All three commands ultimately call the same primitives:
+\`generate\` / \`edit\` / \`audio\` / \`inspect\` / \`detect\` / \`remix\`. The
+agent calls them through a tool manifest; \`build\` calls a curated subset
+(TTS + image + compose + render); \`run\` exposes 55+ actions one per primitive.
+
+## Known overlap
+
+- \`vibe build\` is conceptually a 4-step pipeline; \`vibe run\` could express
+  the same flow but build's STORYBOARD.md input + opinionated defaults are
+  the value-add.
+- \`vibe agent\`'s tool registry currently exposes primitives, not
+  orchestrators. Adding \`vibe.build\` / \`vibe.run\` as agent tools is on the
+  table for a future major.
+- \`vibe run --resume\` has no analog in build/agent; build's idempotent
+  re-invoke covers the common case.
 `;
     META = {
       scene: {
@@ -51220,13 +51364,32 @@ overlay, etc.) \u2014 useful at the tail of a pipeline.
           "vibe schema --list",
           "vibe doctor"
         ]
+      },
+      architecture: {
+        title: "vibe agent / build / run \u2014 when to pick which",
+        summary: "Compare the three orchestrating commands on the dimensions that actually decide the choice",
+        steps: [
+          "Pick agent for exploration (NL prompt, REPL, no checkpoints).",
+          "Pick build for STORYBOARD.md \u2192 MP4 with opinionated defaults.",
+          "Pick run for repeatable, budget-capped, checkpointed YAML pipelines.",
+          "Run `vibe doctor --test-keys` before any high-cost orchestrator to validate keys upfront.",
+          "Use `vibe schema --list` (cost field, v0.84) to plan the budget per step before kicking off `vibe run --budget-usd`."
+        ],
+        relatedCommands: [
+          "vibe agent",
+          "vibe build",
+          "vibe run",
+          "vibe doctor",
+          "vibe schema --list"
+        ]
       }
     };
     CONTENT = {
       scene: SCENE_WALKTHROUGH,
-      pipeline: PIPELINE_WALKTHROUGH
+      pipeline: PIPELINE_WALKTHROUGH,
+      architecture: ARCHITECTURE_WALKTHROUGH
     };
-    WALKTHROUGH_TOPICS = ["scene", "pipeline"];
+    WALKTHROUGH_TOPICS = ["scene", "pipeline", "architecture"];
   }
 });
 
@@ -51326,25 +51489,36 @@ var init_key_live_test = __esm({
           signal
         )
       },
-      // The four below have no cheap authenticated GET — providing a tester
-      // would either consume a paid API call (fal, Runway), require HMAC
-      // signing per request (Kling), or burn an image upload (ImgBB). We
-      // surface them as `skipped` so the user knows we didn't blank-check.
+      // Runway: /v1/organization is a read-only GET that returns tier info
+      // (free, doesn't consume credits). Requires the X-Runway-Version
+      // header alongside the Bearer token — without it the request 401s.
+      runway: {
+        name: "Runway",
+        test: (key, signal) => getOk(
+          "https://api.dev.runwayml.com/v1/organization",
+          {
+            Authorization: `Bearer ${key}`,
+            "X-Runway-Version": "2024-11-06"
+          },
+          signal
+        )
+      },
+      // The three below still have no cheap authenticated GET as of v0.83:
+      // fal lacks a documented validation endpoint, Kling auth is per-
+      // request HMAC-signed, ImgBB's only authenticated route is image
+      // upload. Surface them as `skipped` so the user knows we didn't
+      // blank-check.
       fal: {
         name: "fal.ai",
-        test: async () => ({ ok: false, skipped: true, message: "no list endpoint" })
+        test: async () => ({ ok: false, skipped: true, message: "no auth-only endpoint published" })
       },
       kling: {
         name: "Kling",
-        test: async () => ({ ok: false, skipped: true, message: "HMAC-signed; can't test cheaply" })
-      },
-      runway: {
-        name: "Runway",
-        test: async () => ({ ok: false, skipped: true, message: "POST-only API" })
+        test: async () => ({ ok: false, skipped: true, message: "per-request HMAC; can't test cheaply" })
       },
       imgbb: {
         name: "ImgBB",
-        test: async () => ({ ok: false, skipped: true, message: "would consume an upload" })
+        test: async () => ({ ok: false, skipped: true, message: "only auth route is image upload" })
       }
     };
   }
@@ -62651,7 +62825,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.82.0",
+  version: "0.84.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -63819,6 +63993,7 @@ init_ai_review();
 init_output();
 init_sanitize();
 init_validate();
+init_cost_tier();
 import { readFile as readFile23, writeFile as writeFile30 } from "node:fs/promises";
 import { resolve as resolve33 } from "node:path";
 var inspectCommand = new Command("inspect").description("Inspect media using AI (images, videos, YouTube URLs)").addHelpText(
@@ -63916,6 +64091,7 @@ inspectCommand.command("media").description("Analyze any media: images, videos,
     exitWithError(apiError(`Analysis failed: ${error.message}`));
   }
 });
+applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "low");
 inspectCommand.command("video").description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., '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 (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
   const startedAt = Date.now();
   try {
@@ -63992,7 +64168,9 @@ inspectCommand.command("video").description("Analyze video using Gemini (summari
     exitWithError(apiError(`Video analysis failed: ${error.message}`));
   }
 });
+applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "low");
 registerReviewCommand(inspectCommand);
+applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "low");
 inspectCommand.command("suggest").description("Get AI edit suggestions using Gemini").argument("<project>", "Timeline file or directory").argument("<instruction>", "Natural language instruction").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("--apply", "Apply the first suggestion automatically").option("--dry-run", "Preview parameters without executing").action(async (projectPath, instruction, options) => {
   const startedAt = Date.now();
   try {
@@ -64063,6 +64241,7 @@ inspectCommand.command("suggest").description("Get AI edit suggestions using Gem
     exitWithError(apiError(`AI suggestion failed: ${error.message}`));
   }
 });
+applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "low");
 
 // src/commands/audio.ts
 init_esm();
@@ -64072,6 +64251,7 @@ init_dist2();
 init_api_key();
 init_exec_safe();
 init_subtitle();
+init_cost_tier();
 init_ai_helpers();
 init_output();
 init_validate();
@@ -64579,6 +64759,14 @@ audioCommand.command("duck").description("Auto-duck background music when voice
     exitWithError(generalError(`Audio ducking failed: ${msg}`));
   }
 });
+applyTiers(audioCommand, {
+  "transcribe": "low",
+  "list-voices": "low",
+  "isolate": "low",
+  "clone-voice": "low",
+  "dub": "high",
+  "duck": "free"
+});
 
 // src/commands/remix.ts
 init_esm();
@@ -64769,6 +64957,7 @@ function registerScriptPipelineCommands(aiCommand) {
 init_ai_highlights();
 init_ai_animated_caption();
 init_output();
+init_cost_tier();
 var remixCommand = new Command("remix").description(
   "Transform existing media (highlights, auto-shorts, animated captions, regenerate-scene)"
 ).addHelpText(
@@ -64910,10 +65099,17 @@ Required API Key: OPENAI_API_KEY (Whisper transcription)
     exitWithError(generalError(`Animated caption failed: ${msg}`));
   }
 });
+applyTiers(remixCommand, {
+  "regenerate-scene": "very-high",
+  "highlights": "high",
+  "auto-shorts": "high",
+  "animated-caption": "low"
+});
 
 // src/commands/schema.ts
 init_esm();
 init_output();
+init_cost_tier();
 var schemaCommand = new Command("schema").description("Show JSON schema for a CLI command").argument("[command]", "Command path (e.g., generate.image, edit.silence-cut)").option("--list", "List all available command paths").action((commandPath, options) => {
   const program3 = schemaCommand.parent;
   if (!program3) {
@@ -64970,15 +65166,18 @@ function listCommands(program3) {
     if (subCmds.length === 0) {
       const desc = group.description() || "";
       if (desc.toLowerCase().includes("deprecated")) continue;
-      commands.push({ path: name, description: desc });
+      const cost = getCostTier(group);
+      commands.push({ path: name, description: desc, ...cost ? { cost } : {} });
       continue;
     }
     for (const sub of subCmds) {
       const desc = sub.description() || "";
       if (desc.toLowerCase().includes("deprecated")) continue;
+      const cost = getCostTier(sub);
       commands.push({
         path: `${name}.${sub.name()}`,
-        description: desc
+        description: desc,
+        ...cost ? { cost } : {}
       });
     }
   }
@@ -65106,9 +65305,11 @@ function buildSchema(cmd, toolName) {
     }
     properties[name] = prop;
   }
+  const cost = getCostTier(cmd);
   return {
     name: toolName,
     description: cmd.description(),
+    ...cost ? { cost } : {},
     parameters: {
       type: "object",
       properties,

package/package.json

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