specweave 0.28.67 → 0.29.0

package/dist/src/core/notifications/notification-manager.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Notification Manager
+ *
+ * Manages notification storage, retrieval, and lifecycle.
+ *
+ * @module core/notifications/notification-manager
+ */
+import { Notification, CreateNotificationInput, NotificationQueryOptions } from './notification-types.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Notification manager options
+ */
+export interface NotificationManagerOptions {
+    /**
+     * Path to .specweave directory
+     */
+    specweavePath?: string;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Default cleanup age in days
+     * @default 30
+     */
+    defaultRetentionDays?: number;
+}
+/**
+ * NotificationManager - Central notification storage and retrieval
+ *
+ * Features:
+ * - Add/query/dismiss notifications
+ * - Automatic persistence
+ * - Cleanup of old notifications
+ */
+export declare class NotificationManager {
+    private readonly filePath;
+    private readonly logger;
+    private readonly defaultRetentionDays;
+    private notifications;
+    constructor(options?: NotificationManagerOptions);
+    /**
+     * Add a new notification
+     *
+     * @param input - Notification input
+     * @returns Created notification
+     */
+    add(input: CreateNotificationInput): Promise<Notification>;
+    /**
+     * Get pending notifications (not dismissed)
+     *
+     * @returns Array of pending notifications
+     */
+    getPending(): Promise<Notification[]>;
+    /**
+     * Get all notifications with optional filtering
+     *
+     * @param options - Query options
+     * @returns Array of notifications
+     */
+    getAll(options?: NotificationQueryOptions): Promise<Notification[]>;
+    /**
+     * Get a single notification by ID
+     *
+     * @param id - Notification ID
+     * @returns Notification or undefined
+     */
+    getById(id: string): Promise<Notification | undefined>;
+    /**
+     * Mark notifications as read
+     *
+     * @param ids - Array of notification IDs to mark as read
+     */
+    markRead(ids: string[]): Promise<void>;
+    /**
+     * Dismiss notifications (hide from pending but keep in history)
+     *
+     * @param ids - Array of notification IDs to dismiss
+     */
+    dismiss(ids: string[]): Promise<void>;
+    /**
+     * Dismiss all pending notifications
+     */
+    dismissAll(): Promise<void>;
+    /**
+     * Cleanup old notifications
+     *
+     * @param olderThanDays - Remove notifications older than this many days
+     * @returns Number of removed notifications
+     */
+    cleanup(olderThanDays?: number): Promise<number>;
+    /**
+     * Get summary for display
+     *
+     * @returns Summary object
+     */
+    getSummary(): Promise<{
+        total: number;
+        pending: number;
+        bySeverity: Record<string, number>;
+        byType: Record<string, number>;
+    }>;
+    /**
+     * Check if there are any pending notifications
+     *
+     * @returns true if pending notifications exist
+     */
+    hasPending(): Promise<boolean>;
+    /**
+     * Load notifications from disk
+     */
+    private load;
+    /**
+     * Save notifications to disk
+     */
+    private save;
+    /**
+     * Clear cache (for testing)
+     */
+    clearCache(): void;
+    /**
+     * Get file path (for testing/debugging)
+     */
+    getFilePath(): string;
+}
+//# sourceMappingURL=notification-manager.d.ts.map

package/dist/src/core/notifications/notification-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/notification-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EAGzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AA2B9D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,aAAa,CAA+B;gBAExC,OAAO,GAAE,0BAA+B;IAOpD;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAWhE;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAO3C;;;;;OAKG;IACG,MAAM,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0C7E;;;;;OAKG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAK5D;;;;OAIG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB5C;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;;;;OAKG;IACG,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBtD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IAoBF;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAKpC;;OAEG;YACW,IAAI;IAkClB;;OAEG;YACW,IAAI;IA8BlB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB"}

package/dist/src/core/notifications/notification-manager.js

