specweave 0.28.67 → 0.29.0

package/dist/src/core/logs/log-exporter.js

@@ -0,0 +1,141 @@
+/**
+ * Log Exporter
+ *
+ * Exports log query results to various formats.
+ *
+ * @module core/logs/log-exporter
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * LogExporter - Export log entries to files
+ *
+ * Supports:
+ * - JSON (single object with entries array)
+ * - JSONL (one entry per line)
+ * - CSV (for spreadsheet import)
+ */
+export class LogExporter {
+    constructor(options = {}) {
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Export query results to a file
+     */
+    async export(result, outputPath, options = {}) {
+        const format = options.format ?? this.detectFormat(outputPath);
+        const content = this.formatContent(result, format, options);
+        // Ensure directory exists
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+        // Write file
+        await fs.writeFile(outputPath, content, 'utf-8');
+        this.logger.debug(`Exported ${result.entries.length} entries to ${outputPath}`);
+    }
+    /**
+     * Export entries to a string
+     */
+    exportToString(entries, format, options = {}) {
+        const result = {
+            entries,
+            total: entries.length,
+            hasMore: false,
+            query: {},
+            executionTimeMs: 0,
+        };
+        return this.formatContent(result, format, options);
+    }
+    /**
+     * Format content based on format type
+     */
+    formatContent(result, format, options) {
+        switch (format) {
+            case 'json':
+                return this.formatJson(result, options);
+            case 'jsonl':
+                return this.formatJsonl(result);
+            case 'csv':
+                return this.formatCsv(result);
+            default:
+                return this.formatJson(result, options);
+        }
+    }
+    /**
+     * Format as JSON
+     */
+    formatJson(result, options) {
+        const pretty = options.pretty ?? true;
+        const includeMetadata = options.includeMetadata ?? true;
+        const output = includeMetadata
+            ? {
+                metadata: {
+                    exportedAt: new Date().toISOString(),
+                    total: result.total,
+                    hasMore: result.hasMore,
+                    query: result.query,
+                    executionTimeMs: result.executionTimeMs,
+                },
+                entries: result.entries,
+            }
+            : result.entries;
+        return pretty ? JSON.stringify(output, null, 2) : JSON.stringify(output);
+    }
+    /**
+     * Format as JSONL (one JSON object per line)
+     */
+    formatJsonl(result) {
+        return result.entries.map(e => JSON.stringify(e)).join('\n') + '\n';
+    }
+    /**
+     * Format as CSV
+     */
+    formatCsv(result) {
+        const headers = [
+            'timestamp',
+            'platform',
+            'operation',
+            'itemId',
+            'result',
+            'reason',
+            'error',
+            'durationMs',
+        ];
+        const rows = result.entries.map(entry => [
+            entry.timestamp,
+            entry.platform,
+            entry.operation,
+            entry.itemId,
+            entry.result,
+            entry.reason ?? '',
+            entry.error ?? '',
+            entry.durationMs?.toString() ?? '',
+        ]);
+        const escape = (value) => {
+            if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+                return `"${value.replace(/"/g, '""')}"`;
+            }
+            return value;
+        };
+        const csvLines = [
+            headers.join(','),
+            ...rows.map(row => row.map(escape).join(',')),
+        ];
+        return csvLines.join('\n') + '\n';
+    }
+    /**
+     * Detect format from file extension
+     */
+    detectFormat(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        switch (ext) {
+            case '.jsonl':
+                return 'jsonl';
+            case '.csv':
+                return 'csv';
+            case '.json':
+            default:
+                return 'json';
+        }
+    }
+}
+//# sourceMappingURL=log-exporter.js.map

package/dist/src/core/logs/log-exporter.js.map

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

