GcLogCommand.java

package io.argus.cli.command;

import io.argus.cli.config.CliConfig;
import io.argus.cli.config.Messages;
import io.argus.cli.export.HtmlExporter;
import io.argus.cli.gclog.*;
import io.argus.cli.provider.ProviderRegistry;
import io.argus.cli.render.AnsiStyle;
import io.argus.cli.render.RichRenderer;

import java.io.ByteArrayOutputStream;
import java.io.PrintStream;
import io.argus.core.command.CommandGroup;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;

/**
 * Analyzes GC log files and produces comprehensive analysis with
 * pause distribution, cause breakdown, and tuning recommendations.
 * Free alternative to GCEasy.io.
 *
 * Usage: argus gclog /var/log/gc.log
 */
public final class GcLogCommand implements Command {

    private static final int WIDTH = RichRenderer.DEFAULT_WIDTH;

    @Override public String name() { return "gclog"; }
    @Override public CommandGroup group() { return CommandGroup.MEMORY; }
    @Override public boolean supportsTui() { return false; }
    @Override public CommandMode mode() { return CommandMode.WRITE; }

    @Override
    public String description(Messages messages) {
        return messages.get("cmd.gclog.desc");
    }

    @Override
    public void execute(String[] args, CliConfig config, ProviderRegistry registry, Messages messages) {
        if (args.length == 0) {
            System.err.println("Usage: argus gclog <gc-log-file>");
            return;
        }

        Path logFile = Path.of(args[0]);
        if (!Files.exists(logFile)) {
            System.err.println("File not found: " + logFile);
            return;
        }

        boolean json = "json".equals(config.format());
        boolean useColor = config.color();
        boolean flagsOnly = false;
        boolean showPhases = false;
        String exportHtml = null;
        for (int i = 1; i < args.length; i++) {
            if (args[i].equals("--format=json")) json = true;
            if (args[i].equals("--suggest-flags")) flagsOnly = true;
            if (args[i].startsWith("--export=")) exportHtml = args[i].substring(9);
            if (args[i].equals("--phases")) showPhases = true;
        }

        List<GcEvent> events;
        List<GcPhaseEvent> phaseEvents = List.of();
        try {
            if (showPhases) {
                GcLogParser.ParseResult result = GcLogParser.parseWithPhases(logFile);
                events = result.events();
                phaseEvents = result.phases();
            } else {
                events = GcLogParser.parse(logFile);
            }
        } catch (IOException e) {
            System.err.println("Failed to read GC log: " + e.getMessage());
            return;
        }

        if (events.isEmpty()) {
            System.err.println("No GC events found in " + logFile);
            return;
        }

        GcLogAnalysis analysis = GcLogAnalyzer.analyze(events);

        if (flagsOnly) {
            for (var rec : analysis.recommendations()) {
                if (!rec.flag().isEmpty()) System.out.println(rec.flag());
            }
            return;
        }

        if (json) {
            printJson(analysis, logFile);
            return;
        }

        if (exportHtml != null) {
            PrintStream original = System.out;
            ByteArrayOutputStream capture = new ByteArrayOutputStream();
            System.setOut(new PrintStream(capture));
            printRich(analysis, events, phaseEvents, logFile, true);
            System.setOut(original);
            String html = HtmlExporter.toHtml(capture.toString(), "Argus GC Log Analysis — " + logFile.getFileName());
            try {
                Path outPath = Path.of(exportHtml.equals("html") ? "argus-gclog.html" : exportHtml);
                Files.writeString(outPath, html);
                System.out.println("Exported to: " + outPath.toAbsolutePath());
            } catch (Exception e) {
                System.err.println("Export failed: " + e.getMessage());
            }
            return;
        }

        printRich(analysis, events, phaseEvents, logFile, useColor);
    }

