@infograb/docker-slim-advisor 0.1.0

package/build/formatters/json-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-formatter.js","sourceRoot":"","sources":["../../src/formatters/json-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,6CAA6C;AAC7C,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,IAAI,aAAa;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,IAAI,KAAK,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,IAAI,KAAK,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC;AAED,mDAAmD;AACnD,SAAS,aAAa,CAAC,GAAmB;IACxC,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,qBAAqB,EAAE,GAAG,CAAC,qBAAqB;KACjD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,MAAsB,EACtB,uBAAyC;IAEzC,MAAM,MAAM,GAAe;QACzB,aAAa,EAAE,mBAAmB;QAClC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,mBAAmB,EAAE;YACnB,UAAU,EAAE,MAAM,CAAC,wBAAwB;YAC3C,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,wBAAwB,CAAC;SAC5D;QACD,kBAAkB,EAAE;YAClB,UAAU,EAAE,MAAM,CAAC,uBAAuB;YAC1C,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,uBAAuB,CAAC;SAC3D;QACD,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,MAAM;QAC5C,QAAQ,EAAE,uBAAuB,CAAC,GAAG,CAAC,aAAa,CAAC;KACrD,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/build/formatters/json-schema.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Versioned JSON output schema for docker-slim-advisor.
+ *
+ * This module defines the wire format emitted when --format=json is used.
+ * Schema is versioned so downstream consumers (CI pipelines, GitHub Actions)
+ * can detect breaking changes.
+ *
+ * Schema version changelog:
+ *   1 — initial release
+ */
+/** Current schema version — bump on breaking changes to the JSON shape */
+export declare const JSON_SCHEMA_VERSION = 1;
+/** A single optimization finding in JSON output */
+export interface JsonFinding {
+    /** Rule identifier, e.g. "DSA001" */
+    ruleId: string;
+    /** Severity level */
+    severity: 'HIGH' | 'MEDIUM' | 'LOW';
+    /** 1-indexed Dockerfile line where the issue was found */
+    line: number;
+    /** Short summary of the finding */
+    title: string;
+    /** Detailed explanation */
+    description: string;
+    /** Concrete Dockerfile fix suggestion */
+    fix: string;
+    /** Estimated bytes saved by applying this fix */
+    estimatedSavingsBytes: number;
+}
+/** Size estimate section in JSON output */
+export interface JsonSizeEstimate {
+    /** Total estimated size in bytes */
+    totalBytes: number;
+    /** Human-readable size string, e.g. "245MB" */
+    humanReadable: string;
+}
+/** Top-level versioned JSON output */
+export interface JsonOutput {
+    /** Schema version for forward compatibility */
+    schemaVersion: number;
+    /** Path to the analyzed Dockerfile */
+    dockerfilePath: string;
+    /** Whether this is a multi-stage build (already optimized) */
+    isMultiStage: boolean;
+    /** Base image detected from FROM instruction */
+    baseImage: string;
+    /** Estimated size before optimizations */
+    estimatedBeforeSize: JsonSizeEstimate;
+    /** Estimated size after applying all recommendations */
+    estimatedAfterSize: JsonSizeEstimate;
+    /** Percentage reduction from before to after */
+    sizeReductionPercent: number;
+    /** Total number of findings (before severity filtering) */
+    totalFindings: number;
+    /** Optimization findings (filtered by --severity) */
+    findings: JsonFinding[];
+}

package/build/formatters/json-schema.js

@@ -0,0 +1,13 @@
+/**
+ * Versioned JSON output schema for docker-slim-advisor.
+ *
+ * This module defines the wire format emitted when --format=json is used.
+ * Schema is versioned so downstream consumers (CI pipelines, GitHub Actions)
+ * can detect breaking changes.
+ *
+ * Schema version changelog:
+ *   1 — initial release
+ */
+/** Current schema version — bump on breaking changes to the JSON shape */
+export const JSON_SCHEMA_VERSION = 1;
+//# sourceMappingURL=json-schema.js.map

package/build/formatters/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/formatters/json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC"}

package/build/formatters/markdown-formatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Markdown formatter — renders AnalysisResult as a Markdown report
+ * with table layout for Before/After size predictions.
+ *
+ * Designed for PR comments, CI artifacts, and documentation embedding.
+ */
+import type { AnalysisResult, Recommendation } from '../types.js';
+/**
+ * Format an AnalysisResult as Markdown with table layout for size predictions.
+ * Output is plain Markdown — no TTY detection or color codes needed.
+ */
+export declare function formatMarkdown(result: AnalysisResult, filteredRecommendations: Recommendation[]): string;