package/dist/src/core/notifications/command-integration.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Notification Command Integration
+ *
+ * Helper for injecting notification summaries into command output.
+ * Used by SpecWeave commands like /progress, /status, /done to show
+ * pending notifications after their main output.
+ *
+ * @module core/notifications/command-integration
+ */
+import { Notification } from './notification-types.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Options for command notification display
+ */
+export interface CommandNotificationOptions {
+    /**
+     * Path to .specweave directory
+     */
+    specweavePath?: string;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Display style
+     * @default 'summary'
+     */
+    style?: 'compact' | 'summary' | 'box';
+    /**
+     * Minimum severity to show
+     * If 'critical', only show if critical notifications exist
+     */
+    minSeverity?: 'info' | 'warning' | 'critical';
+}
+/**
+ * Result of notification check
+ */
+export interface NotificationCheckResult {
+    /**
+     * Number of pending notifications
+     */
+    count: number;
+    /**
+     * Whether any critical notifications exist
+     */
+    hasCritical: boolean;
+    /**
+     * Whether any warning notifications exist
+     */
+    hasWarning: boolean;
+    /**
+     * Formatted output string (empty if no notifications to show)
+     */
+    output: string;
+    /**
+     * The pending notifications
+     */
+    notifications: Notification[];
+}
+/**
+ * Check for pending notifications and format for command output
+ *
+ * @param options - Configuration options
+ * @returns Check result with formatted output
+ */
+export declare function checkAndFormatNotifications(options?: CommandNotificationOptions): Promise<NotificationCheckResult>;
+/**
+ * Print notification summary to console if there are pending notifications
+ *
+ * @param options - Configuration options
+ * @returns true if notifications were printed
+ */
+export declare function printNotificationSummary(options?: CommandNotificationOptions): Promise<boolean>;
+/**
+ * Wrapper to add notification summary to a command function
+ *
+ * @param commandFn - The command function to wrap
+ * @param options - Notification display options
+ * @returns Wrapped function that shows notifications after command
+ */
+export declare function withNotifications<T extends (...args: unknown[]) => Promise<void>>(commandFn: T, options?: CommandNotificationOptions): T;
+//# sourceMappingURL=command-integration.d.ts.map

package/dist/src/core/notifications/command-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-integration.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/command-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;IAEtC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,uBAAuB,CAAC,CAmClC;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/E,SAAS,EAAE,CAAC,EACZ,OAAO,GAAE,0BAA+B,GACvC,CAAC,CAKH"}

package/dist/src/core/notifications/command-integration.js

@@ -0,0 +1,80 @@
+/**
+ * Notification Command Integration
+ *
+ * Helper for injecting notification summaries into command output.
+ * Used by SpecWeave commands like /progress, /status, /done to show
+ * pending notifications after their main output.
+ *
+ * @module core/notifications/command-integration
+ */
+import path from 'path';
+import { NotificationManager } from './notification-manager.js';
+import { formatNotificationsForOutput } from './notification-display.js';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Check for pending notifications and format for command output
+ *
+ * @param options - Configuration options
+ * @returns Check result with formatted output
+ */
+export async function checkAndFormatNotifications(options = {}) {
+    const logger = options.logger ?? consoleLogger;
+    const specweavePath = options.specweavePath ?? path.join(process.cwd(), '.specweave');
+    const style = options.style ?? 'summary';
+    const manager = new NotificationManager({ specweavePath, logger });
+    let notifications;
+    try {
+        notifications = await manager.getPending();
+    }
+    catch (error) {
+        logger.debug(`Failed to load notifications: ${error}`);
+        notifications = [];
+    }
+    const hasCritical = notifications.some(n => n.severity === 'critical');
+    const hasWarning = notifications.some(n => n.severity === 'warning');
+    // Filter by minimum severity if specified
+    let filteredNotifications = notifications;
+    if (options.minSeverity === 'critical') {
+        filteredNotifications = hasCritical ? notifications : [];
+    }
+    else if (options.minSeverity === 'warning') {
+        filteredNotifications = (hasCritical || hasWarning) ? notifications : [];
+    }
+    const output = formatNotificationsForOutput(filteredNotifications, { style });
+    return {
+        count: notifications.length,
+        hasCritical,
+        hasWarning,
+        output,
+        notifications: filteredNotifications,
+    };
+}
+/**
+ * Print notification summary to console if there are pending notifications
+ *
+ * @param options - Configuration options
+ * @returns true if notifications were printed
+ */
+export async function printNotificationSummary(options = {}) {
+    const result = await checkAndFormatNotifications(options);
+    if (result.output) {
+        console.log(result.output);
+        console.log("Run '/specweave:notifications' to view");
+        return true;
+    }
+    return false;
+}
+/**
+ * Wrapper to add notification summary to a command function
+ *
+ * @param commandFn - The command function to wrap
+ * @param options - Notification display options
+ * @returns Wrapped function that shows notifications after command
+ */
+export function withNotifications(commandFn, options = {}) {
+    return (async (...args) => {
+        await commandFn(...args);
+        await printNotificationSummary(options);
+    });
+}
+//# sourceMappingURL=command-integration.js.map

