lattice-orchestrator 0.7.0

package/dist/services/sessions/session-analysis-service.js

@@ -0,0 +1,373 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import Database from 'better-sqlite3';
+import { createLogger } from '../infrastructure/logger.js';
+import { SessionInfoService } from '../sessions/session-info-service.js';
+import { ClaudeHistoryReader } from '../sessions/claude-history-reader.js';
+// ============================================================================
+// Service
+// ============================================================================
+/**
+ * SessionAnalysisService extracts and stores session health metrics.
+ * Phase 1: Metrics-only extraction (no LLM calls).
+ *
+ * Data sources:
+ * - Session JSONL file: messages, tool uses, timestamps
+ * - Debug log: errors, context overflows, auto-compacts
+ * - insight_event_audit: mission pivot count
+ */
+export class SessionAnalysisService {
+    static instance;
+    logger;
+    sessionInfoService;
+    historyReader;
+    db;
+    isInitialized = false;
+    // Prepared statements
+    getAnalysisStmt;
+    insertAnalysisStmt;
+    updateAnalysisStmt;
+    constructor(sessionInfoService, historyReader) {
+        this.logger = createLogger('SessionAnalysisService');
+        this.sessionInfoService = sessionInfoService || SessionInfoService.getInstance();
+        this.historyReader = historyReader || new ClaudeHistoryReader(this.sessionInfoService);
+    }
+    static getInstance() {
+        if (!SessionAnalysisService.instance) {
+            SessionAnalysisService.instance = new SessionAnalysisService();
+        }
+        return SessionAnalysisService.instance;
+    }
+    static resetInstance() {
+        SessionAnalysisService.instance = null;
+    }
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        // Get the database from SessionInfoService (shares the same DB file)
+        await this.sessionInfoService.initialize();
+        // Access the underlying database - we need to add our table to it
+        const dbPath = this.sessionInfoService.getDbPath();
+        this.db = new Database(dbPath);
+        this.db.pragma('busy_timeout = 10000');
+        // Create our table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS session_analyses (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id TEXT NOT NULL UNIQUE,
+        created_at TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'pending',
+        error_message TEXT,
+
+        -- Extracted metrics
+        duration_minutes INTEGER,
+        message_count INTEGER,
+        tool_use_count INTEGER,
+        error_count INTEGER,
+        context_overflow_count INTEGER,
+        auto_compact_count INTEGER,
+        file_edit_count INTEGER,
+        file_rewrite_count INTEGER,
+        mission_pivot_count INTEGER,
+
+        FOREIGN KEY (session_id) REFERENCES sessions(session_id)
+      )
+    `);
+        // Create index for fast lookups
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_session_analyses_session_id
+      ON session_analyses(session_id)
+    `);
+        this.prepareStatements();
+        this.isInitialized = true;
+        this.logger.info('SessionAnalysisService initialized');
+    }
+    prepareStatements() {
+        this.getAnalysisStmt = this.db.prepare('SELECT * FROM session_analyses WHERE session_id = ?');
+        this.insertAnalysisStmt = this.db.prepare(`
+      INSERT INTO session_analyses (session_id, created_at, status)
+      VALUES (@sessionId, @createdAt, @status)
+    `);
+        this.updateAnalysisStmt = this.db.prepare(`
+      UPDATE session_analyses SET
+        status = @status,
+        error_message = @errorMessage,
+        duration_minutes = @durationMinutes,
+        message_count = @messageCount,
+        tool_use_count = @toolUseCount,
+        error_count = @errorCount,
+        context_overflow_count = @contextOverflowCount,
+        auto_compact_count = @autoCompactCount,
+        file_edit_count = @fileEditCount,
+        file_rewrite_count = @fileRewriteCount,
+        mission_pivot_count = @missionPivotCount
+      WHERE session_id = @sessionId
+    `);
+    }
+    mapRow(row) {
+        const hasMetrics = row.message_count !== null;
+        return {
+            id: row.id,
+            sessionId: row.session_id,
+            createdAt: row.created_at,
+            status: row.status,
+            errorMessage: row.error_message,
+            metrics: hasMetrics ? {
+                durationMinutes: row.duration_minutes,
+                messageCount: row.message_count,
+                toolUseCount: row.tool_use_count ?? 0,
+                errorCount: row.error_count ?? 0,
+                contextOverflowCount: row.context_overflow_count ?? 0,
+                autoCompactCount: row.auto_compact_count ?? 0,
+                fileEditCount: row.file_edit_count ?? 0,
+                fileRewriteCount: row.file_rewrite_count ?? 0,
+                missionPivotCount: row.mission_pivot_count ?? 0,
+            } : null,
+        };
+    }
+    // ============================================================================
+    // Public API
+    // ============================================================================
+    /**
+     * Check if a session is eligible for analysis.
+     * Eligible if: ≥10 messages OR ≥5 min duration OR ≥5 tool uses
+     */
+    async isEligible(sessionId) {
+        try {
+            // Quick check: get basic message info from session file
+            const { messages } = await this.historyReader.fetchConversationDirect(sessionId);
+            const messageCount = messages.length;
+            const toolUseCount = this.countToolUses(messages);
+            // Calculate duration from first to last message
+            let durationMinutes = null;
+            if (messages.length >= 2) {
+                const firstTs = new Date(messages[0].timestamp).getTime();
+                const lastTs = new Date(messages[messages.length - 1].timestamp).getTime();
+                durationMinutes = Math.round((lastTs - firstTs) / 60000);
+            }
+            const metrics = { messageCount, toolUseCount, durationMinutes };
+            // Eligibility thresholds
+            if (messageCount >= 10) {
+                return { eligible: true, reason: `${messageCount} messages`, metrics };
+            }
+            if (durationMinutes !== null && durationMinutes >= 5) {
+                return { eligible: true, reason: `${durationMinutes} minute session`, metrics };
+            }
+            if (toolUseCount >= 5) {
+                return { eligible: true, reason: `${toolUseCount} tool uses`, metrics };
+            }
+            return {
+                eligible: false,
+                reason: `Session too small (${messageCount} msgs, ${durationMinutes ?? 0} min, ${toolUseCount} tools)`,
+                metrics,
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to check eligibility', { sessionId, error });
+            return { eligible: false, reason: 'Failed to read session' };
+        }
+    }
+    /**
+     * Get existing analysis for a session.
+     */
+    async getAnalysis(sessionId) {
+        try {
+            const row = this.getAnalysisStmt.get(sessionId);
+            return row ? this.mapRow(row) : null;
+        }
+        catch (error) {
+            this.logger.error('Failed to get analysis', { sessionId, error });
+            return null;
+        }
+    }
+    /**
+     * Extract metrics for a session.
+     * Creates a new analysis record or updates existing one.
+     */
+    async extractMetrics(sessionId) {
+        const now = new Date().toISOString();
+        // Check if analysis already exists
+        let existing = await this.getAnalysis(sessionId);
+        if (!existing) {
+            this.insertAnalysisStmt.run({
+                sessionId,
+                createdAt: now,
+                status: 'extracting',
+            });
+            existing = await this.getAnalysis(sessionId);
+        }
+        try {
+            // Update status to extracting
+            this.updateAnalysisStmt.run({
+                sessionId,
+                status: 'extracting',
+                errorMessage: null,
+                durationMinutes: null,
+                messageCount: null,
+                toolUseCount: null,
+                errorCount: null,
+                contextOverflowCount: null,
+                autoCompactCount: null,
+                fileEditCount: null,
+                fileRewriteCount: null,
+                missionPivotCount: null,
+            });
+            // Extract metrics from various sources
+            const metrics = await this.doExtractMetrics(sessionId);
+            // Update with extracted metrics
+            this.updateAnalysisStmt.run({
+                sessionId,
+                status: 'complete',
+                errorMessage: null,
+                durationMinutes: metrics.durationMinutes,
+                messageCount: metrics.messageCount,
+                toolUseCount: metrics.toolUseCount,
+                errorCount: metrics.errorCount,
+                contextOverflowCount: metrics.contextOverflowCount,
+                autoCompactCount: metrics.autoCompactCount,
+                fileEditCount: metrics.fileEditCount,
+                fileRewriteCount: metrics.fileRewriteCount,
+                missionPivotCount: metrics.missionPivotCount,
+            });
+            this.logger.info('Metrics extracted successfully', { sessionId, metrics });
+            return (await this.getAnalysis(sessionId));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.updateAnalysisStmt.run({
+                sessionId,
+                status: 'failed',
+                errorMessage,
+                durationMinutes: null,
+                messageCount: null,
+                toolUseCount: null,
+                errorCount: null,
+                contextOverflowCount: null,
+                autoCompactCount: null,
+                fileEditCount: null,
+                fileRewriteCount: null,
+                missionPivotCount: null,
+            });
+            this.logger.error('Failed to extract metrics', { sessionId, error });
+            return (await this.getAnalysis(sessionId));
+        }
+    }
+    // ============================================================================
+    // Private Extraction Methods
+    // ============================================================================
+    async doExtractMetrics(sessionId) {
+        // 1. Extract from session file
+        const { messages } = await this.historyReader.fetchConversationDirect(sessionId);
+        const messageCount = messages.length;
+        const toolUseCount = this.countToolUses(messages);
+        const { fileEditCount, fileRewriteCount } = this.countFileEdits(messages);
+        // Calculate duration
+        let durationMinutes = null;
+        if (messages.length >= 2) {
+            const firstTs = new Date(messages[0].timestamp).getTime();
+            const lastTs = new Date(messages[messages.length - 1].timestamp).getTime();
+            durationMinutes = Math.round((lastTs - firstTs) / 60000);
+        }
+        // 2. Extract from debug log
+        const debugMetrics = await this.extractDebugLogMetrics(sessionId);
+        // 3. Extract from insight audit
+        const missionPivotCount = this.countMissionPivots(sessionId);
+        return {
+            durationMinutes,
+            messageCount,
+            toolUseCount,
+            errorCount: debugMetrics.errorCount,
+            contextOverflowCount: debugMetrics.contextOverflowCount,
+            autoCompactCount: debugMetrics.autoCompactCount,
+            fileEditCount,
+            fileRewriteCount,
+            missionPivotCount,
+        };
+    }
+    countToolUses(messages) {
+        let count = 0;
+        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') {
+                    count++;
+                }
+            }
+        }
+        return count;
+    }
+    countFileEdits(messages) {
+        const fileCounts = new Map();
+        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 === 'Edit' || block.name === 'Write') &&
+                    'input' in block &&
+                    typeof block.input === 'object' &&
+                    block.input !== null &&
+                    'file_path' in block.input) {
+                    const filePath = String(block.input.file_path);
+                    fileCounts.set(filePath, (fileCounts.get(filePath) || 0) + 1);
+                }
+            }
+        }
+        const fileEditCount = fileCounts.size;
+        const fileRewriteCount = Array.from(fileCounts.values()).filter(c => c >= 3).length;
+        return { fileEditCount, fileRewriteCount };
+    }
+    async extractDebugLogMetrics(sessionId) {
+        const debugPath = path.join(os.homedir(), '.claude', 'debug', `${sessionId}.txt`);
+        try {
+            const content = await fs.readFile(debugPath, 'utf-8');
+            const lines = content.split('\n');
+            let errorCount = 0;
+            let contextOverflowCount = 0;
+            let autoCompactCount = 0;
+            for (const line of lines) {
+                if (line.includes('[ERROR]')) {
+                    errorCount++;
+                }
+                if (line.includes('prompt is too long')) {
+                    contextOverflowCount++;
+                }
+                if (line.includes('PreCompact with query: auto')) {
+                    autoCompactCount++;
+                }
+            }
+            return { errorCount, contextOverflowCount, autoCompactCount };
+        }
+        catch (error) {
+            // Debug file may not exist for all sessions
+            this.logger.debug('Could not read debug log', { sessionId, error });
+            return { errorCount: 0, contextOverflowCount: 0, autoCompactCount: 0 };
+        }
+    }
+    countMissionPivots(sessionId) {
+        try {
+            const row = this.db.prepare(`
+        SELECT COUNT(*) as count
+        FROM insight_event_audit
+        WHERE session_id = ? AND event_type = 'recompute'
+      `).get(sessionId);
+            return row?.count ?? 0;
+        }
+        catch (error) {
+            this.logger.debug('Could not count mission pivots', { sessionId, error });
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=session-analysis-service.js.map

package/dist/services/sessions/session-analysis-service.js.map

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

package/dist/services/sessions/session-branch-service.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Session Branch Service
+ *
+ * Creates branch sessions by truncating conversation history to a specific turn.
+ * Enables "rewind and branch" functionality - pick a point in history and start fresh.
+ */
+interface BranchResult {
+    newSessionId: string;
+    turnCount: number;
+    messageCount: number;
+}
+export declare class SessionBranchService {
+    private static instance;
+    private claudeHomePath;
+    private historyReader;
+    private sessionInfoService;
+    private constructor();
+    static getInstance(): SessionBranchService;
+    /**
+     * Create a branch from a session at a specific turn.
+     * The branch will contain all content up through the specified turn.
+     *
+     * @param sessionId - Source session to branch from
+     * @param options - Branch options including turn number and optional timestamp
+     * @returns New session ID and metadata
+     */
+    branchAfterTurn(sessionId: string, afterTurn: number, timestamp?: string): Promise<BranchResult>;
+    /**
+     * Copy session data (turns, marks) from source to branch.
+     * Only copies data for turns <= afterTurn.
+     */
+    private copySessionData;
+    /**
+     * Find indices where each turn starts (human text messages).
+     * A "turn" begins with a user message containing actual text content,
+     * not tool results.
+     */
+    private findTurnBoundaries;
+    /**
+     * Check if a user message contains actual human text (not just tool results).
+     */
+    private hasHumanText;
+    /**
+     * Find the cut index by matching a timestamp to a turn in the JSONL.
+     * This handles the discrepancy between DB turn numbers and JSONL turn counts.
+     *
+     * Strategy: Find the turn whose user message timestamp is closest to the target,
+     * then return the cut index (start of the next turn, or end of file).
+     */
+    private findCutIndexByTimestamp;
+    /**
+     * Determine the target project directory for the branch.
+     * The CLI uses RESOLVED paths (symlinks followed), so we need to match that.
+     */
+    private determineTargetDirectory;
+    /**
+     * Find the JSONL file for a session by checking each project folder.
+     */
+    private findSessionFile;
+    /**
+     * Get the number of turns in a session.
+     * Useful for UI to know valid range for branching.
+     */
+    getTurnCount(sessionId: string): Promise<number>;
+    /**
+     * Find the UUID of the last message in a specific turn.
+     * Used to identify the branch point for UI indicators.
+     *
+     * @param sessionId - The session to search
+     * @param turnNumber - The turn number (1-indexed)
+     * @returns The UUID of the last message in that turn, or null if not found
+     */
+    getBranchPointMessageId(sessionId: string, turnNumber: number): Promise<string | null>;
+}
+export {};
+//# sourceMappingURL=session-branch-service.d.ts.map

package/dist/services/sessions/session-branch-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-branch-service.d.ts","sourceRoot":"","sources":["../../../src/services/sessions/session-branch-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,UAAU,YAAY;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAC9C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO;IAMP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;;;;;;OAOG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA2GtG;;;OAGG;YACW,eAAe;IA0C7B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAyD/B;;;OAGG;YACW,wBAAwB;IAuBtC;;OAEG;YACW,eAAe;IA2B7B;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAatD;;;;;;;OAOG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA6C7F"}