claudia-orchestrator 0.1.0

package/dist/services/insight-queue.js

@@ -0,0 +1,277 @@
+/**
+ * InsightQueue - Serializes insight operations per session to eliminate race conditions.
+ *
+ * The Problem This Solves:
+ * Previously, background regenerations could race with patches:
+ *   T+0s: Patch starts (Haiku)
+ *   T+1s: Background regen starts (Opus)
+ *   T+5s: Patch completes, writes to cache
+ *   T+8s: Regen completes, merge decision uses stale snapshot, overwrites patch
+ *
+ * The Solution:
+ * All insight operations go through this queue. Operations for the same session
+ * are serialized - a REFRESH can't start until the PATCH completes.
+ *
+ * Key Design Decisions:
+ * - One queue per session (different sessions can run in parallel)
+ * - Operations coalesce (if PATCH is queued and another PATCH comes in, skip the new one)
+ * - Priority ordering: PATCH > GENERATE > REFRESH
+ * - In-memory only (operations are idempotent, no need for persistence)
+ */
+import { EventEmitter } from 'events';
+import { createLogger } from './logger.js';
+// Priority ordering: lower number = higher priority
+const PRIORITY_ORDER = {
+    high: 0,
+    normal: 1,
+    low: 2,
+};
+// Type ordering within same priority: PATCH > GENERATE > REFRESH
+const TYPE_ORDER = {
+    PATCH: 0,
+    GENERATE: 1,
+    REFRESH: 2,
+};
+/**
+ * Compare two operations for queue ordering.
+ * Returns negative if a should come before b.
+ */
+function compareOperations(a, b) {
+    // First by priority
+    const priorityDiff = PRIORITY_ORDER[a.priority] - PRIORITY_ORDER[b.priority];
+    if (priorityDiff !== 0)
+        return priorityDiff;
+    // Then by type
+    const typeDiff = TYPE_ORDER[a.type] - TYPE_ORDER[b.type];
+    if (typeDiff !== 0)
+        return typeDiff;
+    // Finally by enqueue time (FIFO within same priority+type)
+    return a.enqueuedAt - b.enqueuedAt;
+}
+export class InsightQueue extends EventEmitter {
+    logger;
+    queues = new Map();
+    processing = new Set();
+    // Track what operation type is currently being processed per session
+    processingType = new Map();
+    stats = {
+        totalEnqueued: 0,
+        totalProcessed: 0,
+        totalSkipped: 0,
+        byType: { GENERATE: 0, PATCH: 0, REFRESH: 0 },
+        byTrigger: {},
+    };
+    // Executor function - injected to avoid circular dependencies
+    executor = null;
+    constructor() {
+        super();
+        this.logger = createLogger('InsightQueue');
+    }
+    /**
+     * Set the executor function that processes operations.
+     * This is injected to break the circular dependency between queue and handler.
+     */
+    setExecutor(executor) {
+        this.executor = executor;
+        this.logger.info('Executor set');
+    }
+    /**
+     * Enqueue an insight operation.
+     * Operations are coalesced (duplicate type+session skipped) and prioritized.
+     */
+    enqueue(op) {
+        const operation = {
+            ...op,
+            enqueuedAt: Date.now(),
+        };
+        const queue = this.queues.get(op.sessionId) || [];
+        // Coalesce: skip if same operation type is already queued OR currently processing
+        const isQueued = queue.some(q => q.type === op.type);
+        const isProcessing = this.processingType.get(op.sessionId) === op.type;
+        if (isQueued || isProcessing) {
+            this.stats.totalSkipped++;
+            this.logger.debug('Operation coalesced', {
+                sessionId: op.sessionId.slice(0, 8),
+                type: op.type,
+                trigger: op.trigger,
+                reason: isProcessing ? 'already_processing' : 'already_queued',
+                queueLength: queue.length,
+            });
+            return false;
+        }
+        // Add to queue and sort by priority
+        queue.push(operation);
+        queue.sort(compareOperations);
+        this.queues.set(op.sessionId, queue);
+        // Update stats
+        this.stats.totalEnqueued++;
+        this.stats.byType[op.type]++;
+        this.stats.byTrigger[op.trigger] = (this.stats.byTrigger[op.trigger] || 0) + 1;
+        this.logger.info('Operation enqueued', {
+            sessionId: op.sessionId.slice(0, 8),
+            type: op.type,
+            priority: op.priority,
+            trigger: op.trigger,
+            queueLength: queue.length,
+            traceId: op.traceId,
+        });
+        // Emit event for monitoring
+        this.emit('enqueued', operation);
+        // Start processing if not already running
+        this.processNext(op.sessionId);
+        return true;
+    }
+    /**
+     * Process the next operation in a session's queue.
+     * This is the serialization point - only one operation per session at a time.
+     */
+    async processNext(sessionId) {
+        // Already processing this session - wait for current operation to complete
+        if (this.processing.has(sessionId)) {
+            return;
+        }
+        const queue = this.queues.get(sessionId);
+        if (!queue || queue.length === 0) {
+            return;
+        }
+        if (!this.executor) {
+            this.logger.error('No executor set - cannot process operations');
+            return;
+        }
+        // Mark as processing
+        this.processing.add(sessionId);
+        const op = queue.shift();
+        this.processingType.set(sessionId, op.type);
+        const startTime = Date.now();
+        this.logger.info('Processing operation', {
+            sessionId: sessionId.slice(0, 8),
+            type: op.type,
+            trigger: op.trigger,
+            waitTimeMs: startTime - op.enqueuedAt,
+            traceId: op.traceId,
+        });
+        // Emit event for monitoring
+        this.emit('processing', op);
+        try {
+            await this.executor(op);
+            const durationMs = Date.now() - startTime;
+            this.stats.totalProcessed++;
+            this.logger.info('Operation completed', {
+                sessionId: sessionId.slice(0, 8),
+                type: op.type,
+                trigger: op.trigger,
+                durationMs,
+                traceId: op.traceId,
+            });
+            // Emit event for monitoring
+            this.emit('completed', { ...op, durationMs });
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            this.logger.error('Operation failed', {
+                sessionId: sessionId.slice(0, 8),
+                type: op.type,
+                trigger: op.trigger,
+                durationMs,
+                error: error instanceof Error ? error.message : String(error),
+                traceId: op.traceId,
+            });
+            // Emit event for monitoring
+            this.emit('failed', { ...op, durationMs, error });
+        }
+        finally {
+            // Mark as no longer processing
+            this.processing.delete(sessionId);
+            this.processingType.delete(sessionId);
+            // Process next in queue (if any)
+            this.processNext(sessionId);
+        }
+    }
+    /**
+     * Get the current queue for a session (for debugging/UI).
+     */
+    getQueue(sessionId) {
+        return [...(this.queues.get(sessionId) || [])];
+    }
+    /**
+     * Check if a session is currently being processed.
+     */
+    isProcessing(sessionId) {
+        return this.processing.has(sessionId);
+    }
+    /**
+     * Get the operation type currently being processed for a session.
+     */
+    getProcessingType(sessionId) {
+        return this.processingType.get(sessionId);
+    }
+    /**
+     * Get the number of pending operations for a session.
+     */
+    getPendingCount(sessionId) {
+        return this.queues.get(sessionId)?.length || 0;
+    }
+    /**
+     * Get all sessions with pending operations.
+     */
+    getActiveSessionIds() {
+        return Array.from(this.queues.keys()).filter(sessionId => (this.queues.get(sessionId)?.length || 0) > 0 || this.processing.has(sessionId));
+    }
+    /**
+     * Get queue statistics.
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Clear the queue for a session (e.g., when session is archived).
+     */
+    clearSession(sessionId) {
+        const queue = this.queues.get(sessionId);
+        if (queue && queue.length > 0) {
+            this.logger.info('Clearing session queue', {
+                sessionId: sessionId.slice(0, 8),
+                droppedOperations: queue.length,
+            });
+        }
+        this.queues.delete(sessionId);
+    }
+    /**
+     * Shutdown the queue (for graceful server shutdown).
+     * Waits for in-flight operations to complete but doesn't process new ones.
+     */
+    async shutdown(timeoutMs = 30000) {
+        this.logger.info('Shutting down insight queue', {
+            processingCount: this.processing.size,
+            pendingCount: Array.from(this.queues.values()).reduce((sum, q) => sum + q.length, 0),
+        });
+        // Clear all pending queues
+        this.queues.clear();
+        // Wait for in-flight operations to complete
+        const startTime = Date.now();
+        while (this.processing.size > 0 && Date.now() - startTime < timeoutMs) {
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        if (this.processing.size > 0) {
+            this.logger.warn('Shutdown timed out with operations still processing', {
+                remainingCount: this.processing.size,
+            });
+        }
+        else {
+            this.logger.info('Insight queue shutdown complete');
+        }
+    }
+}
+// Singleton instance
+let instance = null;
+export function getInsightQueue() {
+    if (!instance) {
+        instance = new InsightQueue();
+    }
+    return instance;
+}
+// For testing - allows resetting the singleton
+export function resetInsightQueue() {
+    instance = null;
+}
+//# sourceMappingURL=insight-queue.js.map

package/dist/services/insight-queue.js.map

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

package/dist/services/insights-service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * InsightsService - Unified event-driven insights system.
+ *
+ * This consolidates InsightsEventCoordinator + InsightsEventHandler into a single service.
+ * It handles:
+ * 1. Watching for session activity (file changes in ~/.claude/projects)
+ * 2. Tracking session state (action counts, timing, etc.)
+ * 3. Triggering insight generation and patching via InsightQueue
+ * 4. Executing LLM operations (generation, quick check, patch)
+ *
+ * Architecture V2 Features:
+ * - InsightQueue for serialization (eliminates race conditions)
+ * - Haiku-heavy patches (cheap quick checks, targeted updates)
+ * - Ownership model for REFRESH (deterministic field ownership)
+ */
+import { EventEmitter } from 'events';
+interface SessionState {
+    actionCount: number;
+    lastActionAt: number;
+    lastCheckAt: number;
+    insightsGeneratedAt?: number;
+    insightsPatchedAt?: number;
+    regenTimerId?: NodeJS.Timeout;
+    completionCheckTimer?: NodeJS.Timeout;
+    quickCheckDebounceTimer?: NodeJS.Timeout;
+    lastResponseTimestamp?: number;
+}
+export declare class InsightsService extends EventEmitter {
+    private logger;
+    private historyReader;
+    private sessionInfoService;
+    private insightsComputeService;
+    private projectsDir;
+    private watchers;
+    private debounceTimers;
+    private isWatching;
+    private sessionStates;
+    private lastKnownMessageCounts;
+    private pendingGenerations;
+    private pendingQuickChecks;
+    private pendingActionEvents;
+    private pendingGenerateEvents;
+    constructor();
+    /**
+     * Initialize the insights service. Call once at startup.
+     */
+    initialize(): void;
+    /**
+     * Stop the insights service. Call at shutdown.
+     */
+    stop(): void;
+    private startWatching;
+    private watchDirectory;
+    private watchProjectDirectory;
+    private handleFileChange;
+    private processSessionUpdate;
+    /**
+     * Handle action event - determine if/how to trigger patch checking
+     */
+    private handleSessionAction;
+    private extractActions;
+    private extractFilename;
+    private enqueueGenerate;
+    private enqueueAction;
+    private mapReasonToTrigger;
+    private executeQueueOperation;
+    private executeGenerate;
+    /**
+     * Apply deterministic ownership model for REFRESH operations.
+     * - Haiku owns (keep cached): currentState, milestones, recentActions
+     * - Opus owns (use fresh): context, panels, tags, theme
+     * - Notable: accumulates (merge, don't replace)
+     */
+    private applyOwnershipModel;
+    private mergeNotableEvents;
+    private executeAction;
+    private doQuickCheck;
+    private doPatch;
+    private applyPatches;
+    /**
+     * Called when insights have been generated for a session
+     */
+    private markInsightsGenerated;
+    private markInsightsPatched;
+    private markQuickCheckPerformed;
+    private startRegenTimer;
+    /**
+     * Clean up tracking for a session (call when archived or idle)
+     */
+    cleanupSession(sessionId: string): void;
+    /**
+     * Get the current state for a session (for debugging/UI)
+     */
+    getSessionState(sessionId: string): SessionState | undefined;
+}
+export declare function getInsightsService(): InsightsService;
+/**
+ * Initialize the insights service. Call once at server startup.
+ */
+export declare function initializeInsightsService(): void;
+export {};
+//# sourceMappingURL=insights-service.d.ts.map

package/dist/services/insights-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights-service.d.ts","sourceRoot":"","sources":["../../src/services/insights-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAkBtC,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACtC,uBAAuB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACzC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AA6ED,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,UAAU,CAAS;IAG3B,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,sBAAsB,CAAkC;IAGhE,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,kBAAkB,CAA0B;IAGpD,OAAO,CAAC,mBAAmB,CAAuC;IAClE,OAAO,CAAC,qBAAqB,CAAyC;;IAkBtE;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;OAEG;IACH,IAAI,IAAI,IAAI;IA8BZ,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,gBAAgB;YAmBV,oBAAoB;IA8JlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyF3B,OAAO,CAAC,cAAc;IAwGtB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,kBAAkB;YAWZ,qBAAqB;YA4CrB,eAAe;IAmE7B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,kBAAkB;YA8BZ,aAAa;YAoIb,YAAY;YAeZ,OAAO;YAoFP,YAAY;IA0J1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAsCvC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAG7D;AAQD,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD"}