@@ -0,0 +1,287 @@
+/**
+ * Notification Manager
+ *
+ * Manages notification storage, retrieval, and lifecycle.
+ *
+ * @module core/notifications/notification-manager
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { createNotification, isPendingNotification, } from './notification-types.js';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Current schema version
+ */
+const CURRENT_VERSION = 1;
+/**
+ * NotificationManager - Central notification storage and retrieval
+ *
+ * Features:
+ * - Add/query/dismiss notifications
+ * - Automatic persistence
+ * - Cleanup of old notifications
+ */
+export class NotificationManager {
+    constructor(options = {}) {
+        this.notifications = null;
+        const specweavePath = options.specweavePath ?? path.join(process.cwd(), '.specweave');
+        this.filePath = path.join(specweavePath, 'state', 'notifications.json');
+        this.logger = options.logger ?? consoleLogger;
+        this.defaultRetentionDays = options.defaultRetentionDays ?? 30;
+    }
+    /**
+     * Add a new notification
+     *
+     * @param input - Notification input
+     * @returns Created notification
+     */
+    async add(input) {
+        const notifications = await this.load();
+        const notification = createNotification(input);
+        notifications.push(notification);
+        await this.save(notifications);
+        this.logger.debug(`Added notification: ${notification.id} (${notification.type})`);
+        return notification;
+    }
+    /**
+     * Get pending notifications (not dismissed)
+     *
+     * @returns Array of pending notifications
+     */
+    async getPending() {
+        const notifications = await this.load();
+        return notifications
+            .filter(isPendingNotification)
+            .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    }
+    /**
+     * Get all notifications with optional filtering
+     *
+     * @param options - Query options
+     * @returns Array of notifications
+     */
+    async getAll(options = {}) {
+        const notifications = await this.load();
+        let filtered = notifications;
+        // Filter by type
+        if (options.type) {
+            filtered = filtered.filter((n) => n.type === options.type);
+        }
+        // Filter by severity
+        if (options.severity) {
+            filtered = filtered.filter((n) => n.severity === options.severity);
+        }
+        // Filter dismissed
+        if (!options.includeDismissed) {
+            filtered = filtered.filter((n) => !n.dismissedAt);
+        }
+        // Filter read (default: include read)
+        if (options.includeRead === false) {
+            filtered = filtered.filter((n) => !n.readAt);
+        }
+        // Sort
+        const sortMultiplier = options.sortOrder === 'asc' ? 1 : -1;
+        filtered.sort((a, b) => sortMultiplier * (new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime()));
+        // Pagination
+        if (options.offset) {
+            filtered = filtered.slice(options.offset);
+        }
+        if (options.limit) {
+            filtered = filtered.slice(0, options.limit);
+        }
+        return filtered;
+    }
+    /**
+     * Get a single notification by ID
+     *
+     * @param id - Notification ID
+     * @returns Notification or undefined
+     */
+    async getById(id) {
+        const notifications = await this.load();
+        return notifications.find((n) => n.id === id);
+    }
+    /**
+     * Mark notifications as read
+     *
+     * @param ids - Array of notification IDs to mark as read
+     */
+    async markRead(ids) {
+        const notifications = await this.load();
+        const now = new Date().toISOString();
+        let changed = false;
+        for (const id of ids) {
+            const notification = notifications.find((n) => n.id === id);
+            if (notification && !notification.readAt) {
+                notification.readAt = now;
+                changed = true;
+            }
+        }
+        if (changed) {
+            await this.save(notifications);
+            this.logger.debug(`Marked ${ids.length} notifications as read`);
+        }
+    }
+    /**
+     * Dismiss notifications (hide from pending but keep in history)
+     *
+     * @param ids - Array of notification IDs to dismiss
+     */
+    async dismiss(ids) {
+        const notifications = await this.load();
+        const now = new Date().toISOString();
+        let changed = false;
+        for (const id of ids) {
+            const notification = notifications.find((n) => n.id === id);
+            if (notification && !notification.dismissedAt) {
+                notification.dismissedAt = now;
+                // Also mark as read if not already
+                if (!notification.readAt) {
+                    notification.readAt = now;
+                }
+                changed = true;
+            }
+        }
+        if (changed) {
+            await this.save(notifications);
+            this.logger.debug(`Dismissed ${ids.length} notifications`);
+        }
+    }
+    /**
+     * Dismiss all pending notifications
+     */
+    async dismissAll() {
+        const pending = await this.getPending();
+        const ids = pending.map((n) => n.id);
+        if (ids.length > 0) {
+            await this.dismiss(ids);
+        }
+    }
+    /**
+     * Cleanup old notifications
+     *
+     * @param olderThanDays - Remove notifications older than this many days
+     * @returns Number of removed notifications
+     */
+    async cleanup(olderThanDays) {
+        const days = olderThanDays ?? this.defaultRetentionDays;
+        const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
+        const notifications = await this.load();
+        const originalCount = notifications.length;
+        const filtered = notifications.filter((n) => {
+            const createdAt = new Date(n.createdAt);
+            return createdAt > cutoff;
+        });
+        const removedCount = originalCount - filtered.length;
+        if (removedCount > 0) {
+            await this.save(filtered);
+            this.logger.debug(`Cleaned up ${removedCount} old notifications`);
+        }
+        return removedCount;
+    }
+    /**
+     * Get summary for display
+     *
+     * @returns Summary object
+     */
+    async getSummary() {
+        const notifications = await this.load();
+        const pending = notifications.filter(isPendingNotification);
+        const bySeverity = {};
+        const byType = {};
+        for (const n of pending) {
+            bySeverity[n.severity] = (bySeverity[n.severity] || 0) + 1;
+            byType[n.type] = (byType[n.type] || 0) + 1;
+        }
+        return {
+            total: notifications.length,
+            pending: pending.length,
+            bySeverity,
+            byType,
+        };
+    }
+    /**
+     * Check if there are any pending notifications
+     *
+     * @returns true if pending notifications exist
+     */
+    async hasPending() {
+        const pending = await this.getPending();
+        return pending.length > 0;
+    }
+    /**
+     * Load notifications from disk
+     */
+    async load() {
+        if (this.notifications !== null) {
+            return this.notifications;
+        }
+        try {
+            const content = await fs.readFile(this.filePath, 'utf-8');
+            const data = JSON.parse(content);
+            if (!Array.isArray(data.notifications)) {
+                this.notifications = [];
+                return this.notifications;
+            }
+            this.notifications = data.notifications;
+            return this.notifications;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                this.notifications = [];
+                return this.notifications;
+            }
+            if (error instanceof SyntaxError) {
+                this.logger.warn('Corrupted notifications file, starting fresh');
+                this.notifications = [];
+                return this.notifications;
+            }
+            this.logger.error(`Failed to load notifications: ${error}`);
+            this.notifications = [];
+            return this.notifications;
+        }
+    }
+    /**
+     * Save notifications to disk
+     */
+    async save(notifications) {
+        this.notifications = notifications;
+        const data = {
+            version: CURRENT_VERSION,
+            notifications,
+            lastUpdated: new Date().toISOString(),
+        };
+        // Ensure directory exists
+        const dir = path.dirname(this.filePath);
+        await fs.mkdir(dir, { recursive: true });
+        // Atomic write
+        const tempPath = `${this.filePath}.tmp`;
+        const content = JSON.stringify(data, null, 2);
+        try {
+            await fs.writeFile(tempPath, content, 'utf-8');
+            await fs.rename(tempPath, this.filePath);
+        }
+        catch (error) {
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw error;
+        }
+    }
+    /**
+     * Clear cache (for testing)
+     */
+    clearCache() {
+        this.notifications = null;
+    }
+    /**
+     * Get file path (for testing/debugging)
+     */
+    getFilePath() {
+        return this.filePath;
+    }
+}
+//# sourceMappingURL=notification-manager.js.map

