@vibeframe/cli 0.98.0 → 0.99.0

package/CONTEXT.md

@@ -132,7 +132,7 @@ legacy vibe.project.yaml → configured/env default → VibeFrame default
 |-------|----------|
 | `generate` | Always `--dry-run` first. Costs money. `-p` selects provider; default routes via key availability. |
 | `edit` | FFmpeg-only leaves (silence-cut, fade, noise-reduce, text-overlay, interpolate) are free. caption/grade/reframe/image need API keys. |
-| `inspect` | `inspect project` and `inspect render --cheap` are free/local. Gemini media/review calls are low cost. |
+| `inspect` | `inspect project` and `inspect render --cheap` are local. Use `inspect render --ai` for final Gemini critique; Gemini media/review calls are low cost. |
 | `audio` | `transcribe` low cost (Whisper). `dub` is full pipeline (medium-high). `duck` is free. |
 | `remix` | **Confirm with user.** Multi-step, high cost ($5–50+). Always `--dry-run`. |
 | `detect` | Free, FFmpeg only. No keys. |
@@ -163,6 +163,7 @@ vibe build my-video --max-cost 5 --json
 vibe inspect project my-video --json
 vibe render my-video -o renders/final.mp4 --json
 vibe inspect render my-video --cheap --json
+vibe inspect render my-video --ai --json
 vibe scene repair --project my-video --json
 ```
 

package/dist/index.js

@@ -41385,16 +41385,79 @@ function parseSilencedetectOutput(output) {
   }
   return ranges;
 }
+async function previewInspectRender(opts) {
+  const projectDir = resolve38(opts.projectDir);
+  const videoPath = await resolveRenderVideoPath(projectDir, opts.videoPath);
+  const writeReport = opts.writeReport !== false;
+  const reportPath = writeReport ? opts.outputPath ? resolve38(process.cwd(), opts.outputPath) : defaultReviewReportPath(projectDir) : void 0;
+  const storyboardPath2 = resolveStoryboardPath(projectDir);
+  return {
+    schemaVersion: "1",
+    kind: "render",
+    project: projectDir,
+    videoPath,
+    reportPath,
+    params: {
+      projectDir,
+      videoPath: opts.videoPath,
+      outputPath: opts.outputPath,
+      writeReport,
+      cheap: true,
+      ai: opts.ai === true,
+      model: opts.model ?? DEFAULT_AI_MODEL
+    },
+    checks: {
+      renderFound: videoPath !== null,
+      storyboardPath: storyboardPath2
+    }
+  };
+}
+function aiReviewSeverity(score) {
+  if (score <= 4) return "error";
+  if (score <= 6) return "warning";
+  return "info";
+}
+function mapAiReviewFeedbackToIssues(feedback, videoPath) {
+  const issues = [];
+  for (const [key, label] of Object.entries(AI_CATEGORY_LABELS)) {
+    const category = feedback.categories[key];
+    if (!category || category.issues.length === 0) continue;
+    for (const issue of category.issues) {
+      issues.push({
+        severity: aiReviewSeverity(category.score),
+        code: `AI_REVIEW_${toSnakeCase(String(key))}`,
+        message: `${label}: ${issue}`,
+        file: videoPath ? displayPath(videoPath) : void 0,
+        suggestedFix: category.fixable ? "Adjust the relevant storyboard or scene composition, then rerender." : "Review this finding manually before rerendering."
+      });
+    }
+  }
+  return issues;
+}
+function scoreRenderReview(issues, aiOverallScore) {
+  const localScore = scoreIssues(issues);
+  if (aiOverallScore === void 0) return localScore;
+  const aiScore = Math.max(0, Math.min(100, Math.round(aiOverallScore * 10)));
+  return Math.round((localScore + aiScore) / 2);
+}
 async function inspectRender(opts) {
   const projectDir = resolve38(opts.projectDir);
   const issues = [];
   const retryWith = [];
+  const model = opts.model ?? DEFAULT_AI_MODEL;
   const videoPath = await resolveRenderVideoPath(projectDir, opts.videoPath);
   const checks = {
     renderFound: videoPath !== null,
     blackFrames: [],
     silences: []
   };
+  if (opts.ai) {
+    checks.ai = {
+      enabled: true,
+      model,
+      success: false
+    };
+  }
   if (!videoPath) {
     issues.push({
       severity: "error",
@@ -41403,13 +41466,16 @@ async function inspectRender(opts) {
       suggestedFix: "Run `vibe build --stage render --json` or `vibe render --json`."
     });
     retryWith.push(`vibe build ${projectDir} --stage render --json`, `vibe render ${projectDir} --json`);
+    if (checks.ai) {
+      checks.ai.error = "Skipped AI review because no rendered video was found.";
+    }
     return maybeWriteRenderReport(projectDir, opts, {
       schemaVersion: "1",
       kind: "render",
       project: projectDir,
       videoPath: null,
       status: "fail",
-      score: scoreIssues(issues),
+      score: scoreRenderReview(issues),
       issues,
       checks,
       retryWith: uniqueRetryWith(retryWith)
@@ -41547,6 +41613,40 @@ async function inspectRender(opts) {
       suggestedFix: "Install FFmpeg for full cheap render inspection."
     });
   }
+  let aiOverallScore;
+  if (opts.ai && checks.ai) {
+    if (fileStat.size === 0) {
+      checks.ai.error = "Skipped AI review because the rendered video file is empty.";
+    } else {
+      const aiResult = await runAiRenderReview(projectDir, videoPath, model);
+      if (aiResult.success && aiResult.feedback) {
+        checks.ai.success = true;
+        checks.ai.overallScore = aiResult.feedback.overallScore;
+        checks.ai.categories = aiResult.feedback.categories;
+        checks.ai.recommendations = aiResult.feedback.recommendations;
+        aiOverallScore = aiResult.feedback.overallScore;
+        const aiIssues = mapAiReviewFeedbackToIssues(aiResult.feedback, videoPath);
+        issues.push(...aiIssues);
+        if (aiIssues.length > 0) {
+          retryWith.push(
+            'codex "fix issues from review-report.json"',
+            `vibe render ${projectDir} --json`,
+            `vibe inspect render ${projectDir} --ai --json`
+          );
+        }
+      } else {
+        const message = aiResult.error ?? "Gemini video review failed";
+        checks.ai.error = message;
+        issues.push({
+          severity: "error",
+          code: "AI_REVIEW_FAILED",
+          message: `AI render review failed: ${message}`,
+          file: displayPath(videoPath),
+          suggestedFix: "Set GOOGLE_API_KEY or retry the AI review later."
+        });
+      }
+    }
+  }
   const status = statusFromIssues(issues);
   const result = {
     schemaVersion: "1",
@@ -41554,7 +41654,7 @@ async function inspectRender(opts) {
     project: projectDir,
     videoPath,
     status,
-    score: scoreIssues(issues),
+    score: scoreRenderReview(issues, aiOverallScore),
     issues,
     checks,
     retryWith: uniqueRetryWith(retryWith)
@@ -41603,6 +41703,19 @@ async function resolveRenderVideoPath(projectDir, explicit) {
   candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
   return candidates[0]?.path ?? null;
 }
+async function runAiRenderReview(projectDir, videoPath, model) {
+  return executeReview({
+    videoPath,
+    storyboardPath: resolveStoryboardPath(projectDir) ?? void 0,
+    autoApply: false,
+    verify: false,
+    model
+  });
+}
+function resolveStoryboardPath(projectDir) {
+  const storyboardPath2 = join14(projectDir, "STORYBOARD.md");
+  return existsSync30(storyboardPath2) ? storyboardPath2 : null;
+}
 async function expectedDurationFromBuildReport(projectDir) {
   const reportPath = join14(projectDir, "build-report.json");
   if (!existsSync30(reportPath)) return void 0;
@@ -41664,14 +41777,26 @@ function aspectRatio(aspect) {
 function displayPath(path2) {
   return relative8(process.cwd(), path2) || basename11(path2);
 }
-var VIDEO_EXTENSIONS;
+function toSnakeCase(value) {
+  return value.replace(/[A-Z]/g, (match) => `_${match}`).toUpperCase();
+}
+var VIDEO_EXTENSIONS, DEFAULT_AI_MODEL, AI_CATEGORY_LABELS;
 var init_render_inspect = __esm({
   "src/commands/_shared/render-inspect.ts"() {
     "use strict";
+    init_ai_review();
     init_exec_safe();
     init_project_config();
     init_review_report();
     VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([".mp4", ".mov", ".webm", ".m4v"]);
+    DEFAULT_AI_MODEL = "flash";
+    AI_CATEGORY_LABELS = {
+      pacing: "Pacing",
+      color: "Color",
+      textReadability: "Text readability",
+      audioVisualSync: "Audio-visual sync",
+      composition: "Composition"
+    };
   }
 });
 
@@ -62587,21 +62712,44 @@ var init_inspect = __esm({
     inspectRenderTool = defineTool({
       name: "inspect_render",
       category: "analyze",
-      cost: "free",
-      description: "Cheap local render inspection: finds the rendered video, probes duration/dimensions/audio, scans black frames and long silence, and writes review-report.json by default.",
+      cost: "low",
+      description: "Render inspection: runs cheap local video checks by default, optionally adds Gemini AI review with ai: true, and writes review-report.json by default.",
       schema: external_exports.object({
         projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
         videoPath: external_exports.string().optional().describe("Rendered video path. Defaults to build-report outputPath or latest renders/* video."),
         outputPath: external_exports.string().optional().describe("Optional review report path. Defaults to <project>/review-report.json."),
-        report: external_exports.boolean().optional().describe("Write review-report.json. Default true.")
+        report: external_exports.boolean().optional().describe("Write review-report.json. Default true."),
+        ai: external_exports.boolean().optional().describe("Also run Gemini video review and merge findings into review-report.json. Default false."),
+        model: external_exports.enum(["flash", "flash-2.5", "pro"]).optional().describe("Gemini model variant for ai review. Default flash."),
+        dryRun: external_exports.boolean().optional().describe("Preview resolved inputs without probing video or calling Gemini.")
       }),
       async execute(args, ctx) {
         const projectDir = args.projectDir ? resolve68(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        if (args.dryRun) {
+          const result2 = await previewInspectRender({
+            projectDir,
+            videoPath: args.videoPath ? resolve68(ctx.workingDirectory, args.videoPath) : void 0,
+            outputPath: args.outputPath ? resolve68(ctx.workingDirectory, args.outputPath) : void 0,
+            writeReport: args.report !== false,
+            ai: args.ai === true,
+            model: args.model
+          });
+          return {
+            success: true,
+            data: result2,
+            humanLines: [
+              `Render inspection dry-run \u2014 ${result2.videoPath ? "render found" : "render missing"}`,
+              ...result2.reportPath ? [`report: ${result2.reportPath}`] : []
+            ]
+          };
+        }
         const result = await inspectRender({
           projectDir,
           videoPath: args.videoPath ? resolve68(ctx.workingDirectory, args.videoPath) : void 0,
           outputPath: args.outputPath ? resolve68(ctx.workingDirectory, args.outputPath) : void 0,
-          writeReport: args.report !== false
+          writeReport: args.report !== false,
+          ai: args.ai === true,
+          model: args.model
         });
         return {
           success: result.status !== "fail",
@@ -66074,7 +66222,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.98.0",
+  version: "0.99.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -67264,12 +67412,14 @@ init_scene_inspect();
 init_render_inspect();
 import { readFile as readFile26, writeFile as writeFile32 } from "node:fs/promises";
 import { resolve as resolve39 } from "node:path";
+var VALID_RENDER_AI_MODELS = ["flash", "flash-2.5", "pro"];
 var inspectCommand = new Command("inspect").description("Inspect media using AI (images, videos, YouTube URLs)").addHelpText(
   "after",
   `
 Examples:
   $ vibe inspect project my-video --json
   $ vibe inspect render my-video --cheap --json
