@didim365/agent-cli-core 0.1.0

package/dist/src/services/fileDiscoveryService.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GitIgnoreParser } from '../utils/gitIgnoreParser.js';
+import { GeminiIgnoreParser } from '../utils/geminiIgnoreParser.js';
+import { isGitRepository } from '../utils/gitUtils.js';
+import * as path from 'node:path';
+export class FileDiscoveryService {
+    gitIgnoreFilter = null;
+    geminiIgnoreFilter = null;
+    combinedIgnoreFilter = null;
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = path.resolve(projectRoot);
+        if (isGitRepository(this.projectRoot)) {
+            this.gitIgnoreFilter = new GitIgnoreParser(this.projectRoot);
+        }
+        this.geminiIgnoreFilter = new GeminiIgnoreParser(this.projectRoot);
+        if (this.gitIgnoreFilter) {
+            const geminiPatterns = this.geminiIgnoreFilter.getPatterns();
+            // Create combined parser: .gitignore + .geminiignore
+            this.combinedIgnoreFilter = new GitIgnoreParser(this.projectRoot, geminiPatterns);
+        }
+    }
+    /**
+     * Filters a list of file paths based on git ignore rules
+     */
+    filterFiles(filePaths, options = {}) {
+        const { respectGitIgnore = true, respectGeminiIgnore = true } = options;
+        return filePaths.filter((filePath) => {
+            if (respectGitIgnore &&
+                respectGeminiIgnore &&
+                this.combinedIgnoreFilter) {
+                return !this.combinedIgnoreFilter.isIgnored(filePath);
+            }
+            if (respectGitIgnore && this.gitIgnoreFilter?.isIgnored(filePath)) {
+                return false;
+            }
+            if (respectGeminiIgnore && this.geminiIgnoreFilter?.isIgnored(filePath)) {
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * Filters a list of file paths based on git ignore rules and returns a report
+     * with counts of ignored files.
+     */
+    filterFilesWithReport(filePaths, opts = {
+        respectGitIgnore: true,
+        respectGeminiIgnore: true,
+    }) {
+        const filteredPaths = this.filterFiles(filePaths, opts);
+        const ignoredCount = filePaths.length - filteredPaths.length;
+        return {
+            filteredPaths,
+            ignoredCount,
+        };
+    }
+    /**
+     * Unified method to check if a file should be ignored based on filtering options
+     */
+    shouldIgnoreFile(filePath, options = {}) {
+        return this.filterFiles([filePath], options).length === 0;
+    }
+}
+//# sourceMappingURL=fileDiscoveryService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileDiscoveryService.js","sourceRoot":"","sources":["../../../src/services/fileDiscoveryService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAYlC,MAAM,OAAO,oBAAoB;IACvB,eAAe,GAA2B,IAAI,CAAC;IAC/C,kBAAkB,GAA8B,IAAI,CAAC;IACrD,oBAAoB,GAA2B,IAAI,CAAC;IACpD,WAAW,CAAS;IAE5B,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEnE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC;YAC7D,qDAAqD;YACrD,IAAI,CAAC,oBAAoB,GAAG,IAAI,eAAe,CAC7C,IAAI,CAAC,WAAW,EAChB,cAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAmB,EAAE,UAA8B,EAAE;QAC/D,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,mBAAmB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QACxE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;YACnC,IACE,gBAAgB;gBAChB,mBAAmB;gBACnB,IAAI,CAAC,oBAAoB,EACzB,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACxD,CAAC;YAED,IAAI,gBAAgB,IAAI,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,mBAAmB,IAAI,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,qBAAqB,CACnB,SAAmB,EACnB,OAA2B;QACzB,gBAAgB,EAAE,IAAI;QACtB,mBAAmB,EAAE,IAAI;KAC1B;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAE7D,OAAO;YACL,aAAa;YACb,YAAY;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,QAAgB,EAChB,UAA8B,EAAE;QAEhC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5D,CAAC;CACF"}

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,223 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { FileDiscoveryService } from './fileDiscoveryService.js';
+describe('FileDiscoveryService', () => {
+    let testRootDir;
+    let projectRoot;
+    async function createTestFile(filePath, content = '') {
+        const fullPath = path.join(projectRoot, filePath);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, content);
+        return fullPath;
+    }
+    beforeEach(async () => {
+        testRootDir = await fs.mkdtemp(path.join(os.tmpdir(), 'file-discovery-test-'));
+        projectRoot = path.join(testRootDir, 'project');
+        await fs.mkdir(projectRoot, { recursive: true });
+    });
+    afterEach(async () => {
+        await fs.rm(testRootDir, { recursive: true, force: true });
+    });
+    describe('initialization', () => {
+        it('should initialize git ignore parser by default in a git repo', async () => {
+            await fs.mkdir(path.join(projectRoot, '.git'));
+            await createTestFile('.gitignore', 'node_modules/');
+            const service = new FileDiscoveryService(projectRoot);
+            // Let's check the effect of the parser instead of mocking it.
+            expect(service.shouldIgnoreFile('node_modules/foo.js')).toBe(true);
+            expect(service.shouldIgnoreFile('src/foo.js')).toBe(false);
+        });
+        it('should not load git repo patterns when not in a git repo', async () => {
+            // No .git directory
+            await createTestFile('.gitignore', 'node_modules/');
+            const service = new FileDiscoveryService(projectRoot);
+            // .gitignore is not loaded in non-git repos
+            expect(service.shouldIgnoreFile('node_modules/foo.js')).toBe(false);
+        });
+        it('should load .geminiignore patterns even when not in a git repo', async () => {
+            await createTestFile('.geminiignore', 'secrets.txt');
+            const service = new FileDiscoveryService(projectRoot);
+            expect(service.shouldIgnoreFile('secrets.txt')).toBe(true);
+            expect(service.shouldIgnoreFile('src/index.js')).toBe(false);
+        });
+    });
+    describe('filterFiles', () => {
+        beforeEach(async () => {
+            await fs.mkdir(path.join(projectRoot, '.git'));
+            await createTestFile('.gitignore', 'node_modules/\n.git/\ndist');
+            await createTestFile('.geminiignore', 'logs/');
+        });
+        it('should filter out git-ignored and gemini-ignored files by default', () => {
+            const files = [
+                'src/index.ts',
+                'node_modules/package/index.js',
+                'README.md',
+                '.git/config',
+                'dist/bundle.js',
+                'logs/latest.log',
+            ].map((f) => path.join(projectRoot, f));
+            const service = new FileDiscoveryService(projectRoot);
+            expect(service.filterFiles(files)).toEqual(['src/index.ts', 'README.md'].map((f) => path.join(projectRoot, f)));
+        });
+        it('should not filter files when respectGitIgnore is false', () => {
+            const files = [
+                'src/index.ts',
+                'node_modules/package/index.js',
+                '.git/config',
+                'logs/latest.log',
+            ].map((f) => path.join(projectRoot, f));
+            const service = new FileDiscoveryService(projectRoot);
+            const filtered = service.filterFiles(files, {
+                respectGitIgnore: false,
+                respectGeminiIgnore: true, // still respect this one
+            });
+            expect(filtered).toEqual(['src/index.ts', 'node_modules/package/index.js', '.git/config'].map((f) => path.join(projectRoot, f)));
+        });
+        it('should not filter files when respectGeminiIgnore is false', () => {
+            const files = [
+                'src/index.ts',
+                'node_modules/package/index.js',
+                'logs/latest.log',
+            ].map((f) => path.join(projectRoot, f));
+            const service = new FileDiscoveryService(projectRoot);
+            const filtered = service.filterFiles(files, {
+                respectGitIgnore: true,
+                respectGeminiIgnore: false,
+            });
+            expect(filtered).toEqual(['src/index.ts', 'logs/latest.log'].map((f) => path.join(projectRoot, f)));
+        });
+        it('should handle empty file list', () => {
+            const service = new FileDiscoveryService(projectRoot);
+            expect(service.filterFiles([])).toEqual([]);
+        });
+    });
+    describe('filterFilesWithReport', () => {
+        beforeEach(async () => {
+            await fs.mkdir(path.join(projectRoot, '.git'));
+            await createTestFile('.gitignore', 'node_modules/');
+            await createTestFile('.geminiignore', '*.log');
+        });
+        it('should return filtered paths and correct ignored count', () => {
+            const files = [
+                'src/index.ts',
+                'node_modules/package/index.js',
+                'debug.log',
+                'README.md',
+            ].map((f) => path.join(projectRoot, f));
+            const service = new FileDiscoveryService(projectRoot);
+            const report = service.filterFilesWithReport(files);
+            expect(report.filteredPaths).toEqual(['src/index.ts', 'README.md'].map((f) => path.join(projectRoot, f)));
+            expect(report.ignoredCount).toBe(2);
+        });
+        it('should handle no ignored files', () => {
+            const files = ['src/index.ts', 'README.md'].map((f) => path.join(projectRoot, f));
+            const service = new FileDiscoveryService(projectRoot);
+            const report = service.filterFilesWithReport(files);
+            expect(report.filteredPaths).toEqual(files);
+            expect(report.ignoredCount).toBe(0);
+        });
+    });
+    describe('shouldGitIgnoreFile & shouldGeminiIgnoreFile', () => {
+        beforeEach(async () => {
+            await fs.mkdir(path.join(projectRoot, '.git'));
+            await createTestFile('.gitignore', 'node_modules/');
+            await createTestFile('.geminiignore', '*.log');
+        });
+        it('should return true for git-ignored files', () => {
+            const service = new FileDiscoveryService(projectRoot);
+            expect(service.shouldIgnoreFile(path.join(projectRoot, 'node_modules/package/index.js'))).toBe(true);
+        });
+        it('should return false for non-git-ignored files', () => {
+            const service = new FileDiscoveryService(projectRoot);
+            expect(service.shouldIgnoreFile(path.join(projectRoot, 'src/index.ts'))).toBe(false);
+        });
+        it('should return true for gemini-ignored files', () => {
+            const service = new FileDiscoveryService(projectRoot);
+            expect(service.shouldIgnoreFile(path.join(projectRoot, 'debug.log'))).toBe(true);
+        });
+        it('should return false for non-gemini-ignored files', () => {
+            const service = new FileDiscoveryService(projectRoot);
+            expect(service.shouldIgnoreFile(path.join(projectRoot, 'src/index.ts'))).toBe(false);
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle relative project root paths', async () => {
+            await fs.mkdir(path.join(projectRoot, '.git'));
+            await createTestFile('.gitignore', 'ignored.txt');
+            const service = new FileDiscoveryService(path.relative(process.cwd(), projectRoot));
+            expect(service.shouldIgnoreFile(path.join(projectRoot, 'ignored.txt'))).toBe(true);
+            expect(service.shouldIgnoreFile(path.join(projectRoot, 'not-ignored.txt'))).toBe(false);
+        });
+        it('should handle filterFiles with undefined options', async () => {
+            await fs.mkdir(path.join(projectRoot, '.git'));
+            await createTestFile('.gitignore', 'ignored.txt');
+            const service = new FileDiscoveryService(projectRoot);
+            const files = ['src/index.ts', 'ignored.txt'].map((f) => path.join(projectRoot, f));
+            expect(service.filterFiles(files, undefined)).toEqual([
+                path.join(projectRoot, 'src/index.ts'),
+            ]);
+        });
+    });
+    describe('precedence (.geminiignore over .gitignore)', () => {
+        beforeEach(async () => {
+            await fs.mkdir(path.join(projectRoot, '.git'));
+        });
+        it('should un-ignore a file in .geminiignore that is ignored in .gitignore', async () => {
+            await createTestFile('.gitignore', '*.txt');
+            await createTestFile('.geminiignore', '!important.txt');
+            const service = new FileDiscoveryService(projectRoot);
+            const files = ['file.txt', 'important.txt'].map((f) => path.join(projectRoot, f));
+            const filtered = service.filterFiles(files);
+            expect(filtered).toEqual([path.join(projectRoot, 'important.txt')]);
+        });
+        it('should un-ignore a directory in .geminiignore that is ignored in .gitignore', async () => {
+            await createTestFile('.gitignore', 'logs/');
+            await createTestFile('.geminiignore', '!logs/');
+            const service = new FileDiscoveryService(projectRoot);
+            const files = ['logs/app.log', 'other/app.log'].map((f) => path.join(projectRoot, f));
+            const filtered = service.filterFiles(files);
+            expect(filtered).toEqual(files);
+        });
+        it('should extend ignore rules in .geminiignore', async () => {
+            await createTestFile('.gitignore', '*.log');
+            await createTestFile('.geminiignore', 'temp/');
+            const service = new FileDiscoveryService(projectRoot);
+            const files = ['app.log', 'temp/file.txt'].map((f) => path.join(projectRoot, f));
+            const filtered = service.filterFiles(files);
+            expect(filtered).toEqual([]);
+        });
+        it('should use .gitignore rules if respectGeminiIgnore is false', async () => {
+            await createTestFile('.gitignore', '*.txt');
+            await createTestFile('.geminiignore', '!important.txt');
+            const service = new FileDiscoveryService(projectRoot);
+            const files = ['file.txt', 'important.txt'].map((f) => path.join(projectRoot, f));
+            const filtered = service.filterFiles(files, {
+                respectGitIgnore: true,
+                respectGeminiIgnore: false,
+            });
+            expect(filtered).toEqual([]);
+        });
+        it('should use .geminiignore rules if respectGitIgnore is false', async () => {
+            await createTestFile('.gitignore', '*.txt');
+            await createTestFile('.geminiignore', '!important.txt\ntemp/');
+            const service = new FileDiscoveryService(projectRoot);
+            const files = ['file.txt', 'important.txt', 'temp/file.js'].map((f) => path.join(projectRoot, f));
+            const filtered = service.filterFiles(files, {
+                respectGitIgnore: false,
+                respectGeminiIgnore: true,
+            });
+            // .gitignore is ignored, so *.txt is not applied.
+            // .geminiignore un-ignores important.txt (which wasn't ignored anyway)
+            // and ignores temp/
+            expect(filtered).toEqual(['file.txt', 'important.txt'].map((f) => path.join(projectRoot, f)));
+        });
+    });
+});
+//# 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/fileSystemService.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Interface for file system operations that may be delegated to different implementations
+ */
+export interface FileSystemService {
+    /**
+     * Read text content from a file
+     *
+     * @param filePath - The path to the file to read
+     * @returns The file content as a string
+     */
+    readTextFile(filePath: string): Promise<string>;
+    /**
+     * Write text content to a file
+     *
+     * @param filePath - The path to the file to write
+     * @param content - The content to write
+     */
+    writeTextFile(filePath: string, content: string): Promise<void>;
+}
+/**
+ * Standard file system implementation
+ */
+export declare class StandardFileSystemService implements FileSystemService {
+    readTextFile(filePath: string): Promise<string>;
+    writeTextFile(filePath: string, content: string): Promise<void>;
+}

package/dist/src/services/fileSystemService.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs/promises';
+/**
+ * Standard file system implementation
+ */
+export class StandardFileSystemService {
+    async readTextFile(filePath) {
+        return fs.readFile(filePath, 'utf-8');
+    }
+    async writeTextFile(filePath, content) {
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+}
+//# sourceMappingURL=fileSystemService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystemService.js","sourceRoot":"","sources":["../../../src/services/fileSystemService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAuBlC;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,OAAe;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF"}

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import fs from 'node:fs/promises';
+import { StandardFileSystemService } from './fileSystemService.js';
+vi.mock('fs/promises');
+describe('StandardFileSystemService', () => {
+    let fileSystem;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        fileSystem = new StandardFileSystemService();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('readTextFile', () => {
+        it('should read file content using fs', async () => {
+            const testContent = 'Hello, World!';
+            vi.mocked(fs.readFile).mockResolvedValue(testContent);
+            const result = await fileSystem.readTextFile('/test/file.txt');
+            expect(fs.readFile).toHaveBeenCalledWith('/test/file.txt', 'utf-8');
+            expect(result).toBe(testContent);
+        });
+        it('should propagate fs.readFile errors', async () => {
+            const error = new Error('ENOENT: File not found');
+            vi.mocked(fs.readFile).mockRejectedValue(error);
+            await expect(fileSystem.readTextFile('/test/file.txt')).rejects.toThrow('ENOENT: File not found');
+        });
+    });
+    describe('writeTextFile', () => {
+        it('should write file content using fs', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await fileSystem.writeTextFile('/test/file.txt', 'Hello, World!');
+            expect(fs.writeFile).toHaveBeenCalledWith('/test/file.txt', 'Hello, World!', 'utf-8');
+        });
+    });
+});
+//# sourceMappingURL=fileSystemService.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystemService.test.js","sourceRoot":"","sources":["../../../src/services/fileSystemService.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAEvB,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,IAAI,UAAqC,CAAC;IAE1C,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,UAAU,GAAG,IAAI,yBAAyB,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,WAAW,GAAG,eAAe,CAAC;YACpC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAEtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;YAE/D,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACpE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAClD,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAEhD,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACrE,wBAAwB,CACzB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,iBAAiB,EAAE,CAAC;YAE5C,MAAM,UAAU,CAAC,aAAa,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;YAElE,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACvC,gBAAgB,EAChB,eAAe,EACf,OAAO,CACR,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Storage } from '../config/storage.js';
+export declare class GitService {
+    private projectRoot;
+    private storage;
+    constructor(projectRoot: string, storage: Storage);
+    private getHistoryDir;
+    initialize(): Promise<void>;
+    static 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,123 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { isNodeError } from '../utils/errors.js';
+import { spawnAsync } from '../utils/shell-utils.js';
+import { simpleGit, CheckRepoActions } from 'simple-git';
+import { debugLogger } from '../utils/debugLogger.js';
+export class GitService {
+    projectRoot;
+    storage;
+    constructor(projectRoot, storage) {
+        this.projectRoot = path.resolve(projectRoot);
+        this.storage = storage;
+    }
+    getHistoryDir() {
+        return this.storage.getHistoryDir();
+    }
+    async initialize() {
+        const gitAvailable = await GitService.verifyGitAvailability();
+        if (!gitAvailable) {
+            throw new Error('Checkpointing is enabled, but Git is not installed. Please install Git or disable checkpointing to continue.');
+        }
+        try {
+            await this.setupShadowGitRepository();
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize checkpointing: ${error instanceof Error ? error.message : 'Unknown error'}. Please check that Git is working properly or disable checkpointing.`);
+        }
+    }
+    static async verifyGitAvailability() {
+        try {
+            await spawnAsync('git', ['--version']);
+            return true;
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+    /**
+     * 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);
+        let isRepoDefined = false;
+        try {
+            isRepoDefined = await repo.checkIsRepo(CheckRepoActions.IS_REPO_ROOT);
+        }
+        catch (error) {
+            // If checkIsRepo fails (e.g., on certain Git versions like macOS 2.39.5),
+            // log the error and assume repo is not defined, then proceed with initialization
+            debugLogger.debug(`checkIsRepo failed, will initialize repository: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        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) {
+        try {
+            const repo = this.shadowGitRepository;
+            await repo.add('.');
+            const status = await repo.status();
+            if (status.isClean()) {
+                // If no changes are staged, return the current HEAD commit hash
+                return await this.getCurrentCommitHash();
+            }
+            const commitResult = await repo.commit(message, {
+                '--no-verify': null,
+            });
+            return commitResult.commit;
+        }
+        catch (error) {
+            throw new Error(`Failed to create checkpoint snapshot: ${error instanceof Error ? error.message : 'Unknown error'}. Checkpointing may not be working properly.`);
+        }
+    }
+    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 {};