@deniscuciuc/redis-analyzer 1.0.0

package/dist/src/interactive/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interactive/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAKrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAUpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAYhD,qBAAa,cAAc;IAQzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAThC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAGvC,MAAM,EAAE,KAAK,EACb,UAAU,EAAE,eAAe,EAC3B,cAAc,EAAE,aAAa;IAKzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC5B,OAAO,CAAC,QAAQ;YAQF,YAAY;YA+BZ,gBAAgB;YAQhB,SAAS;YAyDT,WAAW;YAqCX,SAAS;YAgBT,YAAY;CAoC1B"}

package/dist/src/interactive/index.js

@@ -0,0 +1,236 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractiveCLI = void 0;
+const prompts_1 = require("@inquirer/prompts");
+const memory_analyzer_1 = require("../analyzers/memory-analyzer");
+const performance_analyzer_1 = require("../analyzers/performance-analyzer");
+const persistence_analyzer_1 = require("../analyzers/persistence-analyzer");
+const replication_analyzer_1 = require("../analyzers/replication-analyzer");
+const runner_1 = require("../cli/runner");
+const stats_collector_1 = require("../collectors/stats-collector");
+const constants_1 = require("../constants");
+const diff_reporter_1 = require("../reporters/diff-reporter");
+const report_generator_1 = require("../reporters/report-generator");
+const runner_2 = require("../watch/runner");
+const display = __importStar(require("./display"));
+const menus_1 = require("./menus");
+class InteractiveCLI {
+    client;
+    connection;
+    runtimeOptions;
+    collector;
+    memory = new memory_analyzer_1.MemoryAnalyzer();
+    performance = new performance_analyzer_1.PerformanceAnalyzer();
+    persistence = new persistence_analyzer_1.PersistenceAnalyzer();
+    replication = new replication_analyzer_1.ReplicationAnalyzer();
+    constructor(client, connection, runtimeOptions) {
+        this.client = client;
+        this.connection = connection;
+        this.runtimeOptions = runtimeOptions;
+        this.collector = new stats_collector_1.StatsCollector(client);
+    }
+    async start() {
+        console.clear();
+        console.log(`\n  Redis Analyzer — ${this.connection.host}:${this.connection.port}/${this.connection.db}\n`);
+        let running = true;
+        while (running) {
+            const action = await (0, prompts_1.select)({
+                message: "Main menu",
+                choices: menus_1.MAIN_MENU_CHOICES,
+            });
+            switch (action) {
+                case "analysis":
+                    await this.analysisMenu();
+                    break;
+                case "reports":
+                    await this.reportsMenu();
+                    break;
+                case "watch":
+                    await this.watchMenu();
+                    break;
+                case "settings":
+                    await this.settingsMenu();
+                    break;
+                case "exit":
+                    running = false;
+                    break;
+            }
+        }
+    }
+    reporter() {
+        return new report_generator_1.ReportGenerator(this.runtimeOptions.outputDir, {
+            outputDir: this.runtimeOptions.outputDir,
+            slowCommandThreshold: this.runtimeOptions.slowCommandThreshold,
+            maxSlowCommands: this.runtimeOptions.maxSlowCommands,
+        });
+    }
+    async analysisMenu() {
+        const choice = await (0, prompts_1.select)({
+            message: "Run analysis",
+            choices: menus_1.ANALYSIS_MENU_CHOICES,
+        });
+        switch (choice) {
+            case "full":
+                display.showFullReport(await (0, runner_1.buildFullReport)(this.client, this.runtimeOptions, this.connection));
+                break;
+            case "health":
+                display.showHealth(await (0, runner_1.buildFullReport)(this.client, this.runtimeOptions, this.connection));
+                break;
+            case "single":
+                await this.singleModuleMenu();
+                break;
+        }
+    }
+    async singleModuleMenu() {
+        const command = await (0, prompts_1.select)({
+            message: "Select command",
+            choices: menus_1.MODULE_CHOICES,
+        });
+        await this.runModule(command);
+    }
+    async runModule(command) {
+        const info = command === "slow-commands" ? undefined : await this.collector.getInfo();
+        switch (command) {
+            case "health":
+                display.showHealth(await (0, runner_1.buildFullReport)(this.client, this.runtimeOptions, this.connection));
+                break;
+            case "server-info":
+                display.showServerInfo(info);
+                break;
+            case "memory":
+                display.showMemory(this.memory.analyze(info));
+                break;
+            case "hit-rate":
+                display.showHitRate(this.performance.analyzeHitRate(info));
+                break;
+            case "slow-commands": {
+                const [commands, totalLogged] = await Promise.all([
+                    this.collector.getSlowLog(this.runtimeOptions.maxSlowCommands),
+                    this.collector.getSlowLogLength(),
+                ]);
+                display.showSlowCommands(this.performance.analyzeSlowCommands(commands, totalLogged, this.runtimeOptions.slowCommandThreshold));
+                break;
+            }
+            case "keys":
+                display.showKeyspaces((0, runner_1.summarizeKeyspaces)(info).keyspaces);
+                break;
+            case "connections":
+                display.showConnections(info);
+                break;
+            case "persistence":
+                display.showPersistence(this.persistence.analyze(info));
+                break;
+            case "replication":
+                display.showReplication(this.replication.analyze(info));
+                break;
+            case "config":
+                display.showConfig(await this.collector.getConfigValues(constants_1.IMPORTANT_CONFIG_KEYS));
+                break;
+        }
+    }
+    async reportsMenu() {
+        const choice = await (0, prompts_1.select)({
+            message: "Generate report",
+            choices: menus_1.REPORTS_MENU_CHOICES,
+        });
+        if (choice === "back") {
+            return;
+        }
+        const report = await (0, runner_1.buildFullReport)(this.client, this.runtimeOptions, this.connection);
+        const reporter = this.reporter();
+        if (choice === "markdown" || choice === "html") {
+            const markdown = await reporter.generateFullReport(report);
+            const json = await reporter.generateJsonReport(report);
+            console.log(`  ✅ Markdown: ${markdown}`);
+            console.log(`  ✅ JSON:     ${json}`);
+            if (choice === "html") {
+                const html = await reporter.generateHtmlReport(report);
+                console.log(`  ✅ HTML:     ${html}`);
+            }
+        }
+        if (choice === "diff") {
+            const previousPath = await (0, prompts_1.input)({
+                message: "Path to previous JSON report:",
+            });
+            diff_reporter_1.DiffReporter.print(diff_reporter_1.DiffReporter.diff(report, (0, runner_1.loadPreviousReport)(previousPath)));
+        }
+    }
+    async watchMenu() {
+        const command = await (0, prompts_1.select)({
+            message: "Select watch command",
+            choices: menus_1.WATCH_COMMAND_CHOICES,
+        });
+        const interval = await (0, prompts_1.input)({
+            message: "Watch interval in seconds",
+            default: String(this.runtimeOptions.watch ?? 30),
+        });
+        await (0, runner_2.runWatchLoop)({
+            intervalSeconds: Number.parseInt(interval, 10),
+            command,
+            runCommand: () => this.runModule(command),
+        });
+    }
+    async settingsMenu() {
+        const choice = await (0, prompts_1.select)({
+            message: "Settings",
+            choices: menus_1.SETTINGS_MENU_CHOICES,
+        });
+        switch (choice) {
+            case "show":
+                console.log(this.runtimeOptions);
+                break;
+            case "output":
+                this.runtimeOptions.outputDir = await (0, prompts_1.input)({
+                    message: "Output directory",
+                    default: this.runtimeOptions.outputDir,
+                });
+                break;
+            case "slow-threshold":
+                this.runtimeOptions.slowCommandThreshold = Number.parseInt(await (0, prompts_1.input)({
+                    message: "Slow command threshold in microseconds",
+                    default: String(this.runtimeOptions.slowCommandThreshold),
+                }), 10);
+                break;
+            case "max-slow":
+                this.runtimeOptions.maxSlowCommands = Number.parseInt(await (0, prompts_1.input)({
+                    message: "Max slow commands to fetch",
+                    default: String(this.runtimeOptions.maxSlowCommands),
+                }), 10);
+                break;
+        }
+    }
+}
+exports.InteractiveCLI = InteractiveCLI;

