@anh3d0nic/qwen-code-termux-ice 21.0.1 → 21.2.0

package/core-dist/src/services/fileSystemService.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileReadResult } from '../utils/fileUtils.js';
+/**
+ * Supported file encodings for new files.
+ */
+export declare const FileEncoding: {
+    readonly UTF8: "utf-8";
+    readonly UTF8_BOM: "utf-8-bom";
+};
+/**
+ * Type for file encoding values.
+ */
+export type FileEncodingType = (typeof FileEncoding)[keyof typeof FileEncoding];
+/**
+ * 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>;
+    /**
+     * Read text content from a file, returning both the content and encoding metadata.
+     * Combines readTextFile + detectFileBOM + detectFileEncoding into a single I/O pass.
+     *
+     * @param filePath - The path to the file to read
+     * @returns The file content, encoding name, and whether a UTF-8 BOM was present
+     */
+    readTextFileWithInfo(filePath: string): Promise<FileReadResult>;
+    /**
+     * Write text content to a file
+     *
+     * @param filePath - The path to the file to write
+     * @param content - The content to write
+     * @param options - Optional write options including whether to add BOM
+     */
+    writeTextFile(filePath: string, content: string, options?: WriteTextFileOptions): Promise<void>;
+    /**
+     * Detects if a file has UTF-8 BOM (Byte Order Mark).
+     *
+     * @param filePath - The path to the file to check
+     * @returns True if the file has BOM, false otherwise
+     */
+    detectFileBOM(filePath: string): Promise<boolean>;
+    /**
+     * Finds files with a given name within specified search paths.
+     *
+     * @param fileName - The name of the file to find.
+     * @param searchPaths - An array of directory paths to search within.
+     * @returns An array of absolute paths to the found files.
+     */
+    findFiles(fileName: string, searchPaths: readonly string[]): string[];
+}
+/**
+ * Options for writing text files
+ */
+export interface WriteTextFileOptions {
+    /**
+     * Whether to write the file with UTF-8 BOM.
+     * If true, EF BB BF will be prepended to the content.
+     * @default false
+     */
+    bom?: boolean;
+    /**
+     * The encoding to use when writing the file.
+     * If specified and not UTF-8 compatible, iconv-lite will be used to encode.
+     * This is used to preserve the original encoding of non-UTF-8 files (e.g. GBK, Big5).
+     * @default undefined (writes as UTF-8)
+     */
+    encoding?: string;
+}
+/**
+ * Standard file system implementation
+ */
+export declare class StandardFileSystemService implements FileSystemService {
+    readTextFile(filePath: string): Promise<string>;
+    readTextFileWithInfo(filePath: string): Promise<FileReadResult>;
+    writeTextFile(filePath: string, content: string, options?: WriteTextFileOptions): Promise<void>;
+    detectFileBOM(filePath: string): Promise<boolean>;
+    findFiles(fileName: string, searchPaths: readonly string[]): string[];
+}

package/core-dist/src/services/fileSystemService.js

