flowlint 0.5.3 → 0.6.1

package/dist/packages/logger/index.js

@@ -1,40 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = void 0;
-exports.createChildLogger = createChildLogger;
-exports.createCorrelatedLogger = createCorrelatedLogger;
-const pino_1 = __importDefault(require("pino"));
-// Create base logger with environment-aware configuration
-exports.logger = (0, pino_1.default)({
-    level: process.env.LOG_LEVEL || 'info',
-    transport: process.env.NODE_ENV === 'development'
-        ? {
-            target: 'pino-pretty',
-            options: {
-                colorize: true,
-                translateTime: 'HH:MM:ss',
-                ignore: 'pid,hostname',
-            },
-        }
-        : undefined,
-});
-/**
- * Create a child logger with additional context.
- * Use this to add correlation IDs, request IDs, or other contextual metadata.
- */
-function createChildLogger(context) {
-    return exports.logger.child(context);
-}
-/**
- * Create a logger with correlation ID for tracking requests across API → Queue → Worker.
- */
-function createCorrelatedLogger(correlationId, additionalContext) {
-    return exports.logger.child({
-        correlationId,
-        ...additionalContext,
-    });
-}
-//# sourceMappingURL=index.js.map

package/dist/packages/logger/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/logger/index.ts"],"names":[],"mappings":";;;;;;AAsBA,8CAEC;AAKD,wDAKC;AAlCD,gDAAwB;AAExB,0DAA0D;AAC7C,QAAA,MAAM,GAAG,IAAA,cAAI,EAAC;IACzB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,SAAS,EACP,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QACpC,CAAC,CAAC;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,UAAU;gBACzB,MAAM,EAAE,cAAc;aACvB;SACF;QACH,CAAC,CAAC,SAAS;CAChB,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,OAAgC;IAChE,OAAO,cAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,aAAqB,EAAE,iBAA2C;IACvG,OAAO,cAAM,CAAC,KAAK,CAAC;QAClB,aAAa;QACb,GAAG,iBAAiB;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/packages/observability/collectors.d.ts

@@ -1,40 +0,0 @@
-/**
- * Metric Collectors for FlowLint
- *
- * This module implements periodic metric collectors that query external systems
- * (e.g., BullMQ queue) and update gauge metrics.
- *
- * @module packages/observability/collectors
- */
-import { Queue } from 'bullmq';
-/**
- * Queue Metrics Collector
- *
- * Periodically queries BullMQ queue for depth by state and updates Prometheus gauges.
- * Runs every 10 seconds to provide near-real-time queue visibility.
- *
- * @param queue - BullMQ queue instance
- * @returns Interval timer (for cleanup)
- *
- * @example
- *   import { Queue } from 'bullmq';
- *   import { startQueueMetricsCollector } from './packages/observability/collectors';
- *
- *   const queue = new Queue('pr-review', { connection: redis });
- *   const collectorInterval = startQueueMetricsCollector(queue);
- *
- *   // Later, to stop collector:
- *   clearInterval(collectorInterval);
- */
-export declare function startQueueMetricsCollector(queue: Queue<any>): NodeJS.Timeout;
-/**
- * Stop queue metrics collector
- *
- * Clears the interval timer to stop metric collection.
- *
- * @param interval - Interval timer from startQueueMetricsCollector
- *
- * @example
- *   stopQueueMetricsCollector(collectorInterval);
- */
-export declare function stopQueueMetricsCollector(interval: NodeJS.Timeout): void;

package/dist/packages/observability/collectors.js

