@cloudcli-ai/cloudcli 1.37.1 → 1.37.3

package/dist-server/server/modules/scheduled-messages/services/scheduled-message-dispatcher.service.js

@@ -0,0 +1,163 @@
+import { scheduledMessagesDb, sessionDraftsDb } from '../../../modules/database/index.js';
+import { chatRunRegistry, runDetachedChatTurn } from '../../../modules/websocket/index.js';
+/**
+ * How often due messages are looked for.
+ *
+ * A minute is the granularity the composer offers, and a claim is indexed on
+ * `(status, scheduled_for)`, so the poll is one cheap query. Anything finer
+ * would buy precision nobody asked for.
+ */
+const POLL_INTERVAL_MS = 30_000;
+let pollTimer = null;
+let dispatchInFlight = false;
+function readOptions(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function readQueuedMessage(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    const record = value;
+    const content = typeof record.content === 'string' ? record.content : '';
+    const attachments = Array.isArray(record.attachments)
+        ? record.attachments
+        : Array.isArray(record.images)
+            ? record.images
+            : [];
+    if (!content.trim() && attachments.length === 0) {
+        return null;
+    }
+    const options = record.options && typeof record.options === 'object' && !Array.isArray(record.options)
+        ? record.options
+        : {};
+    return { content, options, attachments };
+}
+async function sendClaimedQueuedMessage(candidate, runtime) {
+    const message = readQueuedMessage(candidate.queuedMessage);
+    if (!message) {
+        sessionDraftsDb.deleteEmptyDraft(candidate.userId, candidate.sessionId);
+        return;
+    }
+    const result = await runDetachedChatTurn({
+        sessionId: candidate.sessionId,
+        userId: candidate.userId,
+        content: message.content,
+        options: { ...message.options, attachments: message.attachments },
+    }, { runtime });
+    // The registry check and run reservation are separate operations. If a run
+    // wins that tiny race, put the turn back so the next poll tries again.
+    if (!result.started && result.error === 'A run was already in progress for this session.') {
+        sessionDraftsDb.restoreQueuedMessage(candidate);
+        return;
+    }
+    sessionDraftsDb.deleteEmptyDraft(candidate.userId, candidate.sessionId);
+}
+/** Sends every persisted queued turn whose session is currently idle. */
+export async function dispatchQueuedMessages(runtime) {
+    const candidates = sessionDraftsDb.listQueuedMessages();
+    let claimed = 0;
+    await Promise.all(candidates.map(async (candidate) => {
+        if (chatRunRegistry.isProcessing(candidate.sessionId)) {
+            return;
+        }
+        if (!sessionDraftsDb.claimQueuedMessage(candidate)) {
+            return;
+        }
+        claimed += 1;
+        await sendClaimedQueuedMessage(candidate, runtime);
+    }));
+    return claimed;
+}
+async function sendClaimedMessage(row, runtime) {
+    try {
+        const result = await runDetachedChatTurn({
+            sessionId: row.session_id,
+            userId: row.user_id,
+            content: row.content,
+            options: readOptions(row.options),
+            // The user picked this time on purpose; a run that happens to be going
+            // is aborted so the scheduled message lands when it was due, instead
+            // of being recorded as "not sent — session was busy".
+            interruptActiveRun: true,
+        }, { runtime });
+        // Recorded rather than retried, and recorded whether the run never started
+        // (deleted session, unavailable provider) or started and then failed.
+        // Silently dropping a message the user scheduled is worse than telling
+        // them it did not go.
+        if (!result.started || result.error) {
+            scheduledMessagesDb.markFailed(row.id, result.error ?? 'The session was unavailable when this was due.');
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        scheduledMessagesDb.markFailed(row.id, message);
+    }
+}
+/**
+ * Sends every message whose time has come.
+ *
+ * Exported so a test can drive one pass without waiting on the timer.
+ */
+export async function dispatchDueScheduledMessages(runtime, now = new Date()) {
+    // Claimed before any of them runs, so a long turn cannot let the next poll
+    // pick the same message up again.
+    const due = scheduledMessagesDb.claimDue(now);
+    if (due.length === 0) {
+        return 0;
+    }
+    // Sequentially: a session can only have one run at a time, and two due
+    // messages for the same session must not race each other into it.
+    for (const row of due) {
+        await sendClaimedMessage(row, runtime);
+    }
+    return due.length;
+}
+/**
+ * Starts the poll that sends scheduled messages.
+ *
+ * The schedule lives in the database, so a message stays scheduled across a
+ * restart and one that came due while the server was down is sent on the first
+ * poll after it comes back, rather than being skipped.
+ */
+export function initializeScheduledMessageDispatcher(runtime) {
+    if (pollTimer) {
+        return;
+    }
+    const poll = () => {
+        // A pass that overruns the interval must not be started again underneath
+        // itself; the claim is transactional but the runs are not.
+        if (dispatchInFlight) {
+            return;
+        }
+        dispatchInFlight = true;
+        void dispatchDueScheduledMessages(runtime)
+            .then(() => dispatchQueuedMessages(runtime))
+            .catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error('[ScheduledMessages] Dispatch pass failed', { error: message });
+        })
+            .finally(() => {
+            dispatchInFlight = false;
+        });
+    };
+    pollTimer = setInterval(poll, POLL_INTERVAL_MS);
+    // Never keep the process alive just to poll for scheduled messages.
+    pollTimer.unref?.();
+    // Catch up on anything that came due while the server was not running.
+    poll();
+}
+export function closeScheduledMessageDispatcher() {
+    if (pollTimer) {
+        clearInterval(pollTimer);
+        pollTimer = null;
+    }
+}
+//# sourceMappingURL=scheduled-message-dispatcher.service.js.map

