@didim365/agent-cli-core 0.1.0

package/dist/src/utils/gitIgnoreParser.js

@@ -0,0 +1,169 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import ignore, {} from 'ignore';
+export class GitIgnoreParser {
+    extraPatterns;
+    projectRoot;
+    cache = new Map();
+    globalPatterns;
+    processedExtraPatterns;
+    constructor(projectRoot, extraPatterns) {
+        this.extraPatterns = extraPatterns;
+        this.projectRoot = path.resolve(projectRoot);
+        this.processedExtraPatterns = ignore();
+        if (this.extraPatterns) {
+            // extraPatterns are assumed to be from project root (like .geminiignore)
+            this.processedExtraPatterns.add(this.processPatterns(this.extraPatterns, '.'));
+        }
+    }
+    loadPatternsForFile(patternsFilePath) {
+        let content;
+        try {
+            content = fs.readFileSync(patternsFilePath, 'utf-8');
+        }
+        catch (_error) {
+            return ignore();
+        }
+        const isExcludeFile = patternsFilePath.endsWith(path.join('.git', 'info', 'exclude'));
+        const relativeBaseDir = isExcludeFile
+            ? '.'
+            : path
+                .dirname(path.relative(this.projectRoot, patternsFilePath))
+                .split(path.sep)
+                .join(path.posix.sep);
+        const rawPatterns = content.split('\n');
+        return ignore().add(this.processPatterns(rawPatterns, relativeBaseDir));
+    }
+    processPatterns(rawPatterns, relativeBaseDir) {
+        return rawPatterns
+            .map((p) => p.trimStart())
+            .filter((p) => p !== '' && !p.startsWith('#'))
+            .map((p) => {
+            const isNegative = p.startsWith('!');
+            if (isNegative) {
+                p = p.substring(1);
+            }
+            const isAnchoredInFile = p.startsWith('/');
+            if (isAnchoredInFile) {
+                p = p.substring(1);
+            }
+            // An empty pattern can result from a negated pattern like `!`,
+            // which we can ignore.
+            if (p === '') {
+                return '';
+            }
+            let newPattern = p;
+            if (relativeBaseDir && relativeBaseDir !== '.') {
+                // Only in nested .gitignore files, the patterns need to be modified according to:
+                // - If `a/b/.gitignore` defines `/c` then it needs to be changed to `/a/b/c`
+                // - If `a/b/.gitignore` defines `c` then it needs to be changed to `/a/b/**/c`
+                // - If `a/b/.gitignore` defines `c/d` then it needs to be changed to `/a/b/c/d`
+                if (!isAnchoredInFile && !p.includes('/')) {
+                    // If no slash and not anchored in file, it matches files in any
+                    // subdirectory.
+                    newPattern = path.posix.join('**', p);
+                }
+                // Prepend the .gitignore file's directory.
+                newPattern = path.posix.join(relativeBaseDir, newPattern);
+                // Anchor the pattern to a nested gitignore directory.
+                if (!newPattern.startsWith('/')) {
+                    newPattern = '/' + newPattern;
+                }
+            }
+            // Anchor the pattern if originally anchored
+            if (isAnchoredInFile && !newPattern.startsWith('/')) {
+                newPattern = '/' + newPattern;
+            }
+            if (isNegative) {
+                newPattern = '!' + newPattern;
+            }
+            return newPattern;
+        })
+            .filter((p) => p !== '');
+    }
+    isIgnored(filePath) {
+        if (!filePath || typeof filePath !== 'string') {
+            return false;
+        }
+        const absoluteFilePath = path.resolve(this.projectRoot, filePath);
+        if (!absoluteFilePath.startsWith(this.projectRoot)) {
+            return false;
+        }
+        try {
+            const resolved = path.resolve(this.projectRoot, filePath);
+            const relativePath = path.relative(this.projectRoot, resolved);
+            if (relativePath === '' || relativePath.startsWith('..')) {
+                return false;
+            }
+            // Even in windows, Ignore expects forward slashes.
+            const normalizedPath = relativePath.replace(/\\/g, '/');
+            if (normalizedPath.startsWith('/') || normalizedPath === '') {
+                return false;
+            }
+            const ig = ignore();
+            // Always ignore .git directory
+            ig.add('.git');
+            // Load global patterns from .git/info/exclude on first call
+            if (this.globalPatterns === undefined) {
+                const excludeFile = path.join(this.projectRoot, '.git', 'info', 'exclude');
+                this.globalPatterns = fs.existsSync(excludeFile)
+                    ? this.loadPatternsForFile(excludeFile)
+                    : ignore();
+            }
+            ig.add(this.globalPatterns);
+            const pathParts = relativePath.split(path.sep);
+            const dirsToVisit = [this.projectRoot];
+            let currentAbsDir = this.projectRoot;
+            // Collect all directories in the path
+            for (let i = 0; i < pathParts.length - 1; i++) {
+                currentAbsDir = path.join(currentAbsDir, pathParts[i]);
+                dirsToVisit.push(currentAbsDir);
+            }
+            for (const dir of dirsToVisit) {
+                const relativeDir = path.relative(this.projectRoot, dir);
+                if (relativeDir) {
+                    const normalizedRelativeDir = relativeDir.replace(/\\/g, '/');
+                    const igPlusExtras = ignore()
+                        .add(ig)
+                        .add(this.processedExtraPatterns);
+                    if (igPlusExtras.ignores(normalizedRelativeDir)) {
+                        // This directory is ignored by an ancestor's .gitignore.
+                        // According to git behavior, we don't need to process this
+                        // directory's .gitignore, as nothing inside it can be
+                        // un-ignored.
+                        break;
+                    }
+                }
+                if (this.cache.has(dir)) {
+                    const patterns = this.cache.get(dir);
+                    if (patterns) {
+                        ig.add(patterns);
+                    }
+                }
+                else {
+                    const gitignorePath = path.join(dir, '.gitignore');
+                    if (fs.existsSync(gitignorePath)) {
+                        const patterns = this.loadPatternsForFile(gitignorePath);
+                        this.cache.set(dir, patterns);
+                        ig.add(patterns);
+                    }
+                    else {
+                        this.cache.set(dir, ignore());
+                    }
+                }
+            }
+            // Apply extra patterns (e.g. from .geminiignore) last for precedence
+            ig.add(this.processedExtraPatterns);
+            return ig.ignores(normalizedPath);
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=gitIgnoreParser.js.map

package/dist/src/utils/gitIgnoreParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitIgnoreParser.js","sourceRoot":"","sources":["../../../src/utils/gitIgnoreParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,MAAM,EAAE,EAAe,MAAM,QAAQ,CAAC;AAM7C,MAAM,OAAO,eAAe;IAQP;IAPX,WAAW,CAAS;IACpB,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IACvC,cAAc,CAAqB;IACnC,sBAAsB,CAAS;IAEvC,YACE,WAAmB,EACF,aAAwB;QAAxB,kBAAa,GAAb,aAAa,CAAW;QAEzC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,sBAAsB,GAAG,MAAM,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,yEAAyE;YACzE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAC7B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAC9C,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,gBAAwB;QAClD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,MAAM,EAAE,CAAC;QAClB,CAAC;QAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAC7C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CACrC,CAAC;QAEF,MAAM,eAAe,GAAG,aAAa;YACnC,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,IAAI;iBACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;iBAC1D,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC;IAC1E,CAAC;IAEO,eAAe,CACrB,WAAqB,EACrB,eAAuB;QAEvB,OAAO,WAAW;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;aACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,UAAU,EAAE,CAAC;gBACf,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;YAED,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,gBAAgB,EAAE,CAAC;gBACrB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;YAED,+DAA+D;YAC/D,uBAAuB;YACvB,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,eAAe,IAAI,eAAe,KAAK,GAAG,EAAE,CAAC;gBAC/C,kFAAkF;gBAClF,6EAA6E;gBAC7E,+EAA+E;gBAC/E,gFAAgF;gBAEhF,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1C,gEAAgE;oBAChE,gBAAgB;oBAChB,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxC,CAAC;gBAED,2CAA2C;gBAC3C,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;gBAE1D,sDAAsD;gBACtD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,UAAU,GAAG,GAAG,GAAG,UAAU,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,4CAA4C;YAC5C,IAAI,gBAAgB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,UAAU,GAAG,GAAG,GAAG,UAAU,CAAC;YAChC,CAAC;YAED,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,GAAG,GAAG,GAAG,UAAU,CAAC;YAChC,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAClE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAE/D,IAAI,YAAY,KAAK,EAAE,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzD,OAAO,KAAK,CAAC;YACf,CAAC;YAED,mDAAmD;YACnD,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAExD,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;YAEpB,+BAA+B;YAC/B,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEf,4DAA4D;YAC5D,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBACtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAC3B,IAAI,CAAC,WAAW,EAChB,MAAM,EACN,MAAM,EACN,SAAS,CACV,CAAC;gBACF,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;oBAC9C,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC;oBACvC,CAAC,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAE5B,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAE/C,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,sCAAsC;YACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClC,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;gBAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;gBACzD,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC9D,MAAM,YAAY,GAAG,MAAM,EAAE;yBAC1B,GAAG,CAAC,EAAE,CAAC;yBACP,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;oBACpC,IAAI,YAAY,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;wBAChD,yDAAyD;wBACzD,2DAA2D;wBAC3D,sDAAsD;wBACtD,cAAc;wBACd,MAAM;oBACR,CAAC;gBACH,CAAC;gBAED,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACrC,IAAI,QAAQ,EAAE,CAAC;wBACb,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;oBACnD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;wBACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;wBAEzD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;wBAC9B,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,qEAAqE;YACrE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAEpC,OAAO,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/src/utils/gitIgnoreParser.test.d.ts

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

package/dist/src/utils/gitIgnoreParser.test.js

@@ -0,0 +1,243 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { GitIgnoreParser } from './gitIgnoreParser.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+describe('GitIgnoreParser', () => {
+    let parser;
+    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);
+    }
+    async function setupGitRepo() {
+        await fs.mkdir(path.join(projectRoot, '.git'), { recursive: true });
+    }
+    beforeEach(async () => {
+        projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'gitignore-test-'));
+        parser = new GitIgnoreParser(projectRoot);
+    });
+    afterEach(async () => {
+        await fs.rm(projectRoot, { recursive: true, force: true });
+    });
+    describe('Basic ignore behaviors', () => {
+        beforeEach(async () => {
+            await setupGitRepo();
+        });
+        it('should not ignore files when no .gitignore exists', async () => {
+            expect(parser.isIgnored('file.txt')).toBe(false);
+        });
+        it('should ignore files based on a root .gitignore', async () => {
+            const gitignoreContent = `
+# Comment
+node_modules/
+*.log
+/dist
+.env
+`;
+            await createTestFile('.gitignore', gitignoreContent);
+            expect(parser.isIgnored(path.join('node_modules', 'some-lib'))).toBe(true);
+            expect(parser.isIgnored(path.join('src', 'app.log'))).toBe(true);
+            expect(parser.isIgnored(path.join('dist', 'index.js'))).toBe(true);
+            expect(parser.isIgnored('.env')).toBe(true);
+            expect(parser.isIgnored('src/index.js')).toBe(false);
+        });
+        it('should handle git exclude file', async () => {
+            await createTestFile(path.join('.git', 'info', 'exclude'), 'temp/\n*.tmp');
+            expect(parser.isIgnored(path.join('temp', 'file.txt'))).toBe(true);
+            expect(parser.isIgnored(path.join('src', 'file.tmp'))).toBe(true);
+            expect(parser.isIgnored('src/file.js')).toBe(false);
+        });
+    });
+    describe('isIgnored path handling', () => {
+        beforeEach(async () => {
+            await setupGitRepo();
+            const gitignoreContent = `
+node_modules/
+*.log
+/dist
+/.env
+src/*.tmp
+!src/important.tmp
+`;
+            await createTestFile('.gitignore', gitignoreContent);
+        });
+        it('should always ignore .git directory', () => {
+            expect(parser.isIgnored('.git')).toBe(true);
+            expect(parser.isIgnored(path.join('.git', 'config'))).toBe(true);
+            expect(parser.isIgnored(path.join(projectRoot, '.git', 'HEAD'))).toBe(true);
+        });
+        it('should ignore files matching patterns', () => {
+            expect(parser.isIgnored(path.join('node_modules', 'package', 'index.js'))).toBe(true);
+            expect(parser.isIgnored('app.log')).toBe(true);
+            expect(parser.isIgnored(path.join('logs', 'app.log'))).toBe(true);
+            expect(parser.isIgnored(path.join('dist', 'bundle.js'))).toBe(true);
+            expect(parser.isIgnored('.env')).toBe(true);
+            expect(parser.isIgnored(path.join('config', '.env'))).toBe(false); // .env is anchored to root
+        });
+        it('should ignore files with path-specific patterns', () => {
+            expect(parser.isIgnored(path.join('src', 'temp.tmp'))).toBe(true);
+            expect(parser.isIgnored(path.join('other', 'temp.tmp'))).toBe(false);
+        });
+        it('should handle negation patterns', () => {
+            expect(parser.isIgnored(path.join('src', 'important.tmp'))).toBe(false);
+        });
+        it('should not ignore files that do not match patterns', () => {
+            expect(parser.isIgnored(path.join('src', 'index.ts'))).toBe(false);
+            expect(parser.isIgnored('README.md')).toBe(false);
+        });
+        it('should handle absolute paths correctly', () => {
+            const absolutePath = path.join(projectRoot, 'node_modules', 'lib');
+            expect(parser.isIgnored(absolutePath)).toBe(true);
+        });
+        it('should handle paths outside project root by not ignoring them', () => {
+            const outsidePath = path.resolve(projectRoot, '..', 'other', 'file.txt');
+            expect(parser.isIgnored(outsidePath)).toBe(false);
+        });
+        it('should handle relative paths correctly', () => {
+            expect(parser.isIgnored(path.join('node_modules', 'some-package'))).toBe(true);
+            expect(parser.isIgnored(path.join('..', 'some', 'other', 'file.txt'))).toBe(false);
+        });
+        it('should normalize path separators on Windows', () => {
+            expect(parser.isIgnored(path.join('node_modules', 'package'))).toBe(true);
+            expect(parser.isIgnored(path.join('src', 'temp.tmp'))).toBe(true);
+        });
+        it('should handle root path "/" without throwing error', () => {
+            expect(() => parser.isIgnored('/')).not.toThrow();
+            expect(parser.isIgnored('/')).toBe(false);
+        });
+        it('should handle absolute-like paths without throwing error', () => {
+            expect(() => parser.isIgnored('/some/path')).not.toThrow();
+            expect(parser.isIgnored('/some/path')).toBe(false);
+        });
+        it('should handle paths that start with forward slash', () => {
+            expect(() => parser.isIgnored('/node_modules')).not.toThrow();
+            expect(parser.isIgnored('/node_modules')).toBe(false);
+        });
+        it('should handle backslash-prefixed files without crashing', () => {
+            expect(() => parser.isIgnored('\\backslash-file-test.txt')).not.toThrow();
+            expect(parser.isIgnored('\\backslash-file-test.txt')).toBe(false);
+        });
+        it('should handle files with absolute-like names', () => {
+            expect(() => parser.isIgnored('/backslash-file-test.txt')).not.toThrow();
+            expect(parser.isIgnored('/backslash-file-test.txt')).toBe(false);
+        });
+    });
+    describe('nested .gitignore files', () => {
+        beforeEach(async () => {
+            await setupGitRepo();
+            // Root .gitignore
+            await createTestFile('.gitignore', 'root-ignored.txt');
+            // Nested .gitignore 1
+            await createTestFile('a/.gitignore', '/b\nc');
+            // Nested .gitignore 2
+            await createTestFile('a/d/.gitignore', 'e.txt\nf/g');
+        });
+        it('should handle nested .gitignore files correctly', async () => {
+            // From root .gitignore
+            expect(parser.isIgnored('root-ignored.txt')).toBe(true);
+            expect(parser.isIgnored('a/root-ignored.txt')).toBe(true);
+            // From a/.gitignore: /b
+            expect(parser.isIgnored('a/b')).toBe(true);
+            expect(parser.isIgnored('b')).toBe(false);
+            expect(parser.isIgnored('a/x/b')).toBe(false);
+            // From a/.gitignore: c
+            expect(parser.isIgnored('a/c')).toBe(true);
+            expect(parser.isIgnored('a/x/y/c')).toBe(true);
+            expect(parser.isIgnored('c')).toBe(false);
+            // From a/d/.gitignore: e.txt
+            expect(parser.isIgnored('a/d/e.txt')).toBe(true);
+            expect(parser.isIgnored('a/d/x/e.txt')).toBe(true);
+            expect(parser.isIgnored('a/e.txt')).toBe(false);
+            // From a/d/.gitignore: f/g
+            expect(parser.isIgnored('a/d/f/g')).toBe(true);
+            expect(parser.isIgnored('a/f/g')).toBe(false);
+        });
+    });
+    describe('precedence rules', () => {
+        beforeEach(async () => {
+            await setupGitRepo();
+        });
+        it('should prioritize nested .gitignore over root .gitignore', async () => {
+            await createTestFile('.gitignore', '*.log');
+            await createTestFile('a/b/.gitignore', '!special.log');
+            expect(parser.isIgnored('a/b/any.log')).toBe(true);
+            expect(parser.isIgnored('a/b/special.log')).toBe(false);
+        });
+        it('should prioritize .gitignore over .git/info/exclude', async () => {
+            // Exclude all .log files
+            await createTestFile(path.join('.git', 'info', 'exclude'), '*.log');
+            // But make an exception in the root .gitignore
+            await createTestFile('.gitignore', '!important.log');
+            expect(parser.isIgnored('some.log')).toBe(true);
+            expect(parser.isIgnored('important.log')).toBe(false);
+            expect(parser.isIgnored(path.join('subdir', 'some.log'))).toBe(true);
+            expect(parser.isIgnored(path.join('subdir', 'important.log'))).toBe(false);
+        });
+    });
+    describe('Escaped Characters', () => {
+        beforeEach(async () => {
+            await setupGitRepo();
+        });
+        it('should correctly handle escaped characters in .gitignore', async () => {
+            await createTestFile('.gitignore', '\\#foo\n\\!bar');
+            // Create files with special characters in names
+            await createTestFile('bla/#foo', 'content');
+            await createTestFile('bla/!bar', 'content');
+            // These should be ignored based on the escaped patterns
+            expect(parser.isIgnored('bla/#foo')).toBe(true);
+            expect(parser.isIgnored('bla/!bar')).toBe(true);
+        });
+    });
+    describe('Trailing Spaces', () => {
+        beforeEach(async () => {
+            await setupGitRepo();
+        });
+        it('should correctly handle significant trailing spaces', async () => {
+            await createTestFile('.gitignore', 'foo\\ \nbar ');
+            await createTestFile('foo ', 'content');
+            await createTestFile('bar', 'content');
+            await createTestFile('bar ', 'content');
+            // 'foo\ ' should match 'foo '
+            expect(parser.isIgnored('foo ')).toBe(true);
+            // 'bar ' should be trimmed to 'bar'
+            expect(parser.isIgnored('bar')).toBe(true);
+            expect(parser.isIgnored('bar ')).toBe(false);
+        });
+    });
+    describe('Extra Patterns', () => {
+        beforeEach(async () => {
+            await setupGitRepo();
+        });
+        it('should apply extraPatterns with higher precedence than .gitignore', async () => {
+            await createTestFile('.gitignore', '*.txt');
+            const extraPatterns = ['!important.txt', 'temp/'];
+            parser = new GitIgnoreParser(projectRoot, extraPatterns);
+            expect(parser.isIgnored('file.txt')).toBe(true);
+            expect(parser.isIgnored('important.txt')).toBe(false); // Un-ignored by extraPatterns
+            expect(parser.isIgnored('temp/file.js')).toBe(true); // Ignored by extraPatterns
+        });
+        it('should handle extraPatterns that unignore directories', async () => {
+            await createTestFile('.gitignore', '/foo/\n/a/*/c/');
+            const extraPatterns = ['!foo/', '!a/*/c/'];
+            parser = new GitIgnoreParser(projectRoot, extraPatterns);
+            expect(parser.isIgnored('foo/bar/file.txt')).toBe(false);
+            expect(parser.isIgnored('a/b/c/file.txt')).toBe(false);
+        });
+        it('should handle extraPatterns that unignore directories with nested gitignore', async () => {
+            await createTestFile('.gitignore', '/foo/');
+            await createTestFile('foo/bar/.gitignore', 'file.txt');
+            const extraPatterns = ['!foo/'];
+            parser = new GitIgnoreParser(projectRoot, extraPatterns);
+            expect(parser.isIgnored('foo/bar/file.txt')).toBe(true);
+            expect(parser.isIgnored('foo/bar/file2.txt')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=gitIgnoreParser.test.js.map

package/dist/src/utils/gitIgnoreParser.test.js.map

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

package/dist/src/utils/gitUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Checks if a directory is within a git repository
+ * @param directory The directory to check
+ * @returns true if the directory is in a git repository, false otherwise
+ */
+export declare function isGitRepository(directory: string): boolean;
+/**
+ * Finds the root directory of a git repository
+ * @param directory Starting directory to search from
+ * @returns The git repository root path, or null if not in a git repository
+ */
+export declare function findGitRoot(directory: string): string | null;

package/dist/src/utils/gitUtils.js

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Checks if a directory is within a git repository
+ * @param directory The directory to check
+ * @returns true if the directory is in a git repository, false otherwise
+ */
+export function isGitRepository(directory) {
+    try {
+        let currentDir = path.resolve(directory);
+        while (true) {
+            const gitDir = path.join(currentDir, '.git');
+            // Check if .git exists (either as directory or file for worktrees)
+            if (fs.existsSync(gitDir)) {
+                return true;
+            }
+            const parentDir = path.dirname(currentDir);
+            // If we've reached the root directory, stop searching
+            if (parentDir === currentDir) {
+                break;
+            }
+            currentDir = parentDir;
+        }
+        return false;
+    }
+    catch (_error) {
+        // If any filesystem error occurs, assume not a git repo
+        return false;
+    }
+}
+/**
+ * Finds the root directory of a git repository
+ * @param directory Starting directory to search from
+ * @returns The git repository root path, or null if not in a git repository
+ */
+export function findGitRoot(directory) {
+    try {
+        let currentDir = path.resolve(directory);
+        while (true) {
+            const gitDir = path.join(currentDir, '.git');
+            if (fs.existsSync(gitDir)) {
+                return currentDir;
+            }
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                break;
+            }
+            currentDir = parentDir;
+        }
+        return null;
+    }
+    catch (_error) {
+        return null;
+    }
+}
+//# sourceMappingURL=gitUtils.js.map

package/dist/src/utils/gitUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitUtils.js","sourceRoot":"","sources":["../../../src/utils/gitUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,CAAC;QACH,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAE7C,mEAAmE;YACnE,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE3C,sDAAsD;YACtD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;gBAC7B,MAAM;YACR,CAAC;YAED,UAAU,GAAG,SAAS,CAAC;QACzB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,wDAAwD;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,IAAI,CAAC;QACH,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAE7C,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;gBAC7B,MAAM;YACR,CAAC;YAED,UAAU,GAAG,SAAS,CAAC;QACzB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/utils/googleErrors.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview
+ * This file contains types and functions for parsing structured Google API errors.
+ */
+/**
+ * Based on google/rpc/error_details.proto
+ */
+export interface ErrorInfo {
+    '@type': 'type.googleapis.com/google.rpc.ErrorInfo';
+    reason: string;
+    domain: string;
+    metadata: {
+        [key: string]: string;
+    };
+}
+export interface RetryInfo {
+    '@type': 'type.googleapis.com/google.rpc.RetryInfo';
+    retryDelay: string;
+}
+export interface DebugInfo {
+    '@type': 'type.googleapis.com/google.rpc.DebugInfo';
+    stackEntries: string[];
+    detail: string;
+}
+export interface QuotaFailure {
+    '@type': 'type.googleapis.com/google.rpc.QuotaFailure';
+    violations: Array<{
+        subject?: string;
+        description?: string;
+        apiService?: string;
+        quotaMetric?: string;
+        quotaId?: string;
+        quotaDimensions?: {
+            [key: string]: string;
+        };
+        quotaValue?: string | number;
+        futureQuotaValue?: number;
+    }>;
+}
+export interface PreconditionFailure {
+    '@type': 'type.googleapis.com/google.rpc.PreconditionFailure';
+    violations: Array<{
+        type: string;
+        subject: string;
+        description: string;
+    }>;
+}
+export interface LocalizedMessage {
+    '@type': 'type.googleapis.com/google.rpc.LocalizedMessage';
+    locale: string;
+    message: string;
+}
+export interface BadRequest {
+    '@type': 'type.googleapis.com/google.rpc.BadRequest';
+    fieldViolations: Array<{
+        field: string;
+        description: string;
+        reason?: string;
+        localizedMessage?: LocalizedMessage;
+    }>;
+}
+export interface RequestInfo {
+    '@type': 'type.googleapis.com/google.rpc.RequestInfo';
+    requestId: string;
+    servingData: string;
+}
+export interface ResourceInfo {
+    '@type': 'type.googleapis.com/google.rpc.ResourceInfo';
+    resourceType: string;
+    resourceName: string;
+    owner: string;
+    description: string;
+}
+export interface Help {
+    '@type': 'type.googleapis.com/google.rpc.Help';
+    links: Array<{
+        description: string;
+        url: string;
+    }>;
+}
+export type GoogleApiErrorDetail = ErrorInfo | RetryInfo | DebugInfo | QuotaFailure | PreconditionFailure | BadRequest | RequestInfo | ResourceInfo | Help | LocalizedMessage;
+export interface GoogleApiError {
+    code: number;
+    message: string;
+    details: GoogleApiErrorDetail[];
+}
+/**
+ * Parses an error object to check if it's a structured Google API error
+ * and extracts all details.
+ *
+ * This function can handle two formats:
+ * 1. Standard Google API errors where `details` is a top-level field.
+ * 2. Errors where the entire structured error object is stringified inside
+ *    the `message` field of a wrapper error.
+ *
+ * @param error The error object to inspect.
+ * @returns A GoogleApiError object if the error matches, otherwise null.
+ */
+export declare function parseGoogleApiError(error: unknown): GoogleApiError | null;