    private void printRich(GcLogAnalysis a, List<GcEvent> events,
                           List<GcPhaseEvent> phaseEvents,
                           Path file, boolean c) {
        System.out.print(RichRenderer.brandedHeader(c, "gclog",
                "GC log analysis with tuning recommendations"));
        System.out.println(RichRenderer.boxHeader(c, "GC Log Analysis", WIDTH,
                "file:" + file.getFileName()));
        System.out.println(RichRenderer.emptyLine(WIDTH));

        // Summary
        section(c, "Summary");
        kv(c, "Duration", String.format("%.0f seconds", a.durationSec()));
        kv(c, "Total Events", String.valueOf(a.totalEvents()));
        kv(c, "Pause Events", String.valueOf(a.pauseEvents()));
        if (a.fullGcEvents() > 0) {
            kv(c, "Full GC", AnsiStyle.style(c, AnsiStyle.RED) + a.fullGcEvents()
                    + AnsiStyle.style(c, AnsiStyle.RESET));
        }
        kv(c, "Concurrent", String.valueOf(a.concurrentEvents()));

        String tColor = a.throughputPercent() >= 95 ? AnsiStyle.style(c, AnsiStyle.GREEN)
                : a.throughputPercent() >= 90 ? AnsiStyle.style(c, AnsiStyle.YELLOW)
                : AnsiStyle.style(c, AnsiStyle.RED);
        kv(c, "Throughput", tColor + String.format("%.1f%%", a.throughputPercent())
                + AnsiStyle.style(c, AnsiStyle.RESET));

        // Pause Distribution
        section(c, "Pause Distribution");
        System.out.println(RichRenderer.boxLine(String.format(
                "  p50: %dms   p95: %dms   p99: %dms   max: %dms   avg: %dms",
                a.p50PauseMs(), a.p95PauseMs(), a.p99PauseMs(), a.maxPauseMs(), a.avgPauseMs()), WIDTH));
        System.out.println(RichRenderer.emptyLine(WIDTH));

        // ASCII histogram bar
        String bar = "  " + AnsiStyle.style(c, AnsiStyle.GREEN)
                + "\u2588".repeat(Math.min((int)(a.p50PauseMs() / 10), 20))
                + AnsiStyle.style(c, AnsiStyle.YELLOW)
                + "\u2588".repeat(Math.min((int)((a.p95PauseMs() - a.p50PauseMs()) / 10), 15))
                + AnsiStyle.style(c, AnsiStyle.RED)
                + "\u2588".repeat(Math.min((int)((a.maxPauseMs() - a.p95PauseMs()) / 10), 10))
                + AnsiStyle.style(c, AnsiStyle.RESET)
                + "  " + a.p50PauseMs() + "ms ─── " + a.maxPauseMs() + "ms";
        System.out.println(RichRenderer.boxLine(bar, WIDTH));

        // Pause Timeline
        section(c, "Pause Timeline");
        String timeline = GcTimelineRenderer.render(events, a.p50PauseMs(), a.p95PauseMs(), WIDTH, c);
        System.out.print(timeline);

        // Heap
        section(c, "Heap");
        kv(c, "Peak Heap", RichRenderer.formatKB(a.peakHeapKB()));
        kv(c, "Avg After GC", RichRenderer.formatKB(a.avgHeapAfterKB()));

        // Allocation & Promotion Rates
        GcRateAnalyzer.RateAnalysis rates = a.rateAnalysis();
        if (rates != null && rates.allocationRateKBPerSec() > 0) {
            section(c, "Allocation & Promotion Rates");
            kv(c, "Allocation Rate",
                    RichRenderer.formatRate(rates.allocationRateKBPerSec()) + "/s (avg)"
                    + "   peak: " + RichRenderer.formatRate(rates.peakAllocationRateKBPerSec()) + "/s");
            kv(c, "Promotion Rate",
                    RichRenderer.formatRate(rates.promotionRateKBPerSec()) + "/s (avg)"
                    + "   peak: " + RichRenderer.formatRate(rates.peakPromotionRateKBPerSec()) + "/s");
            kv(c, "Reclaim Efficiency",
                    String.format("%.1f%%", rates.reclaimEfficiencyPercent()));
            String ratioColor = rates.promoAllocRatioPercent() > 5
                    ? AnsiStyle.style(c, AnsiStyle.YELLOW) : AnsiStyle.style(c, AnsiStyle.GREEN);
            kv(c, "Promo/Alloc Ratio",
                    ratioColor + String.format("%.1f%%", rates.promoAllocRatioPercent())
                    + AnsiStyle.style(c, AnsiStyle.RESET) + "   (healthy: <5%)");
            System.out.println(RichRenderer.emptyLine(WIDTH));
            System.out.println(RichRenderer.boxLine(
                    "  Alloc  " + sparkline(rates.allocationRateWindows())
                    + "  " + RichRenderer.formatRate(rates.allocationRateKBPerSec()) + "/s avg", WIDTH));
            System.out.println(RichRenderer.boxLine(
                    "  Promo  " + sparkline(rates.promotionRateWindows())
                    + "  " + RichRenderer.formatRate(rates.promotionRateKBPerSec()) + "/s avg", WIDTH));
        }

        // Memory Leak Detection
        GcLeakDetector.LeakAnalysis leak = a.leakAnalysis();
        if (leak != null && leak.trendPoints().length > 0) {
            section(c, "Memory Leak Detection");
            if (leak.leakDetected()) {
                String leakColor = AnsiStyle.style(c, AnsiStyle.RED, AnsiStyle.BOLD);
                kv(c, "Status",
                        leakColor + "\u26a0 LEAK DETECTED"
                        + AnsiStyle.style(c, AnsiStyle.RESET)
                        + String.format(" (R\u00b2=%.2f, %.0f%% confidence)",
                                leak.confidencePercent() / 100.0, leak.confidencePercent()));
                kv(c, "Pattern", leak.pattern()
                        + (leak.staircaseSteps() > 0 ? " (" + leak.staircaseSteps() + " steps)" : ""));
                kv(c, "Growth Rate",
                        RichRenderer.formatRate(leak.heapGrowthRateKBPerSec()) + "/s"
                        + "  (" + RichRenderer.formatRate(leak.heapGrowthRateKBPerSec() * 60) + "/min)");
                if (leak.estimatedOomSec() > 0) {
                    kv(c, "Est. OOM in", formatDuration(leak.estimatedOomSec()));
                }
                System.out.println(RichRenderer.emptyLine(WIDTH));
                String chart = renderTrendChart(leak.trendPoints(), leak.trendMinKB(),
                        leak.trendMaxKB(), WIDTH, c);
                System.out.print(chart);
            } else {
                kv(c, "Status",
                        AnsiStyle.style(c, AnsiStyle.GREEN) + "\u2713 No leak detected"
                        + AnsiStyle.style(c, AnsiStyle.RESET)
                        + String.format(" (R\u00b2=%.2f)", leak.confidencePercent() / 100.0));
            }
        }

        // Cause Breakdown
        if (!a.causeBreakdown().isEmpty()) {
            section(c, "GC Causes");
            String hdr = AnsiStyle.style(c, AnsiStyle.BOLD)
                    + RichRenderer.padRight("Cause", 35)
                    + RichRenderer.padLeft("Count", 8)
                    + RichRenderer.padLeft("Avg ms", 10)
                    + RichRenderer.padLeft("Max ms", 10)
                    + AnsiStyle.style(c, AnsiStyle.RESET);
            System.out.println(RichRenderer.boxLine("  " + hdr, WIDTH));
            System.out.println(RichRenderer.boxSeparator(WIDTH));

            for (var entry : a.causeBreakdown().values()) {
                boolean warn = entry.cause().toLowerCase().contains("humongous")
                        || entry.cause().toLowerCase().contains("full")
                        || entry.cause().toLowerCase().contains("metadata");
                String causeColor = warn ? AnsiStyle.style(c, AnsiStyle.YELLOW) : "";
                String line = causeColor
                        + RichRenderer.padRight(RichRenderer.truncate(entry.cause(), 33), 35)
                        + (warn ? AnsiStyle.style(c, AnsiStyle.RESET) : "")
                        + RichRenderer.padLeft(String.valueOf(entry.count()), 8)
                        + RichRenderer.padLeft(String.valueOf(entry.avgMs()), 10)
                        + RichRenderer.padLeft(String.valueOf(entry.maxMs()), 10);
                if (warn) line += " \u26a0";
                System.out.println(RichRenderer.boxLine("  " + line, WIDTH));
            }
        }

        // Tuning Recommendations
        if (!a.recommendations().isEmpty()) {
            section(c, "Tuning Recommendations");

            for (int i = 0; i < a.recommendations().size(); i++) {
                var rec = a.recommendations().get(i);
                String sevColor = switch (rec.severity()) {
                    case "CRITICAL" -> AnsiStyle.style(c, AnsiStyle.RED, AnsiStyle.BOLD);
                    case "WARNING" -> AnsiStyle.style(c, AnsiStyle.YELLOW, AnsiStyle.BOLD);
                    default -> AnsiStyle.style(c, AnsiStyle.CYAN);
                };

                System.out.println(RichRenderer.boxLine(
                        "  " + sevColor + (i + 1) + ". " + rec.problem()
                                + AnsiStyle.style(c, AnsiStyle.RESET), WIDTH));
                System.out.println(RichRenderer.boxLine(
                        "     \u2192 " + rec.suggestion(), WIDTH));
                if (!rec.flag().isEmpty()) {
                    System.out.println(RichRenderer.boxLine(
                            "     " + AnsiStyle.style(c, AnsiStyle.GREEN)
                                    + rec.flag() + AnsiStyle.style(c, AnsiStyle.RESET), WIDTH));
                }
                System.out.println(RichRenderer.emptyLine(WIDTH));
            }
        }

        // Phase Breakdown (only when --phases flag used and phase data available)
        if (!phaseEvents.isEmpty()) {
            GcPhaseAnalyzer.PhaseAnalysis phaseAnalysis = GcPhaseAnalyzer.analyze(phaseEvents);
            if (!phaseAnalysis.phases().isEmpty()) {
                printPhaseBreakdown(c, phaseAnalysis);
            }
        }

        System.out.println(RichRenderer.boxFooter(c,
                a.pauseEvents() + " pauses, " + String.format("%.1f%%", a.throughputPercent()) + " throughput", WIDTH));
    }