package/dist-server/server/modules/scheduled-messages/services/scheduled-message-dispatcher.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-message-dispatcher.service.js","sourceRoot":"","sources":["../../../../../server/modules/scheduled-messages/services/scheduled-message-dispatcher.service.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/scheduled-messages/services/scheduled-messages.service.js

@@ -0,0 +1,95 @@
+import { scheduledMessagesDb, sessionsDb } from '../../../modules/database/index.js';
+import { AppError } from '../../../shared/utils.js';
+/** How far ahead a message may be scheduled. Beyond this it is almost certainly a mistake. */
+const MAX_SCHEDULE_AHEAD_MS = 365 * 24 * 60 * 60 * 1000;
+const MAX_CONTENT_LENGTH = 100_000;
+function readOptions(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        // A corrupt options blob must not stop the message from being sent.
+        return {};
+    }
+}
+export function toScheduledMessage(row) {
+    return {
+        id: row.id,
+        sessionId: row.session_id,
+        content: row.content,
+        options: readOptions(row.options),
+        scheduledFor: row.scheduled_for,
+        status: row.status,
+        failureReason: row.failure_reason,
+        createdAt: row.created_at,
+    };
+}
+export const scheduledMessagesService = {
+    /**
+     * Records a message to send to a session later.
+     *
+     * The time is taken as an absolute instant, so the schedule does not move if
+     * the user changes time zone — or schedules from a phone and is on a laptop
+     * when it fires.
+     */
+    schedule(input) {
+        const content = input.content.trim();
+        if (!content) {
+            throw new AppError('A scheduled message needs some text.', {
+                code: 'CONTENT_REQUIRED',
+                statusCode: 400,
+            });
+        }
+        if (content.length > MAX_CONTENT_LENGTH) {
+            throw new AppError('That message is too long to schedule.', {
+                code: 'CONTENT_TOO_LONG',
+                statusCode: 400,
+            });
+        }
+        const scheduledFor = new Date(input.scheduledFor);
+        if (Number.isNaN(scheduledFor.getTime())) {
+            throw new AppError('scheduledFor must be an ISO timestamp.', {
+                code: 'INVALID_SCHEDULE_TIME',
+                statusCode: 400,
+            });
+        }
+        if (scheduledFor.getTime() - Date.now() > MAX_SCHEDULE_AHEAD_MS) {
+            throw new AppError('That is too far in the future to schedule.', {
+                code: 'SCHEDULE_TOO_FAR_AHEAD',
+                statusCode: 400,
+            });
+        }
+        if (!sessionsDb.getSessionById(input.sessionId)) {
+            throw new AppError(`Session "${input.sessionId}" was not found.`, {
+                code: 'SESSION_NOT_FOUND',
+                statusCode: 404,
+            });
+        }
+        return toScheduledMessage(scheduledMessagesDb.create({
+            userId: input.userId,
+            sessionId: input.sessionId,
+            content,
+            options: input.options ?? {},
+            scheduledFor,
+        }));
+    },
+    listForSession(userId, sessionId) {
+        return scheduledMessagesDb.listForSession(userId, sessionId).map(toScheduledMessage);
+    },
+    listPending(userId) {
+        return scheduledMessagesDb.listPendingForUser(userId).map(toScheduledMessage);
+    },
+    /** Cancels a pending message, or dismisses a failed one. */
+    cancel(userId, id) {
+        if (!scheduledMessagesDb.cancel(userId, id)) {
+            throw new AppError('That message has already been sent or cancelled.', {
+                code: 'SCHEDULED_MESSAGE_NOT_PENDING',
+                statusCode: 409,
+            });
+        }
+    },
+};
+//# sourceMappingURL=scheduled-messages.service.js.map

