@vibeframe/mcp-server 0.98.0 → 0.99.0

package/dist/index.js

@@ -465926,12 +465926,21 @@ function isExternalRef(value) {
 }
 
 // ../cli/src/commands/_shared/render-inspect.ts
+init_ai_review();
 init_exec_safe();
 init_project_config();
 import { existsSync as existsSync50 } from "node:fs";
 import { readdir as readdir6, readFile as readFile27, stat as stat5 } from "node:fs/promises";
 import { basename as basename13, isAbsolute as isAbsolute6, join as join35, relative as relative12, resolve as resolve45 } from "node:path";
 var VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([".mp4", ".mov", ".webm", ".m4v"]);
+var DEFAULT_AI_MODEL = "flash";
+var AI_CATEGORY_LABELS = {
+  pacing: "Pacing",
+  color: "Color",
+  textReadability: "Text readability",
+  audioVisualSync: "Audio-visual sync",
+  composition: "Composition"
+};
 function parseBlackdetectOutput(output3) {
   const ranges = [];
   const regex2 = /black_start:(-?\d+(?:\.\d+)?)\s+black_end:(-?\d+(?:\.\d+)?)\s+black_duration:(-?\d+(?:\.\d+)?)/g;
@@ -465966,16 +465975,79 @@ function parseSilencedetectOutput(output3) {
   }
   return ranges;
 }
+async function previewInspectRender(opts) {
+  const projectDir = resolve45(opts.projectDir);
+  const videoPath = await resolveRenderVideoPath(projectDir, opts.videoPath);
+  const writeReport = opts.writeReport !== false;
+  const reportPath = writeReport ? opts.outputPath ? resolve45(process.cwd(), opts.outputPath) : defaultReviewReportPath(projectDir) : void 0;
+  const storyboardPath = 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
+    }
+  };
+}
+function aiReviewSeverity(score) {
+  if (score <= 4) return "error";
+  if (score <= 6) return "warning";
+  return "info";
+}
+function mapAiReviewFeedbackToIssues(feedback, videoPath) {
+  const issues = [];
+  for (const [key2, label] of Object.entries(AI_CATEGORY_LABELS)) {
+    const category = feedback.categories[key2];
+    if (!category || category.issues.length === 0) continue;
+    for (const issue of category.issues) {
+      issues.push({
+        severity: aiReviewSeverity(category.score),
+        code: `AI_REVIEW_${toSnakeCase(String(key2))}`,
+        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 = resolve45(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",
@@ -465984,13 +466056,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)
@@ -466128,6 +466203,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",
@@ -466135,7 +466244,7 @@ async function inspectRender(opts) {
     project: projectDir,
     videoPath,
     status,
-    score: scoreIssues(issues),
+    score: scoreRenderReview(issues, aiOverallScore),
     issues,
     checks,
     retryWith: uniqueRetryWith(retryWith)
@@ -466184,6 +466293,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 storyboardPath = join35(projectDir, "STORYBOARD.md");
+  return existsSync50(storyboardPath) ? storyboardPath : null;
+}
 async function expectedDurationFromBuildReport(projectDir) {
   const reportPath = join35(projectDir, "build-report.json");
   if (!existsSync50(reportPath)) return void 0;
@@ -466245,6 +466367,9 @@ function aspectRatio(aspect) {
 function displayPath(path14) {
   return relative12(process.cwd(), path14) || basename13(path14);
 }
+function toSnakeCase(value) {
+  return value.replace(/[A-Z]/g, (match2) => `_${match2}`).toUpperCase();
+}
 
 // ../cli/src/tools/manifest/inspect.ts
 var inspectProjectTool = defineTool({
@@ -466278,21 +466403,44 @@ var inspectProjectTool = defineTool({
 var 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: z4.object({
     projectDir: z4.string().optional().describe("Project directory. Defaults to the surface's cwd."),
     videoPath: z4.string().optional().describe("Rendered video path. Defaults to build-report outputPath or latest renders/* video."),
     outputPath: z4.string().optional().describe("Optional review report path. Defaults to <project>/review-report.json."),
-    report: z4.boolean().optional().describe("Write review-report.json. Default true.")
+    report: z4.boolean().optional().describe("Write review-report.json. Default true."),
+    ai: z4.boolean().optional().describe("Also run Gemini video review and merge findings into review-report.json. Default false."),
+    model: z4.enum(["flash", "flash-2.5", "pro"]).optional().describe("Gemini model variant for ai review. Default flash."),
+    dryRun: z4.boolean().optional().describe("Preview resolved inputs without probing video or calling Gemini.")
   }),
   async execute(args, ctx) {
     const projectDir = args.projectDir ? resolve46(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+    if (args.dryRun) {
+      const result2 = await previewInspectRender({
+        projectDir,
+        videoPath: args.videoPath ? resolve46(ctx.workingDirectory, args.videoPath) : void 0,
+        outputPath: args.outputPath ? resolve46(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 ? resolve46(ctx.workingDirectory, args.videoPath) : void 0,
       outputPath: args.outputPath ? resolve46(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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.98.0",
+  "version": "0.99.0",
   "description": "VibeFrame MCP Server - AI-native video editing via Model Context Protocol",
   "type": "module",
   "bin": {
@@ -57,8 +57,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/cli": "0.98.0",
-    "@vibeframe/core": "0.98.0"
+    "@vibeframe/cli": "0.99.0",
+    "@vibeframe/core": "0.99.0"
   },
   "engines": {
     "node": ">=20"