reflectt-node 0.1.0

package/dist/events.js

@@ -0,0 +1,382 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+export const VALID_EVENT_TYPES = new Set([
+    'message_posted',
+    'task_created',
+    'task_assigned',
+    'task_updated',
+    'memory_written',
+    'presence_updated',
+    'reflection_created',
+    'insight_created',
+]);
+class EventBus {
+    subscriptions = new Map();
+    internalListeners = new Map();
+    eventLog = [];
+    maxLogSize = 1000;
+    batchWindowMs = 2000; // Default: 2 seconds
+    pendingEvents = [];
+    batchTimer = null;
+    keepaliveTimer = null;
+    static KEEPALIVE_INTERVAL_MS = 30000; // SSE keepalive every 30s
+    constructor() {
+        this.startKeepalive();
+    }
+    /**
+     * Send SSE keepalive comments to prevent proxy/Docker network timeouts.
+     * SSE comment lines (starting with ':') are ignored by EventSource clients.
+     */
+    startKeepalive() {
+        this.keepaliveTimer = setInterval(() => {
+            for (const [id, sub] of this.subscriptions) {
+                try {
+                    if (!sub.reply.raw.destroyed) {
+                        sub.reply.raw.write(`:keepalive ${Date.now()}\n\n`);
+                    }
+                    else {
+                        this.subscriptions.delete(id);
+                    }
+                }
+                catch {
+                    this.subscriptions.delete(id);
+                }
+            }
+        }, EventBus.KEEPALIVE_INTERVAL_MS);
+        this.keepaliveTimer.unref();
+    }
+    stopKeepalive() {
+        if (this.keepaliveTimer) {
+            clearInterval(this.keepaliveTimer);
+            this.keepaliveTimer = null;
+        }
+    }
+    /**
+     * Register an in-process listener for events.
+     * Used for internal automation (e.g., insight→task bridge).
+     */
+    on(listenerId, listener) {
+        this.internalListeners.set(listenerId, listener);
+    }
+    /**
+     * Remove an in-process listener.
+     */
+    off(listenerId) {
+        this.internalListeners.delete(listenerId);
+    }
+    /**
+     * Subscribe to events via SSE
+     */
+    subscribe(reply, agent, topics, types) {
+        const id = `sub-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        // Set up SSE headers
+        reply.raw.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        });
+        // Validate and filter event types — unknown types are silently ignored
+        const validTypes = (types || [])
+            .map(t => t.trim())
+            .filter(t => VALID_EVENT_TYPES.has(t));
+        const subscription = {
+            id,
+            reply,
+            agent,
+            topics,
+            types: validTypes.length > 0 ? validTypes : undefined,
+            createdAt: Date.now(),
+        };
+        this.subscriptions.set(id, subscription);
+        // Send initial connection event
+        this.sendEvent(reply, {
+            id: `evt-${Date.now()}`,
+            type: 'message_posted',
+            timestamp: Date.now(),
+            data: {
+                message: `Connected to event stream (subscription ${id})`,
+                agent,
+                topics,
+                types: validTypes.length > 0 ? validTypes : undefined,
+            },
+        });
+        // Clean up on close
+        reply.raw.on('close', () => {
+            this.subscriptions.delete(id);
+            console.log(`[Events] Subscription ${id} closed (${this.subscriptions.size} remaining)`);
+        });
+        console.log(`[Events] New subscription ${id} (agent: ${agent || 'all'}, topics: ${topics?.join(',') || 'all'}, types: ${validTypes.length > 0 ? validTypes.join(',') : 'all'})`);
+        return id;
+    }
+    /**
+     * Get batch configuration
+     */
+    getBatchConfig() {
+        return { batchWindowMs: this.batchWindowMs };
+    }
+    /**
+     * Set batch configuration
+     */
+    setBatchConfig(batchWindowMs) {
+        if (batchWindowMs < 0) {
+            throw new Error('batchWindowMs must be non-negative');
+        }
+        this.batchWindowMs = batchWindowMs;
+        console.log(`[Events] Batch window set to ${batchWindowMs}ms`);
+    }
+    /**
+     * Emit an event to all matching subscriptions (with batching)
+     */
+    emit(event) {
+        // Add to log
+        this.eventLog.push(event);
+        if (this.eventLog.length > this.maxLogSize) {
+            this.eventLog.shift();
+        }
+        // Fire internal listeners (async, non-blocking)
+        for (const [id, listener] of this.internalListeners) {
+            try {
+                const result = listener(event);
+                if (result instanceof Promise) {
+                    result.catch(err => console.error(`[EventBus] Internal listener '${id}' error:`, err));
+                }
+            }
+            catch (err) {
+                console.error(`[EventBus] Internal listener '${id}' error:`, err);
+            }
+        }
+        // Add to pending batch
+        this.pendingEvents.push(event);
+        // Clear existing timer
+        if (this.batchTimer) {
+            clearTimeout(this.batchTimer);
+        }
+        // Set new timer to flush batch
+        this.batchTimer = setTimeout(() => {
+            this.flushBatch();
+        }, this.batchWindowMs);
+    }
+    /**
+     * Flush the pending event batch to subscribers
+     */
+    flushBatch() {
+        if (this.pendingEvents.length === 0) {
+            return;
+        }
+        const events = [...this.pendingEvents];
+        this.pendingEvents = [];
+        this.batchTimer = null;
+        // If only one event, send it normally (no batch wrapper)
+        if (events.length === 1) {
+            const event = events[0];
+            let sent = 0;
+            for (const [id, subscription] of this.subscriptions) {
+                if (this.shouldReceive(subscription, event)) {
+                    try {
+                        this.sendEvent(subscription.reply, event);
+                        sent++;
+                    }
+                    catch (err) {
+                        console.error(`[Events] Failed to send to ${id}:`, err);
+                        this.subscriptions.delete(id);
+                    }
+                }
+            }
+            if (sent > 0) {
+                console.log(`[Events] Emitted ${event.type} to ${sent} subscribers`);
+            }
+            return;
+        }
+        // Multiple events - send as batch
+        let sent = 0;
+        for (const [id, subscription] of this.subscriptions) {
+            // Filter events for this subscription
+            const filteredEvents = events.filter(event => this.shouldReceive(subscription, event));
+            if (filteredEvents.length > 0) {
+                try {
+                    this.sendBatchEvent(subscription.reply, filteredEvents);
+                    sent++;
+                }
+                catch (err) {
+                    console.error(`[Events] Failed to send batch to ${id}:`, err);
+                    this.subscriptions.delete(id);
+                }
+            }
+        }
+        if (sent > 0) {
+            console.log(`[Events] Emitted batch of ${events.length} events to ${sent} subscribers`);
+        }
+    }
+    /**
+     * Check if a subscription should receive an event
+     */
+    shouldReceive(subscription, event) {
+        // Filter by exact event type (e.g., ?types=task_created,task_updated)
+        if (subscription.types && subscription.types.length > 0) {
+            if (!subscription.types.includes(event.type)) {
+                return false;
+            }
+        }
+        // Filter by topic (e.g., "chat", "tasks", "memory") — loose match
+        if (subscription.topics && subscription.topics.length > 0) {
+            const eventTopic = event.type.split('_')[0]; // "message_posted" -> "message"
+            if (!subscription.topics.some(topic => eventTopic.includes(topic) || event.type.includes(topic))) {
+                return false;
+            }
+        }
+        // Filter by agent (for agent-specific events like task_assigned)
+        if (subscription.agent) {
+            const data = event.data;
+            // Check if event is relevant to this agent
+            if (event.type === 'task_assigned' && data.assignee !== subscription.agent) {
+                return false;
+            }
+            if (event.type === 'message_posted' && data.to && data.to !== subscription.agent) {
+                return false;
+            }
+            if (event.type === 'memory_written' && data.agent !== subscription.agent) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Send an event to an SSE connection
+     */
+    sendEvent(reply, event) {
+        const message = `event: ${event.type}\ndata: ${JSON.stringify(event.data)}\nid: ${event.id}\n\n`;
+        reply.raw.write(message);
+    }
+    /**
+     * Send a batch of events to an SSE connection
+     */
+    sendBatchEvent(reply, events) {
+        const batchData = events.map(e => ({
+            id: e.id,
+            type: e.type,
+            timestamp: e.timestamp,
+            data: e.data,
+        }));
+        const message = `event: batch\ndata: ${JSON.stringify(batchData)}\n\n`;
+        reply.raw.write(message);
+    }
+    /**
+     * Get event bus statistics
+     */
+    getStatus() {
+        return {
+            connected: this.subscriptions.size,
+            eventLog: this.eventLog.length,
+            subscriptions: Array.from(this.subscriptions.values()).map(sub => ({
+                id: sub.id,
+                agent: sub.agent,
+                topics: sub.topics,
+                types: sub.types,
+                connectedMs: Date.now() - sub.createdAt,
+            })),
+        };
+    }
+    /**
+     * Helper: Emit message_posted event
+     */
+    emitMessagePosted(message) {
+        this.emit({
+            id: `evt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            type: 'message_posted',
+            timestamp: Date.now(),
+            data: message,
+        });
+    }
+    /**
+     * Helper: Emit task_created event
+     */
+    emitTaskCreated(task) {
+        this.emit({
+            id: `evt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            type: 'task_created',
+            timestamp: Date.now(),
+            data: task,
+        });
+    }
+    /**
+     * Helper: Emit task_assigned event
+     */
+    emitTaskAssigned(task) {
+        if (task.assignee) {
+            this.emit({
+                id: `evt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                type: 'task_assigned',
+                timestamp: Date.now(),
+                data: task,
+            });
+        }
+    }
+    /**
+     * Helper: Emit task_updated event
+     */
+    emitTaskUpdated(task, updates) {
+        this.emit({
+            id: `evt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            type: 'task_updated',
+            timestamp: Date.now(),
+            data: {
+                ...task,
+                updates,
+            },
+        });
+    }
+    /**
+     * Helper: Emit memory_written event
+     */
+    emitMemoryWritten(agent, filename, path) {
+        this.emit({
+            id: `evt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            type: 'memory_written',
+            timestamp: Date.now(),
+            data: {
+                agent,
+                filename,
+                path,
+            },
+        });
+    }
+    /**
+     * Helper: Emit presence_updated event
+     */
+    emitPresenceUpdated(presence) {
+        this.emit({
+            id: `evt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            type: 'presence_updated',
+            timestamp: Date.now(),
+            data: presence,
+        });
+    }
+    /**
+     * Get event log for activity feed
+     */
+    getEvents(filters) {
+        let events = [...this.eventLog];
+        // Filter by timestamp
+        if (filters?.since) {
+            events = events.filter(e => e.timestamp >= filters.since);
+        }
+        // Filter by agent (for agent-specific activity)
+        if (filters?.agent) {
+            events = events.filter(e => {
+                const data = e.data;
+                // Include events where the agent is involved
+                return (data.agent === filters.agent ||
+                    data.from === filters.agent ||
+                    data.to === filters.agent ||
+                    data.assignee === filters.agent ||
+                    data.createdBy === filters.agent);
+            });
+        }
+        // Apply limit (most recent first)
+        const limit = filters?.limit || 100;
+        events = events.slice(-limit).reverse();
+        return events;
+    }
+}
+export const eventBus = new EventBus();
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAyB5B,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAY;IAClD,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,kBAAkB;IAClB,oBAAoB;IACpB,iBAAiB;CAClB,CAAC,CAAA;AAoBF,MAAM,QAAQ;IACJ,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAA;IAC/C,iBAAiB,GAAG,IAAI,GAAG,EAA4B,CAAA;IACvD,QAAQ,GAAY,EAAE,CAAA;IACtB,UAAU,GAAG,IAAI,CAAA;IACjB,aAAa,GAAG,IAAI,CAAA,CAAC,qBAAqB;IAC1C,aAAa,GAAY,EAAE,CAAA;IAC3B,UAAU,GAA0B,IAAI,CAAA;IACxC,cAAc,GAA0B,IAAI,CAAA;IAC5C,MAAM,CAAU,qBAAqB,GAAG,KAAK,CAAA,CAAC,0BAA0B;IAEhF;QACE,IAAI,CAAC,cAAc,EAAE,CAAA;IACvB,CAAC;IAED;;;OAGG;IACK,cAAc;QACpB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC3C,IAAI,CAAC;oBACH,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;wBAC7B,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;oBACrD,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;oBAC/B,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAA;QAClC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;IAC7B,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC5B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,EAAE,CAAC,UAAkB,EAAE,QAA0B;QAC/C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IAClD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,UAAkB;QACpB,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAmB,EAAE,KAAc,EAAE,MAAiB,EAAE,KAAgB;QAChF,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;QAEzE,qBAAqB;QACrB,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACvB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAA;QAEF,uEAAuE;QACvE,MAAM,UAAU,GAAgB,CAAC,KAAK,IAAI,EAAE,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAe,CAAC;aAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAExC,MAAM,YAAY,GAAiB;YACjC,EAAE;YACF,KAAK;YACL,KAAK;YACL,MAAM;YACN,KAAK,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACrD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAA;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAA;QAExC,gCAAgC;QAChC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE;YACpB,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE;YACvB,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE;gBACJ,OAAO,EAAE,2CAA2C,EAAE,GAAG;gBACzD,KAAK;gBACL,MAAM;gBACN,KAAK,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aACtD;SACF,CAAC,CAAA;QAEF,oBAAoB;QACpB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACzB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC7B,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,YAAY,IAAI,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAA;QAC1F,CAAC,CAAC,CAAA;QAEF,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,YAAY,KAAK,IAAI,KAAK,aAAa,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAA;QAEhL,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAA;IAC9C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,aAAqB;QAClC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACvD,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,OAAO,CAAC,GAAG,CAAC,gCAAgC,aAAa,IAAI,CAAC,CAAA;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAY;QACf,aAAa;QACb,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;QAED,gDAAgD;QAChD,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;gBAC9B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAA;gBACxF,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,UAAU,EAAE,GAAG,CAAC,CAAA;YACnE,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAE9B,uBAAuB;QACvB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/B,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,UAAU,EAAE,CAAA;QACnB,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;IACxB,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAM;QACR,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAA;QACtC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QAEtB,yDAAyD;QACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;YACvB,IAAI,IAAI,GAAG,CAAC,CAAA;YACZ,KAAK,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACpD,IAAI,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC5C,IAAI,CAAC;wBACH,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;wBACzC,IAAI,EAAE,CAAA;oBACR,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;wBACvD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,IAAI,OAAO,IAAI,cAAc,CAAC,CAAA;YACtE,CAAC;YACD,OAAM;QACR,CAAC;QAED,kCAAkC;QAClC,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,KAAK,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACpD,sCAAsC;YACtC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAA;YAEtF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,IAAI,CAAC;oBACH,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;oBACvD,IAAI,EAAE,CAAA;gBACR,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;oBAC7D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,MAAM,cAAc,IAAI,cAAc,CAAC,CAAA;QACzF,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,YAA0B,EAAE,KAAY;QAC5D,sEAAsE;QACtE,IAAI,YAAY,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,IAAI,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA,CAAC,gCAAgC;YAC5E,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CACpC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CACzD,EAAE,CAAC;gBACF,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAW,CAAA;YAE9B,2CAA2C;YAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,QAAQ,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC3E,OAAO,KAAK,CAAA;YACd,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBACjF,OAAO,KAAK,CAAA;YACd,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBACzE,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,KAAmB,EAAE,KAAY;QACjD,MAAM,OAAO,GAAG,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,MAAM,CAAA;QAChG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,KAAmB,EAAE,MAAe;QACzD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAA;QACH,MAAM,OAAO,GAAG,uBAAuB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAA;QACtE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;YAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC9B,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjE,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,SAAS;aACxC,CAAC,CAAC;SACJ,CAAA;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAqB;QACrC,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAClE,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,OAAO;SACd,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAU;QACxB,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAClE,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,IAAI;SACX,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAU;QACzB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC;gBACR,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBAClE,IAAI,EAAE,eAAe;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,IAAI,EAAE,IAAI;aACX,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAU,EAAE,OAAgC;QAC1D,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAClE,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE;gBACJ,GAAG,IAAI;gBACP,OAAO;aACR;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAAa,EAAE,QAAgB,EAAE,IAAY;QAC7D,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAClE,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE;gBACJ,KAAK;gBACL,QAAQ;gBACR,IAAI;aACL;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,QAAa;QAC/B,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAClE,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,QAAQ;SACf,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAA4D;QACpE,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE/B,sBAAsB;QACtB,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,KAAM,CAAC,CAAA;QAC5D,CAAC;QAED,gDAAgD;QAChD,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBACzB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAW,CAAA;gBAE1B,6CAA6C;gBAC7C,OAAO,CACL,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;oBAC5B,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK;oBAC3B,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,KAAK;oBACzB,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,KAAK;oBAC/B,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,KAAK,CACjC,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,GAAG,CAAA;QACnC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;QAEvC,OAAO,MAAM,CAAA;IACf,CAAC;;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA"}

package/dist/executionSweeper.d.ts

@@ -0,0 +1,97 @@
+import type { Task } from './types.js';
+export interface LivePrState {
+    state: 'open' | 'merged' | 'closed' | 'unknown';
+    error?: string;
+}
+export declare function checkLivePrState(prUrl: string): LivePrState;
+/** Clear PR state cache (for testing) */
+export declare function _clearPrStateCache(): void;
+/** Dry-run log for 24h evidence capture */
+declare const dryRunLog: Array<{
+    timestamp: number;
+    event: string;
+    detail: string;
+}>;
+export interface SweepViolation {
+    taskId: string;
+    title: string;
+    assignee?: string;
+    reviewer?: string;
+    type: 'validating_sla' | 'validating_critical' | 'pr_drift' | 'orphan_pr';
+    age_minutes: number;
+    message: string;
+    remediation?: string;
+}
+export interface SweepResult {
+    timestamp: number;
+    violations: SweepViolation[];
+    tasksScanned: number;
+    validatingCount: number;
+    autoClosedCount?: number;
+    artifactRejectedCount?: number;
+}
+export interface DriftReportEntry {
+    taskId: string;
+    title: string;
+    status: string;
+    assignee?: string;
+    reviewer?: string;
+    age_minutes: number;
+    prUrl?: string;
+    prMerged?: boolean;
+    issue: 'stale_validating' | 'orphan_pr' | 'pr_merged_not_closed' | 'no_pr_linked' | 'clean';
+    detail: string;
+    remediation?: string;
+}
+export interface DriftReport {
+    timestamp: number;
+    validating: DriftReportEntry[];
+    orphanPRs: DriftReportEntry[];
+    summary: {
+        totalValidating: number;
+        staleValidating: number;
+        orphanPRCount: number;
+        prDriftCount: number;
+        cleanCount: number;
+    };
+}
+/**
+ * Determines if a validating task can be auto-closed (no manual reviewer action needed).
+ *
+ * Conditions (ALL must be true):
+ * 1. metadata.reconciled === true (task was created from insight reconciliation)
+ * 2. Review is approved (reviewer_approved=true OR review_state='approved')
+ * 3. No code delta is required (no pr_url, or PR is already merged)
+ */
+export declare function isAutoClosable(task: Task, meta: Record<string, unknown>): boolean;
+export declare function sweepValidatingQueue(): Promise<SweepResult>;
+/**
+ * Check if a validating task has required artifacts (PR URL or qa_bundle).
+ * Doc-only and config-only tasks are exempt (they use review_handoff).
+ */
+export declare function hasRequiredArtifacts(meta: Record<string, unknown>): boolean;
+/**
+ * Check if a task's linked PR has been merged but the task is still in validating.
+ * Called externally when PR state changes are detected.
+ */
+export declare function flagPrDrift(taskId: string, prState: 'merged' | 'closed'): SweepViolation | null;
+/**
+ * Generate a comprehensive drift report showing all validating tasks,
+ * their PR status, and any orphan PRs or state drift.
+ */
+export declare function generateDriftReport(): DriftReport;
+export declare function startSweeper(): void;
+export declare function stopSweeper(): void;
+export declare function getSweeperStatus(): {
+    running: boolean;
+    lastSweepAt: number;
+    lastResults: SweepResult | null;
+    escalationTracking: Array<{
+        taskId: string;
+        level: string;
+        at: number;
+    }>;
+    dryRunLog: typeof dryRunLog;
+};
+export {};
+//# sourceMappingURL=executionSweeper.d.ts.map

package/dist/executionSweeper.d.ts.map

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