feat: implement real-time dashboard updates via WebSockets

shared/modules/dashboard/dashboard.service.test.ts

@@ -153,4 +153,33 @@ describe("dashboardService", () => {
             );
         });
     });
+
+    describe("recordEvent", () => {
+        test("should emit NEW_EVENT to systemEvents", async () => {
+            const mockEmit = mock(() => { });
+
+            mock.module("@shared/lib/events", () => ({
+                systemEvents: {
+                    emit: mockEmit,
+                },
+                EVENTS: {
+                    DASHBOARD: {
+                        NEW_EVENT: "dashboard:new_event",
+                    }
+                }
+            }));
+
+            await dashboardService.recordEvent({
+                type: 'info',
+                message: 'Test Event',
+                icon: '🚀'
+            });
+
+            expect(mockEmit).toHaveBeenCalled();
+            const [eventName, data] = mockEmit.mock.calls[0] as any;
+            expect(eventName).toBe("dashboard:new_event");
+            expect(data.message).toBe("Test Event");
+            expect(data.timestamp).toBeDefined();
+        });
+    });
 });

shared/modules/dashboard/dashboard.service.ts

@@ -126,6 +126,27 @@ export const dashboardService = {
 
         return allEvents;
     },
+
+    /**
+     * Records a new internal event and broadcasts it via WebSocket
+     */
+    recordEvent: async (event: Omit<RecentEvent, 'timestamp'>): Promise<void> => {
+        const fullEvent: RecentEvent = {
+            ...event,
+            timestamp: new Date(),
+        };
+
+        // Broadcast to WebSocket clients
+        try {
+            const { systemEvents, EVENTS } = await import("@shared/lib/events");
+            systemEvents.emit(EVENTS.DASHBOARD.NEW_EVENT, {
+                ...fullEvent,
+                timestamp: fullEvent.timestamp.toISOString()
+            });
+        } catch (e) {
+            console.error("Failed to emit system event:", e);
+        }
+    },
 };
 
 /**