@deniscuciuc/redis-analyzer 1.0.0

package/dist/src/reporters/report-generator.js

@@ -0,0 +1,239 @@
+"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.ReportGenerator = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const format_1 = require("../utils/format");
+const print_1 = require("../utils/print");
+const html_reporter_1 = require("./html-reporter");
+class ReportGenerator {
+    outputDir;
+    constructor(outputDir = "./reports", _options = {}) {
+        this.outputDir = outputDir;
+        void _options;
+    }
+    async generateFullReport(report, timestamp) {
+        const ts = timestamp ?? new Date().toISOString().replace(/[:.]/g, "-");
+        const filepath = path.join(this.outputDir, `redis-analysis-${ts}.md`);
+        await this.ensureOutputDir();
+        fs.writeFileSync(filepath, this.buildMarkdownReport(report));
+        return filepath;
+    }
+    async generateJsonReport(report, timestamp) {
+        const ts = timestamp ?? new Date().toISOString().replace(/[:.]/g, "-");
+        const filepath = path.join(this.outputDir, `redis-analysis-${ts}.json`);
+        await this.ensureOutputDir();
+        fs.writeFileSync(filepath, JSON.stringify(report, null, 2));
+        return filepath;
+    }
+    async generateHtmlReport(report, timestamp) {
+        const ts = timestamp ?? new Date().toISOString().replace(/[:.]/g, "-");
+        const filepath = path.join(this.outputDir, `redis-analysis-${ts}.html`);
+        await this.ensureOutputDir();
+        fs.writeFileSync(filepath, html_reporter_1.HtmlReporter.generate(report));
+        return filepath;
+    }
+    printSummary(report) {
+        (0, print_1.printRow)("Health score", `${report.healthScore}/100 ${(0, print_1.healthEmoji)(report.healthScore)} ${(0, print_1.healthLabel)(report.healthScore)}`);
+        (0, print_1.printRow)("Redis version", report.metrics.version);
+        (0, print_1.printRow)("Mode", report.metrics.mode);
+        (0, print_1.printRow)("Used memory", report.memory.usedMemoryHuman);
+        (0, print_1.printRow)("Hit rate", (0, format_1.formatPercent)(report.hitRate.hitRate));
+        (0, print_1.printRow)("Slow log length", report.slowCommands.totalLogged);
+        (0, print_1.printSeparator)();
+        for (const recommendation of report.recommendations.slice(0, 5)) {
+            (0, print_1.printBullet)(`[${recommendation.priority}] ${recommendation.message}`);
+        }
+    }
+    async ensureOutputDir() {
+        if (!fs.existsSync(this.outputDir)) {
+            fs.mkdirSync(this.outputDir, { recursive: true });
+        }
+    }
+    buildMarkdownReport(report) {
+        return [
+            this.buildHeader(report),
+            this.buildExecutiveSummary(report),
+            this.buildMetricsSection(report),
+            this.buildMemorySection(report),
+            this.buildHitRateSection(report),
+            this.buildPersistenceSection(report),
+            this.buildReplicationSection(report),
+            this.buildSlowCommandsSection(report),
+            this.buildKeyspacesSection(report.keyspaces),
+            this.buildConfigSection(report.config),
+            this.buildRecommendationsSection(report.recommendations),
+        ].join("\n\n");
+    }
+    buildHeader(report) {
+        return `# Redis Analysis Report
+
+**Target:** ${report.host}:${report.port}/${report.db}
+**Generated:** ${report.generatedAt.toISOString()}
+**Tool:** Redis Analyzer
+
+---`;
+    }
+    buildExecutiveSummary(report) {
+        const issues = report.recommendations
+            .slice(0, 5)
+            .map((item) => `- **${item.priority}** ${item.message}`);
+        return `## Executive Summary
+
+### Health Score: ${report.healthScore}/100 ${(0, print_1.healthEmoji)(report.healthScore)}
+
+### Key Findings
+${issues.length > 0 ? issues.join("\n") : "- No critical issues found"}
+
+### Quick Stats
+| Metric | Value |
+|--------|-------|
+| Redis Version | ${report.metrics.version} |
+| Used Memory | ${report.memory.usedMemoryHuman} |
+| Hit Rate | ${(0, format_1.formatPercent)(report.hitRate.hitRate)} |
+| Ops / sec | ${(0, format_1.formatNumber)(report.metrics.opsPerSec)} |
+| Total Keys | ${(0, format_1.formatNumber)(report.metrics.totalKeyCount)} |`;
+    }
+    buildMetricsSection(report) {
+        return `## Core Metrics
+
+| Metric | Value |
+|--------|-------|
+| Mode | ${report.metrics.mode} |
+| Uptime | ${report.metrics.uptimeDays} days |
+| Connected Clients | ${report.metrics.connectedClients} |
+| Blocked Clients | ${report.metrics.blockedClients} |
+| Max Clients | ${report.metrics.maxClients} |
+| Ops / sec | ${(0, format_1.formatNumber)(report.metrics.opsPerSec)} |
+| Total Keys | ${(0, format_1.formatNumber)(report.metrics.totalKeyCount)} |
+| Keyspaces | ${report.metrics.keyspacesCount} |
+| Rejected Connections | ${(0, format_1.formatNumber)(report.metrics.rejectedConnections)} |`;
+    }
+    buildMemorySection(report) {
+        return `## Memory
+
+| 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)} |
+| Peak Memory | ${(0, format_1.formatBytes)(report.memory.peakMemory)} |
+| Dataset Memory | ${(0, format_1.formatBytes)(report.memory.dataMemory)} |
+| Overhead Memory | ${(0, format_1.formatBytes)(report.memory.overheadMemory)} |`;
+    }
+    buildHitRateSection(report) {
+        return `## Cache Hit Rate
+
+| Metric | Value |
+|--------|-------|
+| Hits | ${(0, format_1.formatNumber)(report.hitRate.hits)} |
+| Misses | ${(0, format_1.formatNumber)(report.hitRate.misses)} |
+| 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)} |
+| Eviction Policy | ${report.hitRate.evictionPolicy} |`;
+    }
+    buildPersistenceSection(report) {
+        return `## Persistence
+
+| Metric | Value |
+|--------|-------|
+| RDB Enabled | ${report.persistence.rdb.enabled ? "yes" : "no"} |
+| Seconds Since Last Save | ${(0, format_1.formatNumber)(report.persistence.rdb.secondsSinceLastSave)} |
+| RDB Status | ${report.persistence.rdb.lastStatus} |
+| RDB Changes Since Save | ${(0, format_1.formatNumber)(report.persistence.rdb.changesSinceLastSave)} |
+| AOF Enabled | ${report.persistence.aof.enabled ? "yes" : "no"} |
+| AOF Status | ${report.persistence.aof.lastStatus} |
+| AOF Rewrite In Progress | ${report.persistence.aof.rewriteInProgress ? "yes" : "no"} |`;
+    }
+    buildReplicationSection(report) {
+        return `## Replication
+
+| Metric | Value |
+|--------|-------|
+| Role | ${report.replication.role} |
+| Connected Replicas | ${report.replication.connectedSlaves} |
+| Link Status | ${report.replication.linkStatus ?? "n/a"} |
+| Lag Seconds | ${report.replication.lagSeconds ?? "n/a"} |
+| Sync In Progress | ${report.replication.syncInProgress ? "yes" : "no"} |`;
+    }
+    buildSlowCommandsSection(report) {
+        const topCommands = report.slowCommands.topCommandTypes
+            .map((command) => `| ${command.command} | ${(0, format_1.formatNumber)(command.count)} | ${(0, format_1.formatDuration)(command.avgMs)} |`)
+            .join("\n");
+        return `## Slow Commands
+
+| Metric | Value |
+|--------|-------|
+| Logged Slow Commands | ${(0, format_1.formatNumber)(report.slowCommands.totalLogged)} |
+| Threshold | ${(0, format_1.formatDuration)(report.slowCommands.threshold / 1000)} |
+
+### Top Slow Command Types
+| Command | Count | Avg Duration |
+|---------|-------|--------------|
+${topCommands || "| none | 0 | 0ms |"}`;
+    }
+    buildKeyspacesSection(keyspaces) {
+        const rows = keyspaces
+            .map((keyspace) => `| db${keyspace.db} | ${(0, format_1.formatNumber)(keyspace.keys)} | ${(0, format_1.formatNumber)(keyspace.expires)} | ${(0, format_1.formatDuration)(keyspace.avgTtl)} |`)
+            .join("\n");
+        return `## Keyspaces
+
+| DB | Keys | Expiring Keys | Avg TTL |
+|----|------|---------------|---------|
+${rows || "| none | 0 | 0 | 0ms |"}`;
+    }
+    buildConfigSection(config) {
+        const rows = Object.entries(config)
+            .map(([key, value]) => `| ${key} | ${value} |`)
+            .join("\n");
+        return `## Important Configuration
+
+| Setting | Value |
+|---------|-------|
+${rows || "| none | n/a |"}`;
+    }
+    buildRecommendationsSection(recommendations) {
+        const items = recommendations.map((item) => `- **${item.priority}** \`${item.category}\` — ${item.message}`);
+        return `## Recommendations
+
+${items.length > 0 ? items.join("\n") : "- No recommendations"}`;
+    }
+}
+exports.ReportGenerator = ReportGenerator;