package/dist/src/interactive/menus.d.ts

@@ -0,0 +1,25 @@
+export declare const MAIN_MENU_CHOICES: {
+    name: string;
+    value: string;
+}[];
+export declare const ANALYSIS_MENU_CHOICES: {
+    name: string;
+    value: string;
+}[];
+export declare const MODULE_CHOICES: {
+    name: string;
+    value: string;
+}[];
+export declare const REPORTS_MENU_CHOICES: {
+    name: string;
+    value: string;
+}[];
+export declare const SETTINGS_MENU_CHOICES: {
+    name: string;
+    value: string;
+}[];
+export declare const WATCH_COMMAND_CHOICES: {
+    name: string;
+    value: string;
+}[];
+//# sourceMappingURL=menus.d.ts.map

package/dist/src/interactive/menus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menus.d.ts","sourceRoot":"","sources":["../../../src/interactive/menus.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;GAM7B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;GAKjC,CAAC;AAEF,eAAO,MAAM,cAAc;;;GAW1B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;GAKhC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;GAMjC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;GAOjC,CAAC"}

package/dist/src/interactive/menus.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WATCH_COMMAND_CHOICES = exports.SETTINGS_MENU_CHOICES = exports.REPORTS_MENU_CHOICES = exports.MODULE_CHOICES = exports.ANALYSIS_MENU_CHOICES = exports.MAIN_MENU_CHOICES = void 0;
+exports.MAIN_MENU_CHOICES = [
+    { name: "Run analysis", value: "analysis" },
+    { name: "Generate reports", value: "reports" },
+    { name: "Watch mode", value: "watch" },
+    { name: "Settings", value: "settings" },
+    { name: "Exit", value: "exit" },
+];
+exports.ANALYSIS_MENU_CHOICES = [
+    { name: "Full analysis", value: "full" },
+    { name: "Health", value: "health" },
+    { name: "Single command", value: "single" },
+    { name: "Back", value: "back" },
+];
+exports.MODULE_CHOICES = [
+    { name: "Health", value: "health" },
+    { name: "Server info", value: "server-info" },
+    { name: "Memory", value: "memory" },
+    { name: "Hit rate", value: "hit-rate" },
+    { name: "Slow commands", value: "slow-commands" },
+    { name: "Keys", value: "keys" },
+    { name: "Connections", value: "connections" },
+    { name: "Persistence", value: "persistence" },
+    { name: "Replication", value: "replication" },
+    { name: "Config", value: "config" },
+];
+exports.REPORTS_MENU_CHOICES = [
+    { name: "Markdown + JSON", value: "markdown" },
+    { name: "Markdown + JSON + HTML", value: "html" },
+    { name: "Diff against previous JSON report", value: "diff" },
+    { name: "Back", value: "back" },
+];
+exports.SETTINGS_MENU_CHOICES = [
+    { name: "Show current settings", value: "show" },
+    { name: "Change output directory", value: "output" },
+    { name: "Change slow command threshold", value: "slow-threshold" },
+    { name: "Change max slow commands", value: "max-slow" },
+    { name: "Back", value: "back" },
+];
+exports.WATCH_COMMAND_CHOICES = [
+    { name: "Health", value: "health" },
+    { name: "Connections", value: "connections" },
+    { name: "Hit rate", value: "hit-rate" },
+    { name: "Slow commands", value: "slow-commands" },
+    { name: "Keys", value: "keys" },
+    { name: "Replication", value: "replication" },
+];

