@gitkraken/core-gitlens 0.5.116 → 0.7.0

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

@@ -0,0 +1,26 @@
+//#region ../git-cli/src/exec/eventLoopMonitor.d.ts
+/**
+ * Detects event-loop stalls via heartbeat drift: a repeating timer whose actual fire time lags its
+ * expected time by roughly the stall length. Cheaper than `perf_hooks.monitorEventLoopDelay`, which
+ * runs a native timer at a resolution far finer than needed to catch a stall worth annotating.
+ *
+ * Only ticks while running; callers `start()`/`stop()` around the window they care about rather than
+ * running this for the lifetime of the process.
+ */
+export declare class EventLoopMonitor {
+  private timer;
+  private expectedMonoMs;
+  private readonly ring;
+  /** Idempotent. */
+  start(): void;
+  /** Idempotent; clears the timer and any recorded samples. */
+  stop(): void;
+  dispose(): void;
+  /** Max observed event-loop stall (ms) among samples ending at or after {@link sinceEpochMs}. 0 when none, or not running. */
+  maxDelaySince(sinceEpochMs: number): number;
+  /** Split out from {@link tick} so tests can inject samples directly, without driving a real timer. */
+  private record;
+  private tick;
+}
+//#endregion
+//# sourceMappingURL=eventLoopMonitor.d.ts.map

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