@@ -1,75 +0,0 @@
-"use strict";
-/**
- * Metric Collectors for FlowLint
- *
- * This module implements periodic metric collectors that query external systems
- * (e.g., BullMQ queue) and update gauge metrics.
- *
- * @module packages/observability/collectors
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startQueueMetricsCollector = startQueueMetricsCollector;
-exports.stopQueueMetricsCollector = stopQueueMetricsCollector;
-const metrics_1 = require("./metrics");
-const logger_1 = require("../logger");
-const logger = (0, logger_1.createChildLogger)({ component: 'observability:collectors' });
-/**
- * Queue Metrics Collector
- *
- * Periodically queries BullMQ queue for depth by state and updates Prometheus gauges.
- * Runs every 10 seconds to provide near-real-time queue visibility.
- *
- * @param queue - BullMQ queue instance
- * @returns Interval timer (for cleanup)
- *
- * @example
- *   import { Queue } from 'bullmq';
- *   import { startQueueMetricsCollector } from './packages/observability/collectors';
- *
- *   const queue = new Queue('pr-review', { connection: redis });
- *   const collectorInterval = startQueueMetricsCollector(queue);
- *
- *   // Later, to stop collector:
- *   clearInterval(collectorInterval);
- */
-function startQueueMetricsCollector(queue) {
-    logger.info('Starting queue metrics collector (10s interval)');
-    const updateQueueMetrics = async () => {
-        try {
-            // Get job counts from BullMQ queue
-            // getJobCounts() returns: { waiting, active, completed, failed, delayed, paused }
-            const counts = await queue.getJobCounts();
-            // Update gauges for each state
-            metrics_1.queueDepthGauge.set({ state: 'waiting' }, counts.waiting || 0);
-            metrics_1.queueDepthGauge.set({ state: 'active' }, counts.active || 0);
-            metrics_1.queueDepthGauge.set({ state: 'failed' }, counts.failed || 0);
-            metrics_1.queueDepthGauge.set({ state: 'delayed' }, counts.delayed || 0);
-            metrics_1.queueDepthGauge.set({ state: 'paused' }, counts.paused || 0);
-            logger.debug({ counts }, 'Queue metrics updated');
-        }
-        catch (error) {
-            // Don't crash if queue is temporarily unavailable
-            logger.warn({ error }, 'Failed to update queue metrics');
-        }
-    };
-    // Initial update (don't wait 10 seconds for first metrics)
-    updateQueueMetrics();
-    // Update every 10 seconds
-    const interval = setInterval(updateQueueMetrics, 10000);
-    return interval;
-}
-/**
- * Stop queue metrics collector
- *
- * Clears the interval timer to stop metric collection.
- *
- * @param interval - Interval timer from startQueueMetricsCollector
- *
- * @example
- *   stopQueueMetricsCollector(collectorInterval);
- */
-function stopQueueMetricsCollector(interval) {
-    logger.info('Stopping queue metrics collector');
-    clearInterval(interval);
-}
-//# sourceMappingURL=collectors.js.map

package/dist/packages/observability/collectors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collectors.js","sourceRoot":"","sources":["../../../packages/observability/collectors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA2BH,gEA8BC;AAYD,8DAGC;AArED,uCAA4C;AAC5C,sCAA8C;AAE9C,MAAM,MAAM,GAAG,IAAA,0BAAiB,EAAC,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,0BAA0B,CAAC,KAAiB;IAC1D,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAE/D,MAAM,kBAAkB,GAAG,KAAK,IAAI,EAAE;QACpC,IAAI,CAAC;YACH,mCAAmC;YACnC,kFAAkF;YAClF,MAAM,MAAM,GAAG,MAAO,KAAa,CAAC,YAAY,EAAE,CAAC;YAEnD,+BAA+B;YAC/B,yBAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;YAC/D,yBAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YAC7D,yBAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YAC7D,yBAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;YAC/D,yBAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YAE7D,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kDAAkD;YAClD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,gCAAgC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC;IAEF,2DAA2D;IAC3D,kBAAkB,EAAE,CAAC;IAErB,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,WAAW,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAExD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,yBAAyB,CAAC,QAAwB;IAChE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAChD,aAAa,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC"}

package/dist/packages/observability/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * FlowLint Observability Package
- *
- * Provides Prometheus metrics collection and exposure for FlowLint.
- *
- * @module packages/observability
- */
-export { register, webhookCounter, jobsQueuedCounter, jobsCompletedCounter, jobDurationHistogram, queueDepthGauge, githubApiCallsCounter, findingsGeneratedCounter, redisOpsCounter, httpRequestDuration, getMetrics, getContentType, clearMetrics, getMetric } from './metrics';
-export { metricsMiddleware, metricsErrorHandler } from './middleware';
-export { startQueueMetricsCollector, stopQueueMetricsCollector } from './collectors';