package/dist/src/reporters/diff-reporter.d.ts

@@ -0,0 +1,21 @@
+import type { FullReport } from "../types";
+export interface MetricDiff {
+    label: string;
+    before: number | string;
+    after: number | string;
+    delta?: number;
+    trend: "better" | "worse" | "neutral" | "unchanged";
+}
+export interface ReportDiff {
+    currentAt: string;
+    previousAt: string;
+    timeDelta: string;
+    metrics: MetricDiff[];
+    newIssues: string[];
+    resolvedIssues: string[];
+}
+export declare const DiffReporter: {
+    diff(current: FullReport, previous: FullReport): ReportDiff;
+    print(diff: ReportDiff, write?: (message?: unknown, ...optionalParams: unknown[]) => void): void;
+};
+//# sourceMappingURL=diff-reporter.d.ts.map

package/dist/src/reporters/diff-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-reporter.d.ts","sourceRoot":"","sources":["../../../src/reporters/diff-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;CACpD;AAED,MAAM,WAAW,UAAU;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,eAAO,MAAM,YAAY;kBACV,UAAU,YAAY,UAAU,GAAG,UAAU;gBA8DpD,UAAU,UACT,CACN,OAAO,CAAC,EAAE,OAAO,EACjB,GAAG,cAAc,EAAE,OAAO,EAAE,KACxB,IAAI,GACP,IAAI;CA2BP,CAAC"}

