reflectt-node 0.1.0

package/dist/escalation.js

@@ -0,0 +1,213 @@
+// SPDX-License-Identifier: Apache-2.0
+// Escalation automation for P1/P0 support incidents
+// Tracks ack timers, triggers alerts, and runs escalation chains
+import { preflightCheck } from './alert-preflight.js';
+import { computeSLAStatus, getFeedback, } from './feedback.js';
+// ── Config ──
+/** Ack window by priority — how long before escalating on no-ack */
+const ACK_WINDOW_MS = {
+    P0: 5 * 60_000, // 5 minutes
+    P1: 15 * 60_000, // 15 minutes
+};
+/** Escalation chain: level → next level */
+const ESCALATION_CHAIN = {
+    owner_alert: 'ack_missed',
+    ack_missed: 'manager_escalation',
+    manager_escalation: 'exec_escalation',
+    exec_escalation: null, // terminal
+};
+/** Time between escalation levels (after missed ack) */
+const ESCALATION_INTERVAL_MS = {
+    P0: 10 * 60_000, // 10 minutes between escalation levels for P0
+    P1: 30 * 60_000, // 30 minutes for P1
+};
+/** Default escalation targets by level */
+const DEFAULT_TARGETS = {
+    owner_alert: 'on-call',
+    ack_missed: 'on-call',
+    manager_escalation: 'team-lead',
+    exec_escalation: 'admin',
+};
+// ── Store ──
+const escalationStore = new Map();
+let alertSink = () => { };
+/**
+ * Set the alert delivery function. Called whenever an alert fires.
+ * Default is no-op (logs silently). Wire this to chatManager, webhooks, etc.
+ * Wraps the sink with alert-preflight guard.
+ */
+export function setAlertSink(sink) {
+    alertSink = (alert, record) => {
+        const result = preflightCheck({
+            taskId: record.feedbackId,
+            alertType: `escalation_${alert.level}`,
+            agentId: record.owner,
+            content: alert.message,
+        });
+        if (!result.proceed) {
+            console.log(`[Escalation] Alert suppressed by preflight: ${result.reason}`);
+            return;
+        }
+        sink(alert, record);
+    };
+}
+// ── Core Logic ──
+let idCounter = 0;
+/**
+ * Create a new escalation for a P0/P1 feedback item.
+ * Returns null if priority is not P0/P1 or escalation already exists.
+ */
+export function createEscalation(feedbackId, priority, tier, owner) {
+    // Only P0/P1 get escalation
+    if (priority !== 'P0' && priority !== 'P1')
+        return null;
+    // Don't duplicate
+    const existing = Array.from(escalationStore.values()).find(e => e.feedbackId === feedbackId);
+    if (existing)
+        return existing;
+    const now = Date.now();
+    const ackWindow = ACK_WINDOW_MS[priority] || ACK_WINDOW_MS.P1;
+    const resolvedOwner = owner || DEFAULT_TARGETS.owner_alert;
+    const id = `esc-${++idCounter}-${Date.now().toString(36)}`;
+    const record = {
+        id,
+        feedbackId,
+        priority,
+        tier,
+        status: 'active',
+        owner: resolvedOwner,
+        level: 'owner_alert',
+        createdAt: now,
+        ackDeadlineAt: now + ackWindow,
+        alerts: [],
+        lastTickAt: now,
+    };
+    // Fire initial owner alert
+    const alert = {
+        level: 'owner_alert',
+        target: resolvedOwner,
+        message: `🚨 ${priority} incident created — feedback ${feedbackId} (${tier} tier). Ack within ${ackWindow / 60_000}m.`,
+        sentAt: now,
+    };
+    record.alerts.push(alert);
+    alertSink(alert, record);
+    escalationStore.set(id, record);
+    return record;
+}
+/**
+ * Acknowledge an escalation. Stops the ack timer.
+ */
+export function acknowledgeEscalation(escalationId, actor) {
+    const record = escalationStore.get(escalationId);
+    if (!record)
+        return null;
+    if (record.status !== 'active')
+        return record;
+    record.acknowledgedAt = Date.now();
+    record.status = 'acknowledged';
+    record.lastTickAt = Date.now();
+    return record;
+}
+/**
+ * Resolve an escalation (incident handled).
+ */
+export function resolveEscalation(escalationId) {
+    const record = escalationStore.get(escalationId);
+    if (!record)
+        return null;
+    record.status = 'resolved';
+    record.lastTickAt = Date.now();
+    return record;
+}
+/**
+ * Tick all active escalations — checks ack timers and triggers escalation chain.
+ * Call this periodically (e.g. every 60s from a watchdog/sweeper).
+ */
+export function tickEscalations(now = Date.now()) {
+    const results = {
+        checked: 0,
+        escalated: 0,
+        alerts: [],
+    };
+    for (const record of escalationStore.values()) {
+        if (record.status === 'resolved')
+            continue;
+        results.checked++;
+        // For active (un-acked) records: check ack deadline and run escalation chain
+        if (record.status === 'active' && !record.acknowledgedAt && now >= record.ackDeadlineAt) {
+            const nextLevel = ESCALATION_CHAIN[record.level];
+            if (nextLevel) {
+                const interval = ESCALATION_INTERVAL_MS[record.priority] || ESCALATION_INTERVAL_MS.P1;
+                const timeSinceLastEscalation = now - (record.alerts[record.alerts.length - 1]?.sentAt || record.createdAt);
+                // Only escalate if enough time has passed since last alert
+                if (timeSinceLastEscalation >= interval || record.level === 'owner_alert') {
+                    record.level = nextLevel;
+                    record.status = nextLevel === 'exec_escalation' ? 'escalated' : 'active';
+                    const target = DEFAULT_TARGETS[nextLevel];
+                    const alert = {
+                        level: nextLevel,
+                        target,
+                        message: `⚠️ ${record.priority} escalation (${nextLevel}): feedback ${record.feedbackId} (${record.tier} tier). No ack after ${Math.round((now - record.createdAt) / 60_000)}m.`,
+                        sentAt: now,
+                    };
+                    record.alerts.push(alert);
+                    alertSink(alert, record);
+                    results.escalated++;
+                    results.alerts.push(alert);
+                }
+            }
+        }
+        // Check SLA breach risk for acknowledged incidents — re-escalate if SLA breached despite ack
+        if (record.status === 'acknowledged') {
+            const feedback = getFeedback(record.feedbackId);
+            if (feedback) {
+                const sla = computeSLAStatus(feedback, now);
+                if (sla.overallBreachRisk === 'breached') {
+                    // Only fire this alert once
+                    const hasBreach = record.alerts.some(a => a.message.includes('SLA BREACHED'));
+                    if (!hasBreach) {
+                        const alert = {
+                            level: 'manager_escalation',
+                            target: DEFAULT_TARGETS.manager_escalation,
+                            message: `🔴 SLA BREACHED on ${record.priority} — feedback ${record.feedbackId} (${record.tier} tier). Despite ack, SLA exceeded.`,
+                            sentAt: now,
+                        };
+                        record.alerts.push(alert);
+                        record.status = 'escalated';
+                        alertSink(alert, record);
+                        results.escalated++;
+                        results.alerts.push(alert);
+                    }
+                }
+            }
+        }
+        record.lastTickAt = now;
+    }
+    return results;
+}
+// ── Query ──
+export function getEscalation(id) {
+    return escalationStore.get(id);
+}
+export function getEscalationByFeedback(feedbackId) {
+    return Array.from(escalationStore.values()).find(e => e.feedbackId === feedbackId);
+}
+export function listEscalations(status) {
+    const all = Array.from(escalationStore.values());
+    const items = status ? all.filter(e => e.status === status) : all;
+    return {
+        active: all.filter(e => e.status === 'active').length,
+        acknowledged: all.filter(e => e.status === 'acknowledged').length,
+        escalated: all.filter(e => e.status === 'escalated').length,
+        resolved: all.filter(e => e.status === 'resolved').length,
+        items: items.sort((a, b) => b.createdAt - a.createdAt),
+    };
+}
+// ── Testing ──
+export function _clearEscalationStore() {
+    escalationStore.clear();
+    idCounter = 0;
+    alertSink = () => { };
+}
+export { ACK_WINDOW_MS, ESCALATION_CHAIN, ESCALATION_INTERVAL_MS, DEFAULT_TARGETS };
+//# sourceMappingURL=escalation.js.map