package/dist/src/core/notifications/command-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-integration.js","sourceRoot":"","sources":["../../../../src/core/notifications/command-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAU,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA2D9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;IAEzC,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnE,IAAI,aAA6B,CAAC;IAClC,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QACvD,aAAa,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAErE,0CAA0C;IAC1C,IAAI,qBAAqB,GAAG,aAAa,CAAC;IAC1C,IAAI,OAAO,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACvC,qBAAqB,GAAG,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,CAAC;SAAM,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC7C,qBAAqB,GAAG,CAAC,WAAW,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,4BAA4B,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAE9E,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,MAAM;QAC3B,WAAW;QACX,UAAU;QACV,MAAM;QACN,aAAa,EAAE,qBAAqB;KACrC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAE1D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAY,EACZ,UAAsC,EAAE;IAExC,OAAO,CAAC,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;QACnC,MAAM,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QACzB,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAM,CAAC;AACV,CAAC"}

package/dist/src/core/notifications/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Notifications Module
+ *
+ * Exports notification functionality for the sync orchestration system.
+ *
+ * @module core/notifications
+ */
+export * from './notification-types.js';
+export * from './notification-manager.js';
+export * from './notification-display.js';
+export * from './command-integration.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

package/dist/src/core/notifications/index.js

@@ -0,0 +1,12 @@
+/**
+ * Notifications Module
+ *
+ * Exports notification functionality for the sync orchestration system.
+ *
+ * @module core/notifications
+ */
+export * from './notification-types.js';
+export * from './notification-manager.js';
+export * from './notification-display.js';
+export * from './command-integration.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

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

@@ -0,0 +1,70 @@
+/**
+ * Notification Display
+ *
+ * Formatting utilities for displaying notifications in CLI output.
+ *
+ * @module core/notifications/notification-display
+ */
+import { Notification } from './notification-types.js';
+/**
+ * Format a single notification for display
+ *
+ * @param notification - Notification to format
+ * @returns Formatted string
+ */
+export declare function formatNotification(notification: Notification): string;
+/**
+ * Format a detailed notification for display
+ *
+ * @param notification - Notification to format
+ * @returns Formatted string with message
+ */
+export declare function formatNotificationDetailed(notification: Notification): string;
+/**
+ * Format a notification summary line
+ *
+ * @param notifications - Array of pending notifications
+ * @returns Summary string (e.g., "3 notifications: 1 critical, 2 warnings")
+ */
+export declare function formatNotificationSummary(notifications: Notification[]): string;
+/**
+ * Format a notification list for CLI display
+ *
+ * @param notifications - Array of notifications
+ * @param options - Display options
+ * @returns Formatted string
+ */
+export declare function formatNotificationList(notifications: Notification[], options?: {
+    maxItems?: number;
+    showDetails?: boolean;
+}): string;
+/**
+ * Format notifications in a box for prominent display
+ *
+ * @param notifications - Array of notifications
+ * @returns Formatted box string
+ */
+export declare function formatNotificationBox(notifications: Notification[]): string;
+/**
+ * Get a compact notification indicator for status line
+ *
+ * @param count - Number of pending notifications
+ * @param hasCritical - Whether any are critical
+ * @returns Compact indicator string
+ */
+export declare function getNotificationIndicator(count: number, hasCritical: boolean): string;
+/**
+ * Format notifications for injection into command output
+ *
+ * This is the main function used by hooks to display notifications
+ * after command execution.
+ *
+ * @param notifications - Pending notifications
+ * @param options - Display options
+ * @returns Formatted string to append to output
+ */
+export declare function formatNotificationsForOutput(notifications: Notification[], options?: {
+    style?: 'compact' | 'summary' | 'box';
+    separator?: string;
+}): string;
+//# sourceMappingURL=notification-display.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification-display.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/notification-display.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EAIb,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAGrE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAI7E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,CA8B/E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,MAAM,CAyBR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,CA0C3E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,OAAO,GACnB,MAAM,CAOR;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,MAAM,CA6BR"}

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

