@vybestack/llxprt-code 0.1.20 → 0.1.22

package/dist/src/storage/ConversationStorage.test.js

@@ -0,0 +1,379 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as path from 'path';
+import { ContentGeneratorRole } from '@vybestack/llxprt-code-core';
+// Mock implementation for behavioral testing
+class MockConversationStorage {
+    config;
+    currentLogFile;
+    currentLogSize = 0;
+    logFiles = new Map();
+    logEntries = [];
+    constructor(config) {
+        this.config = config;
+        this.currentLogFile = path.join(config.logPath, 'conversations.log');
+    }
+    async writeConversationEntry(entry) {
+        await this.ensureLogDirectory();
+        const entrySize = JSON.stringify(entry).length;
+        // Check if rotation is needed before writing
+        if (this.currentLogSize + entrySize >
+            this.config.maxLogSizeMB * 1024 * 1024) {
+            await this.rotateLogIfNeeded();
+        }
+        // Write entry (simulated)
+        this.logEntries.push(entry);
+        this.currentLogSize += entrySize;
+        // Update file metadata
+        const now = new Date();
+        const currentFile = this.getCurrentLogPath();
+        if (!this.logFiles.has(currentFile)) {
+            this.logFiles.set(currentFile, {
+                size: 0,
+                created: now,
+                lastModified: now,
+            });
+        }
+        const fileInfo = this.logFiles.get(currentFile);
+        fileInfo.size = this.currentLogSize;
+        fileInfo.lastModified = now;
+    }
+    async rotateLogIfNeeded() {
+        // Always rotate when called (since we already checked the condition)
+        // Generate new log file name with timestamp
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const newLogFile = path.join(this.config.logPath, `conversations-${timestamp}.log`);
+        // Archive current log
+        const currentFile = this.getCurrentLogPath();
+        const fileInfo = this.logFiles.get(currentFile);
+        if (fileInfo) {
+            this.logFiles.set(newLogFile, { ...fileInfo });
+        }
+        // Create new current log
+        this.currentLogFile = path.join(this.config.logPath, 'conversations.log');
+        this.currentLogSize = 0;
+        // Remove excess log files if needed
+        await this.enforceMaxLogFiles();
+    }
+    async enforceMaxLogFiles() {
+        const files = await this.getLogFiles();
+        if (files.length > this.config.maxLogFiles) {
+            // Sort by creation date, keep newest files
+            const sortedFiles = files.sort((a, b) => b.created.getTime() - a.created.getTime());
+            const filesToDelete = sortedFiles.slice(this.config.maxLogFiles);
+            for (const file of filesToDelete) {
+                this.logFiles.delete(file.path);
+            }
+        }
+    }
+    async cleanupOldLogs() {
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - this.config.retentionDays);
+        const files = await this.getLogFiles();
+        for (const file of files) {
+            if (file.created < cutoffDate) {
+                this.logFiles.delete(file.path);
+            }
+        }
+    }
+    async getLogFiles() {
+        return Array.from(this.logFiles.entries()).map(([filePath, info]) => ({
+            path: filePath,
+            size: info.size,
+            created: info.created,
+            lastModified: info.lastModified,
+        }));
+    }
+    async getCurrentLogSize() {
+        return this.currentLogSize;
+    }
+    getCurrentLogPath() {
+        return this.currentLogFile;
+    }
+    async ensureLogDirectory() {
+        // Simulate directory creation
+        // In real implementation, would create directories recursively
+    }
+    async createLogFileWithDate(filename, date) {
+        const filePath = path.join(this.config.logPath, filename);
+        this.logFiles.set(filePath, {
+            size: 1024, // Simulate some content
+            created: date,
+            lastModified: date,
+        });
+    }
+}
+// Test helper functions
+function createLargeConversationEntry(sizeBytes) {
+    const largeContent = 'x'.repeat(Math.max(sizeBytes - 200, 0)); // Reserve space for JSON overhead
+    return {
+        timestamp: new Date().toISOString(),
+        conversation_id: 'conv_123',
+        provider_name: 'openai',
+        messages: [{ role: ContentGeneratorRole.USER, content: largeContent }],
+    };
+}
+function createTypicalConversationEntry() {
+    return {
+        timestamp: new Date().toISOString(),
+        conversation_id: 'conv_456',
+        provider_name: 'anthropic',
+        messages: [
+            {
+                role: ContentGeneratorRole.USER,
+                content: 'Hello, how can you help me?',
+            },
+            {
+                role: ContentGeneratorRole.ASSISTANT,
+                content: 'I can help you with various tasks...',
+            },
+        ],
+        session_id: 'session_789',
+    };
+}
+describe('Conversation Log Storage Management', () => {
+    let storage;
+    let testLogPath;
+    beforeEach(() => {
+        testLogPath = '/tmp/test-logs-' + Date.now();
+        storage = new MockConversationStorage({
+            logPath: testLogPath,
+            maxLogSizeMB: 1,
+            maxLogFiles: 3,
+            retentionDays: 7,
+        });
+    });
+    afterEach(() => {
+        // Cleanup would happen here in real implementation
+    });
+    /**
+     * @requirement STORAGE-001: Log file rotation
+     * @scenario Log file exceeds maximum size
+     * @given ConversationStorage with maxLogSizeMB: 1
+     * @when writeConversationEntry() is called with large entry
+     * @then New log file is created and old file is rotated
+     * @and Total log files does not exceed maxLogFiles
+     */
+    it('should rotate log files when size limit is exceeded', async () => {
+        // First, add a medium-sized entry to partially fill the log
+        const mediumEntry = createLargeConversationEntry(600 * 1024); // 600KB
+        await storage.writeConversationEntry(mediumEntry);
+        expect(await storage.getCurrentLogSize()).toBeLessThan(1024 * 1024);
+        // Now add another entry that would exceed the 1MB limit (600KB + 600KB > 1MB)
+        const anotherEntry = createLargeConversationEntry(600 * 1024); // 600KB
+        await storage.writeConversationEntry(anotherEntry);
+        // After rotation, we should have multiple log files and the current size should be just the new entry
+        const logFiles = await storage.getLogFiles();
+        expect(logFiles.length).toBeGreaterThan(1); // Rotation should have occurred
+        expect(logFiles.length).toBeLessThanOrEqual(3);
+        expect(await storage.getCurrentLogSize()).toBeLessThan(1024 * 1024); // Current file should have just the new entry
+    });
+    /**
+     * @requirement STORAGE-002: Retention policy
+     * @scenario Old log files exceed retention period
+     * @given Log files older than retentionDays
+     * @when cleanupOldLogs() is called
+     * @then Files older than retention period are deleted
+     */
+    it('should clean up log files beyond retention period', async () => {
+        const oldDate = new Date(Date.now() - 10 * 24 * 60 * 60 * 1000); // 10 days ago
+        await storage.createLogFileWithDate('old-conversation.log', oldDate);
+        // Add a recent file to ensure we don't delete everything
+        const recentDate = new Date(Date.now() - 1 * 24 * 60 * 60 * 1000); // 1 day ago
+        await storage.createLogFileWithDate('recent-conversation.log', recentDate);
+        await storage.cleanupOldLogs();
+        const remainingFiles = await storage.getLogFiles();
+        expect(remainingFiles.some((f) => f.path.includes('old-conversation'))).toBe(false);
+        expect(remainingFiles.some((f) => f.path.includes('recent-conversation'))).toBe(true);
+    });
+    /**
+     * @requirement STORAGE-003: Multiple small entries
+     * @scenario Multiple small conversation entries within size limit
+     * @given ConversationStorage with sufficient capacity
+     * @when multiple writeConversationEntry() calls are made
+     * @then All entries are written to same log file
+     * @and No rotation occurs
+     */
+    it('should handle multiple small conversation entries without rotation', async () => {
+        const entries = [
+            createTypicalConversationEntry(),
+            createTypicalConversationEntry(),
+            createTypicalConversationEntry(),
+        ];
+        for (const entry of entries) {
+            await storage.writeConversationEntry(entry);
+        }
+        const logFiles = await storage.getLogFiles();
+        expect(logFiles.length).toBe(1); // All in one file
+        expect(await storage.getCurrentLogSize()).toBeLessThan(1024 * 1024); // Under 1MB limit
+    });
+    /**
+     * @requirement STORAGE-004: Concurrent write handling
+     * @scenario Multiple simultaneous write operations
+     * @given ConversationStorage with concurrent write operations
+     * @when multiple writeConversationEntry() calls are made simultaneously
+     * @then All entries are written successfully
+     * @and File rotation is handled correctly
+     */
+    it('should handle concurrent conversation entry writes', async () => {
+        const entries = Array.from({ length: 5 }, () => createTypicalConversationEntry());
+        // Write all entries concurrently
+        await Promise.all(entries.map((entry) => storage.writeConversationEntry(entry)));
+        const logFiles = await storage.getLogFiles();
+        expect(logFiles.length).toBeGreaterThan(0);
+        // Verify total size is reasonable
+        const totalSize = logFiles.reduce((sum, file) => sum + file.size, 0);
+        expect(totalSize).toBeGreaterThan(0);
+    });
+    /**
+     * @requirement STORAGE-005: Log directory creation
+     * @scenario Log directory does not exist
+     * @given ConversationStorage with non-existent log directory
+     * @when writeConversationEntry() is called
+     * @then Log directory is created automatically
+     * @and Entry is written successfully
+     */
+    it('should create log directory if it does not exist', async () => {
+        const nonExistentPath = '/tmp/non-existent-' + Date.now();
+        const storageWithNewPath = new MockConversationStorage({
+            logPath: nonExistentPath,
+            maxLogSizeMB: 1,
+            maxLogFiles: 3,
+            retentionDays: 7,
+        });
+        const entry = createTypicalConversationEntry();
+        // Should not throw error even if directory doesn't exist
+        await expect(storageWithNewPath.writeConversationEntry(entry)).resolves.not.toThrow();
+        expect(await storageWithNewPath.getCurrentLogSize()).toBeGreaterThan(0);
+    });
+    /**
+     * @requirement STORAGE-006: Max log files enforcement
+     * @scenario More log files than maxLogFiles limit
+     * @given ConversationStorage with maxLogFiles: 3
+     * @when rotation creates more than 3 log files
+     * @then Oldest log files are deleted to maintain limit
+     */
+    it('should enforce maximum log files limit', async () => {
+        // Create multiple large entries to force multiple rotations
+        for (let i = 0; i < 5; i++) {
+            const largeEntry = createLargeConversationEntry(1.5 * 1024 * 1024); // 1.5MB each
+            await storage.writeConversationEntry(largeEntry);
+            // Small delay to ensure different timestamps
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+        const logFiles = await storage.getLogFiles();
+        expect(logFiles.length).toBeLessThanOrEqual(3);
+    });
+    /**
+     * @requirement STORAGE-007: Log file metadata tracking
+     * @scenario Log file information retrieval
+     * @given ConversationStorage with written log files
+     * @when getLogFiles() is called
+     * @then Returns accurate file metadata including size and dates
+     */
+    it('should track accurate log file metadata', async () => {
+        const entry1 = createTypicalConversationEntry();
+        await storage.writeConversationEntry(entry1);
+        // Force rotation with large entry
+        const largeEntry = createLargeConversationEntry(2 * 1024 * 1024);
+        await storage.writeConversationEntry(largeEntry);
+        const logFiles = await storage.getLogFiles();
+        for (const file of logFiles) {
+            expect(file.path).toBeTruthy();
+            expect(file.size).toBeGreaterThan(0);
+            expect(file.created).toBeInstanceOf(Date);
+            expect(file.lastModified).toBeInstanceOf(Date);
+            expect(file.lastModified.getTime()).toBeGreaterThanOrEqual(file.created.getTime());
+        }
+    });
+    /**
+     * @requirement STORAGE-008: Storage error handling
+     * @scenario Storage operation failures
+     * @given ConversationStorage with simulated write errors
+     * @when writeConversationEntry() encounters errors
+     * @then Errors are handled gracefully without corrupting state
+     */
+    it('should handle storage errors gracefully', async () => {
+        // Create a storage instance that will simulate errors
+        const errorProneStorage = new MockConversationStorage({
+            logPath: '/invalid/path/that/cannot/be/created',
+            maxLogSizeMB: 1,
+            maxLogFiles: 3,
+            retentionDays: 7,
+        });
+        // In real implementation, this would test actual filesystem errors
+        // For now, we verify the storage instance handles the invalid path gracefully
+        await expect(errorProneStorage.ensureLogDirectory()).resolves.not.toThrow();
+    });
+    /**
+     * @requirement STORAGE-009: Log rotation timing
+     * @scenario Rotation happens at correct size threshold
+     * @given ConversationStorage with 1MB limit
+     * @when entries are written approaching the limit
+     * @then Rotation occurs at or before limit is exceeded
+     */
+    it('should rotate logs at correct size threshold', async () => {
+        const mediumEntry = createLargeConversationEntry(600 * 1024); // 600KB
+        // Write first entry (should not rotate)
+        await storage.writeConversationEntry(mediumEntry);
+        expect(await storage.getCurrentLogSize()).toBeLessThan(1024 * 1024);
+        // Write second entry (should trigger rotation due to combined size > 1MB)
+        await storage.writeConversationEntry(mediumEntry);
+        expect(await storage.getCurrentLogSize()).toBeLessThan(1024 * 1024); // New file should be smaller
+        const logFiles = await storage.getLogFiles();
+        expect(logFiles.length).toBeGreaterThan(1); // Rotation should have occurred
+    });
+    /**
+     * @requirement STORAGE-010: Empty entry handling
+     * @scenario Conversation entry with minimal content
+     * @given ConversationStorage with empty or minimal entries
+     * @when writeConversationEntry() is called with empty messages
+     * @then Entry is handled correctly without errors
+     */
+    it('should handle empty or minimal conversation entries', async () => {
+        const emptyEntry = {
+            timestamp: new Date().toISOString(),
+            conversation_id: 'empty_conv',
+            provider_name: 'test',
+            messages: [],
+        };
+        const minimalEntry = {
+            timestamp: new Date().toISOString(),
+            conversation_id: 'minimal_conv',
+            provider_name: 'test',
+            messages: [{ role: ContentGeneratorRole.USER, content: '' }],
+        };
+        await expect(storage.writeConversationEntry(emptyEntry)).resolves.not.toThrow();
+        await expect(storage.writeConversationEntry(minimalEntry)).resolves.not.toThrow();
+        expect(await storage.getCurrentLogSize()).toBeGreaterThan(0);
+    });
+    /**
+     * @requirement STORAGE-011: Retention cleanup precision
+     * @scenario Files created exactly at retention boundary
+     * @given Log files created exactly retentionDays ago
+     * @when cleanupOldLogs() is called
+     * @then Boundary cases are handled correctly (files exactly at limit are kept/deleted consistently)
+     */
+    it('should handle retention boundary cases correctly', async () => {
+        const exactBoundaryDate = new Date();
+        exactBoundaryDate.setDate(exactBoundaryDate.getDate() - 7); // Exactly 7 days ago
+        const justInsideBoundaryDate = new Date();
+        justInsideBoundaryDate.setDate(justInsideBoundaryDate.getDate() - 6); // 6 days ago
+        const justOutsideBoundaryDate = new Date();
+        justOutsideBoundaryDate.setDate(justOutsideBoundaryDate.getDate() - 8); // 8 days ago
+        await storage.createLogFileWithDate('exact-boundary.log', exactBoundaryDate);
+        await storage.createLogFileWithDate('just-inside.log', justInsideBoundaryDate);
+        await storage.createLogFileWithDate('just-outside.log', justOutsideBoundaryDate);
+        await storage.cleanupOldLogs();
+        const remainingFiles = await storage.getLogFiles();
+        const filenames = remainingFiles.map((f) => path.basename(f.path));
+        expect(filenames).toContain('just-inside.log'); // 6 days ago should remain
+        expect(filenames).not.toContain('just-outside.log'); // 8 days ago should be deleted
+        // Boundary case (exactly 7 days) behavior should be consistent
+    });
+});
+//# sourceMappingURL=ConversationStorage.test.js.map

package/dist/src/storage/ConversationStorage.test.js.map

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

package/dist/src/test-utils/customMatchers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+declare module 'vitest' {
+    interface Assertion<T> {
+        toHaveOnlyValidCharacters(): T;
+    }
+    interface AsymmetricMatchersContaining {
+        toHaveOnlyValidCharacters(): void;
+    }
+}
+export {};

package/dist/src/test-utils/customMatchers.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/// <reference types="vitest/globals" />
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { expect } from 'vitest';
+// RegExp to detect invalid characters: backspace, and ANSI escape codes
+// eslint-disable-next-line no-control-regex
+const invalidCharsRegex = /[\b\x1b]/;
+function toHaveOnlyValidCharacters(buffer) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const { isNot } = this;
+    let pass = true;
+    const invalidLines = [];
+    for (let i = 0; i < buffer.lines.length; i++) {
+        const line = buffer.lines[i];
+        if (line.includes('\n')) {
+            pass = false;
+            invalidLines.push({ line: i, content: line });
+            break; // Fail fast on newlines
+        }
+        if (invalidCharsRegex.test(line)) {
+            pass = false;
+            invalidLines.push({ line: i, content: line });
+        }
+    }
+    return {
+        pass,
+        message: () => `Expected buffer ${isNot ? 'not ' : ''}to have only valid characters, but found invalid characters in lines:\n${invalidLines
+            .map((l) => `  [${l.line}]: "${l.content}"`) /* This line was changed */
+            .join('\n')}`,
+        actual: buffer.lines,
+        expected: 'Lines with no line breaks, backspaces, or escape codes.',
+    };
+}
+expect.extend({
+    toHaveOnlyValidCharacters,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+});
+//# sourceMappingURL=customMatchers.js.map