package/dist/src/core/notifications/notification-manager.js.map

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

package/dist/src/core/notifications/notification-types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Notification Types
+ *
+ * Defines the types for the notification system.
+ *
+ * @module core/notifications/notification-types
+ */
+/**
+ * Types of notifications
+ */
+export type NotificationType = 'import-complete' | 'discrepancy' | 'sync-failure' | 'drift' | 'job-complete';
+/**
+ * Notification severity levels
+ */
+export type NotificationSeverity = 'info' | 'warning' | 'critical';
+/**
+ * Notification data structure
+ */
+export interface Notification {
+    /**
+     * Unique notification ID
+     */
+    id: string;
+    /**
+     * Type of notification
+     */
+    type: NotificationType;
+    /**
+     * Severity level
+     */
+    severity: NotificationSeverity;
+    /**
+     * Short title for display
+     */
+    title: string;
+    /**
+     * Detailed message
+     */
+    message: string;
+    /**
+     * Type-specific data
+     */
+    data?: Record<string, unknown>;
+    /**
+     * ISO timestamp when created
+     */
+    createdAt: string;
+    /**
+     * ISO timestamp when user saw the notification
+     */
+    readAt?: string;
+    /**
+     * ISO timestamp when user dismissed the notification
+     */
+    dismissedAt?: string;
+}
+/**
+ * Input for creating a new notification
+ */
+export interface CreateNotificationInput {
+    /**
+     * Type of notification
+     */
+    type: NotificationType;
+    /**
+     * Severity level
+     */
+    severity: NotificationSeverity;
+    /**
+     * Short title for display
+     */
+    title: string;
+    /**
+     * Detailed message
+     */
+    message: string;
+    /**
+     * Type-specific data
+     */
+    data?: Record<string, unknown>;
+}
+/**
+ * Query options for notifications
+ */
+export interface NotificationQueryOptions {
+    /**
+     * Filter by type
+     */
+    type?: NotificationType;
+    /**
+     * Filter by severity
+     */
+    severity?: NotificationSeverity;
+    /**
+     * Include dismissed notifications
+     * @default false
+     */
+    includeDismissed?: boolean;
+    /**
+     * Include read notifications
+     * @default true
+     */
+    includeRead?: boolean;
+    /**
+     * Maximum number of notifications to return
+     */
+    limit?: number;
+    /**
+     * Skip first N notifications
+     */
+    offset?: number;
+    /**
+     * Sort order
+     * @default 'desc' (newest first)
+     */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Generate a unique notification ID
+ *
+ * @returns Unique ID string
+ */
+export declare function generateNotificationId(): string;
+/**
+ * Create a notification from input
+ *
+ * @param input - Notification input
+ * @returns Full notification object
+ */
+export declare function createNotification(input: CreateNotificationInput): Notification;
+/**
+ * Check if notification should be shown (not dismissed)
+ *
+ * @param notification - Notification to check
+ * @returns true if notification should be shown
+ */
+export declare function isPendingNotification(notification: Notification): boolean;
+/**
+ * Check if notification has been read
+ *
+ * @param notification - Notification to check
+ * @returns true if notification has been read
+ */
+export declare function isReadNotification(notification: Notification): boolean;
+/**
+ * Get severity emoji for display
+ *
+ * @param severity - Severity level
+ * @returns Emoji string
+ */
+export declare function getSeverityEmoji(severity: NotificationSeverity): string;
+/**
+ * Get notification type label for display
+ *
+ * @param type - Notification type
+ * @returns Human-readable label
+ */
+export declare function getNotificationTypeLabel(type: NotificationType): string;
+//# sourceMappingURL=notification-types.d.ts.map

package/dist/src/core/notifications/notification-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-types.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/notification-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,OAAO,GACP,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAEhC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY,CAU/E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAWvE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAevE"}

package/dist/src/core/notifications/notification-types.js

@@ -0,0 +1,93 @@
+/**
+ * Notification Types
+ *
+ * Defines the types for the notification system.
+ *
+ * @module core/notifications/notification-types
+ */
+/**
+ * Generate a unique notification ID
+ *
+ * @returns Unique ID string
+ */
+export function generateNotificationId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `notif-${timestamp}-${random}`;
+}
+/**
+ * Create a notification from input
+ *
+ * @param input - Notification input
+ * @returns Full notification object
+ */
+export function createNotification(input) {
+    return {
+        id: generateNotificationId(),
+        type: input.type,
+        severity: input.severity,
+        title: input.title,
+        message: input.message,
+        data: input.data,
+        createdAt: new Date().toISOString(),
+    };
+}
+/**
+ * Check if notification should be shown (not dismissed)
+ *
+ * @param notification - Notification to check
+ * @returns true if notification should be shown
+ */
+export function isPendingNotification(notification) {
+    return !notification.dismissedAt;
+}
+/**
+ * Check if notification has been read
+ *
+ * @param notification - Notification to check
+ * @returns true if notification has been read
+ */
+export function isReadNotification(notification) {
+    return !!notification.readAt;
+}
+/**
+ * Get severity emoji for display
+ *
+ * @param severity - Severity level
+ * @returns Emoji string
+ */
+export function getSeverityEmoji(severity) {
+    switch (severity) {
+        case 'critical':
+            return '❗';
+        case 'warning':
+            return '⚠️';
+        case 'info':
+            return 'ℹ️';
+        default:
+            return '📬';
+    }
+}
+/**
+ * Get notification type label for display
+ *
+ * @param type - Notification type
+ * @returns Human-readable label
+ */
+export function getNotificationTypeLabel(type) {
+    switch (type) {
+        case 'import-complete':
+            return 'Import Complete';
+        case 'discrepancy':
+            return 'Discrepancy';
+        case 'sync-failure':
+            return 'Sync Failure';
+        case 'drift':
+            return 'Drift Detected';
+        case 'job-complete':
+            return 'Job Complete';
+        default:
+            return 'Notification';
+    }
+}
+//# sourceMappingURL=notification-types.js.map

package/dist/src/core/notifications/notification-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-types.js","sourceRoot":"","sources":["../../../../src/core/notifications/notification-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4IH;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,SAAS,SAAS,IAAI,MAAM,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,OAAO;QACL,EAAE,EAAE,sBAAsB,EAAE;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAA0B;IAC9D,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAA0B;IAC3D,OAAO,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA8B;IAC7D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,GAAG,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAsB;IAC7D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB;YACpB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;QAC1B,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC;QACxB;YACE,OAAO,cAAc,CAAC;IAC1B,CAAC;AACH,CAAC"}