    private void printPhaseBreakdown(boolean c, GcPhaseAnalyzer.PhaseAnalysis analysis) {
        section(c, String.format("GC Pause Phase Breakdown (avg of %d GCs)", analysis.gcCount()));

        // Bar chart: max bar width = 20 chars for 100%
        int BAR_WIDTH = 20;
        for (GcPhaseAnalyzer.PhaseStat stat : analysis.phases()) {
            int barLen = (int) Math.round(stat.percentOfTotal() / 100.0 * BAR_WIDTH);
            String bar = AnsiStyle.style(c, AnsiStyle.CYAN)
                    + "\u2588".repeat(Math.max(0, barLen))
                    + AnsiStyle.style(c, AnsiStyle.RESET);
            String row = "  "
                    + RichRenderer.padRight(RichRenderer.truncate(stat.phase(), 22), 22)
                    + String.format("%6.1fms  ", stat.avgMs())
                    + RichRenderer.padRight(bar, BAR_WIDTH + 20)  // +20 for ANSI escape codes
                    + String.format("%3.0f%%", stat.percentOfTotal());
            System.out.println(RichRenderer.boxLine(row, WIDTH));
        }

        // Total row
        double totalAvg = analysis.phases().stream()
                .mapToDouble(GcPhaseAnalyzer.PhaseStat::avgMs).sum();
        System.out.println(RichRenderer.emptyLine(WIDTH));
        System.out.println(RichRenderer.boxLine(
                "  " + AnsiStyle.style(c, AnsiStyle.BOLD)
                + RichRenderer.padRight("Total", 22)
                + String.format("%6.1fms", totalAvg)
                + AnsiStyle.style(c, AnsiStyle.RESET)
                + RichRenderer.padLeft("100%", BAR_WIDTH + 25), WIDTH));
    }

