@vibeframe/cli 0.27.0

package/dist/commands/ai-narrate.js

@@ -0,0 +1,329 @@
+/**
+ * @module ai-narrate
+ *
+ * Auto-narration pipeline and provider listing.
+ *
+ * CLI commands: narrate, providers
+ *
+ * Execute function:
+ *   autoNarrate - Analyze video -> generate script -> TTS voiceover
+ *
+ * Extracted from ai.ts as part of modularisation.
+ * ai.ts calls registerNarrateCommands(aiCommand).
+ *
+ * @dependencies Gemini (video analysis), Claude/OpenAI (script generation),
+ *              ElevenLabs (TTS), FFmpeg (duration probe)
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { resolve, dirname, basename } from "node:path";
+import { existsSync } from "node:fs";
+import chalk from "chalk";
+import ora from "ora";
+import { providerRegistry, whisperProvider, geminiProvider, openaiProvider, claudeProvider, elevenLabsProvider, openaiImageProvider, runwayProvider, klingProvider, replicateProvider, GeminiProvider, OpenAIProvider, ClaudeProvider, ElevenLabsProvider, } from "@vibeframe/ai-providers";
+import { Project } from "../engine/index.js";
+import { getApiKey } from "../utils/api-key.js";
+import { ffprobeDuration } from "../utils/exec-safe.js";
+import { getAudioDuration } from "../utils/audio.js";
+import { formatTime } from "./ai-helpers.js";
+/**
+ * Generate narration for a video that doesn't have one.
+ *
+ * Pipeline:
+ * 1. Analyze video with Gemini Video Understanding
+ * 2. Generate narration script with Claude (fallback to OpenAI on 529)
+ * 3. Convert to speech with ElevenLabs TTS
+ *
+ * Saves both the audio file and script text to the output directory.
+ *
+ * @param options - Auto-narrate configuration
+ * @returns Result with audio path, script text, and timed segments
+ */
+export async function autoNarrate(options) {
+    const { videoPath, duration, outputDir, voice = "rachel", style = "informative", language = "en", scriptProvider = "claude", } = options;
+    // Validate API keys
+    const geminiApiKey = await getApiKey("GOOGLE_API_KEY", "Google");
+    if (!geminiApiKey) {
+        return { success: false, error: "GOOGLE_API_KEY required for video analysis. Run 'vibe setup' or set GOOGLE_API_KEY in .env" };
+    }
+    let claudeApiKey = null;
+    let openaiScriptApiKey = null;
+    if (scriptProvider === "openai") {
+        openaiScriptApiKey = await getApiKey("OPENAI_API_KEY", "OpenAI");
+        if (!openaiScriptApiKey) {
+            return { success: false, error: "OPENAI_API_KEY required for script generation. Run 'vibe setup' or set OPENAI_API_KEY in .env" };
+        }
+    }
+    else {
+        claudeApiKey = await getApiKey("ANTHROPIC_API_KEY", "Anthropic");
+        if (!claudeApiKey) {
+            return { success: false, error: "ANTHROPIC_API_KEY required for script generation. Run 'vibe setup' or set ANTHROPIC_API_KEY in .env" };
+        }
+    }
+    const elevenlabsApiKey = await getApiKey("ELEVENLABS_API_KEY", "ElevenLabs");
+    if (!elevenlabsApiKey) {
+        return { success: false, error: "ELEVENLABS_API_KEY required for TTS. Run 'vibe setup' or set ELEVENLABS_API_KEY in .env" };
+    }
+    try {
+        // Step 1: Analyze video with Gemini
+        const gemini = new GeminiProvider();
+        await gemini.initialize({ apiKey: geminiApiKey });
+        const videoBuffer = await readFile(videoPath);
+        const analysisPrompt = `Analyze this video in detail for narration purposes. Describe:
+1. What is happening visually (actions, movements, subjects)
+2. The setting and environment
+3. Any text or graphics visible
+4. The mood and tone of the content
+5. Key moments and their approximate timestamps
+
+Provide a detailed description that could be used to write a voiceover narration.
+Focus on what viewers need to know to understand and appreciate the video.`;
+        const analysisResult = await gemini.analyzeVideo(videoBuffer, analysisPrompt, {
+            fps: 0.5, // Lower FPS for cost optimization
+            lowResolution: duration > 60, // Use low res for longer videos
+        });
+        if (!analysisResult.success || !analysisResult.response) {
+            return { success: false, error: `Video analysis failed: ${analysisResult.error}` };
+        }
+        // Step 2: Generate narration script with Claude or OpenAI
+        let scriptResult;
+        if (scriptProvider === "openai") {
+            const gpt = new OpenAIProvider();
+            await gpt.initialize({ apiKey: openaiScriptApiKey });
+            scriptResult = await gpt.generateNarrationScript(analysisResult.response, duration, style, language);
+        }
+        else {
+            const claude = new ClaudeProvider();
+            await claude.initialize({ apiKey: claudeApiKey });
+            scriptResult = await claude.generateNarrationScript(analysisResult.response, duration, style, language);
+            // Auto-fallback to OpenAI on Claude overload (529)
+            if (!scriptResult.success && scriptResult.error?.includes("529")) {
+                const fallbackKey = await getApiKey("OPENAI_API_KEY", "OpenAI");
+                if (fallbackKey) {
+                    console.error("⚠️  Claude overloaded, falling back to OpenAI...");
+                    const gpt = new OpenAIProvider();
+                    await gpt.initialize({ apiKey: fallbackKey });
+                    scriptResult = await gpt.generateNarrationScript(analysisResult.response, duration, style, language);
+                }
+            }
+        }
+        if (!scriptResult.success || !scriptResult.script) {
+            return { success: false, error: `Script generation failed: ${scriptResult.error}` };
+        }
+        // Step 3: Convert to speech with ElevenLabs
+        const elevenlabs = new ElevenLabsProvider();
+        await elevenlabs.initialize({ apiKey: elevenlabsApiKey });
+        const ttsResult = await elevenlabs.textToSpeech(scriptResult.script, {
+            voiceId: voice,
+        });
+        if (!ttsResult.success || !ttsResult.audioBuffer) {
+            return { success: false, error: `TTS generation failed: ${ttsResult.error}` };
+        }
+        // Ensure output directory exists
+        if (!existsSync(outputDir)) {
+            await mkdir(outputDir, { recursive: true });
+        }
+        // Save audio file
+        const audioPath = resolve(outputDir, "auto-narration.mp3");
+        await writeFile(audioPath, ttsResult.audioBuffer);
+        // Save script for reference
+        const scriptPath = resolve(outputDir, "narration-script.txt");
+        await writeFile(scriptPath, scriptResult.script, "utf-8");
+        return {
+            success: true,
+            audioPath,
+            script: scriptResult.script,
+            segments: scriptResult.segments,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error in autoNarrate",
+        };
+    }
+}
+// ==========================================
+// CLI Command Registration
+// ==========================================
+export function registerNarrateCommands(ai) {
+    ai
+        .command("providers")
+        .description("List available AI providers")
+        .action(async () => {
+        // Register default providers
+        providerRegistry.register(whisperProvider);
+        providerRegistry.register(geminiProvider);
+        providerRegistry.register(openaiProvider);
+        providerRegistry.register(claudeProvider);
+        providerRegistry.register(elevenLabsProvider);
+        providerRegistry.register(openaiImageProvider);
+        providerRegistry.register(runwayProvider);
+        providerRegistry.register(klingProvider);
+        providerRegistry.register(replicateProvider);
+        console.log();
+        console.log(chalk.bold.cyan("Available AI Providers"));
+        console.log(chalk.dim("─".repeat(60)));
+        const providers = providerRegistry.getAll();
+        for (const provider of providers) {
+            const status = provider.isAvailable ? chalk.green("●") : chalk.red("○");
+            console.log();
+            console.log(`${status} ${chalk.bold(provider.name)} ${chalk.dim(`(${provider.id})`)}`);
+            console.log(`  ${provider.description}`);
+            console.log(`  ${chalk.dim("Capabilities:")} ${provider.capabilities.join(", ")}`);
+        }
+        console.log();
+    });
+    // Auto-Narrate command
+    ai
+        .command("narrate")
+        .description("Generate AI narration for a video file or project")
+        .argument("<input>", "Video file or project file (.vibe.json)")
+        .option("-o, --output <dir>", "Output directory for generated files", ".")
+        .option("-v, --voice <name>", "ElevenLabs voice name (rachel, adam, josh, etc.)", "rachel")
+        .option("-s, --style <style>", "Narration style: informative, energetic, calm, dramatic", "informative")
+        .option("-l, --language <lang>", "Language code (e.g., en, ko)", "en")
+        .option("-p, --provider <name>", "LLM for script generation: claude (default), openai", "claude")
+        .option("--add-to-project", "Add narration to project (only for .vibe.json input)")
+        .action(async (inputPath, options) => {
+        try {
+            const absPath = resolve(process.cwd(), inputPath);
+            if (!existsSync(absPath)) {
+                console.error(chalk.red(`File not found: ${absPath}`));
+                process.exit(1);
+            }
+            console.log();
+            console.log(chalk.bold.cyan("🎙️ Auto-Narrate Pipeline"));
+            console.log(chalk.dim("─".repeat(60)));
+            console.log();
+            const isProject = inputPath.endsWith(".vibe.json");
+            let videoPath;
+            let project = null;
+            let outputDir = resolve(process.cwd(), options.output);
+            if (isProject) {
+                // Load project to find video source
+                const content = await readFile(absPath, "utf-8");
+                const data = JSON.parse(content);
+                project = Project.fromJSON(data);
+                const sources = project.getSources();
+                const videoSource = sources.find((s) => s.type === "video");
+                if (!videoSource) {
+                    console.error(chalk.red("No video source found in project"));
+                    process.exit(1);
+                }
+                videoPath = resolve(dirname(absPath), videoSource.url);
+                if (!existsSync(videoPath)) {
+                    console.error(chalk.red(`Video file not found: ${videoPath}`));
+                    process.exit(1);
+                }
+                // Use project directory as output if not specified
+                if (options.output === ".") {
+                    outputDir = dirname(absPath);
+                }
+                console.log(`📁 Project: ${chalk.bold(project.getMeta().name)}`);
+            }
+            else {
+                videoPath = absPath;
+                console.log(`🎬 Video: ${chalk.bold(basename(videoPath))}`);
+            }
+            // Get video duration
+            const durationSpinner = ora("📊 Analyzing video...").start();
+            let duration;
+            try {
+                duration = await ffprobeDuration(videoPath);
+                durationSpinner.succeed(chalk.green(`Duration: ${formatTime(duration)}`));
+            }
+            catch {
+                durationSpinner.fail(chalk.red("Failed to get video duration"));
+                process.exit(1);
+            }
+            // Validate style option
+            const validStyles = ["informative", "energetic", "calm", "dramatic"];
+            if (!validStyles.includes(options.style)) {
+                console.error(chalk.red(`Invalid style: ${options.style}`));
+                console.error(chalk.dim(`Valid styles: ${validStyles.join(", ")}`));
+                process.exit(1);
+            }
+            // Generate narration
+            const generateSpinner = ora("🤖 Generating narration...").start();
+            generateSpinner.text = "📹 Analyzing video with Gemini...";
+            const result = await autoNarrate({
+                videoPath,
+                duration,
+                outputDir,
+                voice: options.voice,
+                style: options.style,
+                language: options.language,
+                scriptProvider: options.provider,
+            });
+            if (!result.success) {
+                generateSpinner.fail(chalk.red(`Failed: ${result.error}`));
+                process.exit(1);
+            }
+            generateSpinner.succeed(chalk.green("Narration generated successfully"));
+            // Display result
+            console.log();
+            console.log(chalk.bold.cyan("Generated Files"));
+            console.log(chalk.dim("─".repeat(60)));
+            console.log(`  🎵 Audio: ${chalk.green(result.audioPath)}`);
+            console.log(`  📝 Script: ${chalk.green(resolve(outputDir, "narration-script.txt"))}`);
+            if (result.segments && result.segments.length > 0) {
+                console.log();
+                console.log(chalk.bold.cyan("Narration Segments"));
+                console.log(chalk.dim("─".repeat(60)));
+                for (const seg of result.segments.slice(0, 5)) {
+                    console.log(`  [${formatTime(seg.startTime)} - ${formatTime(seg.endTime)}] ${chalk.dim(seg.text.substring(0, 50))}${seg.text.length > 50 ? "..." : ""}`);
+                }
+                if (result.segments.length > 5) {
+                    console.log(chalk.dim(`  ... and ${result.segments.length - 5} more segments`));
+                }
+            }
+            // Add to project if requested
+            if (options.addToProject && project && isProject) {
+                const addSpinner = ora("Adding narration to project...").start();
+                // Get audio duration
+                let audioDuration;
+                try {
+                    audioDuration = await getAudioDuration(result.audioPath);
+                }
+                catch {
+                    audioDuration = duration; // Fallback to video duration
+                }
+                // Add audio source
+                const audioSource = project.addSource({
+                    name: "Auto-generated narration",
+                    url: basename(result.audioPath),
+                    type: "audio",
+                    duration: audioDuration,
+                });
+                // Add audio clip to audio track
+                const audioTrack = project.getTracks().find((t) => t.type === "audio");
+                if (audioTrack) {
+                    project.addClip({
+                        sourceId: audioSource.id,
+                        trackId: audioTrack.id,
+                        startTime: 0,
+                        duration: Math.min(audioDuration, duration),
+                        sourceStartOffset: 0,
+                        sourceEndOffset: Math.min(audioDuration, duration),
+                    });
+                }
+                // Save updated project
+                await writeFile(absPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+                addSpinner.succeed(chalk.green("Narration added to project"));
+            }
+            console.log();
+            console.log(chalk.bold.green("✅ Auto-narrate complete!"));
+            if (!options.addToProject && isProject) {
+                console.log();
+                console.log(chalk.dim("Tip: Use --add-to-project to automatically add the narration to your project"));
+            }
+            console.log();
+        }
+        catch (error) {
+            console.error(chalk.red("Auto-narrate failed"));
+            console.error(error);
+            process.exit(1);
+        }
+    });
+} // end registerNarrateCommands
+//# sourceMappingURL=ai-narrate.js.map

package/dist/commands/ai-narrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-narrate.js","sourceRoot":"","sources":["../../src/commands/ai-narrate.ts"],"names":[],"mappings":"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"}

package/dist/commands/ai-review.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @module ai-review
+ *
+ * AI-powered video quality review and auto-fix using Gemini.
+ *
+ * CLI command: review
+ *
+ * Execute function:
+ *   executeReview - Analyze video quality across 5 categories and optionally auto-fix
+ *
+ * @dependencies Gemini (Google), FFmpeg (auto-fix filters)
+ */
+import { Command } from "commander";
+import type { VideoReviewFeedback } from "./ai-edit.js";
+/** Options for {@link executeReview}. */
+export interface ReviewOptions {
+    /** Path to the video file to review */
+    videoPath: string;
+    /** Optional storyboard JSON for context-aware review */
+    storyboardPath?: string;
+    /** Automatically apply fixable corrections via FFmpeg */
+    autoApply?: boolean;
+    /** Run a verification pass after applying fixes */
+    verify?: boolean;
+    /** Gemini model shorthand (default: "flash") */
+    model?: "flash" | "flash-2.5" | "pro";
+    /** Output path for the fixed video (auto-apply mode) */
+    outputPath?: string;
+}
+/** Result from {@link executeReview}. */
+export interface ReviewResult {
+    /** Whether the review completed successfully */
+    success: boolean;
+    /** Structured review feedback with per-category scores */
+    feedback?: VideoReviewFeedback;
+    /** Descriptions of fixes that were auto-applied */
+    appliedFixes?: string[];
+    /** Post-fix verification quality score 1-10 */
+    verificationScore?: number;
+    /** Path to the reviewed/fixed output video */
+    outputPath?: string;
+    /** Error message on failure */
+    error?: string;
+}
+/**
+ * Review video quality using Gemini AI and optionally auto-fix issues.
+ *
+ * Analyzes 5 quality categories (pacing, color, text readability, audio-visual
+ * sync, composition) and returns scored feedback. When auto-apply is enabled,
+ * applies fixable corrections via FFmpeg filters.
+ *
+ * @param options - Review configuration
+ * @returns Result with structured feedback and optional fix details
+ */
+export declare function executeReview(options: ReviewOptions): Promise<ReviewResult>;
+export declare function registerReviewCommand(aiCommand: Command): void;
+//# sourceMappingURL=ai-review.d.ts.map

package/dist/commands/ai-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-review.d.ts","sourceRoot":"","sources":["../../src/commands/ai-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,KAAK,CAAC;IACtC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyBD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAiIjF;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAwF9D"}

package/dist/commands/ai-review.js

@@ -0,0 +1,251 @@
+/**
+ * @module ai-review
+ *
+ * AI-powered video quality review and auto-fix using Gemini.
+ *
+ * CLI command: review
+ *
+ * Execute function:
+ *   executeReview - Analyze video quality across 5 categories and optionally auto-fix
+ *
+ * @dependencies Gemini (Google), FFmpeg (auto-fix filters)
+ */
+import { readFile, rename } from "node:fs/promises";
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import chalk from "chalk";
+import ora from "ora";
+import { GeminiProvider } from "@vibeframe/ai-providers";
+import { getApiKey, loadEnv } from "../utils/api-key.js";
+import { execSafe } from "../utils/exec-safe.js";
+function parseReviewFeedback(response) {
+    let cleaned = response.trim();
+    if (cleaned.startsWith("```json")) {
+        cleaned = cleaned.slice(7);
+    }
+    else if (cleaned.startsWith("```")) {
+        cleaned = cleaned.slice(3);
+    }
+    if (cleaned.endsWith("```")) {
+        cleaned = cleaned.slice(0, -3);
+    }
+    cleaned = cleaned.trim();
+    try {
+        const parsed = JSON.parse(cleaned);
+        if (typeof parsed.overallScore !== "number" || !parsed.categories) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Review video quality using Gemini AI and optionally auto-fix issues.
+ *
+ * Analyzes 5 quality categories (pacing, color, text readability, audio-visual
+ * sync, composition) and returns scored feedback. When auto-apply is enabled,
+ * applies fixable corrections via FFmpeg filters.
+ *
+ * @param options - Review configuration
+ * @returns Result with structured feedback and optional fix details
+ */
+export async function executeReview(options) {
+    const { videoPath, storyboardPath, autoApply = false, verify = false, model = "flash" } = options;
+    const absVideoPath = resolve(process.cwd(), videoPath);
+    if (!existsSync(absVideoPath)) {
+        return { success: false, error: `Video not found: ${absVideoPath}` };
+    }
+    const apiKey = process.env.GOOGLE_API_KEY || (await getApiKey("GOOGLE_API_KEY", "Google"));
+    if (!apiKey) {
+        return { success: false, error: "Google API key required for Gemini video review. Run 'vibe setup' or set GOOGLE_API_KEY in .env" };
+    }
+    let storyboardContext = "";
+    if (storyboardPath) {
+        const absStoryboardPath = resolve(process.cwd(), storyboardPath);
+        if (existsSync(absStoryboardPath)) {
+            const content = await readFile(absStoryboardPath, "utf-8");
+            storyboardContext = `\n\nOriginal storyboard for reference:\n${content}`;
+        }
+    }
+    const modelMap = {
+        flash: "gemini-3-flash-preview",
+        "flash-2.5": "gemini-2.5-flash",
+        pro: "gemini-2.5-pro",
+    };
+    const modelId = modelMap[model] || modelMap.flash;
+    const reviewPrompt = `You are a professional video editor reviewing this video for quality. Analyze the video and return a JSON review with the following structure. Return ONLY valid JSON, no extra text.
+
+{
+  "overallScore": <number 1-10>,
+  "categories": {
+    "pacing": { "score": <1-10>, "issues": ["..."], "fixable": <boolean> },
+    "color": { "score": <1-10>, "issues": ["..."], "fixable": <boolean>, "suggestedFilter": "<ffmpeg filter or null>" },
+    "textReadability": { "score": <1-10>, "issues": ["..."], "fixable": <boolean>, "suggestions": ["..."] },
+    "audioVisualSync": { "score": <1-10>, "issues": ["..."], "fixable": <boolean> },
+    "composition": { "score": <1-10>, "issues": ["..."], "fixable": <boolean> }
+  },
+  "autoFixable": [
+    { "type": "color_grade"|"text_overlay_adjust"|"speed_adjust"|"crop", "description": "...", "ffmpegFilter": "..." }
+  ],
+  "recommendations": ["..."]
+}
+
+Score each category 1-10. For fixable issues, provide an FFmpeg filter in autoFixable. Be specific and practical.${storyboardContext}`;
+    const gemini = new GeminiProvider();
+    await gemini.initialize({ apiKey });
+    const videoData = await readFile(absVideoPath);
+    const analysisResult = await gemini.analyzeVideo(videoData, reviewPrompt, {
+        model: modelId,
+    });
+    if (!analysisResult.success || !analysisResult.response) {
+        return { success: false, error: analysisResult.error || "Gemini video analysis failed" };
+    }
+    const feedback = parseReviewFeedback(analysisResult.response);
+    if (!feedback) {
+        return {
+            success: false,
+            error: "Failed to parse review feedback from Gemini response",
+        };
+    }
+    const result = {
+        success: true,
+        feedback,
+        appliedFixes: [],
+    };
+    if (autoApply && feedback.autoFixable.length > 0) {
+        let currentInput = absVideoPath;
+        const outputBase = options.outputPath
+            ? resolve(process.cwd(), options.outputPath)
+            : absVideoPath.replace(/(\.[^.]+)$/, "-reviewed$1");
+        for (const fix of feedback.autoFixable) {
+            if (fix.type === "color_grade" && fix.ffmpegFilter) {
+                try {
+                    const tempOutput = outputBase.replace(/(\.[^.]+)$/, `-fix-${result.appliedFixes.length}$1`);
+                    await execSafe("ffmpeg", ["-i", currentInput, "-vf", fix.ffmpegFilter, "-c:a", "copy", tempOutput, "-y"], { timeout: 600000, maxBuffer: 50 * 1024 * 1024 });
+                    currentInput = tempOutput;
+                    result.appliedFixes.push(`${fix.type}: ${fix.description}`);
+                }
+                catch {
+                    // Skip failed fix, continue with others
+                }
+            }
+            else if (fix.type === "text_overlay_adjust") {
+                result.appliedFixes.push(`${fix.type}: ${fix.description} (manual adjustment recommended)`);
+            }
+        }
+        if (currentInput !== absVideoPath) {
+            const finalOutput = outputBase;
+            try {
+                await rename(currentInput, finalOutput);
+                result.outputPath = finalOutput;
+            }
+            catch {
+                result.outputPath = currentInput;
+            }
+        }
+    }
+    if (verify && result.outputPath) {
+        const verifyVideoData = await readFile(result.outputPath);
+        const verifyResult = await gemini.analyzeVideo(verifyVideoData, "Rate this video overall quality on a scale of 1-10. Return ONLY a JSON object: {\"score\": <number>}", { model: modelId });
+        if (verifyResult.success && verifyResult.response) {
+            try {
+                let cleaned = verifyResult.response.trim();
+                if (cleaned.startsWith("```json"))
+                    cleaned = cleaned.slice(7);
+                if (cleaned.startsWith("```"))
+                    cleaned = cleaned.slice(3);
+                if (cleaned.endsWith("```"))
+                    cleaned = cleaned.slice(0, -3);
+                const parsed = JSON.parse(cleaned.trim());
+                result.verificationScore = parsed.score;
+            }
+            catch {
+                // Verification parse failed, not critical
+            }
+        }
+    }
+    return result;
+}
+export function registerReviewCommand(aiCommand) {
+    aiCommand
+        .command("review")
+        .description("Review video quality using Gemini AI and optionally auto-fix issues")
+        .argument("<video>", "Video file path")
+        .option("-s, --storyboard <path>", "Storyboard JSON file for context")
+        .option("--auto-apply", "Automatically apply fixable corrections")
+        .option("--verify", "Run verification pass after applying fixes")
+        .option("-m, --model <model>", "Gemini model: flash (default), flash-2.5, pro", "flash")
+        .option("-o, --output <path>", "Output video file path (for auto-apply)")
+        .action(async (videoPath, options) => {
+        try {
+            loadEnv();
+            const spinner = ora("Reviewing video with Gemini...").start();
+            const result = await executeReview({
+                videoPath,
+                storyboardPath: options.storyboard,
+                autoApply: options.autoApply,
+                verify: options.verify,
+                model: options.model,
+                outputPath: options.output,
+            });
+            if (!result.success) {
+                spinner.fail(chalk.red(result.error || "Video review failed"));
+                process.exit(1);
+            }
+            spinner.succeed(chalk.green("Video review complete"));
+            console.log();
+            const fb = result.feedback;
+            console.log(chalk.bold.cyan("Video Review"));
+            console.log(chalk.dim("─".repeat(60)));
+            console.log(`Overall Score: ${chalk.bold(fb.overallScore >= 7 ? chalk.green(String(fb.overallScore)) : fb.overallScore >= 5 ? chalk.yellow(String(fb.overallScore)) : chalk.red(String(fb.overallScore)))}/10`);
+            console.log();
+            const categories = [
+                ["Pacing", fb.categories.pacing],
+                ["Color", fb.categories.color],
+                ["Text Readability", fb.categories.textReadability],
+                ["Audio-Visual Sync", fb.categories.audioVisualSync],
+                ["Composition", fb.categories.composition],
+            ];
+            for (const [name, cat] of categories) {
+                const scoreColor = cat.score >= 7 ? chalk.green : cat.score >= 5 ? chalk.yellow : chalk.red;
+                const fixable = cat.fixable ? chalk.dim(" [fixable]") : "";
+                console.log(`  ${name.padEnd(20)} ${scoreColor(String(cat.score).padStart(2))}/10${fixable}`);
+                if (cat.issues.length > 0) {
+                    for (const issue of cat.issues) {
+                        console.log(chalk.dim(`    - ${issue}`));
+                    }
+                }
+            }
+            if (result.appliedFixes && result.appliedFixes.length > 0) {
+                console.log();
+                console.log(chalk.bold.green("Applied Fixes:"));
+                for (const fix of result.appliedFixes) {
+                    console.log(chalk.green(`  + ${fix}`));
+                }
+                if (result.outputPath) {
+                    console.log(chalk.green(`  Output: ${result.outputPath}`));
+                }
+            }
+            if (result.verificationScore !== undefined) {
+                console.log();
+                console.log(chalk.bold(`Verification Score: ${result.verificationScore}/10`));
+            }
+            if (fb.recommendations.length > 0) {
+                console.log();
+                console.log(chalk.bold("Recommendations:"));
+                for (const rec of fb.recommendations) {
+                    console.log(chalk.dim(`  * ${rec}`));
+                }
+            }
+            console.log();
+        }
+        catch (error) {
+            console.error(chalk.red("Video review failed"));
+            console.error(error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=ai-review.js.map