package/dist-server/server/modules/scheduled-messages/services/scheduled-messages.service.js.map

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

package/dist-server/server/modules/scheduled-messages/tests/scheduled-messages.test.js

@@ -0,0 +1,255 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { closeConnection, initializeDatabase, scheduledMessagesDb, sessionDraftsDb, sessionsDb, userDb } from '../../../modules/database/index.js';
+import { dispatchDueScheduledMessages, dispatchQueuedMessages } from '../../../modules/scheduled-messages/services/scheduled-message-dispatcher.service.js';
+import { scheduledMessagesService } from '../../../modules/scheduled-messages/services/scheduled-messages.service.js';
+import { chatRunRegistry } from '../../../modules/websocket/index.js';
+const SESSION_ID = 'scheduled-session';
+async function withIsolatedDatabase(runTest) {
+    const previousDatabasePath = process.env.DATABASE_PATH;
+    const tempDirectory = await mkdtemp(path.join(tmpdir(), 'scheduled-messages-'));
+    closeConnection();
+    process.env.DATABASE_PATH = path.join(tempDirectory, 'auth.db');
+    await initializeDatabase();
+    try {
+        const user = userDb.createUser('scheduler', 'hash');
+        sessionsDb.createAppSession(SESSION_ID, 'claude', tempDirectory, 'Scheduled session');
+        await runTest(Number(user.id));
+    }
+    finally {
+        chatRunRegistry.clearAll();
+        closeConnection();
+        if (previousDatabasePath === undefined) {
+            delete process.env.DATABASE_PATH;
+        }
+        else {
+            process.env.DATABASE_PATH = previousDatabasePath;
+        }
+        await rm(tempDirectory, { recursive: true, force: true });
+    }
+}
+function createRuntime(runs, behaviour = 'ok', aborts = []) {
+    return {
+        hasRuntime: () => true,
+        run: async (provider, command, options) => {
+            if (behaviour === 'throw') {
+                throw new Error('provider exploded');
+            }
+            runs.push({ provider, command, options });
+        },
+        abort: async (_provider, sessionId) => {
+            aborts.push(sessionId);
+            return true;
+        },
+    };
+}
+test('a message due in the past is sent on the next pass, not skipped', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        // The server was down when this came due.
+        scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'run the nightly checks',
+            scheduledFor: new Date(Date.now() - 60_000).toISOString(),
+        });
+        const runs = [];
+        const sent = await dispatchDueScheduledMessages(createRuntime(runs));
+        assert.equal(sent, 1);
+        assert.equal(runs.length, 1);
+        assert.equal(runs[0].command, 'run the nightly checks');
+        assert.equal(scheduledMessagesDb.listForSession(userId, SESSION_ID)[0].status, 'sent');
+    });
+});
+test('a queued message is sent by the server without a browser connection', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        sessionDraftsDb.saveDraft(userId, SESSION_ID, {
+            text: '',
+            queuedMessage: {
+                content: 'continue on the VPS',
+                options: { model: 'claude-opus-5' },
+                attachments: [{ path: '/tmp/upload.png' }],
+            },
+        });
+        const runs = [];
+        assert.equal(await dispatchQueuedMessages(createRuntime(runs)), 1);
+        assert.equal(runs.length, 1);
+        assert.equal(runs[0].command, 'continue on the VPS');
+        assert.equal(runs[0].options.model, 'claude-opus-5');
+        assert.deepEqual(runs[0].options.attachments, []);
+        assert.equal(sessionDraftsDb.getDrafts(userId).length, 0);
+    });
+});
+test('a queued message stays pending while its session is busy', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        sessionDraftsDb.saveDraft(userId, SESSION_ID, {
+            text: '',
+            queuedMessage: { content: 'send after this run' },
+        });
+        chatRunRegistry.startRun({
+            appSessionId: SESSION_ID,
+            provider: 'claude',
+            providerSessionId: null,
+            connection: null,
+            userId,
+        });
+        const runs = [];
+        assert.equal(await dispatchQueuedMessages(createRuntime(runs)), 0);
+        assert.equal(runs.length, 0);
+        assert.deepEqual(sessionDraftsDb.getDrafts(userId)[0]?.queuedMessage, {
+            content: 'send after this run',
+        });
+    });
+});
+test('a due message interrupts a run in progress instead of failing', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'the schedule wins',
+            scheduledFor: new Date(Date.now() - 1_000).toISOString(),
+        });
+        chatRunRegistry.startRun({
+            appSessionId: SESSION_ID,
+            provider: 'claude',
+            providerSessionId: null,
+            connection: null,
+            userId,
+        });
+        const runs = [];
+        const aborts = [];
+        assert.equal(await dispatchDueScheduledMessages(createRuntime(runs, 'ok', aborts)), 1);
+        assert.deepEqual(aborts, [SESSION_ID]);
+        assert.equal(runs.length, 1);
+        assert.equal(runs[0].command, 'the schedule wins');
+        assert.equal(scheduledMessagesDb.listForSession(userId, SESSION_ID)[0].status, 'sent');
+    });
+});
+test('a message that is not due yet is left alone', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'later',
+            scheduledFor: new Date(Date.now() + 3_600_000).toISOString(),
+        });
+        const runs = [];
+        assert.equal(await dispatchDueScheduledMessages(createRuntime(runs)), 0);
+        assert.equal(runs.length, 0);
+        assert.equal(scheduledMessagesDb.listForSession(userId, SESSION_ID)[0].status, 'pending');
+    });
+});
+test('a due message is claimed once, so overlapping passes cannot double-send it', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'only once',
+            scheduledFor: new Date(Date.now() - 1_000).toISOString(),
+        });
+        const runs = [];
+        const runtime = createRuntime(runs);
+        await Promise.all([
+            dispatchDueScheduledMessages(runtime),
+            dispatchDueScheduledMessages(runtime),
+        ]);
+        assert.equal(runs.length, 1);
+    });
+});
+test('the composer settings it was scheduled with travel with it', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'with options',
+            options: { model: 'claude-opus-5', permissionMode: 'plan' },
+            scheduledFor: new Date(Date.now() - 1_000).toISOString(),
+        });
+        const runs = [];
+        await dispatchDueScheduledMessages(createRuntime(runs));
+        assert.equal(runs[0].options.model, 'claude-opus-5');
+        assert.equal(runs[0].options.permissionMode, 'plan');
+    });
+});
+test('a provider failure is recorded on the message instead of vanishing', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'will fail',
+            scheduledFor: new Date(Date.now() - 1_000).toISOString(),
+        });
+        await dispatchDueScheduledMessages(createRuntime([], 'throw'));
+        const row = scheduledMessagesDb.listForSession(userId, SESSION_ID)[0];
+        assert.equal(row.status, 'failed');
+        assert.match(row.failure_reason ?? '', /provider exploded/);
+    });
+});
+test('a cancelled message never fires', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        const scheduled = scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'never mind',
+            scheduledFor: new Date(Date.now() - 1_000).toISOString(),
+        });
+        scheduledMessagesService.cancel(userId, scheduled.id);
+        const runs = [];
+        assert.equal(await dispatchDueScheduledMessages(createRuntime(runs)), 0);
+        assert.equal(runs.length, 0);
+    });
+});
+test('a failed message can be dismissed, and stays dismissed', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        const scheduled = scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'will fail',
+            scheduledFor: new Date(Date.now() - 1_000).toISOString(),
+        });
+        await dispatchDueScheduledMessages(createRuntime([], 'throw'));
+        assert.equal(scheduledMessagesDb.listForSession(userId, SESSION_ID)[0].status, 'failed');
+        scheduledMessagesService.cancel(userId, scheduled.id);
+        assert.equal(scheduledMessagesDb.listForSession(userId, SESSION_ID)[0].status, 'cancelled');
+    });
+});
+test('cancelling something that already fired is refused', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        const scheduled = scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'gone',
+            scheduledFor: new Date(Date.now() - 1_000).toISOString(),
+        });
+        await dispatchDueScheduledMessages(createRuntime([]));
+        assert.throws(() => scheduledMessagesService.cancel(userId, scheduled.id), (error) => error.code === 'SCHEDULED_MESSAGE_NOT_PENDING');
+    });
+});
+test('one user cannot cancel another user\'s scheduled message', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        const scheduled = scheduledMessagesService.schedule({
+            userId,
+            sessionId: SESSION_ID,
+            content: 'mine',
+            scheduledFor: new Date(Date.now() + 3_600_000).toISOString(),
+        });
+        assert.throws(() => scheduledMessagesService.cancel(userId + 1, scheduled.id), (error) => error.code === 'SCHEDULED_MESSAGE_NOT_PENDING');
+        assert.equal(scheduledMessagesDb.listForSession(userId, SESSION_ID)[0].status, 'pending');
+    });
+});
+test('scheduling validates its input', async () => {
+    await withIsolatedDatabase(async (userId) => {
+        const base = { userId, sessionId: SESSION_ID, scheduledFor: new Date(Date.now() + 1000).toISOString() };
+        assert.throws(() => scheduledMessagesService.schedule({ ...base, content: '   ' }), (error) => error.code === 'CONTENT_REQUIRED');
+        assert.throws(() => scheduledMessagesService.schedule({ ...base, content: 'hi', scheduledFor: 'not a date' }), (error) => error.code === 'INVALID_SCHEDULE_TIME');
+        assert.throws(() => scheduledMessagesService.schedule({
+            ...base,
+            content: 'hi',
+            scheduledFor: new Date(Date.now() + 400 * 24 * 3600 * 1000).toISOString(),
+        }), (error) => error.code === 'SCHEDULE_TOO_FAR_AHEAD');
+        assert.throws(() => scheduledMessagesService.schedule({ ...base, sessionId: 'nope', content: 'hi' }), (error) => error.code === 'SESSION_NOT_FOUND');
+    });
+});
+//# sourceMappingURL=scheduled-messages.test.js.map