    private void section(boolean c, String title) {
        System.out.println(RichRenderer.emptyLine(WIDTH));
        System.out.println(RichRenderer.boxSeparator(WIDTH));
        System.out.println(RichRenderer.boxLine(
                "  " + AnsiStyle.style(c, AnsiStyle.BOLD, AnsiStyle.CYAN) + title
                        + AnsiStyle.style(c, AnsiStyle.RESET), WIDTH));
        System.out.println(RichRenderer.emptyLine(WIDTH));
    }

    private void kv(boolean c, String key, String value) {
        System.out.println(RichRenderer.boxLine(
                "  " + RichRenderer.padRight(key, 18) + "  " + value, WIDTH));
    }

    private static String formatDuration(double sec) {
        if (sec < 60) return String.format("%.0f sec", sec);
        if (sec < 3600) return String.format("%.1f min", sec / 60);
        return String.format("%.1f hours", sec / 3600);
    }

    private static String sparkline(double[] values) {
        if (values == null || values.length == 0) return "";
        String bars = "\u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
        double min = Double.MAX_VALUE, max = 0;
        for (double v : values) {
            if (v < min) min = v;
            if (v > max) max = v;
        }
        StringBuilder sb = new StringBuilder();
        for (double v : values) {
            if (max == min) {
                sb.append(bars.charAt(0));
            } else {
                int idx = (int) ((v - min) / (max - min) * (bars.length() - 1));
                sb.append(bars.charAt(Math.max(0, Math.min(idx, bars.length() - 1))));
            }
        }
        return sb.toString();
    }

