driftdetect-dashboard 0.8.1 → 0.8.2

package/dist/server/pattern-watcher.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pattern Watcher
+ *
+ * Watches the .drift/patterns/ directory for changes and emits events
+ * when patterns are added, updated, or removed.
+ *
+ * @requirements Phase 5 - Dashboard auto-refresh when watch mode updates patterns
+ */
+import { EventEmitter } from 'node:events';
+export interface PatternChangeEvent {
+    type: 'created' | 'updated' | 'deleted';
+    category: string;
+    status: string;
+    timestamp: string;
+}
+export interface PatternWatcherOptions {
+    /** Path to the .drift directory */
+    driftDir: string;
+    /** Debounce delay in milliseconds (default: 500) */
+    debounceMs?: number;
+}
+export declare class PatternWatcher extends EventEmitter {
+    private readonly driftDir;
+    private readonly patternsDir;
+    private readonly debounceMs;
+    private watchers;
+    private debounceTimers;
+    private isWatching;
+    constructor(options: PatternWatcherOptions);
+    /**
+     * Start watching for pattern changes
+     */
+    start(): void;
+    /**
+     * Stop watching for pattern changes
+     */
+    stop(): void;
+    /**
+     * Check if currently watching
+     */
+    get watching(): boolean;
+    /**
+     * Watch a directory for changes
+     */
+    private watchDirectory;
+    /**
+     * Debounce file change events
+     */
+    private debounceChange;
+    /**
+     * Handle a file change event
+     */
+    private handleFileChange;
+}
+//# sourceMappingURL=pattern-watcher.d.ts.map

package/dist/server/pattern-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-watcher.d.ts","sourceRoot":"","sources":["../../src/server/pattern-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,UAAU,CAAkB;gBAExB,OAAO,EAAE,qBAAqB;IAO1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAsBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAsBZ;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA+BzB"}

package/dist/server/pattern-watcher.js

@@ -0,0 +1,157 @@
+/**
+ * Pattern Watcher
+ *
+ * Watches the .drift/patterns/ directory for changes and emits events
+ * when patterns are added, updated, or removed.
+ *
+ * @requirements Phase 5 - Dashboard auto-refresh when watch mode updates patterns
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { EventEmitter } from 'node:events';
+// ============================================================================
+// Pattern Watcher
+// ============================================================================
+export class PatternWatcher extends EventEmitter {
+    driftDir;
+    patternsDir;
+    debounceMs;
+    watchers = [];
+    debounceTimers = new Map();
+    isWatching = false;
+    constructor(options) {
+        super();
+        this.driftDir = options.driftDir;
+        this.patternsDir = path.join(options.driftDir, 'patterns');
+        this.debounceMs = options.debounceMs ?? 500;
+    }
+    /**
+     * Start watching for pattern changes
+     */
+    start() {
+        if (this.isWatching) {
+            return;
+        }
+        this.isWatching = true;
+        // Watch the patterns directory and subdirectories
+        const statusDirs = ['discovered', 'approved', 'ignored'];
+        for (const status of statusDirs) {
+            const statusDir = path.join(this.patternsDir, status);
+            this.watchDirectory(statusDir, status);
+        }
+        // Also watch the index directory for file-map changes
+        const indexDir = path.join(this.driftDir, 'index');
+        this.watchDirectory(indexDir, 'index');
+        this.emit('started');
+    }
+    /**
+     * Stop watching for pattern changes
+     */
+    stop() {
+        if (!this.isWatching) {
+            return;
+        }
+        this.isWatching = false;
+        // Close all watchers
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers = [];
+        // Clear all debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        this.emit('stopped');
+    }
+    /**
+     * Check if currently watching
+     */
+    get watching() {
+        return this.isWatching;
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    /**
+     * Watch a directory for changes
+     */
+    watchDirectory(dirPath, status) {
+        // Ensure directory exists
+        if (!fs.existsSync(dirPath)) {
+            try {
+                fs.mkdirSync(dirPath, { recursive: true });
+            }
+            catch {
+                // Directory might be created later
+                return;
+            }
+        }
+        try {
+            const watcher = fs.watch(dirPath, (eventType, filename) => {
+                if (!filename || !filename.endsWith('.json')) {
+                    return;
+                }
+                // Skip temp files
+                if (filename.endsWith('.tmp') || filename.startsWith('.')) {
+                    return;
+                }
+                const filePath = path.join(dirPath, filename);
+                const category = filename.replace('.json', '');
+                // Debounce to avoid multiple events for the same file
+                this.debounceChange(filePath, () => {
+                    this.handleFileChange(filePath, category, status, eventType);
+                });
+            });
+            this.watchers.push(watcher);
+            watcher.on('error', (error) => {
+                console.error(`Watcher error for ${dirPath}:`, error);
+            });
+        }
+        catch (error) {
+            console.error(`Failed to watch ${dirPath}:`, error);
+        }
+    }
+    /**
+     * Debounce file change events
+     */
+    debounceChange(key, callback) {
+        const existing = this.debounceTimers.get(key);
+        if (existing) {
+            clearTimeout(existing);
+        }
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(key);
+            callback();
+        }, this.debounceMs);
+        this.debounceTimers.set(key, timer);
+    }
+    /**
+     * Handle a file change event
+     */
+    handleFileChange(filePath, category, status, eventType) {
+        // Determine the change type
+        let changeType;
+        if (!fs.existsSync(filePath)) {
+            changeType = 'deleted';
+        }
+        else if (eventType === 'rename') {
+            // 'rename' can mean created or deleted
+            changeType = 'created';
+        }
+        else {
+            changeType = 'updated';
+        }
+        const event = {
+            type: changeType,
+            category,
+            status,
+            timestamp: new Date().toISOString(),
+        };
+        console.log(`[PatternWatcher] Detected ${changeType}: ${status}/${category}.json`);
+        this.emit('change', event);
+        // Also emit specific events
+        this.emit(changeType, event);
+    }
+}
+//# sourceMappingURL=pattern-watcher.js.map