@@ -0,0 +1,61 @@
+//#region ../git-cli/src/exec/eventLoopMonitor.ts
+const tickIntervalMs = 250;
+const lagRecordThresholdMs = 50;
+const ringCapacity = 480;
+/**
+* Detects event-loop stalls via heartbeat drift: a repeating timer whose actual fire time lags its
+* expected time by roughly the stall length. Cheaper than `perf_hooks.monitorEventLoopDelay`, which
+* runs a native timer at a resolution far finer than needed to catch a stall worth annotating.
+*
+* Only ticks while running; callers `start()`/`stop()` around the window they care about rather than
+* running this for the lifetime of the process.
+*/
+var EventLoopMonitor = class {
+	timer;
+	expectedMonoMs = 0;
+	ring = [];
+	/** Idempotent. */
+	start() {
+		if (this.timer != null) return;
+		this.expectedMonoMs = performance.now() + tickIntervalMs;
+		const timer = setInterval(() => this.tick(), tickIntervalMs);
+		timer.unref?.();
+		this.timer = timer;
+	}
+	/** Idempotent; clears the timer and any recorded samples. */
+	stop() {
+		if (this.timer != null) {
+			clearInterval(this.timer);
+			this.timer = void 0;
+		}
+		this.ring.length = 0;
+	}
+	dispose() {
+		this.stop();
+	}
+	/** Max observed event-loop stall (ms) among samples ending at or after {@link sinceEpochMs}. 0 when none, or not running. */
+	maxDelaySince(sinceEpochMs) {
+		let max = 0;
+		for (const sample of this.ring) if (sample.endMs >= sinceEpochMs && sample.lagMs > max) max = sample.lagMs;
+		return max;
+	}
+	/** Split out from {@link tick} so tests can inject samples directly, without driving a real timer. */
+	record(endMs, lagMs) {
+		if (lagMs < lagRecordThresholdMs) return;
+		this.ring.push({
+			endMs,
+			lagMs
+		});
+		if (this.ring.length > ringCapacity) this.ring.shift();
+	}
+	tick() {
+		const monoMs = performance.now();
+		const lagMs = Math.round(monoMs - this.expectedMonoMs);
+		this.expectedMonoMs = monoMs + tickIntervalMs;
+		this.record(Date.now(), lagMs);
+	}
+};
+//#endregion
+export { EventLoopMonitor };
+
+//# sourceMappingURL=eventLoopMonitor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventLoopMonitor.js","names":[],"sources":["../../../../git-cli/src/exec/eventLoopMonitor.ts"],"sourcesContent":["/** A single recorded event-loop stall. */\ntype LagSample = { readonly endMs: number; readonly lagMs: number };\n\nconst tickIntervalMs = 250;\nconst lagRecordThresholdMs = 50;\nconst ringCapacity = 480;\n\n/**\n * Detects event-loop stalls via heartbeat drift: a repeating timer whose actual fire time lags its\n * expected time by roughly the stall length. Cheaper than `perf_hooks.monitorEventLoopDelay`, which\n * runs a native timer at a resolution far finer than needed to catch a stall worth annotating.\n *\n * Only ticks while running; callers `start()`/`stop()` around the window they care about rather than\n * running this for the lifetime of the process.\n */\nexport class EventLoopMonitor {\n\tprivate timer: ReturnType<typeof setInterval> | undefined;\n\tprivate expectedMonoMs = 0;\n\tprivate readonly ring: LagSample[] = [];\n\n\t/** Idempotent. */\n\tstart(): void {\n\t\tif (this.timer != null) return;\n\n\t\tthis.expectedMonoMs = performance.now() + tickIntervalMs;\n\t\tconst timer = setInterval(() => this.tick(), tickIntervalMs);\n\t\ttimer.unref?.();\n\t\tthis.timer = timer;\n\t}\n\n\t/** Idempotent; clears the timer and any recorded samples. */\n\tstop(): void {\n\t\tif (this.timer != null) {\n\t\t\tclearInterval(this.timer);\n\t\t\tthis.timer = undefined;\n\t\t}\n\n\t\tthis.ring.length = 0;\n\t}\n\n\tdispose(): void {\n\t\tthis.stop();\n\t}\n\n\t/** Max observed event-loop stall (ms) among samples ending at or after {@link sinceEpochMs}. 0 when none, or not running. */\n\tmaxDelaySince(sinceEpochMs: number): number {\n\t\tlet max = 0;\n\t\tfor (const sample of this.ring) {\n\t\t\tif (sample.endMs >= sinceEpochMs && sample.lagMs > max) {\n\t\t\t\tmax = sample.lagMs;\n\t\t\t}\n\t\t}\n\n\t\treturn max;\n\t}\n\n\t/** Split out from {@link tick} so tests can inject samples directly, without driving a real timer. */\n\tprivate record(endMs: number, lagMs: number): void {\n\t\tif (lagMs < lagRecordThresholdMs) return;\n\n\t\tthis.ring.push({ endMs: endMs, lagMs: lagMs });\n\t\tif (this.ring.length > ringCapacity) {\n\t\t\tthis.ring.shift();\n\t\t}\n\t}\n\n\t// Lag is measured on the MONOTONIC clock so a wall-clock step (NTP correction, manual change) or a\n\t// suspend/resume can't be recorded as a stall; the wall clock is only the ring's correlation key,\n\t// since {@link maxDelaySince} callers window by their own `Date.now()`-based start times.\n\tprivate tick(): void {\n\t\tconst monoMs = performance.now();\n\t\tconst lagMs = Math.round(monoMs - this.expectedMonoMs);\n\t\tthis.expectedMonoMs = monoMs + tickIntervalMs;\n\n\t\tthis.record(Date.now(), lagMs);\n\t}\n}\n"],"mappings":";AAGA,MAAM,iBAAiB;AACvB,MAAM,uBAAuB;AAC7B,MAAM,eAAe;;;;;;;;;AAUrB,IAAa,mBAAb,MAA8B;CAC7B;CACA,iBAAyB;CACzB,OAAqC,CAAC;;CAGtC,QAAc;EACb,IAAI,KAAK,SAAS,MAAM;EAExB,KAAK,iBAAiB,YAAY,IAAI,IAAI;EAC1C,MAAM,QAAQ,kBAAkB,KAAK,KAAK,GAAG,cAAc;EAC3D,MAAM,QAAQ;EACd,KAAK,QAAQ;CACd;;CAGA,OAAa;EACZ,IAAI,KAAK,SAAS,MAAM;GACvB,cAAc,KAAK,KAAK;GACxB,KAAK,QAAQ,KAAA;EACd;EAEA,KAAK,KAAK,SAAS;CACpB;CAEA,UAAgB;EACf,KAAK,KAAK;CACX;;CAGA,cAAc,cAA8B;EAC3C,IAAI,MAAM;EACV,KAAK,MAAM,UAAU,KAAK,MACzB,IAAI,OAAO,SAAS,gBAAgB,OAAO,QAAQ,KAClD,MAAM,OAAO;EAIf,OAAO;CACR;;CAGA,OAAe,OAAe,OAAqB;EAClD,IAAI,QAAQ,sBAAsB;EAElC,KAAK,KAAK,KAAK;GAAS;GAAc;EAAM,CAAC;EAC7C,IAAI,KAAK,KAAK,SAAS,cACtB,KAAK,KAAK,MAAM;CAElB;CAKA,OAAqB;EACpB,MAAM,SAAS,YAAY,IAAI;EAC/B,MAAM,QAAQ,KAAK,MAAM,SAAS,KAAK,cAAc;EACrD,KAAK,iBAAiB,SAAS;EAE/B,KAAK,OAAO,KAAK,IAAI,GAAG,KAAK;CAC9B;AACD"}

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