package/build/formatters/markdown-formatter.js

@@ -0,0 +1,97 @@
+/**
+ * Markdown formatter — renders AnalysisResult as a Markdown report
+ * with table layout for Before/After size predictions.
+ *
+ * Designed for PR comments, CI artifacts, and documentation embedding.
+ */
+// --- Formatting Helpers ---
+/** Convert bytes to human-readable string (e.g. "245.3MB") */
+function formatBytes(bytes) {
+    if (bytes >= 1_000_000_000)
+        return `${(bytes / 1_000_000_000).toFixed(1)}GB`;
+    if (bytes >= 1_000_000)
+        return `${(bytes / 1_000_000).toFixed(1)}MB`;
+    if (bytes >= 1_000)
+        return `${(bytes / 1_000).toFixed(1)}KB`;
+    return `${bytes}B`;
+}
+/** Severity emoji for Markdown output */
+function severityEmoji(severity) {
+    switch (severity) {
+        case 'HIGH': return '\u{1F534}'; // 🔴
+        case 'MEDIUM': return '\u{1F7E1}'; // 🟡
+        case 'LOW': return '\u{1F535}'; // 🔵
+    }
+}
+// --- Public API ---
+/**
+ * Format an AnalysisResult as Markdown with table layout for size predictions.
+ * Output is plain Markdown — no TTY detection or color codes needed.
+ */
+export function formatMarkdown(result, filteredRecommendations) {
+    const lines = [];
+    // --- Header ---
+    lines.push('# Docker Slim Advisor Report');
+    lines.push('');
+    lines.push(`- **File:** \`${result.dockerfilePath}\``);
+    lines.push(`- **Base Image:** \`${result.baseImage}\``);
+    lines.push('');
+    // --- Multi-stage detection ---
+    if (result.isMultiStage) {
+        lines.push('> **Multi-stage build detected** — already optimized!');
+        lines.push('');
+        return lines.join('\n');
+    }
+    // --- Size Prediction Table ---
+    lines.push('## Size Prediction');
+    lines.push('');
+    lines.push('| Metric | Size |');
+    lines.push('|--------|------|');
+    const beforeStr = formatBytes(result.estimatedBeforeSizeBytes);
+    const afterStr = formatBytes(result.estimatedAfterSizeBytes);
+    const savedBytes = result.estimatedBeforeSizeBytes - result.estimatedAfterSizeBytes;
+    const savedStr = formatBytes(Math.abs(savedBytes));
+    const pct = result.sizeReductionPercent;
+    lines.push(`| Before | ${beforeStr} |`);
+    lines.push(`| After  | ${afterStr} |`);
+    lines.push(`| Savings | ${savedBytes > 0 ? `**${savedStr}** (${pct}% reduction)` : 'None'} |`);
+    lines.push('');
+    // --- Findings ---
+    if (filteredRecommendations.length === 0) {
+        lines.push('## Findings');
+        lines.push('');
+        lines.push('No optimization findings at this severity level.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    lines.push(`## Findings (${filteredRecommendations.length})`);
+    lines.push('');
+    lines.push('| Severity | Line | Rule | Title | Savings |');
+    lines.push('|----------|------|------|-------|---------|');
+    for (const rec of filteredRecommendations) {
+        const emoji = severityEmoji(rec.severity);
+        const savings = rec.estimatedSavingsBytes > 0
+            ? `~${formatBytes(rec.estimatedSavingsBytes)}`
+            : '-';
+        lines.push(`| ${emoji} ${rec.severity} | ${rec.line} | \`${rec.ruleId}\` | ${rec.title} | ${savings} |`);
+    }
+    lines.push('');
+    // --- Detailed Findings ---
+    lines.push('### Details');
+    lines.push('');
+    for (const rec of filteredRecommendations) {
+        const emoji = severityEmoji(rec.severity);
+        lines.push(`#### ${emoji} ${rec.title} (\`${rec.ruleId}\`) — Line ${rec.line}`);
+        lines.push('');
+        lines.push(rec.description);
+        lines.push('');
+        lines.push(`**Fix:** ${rec.fix}`);
+        if (rec.estimatedSavingsBytes > 0) {
+            lines.push('');
+            lines.push(`**Estimated savings:** ~${formatBytes(rec.estimatedSavingsBytes)}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=markdown-formatter.js.map

package/build/formatters/markdown-formatter.js.map

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

package/build/formatters/terminal-formatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Terminal formatter — renders AnalysisResult as human-readable colored output.
+ *
+ * TTY-aware: emoji and color only when isatty()=true.
+ * Respects NO_COLOR env var per https://no-color.org/
+ */
+import type { AnalysisResult, Recommendation } from '../types.js';
+/**
+ * Format an AnalysisResult as terminal-friendly text.
+ * Output goes to stdout; respects TTY and NO_COLOR.
+ */
+export declare function formatTerminal(result: AnalysisResult, filteredRecommendations: Recommendation[]): string;

package/build/formatters/terminal-formatter.js

@@ -0,0 +1,142 @@
+/**
+ * Terminal formatter — renders AnalysisResult as human-readable colored output.
+ *
+ * TTY-aware: emoji and color only when isatty()=true.
+ * Respects NO_COLOR env var per https://no-color.org/
+ */
+import chalk from 'chalk';
+import { shouldUseColor, shouldUseEmoji } from '../tty-detection.js';
+// --- Formatting Helpers ---
+/** Convert bytes to human-readable string (e.g. "245.3MB") */
+function formatBytes(bytes) {
+    if (bytes >= 1_000_000_000)
+        return `${(bytes / 1_000_000_000).toFixed(1)}GB`;
+    if (bytes >= 1_000_000)
+        return `${(bytes / 1_000_000).toFixed(1)}MB`;
+    if (bytes >= 1_000)
+        return `${(bytes / 1_000).toFixed(1)}KB`;
+    return `${bytes}B`;
+}
+/** Severity badge with optional color */
+function severityBadge(severity, useColor) {
+    const label = `[${severity}]`;
+    if (!useColor)
+        return label;
+    switch (severity) {
+        case 'HIGH': return chalk.red.bold(label);
+        case 'MEDIUM': return chalk.yellow(label);
+        case 'LOW': return chalk.blue(label);
+    }
+}
+/** Severity icon (emoji when TTY, text fallback otherwise) */
+function severityIcon(severity, useEmoji) {
+    if (!useEmoji)
+        return '';
+    switch (severity) {
+        case 'HIGH': return '\u{1F6A8} '; // 🚨
+        case 'MEDIUM': return '\u{26A0}\u{FE0F}  '; // ⚠️
+        case 'LOW': return '\u{1F4A1} '; // 💡
+    }
+}
+/** Build a simple horizontal bar for size comparison */
+function sizeBar(beforeBytes, afterBytes, useColor) {
+    const barWidth = 30;
+    const ratio = beforeBytes > 0 ? afterBytes / beforeBytes : 1;
+    const afterWidth = Math.max(1, Math.round(barWidth * ratio));
+    const savedWidth = barWidth - afterWidth;
+    const afterBar = '\u{2588}'.repeat(afterWidth); // █
+    const savedBar = '\u{2591}'.repeat(savedWidth); // ░
+    if (!useColor)
+        return `[${afterBar}${savedBar}]`;
+    return `[${chalk.green(afterBar)}${chalk.gray(savedBar)}]`;
+}
+// --- Public API ---
+/**
+ * Format an AnalysisResult as terminal-friendly text.
+ * Output goes to stdout; respects TTY and NO_COLOR.
+ */
+export function formatTerminal(result, filteredRecommendations) {
+    const useColor = shouldUseColor();
+    const useEmoji = shouldUseEmoji();
+    const lines = [];
+    // --- Header ---
+    const headerIcon = useEmoji ? '\u{1F433} ' : ''; // 🐳
+    const title = `${headerIcon}Docker Slim Advisor`;
+    lines.push(useColor ? chalk.bold.cyan(title) : title);
+    lines.push(useColor ? chalk.dim('-'.repeat(50)) : '-'.repeat(50));
+    lines.push('');
+    // --- File & Base Image ---
+    lines.push(`  File:       ${result.dockerfilePath}`);
+    lines.push(`  Base Image: ${useColor ? chalk.white.bold(result.baseImage) : result.baseImage}`);
+    // --- Multi-stage detection ---
+    if (result.isMultiStage) {
+        const msIcon = useEmoji ? '\u{2705} ' : ''; // ✅
+        const msg = `${msIcon}Multi-stage build detected — already optimized!`;
+        lines.push('');
+        lines.push(useColor ? chalk.green(msg) : msg);
+        lines.push('');
+        return lines.join('\n');
+    }
+    lines.push('');
+    // --- Size Predictions ---
+    const sizeIcon = useEmoji ? '\u{1F4E6} ' : ''; // 📦
+    const sizeTitle = `${sizeIcon}Size Prediction`;
+    lines.push(useColor ? chalk.bold(sizeTitle) : sizeTitle);
+    lines.push('');
+    const beforeStr = formatBytes(result.estimatedBeforeSizeBytes);
+    const afterStr = formatBytes(result.estimatedAfterSizeBytes);
+    const savedBytes = result.estimatedBeforeSizeBytes - result.estimatedAfterSizeBytes;
+    const savedStr = formatBytes(Math.abs(savedBytes));
+    const beforeLabel = useColor ? chalk.red(`  Before: ${beforeStr}`) : `  Before: ${beforeStr}`;
+    const afterLabel = useColor ? chalk.green(`  After:  ${afterStr}`) : `  After:  ${afterStr}`;
+    lines.push(beforeLabel);
+    lines.push(afterLabel);
+    lines.push('');
+    // Size bar visualization
+    lines.push(`  ${sizeBar(result.estimatedBeforeSizeBytes, result.estimatedAfterSizeBytes, useColor)}`);
+    lines.push('');
+    // Savings summary
+    const reductionPct = result.sizeReductionPercent;
+    const savingsIcon = useEmoji ? '\u{1F4C9} ' : ''; // 📉
+    const savingsText = savedBytes > 0
+        ? `${savingsIcon}Estimated savings: ${savedStr} (${reductionPct}% reduction)`
+        : `${savingsIcon}No size reduction estimated`;
+    lines.push(useColor && savedBytes > 0
+        ? chalk.green.bold(`  ${savingsText}`)
+        : `  ${savingsText}`);
+    lines.push('');
+    // --- Findings ---
+    if (filteredRecommendations.length === 0) {
+        const noFindIcon = useEmoji ? '\u{2728} ' : ''; // ✨
+        const noFindMsg = `${noFindIcon}No optimization findings at this severity level.`;
+        lines.push(useColor ? chalk.green(noFindMsg) : noFindMsg);
+        lines.push('');
+        return lines.join('\n');
+    }
+    const findingsIcon = useEmoji ? '\u{1F50D} ' : ''; // 🔍
+    const findingsTitle = `${findingsIcon}Findings (${filteredRecommendations.length})`;
+    lines.push(useColor ? chalk.bold(findingsTitle) : findingsTitle);
+    lines.push('');
+    for (const rec of filteredRecommendations) {
+        const icon = severityIcon(rec.severity, useEmoji);
+        const badge = severityBadge(rec.severity, useColor);
+        const ruleTag = useColor ? chalk.dim(`(${rec.ruleId})`) : `(${rec.ruleId})`;
+        // Title line: [SEVERITY] Rule Title (DSA-001)  Line 5
+        const lineRef = useColor ? chalk.dim(`Line ${rec.line}`) : `Line ${rec.line}`;
+        lines.push(`  ${icon}${badge} ${rec.title} ${ruleTag}  ${lineRef}`);
+        // Description
+        lines.push(`    ${rec.description}`);
+        // Fix suggestion
+        const fixLabel = useColor ? chalk.yellow('    Fix:') : '    Fix:';
+        lines.push(`${fixLabel} ${rec.fix}`);
+        // Estimated savings for this finding
+        if (rec.estimatedSavingsBytes > 0) {
+            const savStr = formatBytes(rec.estimatedSavingsBytes);
+            const savLine = `    Saves ~${savStr}`;
+            lines.push(useColor ? chalk.dim(savLine) : savLine);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=terminal-formatter.js.map

package/build/formatters/terminal-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-formatter.js","sourceRoot":"","sources":["../../src/formatters/terminal-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,6BAA6B;AAE7B,8DAA8D;AAC9D,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,IAAI,aAAa;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,IAAI,KAAK,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,IAAI,KAAK,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC;AAED,yCAAyC;AACzC,SAAS,aAAa,CAAC,QAAkB,EAAE,QAAiB;IAC1D,MAAM,KAAK,GAAG,IAAI,QAAQ,GAAG,CAAC;IAC9B,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,KAAK,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,KAAK,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,SAAS,YAAY,CAAC,QAAkB,EAAE,QAAiB;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,CAAC,OAAO,YAAY,CAAC,CAAG,KAAK;QACzC,KAAK,QAAQ,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,KAAK;QACjD,KAAK,KAAK,CAAC,CAAC,OAAO,YAAY,CAAC,CAAI,KAAK;IAC3C,CAAC;AACH,CAAC;AAED,wDAAwD;AACxD,SAAS,OAAO,CAAC,WAAmB,EAAE,UAAkB,EAAE,QAAiB;IACzE,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,KAAK,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEzC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAG,IAAI;IACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAI,IAAI;IAEvD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,QAAQ,GAAG,QAAQ,GAAG,CAAC;IACjD,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;AAC7D,CAAC;AAED,qBAAqB;AAErB;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,uBAAyC;IAEzC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,iBAAiB;IACjB,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK;IACtD,MAAM,KAAK,GAAG,GAAG,UAAU,qBAAqB,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,4BAA4B;IAC5B,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAEhG,gCAAgC;IAChC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QAChD,MAAM,GAAG,GAAG,GAAG,MAAM,iDAAiD,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK;IACpD,MAAM,SAAS,GAAG,GAAG,QAAQ,iBAAiB,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,GAAG,MAAM,CAAC,uBAAuB,CAAC;IACpF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnD,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,SAAS,EAAE,CAAC;IAC9F,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC;IAC7F,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,yBAAyB;IACzB,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,uBAAuB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kBAAkB;IAClB,MAAM,YAAY,GAAG,MAAM,CAAC,oBAAoB,CAAC;IACjD,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK;IACvD,MAAM,WAAW,GAAG,UAAU,GAAG,CAAC;QAChC,CAAC,CAAC,GAAG,WAAW,sBAAsB,QAAQ,KAAK,YAAY,cAAc;QAC7E,CAAC,CAAC,GAAG,WAAW,6BAA6B,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,UAAU,GAAG,CAAC;QACnC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;QACtC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mBAAmB;IACnB,IAAI,uBAAuB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QACpD,MAAM,SAAS,GAAG,GAAG,UAAU,kDAAkD,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK;IACxD,MAAM,aAAa,GAAG,GAAG,YAAY,aAAa,uBAAuB,CAAC,MAAM,GAAG,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAE5E,sDAAsD;QACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;QAEpE,cAAc;QACd,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAErC,iBAAiB;QACjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAErC,qCAAqC;QACrC,IAAI,GAAG,CAAC,qBAAqB,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,cAAc,MAAM,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/build/image-size-lookup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Image size lookup module with fuzzy matching.
+ *
+ * Queries base image sizes by name:tag from the static JSON DB.
+ * Implements a multi-strategy fallback chain:
+ *   1. Exact match — "node:22" hits directly
+ *   2. Scratch special case — always 0 bytes
+ *   3. Latest fallback — bare "node" resolves to "node:latest"
+ *   4. Major-version prefix — "node:22.1.0" matches "node:22"
+ *   5. Distro-variant stripping — "node:22-bookworm" matches "node:22"
+ *   6. Partial tag search — scans keys sharing the same image name
+ */
+import type { ImageSizeEntry, BaseImageDb } from './data/base-image-db-schema.js';
+export interface LookupResult {
+    /** The DB key that matched (may differ from query due to fuzzy match) */
+    matchedKey: string;
+    /** Size entry from the DB */
+    entry: ImageSizeEntry;
+    /** Whether this was an exact or fuzzy match */
+    matchType: 'exact' | 'fuzzy';
+}
+/** Load the static JSON DB, cached after first call */
+export declare function loadDb(): BaseImageDb;
+/** Reset DB cache (for testing) */
+export declare function resetDbCache(): void;
+/**
+ * Look up image size by name and tag with fuzzy fallback chain.
+ * Returns undefined only when no reasonable match exists.
+ */
+export declare function lookupImageSize(image: string, tag: string, images?: Record<string, ImageSizeEntry>): LookupResult | undefined;
+/**
+ * Convenience wrapper matching the RuleContext.getImageSize signature.
+ * Returns compressedBytes (or undefined) for backward compatibility.
+ */
+export declare function getImageSizeFromLookup(image: string, tag: string, images?: Record<string, ImageSizeEntry>): number | undefined;

package/build/image-size-lookup.js

@@ -0,0 +1,187 @@
+/**
+ * Image size lookup module with fuzzy matching.
+ *
+ * Queries base image sizes by name:tag from the static JSON DB.
+ * Implements a multi-strategy fallback chain:
+ *   1. Exact match — "node:22" hits directly
+ *   2. Scratch special case — always 0 bytes
+ *   3. Latest fallback — bare "node" resolves to "node:latest"
+ *   4. Major-version prefix — "node:22.1.0" matches "node:22"
+ *   5. Distro-variant stripping — "node:22-bookworm" matches "node:22"
+ *   6. Partial tag search — scans keys sharing the same image name
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// --- Known distro variants to strip during fuzzy matching ---
+const DISTRO_VARIANTS = [
+    'bookworm', 'bullseye', 'buster', 'stretch', 'jessie', // Debian
+    'jammy', 'focal', 'bionic', 'noble', // Ubuntu
+    'el7', 'el8', 'el9', // RHEL/CentOS
+];
+// --- Module-level cache ---
+let cachedDb = null;
+/** Load the static JSON DB, cached after first call */
+export function loadDb() {
+    if (cachedDb)
+        return cachedDb;
+    const dbPath = join(__dirname, 'data', 'base-image-db.json');
+    cachedDb = JSON.parse(readFileSync(dbPath, 'utf-8'));
+    return cachedDb;
+}
+/** Reset DB cache (for testing) */
+export function resetDbCache() {
+    cachedDb = null;
+}
+// --- Public API ---
+/**
+ * Look up image size by name and tag with fuzzy fallback chain.
+ * Returns undefined only when no reasonable match exists.
+ */
+export function lookupImageSize(image, tag, images) {
+    const db = images ?? loadDb().images;
+    // Strategy 1: Exact match
+    const exactKey = buildKey(image, tag);
+    if (db[exactKey]) {
+        return { matchedKey: exactKey, entry: db[exactKey], matchType: 'exact' };
+    }
+    // Strategy 2: Scratch — always 0 bytes
+    if (image === 'scratch') {
+        return {
+            matchedKey: 'scratch',
+            entry: { compressedBytes: 0, uncompressedBytes: 0 },
+            matchType: 'exact',
+        };
+    }
+    // Strategy 3: Latest fallback — bare image resolves to image:latest
+    if (tag === 'latest') {
+        const latestKey = `${image}:latest`;
+        if (db[latestKey]) {
+            return { matchedKey: latestKey, entry: db[latestKey], matchType: 'exact' };
+        }
+    }
+    // Strategy 4: Major-version prefix — "node:22.1.0" → "node:22"
+    const majorMatch = tryMajorVersionMatch(image, tag, db);
+    if (majorMatch)
+        return majorMatch;
+    // Strategy 5: Distro-variant stripping — "node:22-bookworm" → "node:22"
+    const strippedMatch = tryVariantStripping(image, tag, db);
+    if (strippedMatch)
+        return strippedMatch;
+    // Strategy 6: Partial tag search — find closest tag for same image name
+    const partialMatch = tryPartialTagSearch(image, tag, db);
+    if (partialMatch)
+        return partialMatch;
+    return undefined;
+}
+/**
+ * Convenience wrapper matching the RuleContext.getImageSize signature.
+ * Returns compressedBytes (or undefined) for backward compatibility.
+ */
+export function getImageSizeFromLookup(image, tag, images) {
+    const result = lookupImageSize(image, tag, images);
+    return result?.entry.compressedBytes;
+}
+// --- Internal Strategies ---
+/** Build a canonical "image:tag" key */
+function buildKey(image, tag) {
+    return `${image}:${tag}`;
+}
+/**
+ * Strategy 4: Try matching by major version prefix.
+ * "python:3.12.4" → try "python:3.12" → try "python:3"
+ */
+function tryMajorVersionMatch(image, tag, db) {
+    // Extract version-like prefix before any dash suffix
+    const dashIdx = tag.indexOf('-');
+    const versionPart = dashIdx >= 0 ? tag.slice(0, dashIdx) : tag;
+    const suffix = dashIdx >= 0 ? tag.slice(dashIdx) : '';
+    // Split on dots: "3.12.4" → ["3", "12", "4"]
+    const parts = versionPart.split('.');
+    if (parts.length <= 1)
+        return undefined;
+    // Try progressively shorter version prefixes
+    // "3.12.4-slim" → "3.12-slim" → "3-slim" → "3.12.4" → "3.12" → "3"
+    const candidates = [];
+    // With suffix first (more specific)
+    if (suffix) {
+        for (let i = parts.length - 1; i >= 1; i--) {
+            candidates.push(buildKey(image, parts.slice(0, i).join('.') + suffix));
+        }
+    }
+    // Without suffix
+    for (let i = parts.length - 1; i >= 1; i--) {
+        candidates.push(buildKey(image, parts.slice(0, i).join('.')));
+    }
+    for (const key of candidates) {
+        if (db[key]) {
+            return { matchedKey: key, entry: db[key], matchType: 'fuzzy' };
+        }
+    }
+    return undefined;
+}
+/**
+ * Strategy 5: Strip known distro variants from tag.
+ * "node:22-bookworm-slim" → try "node:22-slim" → try "node:22"
+ * "python:3.12-bullseye" → try "python:3.12"
+ */
+function tryVariantStripping(image, tag, db) {
+    const tagParts = tag.split('-');
+    if (tagParts.length <= 1)
+        return undefined;
+    // Find and remove distro variant segments
+    const filtered = tagParts.filter((part) => !DISTRO_VARIANTS.includes(part));
+    // Only proceed if we actually stripped something
+    if (filtered.length === tagParts.length)
+        return undefined;
+    // Try the stripped tag
+    if (filtered.length > 0) {
+        const strippedKey = buildKey(image, filtered.join('-'));
+        if (db[strippedKey]) {
+            return { matchedKey: strippedKey, entry: db[strippedKey], matchType: 'fuzzy' };
+        }
+    }
+    // Try just the version part (first segment)
+    const versionOnly = buildKey(image, tagParts[0]);
+    if (db[versionOnly]) {
+        return { matchedKey: versionOnly, entry: db[versionOnly], matchType: 'fuzzy' };
+    }
+    return undefined;
+}
+/**
+ * Strategy 6: Partial tag search — find the best matching tag for the same image.
+ * Scores candidates by shared tag prefix length.
+ * Only used as last resort to avoid surprising mismatches.
+ */
+function tryPartialTagSearch(image, tag, db) {
+    const prefix = `${image}:`;
+    let bestKey;
+    let bestScore = 0;
+    for (const key of Object.keys(db)) {
+        if (!key.startsWith(prefix))
+            continue;
+        const candidateTag = key.slice(prefix.length);
+        const score = sharedPrefixLength(tag, candidateTag);
+        // Require at least 1 char of shared prefix to avoid random matches
+        if (score > bestScore) {
+            bestScore = score;
+            bestKey = key;
+        }
+    }
+    // Require reasonable overlap — at least the major version digit
+    if (bestKey && bestScore >= 1) {
+        return { matchedKey: bestKey, entry: db[bestKey], matchType: 'fuzzy' };
+    }
+    return undefined;
+}
+/** Count shared prefix characters between two strings */
+function sharedPrefixLength(a, b) {
+    const len = Math.min(a.length, b.length);
+    let i = 0;
+    while (i < len && a[i] === b[i])
+        i++;
+    return i;
+}
+//# sourceMappingURL=image-size-lookup.js.map

package/build/image-size-lookup.js.map

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

package/build/multi-stage-detector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Multi-stage build detection - counts FROM instructions to determine
+ * if a Dockerfile uses multi-stage builds. Multi-stage Dockerfiles
+ * (2+ FROM instructions) are flagged as "already optimized" since
+ * multi-stage is itself a key size optimization technique.
+ */
+import type { Instruction } from './types.js';
+/** Result of multi-stage detection analysis */
+export interface MultiStageResult {
+    /** Whether the Dockerfile uses multi-stage builds (2+ FROM instructions) */
+    isMultiStage: boolean;
+    /** Total number of FROM instructions (build stages) */
+    stageCount: number;
+    /** The FROM instructions found, with line numbers and aliases */
+    stages: Array<{
+        image: string;
+        tag: string;
+        alias?: string;
+        line: number;
+    }>;
+    /** Human-readable message about multi-stage status */
+    message: string;
+}
+/**
+ * Detect multi-stage builds by counting FROM instructions in the parsed AST.
+ * A Dockerfile with 2+ FROM instructions is considered multi-stage and
+ * "already optimized" for image size via build stages.
+ */
+export declare function detectMultiStage(instructions: Instruction[]): MultiStageResult;