@vibeframe/cli 0.103.1 → 0.104.0

package/dist/index.js

@@ -25726,11 +25726,15 @@ var config_exports = {};
 __export(config_exports, {
   CONFIG_DIR: () => CONFIG_DIR,
   CONFIG_PATH: () => CONFIG_PATH,
+  LEGACY_USER_CONFIG_DIR: () => LEGACY_USER_CONFIG_DIR,
+  LEGACY_USER_CONFIG_PATH: () => LEGACY_USER_CONFIG_PATH,
   PROVIDER_ENV_ALIASES: () => PROVIDER_ENV_ALIASES,
   PROVIDER_ENV_VARS: () => PROVIDER_ENV_VARS,
   PROVIDER_NAMES: () => PROVIDER_NAMES,
+  USER_CACHE_DIR: () => USER_CACHE_DIR,
   USER_CONFIG_DIR: () => USER_CONFIG_DIR,
   USER_CONFIG_PATH: () => USER_CONFIG_PATH,
+  USER_DATA_DIR: () => USER_DATA_DIR,
   createDefaultConfig: () => createDefaultConfig,
   findProjectConfigPath: () => findProjectConfigPath,
   getActiveScope: () => getActiveScope,
@@ -25739,6 +25743,7 @@ __export(config_exports, {
   getConfigPath: () => getConfigPath,
   getProjectConfigDir: () => getProjectConfigDir,
   getProjectConfigPath: () => getProjectConfigPath,
+  getUserConfigStatus: () => getUserConfigStatus,
   isConfigured: () => isConfigured,
   loadConfig: () => loadConfig,
   saveConfig: () => saveConfig,
@@ -25747,6 +25752,17 @@ __export(config_exports, {
 import { resolve as resolve4 } from "node:path";
 import { homedir } from "node:os";
 import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2, access as access2 } from "node:fs/promises";
+function resolveEnvPath(name) {
+  const value = process.env[name]?.trim();
+  return value ? resolve4(value) : null;
+}
+function resolveXdgAppDir(opts) {
+  const override = resolveEnvPath(opts.overrideEnv);
+  if (override) return override;
+  const xdgBase = resolveEnvPath(opts.xdgEnv);
+  const base = xdgBase ?? resolve4(homedir(), opts.fallbackHomeRel);
+  return resolve4(base, "vibeframe");
+}
 function getProjectConfigDir(cwd = process.cwd()) {
   return resolve4(cwd, ".vibeframe");
 }
@@ -25767,11 +25783,29 @@ async function fileExists(path2) {
     return false;
   }
 }
+async function getUserConfigStatus() {
+  const primaryConfigured = await fileExists(USER_CONFIG_PATH);
+  const legacyConfigured = LEGACY_USER_CONFIG_PATH === USER_CONFIG_PATH ? primaryConfigured : await fileExists(LEGACY_USER_CONFIG_PATH);
+  const source = primaryConfigured ? "user" : legacyConfigured && LEGACY_USER_CONFIG_PATH !== USER_CONFIG_PATH ? "legacy" : null;
+  return {
+    configured: primaryConfigured || legacyConfigured,
+    configPath: source === "user" ? USER_CONFIG_PATH : source === "legacy" ? LEGACY_USER_CONFIG_PATH : USER_CONFIG_PATH,
+    writePath: USER_CONFIG_PATH,
+    legacyConfigPath: LEGACY_USER_CONFIG_PATH,
+    primaryConfigured,
+    legacyConfigured,
+    source
+  };
+}
 async function findProjectConfigPath(cwd = process.cwd()) {
   let dir = resolve4(cwd);
+  const homeDir = resolve4(homedir());
   for (; ; ) {
+    if (dir === homeDir) return null;
     const candidate = getProjectConfigPath(dir);
-    if (await fileExists(candidate)) return candidate;
+    if (candidate !== USER_CONFIG_PATH && candidate !== LEGACY_USER_CONFIG_PATH && await fileExists(candidate)) {
+      return candidate;
+    }
     const parent = resolve4(dir, "..");
     if (parent === dir) return null;
     dir = parent;
@@ -25806,10 +25840,15 @@ async function readConfigFile(path2) {
     return null;
   }
 }
+async function readUserConfigFile() {
+  if (await fileExists(USER_CONFIG_PATH)) return readConfigFile(USER_CONFIG_PATH);
+  if (await fileExists(LEGACY_USER_CONFIG_PATH)) return readConfigFile(LEGACY_USER_CONFIG_PATH);
+  return null;
+}
 async function loadConfig(options = {}) {
   const { scope, cwd, merge } = options;
   if (merge) {
-    const user = await readConfigFile(USER_CONFIG_PATH);
+    const user = await readUserConfigFile();
     const projectPath2 = await findProjectConfigPath(cwd);
     const project2 = projectPath2 ? await readConfigFile(projectPath2) : null;
     if (!user && !project2) return null;
@@ -25830,12 +25869,12 @@ async function loadConfig(options = {}) {
     };
   }
   if (scope) {
-    return readConfigFile(getConfigPath(scope, cwd));
+    return scope === "user" ? readUserConfigFile() : readConfigFile(getConfigPath(scope, cwd));
   }
   const projectPath = await findProjectConfigPath(cwd);
   const project = projectPath ? await readConfigFile(projectPath) : null;
   if (project) return project;
-  return readConfigFile(USER_CONFIG_PATH);
+  return readUserConfigFile();
 }
 async function saveConfig(config2, options = {}) {
   const scope = options.scope ?? "user";
@@ -25845,8 +25884,8 @@ async function saveConfig(config2, options = {}) {
   const content = (0, import_yaml.stringify)(config2, { indent: 2, lineWidth: 0 });
   await writeFile2(path2, content, "utf-8");
 }
-async function isConfigured() {
-  const config2 = await loadConfig();
+async function isConfigured(options = {}) {
+  const config2 = await loadConfig({ cwd: options.cwd });
   if (!config2) return false;
   const provider = config2.llm.provider;
   const providerKey = provider === "gemini" ? "google" : provider === "claude" ? "anthropic" : provider;
@@ -25878,15 +25917,23 @@ async function updateProviderKey(providerKey, apiKey, options = {}) {
   config2.providers[providerKey] = apiKey;
   await saveConfig(config2, { scope, cwd: options.cwd });
 }
-var import_yaml, USER_CONFIG_DIR, USER_CONFIG_PATH, CONFIG_DIR, CONFIG_PATH;
+var import_yaml, USER_CONFIG_DIR, USER_CONFIG_PATH, USER_DATA_DIR, USER_CACHE_DIR, LEGACY_USER_CONFIG_DIR, LEGACY_USER_CONFIG_PATH, CONFIG_DIR, CONFIG_PATH;
 var init_config = __esm({
   "src/config/index.ts"() {
     "use strict";
     import_yaml = __toESM(require_dist2(), 1);
     init_schema();
     init_schema();
-    USER_CONFIG_DIR = resolve4(homedir(), ".vibeframe");
+    USER_CONFIG_DIR = resolveEnvPath("VIBEFRAME_CONFIG_HOME") ?? resolve4(homedir(), ".vibeframe");
     USER_CONFIG_PATH = resolve4(USER_CONFIG_DIR, "config.yaml");
+    USER_DATA_DIR = resolveXdgAppDir({
+      overrideEnv: "VIBEFRAME_DATA_HOME",
+      xdgEnv: "XDG_DATA_HOME",
+      fallbackHomeRel: ".local/share"
+    });
+    USER_CACHE_DIR = resolveEnvPath("VIBEFRAME_CACHE_HOME") ?? resolve4(USER_CONFIG_DIR, "cache");
+    LEGACY_USER_CONFIG_DIR = resolve4(homedir(), ".vibeframe");
+    LEGACY_USER_CONFIG_PATH = resolve4(LEGACY_USER_CONFIG_DIR, "config.yaml");
     CONFIG_DIR = USER_CONFIG_DIR;
     CONFIG_PATH = USER_CONFIG_PATH;
   }
@@ -28939,7 +28986,6 @@ import { GoogleGenerativeAI } from "@google/generative-ai";
 import { createHash as createHash2 } from "node:crypto";
 import { existsSync as existsSync6, mkdirSync } from "node:fs";
 import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile7 } from "node:fs/promises";
-import { homedir as homedir4 } from "node:os";
 import { dirname as dirname2, join as join5, resolve as resolve10 } from "node:path";
 import { runHyperframeLint as runHyperframeLint2 } from "@hyperframes/producer";
 function buildSystemPrompt(ctx) {
@@ -29109,7 +29155,7 @@ function computeCacheKey(parts) {
   return createHash2("sha256").update(parts.provider).update("\u241E").update(parts.model).update("\u241E").update(parts.systemPrompt).update("\u241E").update(parts.userPrompt).digest("hex");
 }
 function defaultCacheDir() {
-  return join5(homedir4(), ".vibeframe", "cache", "compose-scenes");
+  return join5(USER_CACHE_DIR, "compose-scenes");
 }
 function extractHtml(responseText) {
   const fenced = responseText.match(/```html\s*\n([\s\S]*?)\n```/);
@@ -29399,6 +29445,7 @@ var MODEL_SETTINGS_BY_PROVIDER, ComposeBeatError, defaultCallLLM, CONFIG_PROVIDE
 var init_compose_scenes_skills = __esm({
   "src/commands/_shared/compose-scenes-skills.ts"() {
     "use strict";
+    init_config();
     init_bundle();
     init_scene_lint();
     init_storyboard_parse();
@@ -40732,7 +40779,7 @@ var init_ai_fill_gaps = __esm({
 
 // src/pipeline/renderers/chrome.ts
 import { existsSync as existsSync27 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
+import { homedir as homedir4 } from "node:os";
 import { join as join14 } from "node:path";
 function findChrome() {
   const candidates = [
@@ -40740,7 +40787,7 @@ function findChrome() {
     process.env.CHROME_PATH,
     // puppeteer auto-downloaded headless shell
     join14(
-      homedir5(),
+      homedir4(),
       ".cache",
       "puppeteer",
       "chrome-headless-shell",
@@ -58580,6 +58627,18 @@ async function createBuildPlan(opts) {
       `vibe storyboard revise ${projectDir} --from "<request>" --dry-run --json`
     );
   }
+  if (validationOk && includeAssets && !opts.skipBackdrop) {
+    const generatedBackdrops = beats.map((beat) => beat.assets.backdrop).filter((asset) => Boolean(asset?.willGenerate));
+    if (generatedBackdrops.length > 0) {
+      const cost = generatedBackdrops.reduce((sum, asset) => sum + asset.estimatedCostUsd, 0);
+      const beatFlag = opts.beat ? ` --beat ${opts.beat}` : "";
+      const skipCommand = `vibe build ${projectDir}${beatFlag} --stage ${stage} --skip-backdrop --json`;
+      warnings.push(
+        `Backdrop image generation will run for ${generatedBackdrops.length} beat(s), estimated $${cost.toFixed(2)}. Use --skip-backdrop for HTML/CSS-derived visuals: ${skipCommand}`
+      );
+      retryWith.push(skipCommand);
+    }
+  }
   return finalizeBuildPlan({
     projectDir,
     config: config2,
@@ -69184,7 +69243,7 @@ var init_project2 = __esm({
 });
 
 // src/commands/export.ts
-import { readFile as readFile50, access as access8 } from "node:fs/promises";
+import { readFile as readFile50, access as access7 } from "node:fs/promises";
 import { resolve as resolve77, basename as basename24 } from "node:path";
 import { spawn as spawn3 } from "node:child_process";
 function timelineBaseName(path2) {
@@ -69274,7 +69333,7 @@ async function runExport(projectPath, outputPath, options = {}) {
       const source = sources.find((s) => s.id === clip.sourceId);
       if (source) {
         try {
-          await access8(source.url);
+          await access7(source.url);
           if (!sourceActualDurationMap.has(source.id)) {
             try {
               const dur = await getMediaDuration(source.url, source.type);
@@ -69971,7 +70030,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
           const source = sources.find((s) => s.id === clip.sourceId);
           if (source) {
             try {
-              await access8(source.url);
+              await access7(source.url);
               if (!sourceActualDurationMap.has(source.id)) {
                 try {
                   const dur = await getMediaDuration(source.url, source.type);
@@ -70081,7 +70140,7 @@ var init_export2 = __esm({
 });
 
 // src/tools/manifest/agent-only.ts
-import { readFile as readFile51, writeFile as writeFile57, readdir as readdir7, stat as stat9, access as access9, unlink as unlink4 } from "node:fs/promises";
+import { readFile as readFile51, writeFile as writeFile57, readdir as readdir7, stat as stat9, access as access8, unlink as unlink4 } from "node:fs/promises";
 import { resolve as resolve79, join as join25, basename as basename25, extname as extname16 } from "node:path";
 function matchPattern(filename, pattern) {
   const regex2 = new RegExp(
@@ -70234,7 +70293,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         const absPath = resolve79(ctx.workingDirectory, args.path);
         try {
-          await access9(absPath);
+          await access8(absPath);
           const stats = await stat9(absPath);
           const type = stats.isDirectory() ? "directory" : "file";
           return { success: true, data: { exists: true, type }, humanLines: [`${type} exists: ${args.path}`] };
@@ -71325,7 +71384,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.103.1",
+  version: "0.104.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -78555,7 +78614,7 @@ init_tty();
 init_api_key();
 import { resolve as resolve52 } from "node:path";
 import { access as access6, readFile as readFile36 } from "node:fs/promises";
-import { homedir as homedir6 } from "node:os";
+import { homedir as homedir5 } from "node:os";
 
 // src/utils/key-format.ts
 init_dist2();
@@ -79071,6 +79130,7 @@ function mergeSelectedFeatures(current, next) {
 }
 async function runNonInteractiveSetup(opts) {
   const scope = opts.scope ?? "user";
+  const userStatusBefore = scope === "user" ? await getUserConfigStatus() : null;
   let config2 = await loadConfig({ scope });
   if (!config2) {
     config2 = createDefaultConfig();
@@ -79113,6 +79173,13 @@ async function runNonInteractiveSetup(opts) {
   await saveConfig(config2, { scope });
   console.log(source_default.green(`\u2713 Setup complete (non-interactive, ${scope} scope)`));
   console.log(source_default.dim(`  Config: ${getConfigPath(scope)}`));
+  if (userStatusBefore?.source === "legacy") {
+    console.log(
+      source_default.dim(
+        `  Imported legacy config from ${userStatusBefore.legacyConfigPath}; future writes use ${userStatusBefore.writePath}`
+      )
+    );
+  }
   if (changes.length > 0) {
     for (const c of changes) {
       console.log(source_default.dim(`  ${c}`));
@@ -79162,10 +79229,19 @@ async function runNonInteractiveSetup(opts) {
 async function runSetupWizard(fullSetup = false, scope = "user") {
   console.log();
   loadEnv();
-  const cfgPath = getConfigPath(scope).replace(homedir6(), "~");
+  const userStatus = scope === "user" ? await getUserConfigStatus() : null;
+  const displayPath2 = scope === "user" ? userStatus?.source === "legacy" ? userStatus.configPath : USER_CONFIG_PATH : getConfigPath(scope);
+  const cfgPath = displayPath2.replace(homedir5(), "~");
   const scopeNote = scope === "project" ? "applies to this project only \xB7 add .vibeframe/ to .gitignore" : "applies to every project for this user";
   console.log(source_default.bold.magenta("VibeFrame Setup") + source_default.bold(` \u2014 ${scope} scope`));
   console.log(source_default.dim(`${cfgPath} \xB7 ${scopeNote}`));
+  if (userStatus?.source === "legacy") {
+    console.log(
+      source_default.dim(
+        `Legacy user config detected; saving will migrate it to ${userStatus.writePath.replace(homedir5(), "~")}`
+      )
+    );
+  }
   if (scope === "user") {
     console.log(
       source_default.dim("Tip: for per-project keys, cd into a project and run: vibe setup --scope project")
@@ -79523,8 +79599,14 @@ async function collectKeys(config2, keys) {
   console.log();
 }
 async function runCustomSetup(config2, scope = "user", opts = {}) {
-  console.log(source_default.bold("1. LLM Provider") + source_default.dim(" (optional built-in vibe agent / fallback)"));
-  console.log(source_default.dim("   Most Claude Code/Codex/Cursor users can skip this and let the host agent drive vibe directly."));
+  console.log(
+    source_default.bold("1. LLM Provider") + source_default.dim(" (optional built-in vibe agent / fallback)")
+  );
+  console.log(
+    source_default.dim(
+      "   Most Claude Code/Codex/Cursor users can skip this and let the host agent drive vibe directly."
+    )
+  );
   console.log();
   const providers = ["claude", "openai", "gemini", "xai", "openrouter", "ollama"];
   const providerDescriptions = {
@@ -79703,9 +79785,10 @@ async function showConfig(opts = { verbose: false }) {
   } catch {
   }
   const activeScope = await getActiveScope();
-  const userPath = USER_CONFIG_PATH;
+  const userStatus = await getUserConfigStatus();
+  const userPath = userStatus.configPath;
   const projectPath = getConfigPath("project");
-  const userExists = await loadConfig({ scope: "user" }) !== null;
+  const userExists = userStatus.configured;
   const projectExists = await loadConfig({ scope: "project" }) !== null;
   console.log();
   console.log(source_default.bold.magenta("VibeFrame Configuration"));
@@ -79715,6 +79798,11 @@ async function showConfig(opts = { verbose: false }) {
   const projectMark = activeScope === "project" ? source_default.cyan("\u2190 active") : projectExists ? source_default.dim("(present)") : source_default.dim("(missing)");
   console.log(source_default.dim(`Scopes:`));
   console.log(source_default.dim(`  user     ${userPath} ${userMark}`));
+  if (userStatus.source === "legacy") {
+    console.log(source_default.dim(`           writes to ${userStatus.writePath} (migrates on save)`));
+  } else if (!userStatus.configured) {
+    console.log(source_default.dim(`           writes to ${userStatus.writePath}`));
+  }
   console.log(source_default.dim(`  project  ${projectPath} ${projectMark}`));
   if (hasCwdEnv) {
     console.log(source_default.dim(`  .env     ${cwdEnvPath} ${source_default.dim("(env vars override config)")}`));
@@ -80293,8 +80381,28 @@ defaults:
 
 // src/commands/init.ts
 init_output();
-var VALID_AGENTS = ["claude-code", "codex", "cursor", "aider", "gemini-cli", "opencode", "all", "auto"];
-var initCommand = new Command("init").description("Scaffold a VibeFrame project (video scene project or project-scope agent files)").argument("[project-dir]", "Project directory (defaults to cwd)", ".").option("--type <type>", "Project type: scene (video project) | agent (agent files only)", "scene").option("--profile <profile>", "Scene profile: minimal (storyboard/design only), agent (recommended), full (render scaffold upfront)", "agent").option("--from <brief>", "Draft STORYBOARD.md and DESIGN.md from a brief string or text/markdown file").option("-r, --ratio <ratio>", "Scene aspect ratio: 16:9, 9:16, 1:1, 4:5", "16:9").option("-d, --duration <sec>", "Default scene/root duration in seconds", "10").option("--visual-style <name>", "Seed scene DESIGN.md from a named style").option("--agent <id>", `Agent target: ${VALID_AGENTS.join(" | ")}`, "auto").option("--force", "Overwrite existing files instead of skipping").option("--dry-run", "Print the file list without writing anything").action(async (projectDirArg, options) => {
+var VALID_AGENTS = [
+  "claude-code",
+  "codex",
+  "cursor",
+  "aider",
+  "gemini-cli",
+  "opencode",
+  "all",
+  "auto"
+];
+var initCommand = new Command("init").description("Scaffold a VibeFrame project (video scene project or project-scope agent files)").argument("[project-dir]", "Project directory (defaults to cwd)", ".").option(
+  "--type <type>",
+  "Project type: scene (video project) | agent (agent files only)",
+  "scene"
+).option(
+  "--profile <profile>",
+  "Scene profile: minimal (storyboard/design only), agent (recommended), full (render scaffold upfront)",
+  "agent"
+).option(
+  "--from <brief>",
+  "Draft STORYBOARD.md and DESIGN.md from a brief string or text/markdown file"
+).option("-r, --ratio <ratio>", "Scene aspect ratio: 16:9, 9:16, 1:1, 4:5", "16:9").option("-d, --duration <sec>", "Default scene/root duration in seconds", "10").option("--visual-style <name>", "Seed scene DESIGN.md from a named style").option("--agent <id>", `Agent target: ${VALID_AGENTS.join(" | ")}`, "auto").option("--force", "Overwrite existing files instead of skipping").option("--dry-run", "Print the file list without writing anything").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
   const initType = String(options.type ?? "scene");
   if (initType !== "scene" && initType !== "agent") {
@@ -80306,7 +80414,9 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   }
   const agent = options.agent;
   if (!VALID_AGENTS.includes(agent)) {
-    exitWithError(usageError(`Invalid --agent: ${agent}`, `Must be one of: ${VALID_AGENTS.join(", ")}`));
+    exitWithError(
+      usageError(`Invalid --agent: ${agent}`, `Must be one of: ${VALID_AGENTS.join(", ")}`)
+    );
   }
   const projectDir = resolve53(projectDirArg);
   const projectName = basename19(projectDir);
@@ -80317,58 +80427,72 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   const actions = [];
   if (!existsSync40(projectDir)) {
     if (options.dryRun) {
-      actions.push({ path: projectDir, status: "would-write", reason: "(would create directory)" });
+      actions.push({
+        path: projectDir,
+        status: "would-write",
+        reason: "(would create directory)"
+      });
     } else {
       await mkdir22(projectDir, { recursive: true });
     }
   }
   if (wantsCrossTool || !wantsClaude) {
-    actions.push(await writeIfMissing(
-      resolve53(projectDir, "AGENTS.md"),
-      AGENTS_MD,
-      options.force,
-      options.dryRun
-    ));
+    actions.push(
+      await writeIfMissing(
+        resolve53(projectDir, "AGENTS.md"),
+        AGENTS_MD,
+        options.force,
+        options.dryRun
+      )
+    );
   }
   if (wantsClaude) {
-    actions.push(await writeIfMissing(
-      resolve53(projectDir, "CLAUDE.md"),
-      CLAUDE_MD,
-      options.force,
-      options.dryRun
-    ));
+    actions.push(
+      await writeIfMissing(
+        resolve53(projectDir, "CLAUDE.md"),
+        CLAUDE_MD,
+        options.force,
+        options.dryRun
+      )
+    );
   }
   if (wantsGemini) {
-    actions.push(await writeIfMissing(
-      resolve53(projectDir, "GEMINI.md"),
-      GEMINI_MD,
+    actions.push(
+      await writeIfMissing(
+        resolve53(projectDir, "GEMINI.md"),
+        GEMINI_MD,
+        options.force,
+        options.dryRun
+      )
+    );
+  }
+  actions.push(
+    await writeIfMissing(
+      resolve53(projectDir, ".env.example"),
+      renderEnvExample(),
       options.force,
       options.dryRun
-    ));
-  }
-  actions.push(await writeIfMissing(
-    resolve53(projectDir, ".env.example"),
-    renderEnvExample(),
-    options.force,
-    options.dryRun
-  ));
-  actions.push(await mergeGitignore(
-    resolve53(projectDir, ".gitignore"),
-    GITIGNORE_ADDITIONS,
-    options.dryRun
-  ));
-  actions.push(await writeIfMissing(
-    resolve53(projectDir, VIBE_CONFIG_FILENAME),
-    projectConfigJson({ name: projectName }),
-    options.force,
-    options.dryRun
-  ));
-  actions.push(await writeIfMissing(
-    resolve53(projectDir, "vibe.project.yaml"),
-    renderProjectYaml({ name: projectName }),
-    options.force,
-    options.dryRun
-  ));
+    )
+  );
+  actions.push(
+    await mergeGitignore(resolve53(projectDir, ".gitignore"), GITIGNORE_ADDITIONS, options.dryRun)
+  );
+  actions.push(
+    await writeIfMissing(
+      resolve53(projectDir, VIBE_CONFIG_FILENAME),
+      projectConfigJson({ name: projectName }),
+      options.force,
+      options.dryRun
+    )
+  );
+  actions.push(
+    await writeIfMissing(
+      resolve53(projectDir, "vibe.project.yaml"),
+      renderProjectYaml({ name: projectName }),
+      options.force,
+      options.dryRun
+    )
+  );
   if (isJsonMode()) {
     outputSuccess({
       command: "init",
@@ -80387,7 +80511,11 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   console.log(source_default.bold.magenta("VibeFrame Init") + source_default.dim(" \u2014 project scope"));
   console.log(source_default.dim("\u2500".repeat(50)));
   console.log(source_default.dim(`Project:  ${projectDir}`));
-  console.log(source_default.dim(`Agent:    ${agent}${agent === "auto" ? ` (resolved \u2192 ${targetHosts.join(", ") || "fallback"})` : ""}`));
+  console.log(
+    source_default.dim(
+      `Agent:    ${agent}${agent === "auto" ? ` (resolved \u2192 ${targetHosts.join(", ") || "fallback"})` : ""}`
+    )
+  );
   console.log();
   for (const a of actions) {
     const icon = formatStatusIcon(a.status);
@@ -80403,8 +80531,14 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   console.log();
   console.log(source_default.bold("  Next steps:"));
   if (wantsClaude) {
-    console.log(source_default.dim("    bash <(curl -fsSL https://raw.githubusercontent.com/vericontext/vibeframe/main/scripts/install-skills.sh)"));
-    console.log(source_default.dim("                                  Install /vibeframe + /vibe-* slash commands"));
+    console.log(
+      source_default.dim(
+        "    bash <(curl -fsSL https://raw.githubusercontent.com/vericontext/vibeframe/main/scripts/install-skills.sh)"
+      )
+    );
+    console.log(
+      source_default.dim("                                  Install /vibeframe + /vibe-* slash commands")
+    );
   }
   console.log(source_default.dim("    cp .env.example .env          Add your API keys"));
   console.log(source_default.dim("    vibe doctor                   Check what's configured"));
@@ -80415,19 +80549,33 @@ var VALID_SCENE_ASPECTS = ["16:9", "9:16", "1:1", "4:5"];
 async function runSceneInit(projectDirArg, options, startedAt) {
   const profile = String(options.profile ?? "agent");
   if (!isSceneScaffoldProfile(profile)) {
-    exitWithError(usageError(`Invalid --profile: ${profile}`, "Must be one of: minimal, agent, full"));
+    exitWithError(
+      usageError(`Invalid --profile: ${profile}`, "Must be one of: minimal, agent, full")
+    );
   }
   const aspect = String(options.ratio ?? "16:9");
   if (!VALID_SCENE_ASPECTS.includes(aspect)) {
-    exitWithError(usageError(`Invalid --ratio: ${aspect}`, `Must be one of: ${VALID_SCENE_ASPECTS.join(", ")}`));
+    exitWithError(
+      usageError(`Invalid --ratio: ${aspect}`, `Must be one of: ${VALID_SCENE_ASPECTS.join(", ")}`)
+    );
   }
   const duration = Number.parseFloat(String(options.duration ?? "10"));
   if (!Number.isFinite(duration) || duration <= 0 || duration > 3600) {
-    exitWithError(usageError(`Invalid --duration: ${String(options.duration)}`, "Duration must be a positive number of seconds (\u22643600)"));
+    exitWithError(
+      usageError(
+        `Invalid --duration: ${String(options.duration)}`,
+        "Duration must be a positive number of seconds (\u22643600)"
+      )
+    );
   }
   const visualStyle = options.visualStyle ? getVisualStyle(String(options.visualStyle)) : void 0;
   if (options.visualStyle && !visualStyle) {
-    exitWithError(usageError(`Unknown visual style: ${String(options.visualStyle)}`, `Valid: ${visualStyleNames()}. Browse with \`vibe scene list-styles\`.`));
+    exitWithError(
+      usageError(
+        `Unknown visual style: ${String(options.visualStyle)}`,
+        `Valid: ${visualStyleNames()}. Browse with \`vibe scene list-styles\`.`
+      )
+    );
   }
   const projectDir = resolve53(projectDirArg);
   const projectName = basename19(projectDir);
@@ -80532,17 +80680,26 @@ async function runSceneInit(projectDirArg, options, startedAt) {
   for (const warning of draftWarnings) console.log(source_default.yellow(`Warning: ${warning}`));
   console.log();
   console.log(source_default.bold("Edit first"));
-  console.log(`  ${source_default.cyan("STORYBOARD.md")}  ${source_default.dim("beats: narration, backdrop, minimum duration")}`);
-  console.log(`  ${source_default.cyan("DESIGN.md")}      ${source_default.dim("palette, typography, motion rules")}`);
+  console.log(
+    `  ${source_default.cyan("STORYBOARD.md")}  ${source_default.dim("beats: narration, backdrop, minimum duration")}`
+  );
+  console.log(
+    `  ${source_default.cyan("DESIGN.md")}      ${source_default.dim("palette, typography, motion rules")}`
+  );
   console.log();
   console.log(source_default.bold("Then run"));
-  console.log(`  ${source_default.cyan("vibe build")}   ${source_default.dim("build storyboard assets/compositions")}`);
+  console.log(
+    `  ${source_default.cyan("vibe build")}   ${source_default.dim("build storyboard assets/compositions")}`
+  );
   console.log(`  ${source_default.cyan("vibe render")}  ${source_default.dim("render final MP4")}`);
   console.log();
   console.log(source_default.bold("Files"));
-  for (const p of result.created) console.log(source_default.green(`    + ${p.replace(projectDir + "/", "")}`));
-  for (const p of result.merged) console.log(source_default.yellow(`    ~ ${p.replace(projectDir + "/", "")} (merged)`));
-  for (const p of result.skipped) console.log(source_default.dim(`    \xB7 ${p.replace(projectDir + "/", "")} (kept existing)`));
+  for (const p of result.created)
+    console.log(source_default.green(`    + ${p.replace(projectDir + "/", "")}`));
+  for (const p of result.merged)
+    console.log(source_default.yellow(`    ~ ${p.replace(projectDir + "/", "")} (merged)`));
+  for (const p of result.skipped)
+    console.log(source_default.dim(`    \xB7 ${p.replace(projectDir + "/", "")} (kept existing)`));
   for (const f of skillResult.files.filter((f2) => f2.status === "wrote")) {
     console.log(source_default.green(`    + ${f.path.replace(projectDir + "/", "")}`));
   }
@@ -80560,21 +80717,29 @@ function printSceneInitPlan(opts) {
   console.log(source_default.bold.magenta("VibeFrame Init") + source_default.dim(opts.dryRun ? " \u2014 dry run" : ""));
   console.log(source_default.dim("\u2500".repeat(60)));
   console.log(`${source_default.dim("Project")}  ${opts.projectDir}`);
-  console.log(`${source_default.dim("Profile")}  ${opts.profile} ${source_default.dim(sceneProfileSummary(opts.profile))}`);
+  console.log(
+    `${source_default.dim("Profile")}  ${opts.profile} ${source_default.dim(sceneProfileSummary(opts.profile))}`
+  );
   console.log(`${source_default.dim("Canvas")}   ${opts.aspect} \xB7 ${opts.duration}s default`);
   if (opts.briefSummary) console.log(`${source_default.dim("Brief")}    ${opts.briefSummary}`);
   if (opts.visualStyleName) console.log(`${source_default.dim("Style")}    ${opts.visualStyleName}`);
   console.log();
   console.log(source_default.bold("Edit first"));
-  console.log(`  ${source_default.cyan("STORYBOARD.md")}  ${source_default.dim("beats: narration, backdrop, minimum duration")}`);
-  console.log(`  ${source_default.cyan("DESIGN.md")}      ${source_default.dim("palette, typography, motion rules")}`);
+  console.log(
+    `  ${source_default.cyan("STORYBOARD.md")}  ${source_default.dim("beats: narration, backdrop, minimum duration")}`
+  );
+  console.log(
+    `  ${source_default.cyan("DESIGN.md")}      ${source_default.dim("palette, typography, motion rules")}`
+  );
   console.log();
   console.log(source_default.bold("Project contents"));
   printGroup("authoring", opts.groups.authoring, opts.projectDir);
   printGroup("agent", opts.groups.agent, opts.projectDir);
   printGroup("render", opts.groups.render, opts.projectDir);
   console.log();
-  console.log(source_default.dim("Dry run \u2014 no files were written. Re-run without --dry-run to create the project."));
+  console.log(
+    source_default.dim("Dry run \u2014 no files were written. Re-run without --dry-run to create the project.")
+  );
   console.log();
 }
 function printGroup(label, files, projectDir) {
@@ -81862,7 +82027,6 @@ init_composer_resolve();
 init_cost_tier();
 init_scene_build();
 init_output();
-import { access as access7 } from "node:fs/promises";
 import { existsSync as existsSync48 } from "node:fs";
 import { resolve as resolve66 } from "node:path";
 var COMMAND_KEY_MAP = getCommandKeyMap();
@@ -81879,7 +82043,13 @@ var FREE_COMMANDS = [
   "timeline (all)",
   "batch import/concat"
 ];
-var doctorCommand = new Command("doctor").description("Check system health and available commands").option("--json", "Output in JSON format").option("-v, --verbose", "Show full report (every provider row, scene composer block, free-command list)").option("--test-keys", "Make a lightweight authenticated request to each provider (validates configured keys; skips providers without a cheap test endpoint)").addHelpText(
+var doctorCommand = new Command("doctor").description("Check system health and available commands").option("--json", "Output in JSON format").option(
+  "-v, --verbose",
+  "Show full report (every provider row, scene composer block, free-command list)"
+).option(
+  "--test-keys",
+  "Make a lightweight authenticated request to each provider (validates configured keys; skips providers without a cheap test endpoint)"
+).addHelpText(
   "after",
   `
 Examples:
@@ -81986,12 +82156,20 @@ async function runDiagnostics() {
       }
     } else if (toolName === "chrome") {
       const { existsSync: existsSync54 } = await import("node:fs");
-      const { homedir: homedir7 } = await import("node:os");
+      const { homedir: homedir6 } = await import("node:os");
       const { join: join26 } = await import("node:path");
       const chromePaths = [
         process.env.HYPERFRAMES_CHROME_PATH,
         process.env.CHROME_PATH,
-        join26(homedir7(), ".cache", "puppeteer", "chrome-headless-shell", "mac_arm-147.0.7727.56", "chrome-headless-shell-mac_arm", "chrome-headless-shell"),
+        join26(
+          homedir6(),
+          ".cache",
+          "puppeteer",
+          "chrome-headless-shell",
+          "mac_arm-147.0.7727.56",
+          "chrome-headless-shell-mac_arm",
+          "chrome-headless-shell"
+        ),
         "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
         "/Applications/Chromium.app/Contents/MacOS/Chromium",
         "/usr/bin/google-chrome",
@@ -82008,12 +82186,8 @@ async function runDiagnostics() {
       install: info.install
     };
   }
-  let configExists = false;
-  try {
-    await access7(CONFIG_PATH);
-    configExists = true;
-  } catch {
-  }
+  const userConfig = await getUserConfigStatus();
+  const configExists = userConfig.configured;
   const cwd = process.cwd();
   const activeConfig = await loadConfig({ cwd });
   const providers = {};
@@ -82059,13 +82233,23 @@ async function runDiagnostics() {
   return {
     system: {
       node: { version: nodeVersion, ok: true },
-      ffmpeg: { version: ffmpegVersion, ok: ffmpegExists, ...ffmpegFilters ? { filters: ffmpegFilters } : {} },
-      config: { path: CONFIG_PATH, ok: configExists },
+      ffmpeg: {
+        version: ffmpegVersion,
+        ok: ffmpegExists,
+        ...ffmpegFilters ? { filters: ffmpegFilters } : {}
+      },
+      config: { path: userConfig.configPath, ok: configExists },
       ...Object.keys(optionalTools).length > 0 ? { optionalTools } : {}
     },
     scope: {
       activeScope,
-      user: { configured: configExists, configPath: CONFIG_PATH },
+      user: {
+        configured: configExists,
+        configPath: userConfig.configPath,
+        writePath: userConfig.writePath,
+        legacyConfigPath: userConfig.legacyConfigPath,
+        source: userConfig.source
+      },
       project: {
         cwd,
         initialized: projectInitialized,
@@ -82094,11 +82278,11 @@ function printReport(results, opts = { verbose: false }) {
   const nodeIcon = results.system.node.ok ? source_default.green("OK") : source_default.red("MISSING");
   console.log(`    Node.js    ${results.system.node.version}  ${nodeIcon}`);
   if (results.system.ffmpeg.ok) {
+    console.log(`    FFmpeg     ${results.system.ffmpeg.version}  ${source_default.green("OK")}`);
+  } else {
     console.log(
-      `    FFmpeg     ${results.system.ffmpeg.version}  ${source_default.green("OK")}`
+      `    FFmpeg     ${source_default.red("NOT FOUND")}  ${source_default.dim("Install: brew install ffmpeg")}`
     );
-  } else {
-    console.log(`    FFmpeg     ${source_default.red("NOT FOUND")}  ${source_default.dim("Install: brew install ffmpeg")}`);
   }
   if (results.system.ffmpeg.ok && results.system.ffmpeg.filters) {
     const filters = results.system.ffmpeg.filters;
@@ -82113,7 +82297,9 @@ function printReport(results, opts = { verbose: false }) {
         }
       }
     } else {
-      console.log(`    Filters    ${source_default.green("OK")}  ${source_default.dim("drawtext, subtitles, afftdn")}`);
+      console.log(
+        `    Filters    ${source_default.green("OK")}  ${source_default.dim("drawtext, subtitles, afftdn")}`
+      );
     }
   }
   if (results.system.optionalTools) {
@@ -82121,7 +82307,9 @@ function printReport(results, opts = { verbose: false }) {
     if (verbose) {
       for (const [name, info] of tools) {
         if (info.installed) {
-          console.log(`    ${name.padEnd(11)}${source_default.green("OK")}  ${source_default.dim(info.commands.join(", "))}`);
+          console.log(
+            `    ${name.padEnd(11)}${source_default.green("OK")}  ${source_default.dim(info.commands.join(", "))}`
+          );
         } else {
           console.log(
             `    ${name.padEnd(11)}${source_default.yellow("MISSING")}  ${source_default.dim(`needed by: ${info.commands.join(", ")}`)}`
@@ -82149,11 +82337,14 @@ function printReport(results, opts = { verbose: false }) {
   const projectActive = results.scope.activeScope === "project";
   const activeMark = source_default.cyan(" \u2190 active");
   if (results.scope.user.configured) {
+    const userPath = results.scope.user.source === "legacy" ? `${results.scope.user.configPath} ${source_default.dim(`(legacy; writes ${results.scope.user.writePath})`)}` : results.scope.user.configPath;
     console.log(
-      `    Cfg(user)  ${source_default.green("OK")}       ${source_default.dim(results.scope.user.configPath)}${userActive ? activeMark : ""}`
+      `    Cfg(user)  ${source_default.green("OK")}       ${source_default.dim(userPath)}${userActive ? activeMark : ""}`
     );
   } else {
-    console.log(`    Cfg(user)  ${source_default.yellow("NOT SET")}  ${source_default.dim("Run: vibe setup")}`);
+    console.log(
+      `    Cfg(user)  ${source_default.yellow("NOT SET")}  ${source_default.dim(`Run: vibe setup  (writes ${results.scope.user.writePath})`)}`
+    );
   }
   if (results.scope.project.configFileExists) {
     console.log(
@@ -82168,7 +82359,9 @@ function printReport(results, opts = { verbose: false }) {
     const present = results.scope.project.files.filter((f) => f.exists).map((f) => f.path);
     console.log(`    Init       ${source_default.green("OK")}       ${source_default.dim(present.join(", "))}`);
   } else {
-    console.log(`    Init       ${source_default.yellow("NOT INIT")} ${source_default.dim(`Run: vibe init  (cwd: ${results.scope.project.cwd})`)}`);
+    console.log(
+      `    Init       ${source_default.yellow("NOT INIT")} ${source_default.dim(`Run: vibe init  (cwd: ${results.scope.project.cwd})`)}`
+    );
   }
   console.log(`    Agents     ${source_default.dim(results.scope.agentHosts.summary)}`);
   if (verbose) {
@@ -82189,12 +82382,18 @@ function printReport(results, opts = { verbose: false }) {
     }
     if (sc.sceneProjectInCwd) {
       if (sc.skillInstalled) {
-        console.log(`    SKILL.md     ${source_default.green("OK")}     ${source_default.dim("installed in this scene project")}`);
+        console.log(
+          `    SKILL.md     ${source_default.green("OK")}     ${source_default.dim("installed in this scene project")}`
+        );
       } else {
-        console.log(`    SKILL.md     ${source_default.yellow("MISSING")} ${source_default.dim("Run: vibe scene install-skill")}`);
+        console.log(
+          `    SKILL.md     ${source_default.yellow("MISSING")} ${source_default.dim("Run: vibe scene install-skill")}`
+        );
       }
     } else {
-      console.log(`    SKILL.md     ${source_default.dim("(no STORYBOARD.md in cwd \u2014 skill is per-scene-project)")}`);
+      console.log(
+        `    SKILL.md     ${source_default.dim("(no STORYBOARD.md in cwd \u2014 skill is per-scene-project)")}`
+      );
     }
   }
   console.log();
@@ -82227,7 +82426,9 @@ function printReport(results, opts = { verbose: false }) {
       }
     } else {
       console.log(
-        source_default.dim(`    ${missing.length} provider${missing.length === 1 ? "" : "s"} unconfigured (${missing.slice(0, 4).join(", ")}${missing.length > 4 ? ", \u2026" : ""}). Run with --verbose to list.`)
+        source_default.dim(
+          `    ${missing.length} provider${missing.length === 1 ? "" : "s"} unconfigured (${missing.slice(0, 4).join(", ")}${missing.length > 4 ? ", \u2026" : ""}). Run with --verbose to list.`
+        )
       );
     }
   }
@@ -82240,7 +82441,7 @@ function printReport(results, opts = { verbose: false }) {
   const pct = Math.round(results.readyCount / results.totalCount * 100);
   const readyColor = pct >= 80 ? source_default.green : pct >= 40 ? source_default.yellow : source_default.red;
   let catalogTotal = 0;
-  let tierCounts = { "free": 0, "low": 0, "high": 0, "very-high": 0 };
+  let tierCounts = { free: 0, low: 0, high: 0, "very-high": 0 };
   if (program3) {
     catalogTotal = countCatalog(program3);
     tierCounts = countCostTiers(program3);
@@ -82248,7 +82449,9 @@ function printReport(results, opts = { verbose: false }) {
   const taggedTotal = tierCounts.free + tierCounts.low + tierCounts.high + tierCounts["very-high"];
   console.log(source_default.bold("  Catalog"));
   if (catalogTotal > 0) {
-    console.log(`    Total commands         ${source_default.bold(catalogTotal)} ${source_default.dim("(see: vibe schema --list)")}`);
+    console.log(
+      `    Total commands         ${source_default.bold(catalogTotal)} ${source_default.dim("(see: vibe schema --list)")}`
+    );
   }
   console.log(
     `    Runnable with keys     ${readyColor(`${results.readyCount}/${results.totalCount}`)} ${source_default.dim(`(${pct}%)`)}`
@@ -82260,7 +82463,9 @@ function printReport(results, opts = { verbose: false }) {
       `${TIER_COLOR.high(`${tierCounts.high} high`)}`,
       `${TIER_COLOR["very-high"](`${tierCounts["very-high"]} very-high`)}`
     ];
-    console.log(`    Cost-tagged            ${source_default.bold(taggedTotal)}  ${parts.join(source_default.dim(", "))}`);
+    console.log(
+      `    Cost-tagged            ${source_default.bold(taggedTotal)}  ${parts.join(source_default.dim(", "))}`
+    );
   }
   const nextStep = pickNextStep(results, missing.length > 0);
   if (nextStep) {
@@ -82290,9 +82495,9 @@ function countCatalog(program3) {
 }
 function countCostTiers(program3) {
   const counts = {
-    "free": 0,
-    "low": 0,
-    "high": 0,
+    free: 0,
+    low: 0,
+    high: 0,
     "very-high": 0
   };
   const walk = (cmd) => {
@@ -82306,7 +82511,9 @@ function countCostTiers(program3) {
 async function runLiveKeyTests(results) {
   console.log();
   console.log(source_default.bold("  Live key tests"));
-  console.log(source_default.dim("    Hits each provider's cheapest authenticated endpoint with a 5s timeout."));
+  console.log(
+    source_default.dim("    Hits each provider's cheapest authenticated endpoint with a 5s timeout.")
+  );
   const configured = Object.entries(results.providers).filter(([, info]) => info.configured);
   if (configured.length === 0) {
     console.log(source_default.dim("    No keys configured \u2014 nothing to test."));
@@ -83981,20 +84188,16 @@ init_source();
 init_config();
 init_schema();
 init_api_key();
-import { access as access10, writeFile as writeFile58, mkdir as mkdir28 } from "node:fs/promises";
+import { access as access9, writeFile as writeFile58, mkdir as mkdir28 } from "node:fs/promises";
 import { dirname as dirname25 } from "node:path";
-var BANNER_SHOWN_PATH = CONFIG_PATH.replace(/config\.yaml$/, ".banner-shown");
+var BANNER_SHOWN_PATH = `${USER_CONFIG_DIR}/.banner-shown`;
 async function isFirstRun() {
   try {
-    await access10(BANNER_SHOWN_PATH);
-    return false;
-  } catch {
-  }
-  try {
-    await access10(CONFIG_PATH);
+    await access9(BANNER_SHOWN_PATH);
     return false;
   } catch {
   }
+  if (await loadConfig({ scope: "user" })) return false;
   loadEnv();
   for (const envVar of Object.values(PROVIDER_ENV_VARS)) {
     if (process.env[envVar]) {
@@ -84015,12 +84218,16 @@ function showFirstRunBanner() {
   console.log(source_default.cyan.bold("  Welcome to VibeFrame!"));
   console.log(source_default.dim("  AI-native video editing from your terminal."));
   console.log();
-  console.log(`  ${source_default.white("1.")} ${source_default.green("vibe setup")}         Configure API keys ${source_default.dim("(1 min)")}`);
+  console.log(
+    `  ${source_default.white("1.")} ${source_default.green("vibe setup")}         Configure API keys ${source_default.dim("(1 min)")}`
+  );
   console.log(`  ${source_default.white("2.")} ${source_default.green("vibe doctor")}        Check system health`);
   console.log(`  ${source_default.white("3.")} ${source_default.green("vibe --help")}        See all commands`);
   console.log();
   console.log(source_default.dim("  Try without keys:"));
-  console.log(`    ${source_default.green("vibe demo")}                          Run sample edits on a test video`);
+  console.log(
+    `    ${source_default.green("vibe demo")}                          Run sample edits on a test video`
+  );
   console.log(source_default.dim("    vibe edit silence-cut video.mp4 -o clean.mp4"));
   console.log(source_default.dim("    vibe detect scenes video.mp4"));
   console.log();

package/package.json

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