@@ -0,0 +1,131 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { globSync } from 'glob';
+import { readFileWithEncoding, readFileWithEncodingInfo, } from '../utils/fileUtils.js';
+import { iconvEncode, iconvEncodingExists, isUtf8CompatibleEncoding, } from '../utils/iconvHelper.js';
+/**
+ * Supported file encodings for new files.
+ */
+export const FileEncoding = {
+    UTF8: 'utf-8',
+    UTF8_BOM: 'utf-8-bom',
+};
+/**
+ * Detects if a buffer has UTF-8 BOM (Byte Order Mark).
+ * UTF-8 BOM is the byte sequence EF BB BF.
+ *
+ * @param buffer - The buffer to check
+ * @returns True if the buffer starts with UTF-8 BOM
+ */
+function hasUTF8BOM(buffer) {
+    return (buffer.length >= 3 &&
+        buffer[0] === 0xef &&
+        buffer[1] === 0xbb &&
+        buffer[2] === 0xbf);
+}
+/**
+ * Return the BOM byte sequence for a given encoding name, or null if the
+ * encoding does not use a standard BOM. Used when writing back a file that
+ * originally had a BOM so the BOM is preserved.
+ */
+function getBOMBytesForEncoding(encoding) {
+    const lower = encoding.toLowerCase().replace(/[^a-z0-9]/g, '');
+    switch (lower) {
+        case 'utf8':
+            return Buffer.from([0xef, 0xbb, 0xbf]);
+        case 'utf16le':
+        case 'utf16':
+            return Buffer.from([0xff, 0xfe]);
+        case 'utf16be':
+            return Buffer.from([0xfe, 0xff]);
+        case 'utf32le':
+        case 'utf32':
+            return Buffer.from([0xff, 0xfe, 0x00, 0x00]);
+        case 'utf32be':
+            return Buffer.from([0x00, 0x00, 0xfe, 0xff]);
+        default:
+            return null;
+    }
+}
+/**
+ * Standard file system implementation
+ */
+export class StandardFileSystemService {
+    async readTextFile(filePath) {
+        // Use encoding-aware reader that handles BOM and non-UTF-8 encodings (e.g. GBK)
+        return readFileWithEncoding(filePath);
+    }
+    async readTextFileWithInfo(filePath) {
+        // Single I/O pass: returns content, encoding, and BOM flag together,
+        // eliminating the need for separate detectFileEncoding / detectFileBOM calls.
+        return readFileWithEncodingInfo(filePath);
+    }
+    async writeTextFile(filePath, content, options) {
+        const bom = options?.bom ?? false;
+        const encoding = options?.encoding;
+        // Check if a non-UTF-8 encoding is specified and supported by iconv-lite
+        const isNonUtf8Encoding = encoding &&
+            !isUtf8CompatibleEncoding(encoding) &&
+            iconvEncodingExists(encoding);
+        if (isNonUtf8Encoding) {
+            // Non-UTF-8 encoding (e.g. GBK, Big5, Shift_JIS, UTF-16LE, UTF-32BE…)
+            // Use iconv-lite to encode the content. When the file originally had a BOM
+            // (bom: true), prepend the correct BOM bytes for this encoding so the
+            // byte-order mark is preserved on write-back.
+            const encoded = iconvEncode(content, encoding);
+            if (bom) {
+                const bomBytes = getBOMBytesForEncoding(encoding);
+                await fs.writeFile(filePath, bomBytes ? Buffer.concat([bomBytes, encoded]) : encoded);
+            }
+            else {
+                await fs.writeFile(filePath, encoded);
+            }
+        }
+        else if (bom) {
+            // UTF-8 BOM: prepend EF BB BF
+            // If content already starts with the BOM character, strip it first to avoid double BOM.
+            const normalizedContent = content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;
+            const bomBuffer = Buffer.from([0xef, 0xbb, 0xbf]);
+            const contentBuffer = Buffer.from(normalizedContent, 'utf-8');
+            await fs.writeFile(filePath, Buffer.concat([bomBuffer, contentBuffer]));
+        }
+        else {
+            await fs.writeFile(filePath, content, 'utf-8');
+        }
+    }
+    async detectFileBOM(filePath) {
+        let fd;
+        try {
+            // Read only the first 3 bytes to check for BOM
+            fd = await fs.open(filePath, 'r');
+            const buffer = Buffer.alloc(3);
+            const { bytesRead } = await fd.read(buffer, 0, 3, 0);
+            if (bytesRead < 3) {
+                return false;
+            }
+            return hasUTF8BOM(buffer);
+        }
+        catch {
+            // File doesn't exist or can't be read - treat as no BOM
+            return false;
+        }
+        finally {
+            await fd?.close();
+        }
+    }
+    findFiles(fileName, searchPaths) {
+        return searchPaths.flatMap((searchPath) => {
+            const pattern = path.posix.join(searchPath, '**', fileName);
+            return globSync(pattern, {
+                nodir: true,
+                absolute: true,
+            });
+        });
+    }
+}
+//# sourceMappingURL=fileSystemService.js.map

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

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

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

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

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