package/dist/server/pattern-watcher.js.map

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

package/dist/server/quality-gates-api.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Quality Gates API Handler
+ *
+ * Server-side API for quality gates dashboard integration.
+ *
+ * @license Apache-2.0
+ */
+import type { Request, Response } from 'express';
+export declare function handleQualityGatesRequest(req: Request, res: Response, projectRoot: string): Promise<void>;
+import { Router } from 'express';
+export declare function createQualityGatesRouter(projectRoot: string): Router;
+//# sourceMappingURL=quality-gates-api.d.ts.map

package/dist/server/quality-gates-api.js

@@ -0,0 +1,226 @@
+/**
+ * Quality Gates API Handler
+ *
+ * Server-side API for quality gates dashboard integration.
+ *
+ * @license Apache-2.0
+ */
+import { GateOrchestrator, PolicyLoader, GateRunStore, } from 'driftdetect-core';
+// ============================================================================
+// Handler
+// ============================================================================
+export async function handleQualityGatesRequest(req, res, projectRoot) {
+    try {
+        const action = req.query['action'] || req.body?.['action'] || 'latest';
+        switch (action) {
+            case 'latest':
+                await handleLatest(res, projectRoot);
+                break;
+            case 'history':
+                await handleHistory(req, res, projectRoot);
+                break;
+            case 'policies':
+                await handlePolicies(res, projectRoot);
+                break;
+            case 'run':
+                await handleRun(req, res, projectRoot);
+                break;
+            case 'policy':
+                await handleGetPolicy(req, res, projectRoot);
+                break;
+            default:
+                res.status(400).json({
+                    success: false,
+                    error: `Unknown action: ${action}`,
+                });
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        res.status(500).json({
+            success: false,
+            error: message,
+        });
+    }
+}
+// ============================================================================
+// Action Handlers
+// ============================================================================
+/**
+ * Get the latest quality gate run result.
+ */
+async function handleLatest(res, projectRoot) {
+    const store = new GateRunStore(projectRoot);
+    const recentRuns = await store.getRecent(1);
+    const latestRun = recentRuns[0] ?? null;
+    if (!latestRun) {
+        res.json({
+            success: true,
+            data: null,
+        });
+        return;
+    }
+    // Convert stored run to full result format
+    const result = await expandRunRecord(latestRun, projectRoot);
+    res.json({
+        success: true,
+        data: result,
+    });
+}
+/**
+ * Get quality gate run history.
+ */
+async function handleHistory(req, res, projectRoot) {
+    const limit = parseInt(req.query['limit']) || 10;
+    const branch = req.query['branch'];
+    const store = new GateRunStore(projectRoot);
+    const runs = branch
+        ? await store.getByBranch(branch, limit)
+        : await store.getRecent(limit);
+    res.json({
+        success: true,
+        data: {
+            runs,
+            total: runs.length,
+        },
+    });
+}
+/**
+ * Get available policies.
+ */
+async function handlePolicies(res, projectRoot) {
+    const loader = new PolicyLoader(projectRoot);
+    const policies = await loader.listAll();
+    const simplifiedPolicies = policies.map(p => ({
+        id: p.id,
+        name: p.name,
+        description: p.description,
+        version: p.version,
+    }));
+    res.json({
+        success: true,
+        data: {
+            policies: simplifiedPolicies,
+        },
+    });
+}
+/**
+ * Run quality gates.
+ */
+async function handleRun(req, res, projectRoot) {
+    const { policy, files } = req.body;
+    const options = {
+        projectRoot,
+        policy: policy || 'default',
+        files: files || [],
+        branch: 'main', // Could be detected from git
+        ci: false,
+        saveHistory: true,
+    };
+    const orchestrator = new GateOrchestrator(projectRoot);
+    const result = await orchestrator.run(options);
+    res.json({
+        success: true,
+        data: result,
+    });
+}
+/**
+ * Get a specific policy by ID.
+ */
+async function handleGetPolicy(req, res, projectRoot) {
+    const policyId = req.query['policyId'];
+    if (!policyId) {
+        res.status(400).json({
+            success: false,
+            error: 'policyId is required',
+        });
+        return;
+    }
+    const loader = new PolicyLoader(projectRoot);
+    try {
+        const policy = await loader.load(policyId);
+        res.json({
+            success: true,
+            data: policy,
+        });
+    }
+    catch (error) {
+        res.status(404).json({
+            success: false,
+            error: `Policy not found: ${policyId}`,
+        });
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Expand a stored run record to a full result format.
+ * This reconstructs the full result from the stored summary.
+ */
+async function expandRunRecord(run, projectRoot) {
+    const loader = new PolicyLoader(projectRoot);
+    let policyName = run.policyId;
+    try {
+        const policy = await loader.load(run.policyId);
+        policyName = policy.name;
+    }
+    catch {
+        // Use ID as name if policy not found
+    }
+    // Reconstruct gate results from summary
+    const gates = {};
+    for (const [gateId, gateSummary] of Object.entries(run.gates)) {
+        gates[gateId] = {
+            gateId,
+            gateName: gateId.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' '),
+            status: gateSummary.passed ? 'passed' : 'failed',
+            passed: gateSummary.passed,
+            score: gateSummary.score,
+            summary: gateSummary.passed ? 'Passed' : 'Failed',
+            violations: [],
+            warnings: [],
+            executionTimeMs: 0,
+            details: {},
+        };
+    }
+    return {
+        passed: run.passed,
+        status: run.passed ? 'passed' : 'failed',
+        score: run.score,
+        summary: run.passed ? 'All gates passed' : 'Some gates failed',
+        gates: gates,
+        violations: [],
+        warnings: [],
+        policy: {
+            id: run.policyId,
+            name: policyName,
+        },
+        metadata: {
+            executionTimeMs: run.executionTimeMs,
+            filesChecked: 0,
+            gatesRun: Object.keys(run.gates),
+            gatesSkipped: [],
+            timestamp: run.timestamp,
+            branch: run.branch,
+            ...(run.commitSha ? { commitSha: run.commitSha } : {}),
+            ci: run.ci,
+        },
+        exitCode: run.passed ? 0 : 1,
+    };
+}
+// ============================================================================
+// Express Router Setup
+// ============================================================================
+import { Router } from 'express';
+export function createQualityGatesRouter(projectRoot) {
+    const router = Router();
+    router.get('/quality-gates', (req, res) => {
+        handleQualityGatesRequest(req, res, projectRoot);
+    });
+    router.post('/quality-gates', (req, res) => {
+        handleQualityGatesRequest(req, res, projectRoot);
+    });
+    return router;
+}
+//# sourceMappingURL=quality-gates-api.js.map

package/dist/server/quality-gates-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gates-api.js","sourceRoot":"","sources":["../../src/server/quality-gates-api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,GAKb,MAAM,kBAAkB,CAAC;AAc1B,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAY,EACZ,GAAa,EACb,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAY,IAAK,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAY,IAAI,QAAQ,CAAC;QAE/F,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,QAAQ;gBACX,MAAM,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;gBAC3C,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,KAAK;gBACR,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;gBAC7C,MAAM;YACR;gBACE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,mBAAmB,MAAM,EAAE;iBACnC,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,GAAa,EAAE,WAAmB;IAC5D,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAExC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,2CAA2C;IAC3C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAE7D,GAAG,CAAC,IAAI,CAAC;QACP,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,GAAY,EACZ,GAAa,EACb,WAAmB;IAEnB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAW,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAuB,CAAC;IAEzD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM;QACjB,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC;QACxC,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEjC,GAAG,CAAC,IAAI,CAAC;QACP,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACJ,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAAC,GAAa,EAAE,WAAmB;IAC9D,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IAExC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC,CAAC,CAAC;IAEJ,GAAG,CAAC,IAAI,CAAC;QACP,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACJ,QAAQ,EAAE,kBAAkB;SAC7B;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS,CACtB,GAAY,EACZ,GAAa,EACb,WAAmB;IAEnB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,IAA2B,CAAC;IAE1D,MAAM,OAAO,GAAuB;QAClC,WAAW;QACX,MAAM,EAAE,MAAM,IAAI,SAAS;QAC3B,KAAK,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,EAAE,MAAM,EAAE,6BAA6B;QAC7C,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,IAAI;KAClB,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE/C,GAAG,CAAC,IAAI,CAAC;QACP,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,GAAY,EACZ,GAAa,EACb,WAAmB;IAEnB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAW,CAAC;IAEjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,qBAAqB,QAAQ,EAAE;SACvC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;GAGG;AACH,KAAK,UAAU,eAAe,CAC5B,GAAkB,EAClB,WAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IAED,wCAAwC;IACxC,MAAM,KAAK,GAWN,EAAE,CAAC;IAER,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,MAAM;YACN,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACtF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YAChD,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YACjD,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;YACZ,eAAe,EAAE,CAAC;YAClB,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACxC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB;QAC9D,KAAK,EAAE,KAAmC;QAC1C,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE;YACN,EAAE,EAAE,GAAG,CAAC,QAAQ;YAChB,IAAI,EAAE,UAAU;SACjB;QACD,QAAQ,EAAE;YACR,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAa;YAC5C,YAAY,EAAE,EAAc;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,EAAE,EAAE,GAAG,CAAC,EAAE;SACX;QACD,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACxC,yBAAyB,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACzC,yBAAyB,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/websocket-server.d.ts

@@ -0,0 +1,83 @@
+/**
+ * WebSocket Server
+ *
+ * Manages WebSocket connections for realtime violation streaming.
+ *
+ * @requirements 2.1 - Expose a WebSocket endpoint at `/ws` for realtime communication
+ * @requirements 2.3 - Broadcast violations to all connected WebSocket clients
+ */
+import type { Server } from 'http';
+import type { DashboardViolation } from './drift-data-reader.js';
+export type WebSocketMessageType = 'violation' | 'pattern_updated' | 'patterns_changed' | 'stats_updated' | 'ping' | 'pong' | 'connected';
+export interface WebSocketMessage {
+    type: WebSocketMessageType;
+    payload?: unknown;
+    timestamp: string;
+}
+export interface PatternUpdatePayload {
+    id: string;
+    status: string;
+    action: 'approved' | 'ignored' | 'deleted';
+}
+export interface PatternsChangedPayload {
+    type: 'created' | 'updated' | 'deleted';
+    category: string;
+    status: string;
+}
+export declare class WebSocketManager {
+    private wss;
+    private clients;
+    private pingInterval;
+    /**
+     * Get the number of connected clients
+     */
+    get clientCount(): number;
+    /**
+     * Attach WebSocket server to an HTTP server
+     * @requirements 2.1 - WebSocket endpoint at /ws
+     */
+    attach(server: Server): void;
+    /**
+     * Close the WebSocket server and all connections
+     */
+    close(): void;
+    /**
+     * Broadcast a violation to all connected clients
+     * @requirements 2.3 - Broadcast violations to all connected clients
+     */
+    broadcastViolation(violation: DashboardViolation): void;
+    /**
+     * Broadcast a pattern update to all connected clients
+     */
+    broadcastPatternUpdate(update: PatternUpdatePayload): void;
+    /**
+     * Broadcast stats update to all connected clients
+     */
+    broadcastStatsUpdate(stats: unknown): void;
+    /**
+     * Broadcast patterns changed event to all connected clients
+     * Triggers client-side data refresh
+     */
+    broadcastPatternsChanged(payload: PatternsChangedPayload): void;
+    /**
+     * Handle a new WebSocket connection
+     */
+    private handleConnection;
+    /**
+     * Handle incoming message from a client
+     */
+    private handleMessage;
+    /**
+     * Send a message to a specific client
+     */
+    private send;
+    /**
+     * Broadcast a message to all connected clients
+     */
+    private broadcast;
+    /**
+     * Start ping interval for connection health monitoring
+     */
+    private startPingInterval;
+}
+//# sourceMappingURL=websocket-server.d.ts.map