Method unshift

cli/src/utils/MessageQueue2.ts:190–220

* Push a message to the beginning of the queue with a mode.

(message: string, mode: T, localId?: string)

     * Push a message to the beginning of the queue with a mode.
     */
    unshift(message: string, mode: T, localId?: string): void {
        if (this.closed) {
            throw new Error('Cannot unshift to closed queue');
        }

        const modeHash = this.modeHasher(mode);
        logger.debug(`[MessageQueue2] unshift() called with mode hash: ${modeHash}`);

        this.queue.unshift({
            message,
            mode,
            modeHash,
            localId,
            isolate: false
        });

        // Trigger message handler if set
        if (this.onMessageHandler) {
            this.onMessageHandler(message, mode);
        }

        // Notify waiter if any
        if (this.waiter) {
            logger.debug(`[MessageQueue2] Notifying waiter`);
            const waiter = this.waiter;
            this.waiter = null;
            waiter(true);
        }

        logger.debug(`[MessageQueue2] unshift() completed. Queue size: ${this.queue.length}`);
    }

    /**
     * Push a message to the beginning of the queue with isolation preserved.