@@ -0,0 +1,216 @@
+/**
+ * @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');
+vi.mock('../utils/fileUtils.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        readFileWithEncoding: vi.fn(),
+        readFileWithEncodingInfo: vi.fn(),
+    };
+});
+import { readFileWithEncoding, readFileWithEncodingInfo, } from '../utils/fileUtils.js';
+describe('StandardFileSystemService', () => {
+    let fileSystem;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        fileSystem = new StandardFileSystemService();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('readTextFile', () => {
+        it('should read file content using readFileWithEncoding', async () => {
+            const testContent = 'Hello, World!';
+            vi.mocked(readFileWithEncoding).mockResolvedValue(testContent);
+            const result = await fileSystem.readTextFile('/test/file.txt');
+            expect(readFileWithEncoding).toHaveBeenCalledWith('/test/file.txt');
+            expect(result).toBe(testContent);
+        });
+        it('should propagate readFileWithEncoding errors', async () => {
+            const error = new Error('ENOENT: File not found');
+            vi.mocked(readFileWithEncoding).mockRejectedValue(error);
+            await expect(fileSystem.readTextFile('/test/file.txt')).rejects.toThrow('ENOENT: File not found');
+        });
+    });
+    describe('readTextFileWithInfo', () => {
+        it('should return content, encoding, and bom via readFileWithEncodingInfo', async () => {
+            const mockResult = { content: 'Hello', encoding: 'utf-8', bom: false };
+            vi.mocked(readFileWithEncodingInfo).mockResolvedValue(mockResult);
+            const result = await fileSystem.readTextFileWithInfo('/test/file.txt');
+            expect(readFileWithEncodingInfo).toHaveBeenCalledWith('/test/file.txt');
+            expect(result).toEqual(mockResult);
+        });
+        it('should return non-UTF-8 encoding info for GBK file', async () => {
+            const mockResult = {
+                content: '你好世界',
+                encoding: 'gb18030',
+                bom: false,
+            };
+            vi.mocked(readFileWithEncodingInfo).mockResolvedValue(mockResult);
+            const result = await fileSystem.readTextFileWithInfo('/test/gbk.txt');
+            expect(result.encoding).toBe('gb18030');
+            expect(result.bom).toBe(false);
+            expect(result.content).toBe('你好世界');
+        });
+        it('should propagate readFileWithEncodingInfo errors', async () => {
+            const error = new Error('ENOENT: File not found');
+            vi.mocked(readFileWithEncodingInfo).mockRejectedValue(error);
+            await expect(fileSystem.readTextFileWithInfo('/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');
+        });
+        it('should write file with BOM when bom option is true', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await fileSystem.writeTextFile('/test/file.txt', 'Hello, World!', {
+                bom: true,
+            });
+            // Verify that fs.writeFile was called with a Buffer that starts with BOM
+            const writeCall = vi.mocked(fs.writeFile).mock.calls[0];
+            expect(writeCall[0]).toBe('/test/file.txt');
+            expect(writeCall[1]).toBeInstanceOf(Buffer);
+            const buffer = writeCall[1];
+            expect(buffer[0]).toBe(0xef);
+            expect(buffer[1]).toBe(0xbb);
+            expect(buffer[2]).toBe(0xbf);
+        });
+        it('should write file without BOM when bom option is false', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await fileSystem.writeTextFile('/test/file.txt', 'Hello, World!', {
+                bom: false,
+            });
+            expect(fs.writeFile).toHaveBeenCalledWith('/test/file.txt', 'Hello, World!', 'utf-8');
+        });
+        it('should not duplicate BOM when content already has BOM character', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            // Content that includes the BOM character (as readTextFile would return)
+            const contentWithBOM = '\uFEFF' + 'Hello';
+            await fileSystem.writeTextFile('/test/file.txt', contentWithBOM, {
+                bom: true,
+            });
+            // Verify that fs.writeFile was called with a Buffer that has only one BOM
+            const writeCall = vi.mocked(fs.writeFile).mock.calls[0];
+            expect(writeCall[0]).toBe('/test/file.txt');
+            expect(writeCall[1]).toBeInstanceOf(Buffer);
+            const buffer = writeCall[1];
+            // First three bytes should be BOM
+            expect(buffer[0]).toBe(0xef);
+            expect(buffer[1]).toBe(0xbb);
+            expect(buffer[2]).toBe(0xbf);
+            // Fourth byte should be 'H' (0x48), not another BOM
+            expect(buffer[3]).toBe(0x48);
+            // Count BOM sequences in the buffer - should be only one
+            let bomCount = 0;
+            for (let i = 0; i <= buffer.length - 3; i++) {
+                if (buffer[i] === 0xef &&
+                    buffer[i + 1] === 0xbb &&
+                    buffer[i + 2] === 0xbf) {
+                    bomCount++;
+                }
+            }
+            expect(bomCount).toBe(1);
+        });
+        it('should write file with non-UTF-8 encoding using iconv-lite', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await fileSystem.writeTextFile('/test/file.txt', '你好世界', {
+                encoding: 'gbk',
+            });
+            // Verify that fs.writeFile was called with a Buffer (iconv-encoded)
+            const writeCall = vi.mocked(fs.writeFile).mock.calls[0];
+            expect(writeCall[0]).toBe('/test/file.txt');
+            expect(writeCall[1]).toBeInstanceOf(Buffer);
+        });
+        it('should write file as UTF-8 when encoding is utf-8', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await fileSystem.writeTextFile('/test/file.txt', 'Hello', {
+                encoding: 'utf-8',
+            });
+            expect(fs.writeFile).toHaveBeenCalledWith('/test/file.txt', 'Hello', 'utf-8');
+        });
+        it('should preserve UTF-16LE BOM when writing back a UTF-16LE file', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await fileSystem.writeTextFile('/test/file.txt', 'Hello', {
+                encoding: 'utf-16le',
+                bom: true,
+            });
+            // iconv-lite encodes as UTF-16LE; with bom:true the FF FE BOM is prepended
+            const writeCall = vi.mocked(fs.writeFile).mock.calls[0];
+            expect(writeCall[0]).toBe('/test/file.txt');
+            expect(writeCall[1]).toBeInstanceOf(Buffer);
+            const buf = writeCall[1];
+            // First two bytes must be the UTF-16LE BOM: FF FE
+            expect(buf[0]).toBe(0xff);
+            expect(buf[1]).toBe(0xfe);
+        });
+        it('should not add BOM when writing UTF-16LE file without bom flag', async () => {
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await fileSystem.writeTextFile('/test/file.txt', 'Hello', {
+                encoding: 'utf-16le',
+                bom: false,
+            });
+            // No BOM prepended — raw iconv-encoded buffer written directly
+            const writeCall = vi.mocked(fs.writeFile).mock.calls[0];
+            expect(writeCall[0]).toBe('/test/file.txt');
+            expect(writeCall[1]).toBeInstanceOf(Buffer);
+            const buf = writeCall[1];
+            // First two bytes should NOT be FF FE (the UTF-16LE BOM)
+            expect(!(buf[0] === 0xff && buf[1] === 0xfe)).toBe(true);
+        });
+    });
+    describe('detectFileBOM', () => {
+        it('should return true for file with UTF-8 BOM', async () => {
+            // Create a buffer with BOM
+            const bomBuffer = Buffer.from([0xef, 0xbb, 0xbf]);
+            // Mock fs.open to return a file descriptor that fills buffer with BOM
+            vi.mocked(fs.open).mockImplementation(async () => ({
+                read: async (buffer, offset) => {
+                    // Copy BOM bytes to the buffer
+                    bomBuffer.copy(buffer, offset);
+                    return { bytesRead: 3 };
+                },
+                close: async () => { },
+            }));
+            const result = await fileSystem.detectFileBOM('/test/file.txt');
+            expect(result).toBe(true);
+        });
+        it('should return false for file without BOM', async () => {
+            // Mock file without BOM (starts with plain text)
+            vi.mocked(fs.open).mockImplementation(async () => ({
+                read: async (buffer, offset) => {
+                    // Copy plain text bytes ("// ")
+                    const plainText = Buffer.from([0x2f, 0x2f, 0x20]);
+                    plainText.copy(buffer, offset);
+                    return { bytesRead: 3 };
+                },
+                close: async () => { },
+            }));
+            const result = await fileSystem.detectFileBOM('/test/file.txt');
+            expect(result).toBe(false);
+        });
+        it('should return false for non-existent file', async () => {
+            vi.mocked(fs.open).mockRejectedValue(new Error('ENOENT'));
+            const result = await fileSystem.detectFileBOM('/test/nonexistent.txt');
+            expect(result).toBe(false);
+        });
+        it('should return false for empty file', async () => {
+            vi.mocked(fs.open).mockImplementation(async () => ({
+                read: async () => ({ bytesRead: 0 }),
+                close: async () => { },
+            }));
+            const result = await fileSystem.detectFileBOM('/test/empty.txt');
+            expect(result).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=fileSystemService.test.js.map

package/core-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":"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"}

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

@@ -0,0 +1,22 @@
+/**
+ * @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>;
+    /**
+     * 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/core-dist/src/services/gitService.js

@@ -0,0 +1,98 @@
+/**
+ * @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 { isCommandAvailable } from '../utils/shell-utils.js';
+import { simpleGit, CheckRepoActions } from 'simple-git';
+import { isNodeError } from '../utils/errors.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 { available: gitAvailable } = isCommandAvailable('git');
+        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.`);
+        }
+    }
+    /**
+     * 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 = Qwen Code\n  email = qwen-code@qwen.ai\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) {
+        try {
+            const repo = this.shadowGitRepository;
+            await repo.add('.');
+            const commitResult = await repo.commit(message);
+            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/core-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/core-dist/src/services/gitService.test.d.ts

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