driftdetect-dashboard 0.1.0

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

@@ -0,0 +1,64 @@
+/**
+ * DashboardServer
+ *
+ * Main server class that orchestrates Express and WebSocket servers
+ * for the Drift Dashboard.
+ *
+ * @requirements 1.1 - Start an Express server on localhost:3847
+ * @requirements 1.2 - Start on the specified port
+ * @requirements 1.3 - Automatically open the default browser to the dashboard URL
+ * @requirements 1.5 - Handle port conflict errors gracefully
+ */
+import { type DashboardViolation } from './drift-data-reader.js';
+export interface DashboardServerOptions {
+    /** Port to listen on (default: 3847) */
+    port: number;
+    /** Path to the .drift directory */
+    driftDir: string;
+    /** Whether to automatically open browser on start */
+    openBrowser: boolean;
+}
+export declare class DashboardServer {
+    private readonly options;
+    private readonly reader;
+    private readonly wsManager;
+    private readonly patternWatcher;
+    private server;
+    constructor(options: DashboardServerOptions);
+    /**
+     * Get the configured port
+     */
+    get port(): number;
+    /**
+     * Get the drift directory path
+     */
+    get driftDir(): string;
+    /**
+     * Check if the server is running
+     */
+    get isRunning(): boolean;
+    /**
+     * Get the number of connected WebSocket clients
+     */
+    get connectedClients(): number;
+    /**
+     * Start the dashboard server
+     * @requirements 1.1, 1.2, 1.3
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the dashboard server
+     */
+    stop(): Promise<void>;
+    /**
+     * Broadcast a violation to all connected WebSocket clients
+     * @requirements 2.3
+     */
+    broadcastViolation(violation: DashboardViolation): void;
+    /**
+     * Open the default browser to the dashboard URL
+     * @requirements 1.3
+     */
+    private openBrowser;
+}
+//# sourceMappingURL=dashboard-server.d.ts.map

package/dist/server/dashboard-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-server.d.ts","sourceRoot":"","sources":["../../src/server/dashboard-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AASlF,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,EAAE,sBAAsB;IAgB3C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmD5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAIvD;;;OAGG;YACW,WAAW;CAK1B"}

package/dist/server/dashboard-server.js