    private static String renderTrendChart(double[] points, double minKB, double maxKB,
                                           int width, boolean c) {
        if (points.length == 0) return "";
        int chartHeight = 5;
        int chartWidth = Math.min(points.length, width - 20);
        double range = maxKB - minKB;

        // Build rows top-to-bottom
        StringBuilder sb = new StringBuilder();
        for (int row = chartHeight - 1; row >= 0; row--) {
            String label = row == chartHeight - 1 ? RichRenderer.padLeft(RichRenderer.formatKB((long) maxKB), 8)
                         : row == 0              ? RichRenderer.padLeft(RichRenderer.formatKB((long) minKB), 8)
                         : "        ";
            StringBuilder line = new StringBuilder("  " + label + " ");
            for (int col = 0; col < chartWidth; col++) {
                int idx = col * points.length / chartWidth;
                double val = points[Math.min(idx, points.length - 1)];
                double normalized = range == 0 ? 0 : (val - minKB) / range * (chartHeight - 1);
                if (Math.abs(normalized - row) < 0.6) {
                    line.append(AnsiStyle.style(c, AnsiStyle.RED)).append('\u25cf')
                        .append(AnsiStyle.style(c, AnsiStyle.RESET));
                } else if (normalized > row) {
                    line.append(AnsiStyle.style(c, AnsiStyle.YELLOW)).append('\u2592')
                        .append(AnsiStyle.style(c, AnsiStyle.RESET));
                } else {
                    line.append(' ');
                }
            }
            sb.append(RichRenderer.boxLine(line.toString(), width)).append('\n');
        }
        return sb.toString();
    }