package/dist/escalation.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Server-Sent Events (SSE) Event Bus
+ *
+ * Real-time event stream for agents to react to changes.
+ * Events are emitted when:
+ * - Messages are posted
+ * - Tasks are created, assigned, or updated
+ * - Memory entries are written
+ */
+import type { FastifyReply } from 'fastify';
+import type { AgentMessage, Task } from './types.js';
+export type EventType = 'message_posted' | 'task_created' | 'task_assigned' | 'task_updated' | 'memory_written' | 'presence_updated' | 'reflection_created' | 'insight_created';
+export declare const VALID_EVENT_TYPES: Set<EventType>;
+export interface Event {
+    id: string;
+    type: EventType;
+    timestamp: number;
+    data: unknown;
+}
+type InternalListener = (event: Event) => void | Promise<void>;
+declare class EventBus {
+    private subscriptions;
+    private internalListeners;
+    private eventLog;
+    private maxLogSize;
+    private batchWindowMs;
+    private pendingEvents;
+    private batchTimer;
+    private keepaliveTimer;
+    private static readonly KEEPALIVE_INTERVAL_MS;
+    constructor();
+    /**
+     * Send SSE keepalive comments to prevent proxy/Docker network timeouts.
+     * SSE comment lines (starting with ':') are ignored by EventSource clients.
+     */
+    private startKeepalive;
+    stopKeepalive(): void;
+    /**
+     * Register an in-process listener for events.
+     * Used for internal automation (e.g., insight→task bridge).
+     */
+    on(listenerId: string, listener: InternalListener): void;
+    /**
+     * Remove an in-process listener.
+     */
+    off(listenerId: string): void;
+    /**
+     * Subscribe to events via SSE
+     */
+    subscribe(reply: FastifyReply, agent?: string, topics?: string[], types?: string[]): string;
+    /**
+     * Get batch configuration
+     */
+    getBatchConfig(): {
+        batchWindowMs: number;
+    };
+    /**
+     * Set batch configuration
+     */
+    setBatchConfig(batchWindowMs: number): void;
+    /**
+     * Emit an event to all matching subscriptions (with batching)
+     */
+    emit(event: Event): void;
+    /**
+     * Flush the pending event batch to subscribers
+     */
+    private flushBatch;
+    /**
+     * Check if a subscription should receive an event
+     */
+    private shouldReceive;
+    /**
+     * Send an event to an SSE connection
+     */
+    private sendEvent;
+    /**
+     * Send a batch of events to an SSE connection
+     */
+    private sendBatchEvent;
+    /**
+     * Get event bus statistics
+     */
+    getStatus(): {
+        connected: number;
+        eventLog: number;
+        subscriptions: {
+            id: string;
+            agent: string | undefined;
+            topics: string[] | undefined;
+            types: EventType[] | undefined;
+            connectedMs: number;
+        }[];
+    };
+    /**
+     * Helper: Emit message_posted event
+     */
+    emitMessagePosted(message: AgentMessage): void;
+    /**
+     * Helper: Emit task_created event
+     */
+    emitTaskCreated(task: Task): void;
+    /**
+     * Helper: Emit task_assigned event
+     */
+    emitTaskAssigned(task: Task): void;
+    /**
+     * Helper: Emit task_updated event
+     */
+    emitTaskUpdated(task: Task, updates: Record<string, unknown>): void;
+    /**
+     * Helper: Emit memory_written event
+     */
+    emitMemoryWritten(agent: string, filename: string, path: string): void;
+    /**
+     * Helper: Emit presence_updated event
+     */
+    emitPresenceUpdated(presence: any): void;
+    /**
+     * Get event log for activity feed
+     */
+    getEvents(filters?: {
+        agent?: string;
+        limit?: number;
+        since?: number;
+    }): Event[];
+}
+export declare const eventBus: EventBus;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEpD,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,cAAc,GACd,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,CAAA;AAErB,eAAO,MAAM,iBAAiB,gBAS5B,CAAA;AAEF,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;CACd;AAWD,KAAK,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAE9D,cAAM,QAAQ;IACZ,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,aAAa,CAAO;IAC5B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAQ;;IAMrD;;;OAGG;IACH,OAAO,CAAC,cAAc;IAiBtB,aAAa;IAOb;;;OAGG;IACH,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIxD;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAkD3F;;OAEG;IACH,cAAc,IAAI;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE;IAI3C;;OAEG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAQ3C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAiCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoDlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,SAAS;;;;;;;;;;;IAcT;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAS9C;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IASjC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAWlC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYnE;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAatE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IASxC;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,EAAE;CA8BjF;AAED,eAAO,MAAM,QAAQ,UAAiB,CAAA"}