recall-mcp-v3 3.2.0 → 3.2.2

package/dist/__tests__/preprocessor.test.js

@@ -0,0 +1,414 @@
+/**
+ * Preprocessor Unit Tests
+ *
+ * Tests for the JSONL transcript preprocessor that extracts
+ * high-signal content from Claude Code transcripts.
+ */
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { preprocessTranscript } from '../preprocessor.js';
+// Test fixtures directory
+const FIXTURES_DIR = path.join(os.tmpdir(), 'recall-preprocessor-tests');
+// Sample JSONL entries for testing
+const SAMPLE_USER_MESSAGE = {
+    type: 'user',
+    timestamp: '2026-01-28T10:00:00.000Z',
+    uuid: 'user-1',
+    message: { role: 'user', content: 'Fix the authentication bug in the login flow' },
+};
+const SAMPLE_ASSISTANT_WITH_THINKING = {
+    type: 'assistant',
+    timestamp: '2026-01-28T10:00:05.000Z',
+    uuid: 'assistant-1',
+    parentUuid: 'user-1',
+    message: {
+        role: 'assistant',
+        content: [
+            {
+                type: 'thinking',
+                thinking: 'I need to analyze the authentication flow. The bug is likely in the token validation step where we check expiry times.',
+            },
+            {
+                type: 'text',
+                text: 'I found the issue. The token expiry check was using local time instead of UTC.',
+            },
+        ],
+    },
+};
+const SAMPLE_TOOL_USE = {
+    type: 'assistant',
+    timestamp: '2026-01-28T10:00:10.000Z',
+    uuid: 'assistant-2',
+    message: {
+        role: 'assistant',
+        content: [
+            {
+                type: 'tool_use',
+                id: 'tool-1',
+                name: 'Edit',
+                input: {
+                    file_path: '/src/auth/token.ts',
+                    old_string: 'new Date()',
+                    new_string: 'new Date().toISOString()',
+                },
+            },
+        ],
+    },
+};
+const SAMPLE_TOOL_RESULT_SUCCESS = {
+    type: 'user',
+    timestamp: '2026-01-28T10:00:15.000Z',
+    uuid: 'user-2',
+    message: {
+        role: 'user',
+        content: [
+            {
+                type: 'tool_result',
+                tool_use_id: 'tool-1',
+                content: 'File edited successfully',
+            },
+        ],
+    },
+};
+const SAMPLE_TOOL_RESULT_ERROR = {
+    type: 'user',
+    timestamp: '2026-01-28T10:00:20.000Z',
+    uuid: 'user-3',
+    message: {
+        role: 'user',
+        content: [
+            {
+                type: 'tool_result',
+                tool_use_id: 'tool-2',
+                content: 'Error: ENOENT: no such file or directory',
+                is_error: true,
+            },
+        ],
+    },
+};
+const SAMPLE_SYSTEM_MESSAGE = {
+    type: 'system',
+    timestamp: '2026-01-28T10:00:00.000Z',
+    message: { content: 'System initialization complete' },
+};
+const SAMPLE_PROGRESS_MESSAGE = {
+    type: 'progress',
+    timestamp: '2026-01-28T10:00:01.000Z',
+    content: { tool: 'Read', status: 'started' },
+};
+const SAMPLE_FILE_HISTORY = {
+    type: 'file-history-snapshot',
+    timestamp: '2026-01-28T10:00:02.000Z',
+    files: ['/src/auth/token.ts'],
+};
+const SAMPLE_USER_FILLER = {
+    type: 'user',
+    timestamp: '2026-01-28T10:00:25.000Z',
+    uuid: 'user-4',
+    message: { role: 'user', content: 'ok' },
+};
+const SAMPLE_CONCLUSION = {
+    type: 'assistant',
+    timestamp: '2026-01-28T10:01:00.000Z',
+    uuid: 'assistant-5',
+    message: {
+        role: 'assistant',
+        content: [
+            {
+                type: 'text',
+                text: 'In summary, the authentication bug was caused by timezone handling. The fix involved converting all timestamps to UTC before comparison. This resolved the issue where tokens were being incorrectly marked as expired for users in different timezones. The tests now pass and the login flow works correctly.',
+            },
+        ],
+    },
+};
+// Helper to create test JSONL file
+function createTestJsonl(filename, entries) {
+    const filepath = path.join(FIXTURES_DIR, filename);
+    const content = entries.map((e) => JSON.stringify(e)).join('\n');
+    fs.writeFileSync(filepath, content);
+    return filepath;
+}
+describe('preprocessTranscript', () => {
+    beforeAll(() => {
+        // Create fixtures directory
+        if (!fs.existsSync(FIXTURES_DIR)) {
+            fs.mkdirSync(FIXTURES_DIR, { recursive: true });
+        }
+    });
+    afterAll(() => {
+        // Cleanup fixtures
+        if (fs.existsSync(FIXTURES_DIR)) {
+            fs.rmSync(FIXTURES_DIR, { recursive: true });
+        }
+    });
+    it('extracts thinking blocks', async () => {
+        const filepath = createTestJsonl('thinking.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_ASSISTANT_WITH_THINKING,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).toContain('token validation');
+        expect(result.stats.thinkingBlocksIncluded).toBeGreaterThan(0);
+    });
+    it('captures errors from tool_results', async () => {
+        const filepath = createTestJsonl('errors.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_TOOL_RESULT_ERROR,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).toContain('ENOENT');
+        expect(result.stats.errorsFound).toBeGreaterThan(0);
+    });
+    it('logs tool calls with inputs', async () => {
+        // Add a non-code-change tool (Read) to test tool call logging
+        const readToolUse = {
+            type: 'assistant',
+            timestamp: '2026-01-28T10:00:08.000Z',
+            uuid: 'assistant-read',
+            message: {
+                role: 'assistant',
+                content: [
+                    {
+                        type: 'tool_use',
+                        id: 'tool-read',
+                        name: 'Read',
+                        input: { file_path: '/src/config.ts' },
+                    },
+                ],
+            },
+        };
+        const filepath = createTestJsonl('tools.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            readToolUse,
+            SAMPLE_TOOL_USE, // Edit tool - counted as code change
+            SAMPLE_TOOL_RESULT_SUCCESS,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        // Edit should be in code changes section
+        expect(result.content).toContain('Edit');
+        expect(result.content).toContain('token.ts');
+        // Read tool should be logged as a regular tool call
+        expect(result.stats.toolCallsLogged).toBeGreaterThan(0);
+    });
+    it('discards system messages', async () => {
+        const filepath = createTestJsonl('system.jsonl', [
+            SAMPLE_SYSTEM_MESSAGE,
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_ASSISTANT_WITH_THINKING,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).not.toContain('System initialization');
+        // Should still have the user and assistant messages
+        expect(result.stats.messagesExtracted).toBeGreaterThan(0);
+    });
+    it('discards progress events', async () => {
+        const filepath = createTestJsonl('progress.jsonl', [
+            SAMPLE_PROGRESS_MESSAGE,
+            SAMPLE_USER_MESSAGE,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).not.toContain('"status": "started"');
+    });
+    it('discards file-history-snapshot events', async () => {
+        const filepath = createTestJsonl('filehistory.jsonl', [
+            SAMPLE_FILE_HISTORY,
+            SAMPLE_USER_MESSAGE,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).not.toContain('file-history-snapshot');
+    });
+    it('skips user filler messages', async () => {
+        const filepath = createTestJsonl('filler.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_USER_FILLER,
+            SAMPLE_ASSISTANT_WITH_THINKING,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        // The actual user intent should be there
+        expect(result.content).toContain('authentication bug');
+        // But short filler shouldn't be prominently featured
+        // (it may appear but not as a separate "user intent" section)
+    });
+    it('respects maxTokens limit', async () => {
+        // Create a file with lots of content
+        const manyMessages = [];
+        for (let i = 0; i < 100; i++) {
+            manyMessages.push({
+                type: 'user',
+                timestamp: `2026-01-28T10:${String(i).padStart(2, '0')}:00.000Z`,
+                uuid: `user-${i}`,
+                message: { role: 'user', content: `This is a moderately long message number ${i} that adds to the total token count of the processed output.` },
+            });
+            manyMessages.push({
+                type: 'assistant',
+                timestamp: `2026-01-28T10:${String(i).padStart(2, '0')}:05.000Z`,
+                uuid: `assistant-${i}`,
+                message: {
+                    role: 'assistant',
+                    content: [
+                        { type: 'text', text: `Response to message ${i} with some additional content to increase the size.` },
+                    ],
+                },
+            });
+        }
+        const filepath = createTestJsonl('large.jsonl', manyMessages);
+        // Set a low token limit
+        const result = await preprocessTranscript(filepath, { maxTokens: 1000 });
+        // Should be under the limit (1000 tokens * ~4 chars = 4000 chars)
+        expect(result.stats.processedSize).toBeLessThan(5000);
+    });
+    it('handles malformed JSONL gracefully', async () => {
+        const filepath = path.join(FIXTURES_DIR, 'malformed.jsonl');
+        fs.writeFileSync(filepath, `
+${JSON.stringify(SAMPLE_USER_MESSAGE)}
+{invalid json here
+${JSON.stringify(SAMPLE_ASSISTANT_WITH_THINKING)}
+also not json
+${JSON.stringify(SAMPLE_CONCLUSION)}
+`);
+        // Should not throw, should skip invalid lines
+        const result = await preprocessTranscript(filepath);
+        // Should still extract valid messages
+        expect(result.stats.messagesExtracted).toBeGreaterThan(0);
+        expect(result.content).toContain('authentication');
+    });
+    it('captures key conclusions', async () => {
+        const filepath = createTestJsonl('conclusion.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_ASSISTANT_WITH_THINKING,
+            SAMPLE_CONCLUSION,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).toContain('summary');
+        expect(result.content).toContain('timezone');
+    });
+    it('includes YAML header with metadata', async () => {
+        const filepath = createTestJsonl('metadata.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_ASSISTANT_WITH_THINKING,
+            SAMPLE_CONCLUSION,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        // Check for YAML header
+        expect(result.content).toMatch(/^---/);
+        expect(result.content).toContain('start_time:');
+        expect(result.content).toContain('end_time:');
+        expect(result.content).toContain('primary_goal:');
+    });
+    it('returns accurate stats', async () => {
+        const filepath = createTestJsonl('stats.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_ASSISTANT_WITH_THINKING,
+            SAMPLE_TOOL_USE,
+            SAMPLE_TOOL_RESULT_SUCCESS,
+            SAMPLE_TOOL_RESULT_ERROR,
+            SAMPLE_CONCLUSION,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.stats.originalSize).toBeGreaterThan(0);
+        expect(result.stats.processedSize).toBeGreaterThan(0);
+        expect(result.stats.processedSize).toBeLessThan(result.stats.originalSize);
+        expect(result.stats.errorsFound).toBe(1); // One error result
+        expect(result.stats.thinkingBlocksIncluded).toBeGreaterThanOrEqual(1);
+    });
+});
+describe('preprocessTranscript - error detection', () => {
+    beforeAll(() => {
+        if (!fs.existsSync(FIXTURES_DIR)) {
+            fs.mkdirSync(FIXTURES_DIR, { recursive: true });
+        }
+    });
+    afterAll(() => {
+        if (fs.existsSync(FIXTURES_DIR)) {
+            fs.rmSync(FIXTURES_DIR, { recursive: true });
+        }
+    });
+    it('detects errors from is_error flag', async () => {
+        const filepath = createTestJsonl('error-flag.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_TOOL_RESULT_ERROR,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.stats.errorsFound).toBe(1);
+    });
+    it('detects errors from content patterns', async () => {
+        const errorResult = {
+            type: 'user',
+            timestamp: '2026-01-28T10:00:00.000Z',
+            message: {
+                content: [
+                    {
+                        type: 'tool_result',
+                        tool_use_id: 'tool-1',
+                        content: 'Error: failed to compile\nTypeScript error at line 42',
+                    },
+                ],
+            },
+        };
+        const filepath = createTestJsonl('error-pattern.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            errorResult,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.stats.errorsFound).toBeGreaterThan(0);
+    });
+    it('does not flag code snippets mentioning error as errors', async () => {
+        // This tests the false positive prevention
+        const codeResult = {
+            type: 'user',
+            timestamp: '2026-01-28T10:00:00.000Z',
+            message: {
+                content: [
+                    {
+                        type: 'tool_result',
+                        tool_use_id: 'tool-1',
+                        content: `     1→function handleError(error) {
+     2→  console.log(error.message);
+     3→  return { error: null };
+     4→}`,
+                    },
+                ],
+            },
+        };
+        const filepath = createTestJsonl('code-error.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            codeResult,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        // Should NOT count code mentioning "error" as an actual error
+        expect(result.stats.errorsFound).toBe(0);
+    });
+});
+describe('preprocessTranscript - priority extraction', () => {
+    beforeAll(() => {
+        if (!fs.existsSync(FIXTURES_DIR)) {
+            fs.mkdirSync(FIXTURES_DIR, { recursive: true });
+        }
+    });
+    afterAll(() => {
+        if (fs.existsSync(FIXTURES_DIR)) {
+            fs.rmSync(FIXTURES_DIR, { recursive: true });
+        }
+    });
+    it('includes Priority 1 section header', async () => {
+        const filepath = createTestJsonl('p1.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_TOOL_RESULT_ERROR,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).toContain('Priority 1');
+        expect(result.content).toContain('Outcomes');
+    });
+    it('includes Priority 2 section when thinking blocks present', async () => {
+        const filepath = createTestJsonl('p2.jsonl', [
+            SAMPLE_USER_MESSAGE,
+            SAMPLE_ASSISTANT_WITH_THINKING,
+        ]);
+        const result = await preprocessTranscript(filepath);
+        expect(result.content).toContain('Priority 2');
+        expect(result.content).toContain('Reasoning');
+    });
+});
+//# sourceMappingURL=preprocessor.test.js.map

package/dist/__tests__/preprocessor.test.js.map

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

package/dist/cli.d.ts

@@ -4,15 +4,54 @@
  * CLI commands for use from shell hooks (e.g., SessionEnd).
  * This allows Claude Code hooks to trigger Recall saves automatically.
  */
+/**
+ * Find the current session's transcript file.
+ *
+ * Claude Code stores transcripts at:
+ * ~/.claude/projects/<project-hash>/<session-uuid>.jsonl
+ *
+ * The project hash is derived from the absolute path of the project.
+ * Algorithm: Replace all / with - (keeps leading dash)
+ *
+ * Example:
+ *   Path: /Users/ray/projects/recall-v3
+ *   Hash: -Users-ray-projects-recall-v3
+ *
+ * This function walks UP the directory tree to find transcripts, so it works
+ * even when called from a subdirectory (e.g., packages/mcp-v3).
+ *
+ * @param cwd The current working directory (project path)
+ * @returns Path to most recent JSONL file, or null if not found
+ */
+export declare function findCurrentTranscript(cwd: string): string | null;
+/**
+ * Find the most recent transcript GLOBALLY across all projects.
+ * This is a fallback when path-based resolution fails (e.g., when MCP runs as subprocess).
+ *
+ * @returns Object with transcriptPath and projectPath, or null if not found
+ */
+export declare function findMostRecentTranscriptGlobally(): {
+    transcriptPath: string;
+    projectPath: string;
+} | null;
 /**
  * Save a transcript with AI summarization.
  * This is the main entry point for SessionEnd hooks.
+ *
+ * Uses the new preprocessor to extract high-signal content from JSONL,
+ * with fallback to the old parseTranscript() if preprocessing fails.
  */
 export declare function saveTranscript(options: {
     transcriptPath: string;
     cwd: string;
     quiet?: boolean;
-}): Promise<void>;
+}): Promise<{
+    sessionId: string;
+    stats?: {
+        originalSize: number;
+        processedSize: number;
+    };
+}>;
 /**
  * CLI entry point - parses arguments and dispatches to commands.
  */

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0PH;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoHhB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmF1D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiMH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BhE;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,IAAI;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmEzG;AAqID;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CA8L1F;AAWD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG1D"}