claudia-orchestrator 0.1.0

package/dist/services/session-insights-service.js

@@ -0,0 +1,889 @@
+import crypto from 'crypto';
+import { createLogger } from './logger.js';
+import { anthropicService } from './anthropic-service.js';
+import { SessionInfoService } from './session-info-service.js';
+import { geminiService } from './gemini-service.js';
+import { getSessionActivityWatcher } from './session-activity-watcher.js';
+/**
+ * Generate a trace ID for correlating recompute events through the system.
+ * Format: <session-prefix>-<timestamp-hex>-<random>
+ */
+function generateTraceId(sessionId) {
+    const sessionPrefix = sessionId.slice(0, 8);
+    const timestampHex = Date.now().toString(16);
+    const random = crypto.randomBytes(2).toString('hex');
+    return `${sessionPrefix}-${timestampHex}-${random}`;
+}
+/**
+ * Build a state snapshot for auditing insight changes.
+ * Captures all fields relevant to dashboard display.
+ */
+function buildStateSnapshot(cache, insights) {
+    if (insights) {
+        return {
+            mission: insights.context?.mission || undefined,
+            description: insights.description || undefined,
+            currentState: insights.currentState?.content || undefined,
+            theme: insights.theme || undefined,
+            milestones: insights.milestones?.map(m => `${m.label}:${m.status}`) || [],
+            panels: insights.panels?.map(p => p.label || p.title || 'unnamed') || [],
+            notableCount: insights.notable?.length || 0,
+        };
+    }
+    if (cache) {
+        return {
+            mission: cache.context?.mission || undefined,
+            description: cache.description || undefined,
+            currentState: cache.current_state?.content || undefined,
+            theme: cache.theme || undefined,
+            milestones: cache.milestones?.map((m) => `${m.label}:${m.status}`) || [],
+            panels: cache.panels?.map((p) => p.label || p.title || 'unnamed') || [],
+            notableCount: cache.notable?.length || 0,
+        };
+    }
+    return {};
+}
+export class SessionInsightsService {
+    logger;
+    historyReader;
+    sessionInfoService;
+    constructor(historyReader, sessionInfoService) {
+        this.logger = createLogger('SessionInsightsService');
+        this.historyReader = historyReader;
+        this.sessionInfoService = sessionInfoService || SessionInfoService.getInstance();
+    }
+    /**
+     * Check if a session is automated (e.g., Claudia sessions).
+     * Automated sessions should skip expensive AI insight generation.
+     */
+    async isAutomatedSession(sessionId) {
+        try {
+            const { metadata } = await this.historyReader.fetchConversationDirect(sessionId);
+            return metadata.projectPath?.toLowerCase().includes('/claudia') || false;
+        }
+        catch {
+            // If we can't determine, assume not automated
+            return false;
+        }
+    }
+    /**
+     * Extract the final todo state from conversation messages
+     */
+    extractTodoState(messages) {
+        let lastTodoState = null;
+        for (const msg of messages) {
+            const content = msg.message?.content;
+            if (!Array.isArray(content))
+                continue;
+            for (const block of content) {
+                if (typeof block === 'object' &&
+                    block !== null &&
+                    'type' in block &&
+                    block.type === 'tool_use' &&
+                    'name' in block &&
+                    block.name === 'TodoWrite' &&
+                    'input' in block &&
+                    typeof block.input === 'object' &&
+                    block.input !== null &&
+                    'todos' in block.input &&
+                    Array.isArray(block.input.todos)) {
+                    lastTodoState = block.input.todos;
+                }
+            }
+        }
+        return lastTodoState;
+    }
+    /**
+     * Compute progress from todo state
+     */
+    computeProgress(todos) {
+        const completed = todos.filter(t => t.status === 'completed').length;
+        const inProgress = todos.filter(t => t.status === 'in_progress').length;
+        const pending = todos.filter(t => t.status === 'pending').length;
+        const total = todos.length;
+        const percent = total > 0 ? Math.round((completed / total) * 100) : 0;
+        return { completed, inProgress, pending, total, percent };
+    }
+    /**
+     * Extract the last N actions from recent messages (tool uses, user messages, assistant text)
+     * Returns an array of {tool, timestamp} for mini action log display
+     */
+    extractRecentActions(messages, limit = 14) {
+        const actions = [];
+        // Walk backwards through messages
+        for (let i = messages.length - 1; i >= 0 && actions.length < limit; i--) {
+            const msg = messages[i];
+            const content = msg.message?.content;
+            const timestamp = msg.timestamp ? new Date(msg.timestamp).getTime() : Date.now();
+            // User messages - handle both string and array content
+            if (msg.type === 'user') {
+                // String content (most common for typed user prompts)
+                if (typeof content === 'string' && content.trim().length > 0) {
+                    actions.push({
+                        tool: 'User',
+                        timestamp
+                    });
+                    if (actions.length >= limit)
+                        break;
+                    continue;
+                }
+                // Array content - look for text blocks
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (typeof block === 'object' &&
+                            block !== null &&
+                            'type' in block &&
+                            block.type === 'text' &&
+                            'text' in block &&
+                            typeof block.text === 'string' &&
+                            block.text.trim().length > 0) {
+                            actions.push({
+                                tool: 'User',
+                                timestamp
+                            });
+                            // Only count one user action per message
+                            break;
+                        }
+                    }
+                    if (actions.length >= limit)
+                        break;
+                }
+                continue;
+            }
+            // Skip non-array content for assistant messages
+            if (!Array.isArray(content))
+                continue;
+            // Assistant messages - both tool uses and text responses
+            if (msg.type === 'assistant') {
+                let hasToolUse = false;
+                let hasText = false;
+                // First pass: check what types we have
+                for (const block of content) {
+                    if (typeof block === 'object' && block !== null && 'type' in block) {
+                        if (block.type === 'tool_use')
+                            hasToolUse = true;
+                        if (block.type === 'text')
+                            hasText = true;
+                    }
+                }
+                // Second pass: add actions
+                for (const block of content) {
+                    if (typeof block !== 'object' || block === null || !('type' in block))
+                        continue;
+                    if (block.type === 'tool_use' && 'name' in block && typeof block.name === 'string') {
+                        actions.push({
+                            tool: block.name,
+                            timestamp
+                        });
+                        if (actions.length >= limit)
+                            break;
+                    }
+                    else if (block.type === 'text' && 'text' in block && typeof block.text === 'string') {
+                        // Only add text response if there's no tool use in this message
+                        if (!hasToolUse && block.text.trim().length > 0) {
+                            actions.push({
+                                tool: 'Response',
+                                timestamp
+                            });
+                            // Only count one text response per message
+                            break;
+                        }
+                    }
+                }
+                if (actions.length >= limit)
+                    break;
+            }
+        }
+        // Reverse to get chronological order (oldest first, newest last)
+        return actions.reverse();
+    }
+    /**
+     * Extract user prompts from conversation
+     */
+    extractUserPrompts(messages) {
+        const prompts = [];
+        for (const msg of messages) {
+            if (msg.type !== 'user')
+                continue;
+            const content = msg.message?.content;
+            if (typeof content === 'string' && content.trim()) {
+                prompts.push(content.trim());
+            }
+            else if (Array.isArray(content)) {
+                for (const block of content) {
+                    if (typeof block === 'object' &&
+                        block !== null &&
+                        'type' in block &&
+                        block.type === 'text' &&
+                        'text' in block &&
+                        typeof block.text === 'string') {
+                        prompts.push(block.text.trim());
+                    }
+                }
+            }
+        }
+        return prompts.filter(p => p.length > 0 && !p.startsWith('['));
+    }
+    /**
+     * Extract recent assistant text responses (last N messages)
+     * Used to capture outcomes and progress for insight generation
+     */
+    extractRecentAssistantText(messages, limit = 3) {
+        const texts = [];
+        // Work backwards from the end to get most recent first
+        for (let i = messages.length - 1; i >= 0 && texts.length < limit; i--) {
+            const msg = messages[i];
+            if (msg.type !== 'assistant')
+                continue;
+            const content = msg.message?.content;
+            if (Array.isArray(content)) {
+                for (const block of content) {
+                    if (typeof block === 'object' &&
+                        block !== null &&
+                        'type' in block &&
+                        block.type === 'text' &&
+                        'text' in block &&
+                        typeof block.text === 'string' &&
+                        block.text.trim()) {
+                        texts.push(block.text.trim());
+                        break; // Only one text block per message
+                    }
+                }
+            }
+        }
+        return texts;
+    }
+    /**
+     * Format a tool call into a human-readable action description
+     */
+    formatToolAction(toolName, input) {
+        switch (toolName) {
+            case 'Read':
+                return `Reading ${this.extractFilename(input.file_path)}`;
+            case 'Edit':
+                return `Editing ${this.extractFilename(input.file_path)}`;
+            case 'Write':
+                return `Writing ${this.extractFilename(input.file_path)}`;
+            case 'Grep':
+                return `Searching: "${input.pattern?.slice(0, 40)}"`;
+            case 'Glob':
+                return `Finding: ${input.pattern?.slice(0, 40)}`;
+            case 'Bash': {
+                const description = input.description;
+                if (description) {
+                    return description.slice(0, 50);
+                }
+                const command = input.command || '';
+                return command.slice(0, 50) || 'Running command';
+            }
+            case 'Task':
+                return input.description?.slice(0, 50) || 'Delegating task';
+            case 'TodoWrite': {
+                const todos = input.todos;
+                if (todos && todos.length > 0) {
+                    const inProgress = todos.find(t => t.status === 'in_progress');
+                    if (inProgress?.content) {
+                        return inProgress.content.slice(0, 50);
+                    }
+                }
+                return 'Updating todo list';
+            }
+            default:
+                return toolName;
+        }
+    }
+    /**
+     * Extract filename from a path for display
+     */
+    extractFilename(path) {
+        if (!path)
+            return 'file';
+        const parts = path.split('/');
+        return parts[parts.length - 1] || 'file';
+    }
+    /**
+     * Infer session theme from tool usage patterns
+     */
+    inferTheme(messages) {
+        const toolCounts = {};
+        for (const msg of messages) {
+            const content = msg.message?.content;
+            if (!Array.isArray(content))
+                continue;
+            for (const block of content) {
+                if (typeof block === 'object' &&
+                    block !== null &&
+                    'type' in block &&
+                    block.type === 'tool_use' &&
+                    'name' in block &&
+                    typeof block.name === 'string') {
+                    toolCounts[block.name] = (toolCounts[block.name] || 0) + 1;
+                }
+            }
+        }
+        const readTools = (toolCounts['Read'] || 0) + (toolCounts['Grep'] || 0) + (toolCounts['Glob'] || 0);
+        const writeTools = (toolCounts['Edit'] || 0) + (toolCounts['Write'] || 0);
+        const bashTools = toolCounts['Bash'] || 0;
+        const taskTools = toolCounts['Task'] || 0;
+        // Heuristics for theme detection
+        if (writeTools > readTools && writeTools > 5) {
+            return 'implementation';
+        }
+        if (bashTools > writeTools && bashTools > 5) {
+            return 'debugging';
+        }
+        if (readTools > writeTools * 2 && readTools > 10) {
+            return 'research';
+        }
+        if (taskTools > 3) {
+            return 'research'; // Lots of subagents = exploration
+        }
+        return null;
+    }
+    /**
+     * Generate rich structured session insights using Opus 4.5
+     */
+    async generateStructuredInsights(messages) {
+        // Check if Anthropic is configured
+        if (!anthropicService.isConfigured()) {
+            this.logger.debug('Anthropic service not configured, skipping insight extraction');
+            return { context: null, currentState: null, milestones: [], notable: [], tags: null, recentActions: [], panels: [], theme: null };
+        }
+        try {
+            // Get user prompts for context
+            const userPrompts = this.extractUserPrompts(messages);
+            if (userPrompts.length === 0) {
+                return { context: null, currentState: null, milestones: [], notable: [], tags: null, recentActions: [], panels: [], theme: null };
+            }
+            // Get todo items for context
+            const todos = this.extractTodoState(messages);
+            const todoContext = todos
+                ? `\nTask list:\n${todos.map(t => `- [${t.status}] ${t.content}`).join('\n')}`
+                : '';
+            // Get recent assistant responses for outcome/progress context
+            const recentAssistantText = this.extractRecentAssistantText(messages, 3);
+            const assistantContext = recentAssistantText.length > 0
+                ? `\nRecent assistant responses:\n${recentAssistantText.map(t => `- "${t}"`).join('\n')}`
+                : '';
+            // Build conversation context - no truncation, models have plenty of context
+            const conversationText = `User requests (chronological):
+${userPrompts.slice(-12).map(p => `- "${p}"`).join('\n')}
+${todoContext}${assistantContext}`;
+            const result = await anthropicService.extractSessionInsights(conversationText);
+            return {
+                context: result.context,
+                currentState: result.currentState || null,
+                milestones: result.milestones,
+                notable: result.notable || [],
+                tags: result.tags,
+                recentActions: result.recentActions,
+                panels: result.panels || [],
+                theme: result.theme || null
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to generate structured insights - re-throwing to preserve existing cache', { error });
+            // Re-throw so callers can decide whether to use cached data or handle the error
+            // Previously this returned empty data which would overwrite good cached insights
+            throw error;
+        }
+    }
+    /**
+     * Get full insights for a session (checks cache first)
+     * For automated sessions, returns quick insights without AI generation.
+     *
+     * NON-BLOCKING BEHAVIOR:
+     * - If cache is fresh → return it immediately
+     * - If cache is stale → return stale data immediately, trigger background regeneration
+     * - If no cache → generate synchronously (first time only)
+     */
+    async getInsights(sessionId) {
+        this.logger.info('[GET INSIGHTS] Called', {
+            sessionId: sessionId.slice(0, 8),
+            timestamp: new Date().toISOString()
+        });
+        // Check cache first
+        const cached = await this.sessionInfoService.getInsights(sessionId);
+        this.logger.info('[GET INSIGHTS] Cache lookup result', {
+            sessionId: sessionId.slice(0, 8),
+            hasCached: !!cached,
+            isStale: cached?.stale || false,
+            cachedMission: cached?.context ? (typeof cached.context === 'string' ? JSON.parse(cached.context).mission : cached.context.mission)?.slice(0, 50) : null
+        });
+        if (cached && !cached.stale) {
+            this.logger.info('[GET INSIGHTS] Returning cached (not stale)', {
+                sessionId: sessionId.slice(0, 8)
+            });
+            return this.cachedToSessionInsights(cached);
+        }
+        // For automated sessions, skip AI generation entirely
+        const isAutomated = await this.isAutomatedSession(sessionId);
+        if (isAutomated) {
+            this.logger.debug('Skipping AI insights for automated session', { sessionId });
+            return this.getInsightsQuick(sessionId);
+        }
+        // NON-BLOCKING: If we have stale cache, return it immediately and regenerate in background
+        if (cached && cached.stale) {
+            this.logger.info('[GET INSIGHTS] Returning stale cache, triggering background regeneration', {
+                sessionId: sessionId.slice(0, 8)
+            });
+            // Fire off background regeneration (don't await)
+            this.regenerateInsightsInBackground(sessionId, cached).catch(err => this.logger.debug('Background regeneration failed', { sessionId, error: err }));
+            // Return stale data immediately for fast UX
+            return this.cachedToSessionInsights(cached);
+        }
+        // No cache at all - must generate synchronously (first time for this session)
+        this.logger.warn('[GET INSIGHTS] No cache - triggering synchronous generation', {
+            sessionId: sessionId.slice(0, 8)
+        });
+        const traceId = generateTraceId(sessionId);
+        const startTime = Date.now();
+        const beforeState = buildStateSnapshot(cached);
+        const insights = await this.computeInsights(sessionId);
+        // Cache the result and audit the recompute
+        const afterState = buildStateSnapshot(null, insights);
+        const changedFields = [];
+        if (beforeState.mission !== afterState.mission)
+            changedFields.push('mission');
+        if (beforeState.description !== afterState.description)
+            changedFields.push('description');
+        if (beforeState.currentState !== afterState.currentState)
+            changedFields.push('currentState');
+        if (beforeState.theme !== afterState.theme)
+            changedFields.push('theme');
+        if (JSON.stringify(beforeState.milestones) !== JSON.stringify(afterState.milestones))
+            changedFields.push('milestones');
+        if (JSON.stringify(beforeState.panels) !== JSON.stringify(afterState.panels))
+            changedFields.push('panels');
+        const durationMs = Date.now() - startTime;
+        // Audit the recompute
+        this.sessionInfoService.auditEventInsight({
+            traceId,
+            sessionId,
+            eventType: 'recompute',
+            trigger: 'api_request',
+            beforeState,
+            afterState,
+            patchedFields: changedFields,
+            durationMs,
+            llmResponse: `Opus returned: context=${!!insights.context}, description=${!!insights.description}, milestones=${insights.milestones.length}, panels=${insights.panels.length}`,
+        });
+        // Cache the result (don't await - fire and forget)
+        this.cacheInsights(sessionId, insights).catch(err => this.logger.debug('Failed to cache insights', { sessionId, error: err }));
+        return insights;
+    }
+    /**
+     * Regenerate insights in the background (for stale cache refresh).
+     * This runs async and updates the cache when done.
+     */
+    async regenerateInsightsInBackground(sessionId, existingCache) {
+        const traceId = generateTraceId(sessionId);
+        const startTime = Date.now();
+        const beforeState = buildStateSnapshot(existingCache);
+        this.logger.info('[BACKGROUND REGEN] Starting', {
+            traceId,
+            sessionId: sessionId.slice(0, 8)
+        });
+        try {
+            const insights = await this.computeInsights(sessionId);
+            // Cache the result and audit the recompute
+            const afterState = buildStateSnapshot(null, insights);
+            const changedFields = [];
+            if (beforeState.mission !== afterState.mission)
+                changedFields.push('mission');
+            if (beforeState.description !== afterState.description)
+                changedFields.push('description');
+            if (beforeState.currentState !== afterState.currentState)
+                changedFields.push('currentState');
+            if (beforeState.theme !== afterState.theme)
+                changedFields.push('theme');
+            if (JSON.stringify(beforeState.milestones) !== JSON.stringify(afterState.milestones))
+                changedFields.push('milestones');
+            if (JSON.stringify(beforeState.panels) !== JSON.stringify(afterState.panels))
+                changedFields.push('panels');
+            const durationMs = Date.now() - startTime;
+            // Audit the recompute
+            this.sessionInfoService.auditEventInsight({
+                traceId,
+                sessionId,
+                eventType: 'recompute',
+                trigger: 'background_stale_refresh',
+                beforeState,
+                afterState,
+                patchedFields: changedFields,
+                durationMs,
+                llmResponse: `Opus returned: context=${!!insights.context}, description=${!!insights.description}, milestones=${insights.milestones.length}, panels=${insights.panels.length}`,
+            });
+            await this.cacheInsights(sessionId, insights);
+            this.logger.info('[BACKGROUND REGEN] Completed', {
+                traceId,
+                sessionId: sessionId.slice(0, 8),
+                durationMs,
+                changedFields
+            });
+        }
+        catch (error) {
+            this.logger.warn('[BACKGROUND REGEN] Failed - existing cache preserved', {
+                traceId,
+                sessionId: sessionId.slice(0, 8),
+                error
+            });
+            // Don't throw - this is a background operation
+            // IMPORTANT: We intentionally don't cache anything on failure to preserve existing good data
+        }
+    }
+    /**
+     * Compute insights from conversation (bypasses cache)
+     */
+    async computeInsights(sessionId) {
+        const { messages } = await this.historyReader.fetchConversationDirect(sessionId);
+        const messageCount = messages.length;
+        // Extract todo state
+        const todos = this.extractTodoState(messages);
+        // Compute progress
+        const progress = todos ? this.computeProgress(todos) : null;
+        // Get recently completed (last 3)
+        const recentlyCompleted = todos
+            ? todos
+                .filter(t => t.status === 'completed')
+                .slice(-3)
+                .map(t => t.content)
+            : [];
+        // Get outstanding tasks
+        const outstanding = todos
+            ? todos
+                .filter(t => t.status === 'pending' || t.status === 'in_progress')
+                .map(t => t.content)
+            : [];
+        // Get current task (in_progress)
+        const currentTask = todos
+            ? todos.find(t => t.status === 'in_progress')?.content || null
+            : null;
+        // Generate rich structured insights using Opus
+        const structured = await this.generateStructuredInsights(messages);
+        // Use Opus theme, fallback to inferred
+        const theme = structured.theme || this.inferTheme(messages);
+        // Generate brief description for title (backward compat)
+        const description = structured.context?.mission || null;
+        // Build purposes array from context for backward compatibility
+        const purposes = structured.context
+            ? [structured.context.mission]
+            : [];
+        return {
+            sessionId,
+            context: structured.context,
+            currentState: structured.currentState,
+            milestones: structured.milestones,
+            notable: structured.notable,
+            tags: structured.tags,
+            recentActions: structured.recentActions,
+            panels: structured.panels || [],
+            theme,
+            purposes,
+            description,
+            progress,
+            recentlyCompleted,
+            outstanding,
+            currentTask,
+            messageCount
+        };
+    }
+    /**
+     * Cache insights to database
+     */
+    async cacheInsights(sessionId, insights) {
+        const cached = {
+            session_id: sessionId,
+            description: insights.description,
+            context: insights.context,
+            current_state: insights.currentState || null,
+            last_patch_trace_id: null,
+            purposes: insights.purposes,
+            milestones: insights.milestones, // Supports both old and V8 format
+            notable: insights.notable, // Supports both old and V8 format
+            tags: insights.tags,
+            recent_actions: insights.recentActions,
+            panels: insights.panels || [], // Supports both old and V8 format
+            progress_completed: insights.progress?.completed || 0,
+            progress_total: insights.progress?.total || 0,
+            outstanding_tasks: insights.outstanding,
+            completed_tasks: insights.recentlyCompleted,
+            current_task: insights.currentTask,
+            theme: insights.theme,
+            computed_at: new Date().toISOString(),
+            stale: false,
+            message_count: insights.messageCount
+        };
+        await this.sessionInfoService.setInsights(cached);
+        // Generate identity image if session doesn't have one yet (fire and forget)
+        this.maybeGenerateIdentityImage(sessionId, insights).catch(err => this.logger.debug('Failed to generate identity image', { sessionId, error: err }));
+    }
+    /**
+     * Generate identity image for a session if it doesn't already have one.
+     * This is called after insights are cached, and runs in the background.
+     */
+    async maybeGenerateIdentityImage(sessionId, insights) {
+        // Check if session already has an identity image
+        const hasImage = await this.sessionInfoService.hasIdentityImage(sessionId);
+        if (hasImage) {
+            return;
+        }
+        // Skip automated sessions (claudia) - only generate for manual sessions
+        try {
+            const { metadata } = await this.historyReader.fetchConversationDirect(sessionId);
+            if (metadata.projectPath?.includes('/claudia')) {
+                this.logger.debug('Skipping identity image - automated session', { sessionId, projectPath: metadata.projectPath });
+                return;
+            }
+        }
+        catch {
+            // If we can't fetch metadata, skip image generation
+            this.logger.debug('Skipping identity image - could not fetch metadata', { sessionId });
+            return;
+        }
+        // Need context to generate meaningful image
+        if (!insights.context?.mission) {
+            this.logger.debug('Skipping identity image - no mission context', { sessionId });
+            return;
+        }
+        const imageContext = {
+            mission: insights.context.mission,
+            project: insights.context.project,
+            theme: insights.theme ?? undefined,
+            workTypes: insights.tags?.workType
+        };
+        this.logger.info('Generating identity image for session', {
+            sessionId,
+            imageContext
+        });
+        try {
+            const result = await geminiService.generateSessionImage(imageContext);
+            await this.sessionInfoService.setIdentityImage(sessionId, result.imageData);
+            this.logger.info('Identity image generated and saved', { sessionId });
+            // Emit a follow-up SSE event so clients can update their cache with the new image
+            // This solves the race condition where the initial insights SSE is sent before
+            // the identity image is generated
+            try {
+                await getSessionActivityWatcher().emitInsightsUpdate(sessionId, 'patched');
+                this.logger.debug('Emitted SSE update for new identity image', { sessionId });
+            }
+            catch (sseError) {
+                this.logger.debug('Failed to emit SSE for identity image', { sessionId, error: sseError });
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to generate identity image', { sessionId, error });
+            // Don't throw - this is a non-critical background operation
+        }
+    }
+    /**
+     * Convert cached insights to SessionInsights format
+     */
+    cachedToSessionInsights(cached) {
+        return {
+            sessionId: cached.session_id,
+            context: cached.context,
+            currentState: cached.current_state,
+            lastPatchTraceId: cached.last_patch_trace_id,
+            milestones: (cached.milestones || []),
+            notable: (cached.notable || []),
+            tags: cached.tags,
+            recentActions: cached.recent_actions || [],
+            panels: (cached.panels || []),
+            purposes: cached.purposes || [],
+            description: cached.description,
+            progress: cached.progress_total > 0 ? {
+                completed: cached.progress_completed,
+                inProgress: 0,
+                pending: cached.progress_total - cached.progress_completed,
+                total: cached.progress_total,
+                percent: Math.round((cached.progress_completed / cached.progress_total) * 100)
+            } : null,
+            recentlyCompleted: cached.completed_tasks,
+            outstanding: cached.outstanding_tasks,
+            currentTask: cached.current_task,
+            theme: cached.theme,
+            computedAt: cached.computed_at,
+            patchedAt: cached.patched_at
+        };
+    }
+    /**
+     * Get cached insights for multiple sessions (for list view)
+     */
+    async getCachedInsightsForSessions(sessionIds) {
+        const allCached = await this.sessionInfoService.getAllInsights();
+        const result = new Map();
+        for (const id of sessionIds) {
+            const cached = allCached.get(id);
+            if (cached) {
+                result.set(id, this.cachedToSessionInsights(cached));
+            }
+        }
+        return result;
+    }
+    /**
+     * Compute and cache insights for sessions that don't have cached insights
+     */
+    async computeMissingInsights(sessionIds, maxConcurrent = 3) {
+        const missing = await this.sessionInfoService.getMissingInsightsSessionIds(sessionIds);
+        if (missing.length === 0) {
+            return 0;
+        }
+        this.logger.info('Computing missing insights', { count: missing.length });
+        // Process in batches to avoid overwhelming the system
+        let computed = 0;
+        for (let i = 0; i < missing.length; i += maxConcurrent) {
+            const batch = missing.slice(i, i + maxConcurrent);
+            await Promise.all(batch.map(async (sessionId) => {
+                try {
+                    const insights = await this.computeInsights(sessionId);
+                    await this.cacheInsights(sessionId, insights);
+                    computed++;
+                }
+                catch (error) {
+                    this.logger.debug('Failed to compute insights for session', { sessionId, error });
+                }
+            }));
+        }
+        return computed;
+    }
+    /**
+     * Recompute insights for stale sessions (force refresh)
+     * Preserves accumulated milestones/notable from existing cache if new result is empty
+     */
+    async recomputeStaleInsights(sessionIds, maxConcurrent = 3) {
+        if (sessionIds.length === 0) {
+            return 0;
+        }
+        this.logger.info('Recomputing stale insights', { count: sessionIds.length });
+        // Process in batches to avoid overwhelming the system
+        let computed = 0;
+        for (let i = 0; i < sessionIds.length; i += maxConcurrent) {
+            const batch = sessionIds.slice(i, i + maxConcurrent);
+            await Promise.all(batch.map(async (sessionId) => {
+                const traceId = generateTraceId(sessionId);
+                const startTime = Date.now();
+                try {
+                    // Get existing cache BEFORE regenerating - we may need to preserve accumulated state
+                    const existingCache = await this.sessionInfoService.getInsights(sessionId);
+                    const beforeState = buildStateSnapshot(existingCache);
+                    this.logger.info('Computing insights for session', { traceId, sessionId });
+                    const insights = await this.computeInsights(sessionId);
+                    // Preserve accumulated milestones/notable if new result came back empty
+                    // This handles cases where the LLM regeneration doesn't capture the full history
+                    if (existingCache) {
+                        const existingMilestones = existingCache.milestones || [];
+                        const existingNotable = existingCache.notable || [];
+                        // If new milestones are empty but we had some before, preserve them
+                        if (insights.milestones.length === 0 && existingMilestones.length > 0) {
+                            this.logger.info('Preserving accumulated milestones from cache', {
+                                traceId,
+                                sessionId,
+                                preservedCount: existingMilestones.length
+                            });
+                            insights.milestones = existingMilestones;
+                        }
+                        // If new notable events are empty but we had some before, preserve them
+                        if (insights.notable.length === 0 && existingNotable.length > 0) {
+                            this.logger.info('Preserving accumulated notable events from cache', {
+                                traceId,
+                                sessionId,
+                                preservedCount: existingNotable.length
+                            });
+                            insights.notable = existingNotable;
+                        }
+                    }
+                    await this.cacheInsights(sessionId, insights);
+                    computed++;
+                    // Build after state and determine what changed
+                    const afterState = buildStateSnapshot(null, insights);
+                    const changedFields = [];
+                    if (beforeState.mission !== afterState.mission)
+                        changedFields.push('mission');
+                    if (beforeState.description !== afterState.description)
+                        changedFields.push('description');
+                    if (beforeState.currentState !== afterState.currentState)
+                        changedFields.push('currentState');
+                    if (beforeState.theme !== afterState.theme)
+                        changedFields.push('theme');
+                    if (JSON.stringify(beforeState.milestones) !== JSON.stringify(afterState.milestones))
+                        changedFields.push('milestones');
+                    if (JSON.stringify(beforeState.panels) !== JSON.stringify(afterState.panels))
+                        changedFields.push('panels');
+                    const durationMs = Date.now() - startTime;
+                    // Audit the recompute with full before/after state
+                    this.sessionInfoService.auditEventInsight({
+                        traceId,
+                        sessionId,
+                        eventType: 'recompute',
+                        trigger: 'stale_refresh',
+                        beforeState,
+                        afterState,
+                        patchedFields: changedFields,
+                        durationMs,
+                        llmResponse: `Opus returned: context=${!!insights.context}, description=${!!insights.description}, milestones=${insights.milestones.length}, panels=${insights.panels.length}`,
+                    });
+                    this.logger.info('Insights computed successfully', {
+                        traceId,
+                        sessionId,
+                        milestones: insights.milestones.length,
+                        notable: insights.notable.length,
+                        changedFields,
+                        durationMs,
+                    });
+                }
+                catch (error) {
+                    this.logger.warn('Failed to compute insights for session', { traceId, sessionId, error });
+                }
+            }));
+        }
+        return computed;
+    }
+    /**
+     * Get insights without AI generation (faster, for list views)
+     */
+    async getInsightsQuick(sessionId) {
+        // Check cache first - return cached AI insights if available
+        const cached = await this.sessionInfoService.getInsights(sessionId);
+        if (cached) {
+            return this.cachedToSessionInsights(cached);
+        }
+        // No cached insights - fall back to local extraction (no AI call)
+        const { messages } = await this.historyReader.fetchConversationDirect(sessionId);
+        const todos = this.extractTodoState(messages);
+        const progress = todos ? this.computeProgress(todos) : null;
+        const recentlyCompleted = todos
+            ? todos
+                .filter(t => t.status === 'completed')
+                .slice(-3)
+                .map(t => t.content)
+            : [];
+        const outstanding = todos
+            ? todos
+                .filter(t => t.status === 'pending' || t.status === 'in_progress')
+                .map(t => t.content)
+            : [];
+        const currentTask = todos
+            ? todos.find(t => t.status === 'in_progress')?.content || null
+            : null;
+        const theme = this.inferTheme(messages);
+        return {
+            sessionId,
+            context: null,
+            currentState: null,
+            milestones: [],
+            notable: [],
+            tags: null,
+            recentActions: [],
+            panels: [],
+            purposes: [],
+            description: null, // Skip AI generation for quick mode
+            progress,
+            recentlyCompleted,
+            outstanding,
+            currentTask,
+            theme
+        };
+    }
+}
+//# sourceMappingURL=session-insights-service.js.map