@poolzin/pool-bot 2026.3.9 → 2026.3.11

package/dist/cli/telemetry-cli/register.telemetry-metrics.js

@@ -0,0 +1,323 @@
+import { danger } from "../../globals.js";
+import { defaultRuntime } from "../../runtime.js";
+import { colorize, isRich, theme } from "../../terminal/theme.js";
+import { addGatewayClientOptions, callGatewayFromCli } from "../gateway-rpc.js";
+import { renderTable } from "../../terminal/table.js";
+// Sparkline characters for visual history
+const SPARK_CHARS = ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"];
+// Print metrics dashboard header
+function printDashboardHeader(runtime = defaultRuntime) {
+    const rich = isRich();
+    const now = new Date();
+    const timestamp = now.toLocaleString();
+    runtime.log("");
+    if (rich) {
+        runtime.log(colorize(rich, theme.heading, "╔═══════════════════════════════════════════════════════════╗"));
+        runtime.log(colorize(rich, theme.heading, `║  📈 TELEMETRY METRICS                           ${timestamp.padStart(26)} ║`));
+        runtime.log(colorize(rich, theme.heading, "╚═══════════════════════════════════════════════════════════╝"));
+    }
+    else {
+        runtime.log("═══════════════════════════════════════════════════════════");
+        runtime.log(`TELEMETRY METRICS - ${timestamp}`);
+        runtime.log("═══════════════════════════════════════════════════════════");
+    }
+    runtime.log("");
+}
+// Generate sparkline from value (normalized 0-1)
+function generateSparkline(value, rich) {
+    const normalized = Math.max(0, Math.min(1, value));
+    const index = Math.floor(normalized * (SPARK_CHARS.length - 1));
+    const char = SPARK_CHARS[index];
+    if (!rich)
+        return char;
+    if (normalized > 0.7)
+        return colorize(rich, theme.success, char);
+    if (normalized > 0.4)
+        return colorize(rich, theme.warn, char);
+    return colorize(rich, theme.error, char);
+}
+// Format number with commas
+function formatNumber(num) {
+    return num.toLocaleString();
+}
+// Format duration in ms
+function formatDuration(ms) {
+    if (ms < 1)
+        return `${(ms * 1000).toFixed(2)}μs`;
+    if (ms < 1000)
+        return `${ms.toFixed(1)}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${(ms / 60000).toFixed(1)}m`;
+}
+// Print counters table
+function printCountersTable(counters, runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log(rich ? colorize(rich, theme.heading, "  Counters") : "  Counters");
+    const entries = Object.entries(counters).sort((a, b) => b[1] - a[1]);
+    if (entries.length === 0) {
+        runtime.log(rich
+            ? colorize(rich, theme.muted, "    No counter metrics available.")
+            : "    No counter metrics available.");
+        runtime.log("");
+        return;
+    }
+    const maxValue = Math.max(...entries.map(([, v]) => v));
+    const columns = [
+        {
+            key: "name",
+            header: rich ? colorize(rich, theme.heading, "Name") : "Name",
+            align: "left",
+            minWidth: 30,
+            flex: true,
+        },
+        {
+            key: "value",
+            header: rich ? colorize(rich, theme.heading, "Value") : "Value",
+            align: "right",
+            minWidth: 12,
+        },
+        {
+            key: "visual",
+            header: rich ? colorize(rich, theme.heading, "") : "",
+            align: "left",
+            minWidth: 10,
+            maxWidth: 15,
+        },
+    ];
+    const rows = entries.map(([name, value]) => {
+        const normalized = maxValue > 0 ? value / maxValue : 0;
+        const barLength = Math.max(1, Math.floor(normalized * 10));
+        const bar = "█".repeat(barLength);
+        return {
+            name: rich ? colorize(rich, theme.info, name) : name,
+            value: rich ? colorize(rich, theme.accent, formatNumber(value)) : formatNumber(value),
+            visual: rich ? colorize(rich, theme.success, bar) : bar,
+        };
+    });
+    const table = renderTable({
+        columns,
+        rows,
+        border: rich ? "unicode" : "ascii",
+        padding: 1,
+    });
+    runtime.log(table);
+    runtime.log("");
+}
+// Print histograms table
+function printHistogramsTable(histograms, runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log(rich ? colorize(rich, theme.heading, "  Histograms (Durations)") : "  Histograms (Durations)");
+    const entries = Object.entries(histograms).sort((a, b) => b[1].count - a[1].count);
+    if (entries.length === 0) {
+        runtime.log(rich
+            ? colorize(rich, theme.muted, "    No histogram metrics available.")
+            : "    No histogram metrics available.");
+        runtime.log("");
+        return;
+    }
+    const columns = [
+        {
+            key: "name",
+            header: rich ? colorize(rich, theme.heading, "Name") : "Name",
+            align: "left",
+            minWidth: 25,
+            flex: true,
+        },
+        {
+            key: "count",
+            header: rich ? colorize(rich, theme.heading, "Count") : "Count",
+            align: "right",
+            minWidth: 8,
+        },
+        {
+            key: "avg",
+            header: rich ? colorize(rich, theme.heading, "Avg") : "Avg",
+            align: "right",
+            minWidth: 10,
+        },
+        {
+            key: "min",
+            header: rich ? colorize(rich, theme.heading, "Min") : "Min",
+            align: "right",
+            minWidth: 10,
+        },
+        {
+            key: "max",
+            header: rich ? colorize(rich, theme.heading, "Max") : "Max",
+            align: "right",
+            minWidth: 10,
+        },
+        {
+            key: "p95",
+            header: rich ? colorize(rich, theme.heading, "P95*") : "P95*",
+            align: "right",
+            minWidth: 10,
+        },
+    ];
+    const rows = entries.map(([name, stats]) => {
+        // Estimate P95 as max * 0.9 (rough approximation)
+        const p95 = stats.max * 0.9;
+        return {
+            name: rich ? colorize(rich, theme.info, name) : name,
+            count: rich
+                ? colorize(rich, theme.accent, formatNumber(stats.count))
+                : formatNumber(stats.count),
+            avg: formatDuration(stats.avg),
+            min: formatDuration(stats.min),
+            max: formatDuration(stats.max),
+            p95: formatDuration(p95),
+        };
+    });
+    const table = renderTable({
+        columns,
+        rows,
+        border: rich ? "unicode" : "ascii",
+        padding: 1,
+    });
+    runtime.log(table);
+    if (rich) {
+        runtime.log(colorize(rich, theme.muted, "    * P95 is estimated from max value"));
+    }
+    else {
+        runtime.log("    * P95 is estimated from max value");
+    }
+    runtime.log("");
+}
+// Print gauges table
+function printGaugesTable(gauges, runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log(rich ? colorize(rich, theme.heading, "  Gauges (Current Values)") : "  Gauges (Current Values)");
+    const entries = Object.entries(gauges).sort((a, b) => b[1] - a[1]);
+    if (entries.length === 0) {
+        runtime.log(rich
+            ? colorize(rich, theme.muted, "    No gauge metrics available.")
+            : "    No gauge metrics available.");
+        runtime.log("");
+        return;
+    }
+    const maxValue = Math.max(...entries.map(([, v]) => Math.abs(v)), 1);
+    const columns = [
+        {
+            key: "name",
+            header: rich ? colorize(rich, theme.heading, "Name") : "Name",
+            align: "left",
+            minWidth: 30,
+            flex: true,
+        },
+        {
+            key: "value",
+            header: rich ? colorize(rich, theme.heading, "Value") : "Value",
+            align: "right",
+            minWidth: 12,
+        },
+        {
+            key: "indicator",
+            header: rich ? colorize(rich, theme.heading, "") : "",
+            align: "center",
+            minWidth: 3,
+        },
+    ];
+    const rows = entries.map(([name, value]) => {
+        const normalized = Math.abs(value) / maxValue;
+        const indicator = generateSparkline(normalized, rich);
+        let coloredValue;
+        if (rich) {
+            if (value > 0) {
+                coloredValue = colorize(rich, theme.success, formatNumber(value));
+            }
+            else if (value < 0) {
+                coloredValue = colorize(rich, theme.error, formatNumber(value));
+            }
+            else {
+                coloredValue = colorize(rich, theme.muted, formatNumber(value));
+            }
+        }
+        else {
+            coloredValue = formatNumber(value);
+        }
+        return {
+            name: rich ? colorize(rich, theme.info, name) : name,
+            value: coloredValue,
+            indicator,
+        };
+    });
+    const table = renderTable({
+        columns,
+        rows,
+        border: rich ? "unicode" : "ascii",
+        padding: 1,
+    });
+    runtime.log(table);
+    runtime.log("");
+}
+// Print summary stats
+function printSummaryStats(counters, histograms, gauges, runtime = defaultRuntime) {
+    const rich = isRich();
+    const totalCounterValue = Object.values(counters).reduce((a, b) => a + b, 0);
+    const totalHistogramCount = Object.values(histograms).reduce((a, b) => a + b.count, 0);
+    const avgGaugeValue = Object.values(gauges).length > 0
+        ? Object.values(gauges).reduce((a, b) => a + b, 0) / Object.values(gauges).length
+        : 0;
+    if (rich) {
+        const stats = [
+            `${colorize(rich, theme.info, "Counters:")} ${Object.keys(counters).length} (${formatNumber(totalCounterValue)} total)`,
+            `${colorize(rich, theme.accent, "Histograms:")} ${Object.keys(histograms).length} (${formatNumber(totalHistogramCount)} samples)`,
+            `${colorize(rich, theme.success, "Gauges:")} ${Object.keys(gauges).length} (avg: ${avgGaugeValue.toFixed(2)})`,
+        ].join("  │  ");
+        runtime.log(`  ${stats}`);
+    }
+    else {
+        runtime.log(`  Counters: ${Object.keys(counters).length} (${formatNumber(totalCounterValue)} total) | Histograms: ${Object.keys(histograms).length} (${formatNumber(totalHistogramCount)} samples) | Gauges: ${Object.keys(gauges).length} (avg: ${avgGaugeValue.toFixed(2)})`);
+    }
+    runtime.log("");
+}
+// Print footer
+function printFooter(runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log("");
+    if (rich) {
+        runtime.log(colorize(rich, theme.muted, "  Commands: poolbot telemetry status | poolbot telemetry export"));
+    }
+    else {
+        runtime.log("  Commands: poolbot telemetry status | poolbot telemetry export");
+    }
+    runtime.log("");
+}
+export function registerTelemetryMetricsCommand(telemetry) {
+    addGatewayClientOptions(telemetry
+        .command("metrics")
+        .alias("m")
+        .description("Display telemetry metrics dashboard")
+        .option("--json", "Output JSON (disables visual dashboard)", false)
+        .option("--type <type>", "Filter by metric type (counter|histogram|gauge)", "all")
+        .action(async (opts) => {
+        try {
+            const res = await callGatewayFromCli("telemetry.metrics", opts, {
+                type: opts.type,
+            });
+            if (opts.json) {
+                defaultRuntime.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            const data = res;
+            printDashboardHeader();
+            printSummaryStats(data.counters, data.histograms, data.gauges);
+            const typeFilter = opts.type;
+            if (typeFilter === "all" || typeFilter === "counter") {
+                printCountersTable(data.counters);
+            }
+            if (typeFilter === "all" || typeFilter === "histogram") {
+                printHistogramsTable(data.histograms);
+            }
+            if (typeFilter === "all" || typeFilter === "gauge") {
+                printGaugesTable(data.gauges);
+            }
+            printFooter();
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    }));
+}

package/dist/cli/telemetry-cli/register.telemetry-status.js

@@ -0,0 +1,179 @@
+import { danger } from "../../globals.js";
+import { defaultRuntime } from "../../runtime.js";
+import { colorize, isRich, theme } from "../../terminal/theme.js";
+import { addGatewayClientOptions, callGatewayFromCli } from "../gateway-rpc.js";
+// Status icons
+const STATUS_ICONS = {
+    enabled: "●",
+    disabled: "○",
+    connected: "✓",
+    disconnected: "✗",
+    warning: "⚠",
+};
+// Print telemetry status header
+function printStatusHeader(runtime = defaultRuntime) {
+    const rich = isRich();
+    const now = new Date();
+    const timestamp = now.toLocaleString();
+    runtime.log("");
+    if (rich) {
+        runtime.log(colorize(rich, theme.heading, "╔═══════════════════════════════════════════════════════════╗"));
+        runtime.log(colorize(rich, theme.heading, `║  📊 TELEMETRY STATUS                            ${timestamp.padStart(26)} ║`));
+        runtime.log(colorize(rich, theme.heading, "╚═══════════════════════════════════════════════════════════╝"));
+    }
+    else {
+        runtime.log("═══════════════════════════════════════════════════════════");
+        runtime.log(`TELEMETRY STATUS - ${timestamp}`);
+        runtime.log("═══════════════════════════════════════════════════════════");
+    }
+    runtime.log("");
+}
+// Format exporter type with icon
+function formatExporterType(type, rich) {
+    if (!rich)
+        return type;
+    switch (type) {
+        case "console":
+            return `${colorize(rich, theme.info, "🖥️")} console`;
+        case "memory":
+            return `${colorize(rich, theme.accent, "💾")} memory`;
+        case "otlp":
+            return `${colorize(rich, theme.success, "🌐")} otlp`;
+        case "none":
+            return `${colorize(rich, theme.muted, "⛔")} none`;
+        default:
+            return type;
+    }
+}
+// Format enabled status
+function formatEnabled(enabled, rich) {
+    if (!rich)
+        return enabled ? "enabled" : "disabled";
+    if (enabled) {
+        return `${colorize(rich, theme.success, STATUS_ICONS.enabled)} enabled`;
+    }
+    return `${colorize(rich, theme.muted, STATUS_ICONS.disabled)} disabled`;
+}
+// Print configuration section
+function printConfiguration(config, runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log(rich ? colorize(rich, theme.heading, "  Configuration") : "  Configuration");
+    runtime.log(rich
+        ? colorize(rich, theme.muted, "  ─────────────────────────────────────────────────────────")
+        : "  ─────────────────────────────────────────────────────────");
+    const rows = [
+        { label: "Enabled", value: formatEnabled(config.enabled, rich) },
+        { label: "Service Name", value: config.serviceName },
+        { label: "Service Version", value: config.serviceVersion },
+    ];
+    // Tracing config
+    rows.push({ label: "Tracing", value: formatEnabled(config.tracing.enabled, rich) }, { label: "  Exporter", value: formatExporterType(config.tracing.exporter, rich) }, { label: "  Sample Rate", value: `${(config.tracing.sampleRate * 100).toFixed(0)}%` });
+    if (config.tracing.exporter === "otlp" && config.tracing.otlpEndpoint) {
+        rows.push({ label: "  OTLP Endpoint", value: config.tracing.otlpEndpoint });
+    }
+    // Metrics config
+    rows.push({ label: "Metrics", value: formatEnabled(config.metrics.enabled, rich) }, { label: "  Exporter", value: formatExporterType(config.metrics.exporter, rich) }, { label: "  Export Interval", value: `${config.metrics.exportIntervalMs}ms` });
+    if (config.metrics.exporter === "otlp" && config.metrics.otlpEndpoint) {
+        rows.push({ label: "  OTLP Endpoint", value: config.metrics.otlpEndpoint });
+    }
+    const maxLabelWidth = Math.max(...rows.map((r) => r.label.length));
+    for (const row of rows) {
+        const paddedLabel = row.label.padStart(maxLabelWidth);
+        if (rich) {
+            runtime.log(`    ${colorize(rich, theme.muted, paddedLabel)}: ${row.value}`);
+        }
+        else {
+            runtime.log(`    ${paddedLabel}: ${row.value}`);
+        }
+    }
+    runtime.log("");
+}
+// Print metrics summary
+function printMetricsSummary(metrics, runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log(rich ? colorize(rich, theme.heading, "  Metrics Summary") : "  Metrics Summary");
+    runtime.log(rich
+        ? colorize(rich, theme.muted, "  ─────────────────────────────────────────────────────────")
+        : "  ─────────────────────────────────────────────────────────");
+    const counterCount = Object.keys(metrics.counters).length;
+    const histogramCount = Object.keys(metrics.histograms).length;
+    const gaugeCount = Object.keys(metrics.gauges).length;
+    if (rich) {
+        runtime.log(`    ${colorize(rich, theme.info, "Counters:")}   ${counterCount}`);
+        runtime.log(`    ${colorize(rich, theme.accent, "Histograms:")} ${histogramCount}`);
+        runtime.log(`    ${colorize(rich, theme.success, "Gauges:")}    ${gaugeCount}`);
+    }
+    else {
+        runtime.log(`    Counters:   ${counterCount}`);
+        runtime.log(`    Histograms: ${histogramCount}`);
+        runtime.log(`    Gauges:     ${gaugeCount}`);
+    }
+    runtime.log("");
+}
+// Print connection status
+function printConnectionStatus(status, runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log(rich ? colorize(rich, theme.heading, "  Connection Status") : "  Connection Status");
+    runtime.log(rich
+        ? colorize(rich, theme.muted, "  ─────────────────────────────────────────────────────────")
+        : "  ─────────────────────────────────────────────────────────");
+    const connectionStatus = status.isConnected
+        ? rich
+            ? `${colorize(rich, theme.success, STATUS_ICONS.connected)} Connected`
+            : "Connected"
+        : rich
+            ? `${colorize(rich, theme.error, STATUS_ICONS.disconnected)} Disconnected`
+            : "Disconnected";
+    runtime.log(`    Status:      ${connectionStatus}`);
+    if (status.lastExportAt) {
+        runtime.log(`    Last Export: ${status.lastExportAt}`);
+    }
+    else {
+        runtime.log(`    Last Export: ${rich ? colorize(rich, theme.muted, "never") : "never"}`);
+    }
+    if (status.exportErrors > 0) {
+        runtime.log(`    Errors:      ${rich ? colorize(rich, theme.error, String(status.exportErrors)) : status.exportErrors}`);
+    }
+    else {
+        runtime.log(`    Errors:      ${rich ? colorize(rich, theme.success, "0") : "0"}`);
+    }
+    runtime.log("");
+}
+// Print footer with tips
+function printFooter(runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log("");
+    if (rich) {
+        runtime.log(colorize(rich, theme.muted, "  Commands: poolbot telemetry metrics | poolbot config set telemetry.enabled true"));
+    }
+    else {
+        runtime.log("  Commands: poolbot telemetry metrics | poolbot config set telemetry.enabled true");
+    }
+    runtime.log("");
+}
+export function registerTelemetryStatusCommand(telemetry) {
+    addGatewayClientOptions(telemetry
+        .command("status")
+        .alias("info")
+        .description("Show telemetry configuration and status")
+        .option("--json", "Output JSON (disables visual formatting)", false)
+        .action(async (opts) => {
+        try {
+            const res = await callGatewayFromCli("telemetry.status", opts, {});
+            if (opts.json) {
+                defaultRuntime.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            const data = res;
+            printStatusHeader();
+            printConfiguration(data.config);
+            printMetricsSummary(data.metrics);
+            printConnectionStatus(data.status);
+            printFooter();
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    }));
+}