@vybestack/llxprt-code-storage 0.10.0-nightly.260613.1adad3b34

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

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface FilterFilesOptions {
+    respectGitIgnore?: boolean;
+    respectLlxprtIgnore?: boolean;
+}
+export interface FilterReport {
+    filteredPaths: string[];
+    ignoredCount: number;
+}
+export declare class FileDiscoveryService {
+    private gitIgnoreFilter;
+    private llxprtIgnoreFilter;
+    private combinedIgnoreFilter;
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * Filters a list of file paths based on git ignore rules
+     */
+    filterFiles(filePaths: string[], options?: FilterFilesOptions): string[];
+    /**
+     * Filters a list of file paths based on git ignore rules and returns a report
+     * with counts of ignored files.
+     */
+    filterFilesWithReport(filePaths: string[], opts?: FilterFilesOptions): FilterReport;
+    /**
+     * Checks if a single file should be git-ignored
+     */
+    shouldGitIgnoreFile(filePath: string): boolean;
+    /**
+     * Checks if a single file should be llxprt-ignored
+     */
+    shouldLlxprtIgnoreFile(filePath: string): boolean;
+    /**
+     * Unified method to check if a file should be ignored based on filtering options
+     */
+    shouldIgnoreFile(filePath: string, options?: FilterFilesOptions): boolean;
+    /**
+     * Returns loaded patterns from .llxprtignore
+     */
+    getLlxprtIgnorePatterns(): string[];
+    private resolveAbsolutePath;
+    private readIgnorePatterns;
+    private tryRealpath;
+}

package/dist/src/services/fileDiscoveryService.js

