@google/gemini-cli-core 0.1.0-development.1

package/dist/src/services/fileDiscoveryService.test.d.ts

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

package/dist/src/services/fileDiscoveryService.test.js

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
+import { FileDiscoveryService } from './fileDiscoveryService.js';
+import { GitIgnoreParser } from '../utils/gitIgnoreParser.js';
+import * as gitUtils from '../utils/gitUtils.js';
+// Mock the GitIgnoreParser
+vi.mock('../utils/gitIgnoreParser.js');
+// Mock gitUtils module
+vi.mock('../utils/gitUtils.js');
+describe('FileDiscoveryService', () => {
+    let service;
+    let mockGitIgnoreParser;
+    const mockProjectRoot = '/test/project';
+    beforeEach(() => {
+        mockGitIgnoreParser = {
+            initialize: vi.fn(),
+            isIgnored: vi.fn(),
+            loadPatterns: vi.fn(),
+            loadGitRepoPatterns: vi.fn(),
+        };
+        vi.mocked(GitIgnoreParser).mockImplementation(() => mockGitIgnoreParser);
+        vi.mocked(gitUtils.isGitRepository).mockReturnValue(true);
+        vi.mocked(gitUtils.findGitRoot).mockReturnValue('/test/project');
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('initialization', () => {
+        it('should initialize git ignore parser by default', () => {
+            service = new FileDiscoveryService(mockProjectRoot);
+            expect(GitIgnoreParser).toHaveBeenCalledWith(mockProjectRoot);
+            expect(GitIgnoreParser).toHaveBeenCalledTimes(2);
+            expect(mockGitIgnoreParser.loadGitRepoPatterns).toHaveBeenCalled();
+            expect(mockGitIgnoreParser.loadPatterns).toHaveBeenCalled();
+        });
+        it('should not initialize git ignore parser when not a git repo', () => {
+            vi.mocked(gitUtils.isGitRepository).mockReturnValue(false);
+            service = new FileDiscoveryService(mockProjectRoot);
+            expect(GitIgnoreParser).toHaveBeenCalledOnce();
+            expect(mockGitIgnoreParser.loadGitRepoPatterns).not.toHaveBeenCalled();
+        });
+    });
+    describe('filterFiles', () => {
+        beforeEach(() => {
+            mockGitIgnoreParser.isIgnored.mockImplementation((path) => path.includes('node_modules') || path.includes('.git'));
+            service = new FileDiscoveryService(mockProjectRoot);
+        });
+        it('should filter out git-ignored files by default', () => {
+            const files = [
+                'src/index.ts',
+                'node_modules/package/index.js',
+                'README.md',
+                '.git/config',
+                'dist/bundle.js',
+            ];
+            const filtered = service.filterFiles(files);
+            expect(filtered).toEqual(['src/index.ts', 'README.md', 'dist/bundle.js']);
+        });
+        it('should not filter files when respectGitIgnore is false', () => {
+            const files = [
+                'src/index.ts',
+                'node_modules/package/index.js',
+                '.git/config',
+            ];
+            const filtered = service.filterFiles(files, { respectGitIgnore: false });
+            expect(filtered).toEqual(files);
+        });
+        it('should handle empty file list', () => {
+            const filtered = service.filterFiles([]);
+            expect(filtered).toEqual([]);
+        });
+    });
+    describe('shouldGitIgnoreFile', () => {
+        beforeEach(() => {
+            mockGitIgnoreParser.isIgnored.mockImplementation((path) => path.includes('node_modules'));
+            service = new FileDiscoveryService(mockProjectRoot);
+        });
+        it('should return true for git-ignored files', () => {
+            expect(service.shouldGitIgnoreFile('node_modules/package/index.js')).toBe(true);
+        });
+        it('should return false for non-ignored files', () => {
+            expect(service.shouldGitIgnoreFile('src/index.ts')).toBe(false);
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle relative project root paths', () => {
+            const relativeService = new FileDiscoveryService('./relative/path');
+            expect(relativeService).toBeInstanceOf(FileDiscoveryService);
+        });
+        it('should handle filterFiles with undefined options', () => {
+            const files = ['src/index.ts'];
+            const filtered = service.filterFiles(files, undefined);
+            expect(filtered).toEqual(files);
+        });
+    });
+});
+//# sourceMappingURL=fileDiscoveryService.test.js.map

package/dist/src/services/fileDiscoveryService.test.js.map

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

package/dist/src/services/gitService.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class GitService {
+    private projectRoot;
+    constructor(projectRoot: string);
+    private getHistoryDir;
+    initialize(): Promise<void>;
+    verifyGitAvailability(): Promise<boolean>;
+    /**
+     * Creates a hidden git repository in the project root.
+     * The Git repository is used to support checkpointing.
+     */
+    setupShadowGitRepository(): Promise<void>;
+    private get shadowGitRepository();
+    getCurrentCommitHash(): Promise<string>;
+    createFileSnapshot(message: string): Promise<string>;
+    restoreProjectFromSnapshot(commitHash: string): Promise<void>;
+}

package/dist/src/services/gitService.js

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { isNodeError } from '../utils/errors.js';
+import { isGitRepository } from '../utils/gitUtils.js';
+import { exec } from 'node:child_process';
+import { simpleGit, CheckRepoActions } from 'simple-git';
+import { getProjectHash, GEMINI_DIR } from '../utils/paths.js';
+export class GitService {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = path.resolve(projectRoot);
+    }
+    getHistoryDir() {
+        const hash = getProjectHash(this.projectRoot);
+        return path.join(os.homedir(), GEMINI_DIR, 'history', hash);
+    }
+    async initialize() {
+        if (!isGitRepository(this.projectRoot)) {
+            throw new Error('GitService requires a Git repository');
+        }
+        const gitAvailable = await this.verifyGitAvailability();
+        if (!gitAvailable) {
+            throw new Error('GitService requires Git to be installed');
+        }
+        this.setupShadowGitRepository();
+    }
+    verifyGitAvailability() {
+        return new Promise((resolve) => {
+            exec('git --version', (error) => {
+                if (error) {
+                    resolve(false);
+                }
+                else {
+                    resolve(true);
+                }
+            });
+        });
+    }
+    /**
+     * Creates a hidden git repository in the project root.
+     * The Git repository is used to support checkpointing.
+     */
+    async setupShadowGitRepository() {
+        const repoDir = this.getHistoryDir();
+        const gitConfigPath = path.join(repoDir, '.gitconfig');
+        await fs.mkdir(repoDir, { recursive: true });
+        // We don't want to inherit the user's name, email, or gpg signing
+        // preferences for the shadow repository, so we create a dedicated gitconfig.
+        const gitConfigContent = '[user]\n  name = Gemini CLI\n  email = gemini-cli@google.com\n[commit]\n  gpgsign = false\n';
+        await fs.writeFile(gitConfigPath, gitConfigContent);
+        const repo = simpleGit(repoDir);
+        const isRepoDefined = await repo.checkIsRepo(CheckRepoActions.IS_REPO_ROOT);
+        if (!isRepoDefined) {
+            await repo.init(false, {
+                '--initial-branch': 'main',
+            });
+            await repo.commit('Initial commit', { '--allow-empty': null });
+        }
+        const userGitIgnorePath = path.join(this.projectRoot, '.gitignore');
+        const shadowGitIgnorePath = path.join(repoDir, '.gitignore');
+        let userGitIgnoreContent = '';
+        try {
+            userGitIgnoreContent = await fs.readFile(userGitIgnorePath, 'utf-8');
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        await fs.writeFile(shadowGitIgnorePath, userGitIgnoreContent);
+    }
+    get shadowGitRepository() {
+        const repoDir = this.getHistoryDir();
+        return simpleGit(this.projectRoot).env({
+            GIT_DIR: path.join(repoDir, '.git'),
+            GIT_WORK_TREE: this.projectRoot,
+            // Prevent git from using the user's global git config.
+            HOME: repoDir,
+            XDG_CONFIG_HOME: repoDir,
+        });
+    }
+    async getCurrentCommitHash() {
+        const hash = await this.shadowGitRepository.raw('rev-parse', 'HEAD');
+        return hash.trim();
+    }
+    async createFileSnapshot(message) {
+        const repo = this.shadowGitRepository;
+        await repo.add('.');
+        const commitResult = await repo.commit(message);
+        return commitResult.commit;
+    }
+    async restoreProjectFromSnapshot(commitHash) {
+        const repo = this.shadowGitRepository;
+        await repo.raw(['restore', '--source', commitHash, '.']);
+        // Removes any untracked files that were introduced post snapshot.
+        await repo.clean('f', ['-d']);
+    }
+}
+//# sourceMappingURL=gitService.js.map

package/dist/src/services/gitService.js.map

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

package/dist/src/services/gitService.test.d.ts

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

package/dist/src/services/gitService.test.js

@@ -0,0 +1,233 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { GitService } from './gitService.js';
+import * as path from 'path';
+const hoistedMockExec = vi.hoisted(() => vi.fn());
+vi.mock('node:child_process', () => ({
+    exec: hoistedMockExec,
+}));
+const hoistedMockMkdir = vi.hoisted(() => vi.fn());
+const hoistedMockReadFile = vi.hoisted(() => vi.fn());
+const hoistedMockWriteFile = vi.hoisted(() => vi.fn());
+vi.mock('fs/promises', async (importOriginal) => {
+    const actual = (await importOriginal());
+    return {
+        ...actual,
+        mkdir: hoistedMockMkdir,
+        readFile: hoistedMockReadFile,
+        writeFile: hoistedMockWriteFile,
+    };
+});
+const hoistedMockEnv = vi.hoisted(() => vi.fn());
+const hoistedMockSimpleGit = vi.hoisted(() => vi.fn());
+const hoistedMockCheckIsRepo = vi.hoisted(() => vi.fn());
+const hoistedMockInit = vi.hoisted(() => vi.fn());
+const hoistedMockRaw = vi.hoisted(() => vi.fn());
+const hoistedMockAdd = vi.hoisted(() => vi.fn());
+const hoistedMockCommit = vi.hoisted(() => vi.fn());
+vi.mock('simple-git', () => ({
+    simpleGit: hoistedMockSimpleGit.mockImplementation(() => ({
+        checkIsRepo: hoistedMockCheckIsRepo,
+        init: hoistedMockInit,
+        raw: hoistedMockRaw,
+        add: hoistedMockAdd,
+        commit: hoistedMockCommit,
+        env: hoistedMockEnv,
+    })),
+    CheckRepoActions: { IS_REPO_ROOT: 'is-repo-root' },
+}));
+const hoistedIsGitRepositoryMock = vi.hoisted(() => vi.fn());
+vi.mock('../utils/gitUtils.js', () => ({
+    isGitRepository: hoistedIsGitRepositoryMock,
+}));
+const hoistedMockIsNodeError = vi.hoisted(() => vi.fn());
+vi.mock('../utils/errors.js', () => ({
+    isNodeError: hoistedMockIsNodeError,
+}));
+const hoistedMockHomedir = vi.hoisted(() => vi.fn());
+vi.mock('os', () => ({
+    homedir: hoistedMockHomedir,
+}));
+const hoistedMockCreateHash = vi.hoisted(() => {
+    const mockUpdate = vi.fn().mockReturnThis();
+    const mockDigest = vi.fn();
+    return {
+        createHash: vi.fn(() => ({
+            update: mockUpdate,
+            digest: mockDigest,
+        })),
+        mockUpdate,
+        mockDigest,
+    };
+});
+vi.mock('crypto', () => ({
+    createHash: hoistedMockCreateHash.createHash,
+}));
+describe('GitService', () => {
+    const mockProjectRoot = '/test/project';
+    const mockHomedir = '/mock/home';
+    const mockHash = 'mock-hash';
+    beforeEach(() => {
+        vi.clearAllMocks();
+        hoistedIsGitRepositoryMock.mockReturnValue(true);
+        hoistedMockExec.mockImplementation((command, callback) => {
+            if (command === 'git --version') {
+                callback(null, 'git version 2.0.0');
+            }
+            else {
+                callback(new Error('Command not mocked'));
+            }
+            return {};
+        });
+        hoistedMockMkdir.mockResolvedValue(undefined);
+        hoistedMockReadFile.mockResolvedValue('');
+        hoistedMockWriteFile.mockResolvedValue(undefined);
+        hoistedMockIsNodeError.mockImplementation((e) => e instanceof Error);
+        hoistedMockHomedir.mockReturnValue(mockHomedir);
+        hoistedMockCreateHash.mockUpdate.mockReturnThis();
+        hoistedMockCreateHash.mockDigest.mockReturnValue(mockHash);
+        hoistedMockEnv.mockImplementation(() => ({
+            checkIsRepo: hoistedMockCheckIsRepo,
+            init: hoistedMockInit,
+            raw: hoistedMockRaw,
+            add: hoistedMockAdd,
+            commit: hoistedMockCommit,
+        }));
+        hoistedMockSimpleGit.mockImplementation(() => ({
+            checkIsRepo: hoistedMockCheckIsRepo,
+            init: hoistedMockInit,
+            raw: hoistedMockRaw,
+            add: hoistedMockAdd,
+            commit: hoistedMockCommit,
+            env: hoistedMockEnv,
+        }));
+        hoistedMockCheckIsRepo.mockResolvedValue(false);
+        hoistedMockInit.mockResolvedValue(undefined);
+        hoistedMockRaw.mockResolvedValue('');
+        hoistedMockAdd.mockResolvedValue(undefined);
+        hoistedMockCommit.mockResolvedValue({
+            commit: 'initial',
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('constructor', () => {
+        it('should successfully create an instance if projectRoot is a Git repository', () => {
+            expect(() => new GitService(mockProjectRoot)).not.toThrow();
+        });
+    });
+    describe('verifyGitAvailability', () => {
+        it('should resolve true if git --version command succeeds', async () => {
+            const service = new GitService(mockProjectRoot);
+            await expect(service.verifyGitAvailability()).resolves.toBe(true);
+        });
+        it('should resolve false if git --version command fails', async () => {
+            hoistedMockExec.mockImplementation((command, callback) => {
+                callback(new Error('git not found'));
+                return {};
+            });
+            const service = new GitService(mockProjectRoot);
+            await expect(service.verifyGitAvailability()).resolves.toBe(false);
+        });
+    });
+    describe('initialize', () => {
+        it('should throw an error if projectRoot is not a Git repository', async () => {
+            hoistedIsGitRepositoryMock.mockReturnValue(false);
+            const service = new GitService(mockProjectRoot);
+            await expect(service.initialize()).rejects.toThrow('GitService requires a Git repository');
+        });
+        it('should throw an error if Git is not available', async () => {
+            hoistedMockExec.mockImplementation((command, callback) => {
+                callback(new Error('git not found'));
+                return {};
+            });
+            const service = new GitService(mockProjectRoot);
+            await expect(service.initialize()).rejects.toThrow('GitService requires Git to be installed');
+        });
+        it('should call setupShadowGitRepository if Git is available', async () => {
+            const service = new GitService(mockProjectRoot);
+            const setupSpy = vi
+                .spyOn(service, 'setupShadowGitRepository')
+                .mockResolvedValue(undefined);
+            await service.initialize();
+            expect(setupSpy).toHaveBeenCalled();
+        });
+    });
+    describe('setupShadowGitRepository', () => {
+        const repoDir = path.join(mockHomedir, '.gemini', 'history', mockHash);
+        const hiddenGitIgnorePath = path.join(repoDir, '.gitignore');
+        const visibleGitIgnorePath = path.join(mockProjectRoot, '.gitignore');
+        const gitConfigPath = path.join(repoDir, '.gitconfig');
+        it('should create a .gitconfig file with the correct content', async () => {
+            const service = new GitService(mockProjectRoot);
+            await service.setupShadowGitRepository();
+            const expectedConfigContent = '[user]\n  name = Gemini CLI\n  email = gemini-cli@google.com\n[commit]\n  gpgsign = false\n';
+            expect(hoistedMockWriteFile).toHaveBeenCalledWith(gitConfigPath, expectedConfigContent);
+        });
+        it('should create history and repository directories', async () => {
+            const service = new GitService(mockProjectRoot);
+            await service.setupShadowGitRepository();
+            expect(hoistedMockMkdir).toHaveBeenCalledWith(repoDir, {
+                recursive: true,
+            });
+        });
+        it('should initialize git repo in historyDir if not already initialized', async () => {
+            hoistedMockCheckIsRepo.mockResolvedValue(false);
+            const service = new GitService(mockProjectRoot);
+            await service.setupShadowGitRepository();
+            expect(hoistedMockSimpleGit).toHaveBeenCalledWith(repoDir);
+            expect(hoistedMockInit).toHaveBeenCalled();
+        });
+        it('should not initialize git repo if already initialized', async () => {
+            hoistedMockCheckIsRepo.mockResolvedValue(true);
+            const service = new GitService(mockProjectRoot);
+            await service.setupShadowGitRepository();
+            expect(hoistedMockInit).not.toHaveBeenCalled();
+        });
+        it('should copy .gitignore from projectRoot if it exists', async () => {
+            const gitignoreContent = `node_modules/\n.env`;
+            hoistedMockReadFile.mockImplementation(async (filePath) => {
+                if (filePath === visibleGitIgnorePath) {
+                    return gitignoreContent;
+                }
+                return '';
+            });
+            const service = new GitService(mockProjectRoot);
+            await service.setupShadowGitRepository();
+            expect(hoistedMockReadFile).toHaveBeenCalledWith(visibleGitIgnorePath, 'utf-8');
+            expect(hoistedMockWriteFile).toHaveBeenCalledWith(hiddenGitIgnorePath, gitignoreContent);
+        });
+        it('should throw an error if reading projectRoot .gitignore fails with other errors', async () => {
+            const readError = new Error('Read permission denied');
+            hoistedMockReadFile.mockImplementation(async (filePath) => {
+                if (filePath === visibleGitIgnorePath) {
+                    throw readError;
+                }
+                return '';
+            });
+            hoistedMockIsNodeError.mockImplementation((e) => e instanceof Error);
+            const service = new GitService(mockProjectRoot);
+            await expect(service.setupShadowGitRepository()).rejects.toThrow('Read permission denied');
+        });
+        it('should make an initial commit if no commits exist in history repo', async () => {
+            hoistedMockCheckIsRepo.mockResolvedValue(false);
+            const service = new GitService(mockProjectRoot);
+            await service.setupShadowGitRepository();
+            expect(hoistedMockCommit).toHaveBeenCalledWith('Initial commit', {
+                '--allow-empty': null,
+            });
+        });
+        it('should not make an initial commit if commits already exist', async () => {
+            hoistedMockCheckIsRepo.mockResolvedValue(true);
+            const service = new GitService(mockProjectRoot);
+            await service.setupShadowGitRepository();
+            expect(hoistedMockCommit).not.toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=gitService.test.js.map

package/dist/src/services/gitService.test.js.map

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

package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Buffer } from 'buffer';
+import { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiResponseEvent, ApiErrorEvent } from '../types.js';
+import { Config } from '../../config/config.js';
+export interface LogResponse {
+    nextRequestWaitMs?: number;
+}
+export declare class ClearcutLogger {
+    private static instance;
+    private config?;
+    private readonly events;
+    private last_flush_time;
+    private flush_interval_ms;
+    private constructor();
+    static getInstance(config?: Config): ClearcutLogger | undefined;
+    enqueueLogEvent(event: any): void;
+    createLogEvent(name: string, data: object): object;
+    flushIfNeeded(): void;
+    flushToClearcut(): Promise<LogResponse>;
+    decodeLogResponse(buf: Buffer): LogResponse | undefined;
+    logStartSessionEvent(event: StartSessionEvent): void;
+    logNewPromptEvent(event: UserPromptEvent): void;
+    logToolCallEvent(event: ToolCallEvent): void;
+    logApiRequestEvent(event: ApiRequestEvent): void;
+    logApiResponseEvent(event: ApiResponseEvent): void;
+    logApiErrorEvent(event: ApiErrorEvent): void;
+    logEndSessionEvent(event: EndSessionEvent): void;
+    shutdown(): void;
+}