@infograb/docker-slim-advisor 0.1.0

package/build/size-estimator.js

@@ -0,0 +1,238 @@
+/**
+ * Size prediction engine — estimates Before/After image sizes from parsed
+ * Dockerfile instructions using base image DB lookups + layer heuristics.
+ *
+ * Strategy:
+ * - Base image: direct DB lookup via getImageSize()
+ * - RUN layers: heuristic by command type (apt install, pip, npm, etc.)
+ * - COPY/ADD: rough estimates based on source patterns
+ * - After: subtract recommendation savings from before estimate
+ */
+// --- Constants (bytes) ---
+/** Fallback base image size when not found in DB */
+const UNKNOWN_BASE_IMAGE_SIZE = 200_000_000; // 200MB
+/** Base size estimate per package-manager install command */
+const PKG_INSTALL_SIZE = {
+    'apt-get install': 50_000_000,
+    'apt install': 50_000_000,
+    'apk add': 15_000_000,
+    'yum install': 60_000_000,
+    'dnf install': 60_000_000,
+    'pip install': 30_000_000,
+    'pip3 install': 30_000_000,
+    'npm install': 80_000_000,
+    'npm ci': 80_000_000,
+    'yarn install': 80_000_000,
+    'yarn add': 40_000_000,
+    'pnpm install': 60_000_000,
+    'gem install': 20_000_000,
+    'go build': 30_000_000,
+    'go install': 30_000_000,
+    'cargo build': 100_000_000,
+    'cargo install': 50_000_000,
+    'composer install': 40_000_000,
+    'bundle install': 50_000_000,
+};
+/** Average per-package size by package manager prefix */
+const PER_PACKAGE_SIZE = {
+    'apt-get': 15_000_000,
+    'apt': 15_000_000,
+    'apk': 5_000_000,
+    'yum': 20_000_000,
+    'dnf': 20_000_000,
+};
+/** Override sizes for known heavy packages */
+const HEAVY_PACKAGES = {
+    'build-essential': 250_000_000,
+    'gcc': 150_000_000,
+    'g++': 150_000_000,
+    'cmake': 40_000_000,
+    'git': 40_000_000,
+    'curl': 10_000_000,
+    'wget': 8_000_000,
+    'python3': 50_000_000,
+    'python3-dev': 30_000_000,
+    'openjdk-17-jdk': 350_000_000,
+    'openjdk-21-jdk': 370_000_000,
+    'nodejs': 80_000_000,
+    'default-jdk': 350_000_000,
+    'libssl-dev': 10_000_000,
+};
+/** Estimated savings from cache cleanup (apt-get clean, etc.) */
+export const APT_CACHE_CLEANUP_SAVINGS = 30_000_000;
+export const APK_CACHE_CLEANUP_SAVINGS = 10_000_000;
+const DEFAULT_COPY_SIZE = 10_000_000; // 10MB
+const GENERIC_CMD_SIZE = 1_000_000; // 1MB fallback per command
+// --- Public API ---
+/**
+ * Estimate the "before" (current) image size from parsed instructions.
+ */
+export function estimateBeforeSize(instructions, getImageSizeFn) {
+    const fromInstr = instructions.find((i) => i.type === 'FROM');
+    if (!fromInstr) {
+        return { baseImageBytes: 0, layerBytes: 0, totalBytes: 0 };
+    }
+    const baseImageBytes = getImageSizeFn(fromInstr.image, fromInstr.tag)
+        ?? UNKNOWN_BASE_IMAGE_SIZE;
+    let layerBytes = 0;
+    for (const instr of instructions) {
+        switch (instr.type) {
+            case 'RUN':
+                layerBytes += estimateRunLayerSize(instr);
+                break;
+            case 'COPY':
+                layerBytes += estimateCopyLayerSize(instr);
+                break;
+            case 'ADD':
+                layerBytes += estimateAddLayerSize(instr);
+                break;
+        }
+    }
+    return { baseImageBytes, layerBytes, totalBytes: baseImageBytes + layerBytes };
+}
+/**
+ * Estimate the "after" (optimized) image size by subtracting recommendation savings.
+ * If a base-image swap recommendation exists, uses the alternative base size.
+ */
+export function estimateAfterSize(beforeSize, recommendations, newBaseImageBytes) {
+    const baseSwapRec = recommendations.find((r) => r.ruleId === 'DSA001');
+    const adjustedBase = baseSwapRec && newBaseImageBytes !== undefined
+        ? newBaseImageBytes
+        : beforeSize.baseImageBytes;
+    // Layer savings = total savings minus base-image swap savings
+    const totalSavings = recommendations.reduce((s, r) => s + r.estimatedSavingsBytes, 0);
+    const layerSavings = baseSwapRec
+        ? totalSavings - baseSwapRec.estimatedSavingsBytes
+        : totalSavings;
+    const newLayerBytes = Math.max(0, beforeSize.layerBytes - layerSavings);
+    return {
+        baseImageBytes: adjustedBase,
+        layerBytes: newLayerBytes,
+        totalBytes: adjustedBase + newLayerBytes,
+    };
+}
+/** Calculate size reduction percentage (0 if beforeBytes is 0) */
+export function calcSizeReductionPercent(beforeBytes, afterBytes) {
+    if (beforeBytes === 0)
+        return 0;
+    return Math.round(((beforeBytes - afterBytes) / beforeBytes) * 1000) / 10;
+}
+/**
+ * Estimate cache cleanup savings for a RUN command string.
+ * Used by optimization rules to populate estimatedSavingsBytes.
+ */
+export function estimateCacheCleanupSavings(command) {
+    const lower = command.toLowerCase();
+    const hasCleanup = CLEANUP_PATTERNS.some((p) => lower.includes(p));
+    if (hasCleanup)
+        return 0; // Already cleaning
+    if (lower.includes('apt-get install') || lower.includes('apt install')) {
+        return APT_CACHE_CLEANUP_SAVINGS;
+    }
+    if (lower.includes('apk add'))
+        return APK_CACHE_CLEANUP_SAVINGS;
+    return 0;
+}
+// --- Internal Helpers ---
+/** Split RUN command by && or ; into individual subcommands */
+function splitCommands(command) {
+    return command
+        .split(/\s*(?:&&|;)\s*/)
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0);
+}
+/** Estimate size of a RUN instruction's layer */
+function estimateRunLayerSize(instr) {
+    const commands = splitCommands(instr.command);
+    let size = 0;
+    for (const cmd of commands) {
+        const lower = cmd.toLowerCase();
+        // Skip cache cleanup commands (they reduce, not add)
+        if (isCacheCleanup(lower))
+            continue;
+        // Match package manager install patterns
+        let matched = false;
+        for (const [pattern, baseSize] of Object.entries(PKG_INSTALL_SIZE)) {
+            if (lower.includes(pattern)) {
+                const pkgCount = countPackages(lower, pattern);
+                if (pkgCount > 0) {
+                    const mgr = pattern.split(' ')[0];
+                    size += estimatePackagesSize(lower, pkgCount, PER_PACKAGE_SIZE[mgr] ?? 10_000_000);
+                }
+                else {
+                    size += baseSize;
+                }
+                matched = true;
+                break;
+            }
+        }
+        if (!matched) {
+            size += GENERIC_CMD_SIZE;
+        }
+    }
+    return size;
+}
+/** Count package names after an install command (excluding flags) */
+function countPackages(cmd, installPattern) {
+    const afterInstall = cmd.split(installPattern)[1] || '';
+    return afterInstall
+        .split(/\s+/)
+        .filter((t) => t.length > 0 && !t.startsWith('-') && !t.includes('='))
+        .length;
+}
+/** Estimate total size from known heavy packages + default per-package */
+function estimatePackagesSize(cmd, count, defaultPerPkg) {
+    let total = 0;
+    let heavyMatched = 0;
+    for (const [pkg, size] of Object.entries(HEAVY_PACKAGES)) {
+        if (cmd.includes(pkg)) {
+            total += size;
+            heavyMatched++;
+        }
+    }
+    const remaining = Math.max(0, count - heavyMatched);
+    total += remaining * defaultPerPkg;
+    return total;
+}
+const CLEANUP_PATTERNS = [
+    'apt-get clean',
+    'apt-get autoremove',
+    'rm -rf /var/lib/apt/lists',
+    'rm -rf /var/cache/apt',
+    'apk cache clean',
+    'yum clean all',
+    'dnf clean all',
+    'rm -rf /tmp/',
+    'rm -rf /root/.cache',
+    'pip cache purge',
+    'npm cache clean',
+    'yarn cache clean',
+];
+function isCacheCleanup(cmd) {
+    return CLEANUP_PATTERNS.some((p) => cmd.includes(p));
+}
+/** Estimate COPY layer size from source pattern */
+function estimateCopyLayerSize(instr) {
+    if (instr.from)
+        return DEFAULT_COPY_SIZE / 2; // multi-stage copy
+    const src = instr.source;
+    if (src.includes('package') || src.includes('.json') || src.includes('.lock')) {
+        return 500_000; // config/lock files ~500KB
+    }
+    if (src === '.' || src === './') {
+        return 50_000_000; // entire project ~50MB
+    }
+    return DEFAULT_COPY_SIZE;
+}
+/** Estimate ADD layer size from source pattern */
+function estimateAddLayerSize(instr) {
+    const src = instr.source;
+    if (src.startsWith('http://') || src.startsWith('https://')) {
+        return 20_000_000; // remote download ~20MB
+    }
+    if (src.endsWith('.tar.gz') || src.endsWith('.tgz') || src.endsWith('.tar')) {
+        return 50_000_000; // archive ~50MB
+    }
+    return DEFAULT_COPY_SIZE;
+}
+//# sourceMappingURL=size-estimator.js.map

