lhci-ai-assistant 0.1.0

package/dist/metrics/comparator.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareMetrics = compareMetrics;
+exports.getComparisonSummary = getComparisonSummary;
+/**
+ * Compare current metrics against baseline metrics
+ */
+function compareMetrics(current, baseline) {
+    const comparisons = [];
+    // Compare scores
+    comparisons.push(...compareScores(current.scores, baseline.scores));
+    // Compare Core Web Vitals
+    comparisons.push(...compareCoreWebVitals(current.coreWebVitals, baseline.coreWebVitals));
+    // Categorize results
+    const regressions = comparisons.filter((c) => c.isRegression);
+    const improvements = comparisons.filter((c) => c.isImprovement);
+    const unchanged = comparisons.filter((c) => !c.isRegression && !c.isImprovement);
+    // Calculate overall score change
+    const overallScore = {
+        base: baseline.scores.performance ?? 0,
+        current: current.scores.performance ?? 0,
+        diff: (current.scores.performance ?? 0) - (baseline.scores.performance ?? 0),
+    };
+    return {
+        regressions: sortBySeverity(regressions),
+        improvements: sortBySeverity(improvements),
+        unchanged,
+        overallScore,
+    };
+}
+/**
+ * Compare category scores
+ */
+function compareScores(current, baseline) {
+    const comparisons = [];
+    const scoreKeys = ['performance', 'accessibility', 'bestPractices', 'seo'];
+    for (const key of scoreKeys) {
+        const baseValue = baseline[key];
+        const currentValue = current[key];
+        if (baseValue !== undefined && currentValue !== undefined) {
+            comparisons.push(createScoreComparison(formatScoreKey(key), currentValue, baseValue));
+        }
+    }
+    return comparisons;
+}
+/**
+ * Compare Core Web Vitals
+ */
+function compareCoreWebVitals(current, baseline) {
+    const comparisons = [];
+    const metricKeys = ['fcp', 'lcp', 'tbt', 'cls', 'speedIndex', 'tti'];
+    for (const key of metricKeys) {
+        const baseValue = baseline[key];
+        const currentValue = current[key];
+        if (baseValue !== undefined && currentValue !== undefined) {
+            comparisons.push(createMetricComparison(formatMetricKey(key), currentValue, baseValue));
+        }
+    }
+    return comparisons;
+}
+/**
+ * Create a comparison for score metrics (higher is better)
+ */
+function createScoreComparison(metric, current, base) {
+    const diff = current - base;
+    const diffPercent = base !== 0 ? (diff / base) * 100 : 0;
+    // For scores, higher is better
+    const isRegression = diff < -0.01; // 1% threshold
+    const isImprovement = diff > 0.01;
+    return {
+        metric,
+        base,
+        current,
+        diff,
+        diffPercent,
+        isRegression,
+        isImprovement,
+        severity: getScoreSeverity(diff),
+    };
+}
+/**
+ * Create a comparison for timing metrics (lower is better)
+ */
+function createMetricComparison(metric, current, base) {
+    const diff = current - base;
+    const diffPercent = base !== 0 ? (diff / base) * 100 : 0;
+    // For timing metrics, lower is better (except CLS which also lower is better)
+    const isRegression = diff > getMetricThreshold(metric);
+    const isImprovement = diff < -getMetricThreshold(metric);
+    return {
+        metric,
+        base,
+        current,
+        diff,
+        diffPercent,
+        isRegression,
+        isImprovement,
+        severity: getMetricSeverity(metric, diff),
+    };
+}
+/**
+ * Get the threshold for considering a change significant
+ */
+function getMetricThreshold(metric) {
+    const thresholds = {
+        FCP: 100, // 100ms
+        LCP: 100,
+        TBT: 50, // 50ms
+        CLS: 0.01,
+        'Speed Index': 200,
+        TTI: 200,
+    };
+    return thresholds[metric] ?? 100;
+}
+/**
+ * Get severity for score changes
+ */
+function getScoreSeverity(diff) {
+    const absDiff = Math.abs(diff);
+    if (absDiff >= 0.2)
+        return 'critical';
+    if (absDiff >= 0.1)
+        return 'high';
+    if (absDiff >= 0.05)
+        return 'medium';
+    return 'low';
+}
+/**
+ * Get severity for metric changes
+ */
+function getMetricSeverity(metric, diff) {
+    const absDiff = Math.abs(diff);
+    // Different thresholds for different metrics
+    if (metric === 'CLS') {
+        if (absDiff >= 0.1)
+            return 'critical';
+        if (absDiff >= 0.05)
+            return 'high';
+        if (absDiff >= 0.02)
+            return 'medium';
+        return 'low';
+    }
+    // For timing metrics (ms)
+    if (absDiff >= 1000)
+        return 'critical';
+    if (absDiff >= 500)
+        return 'high';
+    if (absDiff >= 200)
+        return 'medium';
+    return 'low';
+}
+/**
+ * Format score key for display
+ */
+function formatScoreKey(key) {
+    const mapping = {
+        performance: 'Performance Score',
+        accessibility: 'Accessibility Score',
+        bestPractices: 'Best Practices Score',
+        seo: 'SEO Score',
+    };
+    return mapping[key] ?? key;
+}
+/**
+ * Format metric key for display
+ */
+function formatMetricKey(key) {
+    const mapping = {
+        fcp: 'FCP',
+        lcp: 'LCP',
+        tbt: 'TBT',
+        cls: 'CLS',
+        speedIndex: 'Speed Index',
+        tti: 'TTI',
+    };
+    return mapping[key] ?? key;
+}
+/**
+ * Sort comparisons by severity (most severe first)
+ */
+function sortBySeverity(comparisons) {
+    const severityOrder = {
+        critical: 0,
+        high: 1,
+        medium: 2,
+        low: 3,
+    };
+    return [...comparisons].sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+}
+/**
+ * Get a summary of the comparison result
+ */
+function getComparisonSummary(result) {
+    const lines = [];
+    if (result.regressions.length > 0) {
+        lines.push(`Regressions: ${result.regressions.length}`);
+        for (const r of result.regressions.slice(0, 3)) {
+            lines.push(`  - ${r.metric}: ${formatChange(r)}`);
+        }
+    }
+    if (result.improvements.length > 0) {
+        lines.push(`Improvements: ${result.improvements.length}`);
+        for (const i of result.improvements.slice(0, 3)) {
+            lines.push(`  - ${i.metric}: ${formatChange(i)}`);
+        }
+    }
+    const scoreDiff = result.overallScore.diff * 100;
+    lines.push(`\nOverall Performance: ${scoreDiff >= 0 ? '+' : ''}${scoreDiff.toFixed(1)}%`);
+    return lines.join('\n');
+}
+/**
+ * Format a metric change for display
+ */
+function formatChange(comparison) {
+    const sign = comparison.diff >= 0 ? '+' : '';
+    if (comparison.metric.includes('Score')) {
+        const basePct = (comparison.base * 100).toFixed(0);
+        const currentPct = (comparison.current * 100).toFixed(0);
+        const diffPct = (comparison.diff * 100).toFixed(1);
+        return `${basePct}% → ${currentPct}% (${sign}${diffPct}%)`;
+    }
+    if (comparison.metric === 'CLS') {
+        return `${comparison.base.toFixed(3)} → ${comparison.current.toFixed(3)} (${sign}${comparison.diff.toFixed(3)})`;
+    }
+    // Timing metrics
+    return `${comparison.base.toFixed(0)}ms → ${comparison.current.toFixed(0)}ms (${sign}${comparison.diff.toFixed(0)}ms)`;
+}
+//# sourceMappingURL=comparator.js.map

