reflectt-node 0.1.0

package/dist/alert-integrity.js

@@ -0,0 +1,333 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Alert Integrity Guard — Preflight Reconciliation
+ *
+ * P0-2 implementation for task-1771849175579-apuqqi0fd
+ *
+ * Before publishing any task-scoped alert, reconciles live task state
+ * to prevent false-positive SLA/requeue/stale alerts.
+ *
+ * Preflight checks:
+ *   1. Task still exists and is in the expected status
+ *   2. Assignee/reviewer haven't changed since alert was generated
+ *   3. Recent activity (comment ts) might invalidate the alert
+ *   4. Idempotent key prevents duplicate alerts
+ *
+ * All preflight decisions are logged for audit + missed-alert sampling.
+ */
+import { createHash } from 'crypto';
+import { taskManager } from './tasks.js';
+// ── Default Config ─────────────────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    enabled: true,
+    canaryMode: true, // Start in canary mode
+    recentActivityWindowMs: 5 * 60 * 1000, // 5 minutes
+    dedupWindowMs: 15 * 60 * 1000, // 15 minutes
+    bypassTypes: ['escalation'], // Critical escalations always go through
+    maxDedupEntries: 1000,
+};
+// ── Alert Integrity Guard ──────────────────────────────────────────────────
+export class AlertIntegrityGuard {
+    config;
+    dedupCache = new Map(); // idempotent_key → timestamp
+    auditLog = [];
+    latencies = [];
+    stats = {
+        totalChecked: 0,
+        totalAllowed: 0,
+        totalSuppressed: 0,
+        suppressionsByReason: {},
+        canaryWouldSuppress: 0,
+        avgLatencyMs: 0,
+        p95LatencyMs: 0,
+    };
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // ── Core: Preflight Check ──────────────────────────────────────────────
+    /**
+     * Run preflight reconciliation for a task-scoped alert.
+     * Returns whether the alert should be published.
+     */
+    preflight(input) {
+        const start = Date.now();
+        this.stats.totalChecked++;
+        // 0. Bypass types always pass
+        if (this.config.bypassTypes.includes(input.alertType)) {
+            const result = {
+                allowed: true,
+                reason: `Alert type "${input.alertType}" bypasses preflight`,
+                reasonCode: 'allowed',
+                latencyMs: Date.now() - start,
+            };
+            this.recordResult(input, result);
+            return result;
+        }
+        if (!this.config.enabled) {
+            const result = {
+                allowed: true,
+                reason: 'Preflight disabled',
+                reasonCode: 'allowed',
+                latencyMs: Date.now() - start,
+            };
+            this.recordResult(input, result);
+            return result;
+        }
+        // 1. Check task exists
+        let task;
+        try {
+            task = taskManager.getTask(input.taskId);
+        }
+        catch {
+            task = null;
+        }
+        if (!task) {
+            const result = {
+                allowed: false,
+                reason: `Task ${input.taskId} not found — alert suppressed`,
+                reasonCode: 'task_not_found',
+                latencyMs: Date.now() - start,
+            };
+            return this.maybeCanary(input, result);
+        }
+        // Build live state
+        const liveState = this.buildLiveState(task);
+        // 2. Check if task is done — suppress stale alerts for completed work
+        if (task.status === 'done' && input.alertType !== 'escalation') {
+            const result = {
+                allowed: false,
+                reason: `Task ${input.taskId} is done — alert "${input.alertType}" suppressed`,
+                reasonCode: 'task_done',
+                liveState,
+                latencyMs: Date.now() - start,
+            };
+            return this.maybeCanary(input, result);
+        }
+        // 3. Check status change — if expected status doesn't match, alert may be stale
+        if (input.expectedState?.status && task.status !== input.expectedState.status) {
+            const result = {
+                allowed: false,
+                reason: `Task status changed: expected "${input.expectedState.status}" but live is "${task.status}" — alert suppressed`,
+                reasonCode: 'status_changed',
+                liveState,
+                latencyMs: Date.now() - start,
+            };
+            return this.maybeCanary(input, result);
+        }
+        // 4. Check assignee/reviewer change
+        if (input.expectedState?.assignee && task.assignee !== input.expectedState.assignee) {
+            const result = {
+                allowed: false,
+                reason: `Task assignee changed: expected "${input.expectedState.assignee}" but live is "${task.assignee}" — alert suppressed`,
+                reasonCode: 'assignee_changed',
+                liveState,
+                latencyMs: Date.now() - start,
+            };
+            return this.maybeCanary(input, result);
+        }
+        // 5. Check recent activity — if task was just commented on, alert may be obsolete
+        if (liveState.lastCommentTs) {
+            const timeSinceComment = Date.now() - liveState.lastCommentTs;
+            if (timeSinceComment < this.config.recentActivityWindowMs) {
+                const result = {
+                    allowed: false,
+                    reason: `Task has recent activity (${Math.round(timeSinceComment / 1000)}s ago) — alert may be stale`,
+                    reasonCode: 'recent_activity',
+                    liveState,
+                    latencyMs: Date.now() - start,
+                };
+                return this.maybeCanary(input, result);
+            }
+        }
+        // 6. Idempotent dedup check
+        const idempotentKey = this.computeIdempotentKey(input.taskId, input.alertType, liveState.stateHash);
+        const lastSent = this.dedupCache.get(idempotentKey);
+        if (lastSent && (Date.now() - lastSent) < this.config.dedupWindowMs) {
+            const result = {
+                allowed: false,
+                reason: `Duplicate alert (same task + type + state hash) sent ${Math.round((Date.now() - lastSent) / 1000)}s ago`,
+                reasonCode: 'duplicate',
+                liveState,
+                latencyMs: Date.now() - start,
+            };
+            return this.maybeCanary(input, result);
+        }
+        // Update dedup cache
+        this.dedupCache.set(idempotentKey, Date.now());
+        this.pruneDedupCache();
+        // All checks passed — allow
+        const result = {
+            allowed: true,
+            reason: 'Preflight passed — all checks OK',
+            reasonCode: 'allowed',
+            liveState,
+            latencyMs: Date.now() - start,
+        };
+        this.recordResult(input, result);
+        return result;
+    }
+    // ── State Helpers ──────────────────────────────────────────────────────
+    buildLiveState(task) {
+        // Get latest comment timestamp
+        let lastCommentTs = null;
+        try {
+            const comments = taskManager.getTaskComments(task.id);
+            if (comments && comments.length > 0) {
+                lastCommentTs = Math.max(...comments.map((c) => c.timestamp || 0));
+            }
+        }
+        catch { /* ok */ }
+        // Compute state hash for idempotent key
+        const stateHash = this.computeStateHash(task);
+        return {
+            status: task.status,
+            assignee: task.assignee || '',
+            reviewer: task.reviewer || task.metadata?.reviewer || '',
+            lastCommentTs,
+            stateHash,
+        };
+    }
+    computeStateHash(task) {
+        const stateStr = [
+            task.status,
+            task.assignee || '',
+            task.reviewer || task.metadata?.reviewer || '',
+            task.updatedAt || task.createdAt || '',
+        ].join('|');
+        return createHash('sha256').update(stateStr).digest('hex').substring(0, 12);
+    }
+    computeIdempotentKey(taskId, alertType, stateHash) {
+        return `${taskId}:${alertType}:${stateHash}`;
+    }
+    // ── Canary Mode ────────────────────────────────────────────────────────
+    maybeCanary(input, result) {
+        if (this.config.canaryMode) {
+            this.stats.canaryWouldSuppress++;
+            const canaryResult = {
+                ...result,
+                allowed: true,
+                reason: `canary_would_suppress: ${result.reason}`,
+                reasonCode: 'canary_allowed',
+            };
+            this.recordResult(input, canaryResult);
+            return canaryResult;
+        }
+        this.stats.totalSuppressed++;
+        this.stats.suppressionsByReason[result.reasonCode] =
+            (this.stats.suppressionsByReason[result.reasonCode] || 0) + 1;
+        this.recordResult(input, result);
+        return result;
+    }
+    // ── Recording & Audit ──────────────────────────────────────────────────
+    recordResult(input, result) {
+        if (result.allowed) {
+            this.stats.totalAllowed++;
+        }
+        // Track latency
+        this.latencies.push(result.latencyMs);
+        if (this.latencies.length > 1000)
+            this.latencies.splice(0, 500);
+        this.updateLatencyStats();
+        // Audit log
+        this.auditLog.push({
+            timestamp: Date.now(),
+            taskId: input.taskId,
+            alertType: input.alertType,
+            result,
+        });
+        if (this.auditLog.length > 500) {
+            this.auditLog.splice(0, this.auditLog.length - 500);
+        }
+        if (!result.allowed || result.reasonCode === 'canary_allowed') {
+            console.log(`[AlertIntegrity] ${result.reasonCode}: task=${input.taskId} type=${input.alertType} reason="${result.reason}"`);
+        }
+    }
+    updateLatencyStats() {
+        if (this.latencies.length === 0)
+            return;
+        const sorted = [...this.latencies].sort((a, b) => a - b);
+        this.stats.avgLatencyMs = Math.round(sorted.reduce((s, v) => s + v, 0) / sorted.length);
+        this.stats.p95LatencyMs = sorted[Math.floor(sorted.length * 0.95)] || 0;
+    }
+    pruneDedupCache() {
+        if (this.dedupCache.size <= this.config.maxDedupEntries)
+            return;
+        const now = Date.now();
+        for (const [key, ts] of this.dedupCache) {
+            if (now - ts > this.config.dedupWindowMs) {
+                this.dedupCache.delete(key);
+            }
+        }
+        // If still over limit, remove oldest
+        if (this.dedupCache.size > this.config.maxDedupEntries) {
+            const entries = [...this.dedupCache.entries()].sort((a, b) => a[1] - b[1]);
+            const toRemove = entries.slice(0, entries.length - this.config.maxDedupEntries);
+            for (const [key] of toRemove) {
+                this.dedupCache.delete(key);
+            }
+        }
+    }
+    // ── Public API ─────────────────────────────────────────────────────────
+    getStats() {
+        return { ...this.stats };
+    }
+    getAuditLog(options) {
+        let log = this.auditLog;
+        if (options?.taskId) {
+            log = log.filter(e => e.taskId === options.taskId);
+        }
+        if (options?.since) {
+            log = log.filter(e => e.timestamp >= options.since);
+        }
+        log = log.slice().sort((a, b) => b.timestamp - a.timestamp);
+        if (options?.limit) {
+            log = log.slice(0, options.limit);
+        }
+        return log;
+    }
+    /**
+     * Get rollback signals for canary evaluation.
+     */
+    getRollbackSignals() {
+        // Missed true positives would need external adjudication
+        // For now, track critical alert suppression as a proxy
+        const criticalSuppressed = this.auditLog.filter(e => e.alertType === 'escalation' && !e.result.allowed).length;
+        return {
+            missedTruePositives: 0, // Requires manual sampling/adjudication
+            p95LatencyMs: this.stats.p95LatencyMs,
+            criticalAlertErrors: criticalSuppressed,
+            rollbackTriggered: criticalSuppressed >= 3 || this.stats.p95LatencyMs > 500,
+        };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    updateConfig(updates) {
+        this.config = { ...this.config, ...updates };
+        console.log('[AlertIntegrity] Config updated:', JSON.stringify(updates));
+    }
+    /** Exit canary mode — start enforcing suppression */
+    activateEnforcement() {
+        this.config.canaryMode = false;
+        console.log('[AlertIntegrity] Canary mode OFF — enforcement active');
+    }
+    /** Reset stats (for testing) */
+    resetStats() {
+        this.stats = {
+            totalChecked: 0,
+            totalAllowed: 0,
+            totalSuppressed: 0,
+            suppressionsByReason: {},
+            canaryWouldSuppress: 0,
+            avgLatencyMs: 0,
+            p95LatencyMs: 0,
+        };
+        this.latencies = [];
+        this.dedupCache.clear();
+        this.auditLog = [];
+    }
+}
+// ── Singleton ──────────────────────────────────────────────────────────────
+export const alertIntegrityGuard = new AlertIntegrityGuard();
+//# sourceMappingURL=alert-integrity.js.map

package/dist/alert-integrity.js.map

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

package/dist/alert-preflight.d.ts

@@ -0,0 +1,40 @@
+export interface PreflightInput {
+    taskId: string;
+    alertType: string;
+    /** Agent the alert concerns (assignee/reviewer) */
+    agentId?: string;
+    /** Expected task status when alert was triggered */
+    expectedStatus?: string;
+    /** Expected assignee when alert was triggered */
+    expectedAssignee?: string;
+    /** Expected reviewer when alert was triggered */
+    expectedReviewer?: string;
+    /** Alert message content (for audit trail) */
+    content?: string;
+    /** Channel the alert would be posted to */
+    channel?: string;
+}
+export interface PreflightResult {
+    proceed: boolean;
+    reason?: string;
+    latencyMs: number;
+    idempotentKey: string;
+    mode: PreflightMode;
+}
+export type PreflightMode = 'canary' | 'enforce' | 'off';
+export declare function getPreflightMode(): PreflightMode;
+/**
+ * Run preflight check before publishing an alert.
+ * Returns whether the alert should proceed.
+ */
+export declare function preflightCheck(input: PreflightInput): PreflightResult;
+export declare function getPreflightMetrics(): {
+    totalChecked: number;
+    suppressed: number;
+    canaryFlagged: number;
+    latencyP95: number;
+    mode: PreflightMode;
+};
+/** Reset metrics (for testing) */
+export declare function resetPreflightMetrics(): void;
+//# sourceMappingURL=alert-preflight.d.ts.map

package/dist/alert-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-preflight.d.ts","sourceRoot":"","sources":["../src/alert-preflight.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,aAAa,CAAA;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;AAoCxD,wBAAgB,gBAAgB,IAAI,aAAa,CAIhD;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAkDrE;AA6JD,wBAAgB,mBAAmB,IAAI;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,aAAa,CAAA;CACpB,CAYA;AAED,kCAAkC;AAClC,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C"}

package/dist/alert-preflight.js

@@ -0,0 +1,235 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Alert-integrity preflight guard
+ *
+ * Reconciles live task/agent state before publishing alerts.
+ * Eliminates false-positive SLA/requeue/stale alerts by verifying
+ * the condition still holds at publish time.
+ *
+ * Modes (ALERT_PREFLIGHT_MODE env var):
+ *   - canary:  log what would be suppressed, still send (default)
+ *   - enforce: actually suppress false positives
+ *   - off:     bypass entirely
+ */
+import { createHash } from 'crypto';
+import { appendFileSync } from 'fs';
+import { join } from 'path';
+import { DATA_DIR } from './config.js';
+import { taskManager } from './tasks.js';
+// ── Constants ──────────────────────────────────────────────────────────────
+/** Recent activity window — if a comment/update was within this window, suppress stale alerts */
+const RECENT_ACTIVITY_WINDOW_MS = 5 * 60 * 1000; // 5 minutes
+/** Idempotent key dedup window */
+const DEDUP_WINDOW_MS = 15 * 60 * 1000; // 15 minutes
+/** Max latency samples to keep for p95 calculation */
+const MAX_LATENCY_SAMPLES = 1000;
+const AUDIT_FILE = join(DATA_DIR, 'alert-preflight-audit.jsonl');
+// ── State ──────────────────────────────────────────────────────────────────
+const metrics = {
+    totalChecked: 0,
+    suppressed: 0,
+    canaryFlagged: 0,
+    latencies: [],
+};
+/** Map of idempotentKey → timestamp for dedup */
+const recentKeys = new Map();
+// ── Mode ───────────────────────────────────────────────────────────────────
+export function getPreflightMode() {
+    const mode = (process.env.ALERT_PREFLIGHT_MODE || 'canary').toLowerCase();
+    if (mode === 'enforce' || mode === 'off' || mode === 'canary')
+        return mode;
+    return 'canary';
+}
+// ── Core ───────────────────────────────────────────────────────────────────
+/**
+ * Run preflight check before publishing an alert.
+ * Returns whether the alert should proceed.
+ */
+export function preflightCheck(input) {
+    const start = performance.now();
+    const mode = getPreflightMode();
+    // Off mode — bypass entirely
+    if (mode === 'off') {
+        return {
+            proceed: true,
+            reason: 'preflight disabled',
+            latencyMs: performance.now() - start,
+            idempotentKey: '',
+            mode,
+        };
+    }
+    metrics.totalChecked++;
+    // 1. Compute state hash for idempotent key
+    const stateHash = computeStateHash(input);
+    const idempotentKey = `${input.taskId}:${input.alertType}:${stateHash}`;
+    // 2. Check idempotent key dedup
+    const now = Date.now();
+    pruneExpiredKeys(now);
+    if (recentKeys.has(idempotentKey)) {
+        const result = buildResult(false, 'duplicate alert (idempotent key exists)', start, idempotentKey, mode);
+        recordSuppression(input, result, 'dedup');
+        return result;
+    }
+    // 3. Reconcile live task state
+    const reconciliation = reconcileLiveState(input, now);
+    if (!reconciliation.valid) {
+        const result = buildResult(false, reconciliation.reason, start, idempotentKey, mode);
+        recordSuppression(input, result, 'stale_state');
+        return result;
+    }
+    // 4. Alert passes preflight — record the key
+    recentKeys.set(idempotentKey, now);
+    const latencyMs = performance.now() - start;
+    recordLatency(latencyMs);
+    return {
+        proceed: true,
+        latencyMs,
+        idempotentKey,
+        mode,
+    };
+}
+function reconcileLiveState(input, now) {
+    const task = input.taskId ? taskManager.getTask(input.taskId) : undefined;
+    // If task doesn't exist, let the alert through (might be a system alert)
+    if (!input.taskId || !task) {
+        return { valid: true };
+    }
+    // Check 1: Status drift — task status changed since alert was triggered
+    if (input.expectedStatus && task.status !== input.expectedStatus) {
+        return {
+            valid: false,
+            reason: `status drift: expected=${input.expectedStatus}, actual=${task.status}`,
+        };
+    }
+    // Check 2: Assignee drift
+    if (input.expectedAssignee && task.assignee !== input.expectedAssignee) {
+        return {
+            valid: false,
+            reason: `assignee drift: expected=${input.expectedAssignee}, actual=${task.assignee}`,
+        };
+    }
+    // Check 3: Reviewer drift
+    if (input.expectedReviewer && task.reviewer !== input.expectedReviewer) {
+        return {
+            valid: false,
+            reason: `reviewer drift: expected=${input.expectedReviewer}, actual=${task.reviewer}`,
+        };
+    }
+    // Check 4: Recent activity — if there's been a comment in the last 5 minutes,
+    // suppress stale/idle alerts (the agent is actively working)
+    if (input.alertType === 'stale' || input.alertType === 'idle' || input.alertType === 'sla_warning') {
+        const comments = taskManager.getTaskComments(input.taskId);
+        if (comments.length > 0) {
+            const lastComment = comments[comments.length - 1];
+            const commentAge = now - (lastComment.timestamp || 0);
+            if (commentAge < RECENT_ACTIVITY_WINDOW_MS) {
+                return {
+                    valid: false,
+                    reason: `recent activity: comment ${Math.round(commentAge / 1000)}s ago (window: ${RECENT_ACTIVITY_WINDOW_MS / 1000}s)`,
+                };
+            }
+        }
+        // Also check task updatedAt
+        if (task.updatedAt && (now - task.updatedAt) < RECENT_ACTIVITY_WINDOW_MS) {
+            return {
+                valid: false,
+                reason: `recent update: task updated ${Math.round((now - task.updatedAt) / 1000)}s ago`,
+            };
+        }
+    }
+    // Check 5: Task already done — suppress alerts for completed tasks
+    if (task.status === 'done') {
+        return {
+            valid: false,
+            reason: `task already done`,
+        };
+    }
+    return { valid: true };
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function computeStateHash(input) {
+    const task = input.taskId ? taskManager.getTask(input.taskId) : undefined;
+    const hashInput = [
+        input.taskId,
+        input.alertType,
+        task?.status || 'unknown',
+        task?.assignee || '',
+        task?.reviewer || '',
+        task?.updatedAt?.toString() || '',
+    ].join(':');
+    return createHash('sha256').update(hashInput).digest('hex').slice(0, 12);
+}
+function buildResult(proceed, reason, startTime, idempotentKey, mode) {
+    const latencyMs = performance.now() - startTime;
+    recordLatency(latencyMs);
+    // In canary mode, flag but still proceed
+    const actualProceed = mode === 'canary' ? true : proceed;
+    if (!proceed && mode === 'canary') {
+        metrics.canaryFlagged++;
+    }
+    if (!proceed && mode === 'enforce') {
+        metrics.suppressed++;
+    }
+    return {
+        proceed: actualProceed,
+        reason: !proceed ? `[${mode}] ${reason}` : reason,
+        latencyMs,
+        idempotentKey,
+        mode,
+    };
+}
+function recordLatency(ms) {
+    metrics.latencies.push(ms);
+    if (metrics.latencies.length > MAX_LATENCY_SAMPLES) {
+        metrics.latencies.shift();
+    }
+}
+function recordSuppression(input, result, category) {
+    const entry = {
+        ts: Date.now(),
+        taskId: input.taskId,
+        alertType: input.alertType,
+        agentId: input.agentId,
+        mode: result.mode,
+        category,
+        reason: result.reason,
+        idempotentKey: result.idempotentKey,
+        proceed: result.proceed,
+    };
+    try {
+        appendFileSync(AUDIT_FILE, JSON.stringify(entry) + '\n');
+    }
+    catch {
+        // Audit file write failure is non-fatal
+    }
+}
+function pruneExpiredKeys(now) {
+    for (const [key, ts] of recentKeys) {
+        if (now - ts > DEDUP_WINDOW_MS) {
+            recentKeys.delete(key);
+        }
+    }
+}
+// ── Metrics ────────────────────────────────────────────────────────────────
+export function getPreflightMetrics() {
+    const sorted = [...metrics.latencies].sort((a, b) => a - b);
+    const p95Index = Math.floor(sorted.length * 0.95);
+    const latencyP95 = sorted.length > 0 ? sorted[p95Index] ?? 0 : 0;
+    return {
+        totalChecked: metrics.totalChecked,
+        suppressed: metrics.suppressed,
+        canaryFlagged: metrics.canaryFlagged,
+        latencyP95: Math.round(latencyP95 * 100) / 100,
+        mode: getPreflightMode(),
+    };
+}
+/** Reset metrics (for testing) */
+export function resetPreflightMetrics() {
+    metrics.totalChecked = 0;
+    metrics.suppressed = 0;
+    metrics.canaryFlagged = 0;
+    metrics.latencies = [];
+    recentKeys.clear();
+}
+//# sourceMappingURL=alert-preflight.js.map

package/dist/alert-preflight.js.map

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