package/build/size-estimator.js.map

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

package/build/tty-detection.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Centralized TTY detection for output formatting.
+ *
+ * Rules:
+ * - Emoji and color only when stdout.isTTY === true
+ * - NO_COLOR env var (any value) disables color per https://no-color.org/
+ * - FORCE_COLOR env var overrides TTY check (for CI systems that support color)
+ * - Non-TTY (piped) output gets plain text only
+ */
+/** Determine if colored output should be used */
+export declare function shouldUseColor(): boolean;
+/** Determine if emoji should be used (TTY only, NO_COLOR does not affect emoji) */
+export declare function shouldUseEmoji(): boolean;
+/** Combined output capabilities for formatters */
+export interface OutputCapabilities {
+    color: boolean;
+    emoji: boolean;
+}
+/** Get all output capabilities in a single call */
+export declare function getOutputCapabilities(): OutputCapabilities;

package/build/tty-detection.js

@@ -0,0 +1,33 @@
+/**
+ * Centralized TTY detection for output formatting.
+ *
+ * Rules:
+ * - Emoji and color only when stdout.isTTY === true
+ * - NO_COLOR env var (any value) disables color per https://no-color.org/
+ * - FORCE_COLOR env var overrides TTY check (for CI systems that support color)
+ * - Non-TTY (piped) output gets plain text only
+ */
+/** Determine if colored output should be used */
+export function shouldUseColor() {
+    // NO_COLOR takes highest priority per spec — any value disables color
+    if (process.env['NO_COLOR'] !== undefined)
+        return false;
+    // FORCE_COLOR overrides TTY detection (used by some CI systems)
+    if (process.env['FORCE_COLOR'] !== undefined && process.env['FORCE_COLOR'] !== '0')
+        return true;
+    // Default: color only when stdout is a TTY
+    return process.stdout.isTTY === true;
+}
+/** Determine if emoji should be used (TTY only, NO_COLOR does not affect emoji) */
+export function shouldUseEmoji() {
+    // Emoji only renders correctly in interactive terminals
+    return process.stdout.isTTY === true;
+}
+/** Get all output capabilities in a single call */
+export function getOutputCapabilities() {
+    return {
+        color: shouldUseColor(),
+        emoji: shouldUseEmoji(),
+    };
+}
+//# sourceMappingURL=tty-detection.js.map