@@ -0,0 +1,154 @@
+/**
+ * DashboardServer
+ *
+ * Main server class that orchestrates Express and WebSocket servers
+ * for the Drift Dashboard.
+ *
+ * @requirements 1.1 - Start an Express server on localhost:3847
+ * @requirements 1.2 - Start on the specified port
+ * @requirements 1.3 - Automatically open the default browser to the dashboard URL
+ * @requirements 1.5 - Handle port conflict errors gracefully
+ */
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DriftDataReader } from './drift-data-reader.js';
+import { createExpressApp } from './express-app.js';
+import { WebSocketManager } from './websocket-server.js';
+import { PatternWatcher } from './pattern-watcher.js';
+// Get the directory of this file for resolving static files
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class DashboardServer {
+    options;
+    reader;
+    wsManager;
+    patternWatcher;
+    server = null;
+    constructor(options) {
+        this.options = options;
+        this.reader = new DriftDataReader(options.driftDir);
+        this.wsManager = new WebSocketManager();
+        this.patternWatcher = new PatternWatcher({ driftDir: options.driftDir });
+        // Wire up pattern watcher to WebSocket broadcasts
+        this.patternWatcher.on('change', (event) => {
+            this.wsManager.broadcastPatternsChanged({
+                type: event.type,
+                category: event.category,
+                status: event.status,
+            });
+        });
+    }
+    /**
+     * Get the configured port
+     */
+    get port() {
+        return this.options.port;
+    }
+    /**
+     * Get the drift directory path
+     */
+    get driftDir() {
+        return this.options.driftDir;
+    }
+    /**
+     * Check if the server is running
+     */
+    get isRunning() {
+        return this.server !== null;
+    }
+    /**
+     * Get the number of connected WebSocket clients
+     */
+    get connectedClients() {
+        return this.wsManager.clientCount;
+    }
+    /**
+     * Start the dashboard server
+     * @requirements 1.1, 1.2, 1.3
+     */
+    async start() {
+        if (this.server) {
+            throw new Error('Server is already running');
+        }
+        // Resolve static files directory (dist/client relative to dist/server)
+        const staticDir = path.resolve(__dirname, '..', 'client');
+        // Create Express app
+        const app = createExpressApp({
+            reader: this.reader,
+            staticDir,
+            enableCors: true,
+        });
+        // Create HTTP server
+        return new Promise((resolve, reject) => {
+            this.server = app.listen(this.options.port, async () => {
+                console.log(`Dashboard server running at http://localhost:${this.options.port}`);
+                // Attach WebSocket server
+                this.wsManager.attach(this.server);
+                // Start pattern watcher for realtime updates
+                this.patternWatcher.start();
+                // Open browser if requested
+                if (this.options.openBrowser) {
+                    try {
+                        await this.openBrowser();
+                    }
+                    catch (error) {
+                        // Don't fail if browser can't be opened
+                        console.warn('Could not open browser:', error);
+                    }
+                }
+                resolve();
+            });
+            this.server.on('error', (error) => {
+                this.server = null;
+                if (error.code === 'EADDRINUSE') {
+                    reject(new Error(`Port ${this.options.port} is already in use. Try a different port with --port <number>`));
+                }
+                else {
+                    reject(error);
+                }
+            });
+        });
+    }
+    /**
+     * Stop the dashboard server
+     */
+    async stop() {
+        if (!this.server) {
+            return;
+        }
+        // Stop pattern watcher
+        this.patternWatcher.stop();
+        // Close WebSocket connections
+        this.wsManager.close();
+        // Close HTTP server
+        return new Promise((resolve, reject) => {
+            this.server.close((error) => {
+                this.server = null;
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    console.log('Dashboard server stopped');
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Broadcast a violation to all connected WebSocket clients
+     * @requirements 2.3
+     */
+    broadcastViolation(violation) {
+        this.wsManager.broadcastViolation(violation);
+    }
+    /**
+     * Open the default browser to the dashboard URL
+     * @requirements 1.3
+     */
+    async openBrowser() {
+        // Dynamic import to avoid issues with ESM
+        const open = await import('open');
+        await open.default(`http://localhost:${this.options.port}`);
+    }
+}
+//# sourceMappingURL=dashboard-server.js.map

package/dist/server/dashboard-server.js.map

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

package/dist/server/drift-data-reader.d.ts

@@ -0,0 +1,411 @@
+/**
+ * DriftDataReader
+ *
+ * Reads and parses data from the .drift/ folder structure.
+ * Provides methods for accessing patterns, violations, files, and configuration.
+ *
+ * @requirements 1.6 - THE Dashboard_Server SHALL read pattern and violation data from the existing `.drift/` folder structure
+ * @requirements 8.1 - THE Dashboard_Server SHALL expose GET `/api/patterns` to list all patterns
+ * @requirements 8.2 - THE Dashboard_Server SHALL expose GET `/api/patterns/:id` to get pattern details with locations
+ * @requirements 8.6 - THE Dashboard_Server SHALL expose GET `/api/violations` to list all violations
+ * @requirements 8.7 - THE Dashboard_Server SHALL expose GET `/api/files` to get the file tree
+ * @requirements 8.8 - THE Dashboard_Server SHALL expose GET `/api/files/:path` to get patterns and violations for a specific file
+ * @requirements 8.9 - THE Dashboard_Server SHALL expose GET `/api/stats` to get overview statistics
+ */
+import type { PatternStatus, PatternCategory, Severity } from 'driftdetect-core';
+export interface PatternQuery {
+    category?: string;
+    status?: string;
+    minConfidence?: number;
+    search?: string;
+}
+export interface ViolationQuery {
+    severity?: string;
+    file?: string;
+    patternId?: string;
+    search?: string;
+}
+/**
+ * Pattern representation for the dashboard API
+ */
+export interface DashboardPattern {
+    id: string;
+    name: string;
+    category: string;
+    subcategory: string;
+    status: PatternStatus;
+    description: string;
+    confidence: {
+        score: number;
+        level: string;
+    };
+    locationCount: number;
+    outlierCount: number;
+    severity: string;
+    metadata: {
+        firstSeen: string;
+        lastSeen: string;
+        tags?: string[] | undefined;
+    };
+}
+/**
+ * Pattern with full location details for the dashboard API
+ */
+export interface DashboardPatternWithLocations extends DashboardPattern {
+    locations: SemanticLocation[];
+    outliers: OutlierWithDetails[];
+}
+/**
+ * Semantic location for the dashboard
+ */
+export interface SemanticLocation {
+    file: string;
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+/**
+ * Outlier with reason details
+ */
+export interface OutlierWithDetails extends SemanticLocation {
+    reason: string;
+    deviationScore?: number | undefined;
+}
+/**
+ * Violation representation for the dashboard API
+ */
+export interface DashboardViolation {
+    id: string;
+    patternId: string;
+    patternName: string;
+    severity: string;
+    file: string;
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+    message: string;
+    expected: string;
+    actual: string;
+}
+/**
+ * File tree node for hierarchical file structure
+ * @requirements 8.7 - GET `/api/files` to get the file tree
+ */
+export interface FileTreeNode {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    children?: FileTreeNode[];
+    patternCount?: number;
+    violationCount?: number;
+    severity?: Severity;
+}
+/**
+ * File details with patterns and violations
+ * @requirements 8.8 - GET `/api/files/:path` to get patterns and violations for a specific file
+ */
+export interface FileDetails {
+    path: string;
+    language: string;
+    lineCount: number;
+    patterns: Array<{
+        id: string;
+        name: string;
+        category: PatternCategory;
+        locations: SemanticLocation[];
+    }>;
+    violations: DashboardViolation[];
+}
+/**
+ * Drift configuration
+ * @requirements 8.10, 8.11 - Configuration management
+ */
+export interface DriftConfig {
+    version: string;
+    detectors: DetectorConfigEntry[];
+    severityOverrides: Record<string, Severity>;
+    ignorePatterns: string[];
+    watchOptions?: {
+        debounce: number;
+        categories?: PatternCategory[];
+    };
+}
+/**
+ * Detector configuration entry
+ */
+export interface DetectorConfigEntry {
+    id: string;
+    name: string;
+    enabled: boolean;
+    category: PatternCategory;
+    options?: Record<string, unknown>;
+}
+/**
+ * Dashboard statistics
+ * @requirements 8.9 - GET `/api/stats` to get overview statistics
+ */
+export interface DashboardStats {
+    healthScore: number;
+    patterns: {
+        total: number;
+        byStatus: Record<PatternStatus, number>;
+        byCategory: Record<PatternCategory, number>;
+    };
+    violations: {
+        total: number;
+        bySeverity: Record<Severity, number>;
+    };
+    files: {
+        total: number;
+        scanned: number;
+    };
+    detectors: {
+        active: number;
+        total: number;
+    };
+    lastScan: string | null;
+}
+/**
+ * Contract representation for the dashboard API
+ */
+export interface DashboardContract {
+    id: string;
+    method: string;
+    endpoint: string;
+    status: string;
+    backend: {
+        file: string;
+        line: number;
+        framework: string;
+        responseFields: Array<{
+            name: string;
+            type: string;
+            optional: boolean;
+        }>;
+    };
+    frontend: Array<{
+        file: string;
+        line: number;
+        library: string;
+        responseType?: string;
+        responseFields: Array<{
+            name: string;
+            type: string;
+            optional: boolean;
+        }>;
+    }>;
+    mismatches: Array<{
+        fieldPath: string;
+        mismatchType: string;
+        description: string;
+        severity: string;
+    }>;
+    mismatchCount: number;
+    confidence: {
+        score: number;
+        level: string;
+    };
+    metadata: {
+        firstSeen: string;
+        lastSeen: string;
+        verifiedAt?: string;
+    };
+}
+/**
+ * Contract statistics for the dashboard
+ */
+export interface DashboardContractStats {
+    totalContracts: number;
+    byStatus: Record<string, number>;
+    byMethod: Record<string, number>;
+    totalMismatches: number;
+    mismatchesByType: Record<string, number>;
+}
+export declare class DriftDataReader {
+    private readonly driftDir;
+    private readonly patternsDir;
+    constructor(driftDir: string);
+    /**
+     * Get the drift directory path
+     */
+    get directory(): string;
+    /**
+     * Get all patterns, optionally filtered
+     *
+     * @requirements 8.1 - List all patterns
+     */
+    getPatterns(query?: PatternQuery): Promise<DashboardPattern[]>;
+    /**
+     * Get a single pattern by ID with all locations
+     *
+     * @requirements 8.2 - Get pattern details with locations
+     */
+    getPattern(id: string): Promise<DashboardPatternWithLocations | null>;
+    /**
+     * Get all violations, optionally filtered
+     *
+     * Violations are derived from pattern outliers.
+     *
+     * @requirements 8.6 - List all violations
+     */
+    getViolations(query?: ViolationQuery): Promise<DashboardViolation[]>;
+    /**
+     * Get dashboard statistics
+     * @requirements 8.9 - GET `/api/stats` to get overview statistics
+     */
+    getStats(): Promise<DashboardStats>;
+    /**
+     * Get the file tree structure
+     * @requirements 8.7 - GET `/api/files` to get the file tree
+     */
+    getFileTree(): Promise<FileTreeNode[]>;
+    /**
+     * Get details for a specific file
+     * @requirements 8.8 - GET `/api/files/:path` to get patterns and violations for a specific file
+     */
+    getFileDetails(filePath: string): Promise<FileDetails | null>;
+    /**
+     * Get configuration
+     * @requirements 8.10 - GET `/api/config` to get configuration
+     */
+    getConfig(): Promise<DriftConfig>;
+    /**
+     * Update configuration
+     * @requirements 8.11 - PUT `/api/config` to update configuration
+     */
+    updateConfig(partial: Partial<DriftConfig>): Promise<void>;
+    /**
+     * Approve a pattern - changes status to 'approved'
+     * @requirements 4.4 - Approve pattern
+     * @requirements 8.3 - POST `/api/patterns/:id/approve` to approve a pattern
+     */
+    approvePattern(id: string): Promise<void>;
+    /**
+     * Ignore a pattern - changes status to 'ignored'
+     * @requirements 4.5 - Ignore pattern
+     * @requirements 8.4 - POST `/api/patterns/:id/ignore` to ignore a pattern
+     */
+    ignorePattern(id: string): Promise<void>;
+    /**
+     * Delete a pattern - removes from storage
+     * @requirements 4.6 - Delete pattern
+     * @requirements 8.5 - DELETE `/api/patterns/:id` to delete a pattern
+     */
+    deletePattern(id: string): Promise<void>;
+    /**
+     * Convert a StoredPattern to DashboardPattern
+     */
+    private storedToDashboardPattern;
+    /**
+     * Convert a StoredPattern to DashboardPatternWithLocations
+     */
+    private storedToDashboardPatternWithLocations;
+    /**
+     * Convert an outlier to a violation
+     */
+    private outlierToViolation;
+    /**
+     * Filter patterns based on query
+     */
+    private filterPatterns;
+    /**
+     * Filter violations based on query
+     */
+    private filterViolations;
+    /**
+     * Calculate health score based on violations and patterns
+     *
+     * Health score formula:
+     * - Base score starts at 100
+     * - Deduct for violations by severity (error: -10, warning: -3, info: -1, hint: 0)
+     * - Bonus for approved patterns (shows intentional architecture)
+     * - Clamp to 0-100
+     */
+    private calculateHealthScore;
+    /**
+     * Build a hierarchical file tree from file information
+     */
+    private buildFileTree;
+    /**
+     * Sort file tree: directories first, then alphabetically
+     */
+    private sortFileTree;
+    /**
+     * Compare severity levels
+     * Returns positive if a > b, negative if a < b, 0 if equal
+     */
+    private compareSeverity;
+    /**
+     * Get programming language from file path
+     */
+    private getLanguageFromPath;
+    /**
+     * Change pattern status (move between status directories)
+     */
+    private changePatternStatus;
+    /**
+     * Find a pattern's location in the file system
+     */
+    private findPatternLocation;
+    /**
+     * Get default configuration
+     */
+    private getDefaultConfig;
+    /**
+     * Get code snippet from a file at a specific line with context
+     */
+    getCodeSnippet(filePath: string, line: number, contextLines?: number): Promise<{
+        code: string;
+        startLine: number;
+        endLine: number;
+        language: string;
+    } | null>;
+    /**
+     * Get all contracts, optionally filtered
+     */
+    getContracts(query?: {
+        status?: string;
+        method?: string;
+        hasMismatches?: boolean;
+        search?: string;
+    }): Promise<DashboardContract[]>;
+    /**
+     * Get a single contract by ID
+     */
+    getContract(id: string): Promise<DashboardContract | null>;
+    /**
+     * Get contract statistics
+     */
+    getContractStats(): Promise<DashboardContractStats>;
+    /**
+     * Verify a contract
+     */
+    verifyContract(id: string): Promise<void>;
+    /**
+     * Ignore a contract
+     */
+    ignoreContract(id: string): Promise<void>;
+    /**
+     * Change contract status
+     */
+    private changeContractStatus;
+    /**
+     * Filter contracts based on query
+     */
+    private filterContracts;
+}
+//# sourceMappingURL=drift-data-reader.d.ts.map

package/dist/server/drift-data-reader.d.ts.map

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