claude-code-history 0.2.2

package/dist/lib/migrate.js

@@ -0,0 +1,274 @@
+/**
+ * Migration functionality for claude-code-history library.
+ *
+ * Provides functions to copy/move sessions between workspaces
+ * while preserving rollback functionality.
+ */
+import { readFile, writeFile, mkdir, unlink, readdir } from 'fs/promises';
+import { join } from 'path';
+import { resolveConfig } from './config.js';
+import { getProjectsPath, encodeProjectPath } from './platform.js';
+import { getSession } from './session.js';
+import { WorkspaceNotFoundError } from './errors.js';
+// =============================================================================
+// Path Rewriting
+// =============================================================================
+/**
+ * Rewrite a path from source workspace to destination workspace.
+ * Only rewrites paths that start with the source workspace.
+ */
+function rewritePath(path, sourceWorkspace, destWorkspace) {
+    // Normalize paths (remove trailing slashes)
+    const normalizedSource = sourceWorkspace.replace(/\/+$/, '');
+    const normalizedDest = destWorkspace.replace(/\/+$/, '');
+    if (path.startsWith(normalizedSource)) {
+        return normalizedDest + path.slice(normalizedSource.length);
+    }
+    return path;
+}
+/**
+ * Rewrite paths in tool_use input objects.
+ */
+function rewriteToolInput(input, sourceWorkspace, destWorkspace) {
+    const result = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (key === 'file_path' && typeof value === 'string') {
+            result[key] = rewritePath(value, sourceWorkspace, destWorkspace);
+        }
+        else if (key === 'path' && typeof value === 'string') {
+            result[key] = rewritePath(value, sourceWorkspace, destWorkspace);
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            result[key] = rewriteToolInput(value, sourceWorkspace, destWorkspace);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Rewrite paths in message content.
+ */
+function rewriteMessageContent(content, sourceWorkspace, destWorkspace) {
+    if (!Array.isArray(content)) {
+        return content;
+    }
+    return content.map((block) => {
+        if (typeof block !== 'object' || block === null) {
+            return block;
+        }
+        const typed = block;
+        // Rewrite tool_use inputs
+        if (typed.type === 'tool_use' && typeof typed.input === 'object' && typed.input !== null) {
+            return {
+                ...typed,
+                input: rewriteToolInput(typed.input, sourceWorkspace, destWorkspace),
+            };
+        }
+        return block;
+    });
+}
+/**
+ * Rewrite paths in trackedFileBackups.
+ */
+function rewriteTrackedFileBackups(backups, sourceWorkspace, destWorkspace) {
+    const result = {};
+    for (const [filePath, backup] of Object.entries(backups)) {
+        const newPath = rewritePath(filePath, sourceWorkspace, destWorkspace);
+        result[newPath] = backup;
+    }
+    return result;
+}
+/**
+ * Rewrite all paths in a raw session entry.
+ */
+function rewriteEntryPaths(entry, sourceWorkspace, destWorkspace) {
+    const result = { ...entry };
+    // Rewrite cwd field
+    if (result.cwd) {
+        result.cwd = rewritePath(result.cwd, sourceWorkspace, destWorkspace);
+    }
+    // Rewrite message content (for tool_use inputs)
+    if (result.message?.content !== undefined) {
+        result.message = {
+            ...result.message,
+            content: rewriteMessageContent(result.message.content, sourceWorkspace, destWorkspace),
+        };
+    }
+    // Rewrite file-history-snapshot paths
+    if (result.type === 'file-history-snapshot' && result.snapshot) {
+        result.snapshot = {
+            ...result.snapshot,
+            trackedFileBackups: rewriteTrackedFileBackups(result.snapshot.trackedFileBackups, sourceWorkspace, destWorkspace),
+        };
+    }
+    return result;
+}
+// =============================================================================
+// Migration Implementation
+// =============================================================================
+/**
+ * Read and parse a session file, rewrite paths, and return as JSONL string.
+ */
+async function readAndRewriteSession(filePath, sourceWorkspace, destWorkspace) {
+    const content = await readFile(filePath, 'utf-8');
+    const lines = content.split('\n').filter((line) => line.trim());
+    const rewrittenLines = [];
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            const rewritten = rewriteEntryPaths(entry, sourceWorkspace, destWorkspace);
+            rewrittenLines.push(JSON.stringify(rewritten));
+        }
+        catch {
+            // Keep original line if parse fails
+            rewrittenLines.push(line);
+        }
+    }
+    return rewrittenLines.join('\n') + '\n';
+}
+/**
+ * Migrate a single session file.
+ */
+async function migrateSessionFile(sessionId, sourceFilePath, sourceWorkspace, destWorkspace, dataPath, mode) {
+    // Compute destination path
+    const destEncodedPath = encodeProjectPath(destWorkspace);
+    const destProjectDir = join(getProjectsPath(dataPath), destEncodedPath);
+    const destFilePath = join(destProjectDir, `${sessionId}.jsonl`);
+    // Ensure destination directory exists
+    await mkdir(destProjectDir, { recursive: true });
+    // Read, rewrite paths, and write to destination
+    const rewrittenContent = await readAndRewriteSession(sourceFilePath, sourceWorkspace, destWorkspace);
+    await writeFile(destFilePath, rewrittenContent, 'utf-8');
+    // Delete source if moving
+    if (mode === 'move') {
+        await unlink(sourceFilePath);
+    }
+}
+/**
+ * Migrate sessions to a different workspace.
+ *
+ * This function copies or moves session files while rewriting all
+ * absolute paths to point to the new workspace location.
+ *
+ * @param config - Migration configuration
+ * @returns Migration result with success/failure counts
+ *
+ * @example
+ * ```typescript
+ * // Copy a single session
+ * const result = await migrateSession({
+ *   sessions: 0,
+ *   destination: '/new/project/path',
+ * });
+ *
+ * // Move multiple sessions
+ * const result = await migrateSession({
+ *   sessions: [0, 1, 'abc123-...'],
+ *   destination: '/new/project/path',
+ *   mode: 'move',
+ * });
+ * ```
+ */
+export async function migrateSession(config, libraryConfig) {
+    const resolved = resolveConfig(libraryConfig);
+    const mode = config.mode ?? 'copy';
+    // Normalize sessions to array
+    const sessionIds = Array.isArray(config.sessions) ? config.sessions : [config.sessions];
+    const errors = [];
+    let successCount = 0;
+    for (const sessionId of sessionIds) {
+        try {
+            // Get session to find its file path and source workspace
+            const session = await getSession(sessionId, {
+                dataPath: resolved.dataPath,
+                workspace: resolved.workspace,
+            });
+            const sourceFilePath = join(getProjectsPath(resolved.dataPath), session.encodedPath, `${session.id}.jsonl`);
+            await migrateSessionFile(session.id, sourceFilePath, session.projectPath, config.destination, resolved.dataPath, mode);
+            successCount++;
+        }
+        catch (error) {
+            errors.push({
+                sessionId: String(sessionId),
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+    return {
+        successCount,
+        failedCount: errors.length,
+        errors,
+    };
+}
+/**
+ * Migrate all sessions from one workspace to another.
+ *
+ * @param config - Workspace migration configuration
+ * @returns Migration result with success/failure counts
+ *
+ * @example
+ * ```typescript
+ * const result = await migrateWorkspace({
+ *   source: '/old/project/path',
+ *   destination: '/new/project/path',
+ *   mode: 'move',
+ * });
+ * ```
+ */
+export async function migrateWorkspace(config, libraryConfig) {
+    const resolved = resolveConfig(libraryConfig);
+    const mode = config.mode ?? 'copy';
+    // Find all sessions in source workspace
+    const sourceEncodedPath = encodeProjectPath(config.source);
+    const sourceProjectDir = join(getProjectsPath(resolved.dataPath), sourceEncodedPath);
+    // Check if source workspace exists
+    let files;
+    try {
+        files = await readdir(sourceProjectDir);
+    }
+    catch {
+        throw new WorkspaceNotFoundError(config.source);
+    }
+    // Filter to session files only
+    const sessionFiles = files.filter((f) => f.endsWith('.jsonl') && !f.startsWith('agent-'));
+    const errors = [];
+    let successCount = 0;
+    for (const filename of sessionFiles) {
+        const sessionId = filename.replace('.jsonl', '');
+        const sourceFilePath = join(sourceProjectDir, filename);
+        try {
+            await migrateSessionFile(sessionId, sourceFilePath, config.source, config.destination, resolved.dataPath, mode);
+            successCount++;
+        }
+        catch (error) {
+            errors.push({
+                sessionId,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+    // Also migrate agent sessions
+    const agentFiles = files.filter((f) => f.startsWith('agent-') && f.endsWith('.jsonl'));
+    for (const filename of agentFiles) {
+        const agentId = filename.replace('.jsonl', '');
+        const sourceFilePath = join(sourceProjectDir, filename);
+        try {
+            await migrateSessionFile(agentId, sourceFilePath, config.source, config.destination, resolved.dataPath, mode);
+            successCount++;
+        }
+        catch (error) {
+            errors.push({
+                sessionId: agentId,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+    return {
+        successCount,
+        failedCount: errors.length,
+        errors,
+    };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/lib/migrate.js.map

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

package/dist/lib/parser.d.ts

@@ -0,0 +1,67 @@
+/**
+ * JSONL parser for Claude Code session files.
+ *
+ * Provides stream-based parsing with error recovery:
+ * - Skips invalid JSON lines and continues processing
+ * - Tracks parse warnings for reporting
+ * - Transforms raw entries into typed Message objects
+ */
+import type { RawSessionEntry, Message, ParseResult, ParseWarning } from './types.js';
+/**
+ * Parse a single JSONL line into a raw session entry.
+ * @param line - Raw JSON line from session file
+ * @param lineNumber - Line number for error reporting
+ * @returns Parsed entry or null if invalid
+ */
+export declare function parseJsonLine(line: string, lineNumber: number): {
+    entry: RawSessionEntry;
+    warning: null;
+} | {
+    entry: null;
+    warning: ParseWarning;
+};
+/**
+ * Parse all lines from a JSONL file.
+ * @param filePath - Path to the JSONL session file
+ * @returns Array of raw entries and any parse warnings
+ */
+export declare function parseJsonlFile(filePath: string): Promise<ParseResult<RawSessionEntry[]>>;
+/**
+ * Transform a raw session entry into a typed Message.
+ * @param entry - Raw parsed entry from JSONL
+ * @returns Typed Message or null if not a message entry
+ */
+export declare function transformEntry(entry: RawSessionEntry): Message | null;
+/**
+ * Parse a JSONL session file into typed Messages.
+ * @param filePath - Path to the JSONL session file
+ * @returns Parsed messages and warnings
+ */
+export declare function parseSessionFile(filePath: string): Promise<ParseResult<Message[]>>;
+/**
+ * Extract session metadata from raw entries (summary, version, etc.).
+ * Reads only the necessary fields without full message parsing.
+ */
+export interface SessionMetadata {
+    summary: string | null;
+    version: string;
+    gitBranch: string | null;
+    sessionId: string | null;
+    agentId: string | null;
+    firstTimestamp: Date | null;
+    lastTimestamp: Date | null;
+    messageCount: number;
+}
+/**
+ * Extract metadata from raw session entries.
+ * @param entries - Raw parsed entries
+ * @returns Session metadata
+ */
+export declare function extractMetadata(entries: RawSessionEntry[]): SessionMetadata;
+/**
+ * Quick parse to extract only session metadata (faster than full parse).
+ * @param filePath - Path to the JSONL session file
+ * @returns Session metadata and warnings
+ */
+export declare function parseSessionMetadata(filePath: string): Promise<ParseResult<SessionMetadata>>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,eAAe,EAIf,OAAO,EAaP,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAsBpF;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,CAyB9F;AA2HD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,GAAG,IAAI,CAiErE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAaxF;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,CAwD3E;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAIvC"}

package/dist/lib/parser.js

@@ -0,0 +1,321 @@
+/**
+ * JSONL parser for Claude Code session files.
+ *
+ * Provides stream-based parsing with error recovery:
+ * - Skips invalid JSON lines and continues processing
+ * - Tracks parse warnings for reporting
+ * - Transforms raw entries into typed Message objects
+ */
+import { createReadStream } from 'fs';
+import { createInterface } from 'readline';
+// =============================================================================
+// Raw Entry Parsing
+// =============================================================================
+/**
+ * Parse a single JSONL line into a raw session entry.
+ * @param line - Raw JSON line from session file
+ * @param lineNumber - Line number for error reporting
+ * @returns Parsed entry or null if invalid
+ */
+export function parseJsonLine(line, lineNumber) {
+    const trimmed = line.trim();
+    // Skip empty lines
+    if (!trimmed) {
+        return { entry: null, warning: { line: lineNumber, error: 'Empty line' } };
+    }
+    try {
+        const entry = JSON.parse(trimmed);
+        return { entry, warning: null };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown parse error';
+        return {
+            entry: null,
+            warning: {
+                line: lineNumber,
+                error: `Invalid JSON: ${errorMessage}`,
+                content: trimmed.length > 100 ? trimmed.slice(0, 100) + '...' : trimmed,
+            },
+        };
+    }
+}
+/**
+ * Parse all lines from a JSONL file.
+ * @param filePath - Path to the JSONL session file
+ * @returns Array of raw entries and any parse warnings
+ */
+export async function parseJsonlFile(filePath) {
+    const entries = [];
+    const warnings = [];
+    const fileStream = createReadStream(filePath, { encoding: 'utf-8' });
+    const rl = createInterface({
+        input: fileStream,
+        crlfDelay: Infinity,
+    });
+    let lineNumber = 0;
+    for await (const line of rl) {
+        lineNumber++;
+        const result = parseJsonLine(line, lineNumber);
+        if (result.entry) {
+            entries.push(result.entry);
+        }
+        else if (result.warning && result.warning.error !== 'Empty line') {
+            // Only track non-empty line warnings
+            warnings.push(result.warning);
+        }
+    }
+    return { data: entries, warnings };
+}
+// =============================================================================
+// Message Transformation
+// =============================================================================
+/**
+ * Transform raw token usage to typed TokenUsage.
+ */
+function transformTokenUsage(raw) {
+    return {
+        inputTokens: raw?.input_tokens ?? 0,
+        outputTokens: raw?.output_tokens ?? 0,
+        cacheCreationInputTokens: raw?.cache_creation_input_tokens ?? 0,
+        cacheReadInputTokens: raw?.cache_read_input_tokens ?? 0,
+    };
+}
+/**
+ * Transform raw file snapshot to typed FileSnapshot.
+ */
+function transformFileSnapshot(raw) {
+    const trackedFileBackups = {};
+    for (const [path, backup] of Object.entries(raw.trackedFileBackups)) {
+        trackedFileBackups[path] = {
+            backupFileName: backup.backupFileName,
+            version: backup.version,
+            backupTime: new Date(backup.backupTime),
+        };
+    }
+    return {
+        messageId: raw.messageId,
+        timestamp: new Date(raw.timestamp),
+        trackedFileBackups,
+    };
+}
+/**
+ * Parse assistant content from raw message.
+ */
+function parseAssistantContent(rawContent) {
+    if (!Array.isArray(rawContent)) {
+        // Handle string content (rare but possible)
+        if (typeof rawContent === 'string') {
+            return [{ type: 'text', text: rawContent }];
+        }
+        return [];
+    }
+    return rawContent
+        .map((item) => {
+        if (typeof item !== 'object' || item === null) {
+            return null;
+        }
+        const typed = item;
+        switch (typed.type) {
+            case 'text':
+                return {
+                    type: 'text',
+                    text: String(typed.text ?? ''),
+                };
+            case 'tool_use':
+                return {
+                    type: 'tool_use',
+                    id: String(typed.id ?? ''),
+                    name: String(typed.name ?? ''),
+                    input: typed.input ?? {},
+                };
+            case 'thinking':
+                return {
+                    type: 'thinking',
+                    thinking: String(typed.thinking ?? ''),
+                };
+            default:
+                return null;
+        }
+    })
+        .filter((item) => item !== null);
+}
+/**
+ * Parse user content from raw message.
+ */
+function parseUserContent(rawContent) {
+    // String content (normal user message)
+    if (typeof rawContent === 'string') {
+        return rawContent;
+    }
+    // Array content (tool results)
+    if (Array.isArray(rawContent)) {
+        return rawContent
+            .map((item) => {
+            if (typeof item !== 'object' || item === null) {
+                return null;
+            }
+            const typed = item;
+            if (typed.type === 'tool_result') {
+                return {
+                    type: 'tool_result',
+                    tool_use_id: String(typed.tool_use_id ?? ''),
+                    content: String(typed.content ?? ''),
+                    is_error: typed.is_error === true ? true : undefined,
+                };
+            }
+            return null;
+        })
+            .filter((item) => item !== null);
+    }
+    return '';
+}
+/**
+ * Transform a raw session entry into a typed Message.
+ * @param entry - Raw parsed entry from JSONL
+ * @returns Typed Message or null if not a message entry
+ */
+export function transformEntry(entry) {
+    const timestamp = entry.timestamp ? new Date(entry.timestamp) : new Date();
+    const uuid = entry.uuid ?? '';
+    const parentUuid = entry.parentUuid ?? null;
+    switch (entry.type) {
+        case 'user': {
+            const message = entry.message;
+            return {
+                type: 'user',
+                uuid,
+                parentUuid,
+                timestamp,
+                role: 'user',
+                content: parseUserContent(message?.content),
+                cwd: entry.cwd ?? '',
+                gitBranch: entry.gitBranch ?? null,
+                isSidechain: entry.isSidechain ?? false,
+            };
+        }
+        case 'assistant': {
+            const message = entry.message;
+            return {
+                type: 'assistant',
+                uuid,
+                parentUuid,
+                timestamp,
+                role: 'assistant',
+                model: message?.model ?? '',
+                content: parseAssistantContent(message?.content),
+                stopReason: message?.stop_reason ?? null,
+                usage: transformTokenUsage(message?.usage),
+            };
+        }
+        case 'summary': {
+            return {
+                type: 'summary',
+                uuid,
+                parentUuid,
+                timestamp,
+                summary: entry.summary ?? '',
+                leafUuid: entry.leafUuid ?? '',
+            };
+        }
+        case 'file-history-snapshot': {
+            if (!entry.snapshot) {
+                return null;
+            }
+            return {
+                type: 'file-history-snapshot',
+                uuid,
+                parentUuid,
+                timestamp,
+                messageId: entry.messageId ?? '',
+                snapshot: transformFileSnapshot(entry.snapshot),
+            };
+        }
+        default:
+            // Unknown entry type - skip
+            return null;
+    }
+}
+/**
+ * Parse a JSONL session file into typed Messages.
+ * @param filePath - Path to the JSONL session file
+ * @returns Parsed messages and warnings
+ */
+export async function parseSessionFile(filePath) {
+    const { data: entries, warnings } = await parseJsonlFile(filePath);
+    const messages = [];
+    for (const entry of entries) {
+        const message = transformEntry(entry);
+        if (message) {
+            messages.push(message);
+        }
+    }
+    return { data: messages, warnings };
+}
+/**
+ * Extract metadata from raw session entries.
+ * @param entries - Raw parsed entries
+ * @returns Session metadata
+ */
+export function extractMetadata(entries) {
+    let summary = null;
+    let version = '';
+    let gitBranch = null;
+    let sessionId = null;
+    let agentId = null;
+    let firstTimestamp = null;
+    let lastTimestamp = null;
+    let messageCount = 0;
+    for (const entry of entries) {
+        // Extract summary from summary entry
+        if (entry.type === 'summary' && entry.summary) {
+            summary = entry.summary;
+        }
+        // Extract version and git branch from any entry that has them
+        if (entry.version && !version) {
+            version = entry.version;
+        }
+        if (entry.gitBranch !== undefined && gitBranch === null) {
+            gitBranch = entry.gitBranch;
+        }
+        if (entry.sessionId && !sessionId) {
+            sessionId = entry.sessionId;
+        }
+        if (entry.agentId && !agentId) {
+            agentId = entry.agentId;
+        }
+        // Track timestamps for user/assistant messages only
+        if (entry.type === 'user' || entry.type === 'assistant') {
+            messageCount++;
+            if (entry.timestamp) {
+                const ts = new Date(entry.timestamp);
+                if (!firstTimestamp || ts < firstTimestamp) {
+                    firstTimestamp = ts;
+                }
+                if (!lastTimestamp || ts > lastTimestamp) {
+                    lastTimestamp = ts;
+                }
+            }
+        }
+    }
+    return {
+        summary,
+        version,
+        gitBranch,
+        sessionId,
+        agentId,
+        firstTimestamp,
+        lastTimestamp,
+        messageCount,
+    };
+}
+/**
+ * Quick parse to extract only session metadata (faster than full parse).
+ * @param filePath - Path to the JSONL session file
+ * @returns Session metadata and warnings
+ */
+export async function parseSessionMetadata(filePath) {
+    const { data: entries, warnings } = await parseJsonlFile(filePath);
+    const metadata = extractMetadata(entries);
+    return { data: metadata, warnings };
+}
+//# sourceMappingURL=parser.js.map