@meyicloud/meyi-insight-server 1.0.0

package/dist/pipeline/AlarmPipelineWorker.js

@@ -0,0 +1,342 @@
+import { Worker } from "bullmq";
+import { sql } from "drizzle-orm";
+import { getRedisClient } from "./alarmQueue.js";
+const PIPELINE_CONCURRENCY = parseInt(process.env.PIPELINE_CONCURRENCY ?? "5", 10);
+// Default job lock duration (ms). Jobs that take longer than this need lock renewal.
+// Must be > the longest expected stage duration. 30s is BullMQ default.
+const LOCK_DURATION_MS = 60_000; // 60s — generous for DB + normalization
+export function createAlarmPipelineWorker(deps) {
+    const { normalizationService, dedupService, groupingService, pipelineEventModel, alertModel, workflowService, realtimePublisher } = deps;
+    // BullMQ Worker uses its own internal ioredis connection via plain options
+    const redisUrl = process.env.REDIS_URL ?? "redis://localhost:6379";
+    let connOpts;
+    try {
+        const url = new URL(redisUrl);
+        connOpts = {
+            host: url.hostname || "localhost",
+            port: parseInt(url.port || "6379", 10),
+            password: url.password || undefined,
+            db: url.pathname ? parseInt(url.pathname.slice(1) || "0", 10) : 0,
+        };
+    }
+    catch {
+        connOpts = { host: "localhost", port: 6379, db: 0 };
+    }
+    const worker = new Worker("alarm-pipeline", async (job) => {
+        const { sourceId, sourceType, sourceName, tenantId, rawPayload, receivedAt } = job.data;
+        let alarmId;
+        // ── Stage 0: Create placeholder alarm immediately (fail-fast guarantee) ─
+        // IMPORTANT: If this throws, BullMQ will retry the job (attempts: 3).
+        // Do NOT catch-and-return here — that would silently complete the job
+        // without creating an alert and prevent retries.
+        const placeholderRow = await alertModel.create({
+            sourceId,
+            sourceName: sourceName ?? "",
+            sourceType,
+            tenantId: tenantId ?? null, // ← propagated from source via job data
+            resourceId: "pending",
+            resourceName: "pending",
+            resourceType: sourceType,
+            tags: {},
+            severity: "high",
+            alertName: "Processing...",
+            description: null,
+            additionalConfiguration: null,
+            downTime: receivedAt,
+            aliasId: null,
+            pipelineStatus: "queued",
+            rawPayload,
+        });
+        alarmId = placeholderRow.id;
+        // Non-fatal pipeline event recording
+        await pipelineEventModel.append({
+            alarmId,
+            stage: "queue",
+            status: "ok",
+            meta: { sourceId, sourceType, receivedAt, jobId: job.id },
+        }).catch((e) => console.warn("[AlarmPipelineWorker] Stage 0 event append failed (non-fatal):", e?.message));
+        // Emit real-time event so UI updates immediately without polling
+        if (realtimePublisher) {
+            try {
+                realtimePublisher.emit({
+                    topic: "alert:created",
+                    ts: new Date().toISOString(),
+                    payload: { alert: placeholderRow },
+                });
+            }
+            catch { /* best-effort */ }
+        }
+        // ── Stage 1+2: Normalization ─────────────────────────────────────────────
+        const canonical = await normalizationService.normalize({
+            alarmId,
+            sourceId,
+            sourceType,
+            sourceName,
+            rawPayload,
+            receivedAt,
+            tenantId,
+        });
+        if (!canonical) {
+            // Normalization failed — mark alarm as dlq, stop processing
+            await alertModel.update(alarmId, { pipelineStatus: "dlq" }).catch(() => { });
+            await pipelineEventModel.append({ alarmId, stage: "dlq", status: "error", meta: { reason: "normalization_failed" } }).catch(() => { });
+            return;
+        }
+        // Update placeholder alarm with normalized fields
+        await alertModel.update(alarmId, {
+            resourceId: canonical.resourceId,
+            resourceName: canonical.resourceName,
+            resourceType: canonical.resourceType,
+            accountId: canonical.accountId ?? null,
+            accountName: canonical.accountName ?? null,
+            alertName: canonical.alertName,
+            severity: canonical.severity,
+            description: canonical.description ?? null,
+            tags: canonical.tags ?? {},
+            downTime: new Date(canonical.downTime),
+            fingerprint: canonical.fingerprint,
+            rawPayload: canonical.rawPayload,
+            pipelineStatus: "normalised",
+            additionalConfiguration: canonical.additionalConfiguration ?? null,
+            // Ensure tenantId is set after normalization (in case it was null from placeholder)
+            ...(tenantId ? { tenantId } : {}),
+        }).catch((err) => {
+            console.warn("[AlarmPipelineWorker] Could not update alarm after normalization:", err?.message);
+        });
+        // ── Stage 3: Dedup ───────────────────────────────────────────────────────
+        let dedupResult;
+        try {
+            dedupResult = await dedupService.check(canonical, alarmId);
+        }
+        catch (err) {
+            // Dedup failure is non-fatal — continue to grouping
+            console.warn("[AlarmPipelineWorker] Dedup check failed (non-fatal):", err?.message);
+            dedupResult = { suppressed: false, dedupKey: "", reason: "dedup_error" };
+        }
+        if (dedupResult.suppressed) {
+            // P7: Suppressed alarms do NOT enter grouping
+            // Instead of keeping a duplicate alert, we add info to the main alert and delete this placeholder
+            if (dedupResult.mainAlarmId) {
+                try {
+                    const mainAlarm = await alertModel.findById(dedupResult.mainAlarmId);
+                    if (mainAlarm) {
+                        await alertModel.update(dedupResult.mainAlarmId, {
+                            dupCount: (mainAlarm.dupCount ?? 0) + 1,
+                            lastDupAt: new Date(),
+                        });
+                    }
+                }
+                catch (err) {
+                    console.warn("[AlarmPipelineWorker] Failed to update main alert with dup info:", err?.message);
+                }
+            }
+            // Delete the placeholder so duplicates don't clutter the UI
+            if (alarmId) {
+                await alertModel.delete(alarmId).catch(() => { });
+            }
+            return;
+        }
+        let finalSeverity = canonical.severity;
+        if (dedupResult.flapState === "elevate_severity") {
+            const SEVERITIES = ["info", "low", "medium", "high", "critical"];
+            const idx = SEVERITIES.indexOf((canonical.severity || "info").toLowerCase());
+            if (idx >= 0 && idx < SEVERITIES.length - 1) {
+                finalSeverity = SEVERITIES[idx + 1];
+            }
+            else if (idx === -1) {
+                finalSeverity = "high"; // Fallback if unknown
+            }
+            canonical.severity = finalSeverity;
+        }
+        // Update alarm with dedup key and status (and potentially elevated severity)
+        await alertModel.update(alarmId, {
+            pipelineStatus: "dedup_passed",
+            dedupKey: dedupResult.dedupKey,
+            severity: finalSeverity,
+        }).catch(() => { });
+        // ── Stage 4: Grouping ────────────────────────────────────────────────────
+        let groupId;
+        try {
+            const groupingResult = await groupingService.assign(canonical, alarmId);
+            groupId = groupingResult.groupId;
+            // Fetch group config to calculate group name if needed
+            let groupName = "";
+            if (groupingResult.groupNameTemplate) {
+                groupName = groupingResult.groupNameTemplate
+                    .replace(/{{resourceName}}/g, canonical.resourceName ?? "Unknown")
+                    .replace(/{{alertName}}/g, canonical.alertName ?? "Alert")
+                    .replace(/{{severity}}/g, finalSeverity)
+                    .replace(/{{count}}/g, "1+");
+            }
+            else {
+                groupName = groupingResult.matchedStrategyLabel || "Group: " + (canonical.resourceName ?? "Unknown");
+            }
+            const currentConfig = canonical.additionalConfiguration || {};
+            // Update alarm with its group ID and computed groupName
+            await alertModel.update(alarmId, {
+                pipelineStatus: "routed",
+                groupId,
+                additionalConfiguration: {
+                    ...currentConfig,
+                    groupName
+                }
+            }).catch(() => { });
+        }
+        catch (err) {
+            // Grouping failure is non-fatal — continue to workflow routing
+            console.warn("[AlarmPipelineWorker] Stage 4 grouping failed (non-fatal):", err?.message);
+            // Update pipeline status to routed since it bypassed grouping
+            await alertModel.update(alarmId, { pipelineStatus: "routed" }).catch(() => { });
+        }
+        // ── Stage 5: Workflow routing ──────────────────────────────────────────
+        if (workflowService) {
+            try {
+                const savedAlert = await alertModel.findById(alarmId);
+                if (savedAlert) {
+                    let lockKey = null;
+                    const redis = getRedisClient();
+                    if (groupId && redis) {
+                        lockKey = `lock:group_workflow:${groupId}`;
+                        const acquired = await redis.set(lockKey, "1", "PX", 30000, "NX");
+                        if (!acquired) {
+                            // Wait a bit to see if another worker processes it, but ideally we wait via a retry.
+                            // For now, if we can't get the lock, we just wait a bit and proceed, or we could delay the job.
+                            // Actually, if we just wait for the lock:
+                            for (let i = 0; i < 30; i++) {
+                                const gotLock = await redis.set(lockKey, "1", "PX", 30000, "NX");
+                                if (gotLock) {
+                                    break;
+                                }
+                                await new Promise(r => setTimeout(r, 1000));
+                            }
+                        }
+                    }
+                    try {
+                        // Now we safely execute the workflow for this alert.
+                        let existingIncidentId = null;
+                        if (groupId) {
+                            try {
+                                const { db } = alertModel;
+                                const groupRes = await db.execute(sql `SELECT incident_id FROM meyiconnect.insight_alarm_groups WHERE id = ${groupId}`);
+                                if (groupRes.rows.length > 0 && groupRes.rows[0].incident_id) {
+                                    existingIncidentId = groupRes.rows[0].incident_id;
+                                }
+                            }
+                            catch (e) {
+                                console.error("[AlarmPipelineWorker] Failed to fetch existing group incident:", e);
+                            }
+                        }
+                        // Always link to existing incident if one exists for the group
+                        if (existingIncidentId) {
+                            try {
+                                const { db } = alertModel;
+                                await db.execute(sql `UPDATE meyiconnect.insight_alerts SET status = 'converted', incident_id = ${existingIncidentId}, converted_incident_id = ${existingIncidentId} WHERE id = ${savedAlert.id}`);
+                                // Refresh the incident title to reflect the updated member count
+                                if (groupId) {
+                                    await groupingService.refreshIncidentTitle(groupId, existingIncidentId);
+                                }
+                            }
+                            catch (e) {
+                                console.error("[AlarmPipelineWorker] Failed to link alert to existing incident:", e);
+                            }
+                        }
+                        const isGroupedAlert = !!groupId;
+                        // Note: The workflow service will check if the group already has an incident!
+                        const execution = await workflowService.evaluateAndExecute(savedAlert, existingIncidentId, isGroupedAlert);
+                        if (execution && Array.isArray(execution.actionsExecuted)) {
+                            if (!existingIncidentId) {
+                                const createIncidentAction = execution.actionsExecuted.find((a) => a.action === 'create_incident' && a.result?.status === 'success');
+                                if (createIncidentAction?.result?.incidentId && groupId) {
+                                    // Update all members of the group to be linked to this incident.
+                                    const updatePayload = {
+                                        status: "converted",
+                                        incidentId: createIncidentAction.result.incidentId,
+                                        convertedIncidentId: createIncidentAction.result.incidentId,
+                                    };
+                                    try {
+                                        const { db } = alertModel;
+                                        await db.execute(sql `UPDATE meyiconnect.insight_alerts SET status = ${updatePayload.status}, incident_id = ${updatePayload.incidentId}, converted_incident_id = ${updatePayload.incidentId} WHERE group_id = ${groupId}`);
+                                        // Don't set group to flushed, it will be handled by the group-close sliding window job
+                                        await db.execute(sql `UPDATE meyiconnect.insight_alarm_groups SET incident_id = ${updatePayload.incidentId} WHERE id = ${groupId}`);
+                                    }
+                                    catch (e) {
+                                        console.error("[AlarmPipelineWorker] Failed to batch link incident:", e);
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    finally {
+                        if (lockKey && redis) {
+                            await redis.del(lockKey).catch(() => { });
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                console.warn("[AlarmPipelineWorker] Stage 5 workflow routing failed (non-fatal):", err?.message);
+            }
+        }
+        await pipelineEventModel.append({
+            alarmId,
+            stage: "workflow",
+            status: "ok",
+            meta: { alarmId },
+        }).catch(() => { });
+    }, {
+        connection: {
+            ...connOpts,
+            maxRetriesPerRequest: null,
+            enableReadyCheck: false,
+            // Give ioredis plenty of time to reconnect before giving up
+            retryStrategy: (times) => Math.min(times * 500, 10_000),
+        },
+        concurrency: PIPELINE_CONCURRENCY,
+        // Extend lock duration so jobs don't get marked stalled mid-processing
+        lockDuration: LOCK_DURATION_MS,
+        // Renew lock every 1/3 of lock duration
+        lockRenewTime: Math.floor(LOCK_DURATION_MS / 3),
+        // Check for stalled jobs every 15s so they're requeued quickly
+        stalledInterval: 15_000,
+    });
+    worker.on("completed", (job) => {
+        console.info(`[AlarmPipelineWorker] Job ${job.id} completed (source: ${job.data.sourceId})`);
+    });
+    worker.on("failed", async (job, err) => {
+        const errorMsg = err?.message ?? String(err);
+        const errorStack = err?.stack ?? "";
+        console.error(`[AlarmPipelineWorker] Job ${job?.id} failed (attempt ${job?.attemptsMade ?? "?"}/${job?.opts?.attempts ?? "?"}): ${errorMsg}`, errorStack ? `\n${errorStack}` : "");
+        // Record DLQ event for observability
+        await pipelineEventModel.append({
+            alarmId: null,
+            stage: "dlq",
+            status: "error",
+            meta: {
+                jobId: job?.id,
+                error: errorMsg,
+                attemptsMade: job?.attemptsMade,
+                sourceId: job?.data?.sourceId,
+                sourceType: job?.data?.sourceType,
+                receivedAt: job?.data?.receivedAt,
+            },
+        }).catch(() => { });
+    });
+    worker.on("error", (err) => {
+        // These fire on Redis connection issues — the worker auto-reconnects.
+        // Log the full error so we can distinguish connection errors from logic errors.
+        const errorMsg = err?.message ?? String(err);
+        if (errorMsg) {
+            console.error("[AlarmPipelineWorker] Worker connection error:", errorMsg);
+        }
+        else {
+            // BullMQ emits empty-message errors during internal reconnect cycles — suppress noise
+            console.debug("[AlarmPipelineWorker] Worker connection event (reconnecting)");
+        }
+    });
+    worker.on("stalled", (jobId) => {
+        console.warn(`[AlarmPipelineWorker] Job ${jobId} stalled — will be requeued automatically`);
+    });
+    console.info(`[AlarmPipelineWorker] Started with concurrency=${PIPELINE_CONCURRENCY}, lockDuration=${LOCK_DURATION_MS}ms`);
+    return worker;
+}
+//# sourceMappingURL=AlarmPipelineWorker.js.map

package/dist/pipeline/AlarmPipelineWorker.js.map

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

package/dist/pipeline/CanonicalAlarm.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+export declare const AlarmStateSchema: z.ZodEnum<{
+    unknown: "unknown";
+    resolved: "resolved";
+    firing: "firing";
+}>;
+export type AlarmState = z.infer<typeof AlarmStateSchema>;
+export declare const CanonicalAlarmSchema: z.ZodObject<{
+    source: z.ZodString;
+    tenantId: z.ZodDefault<z.ZodString>;
+    resourceId: z.ZodString;
+    resourceName: z.ZodString;
+    resourceType: z.ZodString;
+    alertName: z.ZodString;
+    severity: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        resolved: "resolved";
+        firing: "firing";
+    }>;
+    metricName: z.ZodOptional<z.ZodString>;
+    metricValue: z.ZodOptional<z.ZodString>;
+    metricUnit: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    accountId: z.ZodOptional<z.ZodString>;
+    accountName: z.ZodOptional<z.ZodString>;
+    fingerprint: z.ZodString;
+    downTime: z.ZodString;
+    rawPayload: z.ZodOptional<z.ZodUnknown>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    sourceName: z.ZodOptional<z.ZodString>;
+    additionalConfiguration: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type CanonicalAlarm = z.infer<typeof CanonicalAlarmSchema>;
+/**
+ * Build the human-readable fingerprint shown in the Alarm list UI.
+ * Format: <source_prefix>|<resource_id>|<metric_name>|<state>
+ * Example: cw|i-0abc12|cpu_utilization|firing
+ */
+export declare function buildFingerprint(alarm: {
+    source?: string;
+    resourceId?: string;
+    metricName?: string;
+    alertName?: string;
+    state?: string;
+}): string;
+export declare const PipelineJobDataSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    sourceType: z.ZodString;
+    sourceName: z.ZodOptional<z.ZodString>;
+    tenantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    rawPayload: z.ZodUnknown;
+    receivedAt: z.ZodString;
+    token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PipelineJobData = z.infer<typeof PipelineJobDataSchema>;
+//# sourceMappingURL=CanonicalAlarm.d.ts.map

package/dist/pipeline/CanonicalAlarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanonicalAlarm.d.ts","sourceRoot":"","sources":["../../src/pipeline/CanonicalAlarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;EAA4C,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAU1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2C/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAeT;AAOD,eAAO,MAAM,qBAAqB;;;;;;;;iBAQhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/pipeline/CanonicalAlarm.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+// ─── Canonical Alarm State ────────────────────────────────────────────────────
+export const AlarmStateSchema = z.enum(["firing", "resolved", "unknown"]);
+// ─── Canonical Alarm Envelope ─────────────────────────────────────────────────
+//
+// The contract between Stage 2 (Normalization) and every downstream stage
+// (Dedup, Grouping, Workflow Routing). Every alarm, regardless of source,
+// must produce this structure after normalization.
+//
+// Fingerprint format shown in UI: cw|i-0abc12|cpu_utilization|firing
+export const CanonicalAlarmSchema = z.object({
+    // Source identification
+    source: z.string(), // source type: 'cloudwatch' | 'grafana' | 'datadog' | 'prometheus' | etc.
+    tenantId: z.string().default("default"), // Single-tenant now — placeholder for future multi-tenancy (Q2)
+    // Resource
+    resourceId: z.string(),
+    resourceName: z.string(),
+    resourceType: z.string(),
+    // Alert metadata
+    alertName: z.string(),
+    severity: z.string(), // 'critical' | 'high' | 'medium' | 'low'
+    description: z.string().optional(),
+    state: AlarmStateSchema, // 'firing' | 'resolved' | 'unknown'
+    // Metric details (optional — not all sources provide these)
+    metricName: z.string().optional(),
+    metricValue: z.string().optional(),
+    metricUnit: z.string().optional(),
+    // Generic key-value tags
+    tags: z.record(z.string(), z.string()).default({}),
+    labels: z.record(z.string(), z.string()).optional(),
+    // AWS Account ID & Name
+    accountId: z.string().optional(),
+    accountName: z.string().optional(),
+    // Fingerprint — display format e.g. "cw|i-0abc12|cpu_utilization|firing"
+    // Built by buildFingerprint() below. Used in the Alarm list UI.
+    fingerprint: z.string(),
+    // Timing
+    downTime: z.string(), // ISO 8601
+    // Raw payload preserved for audit / fallback normalization
+    rawPayload: z.unknown().optional(),
+    // Pipeline metadata (set by the worker, not normalization)
+    sourceId: z.string().optional(),
+    sourceName: z.string().optional(),
+    additionalConfiguration: z.unknown().optional(),
+});
+// ─── Fingerprint Builder ──────────────────────────────────────────────────────
+/**
+ * Build the human-readable fingerprint shown in the Alarm list UI.
+ * Format: <source_prefix>|<resource_id>|<metric_name>|<state>
+ * Example: cw|i-0abc12|cpu_utilization|firing
+ */
+export function buildFingerprint(alarm) {
+    const src = String(alarm.source || "unknown").trim();
+    const prefix = src.slice(0, 2).toLowerCase() || "un";
+    const resource = String(alarm.resourceId || "unknown")
+        .trim()
+        .replace(/[\s/\\:]+/g, "_")
+        .toLowerCase()
+        .slice(0, 40);
+    const metric = String(alarm.metricName ?? alarm.alertName ?? "unknown")
+        .trim()
+        .replace(/[\s/\\:]+/g, "_")
+        .toLowerCase()
+        .slice(0, 40);
+    const state = String(alarm.state || "firing").trim().toLowerCase();
+    return `${prefix}|${resource}|${metric}|${state}`;
+}
+// ─── Pipeline Job Payload ─────────────────────────────────────────────────────
+//
+// Shape of the BullMQ job data enqueued by the webhook handler (Stage 0).
+// The worker deserialises this and passes it through the pipeline stages.
+export const PipelineJobDataSchema = z.object({
+    sourceId: z.string(),
+    sourceType: z.string(),
+    sourceName: z.string().optional(),
+    tenantId: z.string().nullish(), // Propagated from source so pipeline alerts have the right tenant
+    rawPayload: z.unknown(),
+    receivedAt: z.string(), // ISO 8601
+    token: z.string().optional(), // For fallback error logging
+});
+//# sourceMappingURL=CanonicalAlarm.js.map

package/dist/pipeline/CanonicalAlarm.js.map

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

package/dist/pipeline/DedupService.d.ts

@@ -0,0 +1,29 @@
+import type { DedupConfigModel } from "../models/dedup-config.model.js";
+import type { PipelineEventModel } from "../models/pipeline-event.model.js";
+import type { CanonicalAlarm } from "./CanonicalAlarm.js";
+export interface DedupResult {
+    suppressed: boolean;
+    dedupKey: string;
+    configId?: string;
+    reason: string;
+    mainAlarmId?: string;
+    flapState?: string;
+}
+export declare class DedupService {
+    private dedupConfigModel;
+    private pipelineEventModel;
+    constructor(dedupConfigModel: DedupConfigModel, pipelineEventModel: PipelineEventModel);
+    /**
+     * Stage 3: Check whether this alarm is a duplicate.
+     *
+     * Returns { suppressed: true } if it is — the caller stops processing.
+     * Returns { suppressed: false } if it's fresh — the caller continues to grouping.
+     *
+     * P7 fix: suppressed alarms are NOT passed to GroupingService.
+     */
+    check(alarm: CanonicalAlarm, alarmId: string): Promise<DedupResult>;
+    private checkViaRedis;
+    private recordFlapIfNeeded;
+    private checkViaDb;
+}
+//# sourceMappingURL=DedupService.d.ts.map

package/dist/pipeline/DedupService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DedupService.d.ts","sourceRoot":"","sources":["../../src/pipeline/DedupService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,kBAAkB;gBADlB,gBAAgB,EAAE,gBAAgB,EAClC,kBAAkB,EAAE,kBAAkB;IAGhD;;;;;;;OAOG;IACG,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAwD3D,aAAa;YAsEb,kBAAkB;YA0BlB,UAAU;CA8CzB"}