package/dist/packages/observability/index.js

@@ -1,35 +0,0 @@
-"use strict";
-/**
- * FlowLint Observability Package
- *
- * Provides Prometheus metrics collection and exposure for FlowLint.
- *
- * @module packages/observability
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stopQueueMetricsCollector = exports.startQueueMetricsCollector = exports.metricsErrorHandler = exports.metricsMiddleware = exports.getMetric = exports.clearMetrics = exports.getContentType = exports.getMetrics = exports.httpRequestDuration = exports.redisOpsCounter = exports.findingsGeneratedCounter = exports.githubApiCallsCounter = exports.queueDepthGauge = exports.jobDurationHistogram = exports.jobsCompletedCounter = exports.jobsQueuedCounter = exports.webhookCounter = exports.register = void 0;
-// Export all metrics
-var metrics_1 = require("./metrics");
-Object.defineProperty(exports, "register", { enumerable: true, get: function () { return metrics_1.register; } });
-Object.defineProperty(exports, "webhookCounter", { enumerable: true, get: function () { return metrics_1.webhookCounter; } });
-Object.defineProperty(exports, "jobsQueuedCounter", { enumerable: true, get: function () { return metrics_1.jobsQueuedCounter; } });
-Object.defineProperty(exports, "jobsCompletedCounter", { enumerable: true, get: function () { return metrics_1.jobsCompletedCounter; } });
-Object.defineProperty(exports, "jobDurationHistogram", { enumerable: true, get: function () { return metrics_1.jobDurationHistogram; } });
-Object.defineProperty(exports, "queueDepthGauge", { enumerable: true, get: function () { return metrics_1.queueDepthGauge; } });
-Object.defineProperty(exports, "githubApiCallsCounter", { enumerable: true, get: function () { return metrics_1.githubApiCallsCounter; } });
-Object.defineProperty(exports, "findingsGeneratedCounter", { enumerable: true, get: function () { return metrics_1.findingsGeneratedCounter; } });
-Object.defineProperty(exports, "redisOpsCounter", { enumerable: true, get: function () { return metrics_1.redisOpsCounter; } });
-Object.defineProperty(exports, "httpRequestDuration", { enumerable: true, get: function () { return metrics_1.httpRequestDuration; } });
-Object.defineProperty(exports, "getMetrics", { enumerable: true, get: function () { return metrics_1.getMetrics; } });
-Object.defineProperty(exports, "getContentType", { enumerable: true, get: function () { return metrics_1.getContentType; } });
-Object.defineProperty(exports, "clearMetrics", { enumerable: true, get: function () { return metrics_1.clearMetrics; } });
-Object.defineProperty(exports, "getMetric", { enumerable: true, get: function () { return metrics_1.getMetric; } });
-// Export middleware
-var middleware_1 = require("./middleware");
-Object.defineProperty(exports, "metricsMiddleware", { enumerable: true, get: function () { return middleware_1.metricsMiddleware; } });
-Object.defineProperty(exports, "metricsErrorHandler", { enumerable: true, get: function () { return middleware_1.metricsErrorHandler; } });
-// Export collectors
-var collectors_1 = require("./collectors");
-Object.defineProperty(exports, "startQueueMetricsCollector", { enumerable: true, get: function () { return collectors_1.startQueueMetricsCollector; } });
-Object.defineProperty(exports, "stopQueueMetricsCollector", { enumerable: true, get: function () { return collectors_1.stopQueueMetricsCollector; } });
-//# sourceMappingURL=index.js.map

package/dist/packages/observability/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/observability/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,qBAAqB;AACrB,qCAemB;AAdjB,mGAAA,QAAQ,OAAA;AACR,yGAAA,cAAc,OAAA;AACd,4GAAA,iBAAiB,OAAA;AACjB,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AACpB,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AACrB,mHAAA,wBAAwB,OAAA;AACxB,0GAAA,eAAe,OAAA;AACf,8GAAA,mBAAmB,OAAA;AACnB,qGAAA,UAAU,OAAA;AACV,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AACZ,oGAAA,SAAS,OAAA;AAGX,oBAAoB;AACpB,2CAAsE;AAA7D,+GAAA,iBAAiB,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAE/C,oBAAoB;AACpB,2CAAqF;AAA5E,wHAAA,0BAA0B,OAAA;AAAE,uHAAA,yBAAyB,OAAA"}

package/dist/packages/observability/metrics.d.ts

@@ -1,119 +0,0 @@
-/**
- * Prometheus Metrics Definitions for FlowLint
- *
- * This module defines all custom Prometheus metrics for FlowLint observability.
- * Metrics follow Prometheus naming conventions and are designed for low cardinality.
- *
- * @module packages/observability/metrics
- */
-import { Registry, Counter, Histogram, Gauge } from 'prom-client';
-export declare const register: Registry<"text/plain; version=0.0.4; charset=utf-8">;
-/**
- * Metric 1: Webhook Counter
- *
- * Tracks total webhooks received from GitHub, labeled by event type and action.
- *
- * Example usage:
- *   webhookCounter.labels('pull_request', 'opened').inc();
- */
-export declare const webhookCounter: Counter<"event_type" | "action">;
-/**
- * Metric 2: Jobs Queued Counter
- *
- * Tracks total review jobs added to BullMQ queue.
- *
- * Example usage:
- *   jobsQueuedCounter.labels('acme-corp/api-gateway').inc();
- */
-export declare const jobsQueuedCounter: Counter<"repo">;
-/**
- * Metric 3: Jobs Completed Counter
- *
- * Tracks total review jobs completed (success or failure).
- *
- * Example usage:
- *   jobsCompletedCounter.labels('success', 'acme-corp/api-gateway').inc();
- */
-export declare const jobsCompletedCounter: Counter<"repo" | "status">;
-/**
- * Metric 4: Job Duration Histogram
- *
- * Distribution of job processing time in seconds.
- * Buckets optimized for typical workflow review times (0.1s to 120s).
- *
- * Example usage:
- *   const timer = jobDurationHistogram.startTimer({ repo: 'acme-corp/api-gateway' });
- *   // ... process job
- *   timer(); // Records duration
- */
-export declare const jobDurationHistogram: Histogram<"repo">;
-/**
- * Metric 5: Queue Depth Gauge
- *
- * Current number of jobs in queue by state.
- * Updated periodically by collector (every 10 seconds).
- *
- * Example usage:
- *   queueDepthGauge.set({ state: 'waiting' }, 10);
- */
-export declare const queueDepthGauge: Gauge<"state">;
-/**
- * Metric 6: GitHub API Calls Counter
- *
- * Tracks GitHub API calls made by FlowLint, labeled by method and status.
- *
- * Example usage:
- *   githubApiCallsCounter.labels('GET', '200', '/repos/:owner/:repo/pulls/:number/files').inc();
- */
-export declare const githubApiCallsCounter: Counter<"status" | "method" | "endpoint">;
-/**
- * Metric 7: Findings Generated Counter
- *
- * Tracks lint findings generated, labeled by rule and severity.
- *
- * Example usage:
- *   findingsGeneratedCounter.labels('rate_limit_retry', 'must').inc();
- */
-export declare const findingsGeneratedCounter: Counter<"rule" | "severity">;
-/**
- * Metric 8: Redis Operations Counter (Optional)
- *
- * Tracks Redis operations performed by BullMQ.
- *
- * Example usage:
- *   redisOpsCounter.labels('zadd', 'success').inc();
- */
-export declare const redisOpsCounter: Counter<"status" | "operation">;
-/**
- * HTTP Request Duration Histogram
- *
- * Automatically populated by metricsMiddleware.
- * Tracks HTTP request latency by method, route, and status.
- */
-export declare const httpRequestDuration: Histogram<"status" | "method" | "route">;
-/**
- * Get all metrics in Prometheus exposition format
- *
- * @returns Prometheus-formatted metrics string
- */
-export declare function getMetrics(): Promise<string>;
-/**
- * Get metrics content type header
- *
- * @returns Prometheus content type string
- */
-export declare function getContentType(): string;
-/**
- * Clear all metrics (useful for testing)
- *
- * WARNING: This removes all metrics from the registry.
- * Only use in test environments.
- */
-export declare function clearMetrics(): void;
-/**
- * Get single metric by name (for testing)
- *
- * @param name - Metric name
- * @returns Metric instance or undefined
- */
-export declare function getMetric(name: string): import("prom-client").Metric<string> | undefined;

