claudecode-omc 4.3.4

package/dist/__tests__/agent-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-registry.test.d.ts.map

package/dist/__tests__/agent-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/agent-registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/agent-registry.test.js

@@ -0,0 +1,44 @@
+import { describe, test, expect } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { getAgentDefinitions } from '../agents/definitions.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+describe('Agent Registry Validation', () => {
+    test('agent count matches documentation', () => {
+        const agentsDir = path.join(__dirname, '../../agents');
+        const promptFiles = fs.readdirSync(agentsDir).filter((file) => file.endsWith('.md') && file !== 'AGENTS.md');
+        expect(promptFiles.length).toBe(21);
+    });
+    test('all agents have .md prompt files', () => {
+        const agents = Object.keys(getAgentDefinitions());
+        const agentsDir = path.join(__dirname, '../../agents');
+        const promptFiles = fs.readdirSync(agentsDir).filter((file) => file.endsWith('.md') && file !== 'AGENTS.md');
+        for (const file of promptFiles) {
+            const name = file.replace(/\.md$/, '');
+            expect(agents, `Missing registry entry for agent: ${name}`).toContain(name);
+        }
+    });
+    test('all registry agents are exported from index.ts', async () => {
+        const registryAgents = Object.keys(getAgentDefinitions());
+        const exports = await import('../agents/index.js');
+        const deprecatedAliases = ['researcher', 'tdd-guide'];
+        for (const name of registryAgents) {
+            if (deprecatedAliases.includes(name))
+                continue;
+            const exportName = name.replace(/-([a-z])/g, (_, c) => c.toUpperCase()) + 'Agent';
+            expect(exports[exportName], `Missing export for agent: ${name} (expected ${exportName})`).toBeDefined();
+        }
+    });
+    test('no hardcoded prompts in base agent .ts files', () => {
+        const baseAgents = ['architect', 'executor', 'explore', 'designer', 'document-specialist',
+            'writer', 'planner', 'critic', 'analyst', 'scientist', 'qa-tester'];
+        const agentsDir = path.join(__dirname, '../agents');
+        for (const name of baseAgents) {
+            const content = fs.readFileSync(path.join(agentsDir, `${name}.ts`), 'utf-8');
+            expect(content, `Hardcoded prompt found in ${name}.ts`).not.toMatch(/const\s+\w+_PROMPT\s*=\s*`/);
+        }
+    });
+});
+//# sourceMappingURL=agent-registry.test.js.map

package/dist/__tests__/agent-registry.test.js.map

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

package/dist/__tests__/analytics/backfill-dedup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backfill-dedup.test.d.ts.map

package/dist/__tests__/analytics/backfill-dedup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill-dedup.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/analytics/backfill-dedup.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/analytics/backfill-dedup.test.js

@@ -0,0 +1,179 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+/**
+ * BackfillDedup Test Suite
+ *
+ * Tests for deduplication and backfilling of transcript entries.
+ * This ensures we don't double-count tokens when replaying or reconstructing
+ * transcript data.
+ */
+describe('BackfillDedup', () => {
+    /**
+     * Mock BackfillDedup class for testing deduplication logic
+     */
+    class MockBackfillDedup {
+        processed = new Set();
+        lastBackfillTime;
+        constructor() {
+            this.lastBackfillTime = new Date().toISOString();
+        }
+        markProcessed(entryId) {
+            this.processed.add(entryId);
+            this.lastBackfillTime = new Date().toISOString();
+        }
+        isProcessed(entryId) {
+            return this.processed.has(entryId);
+        }
+        getStats() {
+            return {
+                totalProcessed: this.processed.size,
+                lastBackfillTime: this.lastBackfillTime
+            };
+        }
+        async reset() {
+            this.processed.clear();
+            this.lastBackfillTime = new Date().toISOString();
+        }
+    }
+    let dedup;
+    beforeEach(() => {
+        dedup = new MockBackfillDedup();
+    });
+    describe('initialization', () => {
+        it('should initialize with empty state', () => {
+            const stats = dedup.getStats();
+            expect(stats.totalProcessed).toBe(0);
+            expect(stats.lastBackfillTime).toBeDefined();
+        });
+        it('should have valid ISO timestamp on init', () => {
+            const stats = dedup.getStats();
+            const date = new Date(stats.lastBackfillTime);
+            expect(date).toBeInstanceOf(Date);
+            expect(date.getTime()).toBeGreaterThan(0);
+        });
+    });
+    describe('deduplication', () => {
+        it('should mark entries as processed', () => {
+            const entryId = 'session-1:2024-01-01T00:00:00Z:claude-sonnet-4.6:100:50';
+            expect(dedup.isProcessed(entryId)).toBe(false);
+            dedup.markProcessed(entryId);
+            expect(dedup.isProcessed(entryId)).toBe(true);
+        });
+        it('should track total processed count', () => {
+            dedup.markProcessed('entry-1');
+            expect(dedup.getStats().totalProcessed).toBe(1);
+            dedup.markProcessed('entry-2');
+            expect(dedup.getStats().totalProcessed).toBe(2);
+            dedup.markProcessed('entry-3');
+            expect(dedup.getStats().totalProcessed).toBe(3);
+        });
+        it('should not double-count duplicate marks', () => {
+            const entryId = 'session-1:2024-01-01T00:00:00Z:claude-sonnet-4.6:100:50';
+            dedup.markProcessed(entryId);
+            dedup.markProcessed(entryId); // Duplicate
+            dedup.markProcessed(entryId); // Another duplicate
+            expect(dedup.getStats().totalProcessed).toBe(1);
+        });
+        it('should handle multiple entry IDs with different patterns', () => {
+            const entries = [
+                'session-1:2024-01-01T00:00:00Z:claude-sonnet-4.6:100:50',
+                'session-1:2024-01-01T00:01:00Z:claude-opus-4.6:200:100',
+                'session-2:2024-01-01T00:00:00Z:claude-haiku-4:50:25',
+                'session-3:2024-01-02T00:00:00Z:claude-sonnet-4.6:150:75'
+            ];
+            entries.forEach(id => dedup.markProcessed(id));
+            expect(dedup.getStats().totalProcessed).toBe(4);
+            entries.forEach(id => {
+                expect(dedup.isProcessed(id)).toBe(true);
+            });
+        });
+        it('should distinguish between similar entry IDs', () => {
+            const entry1 = 'session-1:2024-01-01T00:00:00Z:claude-sonnet-4.6:100:50';
+            const entry2 = 'session-1:2024-01-01T00:00:00Z:claude-sonnet-4.6:100:51'; // Different output tokens
+            dedup.markProcessed(entry1);
+            expect(dedup.isProcessed(entry1)).toBe(true);
+            expect(dedup.isProcessed(entry2)).toBe(false);
+        });
+        it('should handle empty entry ID', () => {
+            const emptyId = '';
+            dedup.markProcessed(emptyId);
+            expect(dedup.isProcessed(emptyId)).toBe(true);
+            expect(dedup.getStats().totalProcessed).toBe(1);
+        });
+        it('should handle long entry IDs', () => {
+            const longId = 'a'.repeat(1000);
+            dedup.markProcessed(longId);
+            expect(dedup.isProcessed(longId)).toBe(true);
+        });
+        it('should update last backfill time on each mark', async () => {
+            const time1 = dedup.getStats().lastBackfillTime;
+            // Small delay to ensure time difference
+            await new Promise(resolve => setTimeout(resolve, 10));
+            dedup.markProcessed('entry-1');
+            const time2 = dedup.getStats().lastBackfillTime;
+            // time2 should be >= time1
+            expect(new Date(time2).getTime()).toBeGreaterThanOrEqual(new Date(time1).getTime());
+        });
+    });
+    describe('backfilling scenarios', () => {
+        it('should handle incremental backfills without duplication', () => {
+            // First batch
+            dedup.markProcessed('session-1:2024-01-01T00:00:00Z:model1:100:50');
+            dedup.markProcessed('session-1:2024-01-01T00:01:00Z:model1:200:100');
+            expect(dedup.getStats().totalProcessed).toBe(2);
+            // Second batch (replay + new)
+            dedup.markProcessed('session-1:2024-01-01T00:00:00Z:model1:100:50'); // Replay
+            dedup.markProcessed('session-1:2024-01-01T00:01:00Z:model1:200:100'); // Replay
+            dedup.markProcessed('session-1:2024-01-01T00:02:00Z:model1:300:150'); // New
+            expect(dedup.getStats().totalProcessed).toBe(3); // Not 5
+        });
+        it('should support out-of-order processing', () => {
+            const entries = [
+                'session-1:2024-01-01T00:05:00Z:model1:100:50',
+                'session-1:2024-01-01T00:02:00Z:model1:200:100',
+                'session-1:2024-01-01T00:01:00Z:model1:300:150'
+            ];
+            entries.forEach(id => dedup.markProcessed(id));
+            expect(dedup.getStats().totalProcessed).toBe(3);
+            entries.forEach(id => {
+                expect(dedup.isProcessed(id)).toBe(true);
+            });
+        });
+        it('should handle high-volume dedup', () => {
+            // Simulate processing 10,000 entries with some duplicates
+            for (let i = 0; i < 10000; i++) {
+                const sessionId = `session-${i % 50}`;
+                const timestamp = new Date(Date.now() - (i * 1000)).toISOString();
+                const model = ['claude-sonnet-4.6', 'claude-haiku-4', 'claude-opus-4.6'][i % 3];
+                const tokens = (i % 1000) + 100;
+                const entryId = `${sessionId}:${timestamp}:${model}:${tokens}:${tokens / 2}`;
+                dedup.markProcessed(entryId);
+            }
+            const stats = dedup.getStats();
+            expect(stats.totalProcessed).toBeGreaterThan(0);
+            // With 50 sessions, 3 models, and varying timestamps, we should have many unique entries
+            expect(stats.totalProcessed).toBeLessThanOrEqual(10000);
+        });
+    });
+    describe('reset', () => {
+        it('should reset state correctly', async () => {
+            dedup.markProcessed('entry-1');
+            dedup.markProcessed('entry-2');
+            dedup.markProcessed('entry-3');
+            expect(dedup.getStats().totalProcessed).toBe(3);
+            await dedup.reset();
+            expect(dedup.getStats().totalProcessed).toBe(0);
+            expect(dedup.isProcessed('entry-1')).toBe(false);
+            expect(dedup.isProcessed('entry-2')).toBe(false);
+            expect(dedup.isProcessed('entry-3')).toBe(false);
+        });
+        it('should allow re-processing after reset', async () => {
+            dedup.markProcessed('entry-1');
+            expect(dedup.getStats().totalProcessed).toBe(1);
+            await dedup.reset();
+            expect(dedup.getStats().totalProcessed).toBe(0);
+            dedup.markProcessed('entry-1');
+            expect(dedup.getStats().totalProcessed).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=backfill-dedup.test.js.map

package/dist/__tests__/analytics/backfill-dedup.test.js.map

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

package/dist/__tests__/analytics/backfill-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backfill-engine.test.d.ts.map

package/dist/__tests__/analytics/backfill-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill-engine.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/analytics/backfill-engine.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/analytics/backfill-engine.test.js

@@ -0,0 +1,362 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * BackfillEngine Integration Tests
+ *
+ * Tests the complete backfill workflow:
+ * 1. Reading transcripts from multiple sessions
+ * 2. Extracting token usage data
+ * 3. Deduplicating entries
+ * 4. Updating analytics summaries
+ * 5. Handling errors gracefully
+ */
+describe('BackfillEngine Integration', () => {
+    const testDir = '.test-backfill-engine';
+    const transcriptDir = path.join(testDir, 'transcripts');
+    const stateDir = path.join(testDir, '.omc/state');
+    // Mock BackfillEngine for integration testing
+    class MockBackfillEngine {
+        processedFiles = new Set();
+        totalTokensProcessed = 0;
+        sessionsProcessed = new Set();
+        async backfill() {
+            const errors = [];
+            try {
+                // Read transcript files
+                const files = await fs.readdir(transcriptDir).catch(() => []);
+                for (const file of files) {
+                    if (!file.endsWith('.jsonl'))
+                        continue;
+                    try {
+                        const filePath = path.join(transcriptDir, file);
+                        const content = await fs.readFile(filePath, 'utf-8');
+                        const lines = content.split('\n').filter(line => line.trim());
+                        // Extract session IDs and process
+                        for (const line of lines) {
+                            try {
+                                const entry = JSON.parse(line);
+                                if (entry.sessionId) {
+                                    this.sessionsProcessed.add(entry.sessionId);
+                                    this.totalTokensProcessed += (entry.message?.usage?.input_tokens || 0);
+                                }
+                            }
+                            catch {
+                                // Skip malformed lines
+                            }
+                        }
+                        this.processedFiles.add(file);
+                    }
+                    catch (error) {
+                        errors.push({
+                            file,
+                            error: error instanceof Error ? error.message : String(error)
+                        });
+                    }
+                }
+                return {
+                    filesProcessed: this.processedFiles.size,
+                    totalTokensExtracted: this.totalTokensProcessed,
+                    duplicatesRemoved: 0,
+                    sessionsUpdated: this.sessionsProcessed.size,
+                    errors
+                };
+            }
+            catch (error) {
+                return {
+                    filesProcessed: 0,
+                    totalTokensExtracted: 0,
+                    duplicatesRemoved: 0,
+                    sessionsUpdated: 0,
+                    errors: [{
+                            file: 'general',
+                            error: error instanceof Error ? error.message : String(error)
+                        }]
+                };
+            }
+        }
+        getStats() {
+            return {
+                filesProcessed: this.processedFiles.size,
+                sessionsProcessed: this.sessionsProcessed.size,
+                totalTokens: this.totalTokensProcessed
+            };
+        }
+    }
+    beforeEach(async () => {
+        // Create test directories
+        await fs.mkdir(transcriptDir, { recursive: true });
+        await fs.mkdir(stateDir, { recursive: true });
+    });
+    afterEach(async () => {
+        // Clean up test directory
+        try {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    describe('basic backfill workflow', () => {
+        it('should process single transcript file', async () => {
+            const engine = new MockBackfillEngine();
+            // Create test transcript
+            const transcript = [
+                JSON.stringify({
+                    type: 'assistant',
+                    sessionId: 'session-1',
+                    timestamp: '2026-01-24T01:00:00.000Z',
+                    message: {
+                        model: 'claude-sonnet-4-6-20260217',
+                        role: 'assistant',
+                        usage: {
+                            input_tokens: 100,
+                            output_tokens: 50,
+                            cache_creation_input_tokens: 0,
+                            cache_read_input_tokens: 0
+                        }
+                    }
+                })
+            ].join('\n');
+            await fs.writeFile(path.join(transcriptDir, 'session-1.jsonl'), transcript);
+            const result = await engine.backfill();
+            expect(result.filesProcessed).toBe(1);
+            expect(result.sessionsUpdated).toBe(1);
+            expect(result.totalTokensExtracted).toBe(100);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should process multiple transcript files', async () => {
+            const engine = new MockBackfillEngine();
+            // Create multiple transcripts
+            const sessions = [
+                { id: 'session-1', tokens: 100 },
+                { id: 'session-2', tokens: 200 },
+                { id: 'session-3', tokens: 150 }
+            ];
+            for (const session of sessions) {
+                const transcript = JSON.stringify({
+                    type: 'assistant',
+                    sessionId: session.id,
+                    timestamp: '2026-01-24T01:00:00.000Z',
+                    message: {
+                        model: 'claude-sonnet-4-6-20260217',
+                        role: 'assistant',
+                        usage: {
+                            input_tokens: session.tokens,
+                            output_tokens: session.tokens / 2,
+                            cache_creation_input_tokens: 0,
+                            cache_read_input_tokens: 0
+                        }
+                    }
+                });
+                await fs.writeFile(path.join(transcriptDir, `${session.id}.jsonl`), transcript);
+            }
+            const result = await engine.backfill();
+            expect(result.filesProcessed).toBe(3);
+            expect(result.sessionsUpdated).toBe(3);
+            expect(result.totalTokensExtracted).toBe(450); // 100 + 200 + 150
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should handle JSONL with multiple entries per session', async () => {
+            const engine = new MockBackfillEngine();
+            // Create transcript with multiple entries
+            const entries = [
+                {
+                    type: 'assistant',
+                    sessionId: 'session-1',
+                    timestamp: '2026-01-24T01:00:00.000Z',
+                    message: {
+                        usage: { input_tokens: 100, output_tokens: 50, cache_creation_input_tokens: 0, cache_read_input_tokens: 0 }
+                    }
+                },
+                {
+                    type: 'assistant',
+                    sessionId: 'session-1',
+                    timestamp: '2026-01-24T01:01:00.000Z',
+                    message: {
+                        usage: { input_tokens: 150, output_tokens: 75, cache_creation_input_tokens: 0, cache_read_input_tokens: 0 }
+                    }
+                },
+                {
+                    type: 'assistant',
+                    sessionId: 'session-1',
+                    timestamp: '2026-01-24T01:02:00.000Z',
+                    message: {
+                        usage: { input_tokens: 200, output_tokens: 100, cache_creation_input_tokens: 0, cache_read_input_tokens: 0 }
+                    }
+                }
+            ];
+            const jsonl = entries.map(e => JSON.stringify(e)).join('\n');
+            await fs.writeFile(path.join(transcriptDir, 'session-1.jsonl'), jsonl);
+            const result = await engine.backfill();
+            expect(result.filesProcessed).toBe(1);
+            expect(result.sessionsUpdated).toBe(1);
+            expect(result.totalTokensExtracted).toBe(450); // 100 + 150 + 200
+        });
+    });
+    describe('error handling', () => {
+        it('should skip malformed JSONL lines', async () => {
+            const engine = new MockBackfillEngine();
+            const content = [
+                JSON.stringify({
+                    type: 'assistant',
+                    sessionId: 'session-1',
+                    message: { usage: { input_tokens: 100 } }
+                }),
+                'this is not valid json',
+                JSON.stringify({
+                    type: 'assistant',
+                    sessionId: 'session-1',
+                    message: { usage: { input_tokens: 200 } }
+                })
+            ].join('\n');
+            await fs.writeFile(path.join(transcriptDir, 'session-1.jsonl'), content);
+            const result = await engine.backfill();
+            // Should process valid entries and skip malformed ones
+            expect(result.filesProcessed).toBe(1);
+            expect(result.totalTokensExtracted).toBe(300); // Only valid entries counted
+        });
+        it('should handle missing transcript directory gracefully', async () => {
+            const engine = new MockBackfillEngine();
+            // Don't create transcript dir, just run backfill
+            await fs.rm(transcriptDir, { recursive: true, force: true });
+            const result = await engine.backfill();
+            // Should handle gracefully
+            expect(result.filesProcessed).toBe(0);
+            expect(result.sessionsUpdated).toBe(0);
+        });
+        it('should skip non-JSONL files', async () => {
+            const engine = new MockBackfillEngine();
+            // Create various file types
+            await fs.writeFile(path.join(transcriptDir, 'readme.md'), '# Readme');
+            await fs.writeFile(path.join(transcriptDir, 'data.json'), '{"test": true}');
+            // Valid JSONL file
+            const valid = JSON.stringify({
+                type: 'assistant',
+                sessionId: 'session-1',
+                message: { usage: { input_tokens: 100 } }
+            });
+            await fs.writeFile(path.join(transcriptDir, 'session-1.jsonl'), valid);
+            const result = await engine.backfill();
+            expect(result.filesProcessed).toBe(1); // Only JSONL
+            expect(result.totalTokensExtracted).toBe(100);
+        });
+    });
+    describe('statistics tracking', () => {
+        it('should track sessions correctly', async () => {
+            const engine = new MockBackfillEngine();
+            const entries = [
+                { sessionId: 'session-1', tokens: 100 },
+                { sessionId: 'session-1', tokens: 200 }, // Same session
+                { sessionId: 'session-2', tokens: 150 },
+                { sessionId: 'session-3', tokens: 75 }
+            ];
+            const jsonl = entries
+                .map(e => JSON.stringify({
+                type: 'assistant',
+                sessionId: e.sessionId,
+                message: { usage: { input_tokens: e.tokens } }
+            }))
+                .join('\n');
+            await fs.writeFile(path.join(transcriptDir, 'batch.jsonl'), jsonl);
+            const result = await engine.backfill();
+            // Should identify 3 unique sessions
+            expect(result.sessionsUpdated).toBe(3);
+            // Total tokens should be sum of all entries
+            expect(result.totalTokensExtracted).toBe(525); // 100 + 200 + 150 + 75
+        });
+        it('should accumulate stats across multiple backfill runs', async () => {
+            const engine = new MockBackfillEngine();
+            // First batch
+            const batch1 = JSON.stringify({
+                type: 'assistant',
+                sessionId: 'session-1',
+                message: { usage: { input_tokens: 100 } }
+            });
+            await fs.writeFile(path.join(transcriptDir, 'batch1.jsonl'), batch1);
+            await engine.backfill();
+            let stats = engine.getStats();
+            expect(stats.totalTokens).toBe(100);
+            // Second batch
+            const batch2 = JSON.stringify({
+                type: 'assistant',
+                sessionId: 'session-2',
+                message: { usage: { input_tokens: 200 } }
+            });
+            await fs.writeFile(path.join(transcriptDir, 'batch2.jsonl'), batch2);
+            await engine.backfill();
+            stats = engine.getStats();
+            // Tokens from both batches should be counted (100 from batch1 + 200 from batch2)
+            expect(stats.totalTokens).toBe(400); // Both batches are re-processed on second run
+        });
+    });
+    describe('cache handling', () => {
+        it('should extract cache metrics', async () => {
+            const engine = new MockBackfillEngine();
+            const entry = JSON.stringify({
+                type: 'assistant',
+                sessionId: 'session-1',
+                message: {
+                    usage: {
+                        input_tokens: 1000,
+                        output_tokens: 400,
+                        cache_creation_input_tokens: 500,
+                        cache_read_input_tokens: 2000
+                    }
+                }
+            });
+            await fs.writeFile(path.join(transcriptDir, 'session-1.jsonl'), entry);
+            const result = await engine.backfill();
+            expect(result.filesProcessed).toBe(1);
+            expect(result.totalTokensExtracted).toBe(1000);
+        });
+        it('should handle missing cache fields', async () => {
+            const engine = new MockBackfillEngine();
+            // Entry without cache fields
+            const entry = JSON.stringify({
+                type: 'assistant',
+                sessionId: 'session-1',
+                message: {
+                    usage: {
+                        input_tokens: 100
+                        // cache fields omitted
+                    }
+                }
+            });
+            await fs.writeFile(path.join(transcriptDir, 'session-1.jsonl'), entry);
+            const result = await engine.backfill();
+            expect(result.filesProcessed).toBe(1);
+            expect(result.totalTokensExtracted).toBe(100);
+        });
+    });
+    describe('performance', () => {
+        it('should handle large transcript files', async () => {
+            const engine = new MockBackfillEngine();
+            // Generate 1000 entries
+            const entries = Array(1000).fill(null).map((_, i) => ({
+                type: 'assistant',
+                sessionId: `session-${i % 10}`,
+                timestamp: new Date(Date.now() - i * 1000).toISOString(),
+                message: {
+                    usage: {
+                        input_tokens: (i % 500) + 100,
+                        output_tokens: (i % 200) + 50,
+                        cache_creation_input_tokens: i % 100,
+                        cache_read_input_tokens: i % 200
+                    }
+                }
+            }));
+            const jsonl = entries.map(e => JSON.stringify(e)).join('\n');
+            await fs.writeFile(path.join(transcriptDir, 'large.jsonl'), jsonl);
+            const startTime = Date.now();
+            const result = await engine.backfill();
+            const duration = Date.now() - startTime;
+            expect(result.filesProcessed).toBe(1);
+            expect(result.sessionsUpdated).toBe(10);
+            expect(result.totalTokensExtracted).toBeGreaterThan(0);
+            // Backfill should complete in reasonable time
+            expect(duration).toBeLessThan(5000); // 5 seconds max
+        });
+    });
+});
+//# sourceMappingURL=backfill-engine.test.js.map