package/dist/metrics/comparator.js.map

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

package/dist/metrics/extractor.d.ts

@@ -0,0 +1,26 @@
+import { LHReport, Metrics } from '../types';
+/**
+ * Extract key metrics from a Lighthouse report
+ */
+export declare function extractMetrics(lhr: LHReport): Metrics;
+/**
+ * Get a human-readable summary of metrics
+ */
+export declare function getMetricsSummary(metrics: Metrics): string;
+/**
+ * Format a score as a percentage
+ */
+export declare function formatScore(score: number): string;
+/**
+ * Format milliseconds in a human-readable way
+ */
+export declare function formatMs(ms: number): string;
+/**
+ * Format bytes in a human-readable way
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Get the rating for a metric value
+ */
+export declare function getMetricRating(metric: string, value: number): 'good' | 'needs-improvement' | 'poor';
+//# sourceMappingURL=extractor.d.ts.map

package/dist/metrics/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/metrics/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAe,MAAM,UAAU,CAAC;AAE1D;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAMrD;AAuED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA2C1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAK3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,mBAAmB,GAAG,MAAM,CAsBvC"}

package/dist/metrics/extractor.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMetrics = extractMetrics;
+exports.getMetricsSummary = getMetricsSummary;
+exports.formatScore = formatScore;
+exports.formatMs = formatMs;
+exports.formatBytes = formatBytes;
+exports.getMetricRating = getMetricRating;
+/**
+ * Extract key metrics from a Lighthouse report
+ */
+function extractMetrics(lhr) {
+    return {
+        scores: extractScores(lhr),
+        coreWebVitals: extractCoreWebVitals(lhr),
+        opportunities: extractOpportunities(lhr),
+    };
+}
+/**
+ * Extract category scores
+ */
+function extractScores(lhr) {
+    return {
+        performance: lhr.categories.performance?.score ?? undefined,
+        accessibility: lhr.categories.accessibility?.score ?? undefined,
+        bestPractices: lhr.categories['best-practices']?.score ?? undefined,
+        seo: lhr.categories.seo?.score ?? undefined,
+    };
+}
+/**
+ * Extract Core Web Vitals metrics
+ */
+function extractCoreWebVitals(lhr) {
+    return {
+        fcp: getNumericValue(lhr, 'first-contentful-paint'),
+        lcp: getNumericValue(lhr, 'largest-contentful-paint'),
+        tbt: getNumericValue(lhr, 'total-blocking-time'),
+        cls: getNumericValue(lhr, 'cumulative-layout-shift'),
+        speedIndex: getNumericValue(lhr, 'speed-index'),
+        tti: getNumericValue(lhr, 'interactive'),
+    };
+}
+/**
+ * Get numeric value from an audit
+ */
+function getNumericValue(lhr, auditId) {
+    const audit = lhr.audits[auditId];
+    if (!audit || audit.numericValue === undefined) {
+        return undefined;
+    }
+    return audit.numericValue;
+}
+/**
+ * Extract performance opportunities
+ */
+function extractOpportunities(lhr) {
+    const opportunities = [];
+    for (const [id, audit] of Object.entries(lhr.audits)) {
+        // Only include opportunities that have room for improvement
+        if (audit.details?.type === 'opportunity' &&
+            audit.score !== null &&
+            audit.score !== 1) {
+            opportunities.push({
+                id,
+                title: audit.title,
+                description: audit.description,
+                savingsMs: audit.details.overallSavingsMs,
+                savingsBytes: audit.details.overallSavingsBytes,
+                score: audit.score,
+            });
+        }
+    }
+    // Sort by potential savings (highest first)
+    return opportunities.sort((a, b) => {
+        const savingsA = a.savingsMs || 0;
+        const savingsB = b.savingsMs || 0;
+        return savingsB - savingsA;
+    });
+}
+/**
+ * Get a human-readable summary of metrics
+ */
+function getMetricsSummary(metrics) {
+    const lines = [];
+    // Scores
+    lines.push('Category Scores:');
+    if (metrics.scores.performance !== undefined) {
+        lines.push(`  Performance: ${formatScore(metrics.scores.performance)}`);
+    }
+    if (metrics.scores.accessibility !== undefined) {
+        lines.push(`  Accessibility: ${formatScore(metrics.scores.accessibility)}`);
+    }
+    if (metrics.scores.bestPractices !== undefined) {
+        lines.push(`  Best Practices: ${formatScore(metrics.scores.bestPractices)}`);
+    }
+    if (metrics.scores.seo !== undefined) {
+        lines.push(`  SEO: ${formatScore(metrics.scores.seo)}`);
+    }
+    // Core Web Vitals
+    lines.push('\nCore Web Vitals:');
+    if (metrics.coreWebVitals.fcp !== undefined) {
+        lines.push(`  FCP: ${formatMs(metrics.coreWebVitals.fcp)}`);
+    }
+    if (metrics.coreWebVitals.lcp !== undefined) {
+        lines.push(`  LCP: ${formatMs(metrics.coreWebVitals.lcp)}`);
+    }
+    if (metrics.coreWebVitals.tbt !== undefined) {
+        lines.push(`  TBT: ${formatMs(metrics.coreWebVitals.tbt)}`);
+    }
+    if (metrics.coreWebVitals.cls !== undefined) {
+        lines.push(`  CLS: ${metrics.coreWebVitals.cls.toFixed(3)}`);
+    }
+    // Top opportunities
+    if (metrics.opportunities.length > 0) {
+        lines.push('\nTop Opportunities:');
+        for (const opp of metrics.opportunities.slice(0, 5)) {
+            const savings = opp.savingsMs ? ` (${formatMs(opp.savingsMs)} savings)` : '';
+            lines.push(`  - ${opp.title}${savings}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a score as a percentage
+ */
+function formatScore(score) {
+    return `${Math.round(score * 100)}%`;
+}
+/**
+ * Format milliseconds in a human-readable way
+ */
+function formatMs(ms) {
+    if (ms >= 1000) {
+        return `${(ms / 1000).toFixed(2)}s`;
+    }
+    return `${Math.round(ms)}ms`;
+}
+/**
+ * Format bytes in a human-readable way
+ */
+function formatBytes(bytes) {
+    if (bytes >= 1024 * 1024) {
+        return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+    }
+    if (bytes >= 1024) {
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    }
+    return `${bytes} B`;
+}
+/**
+ * Get the rating for a metric value
+ */
+function getMetricRating(metric, value) {
+    const thresholds = {
+        fcp: { good: 1800, poor: 3000 },
+        lcp: { good: 2500, poor: 4000 },
+        tbt: { good: 200, poor: 600 },
+        cls: { good: 0.1, poor: 0.25 },
+        speedIndex: { good: 3400, poor: 5800 },
+        tti: { good: 3800, poor: 7300 },
+    };
+    const threshold = thresholds[metric.toLowerCase()];
+    if (!threshold) {
+        return 'needs-improvement';
+    }
+    if (value <= threshold.good) {
+        return 'good';
+    }
+    if (value >= threshold.poor) {
+        return 'poor';
+    }
+    return 'needs-improvement';
+}
+//# sourceMappingURL=extractor.js.map

package/dist/metrics/extractor.js.map

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

package/dist/metrics/loader.d.ts

@@ -0,0 +1,35 @@
+import { LHReport } from '../types';
+/**
+ * Load Lighthouse reports from the .lighthouseci directory
+ */
+export declare function loadLighthouseReports(basePath?: string): Promise<LHReport[]>;
+/**
+ * Load a specific Lighthouse report by filename
+ */
+export declare function loadReportByName(filename: string, basePath?: string): Promise<LHReport>;
+/**
+ * Load the manifest file from .lighthouseci
+ */
+export declare function loadManifest(basePath?: string): Promise<ManifestEntry[]>;
+export interface ManifestEntry {
+    url: string;
+    isRepresentativeRun: boolean;
+    jsonPath: string;
+    htmlPath: string;
+    summary: {
+        performance: number;
+        accessibility: number;
+        'best-practices': number;
+        seo: number;
+        pwa?: number;
+    };
+}
+/**
+ * Get the representative run for each URL
+ */
+export declare function getRepresentativeRuns(basePath?: string): Promise<Map<string, LHReport>>;
+/**
+ * List available Lighthouse reports
+ */
+export declare function listReports(basePath?: string): string[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/metrics/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/metrics/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIpC;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAmClF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAU7F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAU9E;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAmB7F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CASvD"}

package/dist/metrics/loader.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadLighthouseReports = loadLighthouseReports;
+exports.loadReportByName = loadReportByName;
+exports.loadManifest = loadManifest;
+exports.getRepresentativeRuns = getRepresentativeRuns;
+exports.listReports = listReports;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const LHCI_DIR = '.lighthouseci';
+/**
+ * Load Lighthouse reports from the .lighthouseci directory
+ */
+async function loadLighthouseReports(basePath) {
+    const lhciDir = (0, path_1.join)(basePath || process.cwd(), LHCI_DIR);
+    if (!(0, fs_1.existsSync)(lhciDir)) {
+        throw new Error(`No ${LHCI_DIR} directory found. Run \`lhci collect\` first to generate Lighthouse reports.`);
+    }
+    const files = (0, fs_1.readdirSync)(lhciDir);
+    const jsonFiles = files.filter((file) => file.startsWith('lhr-') && file.endsWith('.json'));
+    if (jsonFiles.length === 0) {
+        throw new Error(`No Lighthouse reports found in ${LHCI_DIR}. Run \`lhci collect\` first.`);
+    }
+    const reports = [];
+    for (const file of jsonFiles) {
+        try {
+            const content = (0, fs_1.readFileSync)((0, path_1.join)(lhciDir, file), 'utf-8');
+            const report = JSON.parse(content);
+            reports.push(report);
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to parse ${file}:`, error);
+        }
+    }
+    if (reports.length === 0) {
+        throw new Error('Failed to load any valid Lighthouse reports.');
+    }
+    return reports;
+}
+/**
+ * Load a specific Lighthouse report by filename
+ */
+async function loadReportByName(filename, basePath) {
+    const lhciDir = (0, path_1.join)(basePath || process.cwd(), LHCI_DIR);
+    const filePath = (0, path_1.join)(lhciDir, filename);
+    if (!(0, fs_1.existsSync)(filePath)) {
+        throw new Error(`Report not found: ${filename}`);
+    }
+    const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Load the manifest file from .lighthouseci
+ */
+async function loadManifest(basePath) {
+    const lhciDir = (0, path_1.join)(basePath || process.cwd(), LHCI_DIR);
+    const manifestPath = (0, path_1.join)(lhciDir, 'manifest.json');
+    if (!(0, fs_1.existsSync)(manifestPath)) {
+        return [];
+    }
+    const content = (0, fs_1.readFileSync)(manifestPath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Get the representative run for each URL
+ */
+async function getRepresentativeRuns(basePath) {
+    const manifest = await loadManifest(basePath);
+    const runs = new Map();
+    for (const entry of manifest) {
+        if (entry.isRepresentativeRun) {
+            try {
+                const report = await loadReportByName(entry.jsonPath.replace('.lighthouseci/', ''), basePath);
+                runs.set(entry.url, report);
+            }
+            catch (error) {
+                console.warn(`Warning: Failed to load representative run for ${entry.url}`);
+            }
+        }
+    }
+    return runs;
+}
+/**
+ * List available Lighthouse reports
+ */
+function listReports(basePath) {
+    const lhciDir = (0, path_1.join)(basePath || process.cwd(), LHCI_DIR);
+    if (!(0, fs_1.existsSync)(lhciDir)) {
+        return [];
+    }
+    const files = (0, fs_1.readdirSync)(lhciDir);
+    return files.filter((file) => file.startsWith('lhr-') && file.endsWith('.json'));
+}
+//# sourceMappingURL=loader.js.map

package/dist/metrics/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/metrics/loader.ts"],"names":[],"mappings":";;AASA,sDAmCC;AAKD,4CAUC;AAKD,oCAUC;AAmBD,sDAmBC;AAKD,kCASC;AA9HD,2BAA2D;AAC3D,+BAA4B;AAG5B,MAAM,QAAQ,GAAG,eAAe,CAAC;AAEjC;;GAEG;AACI,KAAK,UAAU,qBAAqB,CAAC,QAAiB;IAC3D,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE1D,IAAI,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,MAAM,QAAQ,8EAA8E,CAC7F,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,gBAAW,EAAC,OAAO,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5F,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,+BAA+B,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAe,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,4BAA4B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAiB;IACxE,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;AACzC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,YAAY,CAAC,QAAiB;IAClD,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAEpD,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;AAChD,CAAC;AAgBD;;GAEG;AACI,KAAK,UAAU,qBAAqB,CAAC,QAAiB;IAC3D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEzC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,EAC5C,QAAQ,CACT,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,QAAiB;IAC3C,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE1D,IAAI,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,gBAAW,EAAC,OAAO,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/output/json.d.ts

@@ -0,0 +1,23 @@
+import { AnalysisResult } from '../types';
+/**
+ * Format analysis result as JSON
+ */
+export declare function formatAsJSON(result: AnalysisResult, pretty?: boolean): string;
+/**
+ * Output analysis result as JSON to stdout
+ */
+export declare function outputAsJSON(result: AnalysisResult, pretty?: boolean): void;
+/**
+ * Parse analysis result from JSON
+ */
+export declare function parseFromJSON(json: string): AnalysisResult;
+/**
+ * Create a minimal JSON report
+ */
+export declare function formatMinimalJSON(result: AnalysisResult): string;
+/**
+ * Format as SARIF (Static Analysis Results Interchange Format)
+ * Useful for GitHub Advanced Security integration
+ */
+export declare function formatAsSARIF(result: AnalysisResult): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,GAAE,OAAc,GAAG,MAAM,CA4CnF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,GAAE,OAAc,GAAG,IAAI,CAEjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAW1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAWhE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAsC5D"}