package/dist/src/reporters/diff-reporter.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiffReporter = void 0;
+const format_1 = require("../utils/format");
+exports.DiffReporter = {
+    diff(current, previous) {
+        const currentIssues = collectIssues(current);
+        const previousIssues = collectIssues(previous);
+        return {
+            currentAt: toIsoString(current.generatedAt),
+            previousAt: toIsoString(previous.generatedAt),
+            timeDelta: describeTimeDelta(previous.generatedAt, current.generatedAt),
+            metrics: [
+                createMetricDiff("Health score", previous.healthScore, current.healthScore, "higher"),
+                createMetricDiff("Hit rate", previous.hitRate.hitRate, current.hitRate.hitRate, "higher"),
+                createMetricDiff("Used memory", previous.memory.usedMemory, current.memory.usedMemory, "lower"),
+                createMetricDiff("Slow commands", previous.slowCommands.totalLogged, current.slowCommands.totalLogged, "lower"),
+                createMetricDiff("Ops / sec", previous.metrics.opsPerSec, current.metrics.opsPerSec, "neutral"),
+                createMetricDiff("Connected clients", previous.metrics.connectedClients, current.metrics.connectedClients, "neutral"),
+                createMetricDiff("Rejected connections", previous.metrics.rejectedConnections, current.metrics.rejectedConnections, "lower"),
+            ],
+            newIssues: currentIssues.filter((issue) => !previousIssues.includes(issue)),
+            resolvedIssues: previousIssues.filter((issue) => !currentIssues.includes(issue)),
+        };
+    },
+    print(diff, write = console.log) {
+        write(`\nReport diff (${diff.previousAt} → ${diff.currentAt}, ${diff.timeDelta})`);
+        for (const metric of diff.metrics) {
+            const arrow = metric.trend === "better" ? "⬆️" : metric.trend === "worse" ? "⬇️" : "↔️";
+            const delta = metric.delta === undefined || metric.delta === 0
+                ? ""
+                : ` (${metric.delta > 0 ? "+" : ""}${formatValue(metric.label, metric.delta)})`;
+            write(`${arrow}  ${metric.label.padEnd(20)} ${formatValue(metric.label, metric.before)} → ${formatValue(metric.label, metric.after)}${delta}`);
+        }
+        if (diff.newIssues.length > 0) {
+            write(`⚠️  New issues (${diff.newIssues.length}): ${diff.newIssues.join(", ")}`);
+        }
+        if (diff.resolvedIssues.length > 0) {
+            write(`✓  Resolved (${diff.resolvedIssues.length}): ${diff.resolvedIssues.join(", ")}`);
+        }
+    },
+};
+function createMetricDiff(label, before, after, direction) {
+    const delta = Math.round((after - before) * 100) / 100;
+    if (delta === 0) {
+        return { label, before, after, delta: 0, trend: "unchanged" };
+    }
+    if (direction === "neutral") {
+        return { label, before, after, delta, trend: "neutral" };
+    }
+    const improved = (direction === "higher" && delta > 0) ||
+        (direction === "lower" && delta < 0);
+    return { label, before, after, delta, trend: improved ? "better" : "worse" };
+}
+function collectIssues(report) {
+    const issues = report.recommendations.map((item) => `${item.priority}:${item.category}:${item.message}`);
+    if (report.memory.fragSeverity !== "ok") {
+        issues.push(`fragmentation:${report.memory.fragSeverity}`);
+    }
+    if (report.persistence.severity !== "ok") {
+        issues.push(`persistence:${report.persistence.severity}`);
+    }
+    if (report.replication.severity !== "ok") {
+        issues.push(`replication:${report.replication.severity}`);
+    }
+    return issues;
+}
+function describeTimeDelta(previousAt, currentAt) {
+    const previous = new Date(previousAt);
+    const current = new Date(currentAt);
+    const minutes = Math.max(1, Math.round((current.getTime() - previous.getTime()) / 60000));
+    if (minutes < 60) {
+        return `${minutes} minute${minutes === 1 ? "" : "s"} apart`;
+    }
+    const hours = Math.round(minutes / 60);
+    if (hours < 48) {
+        return `${hours} hour${hours === 1 ? "" : "s"} apart`;
+    }
+    const days = Math.round(hours / 24);
+    return `${days} day${days === 1 ? "" : "s"} apart`;
+}
+function toIsoString(value) {
+    return new Date(value).toISOString();
+}
+function formatValue(label, value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (label === "Used memory") {
+        return (0, format_1.formatBytes)(value);
+    }
+    if (label === "Hit rate") {
+        return (0, format_1.formatPercent)(value);
+    }
+    return Number.isInteger(value) ? value.toString() : value.toFixed(2);
+}

