@vibeframe/cli 0.102.0 → 0.103.1

package/CONTEXT.md

@@ -40,10 +40,10 @@ vibe guide <topic> --json              # Step-by-step guides (motion | scene | p
 
 | Tier      | Commands                                                                                                                        | Per-call cost |
 | --------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------- |
-| Free      | `detect *`, `edit silence-cut/fade/noise-reduce/text-overlay/interpolate`, `timeline *`, `scene lint/list-styles`, `audio duck` | $0            |
-| Low       | `inspect *`, `audio transcribe/list-voices`, `generate image`                                                                   | $0.01–0.10    |
-| High      | `generate video`, `edit image`, `edit grade/reframe/speed-ramp`                                                                 | $1–5          |
-| Very High | `remix *` (highlights, auto-shorts, regenerate-scene), `vibe build` (full pipeline)                                             | $5–50+        |
+| Free      | `schema/context/doctor`, `detect *`, `status *`, `plan`, `storyboard validate`, `inspect project/render --cheap`, deterministic edits | $0            |
+| Low       | `generate narration/sound-effect/music`, `audio transcribe/list-voices`, `inspect media`, optional AI review                         | $0.01–0.10    |
+| High      | `generate image/motion`, `edit image/reframe/grade/speed-ramp`                                                                       | $1–5          |
+| Very High | `generate video`, `edit fill-gaps`, `remix highlights/auto-shorts`, `build` with generated assets                                      | $5–50+        |
 
 > Rule: **confirm with the user before any High / Very-High call**.
 

package/dist/index.js