package/dist/packages/observability/metrics.js

@@ -1,194 +0,0 @@
-"use strict";
-/**
- * Prometheus Metrics Definitions for FlowLint
- *
- * This module defines all custom Prometheus metrics for FlowLint observability.
- * Metrics follow Prometheus naming conventions and are designed for low cardinality.
- *
- * @module packages/observability/metrics
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.httpRequestDuration = exports.redisOpsCounter = exports.findingsGeneratedCounter = exports.githubApiCallsCounter = exports.queueDepthGauge = exports.jobDurationHistogram = exports.jobsCompletedCounter = exports.jobsQueuedCounter = exports.webhookCounter = exports.register = void 0;
-exports.getMetrics = getMetrics;
-exports.getContentType = getContentType;
-exports.clearMetrics = clearMetrics;
-exports.getMetric = getMetric;
-const prom_client_1 = require("prom-client");
-// Create dedicated registry for FlowLint metrics
-exports.register = new prom_client_1.Registry();
-// Enable default process and Node.js metrics
-(0, prom_client_1.collectDefaultMetrics)({ register: exports.register });
-// ============================================================================
-// Custom Application Metrics
-// ============================================================================
-/**
- * Metric 1: Webhook Counter
- *
- * Tracks total webhooks received from GitHub, labeled by event type and action.
- *
- * Example usage:
- *   webhookCounter.labels('pull_request', 'opened').inc();
- */
-exports.webhookCounter = new prom_client_1.Counter({
-    name: 'flowlint_webhook_received_total',
-    help: 'Total number of webhooks received from GitHub',
-    labelNames: ['event_type', 'action'],
-    registers: [exports.register]
-});
-/**
- * Metric 2: Jobs Queued Counter
- *
- * Tracks total review jobs added to BullMQ queue.
- *
- * Example usage:
- *   jobsQueuedCounter.labels('acme-corp/api-gateway').inc();
- */
-exports.jobsQueuedCounter = new prom_client_1.Counter({
-    name: 'flowlint_jobs_queued_total',
-    help: 'Total number of review jobs queued for processing',
-    labelNames: ['repo'],
-    registers: [exports.register]
-});
-/**
- * Metric 3: Jobs Completed Counter
- *
- * Tracks total review jobs completed (success or failure).
- *
- * Example usage:
- *   jobsCompletedCounter.labels('success', 'acme-corp/api-gateway').inc();
- */
-exports.jobsCompletedCounter = new prom_client_1.Counter({
-    name: 'flowlint_jobs_completed_total',
-    help: 'Total number of review jobs completed',
-    labelNames: ['status', 'repo'],
-    registers: [exports.register]
-});
-/**
- * Metric 4: Job Duration Histogram
- *
- * Distribution of job processing time in seconds.
- * Buckets optimized for typical workflow review times (0.1s to 120s).
- *
- * Example usage:
- *   const timer = jobDurationHistogram.startTimer({ repo: 'acme-corp/api-gateway' });
- *   // ... process job
- *   timer(); // Records duration
- */
-exports.jobDurationHistogram = new prom_client_1.Histogram({
-    name: 'flowlint_job_duration_seconds',
-    help: 'Duration of job processing in seconds',
-    labelNames: ['repo'],
-    buckets: [0.1, 0.5, 1, 2, 5, 10, 30, 60, 120],
-    registers: [exports.register]
-});
-/**
- * Metric 5: Queue Depth Gauge
- *
- * Current number of jobs in queue by state.
- * Updated periodically by collector (every 10 seconds).
- *
- * Example usage:
- *   queueDepthGauge.set({ state: 'waiting' }, 10);
- */
-exports.queueDepthGauge = new prom_client_1.Gauge({
-    name: 'flowlint_queue_depth',
-    help: 'Current number of jobs in queue by state',
-    labelNames: ['state'],
-    registers: [exports.register]
-});
-/**
- * Metric 6: GitHub API Calls Counter
- *
- * Tracks GitHub API calls made by FlowLint, labeled by method and status.
- *
- * Example usage:
- *   githubApiCallsCounter.labels('GET', '200', '/repos/:owner/:repo/pulls/:number/files').inc();
- */
-exports.githubApiCallsCounter = new prom_client_1.Counter({
-    name: 'flowlint_github_api_calls_total',
-    help: 'Total GitHub API calls made by FlowLint',
-    labelNames: ['method', 'status', 'endpoint'],
-    registers: [exports.register]
-});
-/**
- * Metric 7: Findings Generated Counter
- *
- * Tracks lint findings generated, labeled by rule and severity.
- *
- * Example usage:
- *   findingsGeneratedCounter.labels('rate_limit_retry', 'must').inc();
- */
-exports.findingsGeneratedCounter = new prom_client_1.Counter({
-    name: 'flowlint_findings_generated_total',
-    help: 'Total lint findings generated by rule and severity',
-    labelNames: ['rule', 'severity'],
-    registers: [exports.register]
-});
-/**
- * Metric 8: Redis Operations Counter (Optional)
- *
- * Tracks Redis operations performed by BullMQ.
- *
- * Example usage:
- *   redisOpsCounter.labels('zadd', 'success').inc();
- */
-exports.redisOpsCounter = new prom_client_1.Counter({
-    name: 'flowlint_redis_operations_total',
-    help: 'Total Redis operations performed',
-    labelNames: ['operation', 'status'],
-    registers: [exports.register]
-});
-// ============================================================================
-// HTTP Metrics (Automatic via middleware)
-// ============================================================================
-/**
- * HTTP Request Duration Histogram
- *
- * Automatically populated by metricsMiddleware.
- * Tracks HTTP request latency by method, route, and status.
- */
-exports.httpRequestDuration = new prom_client_1.Histogram({
-    name: 'http_request_duration_seconds',
-    help: 'Duration of HTTP requests in seconds',
-    labelNames: ['method', 'route', 'status'],
-    buckets: [0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1, 5],
-    registers: [exports.register]
-});
-// ============================================================================
-// Utility Functions
-// ============================================================================
-/**
- * Get all metrics in Prometheus exposition format
- *
- * @returns Prometheus-formatted metrics string
- */
-async function getMetrics() {
-    return exports.register.metrics();
-}
-/**
- * Get metrics content type header
- *
- * @returns Prometheus content type string
- */
-function getContentType() {
-    return exports.register.contentType;
-}
-/**
- * Clear all metrics (useful for testing)
- *
- * WARNING: This removes all metrics from the registry.
- * Only use in test environments.
- */
-function clearMetrics() {
-    exports.register.clear();
-}
-/**
- * Get single metric by name (for testing)
- *
- * @param name - Metric name
- * @returns Metric instance or undefined
- */
-function getMetric(name) {
-    return exports.register.getSingleMetric(name);
-}
-//# sourceMappingURL=metrics.js.map

