@anthropic-field/core 0.1.0

package/dist/src/services/contextManager.js

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { loadGlobalMemory, loadEnvironmentMemory, loadJitSubdirectoryMemory, concatenateInstructions, } from '../utils/memoryDiscovery.js';
+import { coreEvents, CoreEvent } from '../utils/events.js';
+export class ContextManager {
+    loadedPaths = new Set();
+    config;
+    globalMemory = '';
+    environmentMemory = '';
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Refreshes the memory by reloading global and environment memory.
+     */
+    async refresh() {
+        this.loadedPaths.clear();
+        await this.loadGlobalMemory();
+        await this.loadEnvironmentMemory();
+        this.emitMemoryChanged();
+    }
+    async loadGlobalMemory() {
+        const result = await loadGlobalMemory(this.config.getDebugMode());
+        this.markAsLoaded(result.files.map((f) => f.path));
+        this.globalMemory = concatenateInstructions(result.files.map((f) => ({ filePath: f.path, content: f.content })), this.config.getWorkingDir());
+    }
+    async loadEnvironmentMemory() {
+        const result = await loadEnvironmentMemory([...this.config.getWorkspaceContext().getDirectories()], this.config.getExtensionLoader(), this.config.getDebugMode());
+        this.markAsLoaded(result.files.map((f) => f.path));
+        const envMemory = concatenateInstructions(result.files.map((f) => ({ filePath: f.path, content: f.content })), this.config.getWorkingDir());
+        const mcpInstructions = this.config.getMcpClientManager()?.getMcpInstructions() || '';
+        this.environmentMemory = [envMemory, mcpInstructions.trimStart()]
+            .filter(Boolean)
+            .join('\n\n');
+    }
+    /**
+     * Discovers and loads context for a specific accessed path (Tier 3 - JIT).
+     * Traverses upwards from the accessed path to the project root.
+     */
+    async discoverContext(accessedPath, trustedRoots) {
+        const result = await loadJitSubdirectoryMemory(accessedPath, trustedRoots, this.loadedPaths, this.config.getDebugMode());
+        if (result.files.length === 0) {
+            return '';
+        }
+        this.markAsLoaded(result.files.map((f) => f.path));
+        return concatenateInstructions(result.files.map((f) => ({ filePath: f.path, content: f.content })), this.config.getWorkingDir());
+    }
+    emitMemoryChanged() {
+        coreEvents.emit(CoreEvent.MemoryChanged, {
+            fileCount: this.loadedPaths.size,
+        });
+    }
+    getGlobalMemory() {
+        return this.globalMemory;
+    }
+    getEnvironmentMemory() {
+        return this.environmentMemory;
+    }
+    markAsLoaded(paths) {
+        for (const p of paths) {
+            this.loadedPaths.add(p);
+        }
+    }
+    getLoadedPaths() {
+        return this.loadedPaths;
+    }
+}
+//# sourceMappingURL=contextManager.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type EnvironmentSanitizationConfig = {
+    allowedEnvironmentVariables: string[];
+    blockedEnvironmentVariables: string[];
+    enableEnvironmentVariableRedaction: boolean;
+};
+export declare function sanitizeEnvironment(processEnv: NodeJS.ProcessEnv, config: EnvironmentSanitizationConfig): NodeJS.ProcessEnv;
+export declare const ALWAYS_ALLOWED_ENVIRONMENT_VARIABLES: ReadonlySet<string>;
+export declare const NEVER_ALLOWED_ENVIRONMENT_VARIABLES: ReadonlySet<string>;
+export declare const NEVER_ALLOWED_NAME_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+export declare const NEVER_ALLOWED_VALUE_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];