package/build/tty-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty-detection.js","sourceRoot":"","sources":["../src/tty-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iDAAiD;AACjD,MAAM,UAAU,cAAc;IAC5B,sEAAsE;IACtE,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAExD,gEAAgE;IAChE,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEhG,2CAA2C;IAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc;IAC5B,wDAAwD;IACxD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvC,CAAC;AAQD,mDAAmD;AACnD,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,KAAK,EAAE,cAAc,EAAE;QACvB,KAAK,EAAE,cAAc,EAAE;KACxB,CAAC;AACJ,CAAC"}

package/build/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Typed AST for parsed Dockerfile instructions.
+ * Serves as intermediate representation between parser and rules.
+ */
+export type InstructionType = 'FROM' | 'RUN' | 'COPY' | 'ADD' | 'ENV' | 'EXPOSE' | 'WORKDIR' | 'CMD' | 'ENTRYPOINT' | 'LABEL' | 'ARG' | 'VOLUME' | 'USER' | 'HEALTHCHECK' | 'SHELL' | 'STOPSIGNAL' | 'ONBUILD' | 'UNKNOWN';
+/** Base instruction with line number and raw text */
+export interface BaseInstruction {
+    type: InstructionType;
+    line: number;
+    raw: string;
+}
+export interface FromInstruction extends BaseInstruction {
+    type: 'FROM';
+    image: string;
+    tag: string;
+    alias?: string;
+}
+export interface RunInstruction extends BaseInstruction {
+    type: 'RUN';
+    command: string;
+    /** Whether this was a multi-line command joined from backslash continuations */
+    isMultiLine: boolean;
+}
+export interface CopyInstruction extends BaseInstruction {
+    type: 'COPY';
+    source: string;
+    destination: string;
+    from?: string;
+}
+export interface AddInstruction extends BaseInstruction {
+    type: 'ADD';
+    source: string;
+    destination: string;
+}
+export interface EnvInstruction extends BaseInstruction {
+    type: 'ENV';
+    key: string;
+    value: string;
+}
+export interface GenericInstruction extends BaseInstruction {
+    type: Exclude<InstructionType, 'FROM' | 'RUN' | 'COPY' | 'ADD' | 'ENV'>;
+    arguments: string;
+}
+export type Instruction = FromInstruction | RunInstruction | CopyInstruction | AddInstruction | EnvInstruction | GenericInstruction;
+/** Severity level for optimization recommendations */
+export type Severity = 'HIGH' | 'MEDIUM' | 'LOW';
+/** A single optimization recommendation */
+export interface Recommendation {
+    ruleId: string;
+    severity: Severity;
+    line: number;
+    title: string;
+    description: string;
+    /** Concrete Dockerfile modification suggestion */
+    fix: string;
+    /** Estimated bytes saved by applying this recommendation */
+    estimatedSavingsBytes: number;
+}
+/** Rule interface - each optimization rule implements this */
+export interface Rule {
+    id: string;
+    name: string;
+    description: string;
+    evaluate(instructions: Instruction[], context: RuleContext): Recommendation[];
+}
+/** Context passed to rules for size estimation */
+export interface RuleContext {
+    /** Base image size lookup function */
+    getImageSize: (image: string, tag: string) => number | undefined;
+}
+/** Full analysis result */
+export interface AnalysisResult {
+    dockerfilePath: string;
+    isMultiStage: boolean;
+    baseImage: string;
+    instructions: Instruction[];
+    recommendations: Recommendation[];
+    estimatedBeforeSizeBytes: number;
+    estimatedAfterSizeBytes: number;
+    sizeReductionPercent: number;
+    schemaVersion: number;
+}

package/build/types.js

@@ -0,0 +1,6 @@
+/**
+ * Typed AST for parsed Dockerfile instructions.
+ * Serves as intermediate representation between parser and rules.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@infograb/docker-slim-advisor",
+  "version": "0.1.0",
+  "description": "CLI tool to analyze Dockerfiles and recommend image size optimizations — reduce build size, catch bloat, improve layer efficiency",
+  "type": "module",
+  "main": "./build/cli.js",
+  "bin": {
+    "docker-slim-advisor": "./build/cli.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dockerfile",
+    "docker",
+    "optimization",
+    "cli",
+    "devops",
+    "image-size",
+    "container",
+    "linter",
+    "analyzer",
+    "docker-build"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "fetch-sizes": "tsx scripts/fetch-image-sizes.ts",
+    "fetch-sizes:fallback": "tsx scripts/fetch-image-sizes.ts --fallback-only",
+    "validate-db": "tsx scripts/validate-db.ts",
+    "validate:sizes": "tsx scripts/validate-image-sizes.ts"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}