    private static void printJson(GcLogAnalysis a, Path file) {
        StringBuilder sb = new StringBuilder();
        sb.append("{\"file\":\"").append(RichRenderer.escapeJson(file.toString())).append('"');
        sb.append(",\"totalEvents\":").append(a.totalEvents());
        sb.append(",\"pauseEvents\":").append(a.pauseEvents());
        sb.append(",\"fullGcEvents\":").append(a.fullGcEvents());
        sb.append(",\"durationSec\":").append(String.format("%.1f", a.durationSec()));
        sb.append(",\"throughputPercent\":").append(String.format("%.1f", a.throughputPercent()));
        sb.append(",\"pauses\":{");
        sb.append("\"totalMs\":").append(a.totalPauseMs());
        sb.append(",\"maxMs\":").append(a.maxPauseMs());
        sb.append(",\"p50Ms\":").append(a.p50PauseMs());
        sb.append(",\"p95Ms\":").append(a.p95PauseMs());
        sb.append(",\"p99Ms\":").append(a.p99PauseMs());
        sb.append(",\"avgMs\":").append(a.avgPauseMs()).append('}');
        sb.append(",\"causes\":{");
        boolean first = true;
        for (var entry : a.causeBreakdown().values()) {
            if (!first) sb.append(',');
            sb.append('"').append(RichRenderer.escapeJson(entry.cause())).append("\":{");
            sb.append("\"count\":").append(entry.count());
            sb.append(",\"avgMs\":").append(entry.avgMs());
            sb.append(",\"maxMs\":").append(entry.maxMs()).append('}');
            first = false;
        }
        sb.append('}');
        sb.append(",\"recommendations\":[");
        for (int i = 0; i < a.recommendations().size(); i++) {
            var rec = a.recommendations().get(i);
            if (i > 0) sb.append(',');
            sb.append("{\"severity\":\"").append(rec.severity()).append('"');
            sb.append(",\"problem\":\"").append(RichRenderer.escapeJson(rec.problem())).append('"');
            sb.append(",\"flag\":\"").append(RichRenderer.escapeJson(rec.flag())).append("\"}");
        }
        sb.append(']');

        // Rate analysis
        GcRateAnalyzer.RateAnalysis rates = a.rateAnalysis();
        if (rates != null) {
            sb.append(",\"rateAnalysis\":{");
            sb.append("\"allocationRateKBPerSec\":").append(String.format("%.1f", rates.allocationRateKBPerSec()));
            sb.append(",\"peakAllocationRateKBPerSec\":").append(String.format("%.1f", rates.peakAllocationRateKBPerSec()));
            sb.append(",\"promotionRateKBPerSec\":").append(String.format("%.1f", rates.promotionRateKBPerSec()));
            sb.append(",\"peakPromotionRateKBPerSec\":").append(String.format("%.1f", rates.peakPromotionRateKBPerSec()));
            sb.append(",\"reclaimEfficiencyPercent\":").append(String.format("%.1f", rates.reclaimEfficiencyPercent()));
            sb.append(",\"promoAllocRatioPercent\":").append(String.format("%.1f", rates.promoAllocRatioPercent()));
            sb.append('}');
        }

        // Leak analysis
        GcLeakDetector.LeakAnalysis leak = a.leakAnalysis();
        if (leak != null) {
            sb.append(",\"leakAnalysis\":{");
            sb.append("\"leakDetected\":").append(leak.leakDetected());
            sb.append(",\"heapGrowthRateKBPerSec\":").append(String.format("%.3f", leak.heapGrowthRateKBPerSec()));
            sb.append(",\"estimatedOomSec\":").append(String.format("%.0f", leak.estimatedOomSec()));
            sb.append(",\"confidencePercent\":").append(String.format("%.1f", leak.confidencePercent()));
            sb.append(",\"pattern\":\"").append(leak.pattern()).append('"');
            sb.append(",\"staircaseSteps\":").append(leak.staircaseSteps());
            sb.append('}');
        }

        sb.append('}');
        System.out.println(sb);
    }
}