+  $ vibe inspect render my-video --ai --json
   $ vibe inspect media image.png "Describe this image"
   $ vibe inspect media video.mp4 "Summarize this video"
   $ vibe inspect media "https://youtube.com/watch?v=..." "Key takeaways"
@@ -67308,14 +67458,36 @@ inspectCommand.command("project").description("Inspect project completeness, sto
   }
 });
 applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "free");
-inspectCommand.command("render").description("Inspect a rendered project video with local cheap checks").argument("[project-dir]", "VibeFrame project directory", ".").option("--cheap", "Run local checks only (default; no AI/API calls)").option("--video <path>", "Rendered video path. Defaults to build-report outputPath or latest renders/* video.").option("-o, --output <path>", "Write review report to this path (default: <project>/review-report.json)").option("--no-report", "Do not write review-report.json").action(async (projectDirArg, options) => {
+inspectCommand.command("render").description("Inspect a rendered project video with local checks and optional Gemini review").argument("[project-dir]", "VibeFrame project directory", ".").option("--cheap", "Run local checks only (default; no AI/API calls)").option("--ai", "Also run Gemini video review and merge findings into review-report.json").option("-m, --model <model>", "Gemini model for --ai: flash (default), flash-2.5, pro", "flash").option("--video <path>", "Rendered video path. Defaults to build-report outputPath or latest renders/* video.").option("-o, --output <path>", "Write review report to this path (default: <project>/review-report.json)").option("--no-report", "Do not write review-report.json").option("--dry-run", "Preview parameters without probing video or calling Gemini").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
   try {
+    const model = parseRenderAiModel(options.model);
+    const projectDir = resolve39(projectDirArg);
+    if (options.dryRun) {
+      const result2 = await previewInspectRender({
+        projectDir,
+        videoPath: options.video,
+        outputPath: options.output,
+        writeReport: options.report !== false,
+        ai: options.ai === true,
+        model
+      });
+      outputSuccess({
+        command: "inspect render",
+        startedAt,
+        dryRun: true,
+        costUsd: options.ai ? 0.1 : 0,
+        data: { ...result2 }
+      });
+      return;
+    }
     const result = await inspectRender({
-      projectDir: resolve39(projectDirArg),
+      projectDir,
       videoPath: options.video,
       outputPath: options.output,
-      writeReport: options.report !== false
+      writeReport: options.report !== false,
+      ai: options.ai === true,
+      model
     });
     if (isJsonMode()) {
       outputSuccess({
@@ -67332,7 +67504,7 @@ inspectCommand.command("render").description("Inspect a rendered project video w
     exitWithError(generalError(`Render inspection failed: ${error instanceof Error ? error.message : String(error)}`));
   }
 });
-applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "free");
+applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "low");
 inspectCommand.command("media").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
   const startedAt = Date.now();
   try {
@@ -67431,6 +67603,12 @@ function printInspectSummary(title, status, score, issues, reportPath) {
     if (issue.suggestedFix) console.log(`       ${source_default.dim(issue.suggestedFix)}`);
   }
 }
+function parseRenderAiModel(value) {
+  if (VALID_RENDER_AI_MODELS.includes(value)) {
+    return value;
+  }
+  exitWithError(usageError(`Invalid --model: ${value}`, `Must be one of: ${VALID_RENDER_AI_MODELS.join(", ")}`));
+}
 inspectCommand.command("video").description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
   const startedAt = Date.now();
   try {
@@ -76504,7 +76682,8 @@ var contextCommand = new Command("context").description("Print CLI context/guide
       "build",
       "inspect project",
       "render",
-      "inspect render --cheap"
+      "inspect render --cheap",
+      "inspect render --ai when needed"
     ],
     mentalModel: {
       storyboard: "intent layer; edit or mutate beat cues here",
@@ -76520,7 +76699,7 @@ var contextCommand = new Command("context").description("Print CLI context/guide
     ],
     semanticFixes: "host-agent",
     mechanicalFixes: "vibe scene repair; vibe scene lint --fix remains the lower-level primitive",
-    publicFlow: "vibe init --from <brief> -> edit STORYBOARD.md/DESIGN.md -> vibe storyboard validate -> vibe plan -> vibe build --dry-run --max-cost <usd> -> vibe build -> vibe inspect project -> vibe render -> vibe inspect render --cheap"
+    publicFlow: "vibe init --from <brief> -> edit STORYBOARD.md/DESIGN.md -> vibe storyboard validate -> vibe plan -> vibe build --dry-run --max-cost <usd> -> vibe build -> vibe inspect project -> vibe render -> vibe inspect render --cheap -> optional vibe inspect render --ai"
   };
   if (options.json) {
     console.log(JSON.stringify(contract, null, 2));
@@ -76537,8 +76716,9 @@ var contextCommand = new Command("context").description("Print CLI context/guide
 Source of truth: \`STORYBOARD.md\`, \`DESIGN.md\`, and \`vibe.config.json\`.
 \`STORYBOARD.md\` is the intent layer. Generated scene files under
 \`compositions/\` are artifact layer. Use \`vibe storyboard *\` for narrow
-cue edits; use \`vibe inspect project\`, \`vibe inspect render --cheap\`, and
-\`vibe scene repair\` for deterministic local review and mechanical fixes.
+cue edits; use \`vibe inspect project\`, \`vibe inspect render --cheap\`,
+\`vibe inspect render --ai\`, and \`vibe scene repair\` for local and AI
+review plus mechanical fixes.
 Semantic creative fixes belong to the host agent.
 
 Canonical flow:
@@ -76552,6 +76732,7 @@ vibe build my-video --max-cost 5 --json
 vibe inspect project my-video --json
 vibe render my-video --json
 vibe inspect render my-video --cheap --json
+vibe inspect render my-video --ai --json
 \`\`\`
 
 Provider precedence: CLI flag -> storyboard cue -> \`vibe.config.json\` ->

package/package.json

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