package/dist/src/test-utils/customMatchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customMatchers.js","sourceRoot":"","sources":["../../../src/test-utils/customMatchers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wCAAwC;AAExC;;;;GAIG;AAEH,OAAO,EAAa,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG3C,wEAAwE;AACxE,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAErC,SAAS,yBAAyB,CAAkB,MAAkB;IACpE,8DAA8D;IAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAW,CAAC;IAC9B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,MAAM,YAAY,GAA6C,EAAE,CAAC;IAElE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,GAAG,KAAK,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,CAAC,wBAAwB;QACjC,CAAC;QACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,IAAI,GAAG,KAAK,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,GAAG,EAAE,CACZ,mBAAmB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,0EAA0E,YAAY;aACzH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,2BAA2B;aACvE,IAAI,CAAC,IAAI,CAAC,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC,KAAK;QACpB,QAAQ,EAAE,yDAAyD;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,CAAC;IACZ,yBAAyB;IACzB,8DAA8D;CACxD,CAAC,CAAC"}

package/dist/src/test-utils/mockCommandContext.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommandContext } from '../ui/commands/types.js';
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/**
+ * Creates a deep, fully-typed mock of the CommandContext for use in tests.
+ * All functions are pre-mocked with `vi.fn()`.
+ *
+ * @param overrides - A deep partial object to override any default mock values.
+ * @returns A complete, mocked CommandContext object.
+ */
+export declare const createMockCommandContext: (overrides?: DeepPartial<CommandContext>) => CommandContext;
+export {};