@@ -1,4 +1,3 @@
-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
+import { CancelledRunError, RunError, RunExitResult, RunOptions, RunResult, findExecutable, fsExists, getWindowsShortPath, run, runSpawn } from "../../utils/env/node/exec.js";
+import { isWindows } from "../../utils/env/node/platform.js";
+export { CancelledRunError, RunError, type RunExitResult, type RunOptions, type RunResult, findExecutable, fsExists, getWindowsShortPath, isWindows, run, runSpawn };

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

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

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

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

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

@@ -1,3 +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
+import { isWindows } from "../../utils/env/node/platform.js";
+import { CancelledRunError, RunError, findExecutable, fsExists, getWindowsShortPath, run, runSpawn } from "../../utils/env/node/exec.js";
+export { CancelledRunError, RunError, findExecutable, fsExists, getWindowsShortPath, isWindows, run, runSpawn };

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

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

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

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

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

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

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

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

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

@@ -1,11 +1,15 @@
-import type { BranchErrorReason, CheckoutErrorReason, CherryPickErrorReason, CommitErrorReason, FetchErrorReason, GitCommandError, GitSearchErrorReason, GitWarningKey, MergeErrorReason, PausedOperationAbortErrorReason, PausedOperationContinueErrorReason, PullErrorReason, PushErrorReason, RebaseErrorReason, ResetErrorReason, RevertErrorReason, ShowErrorReason, SigningErrorReason, StashApplyErrorReason, StashPushErrorReason, TagErrorReason, WorktreeCreateErrorReason, WorktreeDeleteErrorReason } from '../../git/errors.js';
-import { GitWarnings } from '../../git/errors.js';
-import type { SigningFormat } from '../../git/models/signature.js';
-import type { LogChannel } from '../../utils/logger.js';
-import type { GitCommandPriority, GitResult, GitRunOptions, 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';
+import { BranchErrorReason, CheckoutErrorReason, CherryPickErrorReason, CommitErrorReason, FetchErrorReason, GitCommandError, GitSearchErrorReason, GitWarningKey, GitWarnings, MergeErrorReason, PausedOperationAbortErrorReason, PausedOperationContinueErrorReason, PullErrorReason, PushErrorReason, RebaseErrorReason, ResetErrorReason, RevertErrorReason, ShowErrorReason, SigningErrorReason, StashApplyErrorReason, StashPushErrorReason, TagErrorReason, WorktreeCreateErrorReason, WorktreeDeleteErrorReason } from "../../git/errors.js";
+import { SigningFormat } from "../../git/models/signature.js";
+import { GitHealthSlownessCategory } from "../../git/gitHealth.js";
+import { GitCommandPriority, GitResult, GitRunOptions, GitSpawnOptions } from "../../git/run.types.js";
+import { FilteredGitFeatures, GitFeatureOrPrefix, GitFeatures } from "../../git/features.js";
+import { LogChannel } from "../../utils/logger.js";
+import "./exec.types.js";
+import { GitQueueConfig } from "./gitQueue.js";
+import { GitLocation } from "./locator.js";
+//#region ../git-cli/src/exec/git.d.ts
+export declare const slowCallWarningThreshold = 2000;
+export type GitFeatureUnsupportedMessage = (requiredVersion: string, installedVersion: string) => string;
 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'];
@@ -15,113 +19,111 @@ export declare const gitConfigsLogWithSignatures: readonly ['-c', 'log.showSigna
 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 cherryPickInProgress: RegExp;
-    readonly commitChangesFirst: RegExp;
-    readonly conflict: RegExp;
-    readonly detachedHead: RegExp;
-    readonly entryNotUpToDate: RegExp;
-    readonly failedToDeleteDirectoryNotEmpty: RegExp;
-    readonly gpgNotFound: RegExp;
-    readonly gpgSignFailed: RegExp;
-    readonly invalidName: RegExp;
-    readonly invalidLineCount: RegExp;
-    readonly invalidObjectName: RegExp;
-    readonly invalidObjectNameList: RegExp;
-    readonly invalidSearchPattern: 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 previousOperationEmpty: RegExp;
-    readonly problemWithEditor: 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 signingKeyNotAvailable: RegExp;
-    readonly sshNotFound: 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;
-    readonly worktreeLocked: RegExp;
-    readonly worktreeLockedReason: RegExp;
+  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 cherryPickInProgress: RegExp;
+  readonly commitChangesFirst: RegExp;
+  readonly conflict: RegExp;
+  readonly detachedHead: RegExp;
+  readonly entryNotUpToDate: RegExp;
+  readonly failedToDeleteDirectoryNotEmpty: RegExp;
+  readonly gpgNotFound: RegExp;
+  readonly gpgSignFailed: RegExp;
+  readonly invalidName: RegExp;
+  readonly invalidLineCount: RegExp;
+  readonly invalidObjectName: RegExp;
+  readonly invalidObjectNameList: RegExp;
+  readonly invalidSearchPattern: 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 previousOperationEmpty: RegExp;
+  readonly problemWithEditor: 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 signingKeyNotAvailable: RegExp;
+  readonly sshNotFound: 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;
+  readonly worktreeLocked: RegExp;
+  readonly worktreeLockedReason: RegExp;
 };
-export { GitWarnings };
-export type { GitWarningKey } from '../../git/errors.js';
 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);