package/dist/src/reporters/html-reporter.d.ts

@@ -0,0 +1,9 @@
+import type { FullRedisReport } from "../types";
+export declare class HtmlReporter {
+    static generate(report: FullRedisReport): string;
+    private static summaryCard;
+    private static table;
+    private static healthClass;
+    private static escape;
+}
+//# sourceMappingURL=html-reporter.d.ts.map

package/dist/src/reporters/html-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-reporter.d.ts","sourceRoot":"","sources":["../../../src/reporters/html-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAShD,qBAAa,YAAY;IACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;IAuHhD,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B,OAAO,CAAC,MAAM,CAAC,KAAK;IAQpB,OAAO,CAAC,MAAM,CAAC,WAAW;IAU1B,OAAO,CAAC,MAAM,CAAC,MAAM;CAQrB"}

package/dist/src/reporters/html-reporter.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlReporter = void 0;
+const format_1 = require("../utils/format");
+// biome-ignore lint/complexity/noStaticOnlyClass: grouped HTML helpers keep the template readable.
+class HtmlReporter {
+    static generate(report) {
+        return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Redis Analysis Report</title>
+    <style>
+      :root {
+        --bg: #0f172a;
+        --surface: #111827;
+        --surface-alt: #1f2937;
+        --text: #e5e7eb;
+        --muted: #94a3b8;
+        --border: #334155;
+        --good: #22c55e;
+        --warn: #f59e0b;
+        --bad: #ef4444;
+      }
+      body { margin: 0; font-family: Inter, system-ui, sans-serif; background: var(--bg); color: var(--text); }
+      main { width: min(1180px, calc(100% - 2rem)); margin: 0 auto; padding: 2rem 0 3rem; }
+      h1, h2, h3 { margin: 0 0 0.75rem; }
+      .card, section { background: var(--surface); border: 1px solid var(--border); border-radius: 1rem; padding: 1.25rem; }
+      .grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); margin: 1.25rem 0; }
+      .muted { color: var(--muted); }
+      table { width: 100%; border-collapse: collapse; margin-top: 0.75rem; }
+      th, td { border-bottom: 1px solid var(--border); text-align: left; padding: 0.65rem 0.5rem; vertical-align: top; }
+      th { color: var(--muted); font-weight: 600; }
+      code { background: var(--surface-alt); border-radius: 0.4rem; padding: 0.1rem 0.35rem; }
+      .pill { display: inline-block; border-radius: 999px; padding: 0.2rem 0.65rem; font-weight: 700; }
+      .good { background: rgba(34, 197, 94, 0.15); color: #86efac; }
+      .warn { background: rgba(245, 158, 11, 0.15); color: #fcd34d; }
+      .bad { background: rgba(239, 68, 68, 0.15); color: #fca5a5; }
+      section + section { margin-top: 1rem; }
+      ul { padding-left: 1.25rem; }
+    </style>
+  </head>
+  <body>
+    <main>
+      <div class="card">
+        <p class="muted">${HtmlReporter.escape(`${report.host}:${report.port}/${report.db}`)} · ${HtmlReporter.escape(report.generatedAt.toISOString())}</p>
+        <h1>Redis Analysis Report</h1>
+        <span class="pill ${HtmlReporter.healthClass(report.healthScore)}">Health score: ${report.healthScore}/100</span>
+        <div class="grid">
+          ${HtmlReporter.summaryCard("Used Memory", report.memory.usedMemoryHuman)}
+          ${HtmlReporter.summaryCard("Hit Rate", (0, format_1.formatPercent)(report.hitRate.hitRate))}
+          ${HtmlReporter.summaryCard("Ops / sec", (0, format_1.formatNumber)(report.metrics.opsPerSec))}
+          ${HtmlReporter.summaryCard("Total Keys", (0, format_1.formatNumber)(report.metrics.totalKeyCount))}
+          ${HtmlReporter.summaryCard("Connected Clients", (0, format_1.formatNumber)(report.metrics.connectedClients))}
+          ${HtmlReporter.summaryCard("Slow Commands", (0, format_1.formatNumber)(report.slowCommands.totalLogged))}
+        </div>
+      </div>
+
+      <section>
+        <h2>Recommendations</h2>
+        <ul>
+          ${report.recommendations.map((item) => `<li><strong>${HtmlReporter.escape(item.priority)}</strong> <code>${HtmlReporter.escape(item.category)}</code> — ${HtmlReporter.escape(item.message)}</li>`).join("") || "<li>No recommendations</li>"}
+        </ul>
+      </section>
+
+      <section>
+        <h2>Memory</h2>
+        ${HtmlReporter.table(["Metric", "Value"], [
+            ["Used Memory", report.memory.usedMemoryHuman],
+            ["Max Memory", report.memory.maxMemoryHuman || "unlimited"],
+            ["Usage Percent", (0, format_1.formatPercent)(report.memory.usagePercent)],
+            ["Fragmentation Ratio", report.memory.fragRatio.toFixed(2)],
+            ["Fragmentation Waste", (0, format_1.formatBytes)(report.memory.fragBytes)],
+            ["RSS Overhead", (0, format_1.formatBytes)(report.memory.rssOverhead)],
+        ])}
+      </section>
+
+      <section>
+        <h2>Cache & Persistence</h2>
+        ${HtmlReporter.table(["Metric", "Value"], [
+            ["Hit Rate", (0, format_1.formatPercent)(report.hitRate.hitRate)],
+            ["Evicted Keys", (0, format_1.formatNumber)(report.hitRate.evictedKeys)],
+            ["Expired Keys", (0, format_1.formatNumber)(report.hitRate.expiredKeys)],
+            ["RDB Status", report.persistence.rdb.lastStatus],
+            ["AOF Enabled", report.persistence.aof.enabled ? "yes" : "no"],
+            ["AOF Status", report.persistence.aof.lastStatus],
+        ])}
+      </section>
+
+      <section>
+        <h2>Slow Commands</h2>
+        ${HtmlReporter.table(["Command", "Count", "Avg Duration"], report.slowCommands.topCommandTypes.map((item) => [
+            item.command,
+            (0, format_1.formatNumber)(item.count),
+            (0, format_1.formatDuration)(item.avgMs),
+        ]))}
+      </section>
+
+      <section>
+        <h2>Keyspaces</h2>
+        ${HtmlReporter.table(["DB", "Keys", "Expiring Keys", "Avg TTL"], report.keyspaces.map((keyspace) => [
+            `db${keyspace.db}`,
+            (0, format_1.formatNumber)(keyspace.keys),
+            (0, format_1.formatNumber)(keyspace.expires),
+            (0, format_1.formatDuration)(keyspace.avgTtl),
+        ]))}
+      </section>
+    </main>
+  </body>
+</html>`;
+    }
+    static summaryCard(label, value) {
+        return `<div class="card"><h3>${HtmlReporter.escape(label)}</h3><p>${HtmlReporter.escape(value)}</p></div>`;
+    }
+    static table(headers, rows) {
+        if (rows.length === 0) {
+            return '<p class="muted">No data available.</p>';
+        }
+        return `<table><thead><tr>${headers.map((header) => `<th>${HtmlReporter.escape(header)}</th>`).join("")}</tr></thead><tbody>${rows.map((row) => `<tr>${row.map((cell) => `<td>${HtmlReporter.escape(cell)}</td>`).join("")}</tr>`).join("")}</tbody></table>`;
+    }
+    static healthClass(score) {
+        if (score >= 90) {
+            return "good";
+        }
+        if (score >= 70) {
+            return "warn";
+        }
+        return "bad";
+    }
+    static escape(value) {
+        return value
+            .replaceAll("&", "&amp;")
+            .replaceAll("<", "&lt;")
+            .replaceAll(">", "&gt;")
+            .replaceAll('"', "&quot;")
+            .replaceAll("'", "&#39;");
+    }
+}
+exports.HtmlReporter = HtmlReporter;

package/dist/src/reporters/report-generator.d.ts

@@ -0,0 +1,23 @@
+import type { AnalyzerOptions, FullRedisReport } from "../types";
+export declare class ReportGenerator {
+    private readonly outputDir;
+    constructor(outputDir?: string, _options?: AnalyzerOptions);
+    generateFullReport(report: FullRedisReport, timestamp?: string): Promise<string>;
+    generateJsonReport(report: FullRedisReport, timestamp?: string): Promise<string>;
+    generateHtmlReport(report: FullRedisReport, timestamp?: string): Promise<string>;
+    printSummary(report: FullRedisReport): void;
+    private ensureOutputDir;
+    private buildMarkdownReport;
+    private buildHeader;
+    private buildExecutiveSummary;
+    private buildMetricsSection;
+    private buildMemorySection;
+    private buildHitRateSection;
+    private buildPersistenceSection;
+    private buildReplicationSection;
+    private buildSlowCommandsSection;
+    private buildKeyspacesSection;
+    private buildConfigSection;
+    private buildRecommendationsSection;
+}
+//# sourceMappingURL=report-generator.d.ts.map

package/dist/src/reporters/report-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-generator.d.ts","sourceRoot":"","sources":["../../../src/reporters/report-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,eAAe,EACf,eAAe,EAGf,MAAM,UAAU,CAAC;AAgBlB,qBAAa,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,GAAE,MAAoB,EAChD,QAAQ,GAAE,eAAoB;IAKzB,kBAAkB,CACvB,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAQZ,kBAAkB,CACvB,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAQZ,kBAAkB,CACvB,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAQlB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;YAiB7B,eAAe;IAM7B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,qBAAqB;IAqB7B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,2BAA2B;CAUnC"}