@michelabboud/visual-forge-mcp 0.6.1 → 0.7.0

package/dist/utils/quality-validator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Quality Validator - Validates generated images for quality issues
+ * Uses OCR (Tesseract.js) to detect text rendering problems
+ * Analyzes sharpness, brightness, and other quality metrics
+ */
+/**
+ * Quality validation configuration
+ */
+export interface QualityValidationConfig {
+    enableOCR?: boolean;
+    maxGibberishRatio?: number;
+    minConfidence?: number;
+    minSharpness?: number;
+    minBrightness?: number;
+    maxBrightness?: number;
+    minQualityScore?: number;
+}
+/**
+ * Quality validation result
+ */
+export interface QualityValidationResult {
+    passed: boolean;
+    score: number;
+    sharpness?: {
+        value: number;
+        passed: boolean;
+        threshold: number;
+    };
+    brightness?: {
+        value: number;
+        passed: boolean;
+        minThreshold: number;
+        maxThreshold: number;
+    };
+    ocr?: {
+        text: string;
+        confidence: number;
+        gibberishRatio: number;
+        passed: boolean;
+        issues: string[];
+    };
+    failureReasons: string[];
+    recommendations: string[];
+}
+/**
+ * Validate image quality
+ */
+export declare function validateImageQuality(imagePath: string, config?: QualityValidationConfig): Promise<QualityValidationResult>;
+/**
+ * Check if quality validation is available
+ */
+export declare function isQualityValidationAvailable(): Promise<{
+    sharpAvailable: boolean;
+    tesseractAvailable: boolean;
+    fullyAvailable: boolean;
+}>;
+/**
+ * Get default quality validation configuration
+ */
+export declare function getDefaultQualityConfig(): Required<QualityValidationConfig>;
+//# sourceMappingURL=quality-validator.d.ts.map

package/dist/utils/quality-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-validator.d.ts","sourceRoot":"","sources":["../../src/utils/quality-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0DH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IAEtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IAGd,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,GAAG,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAGF,cAAc,EAAE,MAAM,EAAE,CAAC;IAGzB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA6PD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,uBAA4B,GACnC,OAAO,CAAC,uBAAuB,CAAC,CAoHlC;AAED;;GAEG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC;IAC5D,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC,CASD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,QAAQ,CAAC,uBAAuB,CAAC,CAE3E"}

package/dist/utils/quality-validator.js