@@ -0,0 +1,177 @@
+/**
+ * Notification Display
+ *
+ * Formatting utilities for displaying notifications in CLI output.
+ *
+ * @module core/notifications/notification-display
+ */
+import { getSeverityEmoji, getNotificationTypeLabel, } from './notification-types.js';
+/**
+ * Format a single notification for display
+ *
+ * @param notification - Notification to format
+ * @returns Formatted string
+ */
+export function formatNotification(notification) {
+    const emoji = getSeverityEmoji(notification.severity);
+    return `${emoji} ${notification.title}`;
+}
+/**
+ * Format a detailed notification for display
+ *
+ * @param notification - Notification to format
+ * @returns Formatted string with message
+ */
+export function formatNotificationDetailed(notification) {
+    const emoji = getSeverityEmoji(notification.severity);
+    const type = getNotificationTypeLabel(notification.type);
+    return `${emoji} [${type}] ${notification.title}\n   ${notification.message}`;
+}
+/**
+ * Format a notification summary line
+ *
+ * @param notifications - Array of pending notifications
+ * @returns Summary string (e.g., "3 notifications: 1 critical, 2 warnings")
+ */
+export function formatNotificationSummary(notifications) {
+    if (notifications.length === 0) {
+        return '';
+    }
+    const bySeverity = {
+        critical: 0,
+        warning: 0,
+        info: 0,
+    };
+    for (const n of notifications) {
+        bySeverity[n.severity]++;
+    }
+    const parts = [];
+    if (bySeverity.critical > 0) {
+        parts.push(`${bySeverity.critical} critical`);
+    }
+    if (bySeverity.warning > 0) {
+        parts.push(`${bySeverity.warning} warning${bySeverity.warning > 1 ? 's' : ''}`);
+    }
+    if (bySeverity.info > 0) {
+        parts.push(`${bySeverity.info} info`);
+    }
+    const count = notifications.length;
+    const countLabel = count === 1 ? 'notification' : 'notifications';
+    return `📬 ${count} ${countLabel}${parts.length > 0 ? ': ' + parts.join(', ') : ''}`;
+}
+/**
+ * Format a notification list for CLI display
+ *
+ * @param notifications - Array of notifications
+ * @param options - Display options
+ * @returns Formatted string
+ */
+export function formatNotificationList(notifications, options = {}) {
+    const { maxItems = 5, showDetails = false } = options;
+    if (notifications.length === 0) {
+        return '';
+    }
+    const items = notifications.slice(0, maxItems);
+    const remaining = notifications.length - items.length;
+    const lines = [];
+    for (const notification of items) {
+        if (showDetails) {
+            lines.push(formatNotificationDetailed(notification));
+        }
+        else {
+            lines.push(formatNotification(notification));
+        }
+    }
+    if (remaining > 0) {
+        lines.push(`   ... and ${remaining} more`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format notifications in a box for prominent display
+ *
+ * @param notifications - Array of notifications
+ * @returns Formatted box string
+ */
+export function formatNotificationBox(notifications) {
+    if (notifications.length === 0) {
+        return '';
+    }
+    const width = 50;
+    const horizontalLine = '─'.repeat(width - 2);
+    const lines = [];
+    // Top border
+    lines.push(`╭${horizontalLine}╮`);
+    // Header
+    const header = `📬 ${notifications.length} pending notification${notifications.length > 1 ? 's' : ''}`;
+    lines.push(`│ ${header.padEnd(width - 3)} │`);
+    // Separator
+    lines.push(`├${horizontalLine}┤`);
+    // Notifications (max 5)
+    const maxItems = 5;
+    const items = notifications.slice(0, maxItems);
+    for (const notification of items) {
+        const emoji = getSeverityEmoji(notification.severity);
+        const text = `${emoji} ${notification.severity.toUpperCase()}: ${notification.title}`;
+        const truncated = text.length > width - 4 ? text.substring(0, width - 7) + '...' : text;
+        lines.push(`│ ${truncated.padEnd(width - 3)} │`);
+    }
+    // Remaining count
+    const remaining = notifications.length - items.length;
+    if (remaining > 0) {
+        const moreText = `   ... and ${remaining} more`;
+        lines.push(`│ ${moreText.padEnd(width - 3)} │`);
+    }
+    // Bottom border
+    lines.push(`╰${horizontalLine}╯`);
+    return lines.join('\n');
+}
+/**
+ * Get a compact notification indicator for status line
+ *
+ * @param count - Number of pending notifications
+ * @param hasCritical - Whether any are critical
+ * @returns Compact indicator string
+ */
+export function getNotificationIndicator(count, hasCritical) {
+    if (count === 0) {
+        return '';
+    }
+    const emoji = hasCritical ? '🔔' : '📬';
+    return `${emoji} ${count}`;
+}
+/**
+ * Format notifications for injection into command output
+ *
+ * This is the main function used by hooks to display notifications
+ * after command execution.
+ *
+ * @param notifications - Pending notifications
+ * @param options - Display options
+ * @returns Formatted string to append to output
+ */
+export function formatNotificationsForOutput(notifications, options = {}) {
+    const { style = 'summary', separator = '\n\n' } = options;
+    if (notifications.length === 0) {
+        return '';
+    }
+    let output;
+    switch (style) {
+        case 'compact':
+            const hasCritical = notifications.some((n) => n.severity === 'critical');
+            output = getNotificationIndicator(notifications.length, hasCritical);
+            break;
+        case 'box':
+            output = formatNotificationBox(notifications);
+            break;
+        case 'summary':
+        default:
+            output = [
+                formatNotificationSummary(notifications),
+                formatNotificationList(notifications, { maxItems: 3 }),
+            ].filter(Boolean).join('\n');
+            break;
+    }
+    return output ? separator + output : '';
+}
+//# sourceMappingURL=notification-display.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification-display.js","sourceRoot":"","sources":["../../../../src/core/notifications/notification-display.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAA0B;IAC3D,MAAM,KAAK,GAAG,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAA0B;IACnE,MAAM,KAAK,GAAG,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,wBAAwB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,GAAG,KAAK,KAAK,IAAI,KAAK,YAAY,CAAC,KAAK,QAAQ,YAAY,CAAC,OAAO,EAAE,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,aAA6B;IACrE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAyC;QACvD,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,CAAC;KACR,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,WAAW,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,WAAW,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC;IACnC,MAAM,UAAU,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC;IAElE,OAAO,MAAM,KAAK,IAAI,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACvF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,aAA6B,EAC7B,UAAwD,EAAE;IAE1D,MAAM,EAAE,QAAQ,GAAG,CAAC,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEtD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAEtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,YAAY,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,aAA6B;IACjE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,IAAI,cAAc,GAAG,CAAC,CAAC;IAElC,SAAS;IACT,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,wBAAwB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvG,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAE9C,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC,IAAI,cAAc,GAAG,CAAC,CAAC;IAElC,wBAAwB;IACxB,MAAM,QAAQ,GAAG,CAAC,CAAC;IACnB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE/C,KAAK,MAAM,YAAY,IAAI,KAAK,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;QACtF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,kBAAkB;IAClB,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACtD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,cAAc,SAAS,OAAO,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,IAAI,cAAc,GAAG,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,WAAoB;IAEpB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,OAAO,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,aAA6B,EAC7B,UAGI,EAAE;IAEN,MAAM,EAAE,KAAK,GAAG,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAE1D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAc,CAAC;IAEnB,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS;YACZ,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;YACzE,MAAM,GAAG,wBAAwB,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACrE,MAAM;QAER,KAAK,KAAK;YACR,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;YAC9C,MAAM;QAER,KAAK,SAAS,CAAC;QACf;YACE,MAAM,GAAG;gBACP,yBAAyB,CAAC,aAAa,CAAC;gBACxC,sBAAsB,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;aACvD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM;IACV,CAAC;IAED,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC"}