package/dist/packages/observability/metrics.js.map

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

package/dist/packages/observability/middleware.d.ts

@@ -1,32 +0,0 @@
-/**
- * Express Middleware for HTTP Metrics Collection
- *
- * This middleware automatically tracks HTTP request metrics including:
- * - Request duration (latency)
- * - Request count by method, route, status
- *
- * @module packages/observability/middleware
- */
-import { Request, Response, NextFunction } from 'express';
-/**
- * Express middleware to collect HTTP request metrics
- *
- * Automatically instruments all HTTP requests with Prometheus metrics.
- * Metrics are labeled by HTTP method, route path, and response status code.
- *
- * Usage:
- *   import { metricsMiddleware } from './packages/observability/middleware';
- *   app.use(metricsMiddleware);
- *
- * @param req - Express request object
- * @param res - Express response object
- * @param next - Express next function
- */
-export declare function metricsMiddleware(req: Request, res: Response, next: NextFunction): void;
-/**
- * Middleware error handler
- *
- * Ensures metrics failures don't crash the application.
- * Logs errors and continues processing.
- */
-export declare function metricsErrorHandler(err: Error, req: Request, res: Response, next: NextFunction): void;

package/dist/packages/observability/middleware.js

@@ -1,58 +0,0 @@
-"use strict";
-/**
- * Express Middleware for HTTP Metrics Collection
- *
- * This middleware automatically tracks HTTP request metrics including:
- * - Request duration (latency)
- * - Request count by method, route, status
- *
- * @module packages/observability/middleware
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.metricsMiddleware = metricsMiddleware;
-exports.metricsErrorHandler = metricsErrorHandler;
-const metrics_1 = require("./metrics");
-/**
- * Express middleware to collect HTTP request metrics
- *
- * Automatically instruments all HTTP requests with Prometheus metrics.
- * Metrics are labeled by HTTP method, route path, and response status code.
- *
- * Usage:
- *   import { metricsMiddleware } from './packages/observability/middleware';
- *   app.use(metricsMiddleware);
- *
- * @param req - Express request object
- * @param res - Express response object
- * @param next - Express next function
- */
-function metricsMiddleware(req, res, next) {
-    // Start timer for this request
-    const timer = metrics_1.httpRequestDuration.startTimer({
-        method: req.method,
-        route: req.route?.path || req.path,
-        status: '0' // Will be updated on response finish
-    });
-    // Record duration when response finishes
-    res.on('finish', () => {
-        try {
-            timer({ status: res.statusCode.toString() });
-        }
-        catch (error) {
-            // Don't let metrics errors crash the application
-            console.error('Failed to record HTTP metrics:', error);
-        }
-    });
-    next();
-}
-/**
- * Middleware error handler
- *
- * Ensures metrics failures don't crash the application.
- * Logs errors and continues processing.
- */
-function metricsErrorHandler(err, req, res, next) {
-    console.error('Metrics middleware error:', err);
-    next(err); // Pass error to next error handler
-}
-//# sourceMappingURL=middleware.js.map