package/dist-server/server/modules/scheduled-messages/tests/scheduled-messages.test.js.map

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

package/dist-server/server/modules/taskmaster/taskmaster.routes.js

@@ -10,8 +10,18 @@
  */
 import path from 'path';
 import express from 'express';
-function broadcastTaskMasterUpdate(wss, type, projectId, payloadKey, payload) {
-    if (!wss || !projectId)
+import { WS_OPEN_STATE, connectedClients } from '../../modules/websocket/index.js';
+/**
+ * These frames are `type`-keyed and only TaskMasterContext, which lives on the
+ * `/ws` chat socket, knows what to do with them. Broadcasting over the raw
+ * `wss.clients` set instead delivered them to every `/shell`, `/plugin-ws` and
+ * `/desktop-notifications` socket as well, where they were parsed and dropped —
+ * and, on `/plugin-ws`, handed to third-party plugin frontends that have no
+ * business seeing them. `connectedClients` is the `/ws`-only set every other
+ * broadcast in the server already uses.
+ */
+function broadcastTaskMasterUpdate(type, projectId, payloadKey, payload) {
+    if (!projectId)
         return;
     const message = JSON.stringify({
         type,
@@ -19,16 +29,16 @@ function broadcastTaskMasterUpdate(wss, type, projectId, payloadKey, payload) {
         ...(payload === undefined ? {} : { [payloadKey]: payload }),
         timestamp: new Date().toISOString(),
     });
-    wss.clients.forEach((client) => {
-        if (client.readyState === 1)
+    connectedClients.forEach((client) => {
+        if (client.readyState === WS_OPEN_STATE)
             client.send(message);
     });
 }
-function broadcastTaskMasterProjectUpdate(wss, projectId, taskMasterData) {
-    broadcastTaskMasterUpdate(wss, 'taskmaster-project-updated', projectId, 'taskMasterData', taskMasterData);
+function broadcastTaskMasterProjectUpdate(projectId, taskMasterData) {
+    broadcastTaskMasterUpdate('taskmaster-project-updated', projectId, 'taskMasterData', taskMasterData);
 }
-function broadcastTaskMasterTasksUpdate(wss, projectId, tasksData) {
-    broadcastTaskMasterUpdate(wss, 'taskmaster-tasks-updated', projectId, 'tasksData', tasksData);
+function broadcastTaskMasterTasksUpdate(projectId, tasksData) {
+    broadcastTaskMasterUpdate('taskmaster-tasks-updated', projectId, 'tasksData', tasksData);
 }
 /**
  * Resolve the absolute project directory from a DB-assigned `projectId`.
@@ -530,9 +540,7 @@ export function createTaskmasterRouter(dependencies) {
                     // Broadcast TaskMaster project update via WebSocket. The
                     // WebSocket payload keeps using `projectId` so the frontend
                     // can match notifications against the current selection.
-                    if (req.app.locals.wss) {
-                        broadcastTaskMasterProjectUpdate(req.app.locals.wss, projectId, { hasTaskmaster: true, status: 'initialized' });
-                    }
+                    broadcastTaskMasterProjectUpdate(projectId, { hasTaskmaster: true, status: 'initialized' });
                     res.json({
                         projectId,
                         projectPath,
@@ -609,9 +617,7 @@ export function createTaskmasterRouter(dependencies) {
                 if (code === 0) {
                     // Broadcast task update via WebSocket using the projectId so
                     // clients subscribed to this project get notified immediately.
-                    if (req.app.locals.wss) {
-                        broadcastTaskMasterTasksUpdate(req.app.locals.wss, projectId);
-                    }
+                    broadcastTaskMasterTasksUpdate(projectId);
                     res.json({
                         projectId,
                         projectPath,
@@ -662,9 +668,7 @@ export function createTaskmasterRouter(dependencies) {
                 }, ({ code, error, stdout, stderr }) => {
                     if (code === 0) {
                         // Broadcast task update via WebSocket
-                        if (req.app.locals.wss) {
-                            broadcastTaskMasterTasksUpdate(req.app.locals.wss, projectId);
-                        }
+                        broadcastTaskMasterTasksUpdate(projectId);
                         res.json({
                             projectId,
                             projectPath,
@@ -703,9 +707,7 @@ export function createTaskmasterRouter(dependencies) {
                 }, ({ code, error, stdout, stderr }) => {
                     if (code === 0) {
                         // Broadcast task update via WebSocket
-                        if (req.app.locals.wss) {
-                            broadcastTaskMasterTasksUpdate(req.app.locals.wss, projectId);
-                        }
+                        broadcastTaskMasterTasksUpdate(projectId);
                         res.json({
                             projectId,
                             projectPath,
@@ -777,9 +779,7 @@ export function createTaskmasterRouter(dependencies) {
             }, ({ code, error, stdout, stderr }) => {
                 if (code === 0) {
                     // Broadcast task update via WebSocket
-                    if (req.app.locals.wss) {
-                        broadcastTaskMasterTasksUpdate(req.app.locals.wss, projectId);
-                    }
+                    broadcastTaskMasterTasksUpdate(projectId);
                     res.json({
                         projectId,
                         projectPath,