package/dist/src/test-utils/mockCommandContext.js

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+/**
+ * Creates a deep, fully-typed mock of the CommandContext for use in tests.
+ * All functions are pre-mocked with `vi.fn()`.
+ *
+ * @param overrides - A deep partial object to override any default mock values.
+ * @returns A complete, mocked CommandContext object.
+ */
+export const createMockCommandContext = (overrides = {}) => {
+    const defaultMocks = {
+        invocation: {
+            raw: '',
+            name: '',
+            args: '',
+        },
+        services: {
+            config: null,
+            settings: { merged: {} },
+            git: undefined,
+            logger: {
+                log: vi.fn(),
+                logMessage: vi.fn(),
+                saveCheckpoint: vi.fn(),
+                loadCheckpoint: vi.fn().mockResolvedValue([]),
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            }, // Cast because Logger is a class.
+        },
+        ui: {
+            addItem: vi.fn(),
+            clear: vi.fn(),
+            setDebugMessage: vi.fn(),
+            pendingItem: null,
+            setPendingItem: vi.fn(),
+            loadHistory: vi.fn(),
+            toggleCorgiMode: vi.fn(),
+            toggleVimEnabled: vi.fn(),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        },
+        session: {
+            sessionShellAllowlist: new Set(),
+            stats: {
+                sessionStartTime: new Date(),
+                lastPromptTokenCount: 0,
+                metrics: {
+                    models: {},
+                    tools: {
+                        totalCalls: 0,
+                        totalSuccess: 0,
+                        totalFail: 0,
+                        totalDurationMs: 0,
+                        totalDecisions: { accept: 0, reject: 0, modify: 0 },
+                        byName: {},
+                    },
+                },
+            },
+        },
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const merge = (target, source) => {
+        const output = { ...target };
+        for (const key in source) {
+            if (Object.prototype.hasOwnProperty.call(source, key)) {
+                const sourceValue = source[key];
+                const targetValue = output[key];
+                if (
+                // We only want to recursivlty merge plain objects
+                Object.prototype.toString.call(sourceValue) === '[object Object]' &&
+                    Object.prototype.toString.call(targetValue) === '[object Object]') {
+                    output[key] = merge(targetValue, sourceValue);
+                }
+                else {
+                    // If not, we do a direct assignment. This preserves Date objects and others.
+                    output[key] = sourceValue;
+                }
+            }
+        }
+        return output;
+    };
+    return merge(defaultMocks, overrides);
+};
+//# sourceMappingURL=mockCommandContext.js.map

package/dist/src/test-utils/mockCommandContext.js.map

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

package/dist/src/test-utils/mockCommandContext.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/test-utils/mockCommandContext.test.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect } from 'vitest';
+import { createMockCommandContext } from './mockCommandContext.js';
+describe('createMockCommandContext', () => {
+    it('should return a valid CommandContext object with default mocks', () => {
+        const context = createMockCommandContext();
+        // Just a few spot checks to ensure the structure is correct
+        // and functions are mocks.
+        expect(context).toBeDefined();
+        expect(context.ui.addItem).toBeInstanceOf(Function);
+        expect(vi.isMockFunction(context.ui.addItem)).toBe(true);
+    });
+    it('should apply top-level overrides correctly', () => {
+        const mockClear = vi.fn();
+        const overrides = {
+            ui: {
+                clear: mockClear,
+            },
+        };
+        const context = createMockCommandContext(overrides);
+        // Call the function to see if the override was used
+        context.ui.clear();
+        // Assert that our specific mock was called, not the default
+        expect(mockClear).toHaveBeenCalled();
+        // And that other defaults are still in place
+        expect(vi.isMockFunction(context.ui.addItem)).toBe(true);
+    });
+    it('should apply deeply nested overrides correctly', () => {
+        // This is the most important test for factory's logic.
+        const mockConfig = {
+            getProjectRoot: () => '/test/project',
+            getModel: () => 'gemini-pro',
+        };
+        const overrides = {
+            services: {
+                config: mockConfig,
+            },
+        };
+        const context = createMockCommandContext(overrides);
+        expect(context.services.config).toBeDefined();
+        expect(context.services.config?.getModel()).toBe('gemini-pro');
+        expect(context.services.config?.getProjectRoot()).toBe('/test/project');
+        // Verify a default property on the same nested object is still there
+        expect(context.services.logger).toBeDefined();
+    });
+});
+//# sourceMappingURL=mockCommandContext.test.js.map

package/dist/src/test-utils/mockCommandContext.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockCommandContext.test.js","sourceRoot":"","sources":["../../../src/test-utils/mockCommandContext.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;QAE3C,4DAA4D;QAC5D,2BAA2B;QAC3B,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG;YAChB,EAAE,EAAE;gBACF,KAAK,EAAE,SAAS;aACjB;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAEpD,oDAAoD;QACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAEnB,4DAA4D;QAC5D,MAAM,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACrC,6CAA6C;QAC7C,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,uDAAuD;QACvD,MAAM,UAAU,GAAG;YACjB,cAAc,EAAE,GAAG,EAAE,CAAC,eAAe;YACrC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY;SAC7B,CAAC;QAEF,MAAM,SAAS,GAAG;YAChB,QAAQ,EAAE;gBACR,MAAM,EAAE,UAAU;aACnB;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAEpD,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/D,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAExE,qEAAqE;QACrE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/test-utils/render.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { render } from 'ink-testing-library';
+import React from 'react';
+export declare const renderWithProviders: (component: React.ReactElement) => ReturnType<typeof render>;