@gitkraken/core-gitlens 0.1.0

package/dist/git-cli/cliGitProvider.js

@@ -0,0 +1,273 @@
+import * as path from 'node:path';
+import { Cache } from '../git/cache.js';
+import { deletedOrMissing } from '../git/models/revision.js';
+import { parseGitRemoteUrl } from '../git/utils/remote.utils.js';
+import { isUncommitted } from '../git/utils/revision.utils.js';
+import { GitIgnoreFilter } from '../git/watching/gitIgnoreFilter.js';
+import { getScopedLogger } from '../utils/logger.scoped.js';
+import { joinPaths, maybeUri, normalizePath, splitPath } from '../utils/path.js';
+import { fileUri, joinUriPath, parseUri, toFsPath } from '../utils/uri.js';
+import { fsExists } from './exec/exec.js';
+import { Git } from './exec/git.js';
+import { BlameGitSubProvider } from './providers/blame.js';
+import { BranchesGitSubProvider } from './providers/branches.js';
+import { CommitsGitSubProvider } from './providers/commits.js';
+import { ConfigGitSubProvider } from './providers/config.js';
+import { ContributorsGitSubProvider } from './providers/contributors.js';
+import { DiffGitSubProvider } from './providers/diff.js';
+import { GraphGitSubProvider } from './providers/graph.js';
+import { OperationsGitSubProvider } from './providers/operations.js';
+import { PatchGitSubProvider } from './providers/patch.js';
+import { PausedOperationsGitSubProvider } from './providers/pausedOperations.js';
+import { RefsGitSubProvider } from './providers/refs.js';
+import { RemotesGitSubProvider } from './providers/remotes.js';
+import { RevisionGitSubProvider } from './providers/revision.js';
+import { StagingGitSubProvider } from './providers/staging.js';
+import { StashGitSubProvider } from './providers/stash.js';
+import { StatusGitSubProvider } from './providers/status.js';
+import { TagsGitSubProvider } from './providers/tags.js';
+import { WorktreesGitSubProvider } from './providers/worktrees.js';
+/**
+ * A fully-wired CLI-based git provider that executes git commands via `child_process`.
+ * Implements both `CliGitProviderInternal` (for internal sub-provider wiring)
+ * and `GitProvider` (for registration in a provider registry).
+ *
+ * @example
+ * ```typescript
+ * const provider = new CliGitProvider({
+ *   context: { events: myEvents },
+ *   locator: () => findGitPath(null),
+ *   gitOptions: { gitTimeout: 30000 },
+ * });
+ *
+ * const branches = await provider.branches.getBranches(repoPath);
+ * const status = await provider.status.getStatus(repoPath);
+ * ```
+ */
+export class CliGitProvider {
+    descriptor = { id: 'git', name: 'Git', virtual: false };
+    _cache;
+    _cacheOwned;
+    _git;
+    context;
+    constructor(options) {
+        this.context = options.context;
+        this._git =
+            options.git ??
+                new Git(options.locator, {
+                    ...options.gitOptions,
+                    isTrusted: options.context.workspace?.isTrusted != null
+                        ? () => options.context.workspace.isTrusted
+                        : undefined,
+                });
+        this._cacheOwned = !(options.cache instanceof Cache);
+        this._cache = options.cache instanceof Cache ? options.cache : new Cache();
+    }
+    /** The underlying cache instance (for repo path registration, etc.) */
+    get cache() {
+        return this._cache;
+    }
+    /** The underlying git execution instance (for sub-providers that need direct exec/stream access) */
+    get git() {
+        return this._git;
+    }
+    /** Returns whether the installed git version supports the given feature. */
+    supports(feature) {
+        return this._git.supports(feature);
+    }
+    /** Returns all features matching the prefix that the installed git version supports. */
+    supported(feature) {
+        return this._git.supported(feature);
+    }
+    /** Throws if the installed git version does not support the given feature. */
+    async ensureSupports(feature, prefix, suffix) {
+        return this._git.ensureSupports(feature, prefix, suffix);
+    }
+    /** Returns the installed git version string. */
+    async version() {
+        return this._git.version();
+    }
+    /** Returns the resolved git binary path. */
+    async path() {
+        return this._git.path();
+    }
+    async clone(url, parentPath) {
+        let count = 0;
+        const [, , remotePath] = parseGitRemoteUrl(url);
+        const remoteName = remotePath.split('/').pop();
+        if (!remoteName)
+            return undefined;
+        let folderPath = joinPaths(parentPath, remoteName);
+        while ((await fsExists(folderPath)) && count < 20) {
+            count++;
+            folderPath = joinPaths(parentPath, `${remoteName}-${count}`);
+        }
+        await this._git.exec({ cwd: parentPath }, 'clone', url, folderPath);
+        return folderPath;
+    }
+    _blame;
+    get blame() {
+        return (this._blame ??= new BlameGitSubProvider(this._git, this._cache, this));
+    }
+    _branches;
+    get branches() {
+        return (this._branches ??= new BranchesGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _commits;
+    get commits() {
+        return (this._commits ??= new CommitsGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _config;
+    get config() {
+        return (this._config ??= new ConfigGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _contributors;
+    get contributors() {
+        return (this._contributors ??= new ContributorsGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _diff;
+    get diff() {
+        return (this._diff ??= new DiffGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _graph;
+    get graph() {
+        return (this._graph ??= new GraphGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _ops;
+    get ops() {
+        return (this._ops ??= new OperationsGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _patch;
+    get patch() {
+        return (this._patch ??= new PatchGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _pausedOps;
+    get pausedOps() {
+        return (this._pausedOps ??= new PausedOperationsGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _refs;
+    get refs() {
+        return (this._refs ??= new RefsGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _remotes;
+    get remotes() {
+        return (this._remotes ??= new RemotesGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _revision;
+    get revision() {
+        return (this._revision ??= new RevisionGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _staging;
+    get staging() {
+        return (this._staging ??= new StagingGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _stash;
+    get stash() {
+        return (this._stash ??= new StashGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _status;
+    get status() {
+        return (this._status ??= new StatusGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _tags;
+    get tags() {
+        return (this._tags ??= new TagsGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    _worktrees;
+    get worktrees() {
+        return (this._worktrees ??= new WorktreesGitSubProvider(this.context, this._git, this._cache, this));
+    }
+    getAbsoluteUri(pathOrUri, base) {
+        const baseUri = typeof base !== 'string' ? base : fileUri(base);
+        if (typeof pathOrUri !== 'string')
+            return pathOrUri;
+        if (maybeUri(pathOrUri))
+            return parseUri(pathOrUri);
+        if (path.isAbsolute(pathOrUri))
+            return fileUri(pathOrUri);
+        return joinUriPath(baseUri, pathOrUri);
+    }
+    getRelativePath(pathOrUri, base) {
+        const [relativePath] = splitPath(toFsPath(pathOrUri), toFsPath(base));
+        return relativePath;
+    }
+    async excludeIgnoredUris(repoPath, uris) {
+        const filter = this.getIgnoreFilter(repoPath);
+        await filter.ready();
+        return uris.filter(uri => {
+            const relativePath = normalizePath(path.relative(repoPath, toFsPath(uri)));
+            return !relativePath || !filter.isIgnored(relativePath);
+        });
+    }
+    async getIgnoredUrisFilter(repoPath) {
+        const filter = this.getIgnoreFilter(repoPath);
+        await filter.ready();
+        return (uri) => {
+            const relativePath = normalizePath(path.relative(repoPath, toFsPath(uri)));
+            return relativePath ? filter.isIgnored(relativePath) : false;
+        };
+    }
+    async getLastFetchedTimestamp(repoPath) {
+        return this._cache.getLastFetchedTimestamp(repoPath, async (commonPath) => {
+            const gitDir = await this.config.getGitDir?.(commonPath);
+            if (gitDir == null)
+                return undefined;
+            const gitDirUri = gitDir.commonUri ?? gitDir.uri;
+            const fetchHeadUri = joinUriPath(gitDirUri, 'FETCH_HEAD');
+            const stats = await this.context.fs.stat(fetchHeadUri);
+            // If the file is empty, assume the fetch failed, and don't update the timestamp
+            if (stats != null && stats.size > 0)
+                return stats.mtime;
+            return undefined;
+        });
+    }
+    getIgnoreFilter(repoPath) {
+        let filter = this._cache.gitIgnore.get(repoPath);
+        if (filter == null) {
+            const gitDir = this._cache.gitDir.get(repoPath);
+            const gitDirPath = gitDir?.uri.fsPath ?? `${repoPath}/.git`;
+            filter = new GitIgnoreFilter({
+                repoPath: repoPath,
+                gitDirPath: gitDirPath,
+                fs: this.context.fs,
+                getGlobalExcludesPath: this.config.getConfig != null
+                    ? async () => this.config.getConfig(repoPath, 'core.excludesFile')
+                    : undefined,
+            });
+            this._cache.gitIgnore.set(repoPath, filter);
+        }
+        return filter;
+    }
+    async isTrackedWithDetails(filePath, repoPath, rev) {
+        if (rev === deletedOrMissing)
+            return undefined;
+        const scope = getScopedLogger();
+        try {
+            const [relativePath, root] = splitPath(filePath, repoPath);
+            // Check if the file exists in the working tree first (better cache reuse)
+            let tracked = await this.revision.exists(root, relativePath);
+            if (tracked)
+                return { path: relativePath };
+            // If a specific revision was provided, check there too
+            if (rev && !isUncommitted(rev)) {
+                tracked = await this.revision.exists(root, relativePath, rev);
+                if (!tracked) {
+                    // Check the parent revision (file might have been deleted in this rev)
+                    tracked = await this.revision.exists(root, relativePath, `${rev}^`);
+                }
+            }
+            return tracked ? { path: relativePath } : undefined;
+        }
+        catch (ex) {
+            scope?.error(ex);
+            return undefined;
+        }
+    }
+    dispose() {
+        this._git.dispose();
+        if (this._cacheOwned) {
+            this._cache.dispose();
+        }
+    }
+}
+//# sourceMappingURL=cliGitProvider.js.map

package/dist/git-cli/cliGitProvider.js.map

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

package/dist/git-cli/exec/exec.d.ts

@@ -0,0 +1,4 @@
+export { CancelledRunError, findExecutable, fsExists, getWindowsShortPath, run, RunError, runSpawn, } from '../../utils/env/node/exec.js';
+export type { RunExitResult, RunOptions, RunResult } from '../../utils/env/node/exec.js';
+export { isWindows } from '../../utils/env/node/platform.js';
+//# sourceMappingURL=exec.d.ts.map

package/dist/git-cli/exec/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/exec/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,GAAG,EACH,QAAQ,EACR,QAAQ,GACR,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/git-cli/exec/exec.errors.d.ts

@@ -0,0 +1,2 @@
+export { CancelledRunError, RunError } from '../../utils/env/node/exec.js';
+//# sourceMappingURL=exec.errors.d.ts.map

package/dist/git-cli/exec/exec.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.errors.d.ts","sourceRoot":"","sources":["../../src/exec/exec.errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/git-cli/exec/exec.errors.js

@@ -0,0 +1,2 @@
+export { CancelledRunError, RunError } from '../../utils/env/node/exec.js';
+//# sourceMappingURL=exec.errors.js.map

package/dist/git-cli/exec/exec.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.errors.js","sourceRoot":"","sources":["../../src/exec/exec.errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/git-cli/exec/exec.js

@@ -0,0 +1,3 @@
+export { CancelledRunError, findExecutable, fsExists, getWindowsShortPath, run, RunError, runSpawn, } from '../../utils/env/node/exec.js';
+export { isWindows } from '../../utils/env/node/platform.js';
+//# sourceMappingURL=exec.js.map

package/dist/git-cli/exec/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/exec/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,GAAG,EACH,QAAQ,EACR,QAAQ,GACR,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/git-cli/exec/exec.types.d.ts

@@ -0,0 +1,2 @@
+export type { GitCommandPriority, GitErrorHandling, GitExecOptions, GitResult, GitResultCache, GitSpawnOptions, } from '../../git/exec.types.js';
+//# sourceMappingURL=exec.types.d.ts.map

package/dist/git-cli/exec/exec.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.types.d.ts","sourceRoot":"","sources":["../../src/exec/exec.types.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,cAAc,EACd,eAAe,GACf,MAAM,4BAA4B,CAAC"}

package/dist/git-cli/exec/exec.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exec.types.js.map

package/dist/git-cli/exec/exec.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.types.js","sourceRoot":"","sources":["../../src/exec/exec.types.ts"],"names":[],"mappings":""}

package/dist/git-cli/exec/features.d.ts

@@ -0,0 +1,3 @@
+export type { FilteredGitFeatures, GitFeatureOrPrefix, GitFeatures } from '../../git/features.js';
+export { gitFeaturesByVersion, gitMinimumVersion } from '../../git/features.js';
+//# sourceMappingURL=features.d.ts.map

package/dist/git-cli/exec/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/exec/features.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/git-cli/exec/features.js

@@ -0,0 +1,2 @@
+export { gitFeaturesByVersion, gitMinimumVersion } from '../../git/features.js';
+//# sourceMappingURL=features.js.map

package/dist/git-cli/exec/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../src/exec/features.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/git-cli/exec/git.d.ts

@@ -0,0 +1,228 @@
+import type { BranchErrorReason, CheckoutErrorReason, CherryPickErrorReason, CommitErrorReason, FetchErrorReason, GitCommandError, MergeErrorReason, PausedOperationAbortErrorReason, PausedOperationContinueErrorReason, PullErrorReason, PushErrorReason, RebaseErrorReason, ResetErrorReason, RevertErrorReason, ShowErrorReason, StashApplyErrorReason, StashPushErrorReason, TagErrorReason, WorktreeCreateErrorReason, WorktreeDeleteErrorReason } from '../../git/errors.js';
+import type { LogChannel } from '../../utils/logger.js';
+import type { GitCommandPriority, GitExecOptions, GitResult, GitSpawnOptions } from './exec.types.js';
+import type { FilteredGitFeatures, GitFeatureOrPrefix, GitFeatures } from './features.js';
+import type { GitQueueConfig } from './gitQueue.js';
+import type { GitLocation } from './locator.js';
+export declare const maxGitCliLength = 30000;
+export declare const gitConfigsBranch: readonly ["-c", "color.branch=false"];
+export declare const gitConfigsDiff: readonly ["-c", "color.diff=false", "-c", "diff.mnemonicPrefix=false"];
+export declare const gitConfigsLog: readonly ["-c", "log.showSignature=false"];
+export declare const gitConfigsLogWithFiles: readonly ["-c", "log.showSignature=false", "-c", "diff.renameLimit=0"];
+export declare const gitConfigsLogWithSignatures: readonly ["-c", "log.showSignature=true"];
+export declare const gitConfigsPull: readonly ["-c", "merge.autoStash=true", "-c", "rebase.autoStash=true"];
+export declare const gitConfigsStatus: readonly ["-c", "color.status=false"];
+export declare const GitErrors: {
+    readonly alreadyCheckedOut: RegExp;
+    readonly alreadyExists: RegExp;
+    readonly ambiguousArgument: RegExp;
+    readonly badObject: RegExp;
+    readonly badRevision: RegExp;
+    readonly branchAlreadyExists: RegExp;
+    readonly notFullyMerged: RegExp;
+    readonly cantLockRef: RegExp;
+    readonly changesWouldBeOverwritten: RegExp;
+    readonly cherryPickAborted: RegExp;
+    readonly cherryPickEmptyPrevious: RegExp;
+    readonly cherryPickInProgress: RegExp;
+    readonly commitChangesFirst: RegExp;
+    readonly conflict: RegExp;
+    readonly detachedHead: RegExp;
+    readonly entryNotUpToDate: RegExp;
+    readonly failedToDeleteDirectoryNotEmpty: RegExp;
+    readonly invalidName: RegExp;
+    readonly invalidLineCount: RegExp;
+    readonly invalidObjectName: RegExp;
+    readonly invalidObjectNameList: RegExp;
+    readonly invalidTagName: RegExp;
+    readonly mainWorkingTree: RegExp;
+    readonly mergeAborted: RegExp;
+    readonly mergeInProgress: RegExp;
+    readonly noFastForward: RegExp;
+    readonly noMergeBase: RegExp;
+    readonly noRemoteReference: RegExp;
+    readonly noRemoteRepositorySpecified: RegExp;
+    readonly noUpstream: RegExp;
+    readonly notAValidObjectName: RegExp;
+    readonly notAWorkingTree: RegExp;
+    readonly noUserNameConfigured: RegExp;
+    readonly nothingToCommit: RegExp;
+    readonly noPausedOperation: RegExp;
+    readonly permissionDenied: RegExp;
+    readonly pushRejected: RegExp;
+    readonly pushRejectedRefDoesNotExists: RegExp;
+    readonly rebaseAborted: RegExp;
+    readonly rebaseInProgress: RegExp;
+    readonly rebaseMissingTodo: RegExp;
+    readonly rebaseMultipleBranches: RegExp;
+    readonly revertAborted: RegExp;
+    readonly revertInProgress: RegExp;
+    readonly refLocked: RegExp;
+    readonly remoteAhead: RegExp;
+    readonly remoteConnectionFailed: RegExp;
+    readonly remoteRejected: RegExp;
+    readonly stashConflictingStagedAndUnstagedLines: RegExp;
+    readonly stashNothingToSave: RegExp;
+    readonly stashSavedWorkingDirAndIndexState: RegExp;
+    readonly tagAlreadyExists: RegExp;
+    readonly tagConflict: RegExp;
+    readonly tagNotFound: RegExp;
+    readonly uncommittedChanges: RegExp;
+    readonly unmergedChanges: RegExp;
+    readonly unmergedFiles: RegExp;
+    readonly unresolvedConflicts: RegExp;
+    readonly unsafeRepository: RegExp;
+    readonly unstagedChanges: RegExp;
+};
+export declare const GitWarnings: {
+    readonly notARepository: RegExp;
+    readonly outsideRepository: RegExp;
+    readonly noPath: RegExp;
+    readonly noCommits: RegExp;
+    readonly notFound: RegExp;
+    readonly foundButNotInRevision: RegExp;
+    readonly headNotABranch: RegExp;
+    readonly noUpstream: RegExp;
+    readonly unknownRevision: RegExp;
+    readonly mustRunInWorkTree: RegExp;
+    readonly patchWithConflicts: RegExp;
+    readonly noRemoteRepositorySpecified: RegExp;
+    readonly remoteConnectionError: RegExp;
+    readonly notAGitCommand: RegExp;
+    readonly tipBehind: RegExp;
+};
+export declare class GitError extends Error {
+    readonly original: Error;
+    readonly cmd: string | undefined;
+    readonly exitCode: number | string | undefined;
+    readonly stdout: string | undefined;
+    readonly stderr: string | undefined;
+    constructor(original: Error);
+}
+export type PushForceOptions = {
+    withLease: true;
+    ifIncludes?: boolean;
+} | {
+    withLease: false;
+    ifIncludes?: never;
+};
+type GitCommand = 'branch' | 'checkout' | 'cherry-pick' | 'commit' | 'fetch' | 'merge' | 'paused-operation-abort' | 'paused-operation-continue' | 'pull' | 'push' | 'rebase' | 'reset' | 'revert' | 'show' | 'stash-apply' | 'stash-push' | 'tag' | 'worktree-create' | 'worktree-delete';
+type GitCommandToReasonMap = {
+    branch: BranchErrorReason;
+    checkout: CheckoutErrorReason;
+    'cherry-pick': CherryPickErrorReason;
+    commit: CommitErrorReason;
+    fetch: FetchErrorReason;
+    merge: MergeErrorReason;
+    'paused-operation-abort': PausedOperationAbortErrorReason;
+    'paused-operation-continue': PausedOperationContinueErrorReason;
+    pull: PullErrorReason;
+    push: PushErrorReason;
+    rebase: RebaseErrorReason;
+    reset: ResetErrorReason;
+    revert: RevertErrorReason;
+    show: ShowErrorReason;
+    'stash-apply': StashApplyErrorReason;
+    'stash-push': StashPushErrorReason;
+    tag: TagErrorReason;
+    'worktree-create': WorktreeCreateErrorReason;
+    'worktree-delete': WorktreeDeleteErrorReason;
+};
+export declare function getGitCommandError<T extends GitCommand, TReturn extends GitCommandError<any>>(command: T, ex: GitError, creator: (reason: GitCommandToReasonMap[T] | undefined) => TReturn): TReturn;
+export interface GitOptions {
+    /** Custom environment variables to add to every git command */
+    env?: Record<string, string | undefined>;
+    /** Dynamic environment provider called for each command (e.g., host-discovered SCM credentials) */
+    getEnvironment?: () => Record<string, string | undefined> | undefined;
+    /** Git command timeout in milliseconds. Defaults to 60000. Set to 0 to disable. */
+    gitTimeout?: number;
+    /** Returns whether the workspace is currently trusted. Defaults to true when not provided. Called on every exec/stream. */
+    isTrusted?: () => boolean;
+    /** Queue configuration (max concurrent processes, etc.) */
+    queue?: GitQueueConfig;
+    /** Decodes non-UTF-8 git output. Required when repositories use non-UTF-8 encodings. */
+    decode?: (data: Uint8Array, options?: {
+        readonly encoding: string;
+    }) => string | Promise<string>;
+    /** Hooks for observing git execution events */
+    hooks?: GitHooks;
+    /** Optional dedicated logger for git command logging */
+    logger?: LogChannel;
+}
+export interface GitHooks {
+    /** Called when a git command is aborted (timeout or cancellation) */
+    onAborted?(info: {
+        operation: string;
+        reason: 'timeout' | 'cancellation' | 'unknown';
+        duration: number;
+        timeout: number;
+    }): void;
+    /** Called when a queued command waited longer than 1s before executing */
+    onSlowQueue?(info: {
+        priority: GitCommandPriority;
+        waitTime: number;
+        active: number;
+        queued: Record<GitCommandPriority, number>;
+        maxConcurrent: number;
+    }): void;
+}
+type ExitCodeOnlyGitCommandOptions = GitExecOptions & {
+    exitCodeOnly: true;
+};
+export declare class Git {
+    private readonly _locator;
+    readonly options: GitOptions;
+    /** Map of running git commands — avoids running duplicate overlapping commands */
+    private readonly pendingCommands;
+    /** Queue for throttling background git operations */
+    private readonly _queue;
+    /** Cached base environment: process.env + static options.env + GCM/LC_ALL vars */
+    private _baseEnv;
+    /** Cached full environment: base + dynamic getEnvironment() result */
+    private _fullEnv;
+    /** Last dynamic env reference, used to detect when getEnvironment() returns a new object */
+    private _lastDynamicEnv;
+    constructor(_locator: () => Promise<GitLocation>, options?: GitOptions);
+    /**
+     * Returns the base environment for git commands. Cached to avoid spreading
+     * process.env (30-100+ keys) on every call. Includes static options.env and
+     * GCM/LC_ALL vars but NOT dynamic getEnvironment() or per-call env overrides.
+     */
+    private getBaseEnv;
+    /**
+     * Returns the full environment (base + dynamic). Cached and invalidated
+     * when getEnvironment() returns a different object reference.
+     */
+    private getFullEnv;
+    /**
+     * Builds the environment for a git command. Returns the cached full env
+     * directly when there are no per-call overrides (the common case).
+     * Only allocates a new object when per-call env overrides are provided.
+     */
+    private buildEnv;
+    dispose(): void;
+    /** Clear pending commands (e.g. on cache reset) */
+    clearPendingCommands(): void;
+    private _gitLocation;
+    private _gitLocationPromise;
+    private getLocation;
+    path(): Promise<string>;
+    version(): Promise<string>;
+    supports(feature: GitFeatures): boolean | Promise<boolean>;
+    supported<T extends GitFeatureOrPrefix>(feature: T): FilteredGitFeatures<T>[] | Promise<FilteredGitFeatures<T>[]>;
+    ensureSupports(feature: GitFeatures, prefix: string, suffix: string): Promise<void>;
+    exec(options: ExitCodeOnlyGitCommandOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<unknown>>;
+    exec<T extends string | Buffer = string>(options: GitExecOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<T>>;
+    private execCore;
+    stream(options: GitSpawnOptions, ...args: readonly (string | undefined)[]): AsyncGenerator<string>;
+    rev_parse__git_dir(cwd: string): Promise<{
+        path: string;
+        commonPath?: string;
+    } | undefined>;
+    rev_parse__show_toplevel(cwd: string): Promise<[safe: true, repoPath: string] | [safe: false] | []>;
+    private logGitCommandStart;
+    private logGitCommandComplete;
+}
+export declare function defaultExceptionHandler(ex: Error, cwd: string | undefined, start?: [number, number]): void;
+export {};
+//# sourceMappingURL=git.d.ts.map

package/dist/git-cli/exec/git.d.ts.map

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