@nexus-cortex/core 4.26.0

package/dist/session/CheckpointManager.js

@@ -0,0 +1,223 @@
+/**
+ * Checkpoint Manager
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md Part 3
+ *
+ * Manages user-created checkpoints with resume capability
+ * Supports cross-provider resume and conversation branching
+ */
+/**
+ * Checkpoint Manager
+ *
+ * Handles checkpoint creation, storage, and resume operations
+ */
+export class CheckpointManager {
+    timeline;
+    historyStore;
+    workspacePath;
+    fileCheckpointManager;
+    constructor(timeline, historyStore, workspacePath, fileCheckpointManager) {
+        this.timeline = timeline;
+        this.historyStore = historyStore;
+        this.workspacePath = workspacePath;
+        this.fileCheckpointManager = fileCheckpointManager;
+    }
+    /**
+     * Create a checkpoint at the current position
+     *
+     * Usage: /checkpoint [description]
+     */
+    async createCheckpoint(options = {}) {
+        const { description, includeFileStates, metadata } = options;
+        // Get current conversation
+        const conversation = this.timeline.getCurrentConversation();
+        if (!conversation) {
+            throw new Error('No active conversation to checkpoint');
+        }
+        // Get all messages up to this point
+        const messages = await this.historyStore.loadSession(this.timeline.sessionId, this.workspacePath);
+        const messageIds = messages.map(m => m.uuid);
+        // Create checkpoint in timeline
+        const checkpoint = this.timeline.createCheckpoint(description, messageIds);
+        // Add file states if requested
+        if (includeFileStates && this.fileCheckpointManager) {
+            try {
+                const snapshot = await this.fileCheckpointManager.createSnapshot(checkpoint.id);
+                // Transform FileBackupInfo to CheckpointWithFiles format
+                const fileStates = {};
+                for (const [filePath, backupInfo] of Object.entries(snapshot.snapshotMessage.snapshot.trackedFileBackups)) {
+                    fileStates[filePath] = {
+                        path: filePath,
+                        hash: backupInfo.backupFileName || '',
+                        version: backupInfo.version,
+                        timestamp: backupInfo.backupTime
+                    };
+                }
+                checkpoint.fileStates = fileStates;
+            }
+            catch (error) {
+                console.warn('[CheckpointManager] Failed to capture file states:', error);
+                // Continue without file states rather than failing the checkpoint
+            }
+        }
+        // Add custom metadata if provided
+        if (metadata) {
+            checkpoint.customMetadata = metadata;
+        }
+        return checkpoint;
+    }
+    /**
+     * Resume from a checkpoint
+     *
+     * Usage: /resume <checkpoint-id> [--model <model-id>]
+     */
+    async resumeFromCheckpoint(checkpointId, options = {}) {
+        const { modelId, preserveHistory } = options;
+        // Get checkpoint
+        const checkpoint = this.timeline.getCheckpoint(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint ${checkpointId} not found`);
+        }
+        // Resume in timeline (creates new conversation branch)
+        const { conversation, checkpoint: updatedCheckpoint } = this.timeline.resumeFromCheckpoint(checkpointId, modelId);
+        // Load messages from checkpoint
+        const messages = await this.loadCheckpointMessages(checkpoint);
+        // Update history store with resumed conversation
+        if (!preserveHistory) {
+            // Replace current history with checkpoint messages
+            const updatedMessages = messages.map(message => ({
+                ...message,
+                // Add timeline tracking to messages
+                timeline: message.timeline || {
+                    sessionId: this.timeline.sessionId,
+                    conversationId: conversation.id,
+                    turnNumber: checkpoint.turnNumber,
+                    resumePoint: true,
+                },
+            }));
+            await this.historyStore.saveSession(this.timeline.sessionId, updatedMessages, this.workspacePath);
+        }
+        return {
+            conversation,
+            checkpoint: updatedCheckpoint,
+            messages,
+        };
+    }
+    /**
+     * List all checkpoints
+     *
+     * Usage: /checkpoints
+     */
+    listCheckpoints() {
+        return this.timeline.getAllCheckpoints();
+    }
+    /**
+     * Get checkpoint details
+     */
+    getCheckpoint(checkpointId) {
+        return this.timeline.getCheckpoint(checkpointId);
+    }
+    /**
+     * Delete a checkpoint
+     */
+    deleteCheckpoint(checkpointId) {
+        const checkpoint = this.timeline.getCheckpoint(checkpointId);
+        if (!checkpoint) {
+            return false;
+        }
+        // Mark as not resumable (soft delete)
+        checkpoint.resumable = false;
+        return true;
+    }
+    /**
+     * Get checkpoint history (all resumes from this checkpoint)
+     */
+    getCheckpointHistory(checkpointId) {
+        const resumeEvents = this.timeline.getResumePoints();
+        return resumeEvents
+            .filter(rp => rp.checkpointId === checkpointId)
+            .map(rp => ({
+            resumeTime: rp.timestamp,
+            modelId: rp.resumedModel,
+            conversationId: rp.conversationId,
+        }));
+    }
+    // Reserved for future use - will integrate with token counting service
+    // private async _calculateContextMetadata(messages: Message[]): Promise<{
+    //   totalTokens: number;
+    //   criticalTokens: number;
+    //   compactableTokens: number;
+    // }> {
+    //   const estimatedTokensPerMessage = 100;
+    //   const totalTokens = messages.length * estimatedTokensPerMessage;
+    //   const criticalMessageCount = Math.min(messages.length, 10);
+    //   const criticalTokens = criticalMessageCount * estimatedTokensPerMessage;
+    //   const compactableTokens = totalTokens - criticalTokens;
+    //   return {
+    //     totalTokens,
+    //     criticalTokens,
+    //     compactableTokens,
+    //   };
+    // }
+    /**
+     * Load messages from checkpoint
+     */
+    async loadCheckpointMessages(checkpoint) {
+        const allMessages = await this.historyStore.loadSession(this.timeline.sessionId, this.workspacePath);
+        const checkpointMessageIds = new Set(checkpoint.snapshot.messageIds);
+        return allMessages.filter(m => checkpointMessageIds.has(m.uuid));
+    }
+    /**
+     * Precompute message selection for target model
+     *
+     * This allows fast resume by pre-selecting messages that fit in target model's context
+     */
+    async precomputeSelectionForModel(checkpointId, targetModelId, _targetContextWindow, strategy = 'preserve-critical') {
+        const checkpoint = this.timeline.getCheckpoint(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint ${checkpointId} not found`);
+        }
+        // Load messages
+        const messages = await this.loadCheckpointMessages(checkpoint);
+        // TODO: Implement intelligent message selection based on strategy
+        // For now, simple selection: take last N messages that fit
+        const selectedMessages = messages.slice(-50).map(m => m.uuid);
+        const estimatedTokens = selectedMessages.length * 100; // Rough estimate
+        // Store precomputed selection
+        if (!checkpoint.snapshot.contextMetadata.precomputedSelections) {
+            checkpoint.snapshot.contextMetadata.precomputedSelections = {};
+        }
+        checkpoint.snapshot.contextMetadata.precomputedSelections[targetModelId] = {
+            selectedMessages,
+            estimatedTokens,
+            strategy,
+        };
+    }
+    /**
+     * Export checkpoint to JSON
+     */
+    async exportCheckpoint(checkpointId) {
+        const checkpoint = this.timeline.getCheckpoint(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint ${checkpointId} not found`);
+        }
+        const messages = await this.loadCheckpointMessages(checkpoint);
+        return JSON.stringify({
+            checkpoint,
+            messages,
+            exportedAt: new Date().toISOString(),
+        }, null, 2);
+    }
+    /**
+     * Import checkpoint from JSON
+     */
+    async importCheckpoint(checkpointJson) {
+        const data = JSON.parse(checkpointJson);
+        const { checkpoint } = data;
+        // Note: messages field available in data.messages for future use
+        // TODO: Validate checkpoint structure
+        // TODO: Add messages to history store
+        // TODO: Register checkpoint in timeline
+        return checkpoint;
+    }
+}
+//# sourceMappingURL=CheckpointManager.js.map

package/dist/session/CheckpointManager.js.map

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

package/dist/session/JSONLHistoryStore.d.ts

@@ -0,0 +1,154 @@
+/**
+ * JSONL History Store
+ * Implements Claude CLI's one-message-per-line storage format
+ *
+ * Based on: .claude/claude_research_analysis/02-claude-cli-analysis/CLAUDE_CODE_CLI_ARCHITECTURE.md
+ * Format: JSONL (JSON Lines) - one complete message object per line
+ */
+import { Message, SessionMetadata } from './MessageTypes.js';
+export interface JSONLHistoryStoreConfig {
+    /**
+     * Base directory for session storage
+     * Default: .cortex/sessions/
+     */
+    baseDir: string;
+    /**
+     * Enable automatic backups on save
+     * Default: true
+     */
+    enableBackups?: boolean;
+    /**
+     * Maximum number of backup files to keep
+     * Default: 5
+     */
+    maxBackups?: number;
+}
+export interface SessionInfo {
+    /**
+     * Session UUID
+     */
+    sessionId: string;
+    /**
+     * Path to the JSONL file
+     */
+    filePath: string;
+    /**
+     * Session metadata
+     */
+    metadata: SessionMetadata;
+    /**
+     * Total messages in session
+     */
+    messageCount: number;
+    /**
+     * File size in bytes
+     */
+    fileSize: number;
+    /**
+     * Last modified timestamp
+     */
+    lastModified: Date;
+}
+/**
+ * JSONL History Store
+ *
+ * Manages session storage using JSONL format (one message per line)
+ * - Append-only writes for performance
+ * - Each line is a complete JSON message object
+ * - Session files named: {sessionUuid}.jsonl
+ * - Stored in: {baseDir}/{normalized-workspace-path}/{sessionUuid}.jsonl
+ */
+export declare class JSONLHistoryStore {
+    private config;
+    private ensuredDirs;
+    constructor(config: JSONLHistoryStoreConfig);
+    /**
+     * Get the file path for a session
+     */
+    getSessionPath(sessionId: string, workspacePath?: string): string;
+    /**
+     * Check if a session exists
+     */
+    sessionExists(sessionId: string, workspacePath?: string): Promise<boolean>;
+    /**
+     * Load all messages from a session
+     *
+     * Reads the JSONL file line by line and parses each message
+     */
+    loadSession(sessionId: string, workspacePath?: string): Promise<Message[]>;
+    /**
+     * Save entire session history
+     *
+     * Writes all messages to JSONL file (one per line)
+     * Creates backup of existing file if enabled
+     */
+    saveSession(sessionId: string, messages: Message[], workspacePath?: string): Promise<void>;
+    /**
+     * Append a single message to the session
+     *
+     * This is the primary write operation - append-only for performance
+     * Does NOT read the entire file, just appends one line
+     */
+    appendMessage(sessionId: string, message: Message, workspacePath?: string): Promise<void>;
+    /**
+     * mkdir memo: skip the syscall when the directory was already ensured
+     * this process. Crash safety unaffected — this only gates mkdir, never
+     * the appendFile write.
+     */
+    private ensureDir;
+    /**
+     * Ensure dir (memoized) then append. On ENOENT (dir deleted externally
+     * after the memo was set) evict the memo, re-mkdir, and retry once.
+     * Non-ENOENT errors propagate without a retry.
+     */
+    private writeWithRecovery;
+    /**
+     * Append multiple messages to the session
+     *
+     * Batch append operation for efficiency
+     */
+    appendMessages(sessionId: string, messages: Message[], workspacePath?: string): Promise<void>;
+    /**
+     * Get session information without loading all messages
+     */
+    getSessionInfo(sessionId: string, workspacePath?: string): Promise<SessionInfo | null>;
+    /**
+     * List all sessions in the base directory
+     */
+    listSessions(workspacePath?: string): Promise<SessionInfo[]>;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string, workspacePath?: string): Promise<boolean>;
+    /**
+     * Create a backup of the session file
+     */
+    private createBackup;
+    /**
+     * Remove old backup files, keeping only the most recent ones
+     */
+    private cleanupOldBackups;
+    /**
+     * Get the metadata file path for a session
+     */
+    getMetadataPath(sessionId: string, workspacePath?: string): string;
+    /**
+     * Save session metadata (includes cache metrics, model info, etc.)
+     */
+    saveMetadata(sessionId: string, metadata: Partial<SessionMetadata>, workspacePath?: string): Promise<void>;
+    /**
+     * Load session metadata
+     */
+    loadMetadata(sessionId: string, workspacePath?: string): Promise<SessionMetadata | null>;
+    /**
+     * Get storage statistics
+     */
+    getStorageStats(workspacePath?: string): Promise<{
+        totalSessions: number;
+        totalMessages: number;
+        totalSize: number;
+        oldestSession: Date | null;
+        newestSession: Date | null;
+    }>;
+}
+//# sourceMappingURL=JSONLHistoryStore.d.ts.map

package/dist/session/JSONLHistoryStore.d.ts.map

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