package/dist/src/services/environmentSanitization.js

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function sanitizeEnvironment(processEnv, config) {
+    // Enable strict sanitization in GitHub actions.
+    const isStrictSanitization = !!processEnv['GITHUB_SHA'] || processEnv['SURFACE'] === 'Github';
+    // Always sanitize when in GitHub actions.
+    if (!config.enableEnvironmentVariableRedaction && !isStrictSanitization) {
+        return { ...processEnv };
+    }
+    const results = {};
+    const allowedSet = new Set((config.allowedEnvironmentVariables || []).map((k) => k.toUpperCase()));
+    const blockedSet = new Set((config.blockedEnvironmentVariables || []).map((k) => k.toUpperCase()));
+    for (const key in processEnv) {
+        const value = processEnv[key];
+        if (!shouldRedactEnvironmentVariable(key, value, allowedSet, blockedSet, isStrictSanitization)) {
+            results[key] = value;
+        }
+    }
+    return results;
+}
+export const ALWAYS_ALLOWED_ENVIRONMENT_VARIABLES = new Set([
+    // Cross-platform
+    'PATH',
+    // Windows specific
+    'SYSTEMROOT',
+    'COMSPEC',
+    'PATHEXT',
+    'WINDIR',
+    'TEMP',
+    'TMP',
+    'USERPROFILE',
+    'SYSTEMDRIVE',
+    // Unix/Linux/macOS specific
+    'HOME',
+    'LANG',
+    'SHELL',
+    'TMPDIR',
+    'USER',
+    'LOGNAME',
+    // GitHub Action-related variables
+    'ADDITIONAL_CONTEXT',
+    'AVAILABLE_LABELS',
+    'BRANCH_NAME',
+    'DESCRIPTION',
+    'EVENT_NAME',
+    'GITHUB_ENV',
+    'IS_PULL_REQUEST',
+    'ISSUES_TO_TRIAGE',
+    'ISSUE_BODY',
+    'ISSUE_NUMBER',
+    'ISSUE_TITLE',
+    'PULL_REQUEST_NUMBER',
+    'REPOSITORY',
+    'TITLE',
+    'TRIGGERING_ACTOR',
+]);
+export const NEVER_ALLOWED_ENVIRONMENT_VARIABLES = new Set([
+    'CLIENT_ID',
+    'DB_URI',
+    'CONNECTION_STRING',
+    'AWS_DEFAULT_REGION',
+    'AZURE_CLIENT_ID',
+    'AZURE_TENANT_ID',
+    'SLACK_WEBHOOK_URL',
+    'TWILIO_ACCOUNT_SID',
+    'DATABASE_URL',
+    'GOOGLE_CLOUD_PROJECT',
+    'GOOGLE_CLOUD_ACCOUNT',
+    'FIREBASE_PROJECT_ID',
+    'GEMINI_API_KEY',
+    'GOOGLE_API_KEY',
+    'GOOGLE_APPLICATION_CREDENTIALS',
+]);
+export const NEVER_ALLOWED_NAME_PATTERNS = [
+    /TOKEN/i,
+    /SECRET/i,
+    /PASSWORD/i,
+    /PASSWD/i,
+    /KEY/i,
+    /AUTH/i,
+    /CREDENTIAL/i,
+    /CREDS/i,
+    /PRIVATE/i,
+    /CERT/i,
+];
+export const NEVER_ALLOWED_VALUE_PATTERNS = [
+    /-----BEGIN (RSA|OPENSSH|EC|PGP) PRIVATE KEY-----/i,
+    /-----BEGIN CERTIFICATE-----/i,
+    // Credentials in URL
+    /(https?|ftp|smtp):\/\/[^:]+:[^@]+@/i,
+    // GitHub tokens (classic, fine-grained, OAuth, etc.)
+    /(ghp|gho|ghu|ghs|ghr|github_pat)_[a-zA-Z0-9_]{36,}/i,
+    // Google API keys
+    /AIzaSy[a-zA-Z0-9_\\-]{33}/i,
+    // Amazon AWS Access Key ID
+    /AKIA[A-Z0-9]{16}/i,
+    // Generic OAuth/JWT tokens
+    /eyJ[a-zA-Z0-9_-]*\.[a-zA-Z0-9_-]*\.[a-zA-Z0-9_-]*/i,
+    // Stripe API keys
+    /(s|r)k_(live|test)_[0-9a-zA-Z]{24}/i,
+    // Slack tokens (bot, user, etc.)
+    /xox[abpr]-[a-zA-Z0-9-]+/i,
+];
+function shouldRedactEnvironmentVariable(key, value, allowedSet, blockedSet, isStrictSanitization = false) {
+    key = key.toUpperCase();
+    value = value?.toUpperCase();
+    // User overrides take precedence.
+    if (allowedSet?.has(key)) {
+        return false;
+    }
+    if (blockedSet?.has(key)) {
+        return true;
+    }
+    // These are never redacted.
+    if (ALWAYS_ALLOWED_ENVIRONMENT_VARIABLES.has(key) ||
+        key.startsWith('GEMINI_CLI_')) {
+        return false;
+    }
+    // These are always redacted.
+    if (NEVER_ALLOWED_ENVIRONMENT_VARIABLES.has(key)) {
+        return true;
+    }
+    // If in strict mode (e.g. GitHub Action), and not explicitly allowed, redact it.
+    if (isStrictSanitization) {
+        return true;
+    }
+    for (const pattern of NEVER_ALLOWED_NAME_PATTERNS) {
+        if (pattern.test(key)) {
+            return true;
+        }
+    }
+    // Redact if the value looks like a key/cert.
+    if (value) {
+        for (const pattern of NEVER_ALLOWED_VALUE_PATTERNS) {
+            if (pattern.test(value)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=environmentSanitization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environmentSanitization.js","sourceRoot":"","sources":["../../../src/services/environmentSanitization.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,UAAU,mBAAmB,CACjC,UAA6B,EAC7B,MAAqC;IAErC,gDAAgD;IAChD,MAAM,oBAAoB,GACxB,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC;IAEnE,0CAA0C;IAC1C,IAAI,CAAC,MAAM,CAAC,kCAAkC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACxE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CAAC,MAAM,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACvE,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CAAC,MAAM,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACvE,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAE9B,IACE,CAAC,+BAA+B,CAC9B,GAAG,EACH,KAAK,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,CACrB,EACD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,oCAAoC,GAC/C,IAAI,GAAG,CAAC;IACN,iBAAiB;IACjB,MAAM;IACN,mBAAmB;IACnB,YAAY;IACZ,SAAS;IACT,SAAS;IACT,QAAQ;IACR,MAAM;IACN,KAAK;IACL,aAAa;IACb,aAAa;IACb,4BAA4B;IAC5B,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;IACT,kCAAkC;IAClC,oBAAoB;IACpB,kBAAkB;IAClB,aAAa;IACb,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,YAAY;IACZ,cAAc;IACd,aAAa;IACb,qBAAqB;IACrB,YAAY;IACZ,OAAO;IACP,kBAAkB;CACnB,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,mCAAmC,GAAwB,IAAI,GAAG,CAC7E;IACE,WAAW;IACX,QAAQ;IACR,mBAAmB;IACnB,oBAAoB;IACpB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;IACpB,cAAc;IACd,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,gBAAgB;IAChB,gBAAgB;IAChB,gCAAgC;CACjC,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,QAAQ;IACR,SAAS;IACT,WAAW;IACX,SAAS;IACT,MAAM;IACN,OAAO;IACP,aAAa;IACb,QAAQ;IACR,UAAU;IACV,OAAO;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,mDAAmD;IACnD,8BAA8B;IAC9B,qBAAqB;IACrB,qCAAqC;IACrC,qDAAqD;IACrD,qDAAqD;IACrD,kBAAkB;IAClB,4BAA4B;IAC5B,2BAA2B;IAC3B,mBAAmB;IACnB,2BAA2B;IAC3B,oDAAoD;IACpD,kBAAkB;IAClB,qCAAqC;IACrC,iCAAiC;IACjC,0BAA0B;CAClB,CAAC;AAEX,SAAS,+BAA+B,CACtC,GAAW,EACX,KAAyB,EACzB,UAAwB,EACxB,UAAwB,EACxB,oBAAoB,GAAG,KAAK;IAE5B,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACxB,KAAK,GAAG,KAAK,EAAE,WAAW,EAAE,CAAC;IAE7B,kCAAkC;IAClC,IAAI,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,IACE,oCAAoC,CAAC,GAAG,CAAC,GAAG,CAAC;QAC7C,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6BAA6B;IAC7B,IAAI,mCAAmC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iFAAiF;IACjF,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,2BAA2B,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,MAAM,OAAO,IAAI,4BAA4B,EAAE,CAAC;YACnD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface FilterFilesOptions {
+    respectGitIgnore?: boolean;
+    respectGeminiIgnore?: boolean;
+    customIgnoreFilePaths?: string[];
+}
+export interface FilterReport {
+    filteredPaths: string[];
+    ignoredCount: number;
+}
+export declare class FileDiscoveryService {
+    private gitIgnoreFilter;
+    private geminiIgnoreFilter;
+    private customIgnoreFilter;
+    private combinedIgnoreFilter;
+    private defaultFilterFileOptions;
+    private projectRoot;
+    constructor(projectRoot: string, options?: FilterFilesOptions);
+    private applyFilterFilesOptions;
+    /**
+     * Filters a list of file paths based on 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;
+    /**
+     * Unified method to check if a file should be ignored based on filtering options
+     */
+    shouldIgnoreFile(filePath: string, options?: FilterFilesOptions): boolean;
+    /**
+     * Returns the list of ignore files being used (e.g. .geminiignore) excluding .gitignore.
+     */
+    getIgnoreFilePaths(): string[];
+    /**
+     * Returns all ignore files including .gitignore if applicable.
+     */
+    getAllIgnoreFilePaths(): string[];
+}

package/dist/src/services/fileDiscoveryService.js

@@ -0,0 +1,141 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GitIgnoreParser } from '../utils/gitIgnoreParser.js';
+import { IgnoreFileParser } from '../utils/ignoreFileParser.js';
+import { isGitRepository } from '../utils/gitUtils.js';
+import { GEMINI_IGNORE_FILE_NAME } from '../config/constants.js';
+import fs from 'node:fs';
+import * as path from 'node:path';
+export class FileDiscoveryService {
+    gitIgnoreFilter = null;
+    geminiIgnoreFilter = null;
+    customIgnoreFilter = null;
+    combinedIgnoreFilter = null;
+    defaultFilterFileOptions = {
+        respectGitIgnore: true,
+        respectGeminiIgnore: true,
+        customIgnoreFilePaths: [],
+    };
+    projectRoot;
+    constructor(projectRoot, options) {
+        this.projectRoot = path.resolve(projectRoot);
+        this.applyFilterFilesOptions(options);
+        if (isGitRepository(this.projectRoot)) {
+            this.gitIgnoreFilter = new GitIgnoreParser(this.projectRoot);
+        }
+        this.geminiIgnoreFilter = new IgnoreFileParser(this.projectRoot, GEMINI_IGNORE_FILE_NAME);
+        if (this.defaultFilterFileOptions.customIgnoreFilePaths?.length) {
+            this.customIgnoreFilter = new IgnoreFileParser(this.projectRoot, this.defaultFilterFileOptions.customIgnoreFilePaths);
+        }
+        if (this.gitIgnoreFilter) {
+            const geminiPatterns = this.geminiIgnoreFilter.getPatterns();
+            const customPatterns = this.customIgnoreFilter
+                ? this.customIgnoreFilter.getPatterns()
+                : [];
+            // Create combined parser: .gitignore + .geminiignore + custom ignore
+            this.combinedIgnoreFilter = new GitIgnoreParser(this.projectRoot, 
+            // customPatterns should go the last to ensure overwriting of geminiPatterns
+            [...geminiPatterns, ...customPatterns]);
+        }
+        else {
+            // Create combined parser when not git repo
+            const geminiPatterns = this.geminiIgnoreFilter.getPatterns();
+            const customPatterns = this.customIgnoreFilter
+                ? this.customIgnoreFilter.getPatterns()
+                : [];
+            this.combinedIgnoreFilter = new IgnoreFileParser(this.projectRoot, [...geminiPatterns, ...customPatterns], true);
+        }
+    }
+    applyFilterFilesOptions(options) {
+        if (!options)
+            return;
+        if (options.respectGitIgnore !== undefined) {
+            this.defaultFilterFileOptions.respectGitIgnore = options.respectGitIgnore;
+        }
+        if (options.respectGeminiIgnore !== undefined) {
+            this.defaultFilterFileOptions.respectGeminiIgnore =
+                options.respectGeminiIgnore;
+        }
+        if (options.customIgnoreFilePaths) {
+            this.defaultFilterFileOptions.customIgnoreFilePaths =
+                options.customIgnoreFilePaths;
+        }
+    }
+    /**
+     * Filters a list of file paths based on ignore rules
+     */
+    filterFiles(filePaths, options = {}) {
+        const { respectGitIgnore = this.defaultFilterFileOptions.respectGitIgnore, respectGeminiIgnore = this.defaultFilterFileOptions.respectGeminiIgnore, } = options;
+        return filePaths.filter((filePath) => {
+            if (respectGitIgnore &&
+                respectGeminiIgnore &&
+                this.combinedIgnoreFilter) {
+                return !this.combinedIgnoreFilter.isIgnored(filePath);
+            }
+            // Always respect custom ignore filter if provided
+            if (this.customIgnoreFilter?.isIgnored(filePath)) {
+                return false;
+            }
+            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;
+    }
+    /**
+     * Returns the list of ignore files being used (e.g. .geminiignore) excluding .gitignore.
+     */
+    getIgnoreFilePaths() {
+        const paths = [];
+        if (this.geminiIgnoreFilter &&
+            this.defaultFilterFileOptions.respectGeminiIgnore) {
+            paths.push(...this.geminiIgnoreFilter.getIgnoreFilePaths());
+        }
+        if (this.customIgnoreFilter) {
+            paths.push(...this.customIgnoreFilter.getIgnoreFilePaths());
+        }
+        return paths;
+    }
+    /**
+     * Returns all ignore files including .gitignore if applicable.
+     */
+    getAllIgnoreFilePaths() {
+        const paths = [];
+        if (this.gitIgnoreFilter &&
+            this.defaultFilterFileOptions.respectGitIgnore) {
+            const gitIgnorePath = path.join(this.projectRoot, '.gitignore');
+            if (fs.existsSync(gitIgnorePath)) {
+                paths.push(gitIgnorePath);
+            }
+        }
+        return paths.concat(this.getIgnoreFilePaths());
+    }
+}
+//# 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,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/gitService.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @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>;
+    private getShadowRepoEnv;
+    /**
+     * 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,132 @@
+/**
+ * @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;
+        }
+    }
+    getShadowRepoEnv(repoDir) {
+        const gitConfigPath = path.join(repoDir, '.gitconfig');
+        const systemConfigPath = path.join(repoDir, '.gitconfig_system_empty');
+        return {
+            // Prevent git from using the user's global git config.
+            GIT_CONFIG_GLOBAL: gitConfigPath,
+            GIT_CONFIG_SYSTEM: systemConfigPath,
+        };
+    }
+    /**
+     * 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 shadowRepoEnv = this.getShadowRepoEnv(repoDir);
+        await fs.writeFile(shadowRepoEnv.GIT_CONFIG_SYSTEM, '');
+        const repo = simpleGit(repoDir).env(shadowRepoEnv);
+        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,
+            ...this.getShadowRepoEnv(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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"}