@@ -0,0 +1,154 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GitIgnoreParser, } from '../utils/gitIgnoreParser.js';
+import { findGitRoot } from '../utils/gitUtils.js';
+import * as fs from 'fs';
+import * as path from 'path';
+const LLXPRT_IGNORE_FILE_NAME = '.llxprtignore';
+export class FileDiscoveryService {
+    gitIgnoreFilter = null;
+    llxprtIgnoreFilter = null;
+    combinedIgnoreFilter = null;
+    projectRoot;
+    constructor(projectRoot) {
+        const absoluteRoot = path.resolve(projectRoot);
+        this.projectRoot = this.tryRealpath(absoluteRoot);
+        const gitRootCandidate = findGitRoot(this.projectRoot);
+        const resolvedGitRoot = gitRootCandidate
+            ? this.tryRealpath(gitRootCandidate)
+            : null;
+        // Read .llxprtignore patterns for both dedicated and combined filters
+        const llxprtPatterns = this.readIgnorePatterns(path.join(this.projectRoot, LLXPRT_IGNORE_FILE_NAME));
+        if (resolvedGitRoot) {
+            // GitIgnoreParser lazily discovers .gitignore patterns on isIgnored()
+            this.gitIgnoreFilter = new GitIgnoreParser(resolvedGitRoot);
+            // Combined filter: .gitignore + .llxprtignore via extraPatterns
+            this.combinedIgnoreFilter = new GitIgnoreParser(resolvedGitRoot, llxprtPatterns);
+        }
+        // Dedicated .llxprtignore filter (also passes patterns as extraPatterns)
+        this.llxprtIgnoreFilter = new GitIgnoreParser(this.projectRoot, llxprtPatterns);
+    }
+    /**
+     * Filters a list of file paths based on git ignore rules
+     */
+    filterFiles(filePaths, options = {
+        respectGitIgnore: true,
+        respectLlxprtIgnore: true,
+    }) {
+        const { respectGitIgnore = true, respectLlxprtIgnore = true } = options;
+        return filePaths.filter((filePath) => {
+            if (respectGitIgnore &&
+                respectLlxprtIgnore &&
+                this.combinedIgnoreFilter) {
+                return !this.combinedIgnoreFilter.isIgnored(filePath);
+            }
+            const absolutePath = this.resolveAbsolutePath(filePath);
+            if (respectGitIgnore && this.shouldGitIgnoreFile(absolutePath)) {
+                return false;
+            }
+            if (respectLlxprtIgnore && this.shouldLlxprtIgnoreFile(absolutePath)) {
+                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,
+        respectLlxprtIgnore: true,
+    }) {
+        const filteredPaths = this.filterFiles(filePaths, opts);
+        const ignoredCount = filePaths.length - filteredPaths.length;
+        return {
+            filteredPaths,
+            ignoredCount,
+        };
+    }
+    /**
+     * Checks if a single file should be git-ignored
+     */
+    shouldGitIgnoreFile(filePath) {
+        if (!this.gitIgnoreFilter) {
+            return false;
+        }
+        const absolutePath = this.resolveAbsolutePath(filePath);
+        return this.gitIgnoreFilter.isIgnored(absolutePath);
+    }
+    /**
+     * Checks if a single file should be llxprt-ignored
+     */
+    shouldLlxprtIgnoreFile(filePath) {
+        if (!this.llxprtIgnoreFilter) {
+            return false;
+        }
+        const absolutePath = this.resolveAbsolutePath(filePath);
+        return this.llxprtIgnoreFilter.isIgnored(absolutePath);
+    }
+    /**
+     * Unified method to check if a file should be ignored based on filtering options
+     */
+    shouldIgnoreFile(filePath, options = {}) {
+        const { respectGitIgnore = true, respectLlxprtIgnore = true } = options;
+        const absolutePath = this.resolveAbsolutePath(filePath);
+        if (respectGitIgnore && this.shouldGitIgnoreFile(absolutePath)) {
+            return true;
+        }
+        if (respectLlxprtIgnore && this.shouldLlxprtIgnoreFile(absolutePath)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Returns loaded patterns from .llxprtignore
+     */
+    getLlxprtIgnorePatterns() {
+        return this.llxprtIgnoreFilter?.getPatterns() ?? [];
+    }
+    resolveAbsolutePath(filePath) {
+        if (path.isAbsolute(filePath)) {
+            try {
+                return fs.realpathSync(filePath);
+            }
+            catch {
+                // Path doesn't exist; return normalized path.
+                return path.normalize(filePath);
+            }
+        }
+        const resolved = path.resolve(this.projectRoot, filePath);
+        try {
+            return fs.realpathSync(resolved);
+        }
+        catch {
+            // Path doesn't exist; return normalized path.
+            return path.normalize(resolved);
+        }
+    }
+    readIgnorePatterns(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return content
+                .split('\n')
+                .filter((line) => line.trim() !== '' && !line.startsWith('#'));
+        }
+        catch {
+            // File doesn't exist or can't be read; return empty patterns.
+            return [];
+        }
+    }
+    tryRealpath(p) {
+        try {
+            return fs.realpathSync(p);
+        }
+        catch {
+            // Path doesn't exist; return normalized path.
+            return path.normalize(p);
+        }
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Abstract base class for file system operations that may be delegated to different implementations.
+ * Provides runtime identity (unlike a pure interface) so consumers can use `instanceof` checks
+ * and the symbol is available at the package root for compatibility verification.
+ */
+export declare abstract class FileSystemService {
+    /**
+     * Read text content from a file
+     *
+     * @param filePath - The path to the file to read
+     * @returns The file content as a string
+     */
+    abstract 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
+     */
+    abstract 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,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs/promises';
+/**
+ * Abstract base class for file system operations that may be delegated to different implementations.
+ * Provides runtime identity (unlike a pure interface) so consumers can use `instanceof` checks
+ * and the symbol is available at the package root for compatibility verification.
+ */
+export class FileSystemService {
+}
+/**
+ * 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;AAElC;;;;GAIG;AACH,MAAM,OAAgB,iBAAiB;CAgBtC;AAED;;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/session/sessionTypes.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Session file naming prefix
+ */
+export declare const SESSION_FILE_PREFIX = "session-";
+/**
+ * Recorded tool call within a message (minimal for rewind purposes)
+ */
+export interface ToolCallRecord {
+    toolName: string;
+    args?: Record<string, unknown>;
+    resultDisplay?: unknown;
+}
+/**
+ * Base message record structure (minimal for session cleanup purposes)
+ */
+export interface BaseMessageRecord {
+    id?: string;
+    timestamp: string;
+    role: 'user' | 'model';
+    type?: string;
+    content?: string;
+    toolCalls?: ToolCallRecord[];
+}
+/**
+ * Conversation record structure (minimal for session cleanup purposes)
+ */
+export interface ConversationRecord {
+    id: string;
+    sessionId: string;
+    timestamp: string;
+    startTime: string;
+    lastUpdated?: string;
+    messages: BaseMessageRecord[];
+}

package/dist/src/session/sessionTypes.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Session file naming prefix
+ */
+export const SESSION_FILE_PREFIX = 'session-';
+//# sourceMappingURL=sessionTypes.js.map

package/dist/src/session/sessionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTypes.js","sourceRoot":"","sources":["../../../src/session/sessionTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC"}

package/dist/src/testing.d.ts

@@ -0,0 +1 @@
+export { resetConversationFileWriterForTesting } from './conversation/ConversationFileWriter.js';

package/dist/src/testing.js

@@ -0,0 +1,4 @@
+// Test-only exports — NOT part of stable public API (Tier 3)
+// These may change between minor versions without notice
+export { resetConversationFileWriterForTesting } from './conversation/ConversationFileWriter.js';
+//# sourceMappingURL=testing.js.map

package/dist/src/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,yDAAyD;AACzD,OAAO,EAAE,qCAAqC,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/src/types/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Logger interface for the storage package.
+ * Injected by consumers to decouple storage from core's logging.
+ */
+export interface StorageLogger {
+    debug(message: string | (() => string), ...context: unknown[]): void;
+    warn(message: string | (() => string), ...context: unknown[]): void;
+    error(message: string | (() => string), ...context: unknown[]): void;
+}
+/** Type-only marker for the null-logger (no runtime footprint). */
+export type NullStorageLogger = StorageLogger;
+/** Concrete null-logger that silently discards all output. */
+export declare class NullStorageLoggerImpl implements StorageLogger {
+    debug(_message: string | (() => string), ..._context: unknown[]): void;
+    warn(_message: string | (() => string), ..._context: unknown[]): void;
+    error(_message: string | (() => string), ..._context: unknown[]): void;
+}

package/dist/src/types/logger.js

@@ -0,0 +1,17 @@
+/**
+ * Logger interface for the storage package.
+ * Injected by consumers to decouple storage from core's logging.
+ */
+/** Concrete null-logger that silently discards all output. */
+export class NullStorageLoggerImpl {
+    debug(_message, ..._context) {
+        // no-op
+    }
+    warn(_message, ..._context) {
+        // no-op
+    }
+    error(_message, ..._context) {
+        // no-op
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/types/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/types/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,8DAA8D;AAC9D,MAAM,OAAO,qBAAqB;IAChC,KAAK,CAAC,QAAiC,EAAE,GAAG,QAAmB;QAC7D,QAAQ;IACV,CAAC;IACD,IAAI,CAAC,QAAiC,EAAE,GAAG,QAAmB;QAC5D,QAAQ;IACV,CAAC;IACD,KAAK,CAAC,QAAiC,EAAE,GAAG,QAAmB;QAC7D,QAAQ;IACV,CAAC;CACF"}

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface GitIgnoreFilter {
+    isIgnored(filePath: string): boolean;
+    getPatterns(): string[];
+}
+export declare class GitIgnoreParser implements GitIgnoreFilter {
+    private readonly extraPatterns?;
+    private projectRoot;
+    private cache;
+    private globalPatterns;
+    private processedExtraPatterns;
+    constructor(projectRoot: string, extraPatterns?: string[] | undefined);
+    private loadPatternsForFile;
+    private processPatterns;
+    isIgnored(filePath: string): boolean;
+    /**
+     * Returns the explicitly added ("extra") ignore patterns.
+     *
+     * NOTE: Despite the generic name, this does NOT return globally loaded
+     * patterns. The underlying `ignore` library does not expose its compiled
+     * patterns, so global patterns cannot be enumerated here. Only the
+     * `extraPatterns` supplied to the constructor are returned.
+     */
+    getPatterns(): string[];
+}

package/dist/src/utils/gitIgnoreParser.js

@@ -0,0 +1,199 @@
+/**
+ * @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 {
+            // File not readable; return empty ignore.
+            return ignore();
+        }
+        // .git/info/exclude file patterns are relative to project root and not file directory
+        const isExcludeFile = patternsFilePath.endsWith(path.join('.git', 'info', 'exclude'));
+        // Use posix path for patterns to preserve escaped characters (e.g., \#, \!)
+        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) => {
+            // Handle escaped special chars at the start: \! or \#
+            // These mean the pattern literally starts with ! or #
+            // We need to KEEP the backslash for the ignore library to interpret correctly
+            // Note: Do NOT strip the backslash - ignore library needs it
+            const isEscapedBang = p.startsWith('\\!');
+            const isNegative = !isEscapedBang && 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;
+        }
+        if (filePath.startsWith('\\') ||
+            filePath === '/' ||
+            filePath.includes('\0')) {
+            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);
+                    // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                    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);
+                    // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                    if (patterns) {
+                        ig.add(patterns);
+                    }
+                }
+                else {
+                    const gitignorePath = path.join(dir, '.gitignore');
+                    // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                    if (fs.existsSync(gitignorePath)) {
+                        const patterns = this.loadPatternsForFile(gitignorePath);
+                        this.cache.set(dir, patterns);
+                        ig.add(patterns);
+                    }
+                    else {
+                        this.cache.set(dir, ignore()); // Cache miss
+                    }
+                }
+            }
+            // Apply extra patterns (e.g. from .geminiignore) last for precedence
+            ig.add(this.processedExtraPatterns);
+            return ig.ignores(normalizedPath);
+        }
+        catch {
+            // Path resolution failed; not ignored.
+            return false;
+        }
+    }
+    /**
+     * Returns the explicitly added ("extra") ignore patterns.
+     *
+     * NOTE: Despite the generic name, this does NOT return globally loaded
+     * patterns. The underlying `ignore` library does not expose its compiled
+     * patterns, so global patterns cannot be enumerated here. Only the
+     * `extraPatterns` supplied to the constructor are returned.
+     */
+    getPatterns() {
+        const allPatterns = [];
+        // Global patterns cannot be enumerated: the `ignore` library does not
+        // expose its compiled pattern set. Intentionally omitted.
+        if (this.extraPatterns) {
+            allPatterns.push(...this.extraPatterns);
+        }
+        return allPatterns;
+    }
+}
+//# 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":"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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;