+  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: true;
+  ifIncludes?: boolean;
 } | {
-    withLease: false;
-    ifIncludes?: never;
+  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;
+  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;
 /**
@@ -145,8 +147,8 @@ export declare function classifySigningError(ex: unknown): SigningErrorReason |
  */
 export declare function inferSigningFormatFromError(ex: unknown): SigningFormat | undefined;
 export interface SearchErrorClassification {
-    reason: GitSearchErrorReason;
-    detail?: string;
+  reason: GitSearchErrorReason;
+  detail?: string;
 }
 /**
  * Classifies a graph search failure from its stderr into an {@link GitSearchErrorReason}, with the
@@ -155,108 +157,123 @@ export interface SearchErrorClassification {
  */
 export declare function classifySearchError(ex: unknown): SearchErrorClassification | undefined;
 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;
+  /** 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;
-    /**
-     * Called once per git command that ran slowly (over the slow-call threshold). Fired only for the
-     * command that actually executed, never for a deduplicated rider that merely awaited it, so a single
-     * slow subprocess counts once. `operation` is the primary git subcommand (e.g. `status`, `rev-list`).
-     */
-    onSlowCommand?(info: {
-        operation: string | undefined;
-        cwd: string | undefined;
-        duration: number;
-    }): void;
+  /** 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;
+  /**
+   * Called once per git command that ran slowly (over the slow-call threshold). Fired only for the
+   * command that actually executed, never for a deduplicated rider that merely awaited it, so a single
+   * slow subprocess counts once. `operation` is the primary git subcommand (e.g. `status`, `rev-list`).
+   */
+  onSlowCommand?(info: {
+    operation: string | undefined;
+    cwd: string | undefined;
+    duration: number;
+    /** Measured event-loop stall overlapping the command; omitted (or 0) when none was observed. */
+    eventLoopDelay?: number;
+    /** Caller-declared operation family, see `GitRunOptions.slownessCategory`. */
+    slownessCategory?: GitHealthSlownessCategory;
+  }): void;
 }
 type ExitCodeOnlyGitCommandOptions = GitRunOptions & {
-    exitCodeOnly: true;
+  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>;
-    run(options: ExitCodeOnlyGitCommandOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<unknown>>;
-    run<T extends string | Buffer = string>(options: GitRunOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<T>>;
-    private runCore;
-    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;
+  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;
+  /** Detects event-loop stalls while at least one git command is in flight */
+  private readonly _eventLoopMonitor;
+  /** Count of git commands currently in flight, across both the exec and streaming paths */
+  private _activeCommandCount;
+  /** 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;
+  /** Marks one more git command as in flight; starts the event-loop monitor on the first. */
+  private beginActiveCommand;
+  /** Marks a git command as finished; stops the event-loop monitor once none remain. */
+  private endActiveCommand;
+  /** Formats the shared "event loop blocked" log annotation; undefined below {@link eventLoopDelayAnnotationThreshold}. */
+  private formatEventLoopDelayAnnotation;
+  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>;
+  ensureSupports(feature: GitFeatures, message: GitFeatureUnsupportedMessage): Promise<void>;
+  run(options: ExitCodeOnlyGitCommandOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<unknown>>;
+  run<T extends string | Buffer = string>(options: GitRunOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<T>>;
+  private runCore;
+  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;
 }
 /**
  * Swallows an error whose message matches a known-benign {@link GitWarnings} pattern, returning WHICH one
@@ -264,4 +281,6 @@ export declare class Git {
  * `notARepository` is a failed read. Rethrows anything else.
  */
 export declare function defaultExceptionHandler(ex: Error, cwd: string | undefined, start?: [number, number]): GitWarningKey | undefined;
+//#endregion
+export { type GitWarningKey, GitWarnings };
 //# sourceMappingURL=git.d.ts.map