@@ -0,0 +1,386 @@
+/**
+ * Quality Validator - Validates generated images for quality issues
+ * Uses OCR (Tesseract.js) to detect text rendering problems
+ * Analyzes sharpness, brightness, and other quality metrics
+ */
+import { logger } from './logger.js';
+// Dynamic import of Sharp and Tesseract
+let sharp = null;
+let tesseract = null; // Use 'any' since tesseract.js might not be installed
+let sharpAvailable = false;
+let tesseractAvailable = false;
+/**
+ * Initialize Sharp library
+ */
+async function initializeSharp() {
+    if (sharp !== null) {
+        return sharpAvailable;
+    }
+    try {
+        sharp = (await import('sharp')).default;
+        sharpAvailable = true;
+        logger.debug('Sharp library loaded for quality validation');
+        return true;
+    }
+    catch (error) {
+        sharpAvailable = false;
+        logger.warn('Sharp not available - quality validation will be limited', {
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+        return false;
+    }
+}
+/**
+ * Initialize Tesseract library
+ */
+async function initializeTesseract() {
+    if (tesseract !== null) {
+        return tesseractAvailable;
+    }
+    try {
+        // Try to dynamically import tesseract.js (optional dependency)
+        // @ts-ignore - tesseract.js is an optional dependency
+        const tesseractModule = await import('tesseract.js');
+        tesseract = tesseractModule;
+        tesseractAvailable = true;
+        logger.info('Tesseract.js loaded - OCR text validation enabled');
+        return true;
+    }
+    catch (error) {
+        tesseractAvailable = false;
+        logger.warn('Tesseract.js not available - OCR validation disabled', {
+            error: error instanceof Error ? error.message : 'Unknown error',
+            hint: 'Install with: npm install tesseract.js',
+        });
+        return false;
+    }
+}
+/**
+ * Default quality validation configuration
+ */
+const DEFAULT_CONFIG = {
+    enableOCR: true,
+    maxGibberishRatio: 0.3,
+    minConfidence: 60,
+    minSharpness: 50,
+    minBrightness: 30,
+    maxBrightness: 240,
+    minQualityScore: 60,
+};
+/**
+ * Detect gibberish in text using heuristics
+ */
+function detectGibberish(text) {
+    if (!text || text.trim().length === 0) {
+        return { isGibberish: false, ratio: 0 };
+    }
+    const words = text.split(/\s+/).filter(w => w.length > 0);
+    if (words.length === 0) {
+        return { isGibberish: false, ratio: 0 };
+    }
+    let gibberishCount = 0;
+    // Common gibberish patterns
+    const gibberishPatterns = [
+        /^[^aeiouAEIOU]{5,}$/, // Too many consonants
+        /(.)\1{3,}/, // Repeated characters (aaaa)
+        /^[a-zA-Z]{1,2}$/, // Single/double letter words (except common ones)
+        /[^a-zA-Z0-9\s\-'.,!?@#$%&*()]/, // Unusual characters
+        /^[0-9]+[a-zA-Z]+[0-9]+$/, // Numbers mixed with letters oddly
+    ];
+    // Common short words that are OK
+    const commonShortWords = new Set([
+        'a', 'i', 'an', 'as', 'at', 'be', 'by', 'do', 'go', 'he', 'if', 'in', 'is', 'it',
+        'me', 'my', 'no', 'of', 'on', 'or', 'so', 'to', 'up', 'us', 'we',
+    ]);
+    for (const word of words) {
+        const lowerWord = word.toLowerCase();
+        // Skip common short words
+        if (commonShortWords.has(lowerWord)) {
+            continue;
+        }
+        // Check for gibberish patterns
+        let isGibberishWord = false;
+        for (const pattern of gibberishPatterns) {
+            if (pattern.test(word)) {
+                isGibberishWord = true;
+                break;
+            }
+        }
+        // Check vowel ratio (real words usually have 20-60% vowels)
+        const vowels = word.match(/[aeiouAEIOU]/g);
+        const vowelRatio = vowels ? vowels.length / word.length : 0;
+        if (word.length > 3 && (vowelRatio < 0.1 || vowelRatio > 0.8)) {
+            isGibberishWord = true;
+        }
+        if (isGibberishWord) {
+            gibberishCount++;
+            logger.debug('Detected gibberish word', { word });
+        }
+    }
+    const ratio = gibberishCount / words.length;
+    const isGibberish = ratio > 0.3; // More than 30% gibberish
+    return { isGibberish, ratio };
+}
+/**
+ * Calculate sharpness using Laplacian variance
+ */
+async function calculateSharpness(imagePath) {
+    if (!sharp) {
+        return 0;
+    }
+    try {
+        const image = sharp(imagePath);
+        const { data, info } = await image
+            .greyscale()
+            .raw()
+            .toBuffer({ resolveWithObject: true });
+        // Calculate Laplacian variance (edge detection)
+        const width = info.width;
+        const height = info.height;
+        let sum = 0;
+        let count = 0;
+        for (let y = 1; y < height - 1; y++) {
+            for (let x = 1; x < width - 1; x++) {
+                const idx = y * width + x;
+                const center = data[idx];
+                const top = data[(y - 1) * width + x];
+                const bottom = data[(y + 1) * width + x];
+                const left = data[y * width + (x - 1)];
+                const right = data[y * width + (x + 1)];
+                // Laplacian kernel
+                const laplacian = Math.abs(4 * center - top - bottom - left - right);
+                sum += laplacian * laplacian;
+                count++;
+            }
+        }
+        const variance = sum / count;
+        return variance;
+    }
+    catch (error) {
+        logger.warn('Failed to calculate sharpness', {
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+        return 0;
+    }
+}
+/**
+ * Calculate average brightness
+ */
+async function calculateBrightness(imagePath) {
+    if (!sharp) {
+        return 128;
+    }
+    try {
+        const image = sharp(imagePath);
+        const { data } = await image
+            .greyscale()
+            .raw()
+            .toBuffer({ resolveWithObject: true });
+        const sum = Array.from(data).reduce((acc, val) => acc + val, 0);
+        const average = sum / data.length;
+        return average;
+    }
+    catch (error) {
+        logger.warn('Failed to calculate brightness', {
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+        return 128;
+    }
+}
+/**
+ * Perform OCR text detection and validation
+ */
+async function performOCR(imagePath, config) {
+    if (!tesseract || !tesseractAvailable) {
+        logger.debug('OCR skipped - Tesseract not available');
+        return {
+            text: '',
+            confidence: 100,
+            gibberishRatio: 0,
+            passed: true,
+            issues: [],
+        };
+    }
+    try {
+        logger.debug('Performing OCR text detection', { imagePath });
+        const worker = await tesseract.createWorker('eng');
+        const { data } = await worker.recognize(imagePath);
+        await worker.terminate();
+        const detectedText = data.text.trim();
+        const avgConfidence = data.confidence;
+        logger.debug('OCR completed', {
+            textLength: detectedText.length,
+            confidence: avgConfidence.toFixed(1),
+        });
+        const issues = [];
+        // Check if text was detected (might indicate unwanted text in image)
+        if (detectedText.length === 0) {
+            // No text detected - this is usually good for diagrams
+            return {
+                text: '',
+                confidence: 100,
+                gibberishRatio: 0,
+                passed: true,
+                issues: [],
+            };
+        }
+        // If text was detected, validate quality
+        const gibberishAnalysis = detectGibberish(detectedText);
+        // Low confidence
+        if (avgConfidence < config.minConfidence) {
+            issues.push(`Low OCR confidence: ${avgConfidence.toFixed(1)}% (min: ${config.minConfidence}%)`);
+        }
+        // High gibberish ratio
+        if (gibberishAnalysis.ratio > config.maxGibberishRatio) {
+            issues.push(`High gibberish ratio: ${(gibberishAnalysis.ratio * 100).toFixed(1)}% (max: ${config.maxGibberishRatio * 100}%)`);
+        }
+        const passed = issues.length === 0;
+        if (!passed) {
+            logger.warn('OCR quality issues detected', {
+                text: detectedText.substring(0, 100),
+                confidence: avgConfidence,
+                gibberishRatio: gibberishAnalysis.ratio,
+                issues,
+            });
+        }
+        return {
+            text: detectedText,
+            confidence: avgConfidence,
+            gibberishRatio: gibberishAnalysis.ratio,
+            passed,
+            issues,
+        };
+    }
+    catch (error) {
+        logger.warn('OCR failed', {
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+        // On error, pass validation (don't block generation)
+        return {
+            text: '',
+            confidence: 0,
+            gibberishRatio: 0,
+            passed: true,
+            issues: ['OCR error - validation skipped'],
+        };
+    }
+}
+/**
+ * Validate image quality
+ */
+export async function validateImageQuality(imagePath, config = {}) {
+    // Merge with defaults
+    const fullConfig = {
+        ...DEFAULT_CONFIG,
+        ...config,
+    };
+    // Initialize libraries
+    await initializeSharp();
+    if (fullConfig.enableOCR) {
+        await initializeTesseract();
+    }
+    logger.info('Starting quality validation', {
+        imagePath,
+        ocrEnabled: fullConfig.enableOCR && tesseractAvailable,
+    });
+    const failureReasons = [];
+    const recommendations = [];
+    // Calculate sharpness
+    let sharpnessResult;
+    if (sharpAvailable) {
+        const sharpnessValue = await calculateSharpness(imagePath);
+        const sharpnessPassed = sharpnessValue >= fullConfig.minSharpness;
+        sharpnessResult = {
+            value: sharpnessValue,
+            passed: sharpnessPassed,
+            threshold: fullConfig.minSharpness,
+        };
+        if (!sharpnessPassed) {
+            failureReasons.push(`Low sharpness: ${sharpnessValue.toFixed(1)} (min: ${fullConfig.minSharpness})`);
+            recommendations.push('Image appears blurry - may need higher resolution or better AI model');
+        }
+        logger.debug('Sharpness calculated', sharpnessResult);
+    }
+    // Calculate brightness
+    let brightnessResult;
+    if (sharpAvailable) {
+        const brightnessValue = await calculateBrightness(imagePath);
+        const brightnessPassed = brightnessValue >= fullConfig.minBrightness &&
+            brightnessValue <= fullConfig.maxBrightness;
+        brightnessResult = {
+            value: brightnessValue,
+            passed: brightnessPassed,
+            minThreshold: fullConfig.minBrightness,
+            maxThreshold: fullConfig.maxBrightness,
+        };
+        if (!brightnessPassed) {
+            if (brightnessValue < fullConfig.minBrightness) {
+                failureReasons.push(`Too dark: ${brightnessValue.toFixed(1)} (min: ${fullConfig.minBrightness})`);
+                recommendations.push('Image is too dark - adjust prompt or generation parameters');
+            }
+            else {
+                failureReasons.push(`Too bright: ${brightnessValue.toFixed(1)} (max: ${fullConfig.maxBrightness})`);
+                recommendations.push('Image is too bright - adjust prompt or generation parameters');
+            }
+        }
+        logger.debug('Brightness calculated', brightnessResult);
+    }
+    // Perform OCR validation
+    let ocrResult;
+    if (fullConfig.enableOCR && tesseractAvailable) {
+        const ocr = await performOCR(imagePath, fullConfig);
+        ocrResult = ocr;
+        if (!ocr.passed) {
+            failureReasons.push(...ocr.issues);
+            recommendations.push('Text rendering issues detected - consider regenerating with enhanced prompt');
+        }
+    }
+    // Calculate overall quality score (0-100)
+    let score = 100;
+    if (sharpnessResult && !sharpnessResult.passed) {
+        score -= 30;
+    }
+    if (brightnessResult && !brightnessResult.passed) {
+        score -= 20;
+    }
+    if (ocrResult && !ocrResult.passed) {
+        score -= 30;
+    }
+    score = Math.max(0, Math.min(100, score));
+    // Overall pass/fail
+    const passed = score >= fullConfig.minQualityScore;
+    const result = {
+        passed,
+        score,
+        sharpness: sharpnessResult,
+        brightness: brightnessResult,
+        ocr: ocrResult,
+        failureReasons,
+        recommendations,
+    };
+    logger.info('Quality validation complete', {
+        passed,
+        score,
+        failureReasons: failureReasons.length,
+    });
+    return result;
+}
+/**
+ * Check if quality validation is available
+ */
+export async function isQualityValidationAvailable() {
+    const sharp = await initializeSharp();
+    const tesseract = await initializeTesseract();
+    return {
+        sharpAvailable: sharp,
+        tesseractAvailable: tesseract,
+        fullyAvailable: sharp && tesseract,
+    };
+}
+/**
+ * Get default quality validation configuration
+ */
+export function getDefaultQualityConfig() {
+    return { ...DEFAULT_CONFIG };
+}
+//# sourceMappingURL=quality-validator.js.map

package/dist/utils/quality-validator.js.map

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

package/dist/utils/source-metadata.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Source Metadata Manager - Manages source.json files in indexed directories
+ * Provides rich metadata about source files and generated images
+ */
+export interface SourceMetadata {
+    index: number;
+    sourceFile: string;
+    absolutePath: string;
+    sessionId?: string;
+    provider: string;
+    createdAt: string;
+    updatedAt: string;
+    stats: {
+        imageCount: number;
+        totalSize: number;
+        formats: {
+            [format: string]: {
+                count: number;
+                avgSize: number;
+            };
+        };
+    };
+    quality?: {
+        avgScore: number;
+        passedCount: number;
+        failedCount: number;
+        regeneratedCount: number;
+    };
+}
+export declare class SourceMetadataManager {
+    /**
+     * Create source.json for a new indexed directory
+     */
+    static create(indexDir: string, sourceFile: string, index: number, provider: string, sessionId?: string): Promise<void>;
+    /**
+     * Read source.json from indexed directory
+     */
+    static read(indexDir: string): Promise<SourceMetadata>;
+    /**
+     * Check if source.json exists in directory
+     */
+    static exists(indexDir: string): Promise<boolean>;
+    /**
+     * Update metadata (call after generating images)
+     */
+    static update(indexDir: string, updates: Partial<SourceMetadata>): Promise<void>;
+    /**
+     * Update stats after image generation
+     */
+    static updateStats(indexDir: string, format: string, size: number): Promise<void>;
+    /**
+     * Update quality metrics
+     */
+    static updateQuality(indexDir: string, score: number, passed: boolean, regenerated?: boolean): Promise<void>;
+}
+//# sourceMappingURL=source-metadata.d.ts.map

package/dist/utils/source-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-metadata.d.ts","sourceRoot":"","sources":["../../src/utils/source-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE;YACP,CAAC,MAAM,EAAE,MAAM,GAAG;gBAChB,KAAK,EAAE,MAAM,CAAC;gBACd,OAAO,EAAE,MAAM,CAAC;aACjB,CAAC;SACH,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,qBAAa,qBAAqB;IAChC;;OAEG;WACU,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IA0BhB;;OAEG;WACU,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAM5D;;OAEG;WACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvD;;OAEG;WACU,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;WACU,WAAW,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAuBhB;;OAEG;WACU,aAAa,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,EACf,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,IAAI,CAAC;CA4BjB"}

package/dist/utils/source-metadata.js

@@ -0,0 +1,122 @@
+/**
+ * Source Metadata Manager - Manages source.json files in indexed directories
+ * Provides rich metadata about source files and generated images
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { logger } from './logger.js';
+export class SourceMetadataManager {
+    /**
+     * Create source.json for a new indexed directory
+     */
+    static async create(indexDir, sourceFile, index, provider, sessionId) {
+        const metadata = {
+            index,
+            sourceFile,
+            absolutePath: path.resolve(sourceFile),
+            sessionId,
+            provider,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            stats: {
+                imageCount: 0,
+                totalSize: 0,
+                formats: {},
+            },
+        };
+        const metadataPath = path.join(indexDir, 'source.json');
+        await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
+        logger.debug('Created source metadata', {
+            indexDir,
+            sourceFile,
+            index,
+        });
+    }
+    /**
+     * Read source.json from indexed directory
+     */
+    static async read(indexDir) {
+        const metadataPath = path.join(indexDir, 'source.json');
+        const data = await fs.readFile(metadataPath, 'utf-8');
+        return JSON.parse(data);
+    }
+    /**
+     * Check if source.json exists in directory
+     */
+    static async exists(indexDir) {
+        try {
+            const metadataPath = path.join(indexDir, 'source.json');
+            await fs.access(metadataPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Update metadata (call after generating images)
+     */
+    static async update(indexDir, updates) {
+        const current = await this.read(indexDir);
+        const updated = {
+            ...current,
+            ...updates,
+            updatedAt: new Date().toISOString(),
+        };
+        const metadataPath = path.join(indexDir, 'source.json');
+        await fs.writeFile(metadataPath, JSON.stringify(updated, null, 2), 'utf-8');
+        logger.debug('Updated source metadata', {
+            indexDir,
+            updates: Object.keys(updates),
+        });
+    }
+    /**
+     * Update stats after image generation
+     */
+    static async updateStats(indexDir, format, size) {
+        const current = await this.read(indexDir);
+        if (!current.stats.formats[format]) {
+            current.stats.formats[format] = { count: 0, avgSize: 0 };
+        }
+        const formatStats = current.stats.formats[format];
+        const newCount = formatStats.count + 1;
+        const newAvgSize = (formatStats.avgSize * formatStats.count + size) / newCount;
+        current.stats.formats[format] = {
+            count: newCount,
+            avgSize: Math.round(newAvgSize),
+        };
+        current.stats.imageCount++;
+        current.stats.totalSize += size;
+        await this.update(indexDir, { stats: current.stats });
+    }
+    /**
+     * Update quality metrics
+     */
+    static async updateQuality(indexDir, score, passed, regenerated = false) {
+        const current = await this.read(indexDir);
+        if (!current.quality) {
+            current.quality = {
+                avgScore: score,
+                passedCount: passed ? 1 : 0,
+                failedCount: passed ? 0 : 1,
+                regeneratedCount: regenerated ? 1 : 0,
+            };
+        }
+        else {
+            const totalImages = current.quality.passedCount + current.quality.failedCount;
+            const newAvgScore = (current.quality.avgScore * totalImages + score) / (totalImages + 1);
+            current.quality.avgScore = Math.round(newAvgScore * 10) / 10;
+            if (passed) {
+                current.quality.passedCount++;
+            }
+            else {
+                current.quality.failedCount++;
+            }
+            if (regenerated) {
+                current.quality.regeneratedCount++;
+            }
+        }
+        await this.update(indexDir, { quality: current.quality });
+    }
+}
+//# sourceMappingURL=source-metadata.js.map

package/dist/utils/source-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-metadata.js","sourceRoot":"","sources":["../../src/utils/source-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA4BrC,MAAM,OAAO,qBAAqB;IAChC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,QAAgB,EAChB,UAAkB,EAClB,KAAa,EACb,QAAgB,EAChB,SAAkB;QAElB,MAAM,QAAQ,GAAmB;YAC/B,KAAK;YACL,UAAU;YACV,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YACtC,SAAS;YACT,QAAQ;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE;gBACL,UAAU,EAAE,CAAC;gBACb,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,EAAE;aACZ;SACF,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACxD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAE7E,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;YACtC,QAAQ;YACR,UAAU;YACV,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAgB;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAgB;QAClC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,QAAgB,EAChB,OAAgC;QAEhC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG;YACd,GAAG,OAAO;YACV,GAAG,OAAO;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACxD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAE5E,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;YACtC,QAAQ;YACR,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CACtB,QAAgB,EAChB,MAAc,EACd,IAAY;QAEZ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC;QACvC,MAAM,UAAU,GACd,CAAC,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC;QAE9D,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG;YAC9B,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;SAChC,CAAC;QAEF,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QAEhC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CACxB,QAAgB,EAChB,KAAa,EACb,MAAe,EACf,cAAuB,KAAK;QAE5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,GAAG;gBAChB,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3B,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3B,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACtC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;YAC9E,MAAM,WAAW,GACf,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YAEvE,OAAO,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;YAC7D,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAChC,CAAC;YACD,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACrC,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/workflow/workflow-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-orchestrator.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EACL,cAAc,EACd,SAAS,EAET,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAI3B,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,YAAY,CAAgB;gBAExB,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc;IAK9D;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDnD;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ;;OAEG;IACH,WAAW,IAAI,kBAAkB;IA+DjC;;OAEG;YACW,kBAAkB;IA0BhC;;OAEG;YACW,YAAY;IAsC1B;;OAEG;YACW,WAAW;IAiDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuCnB;;OAEG;YACW,UAAU;CA4EzB"}
+{"version":3,"file":"workflow-orchestrator.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EACL,cAAc,EACd,SAAS,EAET,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAI3B,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,YAAY,CAAgB;gBAExB,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc;IAK9D;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDnD;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ;;OAEG;IACH,WAAW,IAAI,kBAAkB;IA+DjC;;OAEG;YACW,kBAAkB;IA0BhC;;OAEG;YACW,YAAY;IAsC1B;;OAEG;YACW,WAAW;IAiDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuCnB;;OAEG;YACW,UAAU;CAsGzB"}