@@ -25732,6 +25732,7 @@ __export(config_exports, {
   USER_CONFIG_DIR: () => USER_CONFIG_DIR,
   USER_CONFIG_PATH: () => USER_CONFIG_PATH,
   createDefaultConfig: () => createDefaultConfig,
+  findProjectConfigPath: () => findProjectConfigPath,
   getActiveScope: () => getActiveScope,
   getApiKeyFromConfig: () => getApiKeyFromConfig,
   getConfigDir: () => getConfigDir,
@@ -26461,9 +26462,14 @@ End on the product name, offer, or command. Avoid adding a new idea in the
 final beat.
 `;
 }
-function buildProjectClaudeMd(name) {
+function buildProjectAgentsMd(name) {
   return `# ${name} \u2014 Scene Authoring Project
 
+This is the canonical cross-agent guidance file for this scene project.
+Claude Code imports it through \`CLAUDE.md\`; Codex, Cursor, Aider,
+Gemini CLI, OpenCode, and other bash-capable agents should read it
+directly.
+
 This project is **bilingual**: it works with both VibeFrame (\`vibe\`) and
 HeyGen Hyperframes (\`hyperframes\`). You can run either CLI inside this
 directory.
@@ -26503,6 +26509,8 @@ Browse named styles: \`vibe scene list-styles\`. Re-seed from one with
 
 ## Skills \u2014 USE THESE FIRST
 
+@SKILL.md
+
 **Always invoke the relevant skill before authoring scenes.** Skills encode
 framework-specific patterns (GSAP timeline registration, data-attribute
 semantics, VibeFrame pipeline conventions) that are NOT in generic web docs.
@@ -26571,6 +26579,17 @@ vibe scene lint --json    # structured output for agent loops
 \`\`\`
 `;
 }
+function buildProjectClaudeMd(name) {
+  return `@AGENTS.md
+
+# ${name} \u2014 Claude Code Overrides
+
+This file imports \`AGENTS.md\`; keep cross-agent VibeFrame and
+Hyperframes instructions there so Codex, Cursor, Aider, Gemini CLI, and
+OpenCode see the same project rules. Add Claude-Code-specific notes below
+only when this project needs them.
+`;
+}
 function buildSceneGitignore() {
   return `# VibeFrame \u2014 caches, checkpoints, and project-scope config.yaml (may contain API keys)
 .vibeframe/
@@ -26613,6 +26632,7 @@ function describeSceneScaffold(opts) {
   }
   if (profile === "agent" || profile === "full") {
     groups.agent = [
+      resolve7(dir, "AGENTS.md"),
       resolve7(dir, "SKILL.md"),
       resolve7(dir, "references"),
       resolve7(dir, "CLAUDE.md")
@@ -26692,9 +26712,24 @@ async function scaffoldSceneProject(opts) {
     created.push(vibePath);
   }
   if (profile === "agent" || profile === "full") {
+    const agentsPath = resolve7(dir, "AGENTS.md");
+    if (await pathExists(agentsPath)) {
+      skipped2.push(agentsPath);
+    } else {
+      await writeFile4(agentsPath, buildProjectAgentsMd(name), "utf-8");
+      created.push(agentsPath);
+    }
     const claudePath = resolve7(dir, "CLAUDE.md");
     if (await pathExists(claudePath)) {
-      skipped2.push(claudePath);
+      const existing = await readFile5(claudePath, "utf-8");
+      if (existing.includes("@AGENTS.md")) {
+        skipped2.push(claudePath);
+      } else {
+        await writeFile4(claudePath, `@AGENTS.md
+
+${existing}`, "utf-8");
+        merged.push(claudePath);
+      }
     } else {
       await writeFile4(claudePath, buildProjectClaudeMd(name), "utf-8");
       created.push(claudePath);
@@ -32543,22 +32578,35 @@ function applySuggestion(project, suggestion) {
   if (clipIds.length === 0) return false;
   const clipId = clipIds[0];
   switch (type) {
-    case "trim":
-      if (params.newDuration) {
-        return project.trimClipEnd(clipId, params.newDuration);
+    case "trim": {
+      const newDuration = params.newDuration;
+      if (typeof newDuration === "number") {
+        return project.trimClipEnd(clipId, newDuration);
       }
       break;
-    case "add-effect":
-      if (params.effectType) {
+    }
+    case "add-effect": {
+      const effectType = params.effectType;
+      if (typeof effectType === "string") {
+        const startTime = typeof params.startTime === "number" ? params.startTime : 0;
+        const duration = typeof params.duration === "number" ? params.duration : 1;
+        const rawEffectParams = params.effectParams && typeof params.effectParams === "object" ? params.effectParams : {};
+        const effectParams = {};
+        for (const [k, v] of Object.entries(rawEffectParams)) {
+          if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+            effectParams[k] = v;
+          }
+        }
         const effect = project.addEffect(clipId, {
-          type: params.effectType,
-          startTime: params.startTime || 0,
-          duration: params.duration || 1,
-          params: params.effectParams || {}
+          type: effectType,
+          startTime,
+          duration,
+          params: effectParams
         });
         return effect !== null;
       }
       break;
+    }
     case "delete":
       return project.removeClip(clipId);
   }
@@ -32763,6 +32811,19 @@ var init_open_url = __esm({
 // src/utils/tty.ts
 import { createInterface as createInterface2 } from "node:readline";
 import { ReadStream } from "node:tty";
+function stripAnsi2(value) {
+  return value.replace(ANSI_RE, "");
+}
+function terminalColumns() {
+  return process.stdout.columns && process.stdout.columns > 0 ? process.stdout.columns : 80;
+}
+function fitOptionToLine(value, prefixColumns) {
+  const maxColumns = Math.max(8, terminalColumns() - prefixColumns - 1);
+  const visible = stripAnsi2(value);
+  if (visible.length <= maxColumns) return value;
+  if (maxColumns <= ELLIPSIS.length) return ELLIPSIS.slice(0, maxColumns);
+  return `${visible.slice(0, maxColumns - ELLIPSIS.length)}${ELLIPSIS}`;
+}
 function splitTTYInput(chunk) {
   const tokens = [];
   for (let i = 0; i < chunk.length; i++) {
@@ -32883,7 +32944,8 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
         }
         for (let i = 0; i < options.length; i++) {
           const marker = i === selected ? "\x1B[36m\u276F\x1B[0m" : " ";
-          const text = i === selected ? `\x1B[1m${options[i]}\x1B[0m` : options[i];
+          const optionText = fitOptionToLine(options[i], 5);
+          const text = i === selected ? `\x1B[1m${optionText}\x1B[0m` : optionText;
           process.stdout.write(`\x1B[2K   ${marker} ${text}
 `);
         }
@@ -32962,7 +33024,8 @@ async function promptConfirm(question, defaultYes = true) {
         }
         for (let i = 0; i < options.length; i++) {
           const marker = i === selected ? "\x1B[36m\u276F\x1B[0m" : " ";
-          const text = i === selected ? `\x1B[1m${options[i]}\x1B[0m` : options[i];
+          const optionText = fitOptionToLine(options[i], 5);
+          const text = i === selected ? `\x1B[1m${optionText}\x1B[0m` : optionText;
           process.stdout.write(`\x1B[2K   ${marker} ${text}
 `);
         }
@@ -33030,7 +33093,8 @@ async function promptMultiSelect(_question, options, defaultSelected = [], opts
         for (let i = 0; i < options.length; i++) {
           const pointer = i === cursor ? "\x1B[36m\u276F\x1B[0m" : " ";
           const box = selected[i] ? "\x1B[36m[x]\x1B[0m" : "[ ]";
-          const text = i === cursor ? `\x1B[1m${options[i]}\x1B[0m` : options[i];
+          const optionText = fitOptionToLine(options[i], 9);
+          const text = i === cursor ? `\x1B[1m${optionText}\x1B[0m` : optionText;
           process.stdout.write(`\x1B[2K   ${pointer} ${box} ${text}
 `);
         }
@@ -33122,12 +33186,14 @@ async function promptMultiSelect(_question, options, defaultSelected = [], opts
   }
   return [...picked].sort((a, b) => a - b);
 }
-var ttyStream;
+var ttyStream, ANSI_RE, ELLIPSIS;
 var init_tty = __esm({
   "src/utils/tty.ts"() {
     "use strict";
     init_open_url();
     ttyStream = null;
+    ANSI_RE = new RegExp(`${String.fromCharCode(27)}\\[[0-?]*[ -/]*[@-~]`, "g");
+    ELLIPSIS = "...";
   }
 });
 
@@ -34891,6 +34957,7 @@ function isActiveStatus(status) {
 }
 function providerStatusCommand(record) {
   if (record.jobType === "generate-video") {
+    if (record.provider !== "runway" && record.provider !== "kling") return void 0;
     const type = record.provider === "kling" && record.providerTaskType ? ` --type ${record.providerTaskType}` : "";
     return `vibe generate video-status ${record.providerTaskId} -p ${record.provider}${type} --json`;
   }
@@ -58194,9 +58261,22 @@ function backdropCacheDescriptor(opts) {
     provider: opts.provider,
     quality: opts.quality,
     size: opts.size,
+    ratio: opts.ratio,
     ext: "png"
   });
 }
+function imageRatioForSize(size) {
+  switch (size) {
+    case "1024x1024":
+      return "1:1";
+    case "1024x1536":
+      return "2:3";
+    case "1536x1024":
+      return "3:2";
+    default:
+      return "16:9";
+  }
+}
 function videoCacheDescriptor(opts) {
   return cacheAssetDescriptor("video", {
     beatId: opts.beatId,
@@ -58274,6 +58354,7 @@ async function createBuildPlan(opts) {
   }
   const storyboardMd = await readFile40(storyboardPath2, "utf-8");
   const validation = validateStoryboardMarkdown(storyboardMd);
+  const validationIssues = [...validation.issues];
   const parsed = parseStoryboard(storyboardMd);
   let sourceBeats = parsed.beats;
   if (opts.beat) {
@@ -58296,6 +58377,7 @@ async function createBuildPlan(opts) {
   const mode = opts.mode ?? config2.config.build.mode;
   const imageQuality = opts.imageQuality ?? config2.config.build.imageQuality ?? "hd";
   const imageSize2 = opts.imageSize ?? config2.config.build.imageSize ?? "1536x1024";
+  const imageRatio = imageRatioForSize(imageSize2);
   const needsComposer = includeCompose && mode !== "agent" && sourceBeats.some((beat) => !existsSync44(join20(projectDir, `compositions/scene-${beat.id}.html`)));
   const resolved = await resolvePlanProviders({
     projectDir,
@@ -58345,7 +58427,8 @@ async function createBuildPlan(opts) {
       cue: backdropPrompt,
       provider: resolved.image.resolved,
       quality: imageQuality,
-      size: imageSize2
+      size: imageSize2,
+      ratio: imageRatio
     }) : null;
     const videoCache = videoPrompt && !videoReference ? videoCacheDescriptor({
       beatId: beat.id,
@@ -58439,7 +58522,8 @@ async function createBuildPlan(opts) {
       }
     }
     if (narration?.willGenerate) noteProviderNeed(resolved.narration, "Narration");
-    if (backdrop?.willGenerate) noteProviderNeed(resolved.image, "Backdrop generation");
+    if (backdrop?.willGenerate && isSupportedBuildImageProvider(resolved.image.resolved))
+      noteProviderNeed(resolved.image, "Backdrop generation");
     if (video?.willGenerate) noteProviderNeed(resolved.video, "Video generation");
     if (music?.willGenerate) noteProviderNeed(resolved.music, "Music generation");
     if (!compositionExists) missing.add("compositions");
@@ -58461,23 +58545,35 @@ async function createBuildPlan(opts) {
     };
   });
   providerResolution.push(...providerResolutionsForPlan(resolved, beats, opts, includeAssets));
+  if (includeAssets && !opts.skipBackdrop && !isSupportedBuildImageProvider(resolved.image.resolved)) {
+    const unsupportedBackdropBeats = beats.filter(
+      (beat) => isBuildGeneratedBackdropPlan(beat.assets.backdrop)
+    );
+    for (const beat of unsupportedBackdropBeats) {
+      validationIssues.push({
+        severity: "error",
+        code: "UNSUPPORTED_BUILD_IMAGE_PROVIDER",
+        beatId: beat.id,
+        message: `Build backdrop generation supports openai, gemini, and grok. Beat "${beat.id}" resolves image provider "${resolved.image.resolved}"; rerun with one of those or replace the backdrop cue with a project asset path.`
+      });
+    }
+    if (unsupportedBackdropBeats.length > 0) {
+      const beatFlag = opts.beat ? ` --beat ${opts.beat}` : "";
+      retryWith.push(
+        `vibe build ${projectDir}${beatFlag} --stage assets --image-provider openai --json`
+      );
+    }
+  }
+  const validationOk = !validationIssues.some((issue) => issue.severity === "error");
   if (!existsSync44(join20(projectDir, config2.config.composition.entry))) {
     missing.add("root-composition");
-    if (validation.ok) retryWith.push(`vibe build ${projectDir} --stage sync --json`);
+    if (validationOk) retryWith.push(`vibe build ${projectDir} --stage sync --json`);
   }
   if (config2.legacy) {
     warnings.push(
       `Using legacy ${config2.source}; write ${projectDir}/vibe.config.json to use the TO-BE project contract.`
     );
   }
-  if (resolved.image.resolved !== "openai" && beats.some((beat) => {
-    const backdrop = beat.assets.backdrop;
-    return backdrop && !["referenced-asset", "invalid-reference", "stage-skipped"].includes(backdrop.reason);
-  }) && !opts.skipBackdrop) {
-    warnings.push(
-      `Image provider "${resolved.image.resolved}" is not supported by build assets yet; use --image-provider openai.`
-    );
-  }
   if (!validation.ok) {
     retryWith.push(
       `vibe storyboard validate ${projectDir} --json`,
@@ -58488,7 +58584,7 @@ async function createBuildPlan(opts) {
     projectDir,
     config: config2,
     stage,
-    status: validation.ok ? "ready" : "invalid",
+    status: validationOk ? "ready" : "invalid",
     currentStage: stage,
     mode,
     beat: opts.beat ?? null,
@@ -58500,8 +58596,8 @@ async function createBuildPlan(opts) {
     warnings,
     retryWith,
     validation: {
-      ok: validation.ok,
-      issues: validation.issues
+      ok: validationOk,
+      issues: validationIssues
     }
   });
 }
@@ -58528,6 +58624,15 @@ function finalizeBuildPlan(plan) {
     retryWith: unique3(plan.retryWith)
   };
 }
+function isBuildGeneratedBackdropPlan(asset) {
+  if (!asset || asset.kind !== "backdrop") return false;
+  return !["referenced-asset", "invalid-reference", "stage-skipped"].includes(asset.reason);
+}
+function isSupportedBuildImageProvider(provider) {
+  return SUPPORTED_BUILD_IMAGE_PROVIDERS.includes(
+    provider
+  );
+}
 function nextCommandsForPlan(plan) {
   if (plan.status === "invalid") return unique3(plan.retryWith);
   const commands = [];
@@ -58827,7 +58932,7 @@ function loadPlanEnv(projectDir) {
     dir = dirname19(dir);
   }
 }
-var import_dotenv3, BACKDROP_COST_USD, VIDEO_COST_USD, MUSIC_COST_USD, ELEVENLABS_NARRATION_COST_USD, COMPOSE_COST_USD;
+var import_dotenv3, BACKDROP_COST_USD, VIDEO_COST_USD, MUSIC_COST_USD, ELEVENLABS_NARRATION_COST_USD, COMPOSE_COST_USD, SUPPORTED_BUILD_IMAGE_PROVIDERS;
 var init_build_plan = __esm({
   "src/commands/_shared/build-plan.ts"() {
     "use strict";
@@ -58846,6 +58951,7 @@ var init_build_plan = __esm({
     MUSIC_COST_USD = 0.5;
     ELEVENLABS_NARRATION_COST_USD = 0.05;
     COMPOSE_COST_USD = 0.06;
+    SUPPORTED_BUILD_IMAGE_PROVIDERS = ["openai", "gemini", "grok"];
   }
 });
 
@@ -60252,19 +60358,18 @@ async function dispatchBackdrop(beat, ctx) {
   if (reference) return referencePrimitiveOutcome("backdrop", beat, ctx, reference);
   const prompt3 = stringOrUndefined4(beat.cues?.backdrop);
   if (!prompt3) return { status: "no-cue" };
-  if (ctx.imageProvider !== "openai") {
-    const error = `image provider "${ctx.imageProvider}" not yet supported (use openai)`;
-    ctx.onProgress({ type: "backdrop-failed", beatId: beat.id, error });
-    return { status: "failed", error };
-  }
   const rel = `assets/backdrop-${beat.id}.png`;
   const abs = join22(ctx.projectDir, rel);
+  const size = ctx.imageSize ?? "1536x1024";
+  const ratio = imageRatioForSize(size);
+  const metadataOptions = { quality: ctx.imageQuality, size, ratio };
   const cache = backdropCacheDescriptor({
     beatId: beat.id,
     cue: prompt3,
     provider: ctx.imageProvider,
     quality: ctx.imageQuality,
-    size: ctx.imageSize ?? "1536x1024"
+    size,
+    ratio
   });
   const metadataPath = assetMetadataPath("backdrop", beat.id);
   if (existsSync46(abs) && !ctx.force) {
@@ -60275,7 +60380,7 @@ async function dispatchBackdrop(beat, ctx) {
       beatId: beat.id,
       cue: prompt3,
       provider: ctx.imageProvider,
-      options: { quality: ctx.imageQuality, size: ctx.imageSize ?? "1536x1024" },
+      options: metadataOptions,
       cacheKey: cache.key
     })) {
       ctx.onProgress({ type: "backdrop-cached", beatId: beat.id, path: rel });
@@ -60300,7 +60405,7 @@ async function dispatchBackdrop(beat, ctx) {
       beatId: beat.id,
       cue: prompt3,
       provider: ctx.imageProvider,
-      options: { quality: ctx.imageQuality, size: ctx.imageSize ?? "1536x1024" },
+      options: metadataOptions,
       cacheKey: cache.key,
       canonicalPath: rel,
       cachePath: cache.path
@@ -60316,27 +60421,14 @@ async function dispatchBackdrop(beat, ctx) {
       freshness: "fresh"
     };
   }
-  loadSceneBuildEnv(ctx.projectDir);
-  const apiKey = await getApiKeyFromConfig("openai", { cwd: ctx.projectDir }) ?? process.env.OPENAI_API_KEY ?? "";
-  if (!apiKey) {
-    const error = "OPENAI_API_KEY not set \u2014 cannot dispatch backdrop";
-    ctx.onProgress({ type: "backdrop-failed", beatId: beat.id, error });
-    return { status: "failed", error };
-  }
-  const provider = new OpenAIImageProvider();
-  await provider.initialize({ apiKey });
-  const result = await provider.generateImage(prompt3, {
-    model: "gpt-image-2",
-    size: ctx.imageSize,
-    quality: ctx.imageQuality
-  });
-  if (!result.success || !result.images?.[0]?.base64) {
-    const error = result.error ?? "no image data returned";
+  const generated = await generateBackdropImage(prompt3, ctx, ratio);
+  if (!generated.success) {
+    const error = generated.error;
     ctx.onProgress({ type: "backdrop-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
   await mkdir24(dirname22(abs), { recursive: true });
-  const buffer = Buffer.from(result.images[0].base64, "base64");
+  const buffer = generated.buffer;
   await writeFile48(abs, buffer);
   await mkdir24(dirname22(cacheAbs), { recursive: true });
   await writeFile48(cacheAbs, buffer);
@@ -60345,8 +60437,8 @@ async function dispatchBackdrop(beat, ctx) {
     kind: "backdrop",
     beatId: beat.id,
     cue: prompt3,
-    provider: "openai",
-    options: { quality: ctx.imageQuality, size: ctx.imageSize ?? "1536x1024" },
+    provider: ctx.imageProvider,
+    options: metadataOptions,
     cacheKey: cache.key,
     canonicalPath: rel,
     cachePath: cache.path
@@ -60355,18 +60447,75 @@ async function dispatchBackdrop(beat, ctx) {
     type: "backdrop-generated",
     beatId: beat.id,
     path: rel,
-    provider: "openai"
+    provider: ctx.imageProvider
   });
   return {
     status: "generated",
     path: rel,
-    provider: "openai",
+    provider: ctx.imageProvider,
     cachePath: cache.path,
     cacheKey: cache.key,
     metadataPath,
     freshness: "fresh"
   };
 }
+async function generateBackdropImage(prompt3, ctx, ratio) {
+  loadSceneBuildEnv(ctx.projectDir);
+  const keyInfo = imageProviderKeyInfo(ctx.imageProvider);
+  const apiKey = await getApiKeyFromConfig(keyInfo.configKey, { cwd: ctx.projectDir }) ?? process.env[keyInfo.envVar] ?? "";
+  if (!apiKey) {
+    return {
+      success: false,
+      error: `${keyInfo.envVar} not set \u2014 cannot dispatch backdrop with ${ctx.imageProvider}`
+    };
+  }
+  if (ctx.imageProvider === "openai") {
+    const provider2 = new OpenAIImageProvider();
+    await provider2.initialize({ apiKey });
+    const result2 = await provider2.generateImage(prompt3, {
+      model: "gpt-image-2",
+      size: ctx.imageSize,
+      quality: ctx.imageQuality
+    });
+    return imageBufferFromResult(result2);
+  }
+  if (ctx.imageProvider === "gemini") {
+    const provider2 = new GeminiProvider();
+    await provider2.initialize({ apiKey });
+    const result2 = await provider2.generateImage(prompt3, {
+      model: "flash",
+      aspectRatio: ratio
+    });
+    return imageBufferFromResult(result2);
+  }
+  const provider = new GrokProvider();
+  await provider.initialize({ apiKey });
+  const result = await provider.generateImage(prompt3, {
+    aspectRatio: ratio,
+    n: 1
+  });
+  return imageBufferFromResult(result);
+}
+async function imageBufferFromResult(result) {
+  const image = result.images?.[0];
+  if (!result.success || !image) {
+    return { success: false, error: result.error ?? "no image data returned" };
+  }
+  if (image.base64) return { success: true, buffer: Buffer.from(image.base64, "base64") };
+  if (image.url) {
+    const response = await fetch(image.url);
+    if (!response.ok) {
+      return { success: false, error: `failed to download image: HTTP ${response.status}` };
+    }
+    return { success: true, buffer: Buffer.from(await response.arrayBuffer()) };
+  }
+  return { success: false, error: "no image data returned" };
+}
+function imageProviderKeyInfo(provider) {
+  if (provider === "gemini") return { configKey: "google", envVar: "GOOGLE_API_KEY" };
+  if (provider === "grok") return { configKey: "xai", envVar: "XAI_API_KEY" };
+  return { configKey: "openai", envVar: "OPENAI_API_KEY" };
+}
 async function dispatchVideo(beat, ctx) {
   const reference = assetReferenceForBeat(ctx.projectDir, "video", beat);
   if (reference) return referencePrimitiveOutcome("video", beat, ctx, reference);
@@ -61265,14 +61414,14 @@ __export(ai_audio_exports, {
 });
 import { resolve as resolve69, dirname as dirname24, basename as basename22, extname as extname15 } from "node:path";
 import { readFile as readFile45, writeFile as writeFile49 } from "node:fs/promises";
-import { existsSync as existsSync50 } from "node:fs";
+import { existsSync as existsSync51 } from "node:fs";
 async function executeTranscribe(options) {
   const { audioPath, language, output, format, apiKey } = options;
   try {
     const key = apiKey || process.env.OPENAI_API_KEY;
     if (!key) return { success: false, error: "OPENAI_API_KEY required" };
     const absPath = resolve69(process.cwd(), audioPath);
-    if (!existsSync50(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync51(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: key });
     const audioBuffer = await readFile45(absPath);
@@ -61305,7 +61454,7 @@ async function executeIsolate(options) {
     const key = apiKey || process.env.ELEVENLABS_API_KEY;
     if (!key) return { success: false, error: "ELEVENLABS_API_KEY required" };
     const absPath = resolve69(process.cwd(), audioPath);
-    if (!existsSync50(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync51(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const audioBuffer = await readFile45(absPath);
     const elevenlabs = new ElevenLabsProvider();
     await elevenlabs.initialize({ apiKey: key });
@@ -61331,7 +61480,7 @@ async function executeVoiceClone(options) {
     const audioBuffers = [];
     for (const samplePath of samplePaths) {
       const absPath = resolve69(process.cwd(), samplePath);
-      if (!existsSync50(absPath)) return { success: false, error: `File not found: ${samplePath}` };
+      if (!existsSync51(absPath)) return { success: false, error: `File not found: ${samplePath}` };
       const buffer = await readFile45(absPath);
       audioBuffers.push(buffer);
     }
@@ -61353,7 +61502,7 @@ async function executeDub(options) {
   const { mediaPath, language, source, voice, analyzeOnly, output } = options;
   try {
     const absPath = resolve69(process.cwd(), mediaPath);
-    if (!existsSync50(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync51(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const openaiKey = process.env.OPENAI_API_KEY;
     const anthropicKey = process.env.ANTHROPIC_API_KEY;
     const elevenlabsKey = process.env.ELEVENLABS_API_KEY;
@@ -61481,8 +61630,8 @@ async function executeDuck(options) {
     if (!commandExists("ffmpeg")) return { success: false, error: "FFmpeg not found" };
     const absMusicPath = resolve69(process.cwd(), musicPath);
     const absVoicePath = resolve69(process.cwd(), voicePath);
-    if (!existsSync50(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
-    if (!existsSync50(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
+    if (!existsSync51(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
+    if (!existsSync51(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
     const defaultOutput = resolve69(dirname24(absMusicPath), `${basename22(absMusicPath, extname15(absMusicPath))}-ducked${extname15(absMusicPath)}`);
     const outputPath = resolve69(process.cwd(), output || defaultOutput);
     const filter = `[1:a]asplit=2[sc][mix];[0:a][sc]sidechaincompress=threshold=${threshold}dB:ratio=${ratio}:attack=${attack}:release=${release}[ducked];[ducked][mix]amix=inputs=2:duration=longest`;
@@ -61496,7 +61645,7 @@ async function executeDuck(options) {
       "-y",
       outputPath
     ], { timeout: 12e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync50(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
+    if (!existsSync51(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
     return { success: true, outputPath };
   } catch (error) {
     return { success: false, error: `Audio ducking failed: ${error instanceof Error ? error.message : String(error)}` };
@@ -61514,7 +61663,7 @@ var init_ai_audio = __esm({
 // src/pipeline/executor.ts
 import { resolve as resolve70 } from "node:path";
 import { readFile as readFile46, writeFile as writeFile50, mkdir as mkdir26 } from "node:fs/promises";
-import { existsSync as existsSync51 } from "node:fs";
+import { existsSync as existsSync52 } from "node:fs";
 function maxCostFor(action) {
   const cmd = ACTION_METADATA[action]?.command;
   if (!cmd) return 0;
@@ -61829,7 +61978,7 @@ async function ensureActionsRegistered() {
 }
 async function loadPipeline(filePath) {
   const absPath = resolve70(process.cwd(), filePath);
-  if (!existsSync51(absPath)) {
+  if (!existsSync52(absPath)) {
     throw new Error(`Pipeline file not found: ${absPath}`);
   }
   const content = await readFile46(absPath, "utf-8");
@@ -61854,7 +62003,7 @@ async function executePipeline(manifest2, options = {}) {
   const startTime = Date.now();
   if (options.resume) {
     const checkpointPath = resolve70(outputDir, CHECKPOINT_FILE);
-    if (existsSync51(checkpointPath)) {
+    if (existsSync52(checkpointPath)) {
       const checkpointContent = await readFile46(checkpointPath, "utf-8");
       const checkpoint = (0, import_yaml8.parse)(checkpointContent);
       for (const cs of checkpoint.completedSteps) {
@@ -67398,7 +67547,10 @@ async function executeSuggestEdit(options) {
     }
     return { success: true, suggestions };
   } catch (error) {
-    return { success: false, error: `Suggest failed: ${error instanceof Error ? error.message : String(error)}` };
+    return {
+      success: false,
+      error: `Suggest failed: ${error instanceof Error ? error.message : String(error)}`
+    };
   }
 }
 var init_ai_suggest_edit = __esm({
@@ -68078,12 +68230,12 @@ var init_generate2 = __esm({
 });
 
 // src/tools/manifest/storyboard.ts
-import { existsSync as existsSync52 } from "node:fs";
+import { existsSync as existsSync53 } from "node:fs";
 import { readFile as readFile48, writeFile as writeFile52 } from "node:fs/promises";
 import { resolve as resolve74 } from "node:path";
 async function readStoryboard2(projectDir) {
   const path2 = resolve74(projectDir, "STORYBOARD.md");
-  if (!existsSync52(path2)) return null;
+  if (!existsSync53(path2)) return null;
   return { path: path2, markdown: await readFile48(path2, "utf-8") };
 }
 var projectDirSchema, storyboardListTool, storyboardValidateTool, storyboardGetTool, storyboardSetTool, storyboardMoveTool, storyboardReviseTool, planTool, storyboardTools;
@@ -71173,7 +71325,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.102.0",
+  version: "0.103.1",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -71620,7 +71772,9 @@ init_project_resolver();
 import { readFile as readFile12, writeFile as writeFile12 } from "node:fs/promises";
 import { existsSync as existsSync10 } from "node:fs";
 import { resolve as resolve16, basename as basename3, extname } from "node:path";
-var timelineCommand = new Command("timeline").description("Low-level timeline JSON commands").addHelpText("after", `
+var timelineCommand = new Command("timeline").description("Low-level timeline JSON commands").addHelpText(
+  "after",
+  `
 Examples:
   $ vibe timeline create my-video                               # my-video/timeline.json
   $ vibe timeline add-source my-video video.mp4                 # Returns source ID
@@ -71632,7 +71786,8 @@ Examples:
 
 Typical workflow: create \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.`);
+Run 'vibe schema timeline.<command>' for structured parameter info.`
+);
 timelineCommand.command("create").description("Create a low-level timeline JSON file").argument("<name>", "Timeline name or path (e.g., 'my-video' or 'output/my-video')").option("-o, --output <path>", "Output file path (overrides name-based path)").option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:5)", "16:9").option("--fps <fps>", "Frame rate", "30").option("--dry-run", "Preview parameters without executing").action(async (name, options) => {
   await executeTimelineCreate(name, options, "timeline create", Date.now());
 });
@@ -71843,7 +71998,10 @@ timelineCommand.command("add-track").description("Add a new track").argument("<p
     exitWithError(generalError(`Failed to add track: ${msg}`));
   }
 });
-timelineCommand.command("add-effect").description("Add an effect to a clip").argument("<project>", "Timeline file or directory").argument("<clip-id>", "Clip ID").argument("<effect-type>", "Effect type (fadeIn, fadeOut, blur, brightness, contrast, saturation, speed, volume)").option("--start <seconds>", "Effect start time (relative to clip)", "0").option("-d, --duration <seconds>", "Effect duration (defaults to clip duration)").option("--params <json>", "Effect parameters as JSON", "{}").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, effectType, options) => {
+timelineCommand.command("add-effect").description("Add an effect to a clip").argument("<project>", "Timeline file or directory").argument("<clip-id>", "Clip ID").argument(
+  "<effect-type>",
+  "Effect type (fadeIn, fadeOut, blur, brightness, contrast, saturation, speed, volume)"
+).option("--start <seconds>", "Effect start time (relative to clip)", "0").option("-d, --duration <seconds>", "Effect duration (defaults to clip duration)").option("--params <json>", "Effect parameters as JSON", "{}").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, effectType, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Adding effect...").start();
   try {
@@ -72067,7 +72225,9 @@ timelineCommand.command("list").description("List timeline contents").argument("
         for (const clip of clips) {
           const source = project.getSource(clip.sourceId);
           console.log(`  ${source_default.yellow(clip.id)}`);
-          console.log(`    ${source?.name || "unknown"} @ ${clip.startTime}s (${clip.duration}s)`);
+          console.log(
+            `    ${source?.name || "unknown"} @ ${clip.startTime}s (${clip.duration}s)`
+          );
           if (clip.effects.length > 0) {
             console.log(`    Effects: ${clip.effects.map((e) => e.type).join(", ")}`);
           }
@@ -72327,10 +72487,10 @@ function detectMediaType(path2) {
   return "video";
 }
 applyTiers(timelineCommand, {
-  "create": "free",
-  "info": "free",
-  "set": "free",
-  "list": "free",
+  create: "free",
+  info: "free",
+  set: "free",
+  list: "free",
   "add-source": "free",
   "add-clip": "free",
   "add-track": "free",
@@ -79933,7 +80093,7 @@ starting from a media file and wants it transformed, it's REMIX.
 | 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\` |
-| Inspect a video | \`vibe inspect video file.mp4 "summarise"\` |
+| Inspect media with Gemini | \`vibe inspect media file.mp4 "summarise" --json\` |
 
 ### Compose pipelines (Video as Code)
 
@@ -79946,10 +80106,10 @@ starting from a media file and wants it transformed, it's REMIX.
 
 | Tier | Examples | Approx. per call |
 |---|---|---|
-| **Free** | \`detect *\`, \`edit silence-cut/fade/noise-reduce\`, \`schema\`, \`project\`, \`timeline\` | $0 |
-| **Low** | \`inspect *\`, \`audio transcribe\`, \`generate image\` | $0.01\u2013$0.10 |
-| **High** | \`generate video\`, \`edit image\` | $1\u2013$5 |
-| **Very High** | \`remix *\` (highlights, auto-shorts, regenerate-scene), \`build\` | $5\u2013$50+ |
+| **Free** | \`schema/context/doctor\`, \`detect *\`, \`status *\`, \`plan\`, \`storyboard validate\`, \`inspect project/render --cheap\`, deterministic edits | $0 |
+| **Low** | \`generate narration/sound-effect/music\`, \`audio transcribe\`, \`inspect media\`, optional AI review | $0.01\u2013$0.10 |
+| **High** | \`generate image/motion\`, \`edit image/reframe/grade/speed-ramp\` | $1\u2013$5 |
+| **Very High** | \`generate video\`, \`edit fill-gaps\`, \`remix highlights/auto-shorts\`, \`build\` with generated assets | $5\u2013$50+ |
 
 ## Agent invariants
 
@@ -80122,7 +80282,7 @@ defaults:
 # Optional \u2014 uncomment to set per-primitive provider preferences.
 # providers:
 #   tts: elevenlabs       # auto | elevenlabs | kokoro
-#   image: openai         # openai | gemini
+#   image: openai         # openai | gemini | grok
 #   music: elevenlabs
 
 # Optional \u2014 cap total spend per pipeline run.
@@ -80735,11 +80895,12 @@ import { resolve as resolve58 } from "node:path";
 var VALID_STAGES = ["assets", "compose", "sync", "render", "all"];
 var VALID_MODES = ["agent", "batch", "auto"];
 var VALID_TTS_PROVIDERS = ["auto", "elevenlabs", "kokoro"];
+var VALID_IMAGE_PROVIDERS = ["openai", "gemini", "grok"];
 var VALID_VIDEO_PROVIDERS = ["seedance", "grok", "kling", "runway", "veo"];
 var VALID_MUSIC_PROVIDERS = ["elevenlabs", "replicate"];
 var VALID_COMPOSERS = ["claude", "openai", "gemini"];
 var VALID_IMAGE_QUALITIES = ["standard", "hd"];
-var planCommand = new Command("plan").description("Read STORYBOARD.md and show build plan, costs, missing cues, and provider needs").argument("[project-dir]", "Video project directory", ".").option("--stage <stage>", `Stage to plan: ${VALID_STAGES.join("|")}`, "all").option("--beat <id>", "Restrict the plan to one beat").option("--mode <mode>", "Build mode: agent|batch|auto", "auto").option("--skip-narration", "Don't include narration generation in the plan").option("--skip-backdrop", "Don't include backdrop image generation in the plan").option("--skip-video", "Don't include video generation in the plan").option("--skip-music", "Don't include music generation in the plan").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro").option("--voice <id>", "Voice id").option("--image-provider <name>", "Image provider: openai").option("--video-provider <name>", `Video provider: ${VALID_VIDEO_PROVIDERS.join("|")}`).option("--music-provider <name>", `Music provider: ${VALID_MUSIC_PROVIDERS.join("|")}`).option("--quality <q>", "Image quality: standard|hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536").option("--composer <provider>", "Batch composer: claude|openai|gemini").option("--force", "Plan regeneration even when outputs already exist").option("--max-cost <usd>", "Fail if estimated cost exceeds this USD cap").action(async (projectDirArg, options) => {
+var planCommand = new Command("plan").description("Read STORYBOARD.md and show build plan, costs, missing cues, and provider needs").argument("[project-dir]", "Video project directory", ".").option("--stage <stage>", `Stage to plan: ${VALID_STAGES.join("|")}`, "all").option("--beat <id>", "Restrict the plan to one beat").option("--mode <mode>", "Build mode: agent|batch|auto", "auto").option("--skip-narration", "Don't include narration generation in the plan").option("--skip-backdrop", "Don't include backdrop image generation in the plan").option("--skip-video", "Don't include video generation in the plan").option("--skip-music", "Don't include music generation in the plan").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro").option("--voice <id>", "Voice id").option("--image-provider <name>", `Image provider: ${VALID_IMAGE_PROVIDERS.join("|")}`).option("--video-provider <name>", `Video provider: ${VALID_VIDEO_PROVIDERS.join("|")}`).option("--music-provider <name>", `Music provider: ${VALID_MUSIC_PROVIDERS.join("|")}`).option("--quality <q>", "Image quality: standard|hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536").option("--composer <provider>", "Batch composer: claude|openai|gemini").option("--force", "Plan regeneration even when outputs already exist").option("--max-cost <usd>", "Fail if estimated cost exceeds this USD cap").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
   const stage = String(options.stage ?? "all");
   if (!VALID_STAGES.includes(stage)) {
@@ -80762,6 +80923,11 @@ var planCommand = new Command("plan").description("Read STORYBOARD.md and show b
     VALID_MUSIC_PROVIDERS,
     "music"
   );
+  const imageProvider = parseOptionalProvider(
+    options.imageProvider,
+    VALID_IMAGE_PROVIDERS,
+    "image"
+  );
   const composer = parseOptionalProvider(options.composer, VALID_COMPOSERS, "composer");
   const imageQuality = parseOptionalProvider(options.quality, VALID_IMAGE_QUALITIES, "quality");
   const maxCost = options.maxCost !== void 0 ? Number.parseFloat(String(options.maxCost)) : void 0;
@@ -80785,7 +80951,7 @@ var planCommand = new Command("plan").description("Read STORYBOARD.md and show b
     skipMusic: options.skipMusic,
     ttsProvider,
     voice: options.voice,
-    imageProvider: options.imageProvider,
+    imageProvider,
     imageQuality,
     imageSize: options.imageSize,
     videoProvider,
@@ -80922,9 +81088,10 @@ import { resolve as resolve63, join as join23 } from "node:path";
 import { readFileSync as readFileSync3, existsSync as existsSync47 } from "node:fs";
 var VALID_MODES2 = ["agent", "batch", "auto"];
 var VALID_STAGES2 = ["assets", "compose", "sync", "render", "all"];
+var VALID_IMAGE_PROVIDERS2 = ["openai", "gemini", "grok"];
 var VALID_VIDEO_PROVIDERS2 = ["seedance", "grok", "kling", "runway", "veo"];
 var VALID_MUSIC_PROVIDERS2 = ["elevenlabs", "replicate"];
-var buildCommand = new Command("build").description("Build a VibeFrame video project from STORYBOARD.md").argument("[project-dir]", "Video project directory", ".").option("--stage <stage>", `Build stage: ${VALID_STAGES2.join("|")}`, "all").option("--beat <id>", "Restrict asset/compose work to one beat id").option("--mode <mode>", "Build mode: agent|batch|auto", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "Batch composer: claude|openai|gemini").option("--max-cost <usd>", "Fail before provider spend when estimated cost exceeds this USD cap").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-video", "Don't dispatch video generation even when beats declare video cues").option("--skip-music", "Don't dispatch music generation even when beats declare music cues").option("--skip-render", "Compose only \u2014 don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro").option("--voice <id>", "Voice id").option("--image-provider <name>", "Image provider: openai").option("--video-provider <name>", `Video provider: ${VALID_VIDEO_PROVIDERS2.join("|")}`).option("--music-provider <name>", `Music provider: ${VALID_MUSIC_PROVIDERS2.join("|")}`).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").addHelpText(
+var buildCommand = new Command("build").description("Build a VibeFrame video project from STORYBOARD.md").argument("[project-dir]", "Video project directory", ".").option("--stage <stage>", `Build stage: ${VALID_STAGES2.join("|")}`, "all").option("--beat <id>", "Restrict asset/compose work to one beat id").option("--mode <mode>", "Build mode: agent|batch|auto", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "Batch composer: claude|openai|gemini").option("--max-cost <usd>", "Fail before provider spend when estimated cost exceeds this USD cap").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-video", "Don't dispatch video generation even when beats declare video cues").option("--skip-music", "Don't dispatch music generation even when beats declare music cues").option("--skip-render", "Compose only \u2014 don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro").option("--voice <id>", "Voice id").option("--image-provider <name>", `Image provider: ${VALID_IMAGE_PROVIDERS2.join("|")}`).option("--video-provider <name>", `Video provider: ${VALID_VIDEO_PROVIDERS2.join("|")}`).option("--music-provider <name>", `Music provider: ${VALID_MUSIC_PROVIDERS2.join("|")}`).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").addHelpText(
   "after",
   `
 Examples:
@@ -80967,6 +81134,11 @@ Advanced equivalent: \`vibe scene build\`.`
     VALID_MUSIC_PROVIDERS2,
     "music"
   );
+  const imageProvider = parseOptionalProvider2(
+    options.imageProvider,
+    VALID_IMAGE_PROVIDERS2,
+    "image"
+  );
   const params = {
     projectDir,
     stage,
@@ -80982,7 +81154,7 @@ Advanced equivalent: \`vibe scene build\`.`
     skipRender: options.skipRender ?? false,
     ttsProvider: options.tts,
     voice: options.voice,
-    imageProvider: options.imageProvider,
+    imageProvider,
     videoProvider,
     musicProvider,
     imageQuality: options.quality,
@@ -81001,7 +81173,7 @@ Advanced equivalent: \`vibe scene build\`.`
       skipMusic: options.skipMusic,
       ttsProvider: options.tts,
       voice: options.voice,
-      imageProvider: options.imageProvider,
+      imageProvider,
       imageQuality: options.quality,
       imageSize: options.imageSize,
       videoProvider,
@@ -81092,7 +81264,7 @@ Advanced equivalent: \`vibe scene build\`.`
     skipRender: options.skipRender,
     ttsProvider: options.tts,
     voice: options.voice,
-    imageProvider: options.imageProvider,
+    imageProvider,
     videoProvider,
     musicProvider,
     imageQuality: options.quality,
@@ -81813,7 +81985,7 @@ async function runDiagnostics() {
         installed = false;
       }
     } else if (toolName === "chrome") {
-      const { existsSync: existsSync53 } = await import("node:fs");
+      const { existsSync: existsSync54 } = await import("node:fs");
       const { homedir: homedir7 } = await import("node:os");
       const { join: join26 } = await import("node:path");
       const chromePaths = [
@@ -81826,7 +81998,7 @@ async function runDiagnostics() {
         "/usr/bin/chromium",
         "/usr/bin/chromium-browser"
       ];
-      installed = chromePaths.some((p) => p && existsSync53(p));
+      installed = chromePaths.some((p) => p && existsSync54(p));
     } else {
       installed = commandExists(toolName);
     }
@@ -81842,28 +82014,33 @@ async function runDiagnostics() {
     configExists = true;
   } catch {
   }
+  const cwd = process.cwd();
+  const activeConfig = await loadConfig({ cwd });
   const providers = {};
   let readyCount = FREE_COMMANDS.length;
   let totalCount = FREE_COMMANDS.length;
   for (const [envVar, commands] of Object.entries(COMMAND_KEY_MAP)) {
+    const providerName = Object.entries(PROVIDER_ENV_VARS).find(([, v]) => v === envVar)?.[0] ?? envVar;
+    const configuredInConfig = Boolean(
+      activeConfig?.providers[providerName]
+    );
     const configured = Boolean(
-      process.env[envVar] || PROVIDER_ENV_ALIASES[envVar]?.map((alias) => process.env[alias]).find(Boolean)
+      process.env[envVar] || PROVIDER_ENV_ALIASES[envVar]?.map((alias) => process.env[alias]).find(Boolean) || configuredInConfig
     );
-    const providerName = Object.entries(PROVIDER_ENV_VARS).find(([, v]) => v === envVar)?.[0] ?? envVar;
     providers[providerName] = { envVar, configured, commands };
     totalCount += commands.length;
     if (configured) {
       readyCount += commands.length;
     }
   }
-  const cwd = process.cwd();
   const projectFiles = ["AGENTS.md", "CLAUDE.md", "vibe.project.yaml"].map((rel) => ({
     path: rel,
     exists: existsSync48(resolve66(cwd, rel))
   }));
   const projectInitialized = projectFiles.some((f) => f.exists);
-  const projectConfigPath = getProjectConfigPath(cwd);
-  const projectConfigExists = existsSync48(projectConfigPath);
+  const nearestProjectConfigPath = await findProjectConfigPath(cwd);
+  const projectConfigPath = nearestProjectConfigPath ?? getProjectConfigPath(cwd);
+  const projectConfigExists = Boolean(nearestProjectConfigPath);
   const activeScope = await getActiveScope(cwd);
   const hosts = detectAgentHosts();
   const detectedNames = hosts.filter((h) => h.detected).map((h) => h.label);
@@ -82136,8 +82313,9 @@ async function runLiveKeyTests(results) {
     return;
   }
   const { testKey: testKey2 } = await Promise.resolve().then(() => (init_key_live_test(), key_live_test_exports));
+  const activeConfig = await loadConfig({ cwd: process.cwd() });
   for (const [name, info] of configured) {
-    const value = process.env[info.envVar] || PROVIDER_ENV_ALIASES[info.envVar]?.map((alias) => process.env[alias]).find(Boolean);
+    const value = process.env[info.envVar] || PROVIDER_ENV_ALIASES[info.envVar]?.map((alias) => process.env[alias]).find(Boolean) || activeConfig?.providers[name];
     if (!value) continue;
     process.stdout.write(`    ${name.padEnd(12)} `);
     const result = await testKey2(name, value);
@@ -82378,11 +82556,21 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
 
 // src/commands/context.ts
 init_esm();
+import { existsSync as existsSync50 } from "node:fs";
 import { readFile as readFile44 } from "node:fs/promises";
 import { resolve as resolve68, dirname as dirname23 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var __filename = fileURLToPath2(import.meta.url);
 var __dirname = dirname23(__filename);
+function resolveContextPath(baseDir = __dirname) {
+  const candidates = [
+    // Bundled package layout: packages/cli/dist/index.js -> packages/cli/CONTEXT.md
+    resolve68(baseDir, "../CONTEXT.md"),
+    // Source/dev layout: packages/cli/src/commands/context.ts -> packages/cli/CONTEXT.md
+    resolve68(baseDir, "../../CONTEXT.md")
+  ];
+  return candidates.find((candidate) => existsSync50(candidate)) ?? null;
+}
 var contextCommand = new Command("context").description("Print CLI context/guidelines for AI agent integration").option("--format <format>", "Output format: markdown | json", "markdown").action(async (_options, cmd) => {
   const options = {
     json: cmd.parent?.opts()?.json || cmd.opts()?.json || cmd.opts()?.format === "json",
@@ -82468,8 +82656,9 @@ var contextCommand = new Command("context").description("Print CLI context/guide
     console.log(JSON.stringify(contract, null, 2));
     return;
   }
-  const contextPath = resolve68(__dirname, "../CONTEXT.md");
   try {
+    const contextPath = resolveContextPath();
+    if (!contextPath) throw new Error("CONTEXT.md not found");
     const content = await readFile44(contextPath, "utf-8");
     console.log(
       content.replace(
@@ -82561,7 +82750,7 @@ Use 'vibe schema <command> --json' to get parameter schemas.
 Use 'vibe doctor --json' to check configured API keys.
 Use '--dry-run --json' before any mutating/costly operation.
 
-Cost tiers: Free (detect, edit silence-cut/fade/noise-reduce, project, timeline) | Low (inspect, audio transcribe, generate image) | High (generate video, edit image) | Very High (remix highlights/auto-shorts/regenerate-scene, vibe build)
+Cost tiers: Free (schema/context/doctor/detect/status/plan/storyboard validate/inspect project/render --cheap, deterministic edits) | Low (generate narration/sound-effect/music, audio transcribe, inspect media, optional AI review) | High (generate image/motion, edit image/reframe/grade/speed-ramp) | Very High (generate video, edit fill-gaps, remix highlights/auto-shorts, build with generated assets)
 
 Group \u2192 MCP tool name: '<group>_<leaf>' (snake_case). Bare top-level (init/build/render/run) maps to bare MCP names.
 

package/package.json

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