package/dist/packages/observability/middleware.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../packages/observability/middleware.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAmBH,8CAmBC;AAQD,kDAGC;AA9CD,uCAAgD;AAEhD;;;;;;;;;;;;;GAaG;AACH,SAAgB,iBAAiB,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;IAC/E,+BAA+B;IAC/B,MAAM,KAAK,GAAG,6BAAmB,CAAC,UAAU,CAAC;QAC3C,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI;QAClC,MAAM,EAAE,GAAG,CAAC,qCAAqC;KAClD,CAAC,CAAC;IAEH,yCAAyC;IACzC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACpB,IAAI,CAAC;YACH,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iDAAiD;YACjD,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,EAAE,CAAC;AACT,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,GAAU,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB;IAC7F,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC;AAChD,CAAC"}

package/dist/packages/review/analysis-engine.d.ts

@@ -1,19 +0,0 @@
-/**
- * FlowLint Analysis Engine
- *
- * Orchestrates the linting workflow:
- * 1. Load configuration
- * 2. Fetch files to analyze
- * 3. Parse each file into a graph
- * 4. Run rules against the graph
- * 5. Report results
- */
-import type { AnalysisEngine, AnalysisSummary, ConfigProvider, FileSource, Reporter } from './providers';
-export declare class DefaultAnalysisEngine implements AnalysisEngine {
-    private fileSource;
-    private configProvider;
-    private reporter;
-    constructor(fileSource: FileSource, configProvider: ConfigProvider, reporter: Reporter);
-    analyze(): Promise<AnalysisSummary>;
-    private formatParseError;
-}