package/dist/src/types.d.ts

@@ -0,0 +1,184 @@
+export interface RedisConnection {
+    host: string;
+    port: number;
+    password?: string;
+    db: number;
+    tls: boolean;
+    uri?: string;
+}
+export interface RedisInfo {
+    redisVersion: string;
+    redisMode: string;
+    os: string;
+    uptimeInSeconds: number;
+    uptimeInDays: number;
+    tcpPort: number;
+    executablePath: string;
+    configFile: string;
+    connectedClients: number;
+    blockedClients: number;
+    maxClients: number;
+    clientRecentMaxInputBuffer: number;
+    clientRecentMaxOutputBuffer: number;
+    usedMemory: number;
+    usedMemoryHuman: string;
+    usedMemoryRss: number;
+    usedMemoryRssHuman: string;
+    usedMemoryPeak: number;
+    usedMemoryPeakHuman: string;
+    usedMemoryPeakPerc: number;
+    usedMemoryOverhead: number;
+    usedMemoryDataset: number;
+    memFragmentationRatio: number;
+    memFragmentationBytes: number;
+    maxmemory: number;
+    maxmemoryHuman: string;
+    maxmemoryPolicy: string;
+    totalCommandsProcessed: number;
+    instantaneousOpsPerSec: number;
+    totalNetInputBytes: number;
+    totalNetOutputBytes: number;
+    rejectedConnections: number;
+    expiredKeys: number;
+    evictedKeys: number;
+    keyspaceHits: number;
+    keyspaceMisses: number;
+    role: "master" | "slave";
+    connectedSlaves: number;
+    masterLinkStatus?: "up" | "down";
+    masterLastIoSecondsAgo?: number;
+    masterSyncInProgress?: boolean;
+    masterReplOffset?: number;
+    slaveReplOffset?: number;
+    rdbChangesSinceLastSave: number;
+    rdbBgsaveInProgress: boolean;
+    rdbLastSaveTime: number;
+    rdbLastBgsaveStatus: "ok" | "err";
+    rdbLastBgsaveTimeSec: number;
+    aofEnabled: boolean;
+    aofRewriteInProgress: boolean;
+    aofLastRewriteTimeSec: number;
+    aofLastBgrewriteStatus: "ok" | "err";
+    aofCurrentSize?: number;
+    keyspaces: KeyspaceInfo[];
+}
+export interface KeyspaceInfo {
+    db: number;
+    keys: number;
+    expires: number;
+    avgTtl: number;
+}
+export interface SlowCommand {
+    id: number;
+    timestamp: number;
+    durationMicros: number;
+    durationMs: number;
+    command: string[];
+    commandPreview: string;
+    clientAddr?: string;
+}
+export interface MemoryAnalysis {
+    usedMemory: number;
+    usedMemoryHuman: string;
+    maxMemory: number;
+    maxMemoryHuman: string;
+    usagePercent: number;
+    fragRatio: number;
+    fragBytes: number;
+    fragSeverity: "ok" | "warning" | "critical";
+    rssOverhead: number;
+    peakMemory: number;
+    dataMemory: number;
+    overheadMemory: number;
+    recommendations: string[];
+}
+export interface HitRateAnalysis {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    evictedKeys: number;
+    expiredKeys: number;
+    evictionPolicy: string;
+    evictionSeverity: "ok" | "warning" | "critical";
+    recommendations: string[];
+}
+export interface PersistenceAnalysis {
+    rdb: {
+        enabled: boolean;
+        lastSaveTime: number;
+        secondsSinceLastSave: number;
+        lastStatus: "ok" | "err";
+        changesSinceLastSave: number;
+        saveInProgress: boolean;
+    };
+    aof: {
+        enabled: boolean;
+        lastStatus: "ok" | "err";
+        rewriteInProgress: boolean;
+        currentSizeBytes?: number;
+    };
+    severity: "ok" | "warning" | "critical";
+    recommendations: string[];
+}
+export interface ReplicationAnalysis {
+    role: "master" | "slave" | "standalone";
+    connectedSlaves: number;
+    linkStatus?: "up" | "down";
+    lagSeconds?: number;
+    syncInProgress?: boolean;
+    severity: "ok" | "warning" | "critical";
+    recommendations: string[];
+}
+export interface SlowCommandSummary {
+    command: string;
+    count: number;
+    avgMs: number;
+}
+export interface SlowCommandAnalysis {
+    totalLogged: number;
+    commands: SlowCommand[];
+    topCommandTypes: SlowCommandSummary[];
+    threshold: number;
+    recommendations: string[];
+}
+export interface RedisMetrics {
+    version: string;
+    mode: string;
+    uptimeDays: number;
+    connectedClients: number;
+    blockedClients: number;
+    maxClients: number;
+    opsPerSec: number;
+    totalKeyCount: number;
+    keyspacesCount: number;
+    rejectedConnections: number;
+}
+export interface Recommendation {
+    priority: "critical" | "high" | "medium" | "low";
+    category: string;
+    message: string;
+    action?: string;
+}
+export interface FullRedisReport {
+    generatedAt: Date;
+    host: string;
+    port: number;
+    db: number;
+    healthScore: number;
+    metrics: RedisMetrics;
+    memory: MemoryAnalysis;
+    hitRate: HitRateAnalysis;
+    persistence: PersistenceAnalysis;
+    replication: ReplicationAnalysis;
+    slowCommands: SlowCommandAnalysis;
+    keyspaces: KeyspaceInfo[];
+    config: Record<string, string>;
+    recommendations: Recommendation[];
+}
+export type FullReport = FullRedisReport;
+export interface AnalyzerOptions {
+    slowCommandThreshold?: number;
+    maxSlowCommands?: number;
+    outputDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/utils/format.d.ts

@@ -0,0 +1,6 @@
+export declare function formatBytes(bytes: number): string;
+export declare function formatDuration(ms: number): string;
+export declare function formatMs(ms: number): string;
+export declare function formatNumber(value: number): string;
+export declare function formatPercent(value: number, decimals?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/src/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAEjE"}

package/dist/src/utils/format.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBytes = formatBytes;
+exports.formatDuration = formatDuration;
+exports.formatMs = formatMs;
+exports.formatNumber = formatNumber;
+exports.formatPercent = formatPercent;
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1_048_576)
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    if (bytes < 1_073_741_824)
+        return `${(bytes / 1_048_576).toFixed(2)} MB`;
+    return `${(bytes / 1_073_741_824).toFixed(2)} GB`;
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms.toFixed(0)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(2)}s`;
+    return `${(ms / 60_000).toFixed(2)}m`;
+}
+function formatMs(ms) {
+    return formatDuration(ms);
+}
+function formatNumber(value) {
+    return value.toLocaleString("en-US");
+}
+function formatPercent(value, decimals = 2) {
+    return `${value.toFixed(decimals)}%`;
+}

package/dist/src/utils/print.d.ts

@@ -0,0 +1,8 @@
+export declare function printSection(title: string): void;
+export declare function printRow(label: string, value: string | number): void;
+export declare function printBullet(line: string): void;
+export declare function printSubBullet(line: string): void;
+export declare function printSeparator(): void;
+export declare function healthEmoji(score: number): string;
+export declare function healthLabel(score: number): string;
+//# sourceMappingURL=print.d.ts.map

package/dist/src/utils/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../../src/utils/print.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/src/utils/print.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printSection = printSection;
+exports.printRow = printRow;
+exports.printBullet = printBullet;
+exports.printSubBullet = printSubBullet;
+exports.printSeparator = printSeparator;
+exports.healthEmoji = healthEmoji;
+exports.healthLabel = healthLabel;
+function printSection(title) {
+    console.log(`\n━━━ ${title} ━━━`);
+}
+function printRow(label, value) {
+    console.log(`  ${label}: ${value}`);
+}
+function printBullet(line) {
+    console.log(`  • ${line}`);
+}
+function printSubBullet(line) {
+    console.log(`    ${line}`);
+}
+function printSeparator() {
+    console.log("");
+}
+function healthEmoji(score) {
+    if (score >= 90)
+        return "🟢";
+    if (score >= 70)
+        return "🟡";
+    if (score >= 50)
+        return "🟠";
+    return "🔴";
+}
+function healthLabel(score) {
+    if (score >= 90)
+        return "Excellent";
+    if (score >= 70)
+        return "Good";
+    if (score >= 50)
+        return "Warning";
+    return "Critical";
+}

package/dist/src/watch/runner.d.ts

@@ -0,0 +1,8 @@
+export interface WatchOptions {
+    intervalSeconds: number;
+    command: string;
+    runCommand: () => Promise<void>;
+}
+export declare function validateWatchCommand(command: string): void;
+export declare function runWatchLoop(options: WatchOptions): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/watch/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/watch/runner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAY1D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CvE"}

package/dist/src/watch/runner.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWatchCommand = validateWatchCommand;
+exports.runWatchLoop = runWatchLoop;
+const constants_1 = require("../constants");
+const CLEAR = "\x1Bc";
+function validateWatchCommand(command) {
+    if (constants_1.WATCH_BLOCKED.has(command)) {
+        throw new Error(`--watch cannot be used with '${command}' (write operation).`);
+    }
+    if (!constants_1.WATCH_ALLOWED.has(command)) {
+        throw new Error(`--watch is not supported for '${command}'. Supported: ${Array.from(constants_1.WATCH_ALLOWED).join(", ")}`);
+    }
+}
+async function runWatchLoop(options) {
+    validateWatchCommand(options.command);
+    let stopped = false;
+    const handleSigInt = () => {
+        stopped = true;
+    };
+    process.on("SIGINT", handleSigInt);
+    try {
+        while (!stopped) {
+            process.stdout.write(CLEAR);
+            process.stdout.write(`[watch] command: ${options.command} | interval: ${options.intervalSeconds}s | updated: ${new Date().toLocaleTimeString()} | Ctrl+C to stop\n\n`);
+            try {
+                await options.runCommand();
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                process.stderr.write(`\nWatch iteration failed: ${message}\n`);
+            }
+            for (let remaining = options.intervalSeconds; remaining > 0; remaining--) {
+                if (stopped) {
+                    break;
+                }
+                process.stdout.write(`\rNext update in ${remaining}s...   `);
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+            }
+            if (!stopped) {
+                process.stdout.write("\r");
+            }
+        }
+    }
+    finally {
+        process.off("SIGINT", handleSigInt);
+        process.stdout.write("\nWatch stopped.\n");
+    }
+}

package/dist/tests/analysis-and-reports.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analysis-and-reports.test.d.ts.map

package/dist/tests/analysis-and-reports.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-and-reports.test.d.ts","sourceRoot":"","sources":["../../tests/analysis-and-reports.test.ts"],"names":[],"mappings":""}